diff --git a/docs/dyn/abusiveexperiencereport_v1.html b/docs/dyn/abusiveexperiencereport_v1.html index cf674a2780..0ade5e410b 100644 --- a/docs/dyn/abusiveexperiencereport_v1.html +++ b/docs/dyn/abusiveexperiencereport_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/acceleratedmobilepageurl_v1.html b/docs/dyn/acceleratedmobilepageurl_v1.html index 06730c3e6e..1a604c97fe 100644 --- a/docs/dyn/acceleratedmobilepageurl_v1.html +++ b/docs/dyn/acceleratedmobilepageurl_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/accessapproval_v1.folders.approvalRequests.html b/docs/dyn/accessapproval_v1.folders.approvalRequests.html index 4c1f455659..1ab21e4adb 100644 --- a/docs/dyn/accessapproval_v1.folders.approvalRequests.html +++ b/docs/dyn/accessapproval_v1.folders.approvalRequests.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/accessapproval_v1.html b/docs/dyn/accessapproval_v1.html index e675ee2bfc..7e5808deaf 100644 --- a/docs/dyn/accessapproval_v1.html +++ b/docs/dyn/accessapproval_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/accessapproval_v1.organizations.approvalRequests.html b/docs/dyn/accessapproval_v1.organizations.approvalRequests.html index 416f433cc3..8dc3699422 100644 --- a/docs/dyn/accessapproval_v1.organizations.approvalRequests.html +++ b/docs/dyn/accessapproval_v1.organizations.approvalRequests.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/accessapproval_v1.projects.approvalRequests.html b/docs/dyn/accessapproval_v1.projects.approvalRequests.html index c9086dd00e..7e4153626b 100644 --- a/docs/dyn/accessapproval_v1.projects.approvalRequests.html +++ b/docs/dyn/accessapproval_v1.projects.approvalRequests.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/accesscontextmanager_v1.accessPolicies.accessLevels.html b/docs/dyn/accesscontextmanager_v1.accessPolicies.accessLevels.html index e266474012..f21062738a 100644 --- a/docs/dyn/accesscontextmanager_v1.accessPolicies.accessLevels.html +++ b/docs/dyn/accesscontextmanager_v1.accessPolicies.accessLevels.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, accessLevelFormat=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all access levels for an access policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -414,17 +414,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/accesscontextmanager_v1.accessPolicies.authorizedOrgsDescs.html b/docs/dyn/accesscontextmanager_v1.accessPolicies.authorizedOrgsDescs.html index e866535e86..34cec05fe3 100644 --- a/docs/dyn/accesscontextmanager_v1.accessPolicies.authorizedOrgsDescs.html +++ b/docs/dyn/accesscontextmanager_v1.accessPolicies.authorizedOrgsDescs.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all authorized orgs descs for an access policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/accesscontextmanager_v1.accessPolicies.html b/docs/dyn/accesscontextmanager_v1.accessPolicies.html index 7083960c9e..d85c9cf147 100644 --- a/docs/dyn/accesscontextmanager_v1.accessPolicies.html +++ b/docs/dyn/accesscontextmanager_v1.accessPolicies.html @@ -108,7 +108,7 @@

Instance Methods

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

Lists all access policies in an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -321,17 +321,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html b/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html index c9d7691b5c..7ed47d557d 100644 --- a/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html +++ b/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, deletedPrincipalSyntax=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all service perimeters for an access policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -996,17 +996,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/accesscontextmanager_v1.html b/docs/dyn/accesscontextmanager_v1.html index 8e6c27a84b..16890ad7bb 100644 --- a/docs/dyn/accesscontextmanager_v1.html +++ b/docs/dyn/accesscontextmanager_v1.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/accesscontextmanager_v1.operations.html b/docs/dyn/accesscontextmanager_v1.operations.html index 5c5b48f73e..18ca5016db 100644 --- a/docs/dyn/accesscontextmanager_v1.operations.html +++ b/docs/dyn/accesscontextmanager_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html b/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html index b06067531f..a3fc2164e2 100644 --- a/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html +++ b/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all GcpUserAccessBindings for a Google Cloud organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/accesscontextmanager_v1.permissions.html b/docs/dyn/accesscontextmanager_v1.permissions.html index be9ad6b109..a776c5ddf4 100644 --- a/docs/dyn/accesscontextmanager_v1.permissions.html +++ b/docs/dyn/accesscontextmanager_v1.permissions.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all supported permissions in VPC Service Controls ingress and egress rules for Granular Controls.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -113,17 +113,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/accesscontextmanager_v1.services.html b/docs/dyn/accesscontextmanager_v1.services.html index 3b0abe0594..2adf39d170 100644 --- a/docs/dyn/accesscontextmanager_v1.services.html +++ b/docs/dyn/accesscontextmanager_v1.services.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all VPC-SC supported services. **IAM Permissions**: Requires the following IAM permissions to use this method: - `serviceusage.services.use` on the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/addressvalidation_v1.html b/docs/dyn/addressvalidation_v1.html index e16dd76ef1..303673a9e8 100644 --- a/docs/dyn/addressvalidation_v1.html +++ b/docs/dyn/addressvalidation_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.html index ddcab35ef7..24dbd21da8 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.html @@ -97,7 +97,7 @@

Instance Methods

list(accountId, pageSize=None, pageToken=None, partnerClientId=None, x__xgafv=None)

Lists all the clients for the current sponsor buyer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(accountId, clientAccountId, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.invitations.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.invitations.html index 2eab5aa1c5..f71ba4a92d 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.invitations.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.invitations.html @@ -87,7 +87,7 @@

Instance Methods

list(accountId, clientAccountId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the client users invitations for a client with a given account ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -179,17 +179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.accounts.clients.users.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.users.html index ea8e892ec4..db9aa7f85e 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.users.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.users.html @@ -84,7 +84,7 @@

Instance Methods

list(accountId, clientAccountId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the known client users for a specified sponsor buyer account ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(accountId, clientAccountId, userId, body=None, x__xgafv=None)

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.dealAssociations.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.dealAssociations.html index 2e405ad727..066bca1cbc 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.dealAssociations.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.dealAssociations.html @@ -84,7 +84,7 @@

Instance Methods

list(accountId, creativeId, pageSize=None, pageToken=None, query=None, x__xgafv=None)

List all creative-deal associations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

remove(accountId, creativeId, body=None, x__xgafv=None)

@@ -156,17 +156,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html index e083200037..46b1a5f8b1 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html @@ -92,7 +92,7 @@

Instance Methods

list(accountId, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Lists creatives.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stopWatching(accountId, creativeId, body=None, x__xgafv=None)

@@ -867,17 +867,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.finalizedProposals.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.finalizedProposals.html index 8e726e970e..b764e9b2cd 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.finalizedProposals.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.finalizedProposals.html @@ -81,7 +81,7 @@

Instance Methods

list(accountId, filter=None, filterSyntax=None, pageSize=None, pageToken=None, x__xgafv=None)

List finalized proposals, regardless if a proposal is being renegotiated. A filter expression (PQL query) may be specified to filter the results. The notes will not be returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(accountId, proposalId, body=None, x__xgafv=None)

@@ -506,17 +506,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.products.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.products.html index f6cc5c8b2a..b64fff06aa 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.products.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.products.html @@ -84,7 +84,7 @@

Instance Methods

list(accountId, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all products visible to the buyer (optionally filtered by the specified PQL query).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -528,17 +528,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.accounts.proposals.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html index 79af70688a..7dc080fd81 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html @@ -99,7 +99,7 @@

Instance Methods

list(accountId, filter=None, filterSyntax=None, pageSize=None, pageToken=None, x__xgafv=None)

List proposals. A filter expression (PQL query) may be specified to filter the results. To retrieve all finalized proposals, regardless if a proposal is being renegotiated, see the FinalizedProposals resource. Note that Bidder/ChildSeat relationships differ from the usual behavior. A Bidder account can only see its child seats' proposals by specifying the ChildSeat's accountId in the request path.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(accountId, proposalId, body=None, x__xgafv=None)

@@ -2960,17 +2960,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.publisherProfiles.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.publisherProfiles.html index 886dd6422a..e4a92cc03c 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.publisherProfiles.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.publisherProfiles.html @@ -84,7 +84,7 @@

Instance Methods

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

List all publisher profiles visible to the buyer

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidMetrics.html index 8c3da140b5..b8dbbed214 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of bids.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponseErrors.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponseErrors.html index cf59529c68..53207b05f1 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponseErrors.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponseErrors.html @@ -81,7 +81,7 @@

Instance Methods

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

List all errors that occurred in bid responses, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponsesWithoutBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponsesWithoutBids.html index 42aa2b94e1..0a8bbf09ca 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponsesWithoutBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.bidResponsesWithoutBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBidRequests.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBidRequests.html index 42566440e5..4e8b1c49a7 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBidRequests.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBidRequests.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.creatives.html index 2050c2d2ef..7534464aa4 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.creatives.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.creatives.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.details.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.details.html index 6573fd19f6..9ff426d103 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.details.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.details.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -130,17 +130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.html index d34a3ee9b7..575d425312 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.filteredBids.html @@ -91,7 +91,7 @@

Instance Methods

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

List all reasons for which bids were filtered, with the number of bids filtered for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.html index 8101891e40..2dbb70088f 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.html @@ -130,7 +130,7 @@

Instance Methods

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

Lists all filter sets for the account with the given account ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -385,17 +385,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.impressionMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.impressionMetrics.html index 2b180d6213..c5c48f61d9 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.impressionMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.impressionMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of impressions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.losingBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.losingBids.html index 01f586566b..6856e39f89 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.losingBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.losingBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.nonBillableWinningBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.nonBillableWinningBids.html index 6f31ba52cb..6fce518a6e 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.nonBillableWinningBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.accounts.filterSets.nonBillableWinningBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.bidMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidMetrics.html index cfabe24e04..2402d7eb01 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of bids.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponseErrors.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponseErrors.html index 336d141a20..6cd8506d4b 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponseErrors.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponseErrors.html @@ -81,7 +81,7 @@

Instance Methods

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

List all errors that occurred in bid responses, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponsesWithoutBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponsesWithoutBids.html index e1ab9129c9..bb7ac51b72 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponsesWithoutBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.bidResponsesWithoutBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBidRequests.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBidRequests.html index 36d1ed12be..923458741a 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBidRequests.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBidRequests.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.creatives.html index e0978d059b..a9db131602 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.creatives.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.creatives.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.details.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.details.html index 7abba8b076..fdbcffa003 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.details.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.details.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -130,17 +130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.html index 555135c92d..e834398146 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.filteredBids.html @@ -91,7 +91,7 @@

Instance Methods

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

List all reasons for which bids were filtered, with the number of bids filtered for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.html index 76bd4abc87..45bcb15146 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.html @@ -130,7 +130,7 @@

Instance Methods

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

Lists all filter sets for the account with the given account ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -385,17 +385,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.impressionMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.impressionMetrics.html index 3412a7ec2e..0c80701e6b 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.impressionMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.impressionMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of impressions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.losingBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.losingBids.html index b90e41a6b4..9208998296 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.losingBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.losingBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.bidders.filterSets.nonBillableWinningBids.html b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.nonBillableWinningBids.html index f51e40478b..73aed61f25 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.nonBillableWinningBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.bidders.filterSets.nonBillableWinningBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.bidMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidMetrics.html index 7597ea61ff..ade8763e70 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of bids.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponseErrors.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponseErrors.html index f9b34403f2..8ff9fc3278 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponseErrors.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponseErrors.html @@ -81,7 +81,7 @@

Instance Methods

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

List all errors that occurred in bid responses, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponsesWithoutBids.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponsesWithoutBids.html index d2f2194b0a..d13c6a8c3a 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponsesWithoutBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.bidResponsesWithoutBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBidRequests.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBidRequests.html index b7a7c3e09f..b36d06ac22 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBidRequests.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBidRequests.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.creatives.html index 0786154c78..b17b92fcc5 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.creatives.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.creatives.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.details.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.details.html index c5566fa40f..218204f89b 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.details.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.details.html @@ -81,7 +81,7 @@

Instance Methods

list(filterSetName, creativeStatusId, pageSize=None, pageToken=None, x__xgafv=None)

List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -130,17 +130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.html index b56af3dd92..30c4f8a786 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.filteredBids.html @@ -91,7 +91,7 @@

Instance Methods

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

List all reasons for which bids were filtered, with the number of bids filtered for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.html index 07ee0668d1..d41429c3ab 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.html @@ -130,7 +130,7 @@

Instance Methods

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

Lists all filter sets for the account with the given account ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -385,17 +385,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.impressionMetrics.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.impressionMetrics.html index 63fdb4b0dd..366d2d25a0 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.impressionMetrics.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.impressionMetrics.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all metrics that are measured in terms of number of impressions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.losingBids.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.losingBids.html index a20d4d7ebc..517a6f83c2 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.losingBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.losingBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.buyers.filterSets.nonBillableWinningBids.html b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.nonBillableWinningBids.html index 47a0e45889..50660b4e43 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.nonBillableWinningBids.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.buyers.filterSets.nonBillableWinningBids.html @@ -81,7 +81,7 @@

Instance Methods

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

List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adexchangebuyer2_v2beta1.html b/docs/dyn/adexchangebuyer2_v2beta1.html index b25f4ae690..400f63bb2e 100644 --- a/docs/dyn/adexchangebuyer2_v2beta1.html +++ b/docs/dyn/adexchangebuyer2_v2beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adexperiencereport_v1.html b/docs/dyn/adexperiencereport_v1.html index a96dba353a..7611012598 100644 --- a/docs/dyn/adexperiencereport_v1.html +++ b/docs/dyn/adexperiencereport_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/admin_datatransfer_v1.applications.html b/docs/dyn/admin_datatransfer_v1.applications.html index 56721aafd9..4b53435b53 100644 --- a/docs/dyn/admin_datatransfer_v1.applications.html +++ b/docs/dyn/admin_datatransfer_v1.applications.html @@ -84,7 +84,7 @@

Instance Methods

list(customerId=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists the applications available for data transfer for a customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admin_datatransfer_v1.html b/docs/dyn/admin_datatransfer_v1.html index bd1b832522..c12caa0254 100644 --- a/docs/dyn/admin_datatransfer_v1.html +++ b/docs/dyn/admin_datatransfer_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/admin_datatransfer_v1.transfers.html b/docs/dyn/admin_datatransfer_v1.transfers.html index 9efc259fb6..95508114b1 100644 --- a/docs/dyn/admin_datatransfer_v1.transfers.html +++ b/docs/dyn/admin_datatransfer_v1.transfers.html @@ -87,7 +87,7 @@

Instance Methods

list(customerId=None, maxResults=None, newOwnerUserId=None, oldOwnerUserId=None, pageToken=None, status=None, x__xgafv=None)

Lists the transfers for a customer by source user, destination user, or status.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -251,17 +251,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admin_directory_v1.chromeosdevices.html b/docs/dyn/admin_directory_v1.chromeosdevices.html index 8a42ef293e..bdbfea5b24 100644 --- a/docs/dyn/admin_directory_v1.chromeosdevices.html +++ b/docs/dyn/admin_directory_v1.chromeosdevices.html @@ -87,7 +87,7 @@

Instance Methods

list(customerId, includeChildOrgunits=None, maxResults=None, orderBy=None, orgUnitPath=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)

Retrieves a paginated list of Chrome OS devices within an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

moveDevicesToOu(customerId, orgUnitPath, body=None, x__xgafv=None)

@@ -524,17 +524,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.customers.chrome.printServers.html b/docs/dyn/admin_directory_v1.customers.chrome.printServers.html index b21ad92e3c..7eba3bcd0b 100644 --- a/docs/dyn/admin_directory_v1.customers.chrome.printServers.html +++ b/docs/dyn/admin_directory_v1.customers.chrome.printServers.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists print server configurations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.customers.chrome.printers.html b/docs/dyn/admin_directory_v1.customers.chrome.printers.html index 861b6fdc9a..22b6bb1e7c 100644 --- a/docs/dyn/admin_directory_v1.customers.chrome.printers.html +++ b/docs/dyn/admin_directory_v1.customers.chrome.printers.html @@ -99,10 +99,10 @@

Instance Methods

listPrinterModels(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the supported printer models.

- listPrinterModels_next(previous_request, previous_response)

+ listPrinterModels_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -442,31 +442,31 @@

Method Details

- listPrinterModels_next(previous_request, previous_response) + listPrinterModels_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.groups.html b/docs/dyn/admin_directory_v1.groups.html index c8b8ebf2f2..4b23a6004b 100644 --- a/docs/dyn/admin_directory_v1.groups.html +++ b/docs/dyn/admin_directory_v1.groups.html @@ -95,7 +95,7 @@

Instance Methods

list(customer=None, domain=None, maxResults=None, orderBy=None, pageToken=None, query=None, sortOrder=None, userKey=None, x__xgafv=None)

Retrieves all groups of a domain or of a user given a userKey (paginated).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(groupKey, body=None, x__xgafv=None)

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.html b/docs/dyn/admin_directory_v1.html index 0c33085fcb..6fddcd7fda 100644 --- a/docs/dyn/admin_directory_v1.html +++ b/docs/dyn/admin_directory_v1.html @@ -178,7 +178,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -187,20 +187,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/admin_directory_v1.members.html b/docs/dyn/admin_directory_v1.members.html index f01e3074ca..a443d09b2a 100644 --- a/docs/dyn/admin_directory_v1.members.html +++ b/docs/dyn/admin_directory_v1.members.html @@ -93,7 +93,7 @@

Instance Methods

list(groupKey, includeDerivedMembership=None, maxResults=None, pageToken=None, roles=None, x__xgafv=None)

Retrieves a paginated list of all members in a group. This method times out after 60 minutes. For more information, see [Troubleshoot error codes](https://developers.google.com/workspace/admin/directory/v1/guides/troubleshoot-error-codes).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(groupKey, memberKey, body=None, x__xgafv=None)

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.mobiledevices.html b/docs/dyn/admin_directory_v1.mobiledevices.html index d8f63f4665..2cf8451a18 100644 --- a/docs/dyn/admin_directory_v1.mobiledevices.html +++ b/docs/dyn/admin_directory_v1.mobiledevices.html @@ -90,7 +90,7 @@

Instance Methods

list(customerId, maxResults=None, orderBy=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)

Retrieves a paginated list of all user-owned mobile devices for an account. To retrieve a list that includes company-owned devices, use the Cloud Identity [Devices API](https://cloud.google.com/identity/docs/concepts/overview-devices) instead. This method times out after 60 minutes. For more information, see [Troubleshoot error codes](https://developers.google.com/workspace/admin/directory/v1/guides/troubleshoot-error-codes).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admin_directory_v1.resources.buildings.html b/docs/dyn/admin_directory_v1.resources.buildings.html index 53701f73d6..d24bf60317 100644 --- a/docs/dyn/admin_directory_v1.resources.buildings.html +++ b/docs/dyn/admin_directory_v1.resources.buildings.html @@ -90,7 +90,7 @@

Instance Methods

list(customer, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of buildings for an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customer, buildingId, body=None, coordinatesSource=None, x__xgafv=None)

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.resources.calendars.html b/docs/dyn/admin_directory_v1.resources.calendars.html index c99bd402ba..4cf9a5da49 100644 --- a/docs/dyn/admin_directory_v1.resources.calendars.html +++ b/docs/dyn/admin_directory_v1.resources.calendars.html @@ -90,7 +90,7 @@

Instance Methods

list(customer, maxResults=None, orderBy=None, pageToken=None, query=None, x__xgafv=None)

Retrieves a list of calendar resources for an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customer, calendarResourceId, body=None, x__xgafv=None)

@@ -251,17 +251,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.resources.features.html b/docs/dyn/admin_directory_v1.resources.features.html index abea56d684..41f5b2a35a 100644 --- a/docs/dyn/admin_directory_v1.resources.features.html +++ b/docs/dyn/admin_directory_v1.resources.features.html @@ -90,7 +90,7 @@

Instance Methods

list(customer, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of features for an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customer, featureKey, body=None, x__xgafv=None)

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.roleAssignments.html b/docs/dyn/admin_directory_v1.roleAssignments.html index 4655b10664..208e72a07b 100644 --- a/docs/dyn/admin_directory_v1.roleAssignments.html +++ b/docs/dyn/admin_directory_v1.roleAssignments.html @@ -90,7 +90,7 @@

Instance Methods

list(customer, includeIndirectRoleAssignments=None, maxResults=None, pageToken=None, roleId=None, userKey=None, x__xgafv=None)

Retrieves a paginated list of all roleAssignments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admin_directory_v1.roles.html b/docs/dyn/admin_directory_v1.roles.html index 849b60e680..0f8acea98e 100644 --- a/docs/dyn/admin_directory_v1.roles.html +++ b/docs/dyn/admin_directory_v1.roles.html @@ -90,7 +90,7 @@

Instance Methods

list(customer, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a paginated list of all the roles in a domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customer, roleId, body=None, x__xgafv=None)

@@ -241,17 +241,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_directory_v1.users.html b/docs/dyn/admin_directory_v1.users.html index b4380e7eb2..1536672555 100644 --- a/docs/dyn/admin_directory_v1.users.html +++ b/docs/dyn/admin_directory_v1.users.html @@ -103,7 +103,7 @@

Instance Methods

list(customFieldMask=None, customer=None, domain=None, event=None, maxResults=None, orderBy=None, pageToken=None, projection=None, query=None, showDeleted=None, sortOrder=None, viewType=None, x__xgafv=None)

Retrieves a paginated list of either deleted users or all users in a domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

makeAdmin(userKey, body=None, x__xgafv=None)

@@ -602,17 +602,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_reports_v1.activities.html b/docs/dyn/admin_reports_v1.activities.html index 2c91449553..6af0bdeaab 100644 --- a/docs/dyn/admin_reports_v1.activities.html +++ b/docs/dyn/admin_reports_v1.activities.html @@ -81,7 +81,7 @@

Instance Methods

list(userKey, applicationName, actorIpAddress=None, agentInfoFilter=None, applicationInfoFilter=None, customerId=None, deviceFilter=None, endTime=None, eventName=None, filters=None, groupIdFilter=None, includeSensitiveData=None, maxResults=None, networkInfoFilter=None, orgUnitID=None, pageToken=None, resourceDetailsFilter=None, startTime=None, statusFilter=None, x__xgafv=None)

Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

watch(userKey, applicationName, actorIpAddress=None, body=None, customerId=None, endTime=None, eventName=None, filters=None, groupIdFilter=None, maxResults=None, orgUnitID=None, pageToken=None, startTime=None, x__xgafv=None)

@@ -430,17 +430,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admin_reports_v1.customerUsageReports.html b/docs/dyn/admin_reports_v1.customerUsageReports.html index f230513344..edb27f3e8c 100644 --- a/docs/dyn/admin_reports_v1.customerUsageReports.html +++ b/docs/dyn/admin_reports_v1.customerUsageReports.html @@ -81,7 +81,7 @@

Instance Methods

get(date, customerId=None, pageToken=None, parameters=None, x__xgafv=None)

Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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/admin_reports_v1.entityUsageReports.html b/docs/dyn/admin_reports_v1.entityUsageReports.html index 63a5fbf1a4..bf07bf1107 100644 --- a/docs/dyn/admin_reports_v1.entityUsageReports.html +++ b/docs/dyn/admin_reports_v1.entityUsageReports.html @@ -81,7 +81,7 @@

Instance Methods

get(entityType, entityKey, date, customerId=None, filters=None, maxResults=None, pageToken=None, parameters=None, x__xgafv=None)

Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

Method Details

@@ -160,17 +160,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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/admin_reports_v1.html b/docs/dyn/admin_reports_v1.html index 71c1e6cf0b..62d2b55489 100644 --- a/docs/dyn/admin_reports_v1.html +++ b/docs/dyn/admin_reports_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/admin_reports_v1.userUsageReport.html b/docs/dyn/admin_reports_v1.userUsageReport.html index 116eb491d8..8b9417d480 100644 --- a/docs/dyn/admin_reports_v1.userUsageReport.html +++ b/docs/dyn/admin_reports_v1.userUsageReport.html @@ -81,7 +81,7 @@

Instance Methods

get(userKey, date, customerId=None, filters=None, groupIdFilter=None, maxResults=None, orgUnitID=None, pageToken=None, parameters=None, x__xgafv=None)

Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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/admob_v1.accounts.adUnits.html b/docs/dyn/admob_v1.accounts.adUnits.html index e334b764be..c219fdc952 100644 --- a/docs/dyn/admob_v1.accounts.adUnits.html +++ b/docs/dyn/admob_v1.accounts.adUnits.html @@ -81,7 +81,7 @@

Instance Methods

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

List the ad units under the specified AdMob account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1.accounts.apps.html b/docs/dyn/admob_v1.accounts.apps.html index d4fe92b636..2cd53316a7 100644 --- a/docs/dyn/admob_v1.accounts.apps.html +++ b/docs/dyn/admob_v1.accounts.apps.html @@ -81,7 +81,7 @@

Instance Methods

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

List the apps under the specified AdMob account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1.accounts.html b/docs/dyn/admob_v1.accounts.html index ba3302a204..17c4fe7c49 100644 --- a/docs/dyn/admob_v1.accounts.html +++ b/docs/dyn/admob_v1.accounts.html @@ -104,7 +104,7 @@

Instance Methods

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

Lists the AdMob publisher account that was most recently signed in to from the AdMob UI. For more information, see https://support.google.com/admob/answer/10243672.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -163,17 +163,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1.html b/docs/dyn/admob_v1.html index b40e4f3ad1..3b75fe820e 100644 --- a/docs/dyn/admob_v1.html +++ b/docs/dyn/admob_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/admob_v1beta.accounts.adSources.adapters.html b/docs/dyn/admob_v1beta.accounts.adSources.adapters.html index 15e84b507f..b534a70132 100644 --- a/docs/dyn/admob_v1beta.accounts.adSources.adapters.html +++ b/docs/dyn/admob_v1beta.accounts.adSources.adapters.html @@ -81,7 +81,7 @@

Instance Methods

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

List the adapters of the ad source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.adSources.html b/docs/dyn/admob_v1beta.accounts.adSources.html index 65a9dc8130..fa0b2f5707 100644 --- a/docs/dyn/admob_v1beta.accounts.adSources.html +++ b/docs/dyn/admob_v1beta.accounts.adSources.html @@ -86,7 +86,7 @@

Instance Methods

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

List the ad sources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.adUnits.adUnitMappings.html b/docs/dyn/admob_v1beta.accounts.adUnits.adUnitMappings.html index 2048ab9ad6..87dcee6626 100644 --- a/docs/dyn/admob_v1beta.accounts.adUnits.adUnitMappings.html +++ b/docs/dyn/admob_v1beta.accounts.adUnits.adUnitMappings.html @@ -84,7 +84,7 @@

Instance Methods

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

List ad unit mappings under the specified AdMob account and ad unit. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.adUnits.html b/docs/dyn/admob_v1beta.accounts.adUnits.html index 19286b04f7..80f7de9680 100644 --- a/docs/dyn/admob_v1beta.accounts.adUnits.html +++ b/docs/dyn/admob_v1beta.accounts.adUnits.html @@ -89,7 +89,7 @@

Instance Methods

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

List the ad units under the specified AdMob account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.apps.html b/docs/dyn/admob_v1beta.accounts.apps.html index 80e3a6c5b7..4c138c03e4 100644 --- a/docs/dyn/admob_v1beta.accounts.apps.html +++ b/docs/dyn/admob_v1beta.accounts.apps.html @@ -84,7 +84,7 @@

Instance Methods

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

List the apps under the specified AdMob account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -184,17 +184,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.html b/docs/dyn/admob_v1beta.accounts.html index 670e1e75c4..e2340e6a1f 100644 --- a/docs/dyn/admob_v1beta.accounts.html +++ b/docs/dyn/admob_v1beta.accounts.html @@ -124,7 +124,7 @@

Instance Methods

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

Lists the AdMob publisher account that was most recently signed in to from the AdMob UI. For more information, see https://support.google.com/admob/answer/10243672.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/admob_v1beta.accounts.mediationGroups.html b/docs/dyn/admob_v1beta.accounts.mediationGroups.html index 2fad4c03de..83e29af590 100644 --- a/docs/dyn/admob_v1beta.accounts.mediationGroups.html +++ b/docs/dyn/admob_v1beta.accounts.mediationGroups.html @@ -89,7 +89,7 @@

Instance Methods

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

List mediation groups under the specified AdMob account. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/admob_v1beta.html b/docs/dyn/admob_v1beta.html index 5e5898fee4..ebf9dd3738 100644 --- a/docs/dyn/admob_v1beta.html +++ b/docs/dyn/admob_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adsense_v2.accounts.adclients.adunits.html b/docs/dyn/adsense_v2.accounts.adclients.adunits.html index 3d23099681..aaeb6503cd 100644 --- a/docs/dyn/adsense_v2.accounts.adclients.adunits.html +++ b/docs/dyn/adsense_v2.accounts.adclients.adunits.html @@ -93,10 +93,10 @@

Instance Methods

listLinkedCustomChannels(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the custom channels available for an ad unit.

- listLinkedCustomChannels_next(previous_request, previous_response)

+ listLinkedCustomChannels_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -255,31 +255,31 @@

Method Details

- listLinkedCustomChannels_next(previous_request, previous_response) + listLinkedCustomChannels_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsense_v2.accounts.adclients.customchannels.html b/docs/dyn/adsense_v2.accounts.adclients.customchannels.html index c303a94284..36fa291940 100644 --- a/docs/dyn/adsense_v2.accounts.adclients.customchannels.html +++ b/docs/dyn/adsense_v2.accounts.adclients.customchannels.html @@ -93,10 +93,10 @@

Instance Methods

listLinkedAdUnits(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the ad units available for a custom channel.

- listLinkedAdUnits_next(previous_request, previous_response)

+ listLinkedAdUnits_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -242,31 +242,31 @@

Method Details

- listLinkedAdUnits_next(previous_request, previous_response) + listLinkedAdUnits_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsense_v2.accounts.adclients.html b/docs/dyn/adsense_v2.accounts.adclients.html index a14146622a..e72e31b296 100644 --- a/docs/dyn/adsense_v2.accounts.adclients.html +++ b/docs/dyn/adsense_v2.accounts.adclients.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists all the ad clients available in an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.accounts.adclients.urlchannels.html b/docs/dyn/adsense_v2.accounts.adclients.urlchannels.html index e4c00da1b6..6e479eff04 100644 --- a/docs/dyn/adsense_v2.accounts.adclients.urlchannels.html +++ b/docs/dyn/adsense_v2.accounts.adclients.urlchannels.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists active url channels.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.accounts.html b/docs/dyn/adsense_v2.accounts.html index 0337bdfd5e..38012add93 100644 --- a/docs/dyn/adsense_v2.accounts.html +++ b/docs/dyn/adsense_v2.accounts.html @@ -120,10 +120,10 @@

Instance Methods

listChildAccounts(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all accounts directly managed by the given AdSense account.

- listChildAccounts_next(previous_request, previous_response)

+ listChildAccounts_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -255,31 +255,31 @@

Method Details

- listChildAccounts_next(previous_request, previous_response) + listChildAccounts_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.accounts.policyIssues.html b/docs/dyn/adsense_v2.accounts.policyIssues.html index 6d71413d79..fff10c3f44 100644 --- a/docs/dyn/adsense_v2.accounts.policyIssues.html +++ b/docs/dyn/adsense_v2.accounts.policyIssues.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all the policy issues where the specified account is involved, both directly and through any AFP child accounts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -200,17 +200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.accounts.reports.saved.html b/docs/dyn/adsense_v2.accounts.reports.saved.html index b17098a149..e7bf1b93f8 100644 --- a/docs/dyn/adsense_v2.accounts.reports.saved.html +++ b/docs/dyn/adsense_v2.accounts.reports.saved.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists saved reports.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.accounts.sites.html b/docs/dyn/adsense_v2.accounts.sites.html index a6ffc970d9..1b2bb2943b 100644 --- a/docs/dyn/adsense_v2.accounts.sites.html +++ b/docs/dyn/adsense_v2.accounts.sites.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all the sites available in an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsense_v2.html b/docs/dyn/adsense_v2.html index 5c41e44055..f60eb3d73f 100644 --- a/docs/dyn/adsense_v2.html +++ b/docs/dyn/adsense_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adsenseplatform_v1.html b/docs/dyn/adsenseplatform_v1.html index 3161133d70..ba547cb16b 100644 --- a/docs/dyn/adsenseplatform_v1.html +++ b/docs/dyn/adsenseplatform_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adsenseplatform_v1.platforms.accounts.html b/docs/dyn/adsenseplatform_v1.platforms.accounts.html index ed2062f3fb..5c16537c2f 100644 --- a/docs/dyn/adsenseplatform_v1.platforms.accounts.html +++ b/docs/dyn/adsenseplatform_v1.platforms.accounts.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists a partial view of sub-accounts for a specific parent account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, creationRequestId=None, x__xgafv=None)

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsenseplatform_v1.platforms.accounts.sites.html b/docs/dyn/adsenseplatform_v1.platforms.accounts.sites.html index fc2fa867e2..4a95b8d4c1 100644 --- a/docs/dyn/adsenseplatform_v1.platforms.accounts.sites.html +++ b/docs/dyn/adsenseplatform_v1.platforms.accounts.sites.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists sites for a specific account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

requestReview(name, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.childAccounts.sites.html b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.childAccounts.sites.html index d337d273bb..b3965e943e 100644 --- a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.childAccounts.sites.html +++ b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.childAccounts.sites.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Platform Child Sites for a specified Platform Child Account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.groups.html b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.groups.html index 6e670a334e..2d97383780 100644 --- a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.groups.html +++ b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.groups.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Platform Groups for a specified Platform.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.html b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.html index 97cf7d1062..5d08ea5c64 100644 --- a/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.html +++ b/docs/dyn/adsenseplatform_v1alpha.accounts.platforms.html @@ -94,7 +94,7 @@

Instance Methods

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

Lists platforms for a specified account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/adsenseplatform_v1alpha.html b/docs/dyn/adsenseplatform_v1alpha.html index 27f70832e6..1d23c05b0a 100644 --- a/docs/dyn/adsenseplatform_v1alpha.html +++ b/docs/dyn/adsenseplatform_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.html b/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.html index 016d064356..91a9c5f400 100644 --- a/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.html +++ b/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists a partial view of sub-accounts for a specific parent account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, creationRequestId=None, x__xgafv=None)

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.sites.html b/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.sites.html index 2736dd6735..e3f66b8672 100644 --- a/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.sites.html +++ b/docs/dyn/adsenseplatform_v1alpha.platforms.accounts.sites.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists sites for a specific account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

requestReview(name, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/advisorynotifications_v1.html b/docs/dyn/advisorynotifications_v1.html index f7fe5bcc02..52a1abd24c 100644 --- a/docs/dyn/advisorynotifications_v1.html +++ b/docs/dyn/advisorynotifications_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/advisorynotifications_v1.organizations.locations.notifications.html b/docs/dyn/advisorynotifications_v1.organizations.locations.notifications.html index c1494fd752..e28a19d768 100644 --- a/docs/dyn/advisorynotifications_v1.organizations.locations.notifications.html +++ b/docs/dyn/advisorynotifications_v1.organizations.locations.notifications.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists notifications under a given parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/advisorynotifications_v1.projects.locations.notifications.html b/docs/dyn/advisorynotifications_v1.projects.locations.notifications.html index 093008c061..f6f9d3fd5b 100644 --- a/docs/dyn/advisorynotifications_v1.projects.locations.notifications.html +++ b/docs/dyn/advisorynotifications_v1.projects.locations.notifications.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists notifications under a given parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agenciesandbrands_v1.agencies.reports.html b/docs/dyn/agenciesandbrands_v1.agencies.reports.html index 2a2a5fa3a0..a5dfcd6a6c 100644 --- a/docs/dyn/agenciesandbrands_v1.agencies.reports.html +++ b/docs/dyn/agenciesandbrands_v1.agencies.reports.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, skip=None, x__xgafv=None)

Lists `Report` objects.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -552,17 +552,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agenciesandbrands_v1.agencies.reports.results.html b/docs/dyn/agenciesandbrands_v1.agencies.reports.results.html index 41570ad824..49df269223 100644 --- a/docs/dyn/agenciesandbrands_v1.agencies.reports.results.html +++ b/docs/dyn/agenciesandbrands_v1.agencies.reports.results.html @@ -81,7 +81,7 @@

Instance Methods

fetchRows(name, pageSize=None, pageToken=None, x__xgafv=None)

Returns the result rows from a completed report. The caller must have previously called `RunReport` and waited for that operation to complete. The rows will be returned according to the order specified by the `sorts` member of the report definition.

- fetchRows_next(previous_request, previous_response)

+ fetchRows_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- fetchRows_next(previous_request, previous_response) + fetchRows_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)
+        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.
-
+ 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/agenciesandbrands_v1.html b/docs/dyn/agenciesandbrands_v1.html index a244eb2d7a..95f7f15eb1 100644 --- a/docs/dyn/agenciesandbrands_v1.html +++ b/docs/dyn/agenciesandbrands_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentity_v1.html b/docs/dyn/agentidentity_v1.html index 3b74b43ec4..877df76ac9 100644 --- a/docs/dyn/agentidentity_v1.html +++ b/docs/dyn/agentidentity_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentity_v1.projects.locations.accessSummaries.html b/docs/dyn/agentidentity_v1.projects.locations.accessSummaries.html index af54f84cac..47043c9baf 100644 --- a/docs/dyn/agentidentity_v1.projects.locations.accessSummaries.html +++ b/docs/dyn/agentidentity_v1.projects.locations.accessSummaries.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists access summaries in a given project and location. Supported filters: - `workload_id`: Filter by the SPIFFE ID of the agent. Example: `workload_id="spiffe://example.com/ns/default/sa/my-agent"`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1.projects.locations.authProviders.authorizations.html b/docs/dyn/agentidentity_v1.projects.locations.authProviders.authorizations.html index 88287d1277..69eb095c88 100644 --- a/docs/dyn/agentidentity_v1.projects.locations.authProviders.authorizations.html +++ b/docs/dyn/agentidentity_v1.projects.locations.authProviders.authorizations.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists authorizations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -179,17 +179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1.projects.locations.authProviders.html b/docs/dyn/agentidentity_v1.projects.locations.authProviders.html index c6b6e73fb9..9e824eddd2 100644 --- a/docs/dyn/agentidentity_v1.projects.locations.authProviders.html +++ b/docs/dyn/agentidentity_v1.projects.locations.authProviders.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists auth providers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -116,10 +116,10 @@

Instance Methods

queryWorkloads(name, pageSize=None, pageToken=None, x__xgafv=None)

Queries which workloads are using a given auth provider.

- queryWorkloads_next(previous_request, previous_response)

+ queryWorkloads_next()

Retrieves the next page of results.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

revokeAuthorization(name, body=None, x__xgafv=None)

@@ -572,17 +572,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -741,31 +741,31 @@

Method Details

- queryWorkloads_next(previous_request, previous_response) + queryWorkloads_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)
+        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.
-
+ 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. +
- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentidentity_v1.projects.locations.html b/docs/dyn/agentidentity_v1.projects.locations.html index be4c65d33d..f75e6ea9d0 100644 --- a/docs/dyn/agentidentity_v1.projects.locations.html +++ b/docs/dyn/agentidentity_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1alpha.html b/docs/dyn/agentidentity_v1alpha.html index c4fcdcc3f3..967045d91a 100644 --- a/docs/dyn/agentidentity_v1alpha.html +++ b/docs/dyn/agentidentity_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentity_v1alpha.projects.locations.accessSummaries.html b/docs/dyn/agentidentity_v1alpha.projects.locations.accessSummaries.html index f6c82ef94d..41117424e5 100644 --- a/docs/dyn/agentidentity_v1alpha.projects.locations.accessSummaries.html +++ b/docs/dyn/agentidentity_v1alpha.projects.locations.accessSummaries.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists access summaries in a given project and location. Supported filters: - `workload_id`: Filter by the SPIFFE ID of the agent. Example: `workload_id="spiffe://example.com/ns/default/sa/my-agent"`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1alpha.projects.locations.authProviders.authorizations.html b/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.authorizations.html index 21137e15e4..fcc9acd3bb 100644 --- a/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.authorizations.html +++ b/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.authorizations.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists authorizations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.html b/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.html index 408da7724e..bdc63fd84b 100644 --- a/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.html +++ b/docs/dyn/agentidentity_v1alpha.projects.locations.authProviders.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists auth providers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -116,10 +116,10 @@

Instance Methods

queryWorkloads(name, pageSize=None, pageToken=None, x__xgafv=None)

Queries which workloads are using a given auth provider.

- queryWorkloads_next(previous_request, previous_response)

+ queryWorkloads_next()

Retrieves the next page of results.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

revokeAuthorization(name, body=None, x__xgafv=None)

@@ -572,17 +572,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -741,31 +741,31 @@

Method Details

- queryWorkloads_next(previous_request, previous_response) + queryWorkloads_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)
+        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.
-
+ 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. +
- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentidentity_v1alpha.projects.locations.html b/docs/dyn/agentidentity_v1alpha.projects.locations.html index 8d9e88b653..78bec947ef 100644 --- a/docs/dyn/agentidentity_v1alpha.projects.locations.html +++ b/docs/dyn/agentidentity_v1alpha.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1beta.html b/docs/dyn/agentidentity_v1beta.html index f9c17ad752..cbc491d496 100644 --- a/docs/dyn/agentidentity_v1beta.html +++ b/docs/dyn/agentidentity_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentity_v1beta.projects.locations.accessSummaries.html b/docs/dyn/agentidentity_v1beta.projects.locations.accessSummaries.html index f5934b65b5..af9c5bb90d 100644 --- a/docs/dyn/agentidentity_v1beta.projects.locations.accessSummaries.html +++ b/docs/dyn/agentidentity_v1beta.projects.locations.accessSummaries.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists access summaries in a given project and location. Supported filters: - `workload_id`: Filter by the SPIFFE ID of the agent. Example: `workload_id="spiffe://example.com/ns/default/sa/my-agent"`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1beta.projects.locations.authProviders.authorizations.html b/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.authorizations.html index 6268456a4b..51c30f052c 100644 --- a/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.authorizations.html +++ b/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.authorizations.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists authorizations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -179,17 +179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentity_v1beta.projects.locations.authProviders.html b/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.html index f6306b2853..b9446a7de5 100644 --- a/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.html +++ b/docs/dyn/agentidentity_v1beta.projects.locations.authProviders.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists auth providers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -116,10 +116,10 @@

Instance Methods

queryWorkloads(name, pageSize=None, pageToken=None, x__xgafv=None)

Queries which workloads are using a given auth provider.

- queryWorkloads_next(previous_request, previous_response)

+ queryWorkloads_next()

Retrieves the next page of results.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

revokeAuthorization(name, body=None, x__xgafv=None)

@@ -572,17 +572,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -741,31 +741,31 @@

Method Details

- queryWorkloads_next(previous_request, previous_response) + queryWorkloads_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)
+        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.
-
+ 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. +
- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentidentity_v1beta.projects.locations.html b/docs/dyn/agentidentity_v1beta.projects.locations.html index aa7457eaff..cbc7a20c49 100644 --- a/docs/dyn/agentidentity_v1beta.projects.locations.html +++ b/docs/dyn/agentidentity_v1beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentidentitycredentials_v1.html b/docs/dyn/agentidentitycredentials_v1.html index a7197a6197..7d0c9d5fef 100644 --- a/docs/dyn/agentidentitycredentials_v1.html +++ b/docs/dyn/agentidentitycredentials_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentitycredentials_v1alpha.html b/docs/dyn/agentidentitycredentials_v1alpha.html index a4a8882a31..0955016f80 100644 --- a/docs/dyn/agentidentitycredentials_v1alpha.html +++ b/docs/dyn/agentidentitycredentials_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentidentitycredentials_v1beta.html b/docs/dyn/agentidentitycredentials_v1beta.html index d9bf30a77e..5bda841e3c 100644 --- a/docs/dyn/agentidentitycredentials_v1beta.html +++ b/docs/dyn/agentidentitycredentials_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentregistry_v1.html b/docs/dyn/agentregistry_v1.html index 1ec1098e5b..3a8c9970e2 100644 --- a/docs/dyn/agentregistry_v1.html +++ b/docs/dyn/agentregistry_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentregistry_v1.projects.locations.agents.html b/docs/dyn/agentregistry_v1.projects.locations.agents.html index 7709618dde..f0f6f0ca83 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.agents.html +++ b/docs/dyn/agentregistry_v1.projects.locations.agents.html @@ -84,13 +84,13 @@

Instance Methods

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

Lists Agents in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, body=None, x__xgafv=None)

Searches Agents in a given project and location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -325,17 +325,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1.projects.locations.bindings.html b/docs/dyn/agentregistry_v1.projects.locations.bindings.html index 0e3fe1db1c..542a14053a 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.bindings.html +++ b/docs/dyn/agentregistry_v1.projects.locations.bindings.html @@ -87,7 +87,7 @@

Instance Methods

fetchAvailable(parent, pageSize=None, pageToken=None, sourceIdentifier=None, targetIdentifier=None, x__xgafv=None)

Fetches available Bindings.

- fetchAvailable_next(previous_request, previous_response)

+ fetchAvailable_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

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

Lists Bindings in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -250,17 +250,17 @@

Method Details

- fetchAvailable_next(previous_request, previous_response) + fetchAvailable_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)
+        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.
-
+ 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. +
@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentregistry_v1.projects.locations.endpoints.html b/docs/dyn/agentregistry_v1.projects.locations.endpoints.html index 1ddb3b74c4..a96237231e 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.endpoints.html +++ b/docs/dyn/agentregistry_v1.projects.locations.endpoints.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Endpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1.projects.locations.html b/docs/dyn/agentregistry_v1.projects.locations.html index 30764f03ff..caa975bee3 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.html +++ b/docs/dyn/agentregistry_v1.projects.locations.html @@ -119,7 +119,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1.projects.locations.mcpServers.html b/docs/dyn/agentregistry_v1.projects.locations.mcpServers.html index cf038b3c82..0445c7736c 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.mcpServers.html +++ b/docs/dyn/agentregistry_v1.projects.locations.mcpServers.html @@ -84,13 +84,13 @@

Instance Methods

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

Lists McpServers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, body=None, x__xgafv=None)

Searches McpServers in a given project and location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -280,17 +280,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1.projects.locations.operations.html b/docs/dyn/agentregistry_v1.projects.locations.operations.html index 6b89ab64db..9e316867d1 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.operations.html +++ b/docs/dyn/agentregistry_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1.projects.locations.services.html b/docs/dyn/agentregistry_v1.projects.locations.services.html index 5818ce7fd7..8b74c9ede4 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.services.html +++ b/docs/dyn/agentregistry_v1.projects.locations.services.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Services in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentregistry_v1alpha.html b/docs/dyn/agentregistry_v1alpha.html index 613ad352ad..c0fc2128cc 100644 --- a/docs/dyn/agentregistry_v1alpha.html +++ b/docs/dyn/agentregistry_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/agentregistry_v1alpha.projects.locations.agents.html b/docs/dyn/agentregistry_v1alpha.projects.locations.agents.html index 16eef2aac2..c0b5cef08d 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.agents.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.agents.html @@ -84,13 +84,13 @@

Instance Methods

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

Lists Agents in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, body=None, x__xgafv=None)

Searches Agents in a given project and location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -325,17 +325,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.bindings.html b/docs/dyn/agentregistry_v1alpha.projects.locations.bindings.html index ff42f302ba..628cd896da 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.bindings.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.bindings.html @@ -87,7 +87,7 @@

Instance Methods

fetchAvailable(parent, pageSize=None, pageToken=None, sourceIdentifier=None, targetIdentifier=None, x__xgafv=None)

Fetches available Bindings.

- fetchAvailable_next(previous_request, previous_response)

+ fetchAvailable_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

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

Lists Bindings in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -250,17 +250,17 @@

Method Details

- fetchAvailable_next(previous_request, previous_response) + fetchAvailable_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)
+        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.
-
+ 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. +
@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentregistry_v1alpha.projects.locations.endpoints.html b/docs/dyn/agentregistry_v1alpha.projects.locations.endpoints.html index 70fdae65c5..37c968664b 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.endpoints.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.endpoints.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Endpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.html b/docs/dyn/agentregistry_v1alpha.projects.locations.html index 5f1e707216..afd64e3b66 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.html @@ -129,7 +129,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -201,17 +201,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.mcpServers.html b/docs/dyn/agentregistry_v1alpha.projects.locations.mcpServers.html index 57ccc09bc1..977b399dde 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.mcpServers.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.mcpServers.html @@ -84,13 +84,13 @@

Instance Methods

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

Lists McpServers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, body=None, x__xgafv=None)

Searches McpServers in a given project and location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -280,17 +280,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.operations.html b/docs/dyn/agentregistry_v1alpha.projects.locations.operations.html index eede05b82b..6697727e9b 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.operations.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.publishers.html b/docs/dyn/agentregistry_v1alpha.projects.locations.publishers.html index 51c1039a73..d60085930c 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.publishers.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.publishers.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all Publishers in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/agentregistry_v1alpha.projects.locations.services.html b/docs/dyn/agentregistry_v1alpha.projects.locations.services.html index 52053953d5..655d7af29e 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.services.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.services.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Services in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentregistry_v1alpha.projects.locations.skills.html b/docs/dyn/agentregistry_v1alpha.projects.locations.skills.html index 839ec6dc93..2525ea365e 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.skills.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.skills.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists logical Skills available in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -110,7 +110,7 @@

Instance Methods

search(parent, filter=None, pageSize=None, pageToken=None, searchString=None, searchType=None, x__xgafv=None)

Custom deep-search method to filter by frontmatter or query SKILL.md text blobs.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

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

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -632,17 +632,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/agentregistry_v1alpha.projects.locations.skills.revisions.html b/docs/dyn/agentregistry_v1alpha.projects.locations.skills.revisions.html index 149adaf09b..838ade25b4 100644 --- a/docs/dyn/agentregistry_v1alpha.projects.locations.skills.revisions.html +++ b/docs/dyn/agentregistry_v1alpha.projects.locations.skills.revisions.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists all revisions belonging to a parent Skill.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.batchPredictionJobs.html b/docs/dyn/aiplatform_v1.batchPredictionJobs.html index 9346e51cad..5279a20762 100644 --- a/docs/dyn/aiplatform_v1.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1.batchPredictionJobs.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists BatchPredictionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1597,17 +1597,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.customJobs.operations.html b/docs/dyn/aiplatform_v1.customJobs.operations.html index a761becd56..0b13c183d9 100644 --- a/docs/dyn/aiplatform_v1.customJobs.operations.html +++ b/docs/dyn/aiplatform_v1.customJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.dataLabelingJobs.operations.html b/docs/dyn/aiplatform_v1.dataLabelingJobs.operations.html index dc7a39afe5..694e5d1c55 100644 --- a/docs/dyn/aiplatform_v1.dataLabelingJobs.operations.html +++ b/docs/dyn/aiplatform_v1.dataLabelingJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.annotationSpecs.operations.html b/docs/dyn/aiplatform_v1.datasets.annotationSpecs.operations.html index efedddcbd9..c41ca7a1cb 100644 --- a/docs/dyn/aiplatform_v1.datasets.annotationSpecs.operations.html +++ b/docs/dyn/aiplatform_v1.datasets.annotationSpecs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.dataItems.annotations.operations.html b/docs/dyn/aiplatform_v1.datasets.dataItems.annotations.operations.html index e94821bd9d..e3091fc731 100644 --- a/docs/dyn/aiplatform_v1.datasets.dataItems.annotations.operations.html +++ b/docs/dyn/aiplatform_v1.datasets.dataItems.annotations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.dataItems.operations.html b/docs/dyn/aiplatform_v1.datasets.dataItems.operations.html index c9d389a9a2..5ce2ebf6f6 100644 --- a/docs/dyn/aiplatform_v1.datasets.dataItems.operations.html +++ b/docs/dyn/aiplatform_v1.datasets.dataItems.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.datasetVersions.html b/docs/dyn/aiplatform_v1.datasets.datasetVersions.html index 6a9ae68ed5..c91744519f 100644 --- a/docs/dyn/aiplatform_v1.datasets.datasetVersions.html +++ b/docs/dyn/aiplatform_v1.datasets.datasetVersions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DatasetVersions in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.html b/docs/dyn/aiplatform_v1.datasets.html index addc2e038d..ef02f62119 100644 --- a/docs/dyn/aiplatform_v1.datasets.html +++ b/docs/dyn/aiplatform_v1.datasets.html @@ -115,7 +115,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, parent=None, readMask=None, x__xgafv=None)

Lists Datasets in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -349,17 +349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.operations.html b/docs/dyn/aiplatform_v1.datasets.operations.html index 14b006a18d..0ba9dff9de 100644 --- a/docs/dyn/aiplatform_v1.datasets.operations.html +++ b/docs/dyn/aiplatform_v1.datasets.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.datasets.savedQueries.operations.html b/docs/dyn/aiplatform_v1.datasets.savedQueries.operations.html index ca141027c3..efa7d5d0c6 100644 --- a/docs/dyn/aiplatform_v1.datasets.savedQueries.operations.html +++ b/docs/dyn/aiplatform_v1.datasets.savedQueries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.deploymentResourcePools.operations.html b/docs/dyn/aiplatform_v1.deploymentResourcePools.operations.html index 3bf8bad93f..5b238b4c3b 100644 --- a/docs/dyn/aiplatform_v1.deploymentResourcePools.operations.html +++ b/docs/dyn/aiplatform_v1.deploymentResourcePools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.endpoints.operations.html b/docs/dyn/aiplatform_v1.endpoints.operations.html index 040a671259..0667628ca6 100644 --- a/docs/dyn/aiplatform_v1.endpoints.operations.html +++ b/docs/dyn/aiplatform_v1.endpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featureGroups.features.operations.html b/docs/dyn/aiplatform_v1.featureGroups.features.operations.html index 14ef3b140a..1bb4debc0f 100644 --- a/docs/dyn/aiplatform_v1.featureGroups.features.operations.html +++ b/docs/dyn/aiplatform_v1.featureGroups.features.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featureGroups.operations.html b/docs/dyn/aiplatform_v1.featureGroups.operations.html index f44d17c477..3cc5d806d2 100644 --- a/docs/dyn/aiplatform_v1.featureGroups.operations.html +++ b/docs/dyn/aiplatform_v1.featureGroups.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featureOnlineStores.featureViews.operations.html b/docs/dyn/aiplatform_v1.featureOnlineStores.featureViews.operations.html index 989509fc9d..82d68b90bd 100644 --- a/docs/dyn/aiplatform_v1.featureOnlineStores.featureViews.operations.html +++ b/docs/dyn/aiplatform_v1.featureOnlineStores.featureViews.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featureOnlineStores.operations.html b/docs/dyn/aiplatform_v1.featureOnlineStores.operations.html index d37d9ca9f4..fd0bba2b89 100644 --- a/docs/dyn/aiplatform_v1.featureOnlineStores.operations.html +++ b/docs/dyn/aiplatform_v1.featureOnlineStores.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featurestores.entityTypes.features.operations.html b/docs/dyn/aiplatform_v1.featurestores.entityTypes.features.operations.html index 87aff4bf52..6025d56b79 100644 --- a/docs/dyn/aiplatform_v1.featurestores.entityTypes.features.operations.html +++ b/docs/dyn/aiplatform_v1.featurestores.entityTypes.features.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featurestores.entityTypes.operations.html b/docs/dyn/aiplatform_v1.featurestores.entityTypes.operations.html index 6574e87f50..5371ff268c 100644 --- a/docs/dyn/aiplatform_v1.featurestores.entityTypes.operations.html +++ b/docs/dyn/aiplatform_v1.featurestores.entityTypes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.featurestores.operations.html b/docs/dyn/aiplatform_v1.featurestores.operations.html index af597c8785..2e9696b524 100644 --- a/docs/dyn/aiplatform_v1.featurestores.operations.html +++ b/docs/dyn/aiplatform_v1.featurestores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.html b/docs/dyn/aiplatform_v1.html index 0d30919da5..cb0187e269 100644 --- a/docs/dyn/aiplatform_v1.html +++ b/docs/dyn/aiplatform_v1.html @@ -283,7 +283,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -292,20 +292,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/aiplatform_v1.hyperparameterTuningJobs.operations.html b/docs/dyn/aiplatform_v1.hyperparameterTuningJobs.operations.html index 67c858061e..f1ab8798d5 100644 --- a/docs/dyn/aiplatform_v1.hyperparameterTuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1.hyperparameterTuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.indexEndpoints.operations.html b/docs/dyn/aiplatform_v1.indexEndpoints.operations.html index 84a3e633ba..5d0aee2344 100644 --- a/docs/dyn/aiplatform_v1.indexEndpoints.operations.html +++ b/docs/dyn/aiplatform_v1.indexEndpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.indexes.operations.html b/docs/dyn/aiplatform_v1.indexes.operations.html index 24e79d254d..4bf696638c 100644 --- a/docs/dyn/aiplatform_v1.indexes.operations.html +++ b/docs/dyn/aiplatform_v1.indexes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.memoryBanks.memories.operations.html b/docs/dyn/aiplatform_v1.memoryBanks.memories.operations.html index 70ed22f58a..5610814fe9 100644 --- a/docs/dyn/aiplatform_v1.memoryBanks.memories.operations.html +++ b/docs/dyn/aiplatform_v1.memoryBanks.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.memoryBanks.operations.html b/docs/dyn/aiplatform_v1.memoryBanks.operations.html index 38afd516b0..627ed4787a 100644 --- a/docs/dyn/aiplatform_v1.memoryBanks.operations.html +++ b/docs/dyn/aiplatform_v1.memoryBanks.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.metadataStores.artifacts.operations.html b/docs/dyn/aiplatform_v1.metadataStores.artifacts.operations.html index 0bd0dc51fc..24f1a676ab 100644 --- a/docs/dyn/aiplatform_v1.metadataStores.artifacts.operations.html +++ b/docs/dyn/aiplatform_v1.metadataStores.artifacts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.metadataStores.contexts.operations.html b/docs/dyn/aiplatform_v1.metadataStores.contexts.operations.html index 4fda67a798..da0c878e73 100644 --- a/docs/dyn/aiplatform_v1.metadataStores.contexts.operations.html +++ b/docs/dyn/aiplatform_v1.metadataStores.contexts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.metadataStores.executions.operations.html b/docs/dyn/aiplatform_v1.metadataStores.executions.operations.html index 032eb12ddb..abfce6ca1f 100644 --- a/docs/dyn/aiplatform_v1.metadataStores.executions.operations.html +++ b/docs/dyn/aiplatform_v1.metadataStores.executions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.metadataStores.operations.html b/docs/dyn/aiplatform_v1.metadataStores.operations.html index fab3f80ae7..88d3889a58 100644 --- a/docs/dyn/aiplatform_v1.metadataStores.operations.html +++ b/docs/dyn/aiplatform_v1.metadataStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.migratableResources.operations.html b/docs/dyn/aiplatform_v1.migratableResources.operations.html index bd205ada30..de4fd001c0 100644 --- a/docs/dyn/aiplatform_v1.migratableResources.operations.html +++ b/docs/dyn/aiplatform_v1.migratableResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.modelDeploymentMonitoringJobs.operations.html b/docs/dyn/aiplatform_v1.modelDeploymentMonitoringJobs.operations.html index 41015662e3..3b5ca1570e 100644 --- a/docs/dyn/aiplatform_v1.modelDeploymentMonitoringJobs.operations.html +++ b/docs/dyn/aiplatform_v1.modelDeploymentMonitoringJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.models.evaluations.operations.html b/docs/dyn/aiplatform_v1.models.evaluations.operations.html index 596a988eb8..e1e2e086d7 100644 --- a/docs/dyn/aiplatform_v1.models.evaluations.operations.html +++ b/docs/dyn/aiplatform_v1.models.evaluations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.models.operations.html b/docs/dyn/aiplatform_v1.models.operations.html index c35c8b799f..d9d5714e56 100644 --- a/docs/dyn/aiplatform_v1.models.operations.html +++ b/docs/dyn/aiplatform_v1.models.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.notebookExecutionJobs.operations.html b/docs/dyn/aiplatform_v1.notebookExecutionJobs.operations.html index 1ca278c07c..6e8c41d9dc 100644 --- a/docs/dyn/aiplatform_v1.notebookExecutionJobs.operations.html +++ b/docs/dyn/aiplatform_v1.notebookExecutionJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.notebookRuntimeTemplates.operations.html b/docs/dyn/aiplatform_v1.notebookRuntimeTemplates.operations.html index f100f351b8..16db5c8b36 100644 --- a/docs/dyn/aiplatform_v1.notebookRuntimeTemplates.operations.html +++ b/docs/dyn/aiplatform_v1.notebookRuntimeTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.notebookRuntimes.operations.html b/docs/dyn/aiplatform_v1.notebookRuntimes.operations.html index 59ef99c2c1..4105223135 100644 --- a/docs/dyn/aiplatform_v1.notebookRuntimes.operations.html +++ b/docs/dyn/aiplatform_v1.notebookRuntimes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.onlineEvaluators.operations.html b/docs/dyn/aiplatform_v1.onlineEvaluators.operations.html index ac188b0a56..f0987c139d 100644 --- a/docs/dyn/aiplatform_v1.onlineEvaluators.operations.html +++ b/docs/dyn/aiplatform_v1.onlineEvaluators.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.operations.html b/docs/dyn/aiplatform_v1.operations.html index a292fcb25c..7cde768be4 100644 --- a/docs/dyn/aiplatform_v1.operations.html +++ b/docs/dyn/aiplatform_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.persistentResources.operations.html b/docs/dyn/aiplatform_v1.persistentResources.operations.html index 9a0bf6dd45..9f1f16d54a 100644 --- a/docs/dyn/aiplatform_v1.persistentResources.operations.html +++ b/docs/dyn/aiplatform_v1.persistentResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.pipelineJobs.operations.html b/docs/dyn/aiplatform_v1.pipelineJobs.operations.html index be06e3cca4..d2d8c8f70b 100644 --- a/docs/dyn/aiplatform_v1.pipelineJobs.operations.html +++ b/docs/dyn/aiplatform_v1.pipelineJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.agents.html b/docs/dyn/aiplatform_v1.projects.locations.agents.html index 061cf4a5c6..91cc40f172 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.agents.html +++ b/docs/dyn/aiplatform_v1.projects.locations.agents.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists the agents in a location that belong to the caller. An agent belongs to the end user recorded as its owner when it was created, so the response holds that caller's agents and no others. It is empty for a caller that is not an end user, and an agent with no recorded owner is listed for nobody.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html b/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html index bf99f7e88e..69ce8f6c79 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists BatchPredictionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1662,17 +1662,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.cachedContents.html b/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html index fb9e11e9dd..37e539bcbd 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html +++ b/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists cached contents in a project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1967,17 +1967,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.customJobs.html b/docs/dyn/aiplatform_v1.projects.locations.customJobs.html index e441dcbef0..795faf83b1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.customJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.customJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists CustomJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -767,17 +767,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.customJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.customJobs.operations.html index 675c89fef2..2a1b12d24d 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.customJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.customJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.html b/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.html index 13174a6798..226c4c8e57 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DataLabelingJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -440,17 +440,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.dataLabelingJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.operations.html index dc9cf2d9c6..a407b54424 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.dataLabelingJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.annotationSpecs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.annotationSpecs.operations.html index f4a9771636..de6600f6c1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.annotationSpecs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.annotationSpecs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.html index 0fc681ed83..c649a159fa 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Annotations belongs to a dataitem.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.datasets.dataItems.annotations.operations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.operations.html index 02b366e359..b88f28ac47 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.annotations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.html index d38a4c69c5..1c1ac0bba2 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.html @@ -91,7 +91,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DataItems in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -138,17 +138,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.datasets.dataItems.operations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.operations.html index 3b054df5d4..da3494325c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.dataItems.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.datasetVersions.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.datasetVersions.html index b2725c5596..7a33e16526 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.datasetVersions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.datasetVersions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DatasetVersions in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.html index 72e1e6c4d1..9b1cd98517 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.html @@ -124,7 +124,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Datasets in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -133,7 +133,7 @@

Instance Methods

searchDataItems(dataset, annotationFilters=None, annotationsFilter=None, annotationsLimit=None, dataItemFilter=None, dataLabelingJob=None, fieldMask=None, orderBy=None, orderByAnnotation_orderBy=None, orderByAnnotation_savedQuery=None, orderByDataItem=None, pageSize=None, pageToken=None, savedQuery=None, x__xgafv=None)

Searches DataItems in a Dataset.

- searchDataItems_next(previous_request, previous_response)

+ searchDataItems_next()

Retrieves the next page of results.

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

@@ -522,17 +522,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -694,17 +694,17 @@

Method Details

- searchDataItems_next(previous_request, previous_response) + searchDataItems_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.operations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.operations.html index 6454169539..782d5d35d0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.html index 3b6aace302..660f1f8432 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists SavedQueries in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.datasets.savedQueries.operations.html b/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.operations.html index 4eaa1d1293..c1c399ab58 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.datasets.savedQueries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html index 971d47eb93..9307f7e8d4 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html +++ b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html @@ -95,7 +95,7 @@

Instance Methods

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

List DeploymentResourcePools in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -104,7 +104,7 @@

Instance Methods

queryDeployedModels(deploymentResourcePool, pageSize=None, pageToken=None, x__xgafv=None)

List DeployedModels that have been deployed on this DeploymentResourcePool.

- queryDeployedModels_next(previous_request, previous_response)

+ queryDeployedModels_next()

Retrieves the next page of results.

Method Details

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -641,17 +641,17 @@

Method Details

- queryDeployedModels_next(previous_request, previous_response) + queryDeployedModels_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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.deploymentResourcePools.operations.html b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.operations.html index ab85ebc615..be2eb52c7c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html index 879e1024fa..572ad3cef8 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html @@ -149,7 +149,7 @@

Instance Methods

list(parent, filter=None, gdcZone=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Endpoints in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mutateDeployedModel(endpoint, body=None, x__xgafv=None)

@@ -3317,17 +3317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.endpoints.operations.html b/docs/dyn/aiplatform_v1.projects.locations.endpoints.operations.html index edc13feae5..05e71d6cdf 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.endpoints.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.endpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html b/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html index 769b646b52..47196d9b41 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html +++ b/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Evaluation Items.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -15587,17 +15587,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.evaluationMetrics.html b/docs/dyn/aiplatform_v1.projects.locations.evaluationMetrics.html index 31bcfdf048..b4e72b033b 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.evaluationMetrics.html +++ b/docs/dyn/aiplatform_v1.projects.locations.evaluationMetrics.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists EvaluationMetrics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1940,17 +1940,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.evaluationRuns.html b/docs/dyn/aiplatform_v1.projects.locations.evaluationRuns.html index a589dce8b7..ece3d4b723 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.evaluationRuns.html +++ b/docs/dyn/aiplatform_v1.projects.locations.evaluationRuns.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Evaluation Runs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -9034,17 +9034,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.evaluationSets.html b/docs/dyn/aiplatform_v1.projects.locations.evaluationSets.html index 3d4fd65494..ef6ca0766f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.evaluationSets.html +++ b/docs/dyn/aiplatform_v1.projects.locations.evaluationSets.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Evaluation Sets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1577,17 +1577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.html b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.html index d05ce58c1c..d49a25f4c9 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, latestStatsCount=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Features in a given FeatureGroup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.operations.html index e8776a7744..e18c1e0c30 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.features.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.html b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.html index 9325216e06..1684ffbba5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists FeatureGroups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -348,17 +348,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.operations.html index 11076c52b6..e53ff3108c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureGroups.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureGroups.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html index a6379428a2..2f9a49fa1a 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists FeatureViewSyncs in a given FeatureView.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -182,17 +182,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.html b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.html index a8816fc60f..05a75fab11 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.html @@ -112,7 +112,7 @@

Instance Methods

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

Lists FeatureViews in a given FeatureOnlineStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -687,17 +687,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.operations.html index 481472f149..b22fdb5d40 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.featureViews.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.html b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.html index 2a40aaa740..af3b46fc44 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists FeatureOnlineStores in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -429,17 +429,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.operations.html index 7de4507f6d..576754b07c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featureOnlineStores.operations.html @@ -87,7 +87,7 @@

Instance Methods

listWait(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- listWait_next(previous_request, previous_response)

+ listWait_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- listWait_next(previous_request, previous_response) + listWait_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.html index 1613217b03..1a48b15fa4 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, latestStatsCount=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Features in a given EntityType.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.operations.html index cda5fd7914..a194799886 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.features.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.html index 6ad1391b3c..b1a7b06de8 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.html @@ -112,7 +112,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists EntityTypes in a given Featurestore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -596,17 +596,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.operations.html index c5206d1ad5..6c9b1352a4 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.entityTypes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.html index bf892aa32c..15559c193c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Featurestores in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -115,7 +115,7 @@

Instance Methods

searchFeatures(location, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches Features matching a query in a given project.

- searchFeatures_next(previous_request, previous_response)

+ searchFeatures_next()

Retrieves the next page of results.

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

@@ -445,17 +445,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -575,17 +575,17 @@

Method Details

- searchFeatures_next(previous_request, previous_response) + searchFeatures_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.featurestores.operations.html b/docs/dyn/aiplatform_v1.projects.locations.featurestores.operations.html index 551117e35c..7dbf425f20 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.featurestores.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.featurestores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.html b/docs/dyn/aiplatform_v1.projects.locations.html index 1087e8b37f..19b2efa2a5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.html @@ -353,7 +353,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

retrieveContexts(parent, body=None, x__xgafv=None)

@@ -9281,17 +9281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.html b/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.html index f8adcbe4c2..9ba62722bc 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists HyperparameterTuningJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1307,17 +1307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.hyperparameterTuningJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.operations.html index 60315b3cc8..ece9b6a619 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.hyperparameterTuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.html b/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.html index 101f9e7f51..b7805bff44 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.html +++ b/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists IndexEndpoints in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mutateDeployedIndex(indexEndpoint, body=None, updateMask=None, x__xgafv=None)

@@ -823,17 +823,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.operations.html b/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.operations.html index 01d1a0bc38..64ec3f5deb 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.indexEndpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.indexes.html b/docs/dyn/aiplatform_v1.projects.locations.indexes.html index 8c4cfd234a..aad4c3299f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.indexes.html +++ b/docs/dyn/aiplatform_v1.projects.locations.indexes.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Indexes in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -321,17 +321,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.indexes.operations.html b/docs/dyn/aiplatform_v1.projects.locations.indexes.operations.html index 4978a52f1c..d9566d4b1f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.indexes.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.indexes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html index 1538e84b6d..e5b1f069f7 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html @@ -103,7 +103,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -521,17 +521,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.operations.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.operations.html index db5c204272..f7830c0bf0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.revisions.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.revisions.html index 5050054a52..8ffbb5f7fe 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.revisions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.memoryBanks.operations.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.operations.html index 200ec9af46..297420b2a1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.html index ec1aea31c6..626a3be808 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Artifacts in the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.operations.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.operations.html index bca7be24a7..375858b774 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.artifacts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.html index 61fe398c70..aeb1672389 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists Contexts on the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -354,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.operations.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.operations.html index 40393b7d47..9fb96263a0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.contexts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.html index 9a28865050..46e2b03b8e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Executions in the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -317,17 +317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.operations.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.operations.html index ab396f2f79..0f61d1cc11 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.executions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.html index 24178ebae2..411f726300 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.html @@ -115,7 +115,7 @@

Instance Methods

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

Lists MetadataStores for a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.metadataStores.metadataSchemas.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.metadataSchemas.html index 2e407d6b28..c5bd74ffa1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.metadataSchemas.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.metadataSchemas.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists MetadataSchemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -189,17 +189,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.metadataStores.operations.html b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.operations.html index cf1ae5c7ba..056ba828ac 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.metadataStores.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.metadataStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.migratableResources.html b/docs/dyn/aiplatform_v1.projects.locations.migratableResources.html index ffa4f7b01d..f0883069b0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.migratableResources.html +++ b/docs/dyn/aiplatform_v1.projects.locations.migratableResources.html @@ -89,7 +89,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and ml.googleapis.com that can be migrated to Vertex AI's given location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.migratableResources.operations.html b/docs/dyn/aiplatform_v1.projects.locations.migratableResources.operations.html index 4588978a39..95aa979c37 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.migratableResources.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.migratableResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.html b/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.html index 560a9a36b3..50ae2bbe52 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists ModelDeploymentMonitoringJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -110,7 +110,7 @@

Instance Methods

searchModelDeploymentMonitoringStatsAnomalies(modelDeploymentMonitoringJob, body=None, x__xgafv=None)

Searches Model Monitoring Statistics generated within a given time window.

- searchModelDeploymentMonitoringStatsAnomalies_next(previous_request, previous_response)

+ searchModelDeploymentMonitoringStatsAnomalies_next()

Retrieves the next page of results.

Method Details

@@ -783,17 +783,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1099,17 +1099,17 @@

Method Details

- searchModelDeploymentMonitoringStatsAnomalies_next(previous_request, previous_response) + searchModelDeploymentMonitoringStatsAnomalies_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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.operations.html index c7babfa4e3..c90f11e2b4 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.modelDeploymentMonitoringJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.html b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.html index 8f33578649..cad70f0a5e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists ModelEvaluations in a Model.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -733,17 +733,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.models.evaluations.operations.html b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.operations.html index 0bb7b3e29c..e5255dae77 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.slices.html b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.slices.html index 1aa016cc2d..f849c97152 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.slices.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.evaluations.slices.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists ModelEvaluationSlices in a ModelEvaluation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.models.html b/docs/dyn/aiplatform_v1.projects.locations.models.html index bbbfd54c73..ebbb0835c2 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.html @@ -112,16 +112,16 @@

Instance Methods

listCheckpoints(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists checkpoints of the specified model version.

- listCheckpoints_next(previous_request, previous_response)

+ listCheckpoints_next()

Retrieves the next page of results.

listVersions(name, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists versions of the specified model.

- listVersions_next(previous_request, previous_response)

+ listVersions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mergeVersionAliases(name, body=None, x__xgafv=None)

@@ -1071,17 +1071,17 @@

Method Details

- listCheckpoints_next(previous_request, previous_response) + listCheckpoints_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)
+        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.
-
+ 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. +
@@ -1436,31 +1436,31 @@

Method Details

- listVersions_next(previous_request, previous_response) + listVersions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.models.operations.html b/docs/dyn/aiplatform_v1.projects.locations.models.operations.html index 51e9fe57cd..faf7cdce60 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.nasJobs.html b/docs/dyn/aiplatform_v1.projects.locations.nasJobs.html index 0c28f30c08..7910881193 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.nasJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.nasJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists NasJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1423,17 +1423,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.nasJobs.nasTrialDetails.html b/docs/dyn/aiplatform_v1.projects.locations.nasJobs.nasTrialDetails.html index 8c51998ebf..543751e004 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.nasJobs.nasTrialDetails.html +++ b/docs/dyn/aiplatform_v1.projects.locations.nasJobs.nasTrialDetails.html @@ -84,7 +84,7 @@

Instance Methods

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

List top NasTrialDetails of a NasJob.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.notebookExecutionJobs.html b/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.html index 56dc0e96ab..47f593c76c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists NotebookExecutionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -473,17 +473,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.notebookExecutionJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.operations.html index 050ca1ed95..21a8cd849a 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookExecutionJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.html b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.html index d4f82b3ecf..88ed64245f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists NotebookRuntimeTemplates in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -502,17 +502,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.operations.html b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.operations.html index cf933570b3..196334a314 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimeTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.html b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.html index 72dff7dfd2..b7baabec54 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists NotebookRuntimes in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

start(name, body=None, x__xgafv=None)

@@ -497,17 +497,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.operations.html b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.operations.html index 3a397c77ad..2a711962a5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.notebookRuntimes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html index c021257f92..6079173fb9 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html +++ b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists the OnlineEvaluators for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1781,17 +1781,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.operations.html b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.operations.html index 854144322f..70486d4066 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.operations.html b/docs/dyn/aiplatform_v1.projects.locations.operations.html index 4d5e305ea6..e205401335 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.persistentResources.html b/docs/dyn/aiplatform_v1.projects.locations.persistentResources.html index 86cf67618a..cfce4cf343 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.persistentResources.html +++ b/docs/dyn/aiplatform_v1.projects.locations.persistentResources.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists PersistentResources in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.persistentResources.operations.html b/docs/dyn/aiplatform_v1.projects.locations.persistentResources.operations.html index 0285434284..53b0c9a03f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.persistentResources.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.persistentResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.html b/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.html index cd03549814..4bfdff1584 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists PipelineJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1227,17 +1227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.pipelineJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.operations.html index 5e26f66de5..e8175ef44b 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.pipelineJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.html b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.html index 1bff5183d0..c80be923d0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.html +++ b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists RagCorpora in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -373,17 +373,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.operations.html b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.operations.html index 0d1fd52997..0f72596581 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.html b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.html index 8345623806..aa28d0023e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.html +++ b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists RagFiles in a RagCorpus.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -481,17 +481,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.ragCorpora.ragFiles.operations.html b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.operations.html index 9ebf465ee0..2f13139993 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.ragCorpora.ragFiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.ragEngineConfig.operations.html b/docs/dyn/aiplatform_v1.projects.locations.ragEngineConfig.operations.html index ccb11655ca..d3737750a8 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.ragEngineConfig.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.ragEngineConfig.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html index 695b9d568a..958eefac13 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html @@ -137,7 +137,7 @@

Instance Methods

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

Lists reasoning engines in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1268,17 +1268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html index 5494446479..ad1bd21b28 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html @@ -106,7 +106,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -690,17 +690,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.operations.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.operations.html index c93d265011..4e0849a0db 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.revisions.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.revisions.html index 695acae49c..2a48ea5b1e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.revisions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.reasoningEngines.operations.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.operations.html index 7cd2bffe9f..4514688398 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html index 5d0461626a..22efcaa1b5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists SandboxEnvironmentSnapshots in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html index 7b6a59ac71..e4ab02a49a 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SandboxEnvironmentTemplates in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -413,17 +413,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironments.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironments.html index 5ce53e9aa8..7630e509ae 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironments.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sandboxEnvironments.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists SandboxEnvironments in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html index 07c1fced1d..0d07ac09d9 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists Events in a given session.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -343,17 +343,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html index 9aab542a07..36658cf848 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html @@ -106,7 +106,7 @@

Instance Methods

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

Lists Sessions in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -578,17 +578,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.operations.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.operations.html index 444e90bc8c..11cfeef2cd 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.schedules.html b/docs/dyn/aiplatform_v1.projects.locations.schedules.html index 7952e8d8f9..f364ef70a9 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.schedules.html +++ b/docs/dyn/aiplatform_v1.projects.locations.schedules.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Schedules in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1561,17 +1561,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.schedules.operations.html b/docs/dyn/aiplatform_v1.projects.locations.schedules.operations.html index e26e2280aa..5f40e266c0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.schedules.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.schedules.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.html b/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.html index 603100acbd..a14e412c8e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.html +++ b/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SemanticGovernancePolicies in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.operations.html b/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.operations.html index d925d14dbf..875abf9b8e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.semanticGovernancePolicies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.servingProfiles.operations.html b/docs/dyn/aiplatform_v1.projects.locations.servingProfiles.operations.html index ea675561ca..b343e098c5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.servingProfiles.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.servingProfiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.skills.operations.html b/docs/dyn/aiplatform_v1.projects.locations.skills.operations.html index 53472aa87c..bdd3fdab1f 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.skills.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.skills.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.specialistPools.html b/docs/dyn/aiplatform_v1.projects.locations.specialistPools.html index 0956442f64..71d9515e50 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.specialistPools.html +++ b/docs/dyn/aiplatform_v1.projects.locations.specialistPools.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists SpecialistPools in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.specialistPools.operations.html b/docs/dyn/aiplatform_v1.projects.locations.specialistPools.operations.html index 2360b346c0..f70851f5e0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.specialistPools.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.specialistPools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.studies.html b/docs/dyn/aiplatform_v1.projects.locations.studies.html index 98dd602473..16db8008c1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.studies.html +++ b/docs/dyn/aiplatform_v1.projects.locations.studies.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists all the studies in a region for an associated project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, body=None, x__xgafv=None)

@@ -585,17 +585,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.studies.operations.html b/docs/dyn/aiplatform_v1.projects.locations.studies.operations.html index cd64419514..8cc96e75c3 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.studies.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.studies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.studies.trials.html b/docs/dyn/aiplatform_v1.projects.locations.studies.trials.html index a376c52e5e..959389c1ac 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.studies.trials.html +++ b/docs/dyn/aiplatform_v1.projects.locations.studies.trials.html @@ -107,7 +107,7 @@

Instance Methods

listOptimalTrials(parent, body=None, x__xgafv=None)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stop(name, body=None, x__xgafv=None)

@@ -619,17 +619,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.studies.trials.operations.html b/docs/dyn/aiplatform_v1.projects.locations.studies.trials.operations.html index 2f582fd7b1..c0df5531f9 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.studies.trials.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.studies.trials.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.taskStores.operations.html b/docs/dyn/aiplatform_v1.projects.locations.taskStores.operations.html index 2cd3aea75f..06712749dd 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.taskStores.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.taskStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.html index 54d70d0bee..91fc0c9801 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardExperiments in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -328,17 +328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.operations.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.operations.html index adea5ac03c..735499873a 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.html index dca819745c..9ccde316a5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardRuns in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -314,17 +314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.operations.html index 57553b5e30..be85b33e8a 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.html index f0b569f479..31f2bd2045 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.html @@ -92,7 +92,7 @@

Instance Methods

exportTensorboardTimeSeries(tensorboardTimeSeries, body=None, x__xgafv=None)

Exports a TensorboardTimeSeries' data. Data is returned in paginated responses.

- exportTensorboardTimeSeries_next(previous_request, previous_response)

+ exportTensorboardTimeSeries_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardTimeSeries in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -257,17 +257,17 @@

Method Details

- exportTensorboardTimeSeries_next(previous_request, previous_response) + exportTensorboardTimeSeries_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)
+        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.
-
+ 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. +
@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html index 15a7a2aa57..ed730025c0 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.html index a9b260d63f..faa34d1c76 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Tensorboards in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.operations.html b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.operations.html index a8e457e41d..3c55201a56 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tensorboards.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tensorboards.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html index 4eddb57eb1..79a9ed1614 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html +++ b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists TrainingPipelines in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1795,17 +1795,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.projects.locations.trainingPipelines.operations.html b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.operations.html index 889cd7acc0..84b168c820 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html index c897119871..79bc23ef9c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists tuning jobs in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

rebaseTunedModel(parent, body=None, x__xgafv=None)

@@ -5511,17 +5511,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.operations.html b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.operations.html index ce88ad6622..d87dbfa0a1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.ragCorpora.operations.html b/docs/dyn/aiplatform_v1.ragCorpora.operations.html index 55cb16058e..f3c8dbb3b4 100644 --- a/docs/dyn/aiplatform_v1.ragCorpora.operations.html +++ b/docs/dyn/aiplatform_v1.ragCorpora.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.ragCorpora.ragFiles.operations.html b/docs/dyn/aiplatform_v1.ragCorpora.ragFiles.operations.html index 05e8f4ef23..c2917ce5a3 100644 --- a/docs/dyn/aiplatform_v1.ragCorpora.ragFiles.operations.html +++ b/docs/dyn/aiplatform_v1.ragCorpora.ragFiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.ragEngineConfig.operations.html b/docs/dyn/aiplatform_v1.ragEngineConfig.operations.html index f19a4c4628..485182f84a 100644 --- a/docs/dyn/aiplatform_v1.ragEngineConfig.operations.html +++ b/docs/dyn/aiplatform_v1.ragEngineConfig.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.html b/docs/dyn/aiplatform_v1.reasoningEngines.html index 4ad8c9c9d5..ed2b30173d 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.html @@ -134,7 +134,7 @@

Instance Methods

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

Lists reasoning engines in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1224,17 +1224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.memories.operations.html b/docs/dyn/aiplatform_v1.reasoningEngines.memories.operations.html index 6fa469bf6d..45c729f796 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.memories.operations.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.operations.html b/docs/dyn/aiplatform_v1.reasoningEngines.operations.html index 04680ba007..865d37e0e2 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.operations.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentSnapshots.html b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentSnapshots.html index 95dcf1c46a..9a09fa3579 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentSnapshots.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentSnapshots.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists SandboxEnvironmentSnapshots in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.reasoningEngines.sandboxEnvironmentTemplates.html b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentTemplates.html index 4ffdea50b4..9391410153 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentTemplates.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironmentTemplates.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SandboxEnvironmentTemplates in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -413,17 +413,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1.reasoningEngines.sandboxEnvironments.html b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironments.html index beeb6a0871..c3cf0f50ab 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironments.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.sandboxEnvironments.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists SandboxEnvironments in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.sessions.operations.html b/docs/dyn/aiplatform_v1.reasoningEngines.sessions.operations.html index 624550d687..cb7d7997a5 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.sessions.operations.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.sessions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.schedules.operations.html b/docs/dyn/aiplatform_v1.schedules.operations.html index 13dda6bc05..1a0252e04c 100644 --- a/docs/dyn/aiplatform_v1.schedules.operations.html +++ b/docs/dyn/aiplatform_v1.schedules.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.semanticGovernancePolicies.operations.html b/docs/dyn/aiplatform_v1.semanticGovernancePolicies.operations.html index 8c46f3e14f..deea417c02 100644 --- a/docs/dyn/aiplatform_v1.semanticGovernancePolicies.operations.html +++ b/docs/dyn/aiplatform_v1.semanticGovernancePolicies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.servingProfiles.operations.html b/docs/dyn/aiplatform_v1.servingProfiles.operations.html index c9e5930004..8e1117122c 100644 --- a/docs/dyn/aiplatform_v1.servingProfiles.operations.html +++ b/docs/dyn/aiplatform_v1.servingProfiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.skills.operations.html b/docs/dyn/aiplatform_v1.skills.operations.html index 739f317e9d..946e3fd6cf 100644 --- a/docs/dyn/aiplatform_v1.skills.operations.html +++ b/docs/dyn/aiplatform_v1.skills.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.specialistPools.operations.html b/docs/dyn/aiplatform_v1.specialistPools.operations.html index 2ffcc17e91..45e499b9ec 100644 --- a/docs/dyn/aiplatform_v1.specialistPools.operations.html +++ b/docs/dyn/aiplatform_v1.specialistPools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.studies.operations.html b/docs/dyn/aiplatform_v1.studies.operations.html index eb29cb4a18..911a6860df 100644 --- a/docs/dyn/aiplatform_v1.studies.operations.html +++ b/docs/dyn/aiplatform_v1.studies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.studies.trials.operations.html b/docs/dyn/aiplatform_v1.studies.trials.operations.html index 89b345c978..e73aa32f00 100644 --- a/docs/dyn/aiplatform_v1.studies.trials.operations.html +++ b/docs/dyn/aiplatform_v1.studies.trials.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.taskStores.operations.html b/docs/dyn/aiplatform_v1.taskStores.operations.html index 58a0dee087..c6b02f3472 100644 --- a/docs/dyn/aiplatform_v1.taskStores.operations.html +++ b/docs/dyn/aiplatform_v1.taskStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.tensorboards.experiments.operations.html b/docs/dyn/aiplatform_v1.tensorboards.experiments.operations.html index ec5534c3f3..26dfc9672e 100644 --- a/docs/dyn/aiplatform_v1.tensorboards.experiments.operations.html +++ b/docs/dyn/aiplatform_v1.tensorboards.experiments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.operations.html b/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.operations.html index a2f902beba..2062d6cb8e 100644 --- a/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.operations.html +++ b/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.timeSeries.operations.html b/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.timeSeries.operations.html index ed6ca3377e..b22523ed4a 100644 --- a/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.timeSeries.operations.html +++ b/docs/dyn/aiplatform_v1.tensorboards.experiments.runs.timeSeries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.tensorboards.operations.html b/docs/dyn/aiplatform_v1.tensorboards.operations.html index 87c3d5e45a..3ff5e794ea 100644 --- a/docs/dyn/aiplatform_v1.tensorboards.operations.html +++ b/docs/dyn/aiplatform_v1.tensorboards.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.trainingPipelines.operations.html b/docs/dyn/aiplatform_v1.trainingPipelines.operations.html index 158c325d3c..50906e165e 100644 --- a/docs/dyn/aiplatform_v1.trainingPipelines.operations.html +++ b/docs/dyn/aiplatform_v1.trainingPipelines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1.tuningJobs.operations.html b/docs/dyn/aiplatform_v1.tuningJobs.operations.html index 75daef1e84..793700b700 100644 --- a/docs/dyn/aiplatform_v1.tuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1.tuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.agents.operations.html b/docs/dyn/aiplatform_v1beta1.agents.operations.html index e6ed0ff8c2..ba0a27ab8e 100644 --- a/docs/dyn/aiplatform_v1beta1.agents.operations.html +++ b/docs/dyn/aiplatform_v1beta1.agents.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.apps.operations.html b/docs/dyn/aiplatform_v1beta1.apps.operations.html index ef81d72649..4bb661ec44 100644 --- a/docs/dyn/aiplatform_v1beta1.apps.operations.html +++ b/docs/dyn/aiplatform_v1beta1.apps.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html b/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html index 5b537e8215..3b8c24e766 100644 --- a/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists BatchPredictionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2145,17 +2145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.customJobs.operations.html b/docs/dyn/aiplatform_v1beta1.customJobs.operations.html index 4c6b9b8ea9..89636ec8d1 100644 --- a/docs/dyn/aiplatform_v1beta1.customJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.customJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.dataLabelingJobs.operations.html b/docs/dyn/aiplatform_v1beta1.dataLabelingJobs.operations.html index 9e8dc88668..7ecedfc253 100644 --- a/docs/dyn/aiplatform_v1beta1.dataLabelingJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.dataLabelingJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.annotationSpecs.operations.html b/docs/dyn/aiplatform_v1beta1.datasets.annotationSpecs.operations.html index b91545b6f3..5e1854b067 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.annotationSpecs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.annotationSpecs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.dataItems.annotations.operations.html b/docs/dyn/aiplatform_v1beta1.datasets.dataItems.annotations.operations.html index 21e3213427..bd861151a4 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.dataItems.annotations.operations.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.dataItems.annotations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.dataItems.operations.html b/docs/dyn/aiplatform_v1beta1.datasets.dataItems.operations.html index 4d0c85c467..55eed99b12 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.dataItems.operations.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.dataItems.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.datasetVersions.html b/docs/dyn/aiplatform_v1beta1.datasets.datasetVersions.html index a8f497bb2c..e90861c5cf 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.datasetVersions.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.datasetVersions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DatasetVersions in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.html b/docs/dyn/aiplatform_v1beta1.datasets.html index 6586ac93b5..1ab4fd0e12 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.html @@ -115,7 +115,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, parent=None, readMask=None, x__xgafv=None)

Lists Datasets in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -349,17 +349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.operations.html b/docs/dyn/aiplatform_v1beta1.datasets.operations.html index 94c0455ebc..1d2777fdc4 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.operations.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.datasets.savedQueries.operations.html b/docs/dyn/aiplatform_v1beta1.datasets.savedQueries.operations.html index 06be19422b..fec79a42bd 100644 --- a/docs/dyn/aiplatform_v1beta1.datasets.savedQueries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.datasets.savedQueries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.deploymentResourcePools.operations.html b/docs/dyn/aiplatform_v1beta1.deploymentResourcePools.operations.html index b72bbc0104..679670cc6e 100644 --- a/docs/dyn/aiplatform_v1beta1.deploymentResourcePools.operations.html +++ b/docs/dyn/aiplatform_v1beta1.deploymentResourcePools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.edgeDevices.operations.html b/docs/dyn/aiplatform_v1beta1.edgeDevices.operations.html index dabf02b419..6c0f303cd8 100644 --- a/docs/dyn/aiplatform_v1beta1.edgeDevices.operations.html +++ b/docs/dyn/aiplatform_v1beta1.edgeDevices.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.endpoints.operations.html b/docs/dyn/aiplatform_v1beta1.endpoints.operations.html index 148ff84fbe..098081b6a7 100644 --- a/docs/dyn/aiplatform_v1beta1.endpoints.operations.html +++ b/docs/dyn/aiplatform_v1beta1.endpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.evaluationItems.operations.html b/docs/dyn/aiplatform_v1beta1.evaluationItems.operations.html index f7f9fd966b..d6c1a1d3be 100644 --- a/docs/dyn/aiplatform_v1beta1.evaluationItems.operations.html +++ b/docs/dyn/aiplatform_v1beta1.evaluationItems.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.evaluationMetrics.operations.html b/docs/dyn/aiplatform_v1beta1.evaluationMetrics.operations.html index 3a9365164b..b4270e4819 100644 --- a/docs/dyn/aiplatform_v1beta1.evaluationMetrics.operations.html +++ b/docs/dyn/aiplatform_v1beta1.evaluationMetrics.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.evaluationRuns.operations.html b/docs/dyn/aiplatform_v1beta1.evaluationRuns.operations.html index accd9d0f11..62125f6b0f 100644 --- a/docs/dyn/aiplatform_v1beta1.evaluationRuns.operations.html +++ b/docs/dyn/aiplatform_v1beta1.evaluationRuns.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.evaluationSets.operations.html b/docs/dyn/aiplatform_v1beta1.evaluationSets.operations.html index 554fdab4af..017ff0b1c8 100644 --- a/docs/dyn/aiplatform_v1beta1.evaluationSets.operations.html +++ b/docs/dyn/aiplatform_v1beta1.evaluationSets.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.evaluationTasks.operations.html b/docs/dyn/aiplatform_v1beta1.evaluationTasks.operations.html index d62eb9da59..634f0a3e03 100644 --- a/docs/dyn/aiplatform_v1beta1.evaluationTasks.operations.html +++ b/docs/dyn/aiplatform_v1beta1.evaluationTasks.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.exampleStores.operations.html b/docs/dyn/aiplatform_v1beta1.exampleStores.operations.html index 87ddca8266..b4ff997dba 100644 --- a/docs/dyn/aiplatform_v1beta1.exampleStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.exampleStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.extensionControllers.operations.html b/docs/dyn/aiplatform_v1beta1.extensionControllers.operations.html index 4a54860a2f..1438c1206a 100644 --- a/docs/dyn/aiplatform_v1beta1.extensionControllers.operations.html +++ b/docs/dyn/aiplatform_v1beta1.extensionControllers.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.extensions.operations.html b/docs/dyn/aiplatform_v1beta1.extensions.operations.html index b542be8f27..35ee8d6b98 100644 --- a/docs/dyn/aiplatform_v1beta1.extensions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.extensions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featureGroups.featureMonitors.operations.html b/docs/dyn/aiplatform_v1beta1.featureGroups.featureMonitors.operations.html index e29cc2058d..0a294f517a 100644 --- a/docs/dyn/aiplatform_v1beta1.featureGroups.featureMonitors.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featureGroups.featureMonitors.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featureGroups.features.operations.html b/docs/dyn/aiplatform_v1beta1.featureGroups.features.operations.html index ffd7458d13..ff4128397e 100644 --- a/docs/dyn/aiplatform_v1beta1.featureGroups.features.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featureGroups.features.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featureGroups.operations.html b/docs/dyn/aiplatform_v1beta1.featureGroups.operations.html index 6b51d96a91..cb77ff8f11 100644 --- a/docs/dyn/aiplatform_v1beta1.featureGroups.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featureGroups.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featureOnlineStores.featureViews.operations.html b/docs/dyn/aiplatform_v1beta1.featureOnlineStores.featureViews.operations.html index 32fdc94ce0..db42439530 100644 --- a/docs/dyn/aiplatform_v1beta1.featureOnlineStores.featureViews.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featureOnlineStores.featureViews.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featureOnlineStores.operations.html b/docs/dyn/aiplatform_v1beta1.featureOnlineStores.operations.html index 97117aecca..6d1f629582 100644 --- a/docs/dyn/aiplatform_v1beta1.featureOnlineStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featureOnlineStores.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.features.operations.html b/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.features.operations.html index 38e673fb4d..8d7ce25906 100644 --- a/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.features.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.features.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.operations.html b/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.operations.html index 2123b9349d..b51814f680 100644 --- a/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featurestores.entityTypes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.featurestores.operations.html b/docs/dyn/aiplatform_v1beta1.featurestores.operations.html index 8ddd6cf321..6b2e466d04 100644 --- a/docs/dyn/aiplatform_v1beta1.featurestores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.featurestores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.html b/docs/dyn/aiplatform_v1beta1.html index 8f66369dfb..c5090f5e0b 100644 --- a/docs/dyn/aiplatform_v1beta1.html +++ b/docs/dyn/aiplatform_v1beta1.html @@ -358,7 +358,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -367,20 +367,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/aiplatform_v1beta1.hyperparameterTuningJobs.operations.html b/docs/dyn/aiplatform_v1beta1.hyperparameterTuningJobs.operations.html index 030d148d42..52b4155cdb 100644 --- a/docs/dyn/aiplatform_v1beta1.hyperparameterTuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.hyperparameterTuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.indexEndpoints.operations.html b/docs/dyn/aiplatform_v1beta1.indexEndpoints.operations.html index 194f038271..dd09efa35a 100644 --- a/docs/dyn/aiplatform_v1beta1.indexEndpoints.operations.html +++ b/docs/dyn/aiplatform_v1beta1.indexEndpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.indexes.operations.html b/docs/dyn/aiplatform_v1beta1.indexes.operations.html index 227044a4bb..613087bdbb 100644 --- a/docs/dyn/aiplatform_v1beta1.indexes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.indexes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html index 7ecd6e40fb..8771973202 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html @@ -103,7 +103,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -546,17 +546,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.operations.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.operations.html index 895f40b43f..b0ac626cfc 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.operations.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.revisions.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.revisions.html index df992e29a3..d71e2b5c2d 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.revisions.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.memoryBanks.operations.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.operations.html index ee5746ddfa..a2437c7ee5 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.operations.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.metadataStores.artifacts.operations.html b/docs/dyn/aiplatform_v1beta1.metadataStores.artifacts.operations.html index 662318f165..b34403743c 100644 --- a/docs/dyn/aiplatform_v1beta1.metadataStores.artifacts.operations.html +++ b/docs/dyn/aiplatform_v1beta1.metadataStores.artifacts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.metadataStores.contexts.operations.html b/docs/dyn/aiplatform_v1beta1.metadataStores.contexts.operations.html index 79b1696c6d..cc5882eefa 100644 --- a/docs/dyn/aiplatform_v1beta1.metadataStores.contexts.operations.html +++ b/docs/dyn/aiplatform_v1beta1.metadataStores.contexts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.metadataStores.executions.operations.html b/docs/dyn/aiplatform_v1beta1.metadataStores.executions.operations.html index ab1a7adeb5..d495251ea5 100644 --- a/docs/dyn/aiplatform_v1beta1.metadataStores.executions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.metadataStores.executions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.metadataStores.operations.html b/docs/dyn/aiplatform_v1beta1.metadataStores.operations.html index ce1323c1ff..3c2d3188d5 100644 --- a/docs/dyn/aiplatform_v1beta1.metadataStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.metadataStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.migratableResources.operations.html b/docs/dyn/aiplatform_v1beta1.migratableResources.operations.html index 0d17421861..38cd940224 100644 --- a/docs/dyn/aiplatform_v1beta1.migratableResources.operations.html +++ b/docs/dyn/aiplatform_v1beta1.migratableResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.modelDeploymentMonitoringJobs.operations.html b/docs/dyn/aiplatform_v1beta1.modelDeploymentMonitoringJobs.operations.html index a0869b5823..bf5c4fb1bb 100644 --- a/docs/dyn/aiplatform_v1beta1.modelDeploymentMonitoringJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.modelDeploymentMonitoringJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.modelMonitors.operations.html b/docs/dyn/aiplatform_v1beta1.modelMonitors.operations.html index f200669c7c..f7c1196e8f 100644 --- a/docs/dyn/aiplatform_v1beta1.modelMonitors.operations.html +++ b/docs/dyn/aiplatform_v1beta1.modelMonitors.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.models.evaluations.operations.html b/docs/dyn/aiplatform_v1beta1.models.evaluations.operations.html index ea8173ed78..006f678703 100644 --- a/docs/dyn/aiplatform_v1beta1.models.evaluations.operations.html +++ b/docs/dyn/aiplatform_v1beta1.models.evaluations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.models.operations.html b/docs/dyn/aiplatform_v1beta1.models.operations.html index 56c6d76ec5..0c5aacae7a 100644 --- a/docs/dyn/aiplatform_v1beta1.models.operations.html +++ b/docs/dyn/aiplatform_v1beta1.models.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.notebookExecutionJobs.operations.html b/docs/dyn/aiplatform_v1beta1.notebookExecutionJobs.operations.html index e36c25f7f2..c67ef9f63b 100644 --- a/docs/dyn/aiplatform_v1beta1.notebookExecutionJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.notebookExecutionJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.notebookRuntimeTemplates.operations.html b/docs/dyn/aiplatform_v1beta1.notebookRuntimeTemplates.operations.html index df6f77f19c..977ec6617f 100644 --- a/docs/dyn/aiplatform_v1beta1.notebookRuntimeTemplates.operations.html +++ b/docs/dyn/aiplatform_v1beta1.notebookRuntimeTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.notebookRuntimes.operations.html b/docs/dyn/aiplatform_v1beta1.notebookRuntimes.operations.html index eda2a56735..0a11f6bc71 100644 --- a/docs/dyn/aiplatform_v1beta1.notebookRuntimes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.notebookRuntimes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.onlineEvaluators.operations.html b/docs/dyn/aiplatform_v1beta1.onlineEvaluators.operations.html index b3ef369629..77f2cb159c 100644 --- a/docs/dyn/aiplatform_v1beta1.onlineEvaluators.operations.html +++ b/docs/dyn/aiplatform_v1beta1.onlineEvaluators.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.operations.html b/docs/dyn/aiplatform_v1beta1.operations.html index 3c8d51649d..a8384fa1e2 100644 --- a/docs/dyn/aiplatform_v1beta1.operations.html +++ b/docs/dyn/aiplatform_v1beta1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.persistentResources.operations.html b/docs/dyn/aiplatform_v1beta1.persistentResources.operations.html index 5062264225..419ab42ef2 100644 --- a/docs/dyn/aiplatform_v1beta1.persistentResources.operations.html +++ b/docs/dyn/aiplatform_v1beta1.persistentResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.pipelineJobs.operations.html b/docs/dyn/aiplatform_v1beta1.pipelineJobs.operations.html index 8b72245205..3d58a6441c 100644 --- a/docs/dyn/aiplatform_v1beta1.pipelineJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.pipelineJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html b/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html index b907c47fb2..93581c9900 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists AgentAnomalyDetectionScopes in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.agents.html b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html index f407b72eb3..2994b4421b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists the agents in a location that belong to the caller. An agent belongs to the end user recorded as its owner when it was created, so the response holds that caller's agents and no others. It is empty for a caller that is not an end user, and an agent with no recorded owner is listed for nobody.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -351,17 +351,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.agents.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.operations.html index c4ad40a79e..9ed9bb75ee 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.agents.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.apps.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.apps.operations.html index bdf2589f90..475b604993 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.apps.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.apps.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html index e5e46c2f45..911ecabc44 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists BatchPredictionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2210,17 +2210,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.cachedContents.html b/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html index 64a68db747..79eca33fa4 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists cached contents in a project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -2003,17 +2003,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.html index 7e143b7c72..1f9393fb16 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists CustomJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -775,17 +775,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.customJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.operations.html index a5291ea2d8..4ae94c6dcc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.customJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.html index c9c7dd1d0b..847615279f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DataLabelingJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -440,17 +440,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.dataLabelingJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.operations.html index afcb9b9264..1f4f3ba393 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.dataLabelingJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.annotationSpecs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.annotationSpecs.operations.html index f8b2839077..decf267e54 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.annotationSpecs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.annotationSpecs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.html index 083fa16433..3a83ffac8a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Annotations belongs to a dataitem.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.operations.html index 720b507b3c..3e1381a82f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.annotations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.html index cebbaa2db8..da1758fc1f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.html @@ -91,7 +91,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DataItems in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -138,17 +138,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.datasets.dataItems.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.operations.html index 262bd3bbb9..084bafb2b9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.dataItems.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.datasetVersions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.datasetVersions.html index 3875a473f2..7868d4861c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.datasetVersions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.datasetVersions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists DatasetVersions in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html index 69ea366f4a..9b7e49046a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html @@ -130,7 +130,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Datasets in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -139,7 +139,7 @@

Instance Methods

searchDataItems(dataset, annotationFilters=None, annotationsFilter=None, annotationsLimit=None, dataItemFilter=None, dataLabelingJob=None, fieldMask=None, orderBy=None, orderByAnnotation_orderBy=None, orderByAnnotation_savedQuery=None, orderByDataItem=None, pageSize=None, pageToken=None, savedQuery=None, x__xgafv=None)

Searches DataItems in a Dataset.

- searchDataItems_next(previous_request, previous_response)

+ searchDataItems_next()

Retrieves the next page of results.

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

@@ -1875,17 +1875,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2047,17 +2047,17 @@

Method Details

- searchDataItems_next(previous_request, previous_response) + searchDataItems_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.operations.html index db4181ac0e..1c9c41825b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.html index e643b7d2a1..2f5336f77a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists SavedQueries in a Dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.datasets.savedQueries.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.operations.html index 52b24a0a4a..d1cdd71b77 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.savedQueries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html index 57a01899e2..726c767eac 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html @@ -95,7 +95,7 @@

Instance Methods

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

List DeploymentResourcePools in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -104,7 +104,7 @@

Instance Methods

queryDeployedModels(deploymentResourcePool, pageSize=None, pageToken=None, x__xgafv=None)

List DeployedModels that have been deployed on this DeploymentResourcePool.

- queryDeployedModels_next(previous_request, previous_response)

+ queryDeployedModels_next()

Retrieves the next page of results.

Method Details

@@ -379,17 +379,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -724,17 +724,17 @@

Method Details

- queryDeployedModels_next(previous_request, previous_response) + queryDeployedModels_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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.deploymentResourcePools.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.operations.html index ea2c8aa8ac..b9dbb4f3b6 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.edgeDevices.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.edgeDevices.operations.html index fb279e89a9..03bcbe2952 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.edgeDevices.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.edgeDevices.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html index 59620f6597..6ba2e856c5 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html @@ -152,7 +152,7 @@

Instance Methods

list(parent, filter=None, gdcZone=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Endpoints in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mutateDeployedModel(endpoint, body=None, x__xgafv=None)

@@ -3710,17 +3710,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.operations.html index 751848a965..791e49439b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationExperiments.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationExperiments.html index 30cec9d463..3e88d97f77 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationExperiments.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationExperiments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Evaluation Experiments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html index f3960489fd..0c6648ccc3 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Evaluation Items.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -17432,17 +17432,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.evaluationItems.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.operations.html index 525105efa0..05bd625b2f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.html index fd1278c758..312fbb6b62 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists EvaluationMetrics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1977,17 +1977,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.evaluationMetrics.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.operations.html index 192692076e..02ff02afb6 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationMetrics.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.evaluationRuns.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html index 2a863faade..7909e447d3 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Evaluation Runs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -19315,17 +19315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.evaluationRuns.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.operations.html index 06674faf30..94b73f2273 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.html index 659921baf4..f13286aebc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Evaluation Sets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1617,17 +1617,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.operations.html index 04e93533f6..9fbd496f9e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationSets.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationTasks.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationTasks.operations.html index 357a5dc336..c5326ede8e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationTasks.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationTasks.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html index c8c2ccca25..96f066700b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html @@ -92,7 +92,7 @@

Instance Methods

fetchExamples(exampleStore, body=None, x__xgafv=None)

Get Examples from the Example Store.

- fetchExamples_next(previous_request, previous_response)

+ fetchExamples_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

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

List ExampleStores in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -441,17 +441,17 @@

Method Details

- fetchExamples_next(previous_request, previous_response) + fetchExamples_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)
+        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.
-
+ 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. +
@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.operations.html index 4760cfecac..2bc988f924 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.extensionControllers.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.extensionControllers.operations.html index 3d2f4f2908..3075939fcd 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.extensionControllers.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.extensionControllers.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html index 169807aa30..e615673552 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Extensions in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -775,17 +775,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.operations.html index 0df0d9f59e..7548b6c2d2 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.html index 3fc62d6348..d8c27d4507 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.html @@ -87,7 +87,7 @@

Instance Methods

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

List feature monitor jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -330,17 +330,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.html index 186f838aeb..1cb79d27d6 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists FeatureGroups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -291,17 +291,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.operations.html index c3f9a96b00..3d14143e15 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.featureMonitors.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.html index 58de41da0d..9b9640ca46 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, latestStatsCount=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Features in a given FeatureGroup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -554,17 +554,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.operations.html index 101ac8b571..1331f15019 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.features.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.html index 4ca59e9f45..c40dc86dd6 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.html @@ -108,7 +108,7 @@

Instance Methods

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

Lists FeatureGroups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -353,17 +353,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.operations.html index 9ccb4c768d..8c289839bc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureGroups.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html index 98903676b7..c2089dce27 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists FeatureViewSyncs in a given FeatureView.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -182,17 +182,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.html index 40fc915e53..868b8dae6b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.html @@ -112,7 +112,7 @@

Instance Methods

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

Lists FeatureViews in a given FeatureOnlineStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -775,17 +775,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.operations.html index c2fbaa6893..f0c800d1d0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.featureViews.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.html index cf55365b87..c9cf13e6af 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists FeatureOnlineStores in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -441,17 +441,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.operations.html index b07482a469..8119bc350d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featureOnlineStores.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.html index 05d9615d06..f9fc26260c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, latestStatsCount=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Features in a given EntityType.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -554,17 +554,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.operations.html index 4f92a3a13d..45afbe8754 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.features.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.html index 834c5819b5..92731af95c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.html @@ -112,7 +112,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists EntityTypes in a given Featurestore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -599,17 +599,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.operations.html index a89399406a..a76987629c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.entityTypes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.html index 9a19244c82..b41b9409f4 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Featurestores in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -115,7 +115,7 @@

Instance Methods

searchFeatures(location, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches Features matching a query in a given project.

- searchFeatures_next(previous_request, previous_response)

+ searchFeatures_next()

Retrieves the next page of results.

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

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -624,17 +624,17 @@

Method Details

- searchFeatures_next(previous_request, previous_response) + searchFeatures_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.operations.html index 3bfef2cc4b..80ac3de896 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.featurestores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.html index e0c99482de..431ff40f8e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.html @@ -421,7 +421,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

recommendSpec(parent, body=None, x__xgafv=None)

@@ -10413,17 +10413,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.html index 058462e566..6954bc96c9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists HyperparameterTuningJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1367,17 +1367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.operations.html index f626d6133e..2183a186a0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.hyperparameterTuningJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.html b/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.html index 3c7210ebbd..28e5a68754 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists IndexEndpoints in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mutateDeployedIndex(indexEndpoint, body=None, updateMask=None, x__xgafv=None)

@@ -878,17 +878,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.operations.html index fa46717af4..5fe69b894d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.indexEndpoints.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.html b/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.html index 28de70860f..06f0df4a12 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Indexes in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -396,17 +396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.operations.html index ee8c1643a4..5d89703a35 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.indexes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html index 5519abd8a9..0525a727aa 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html @@ -103,7 +103,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -546,17 +546,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.operations.html index ab992b6dfa..bf2b043cb1 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.revisions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.revisions.html index ccfebe9374..b2656faa62 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.revisions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.memoryBanks.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.operations.html index adc75be476..2ea006cca8 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.html index d8b3e08d6b..84a28d591a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Artifacts in the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.operations.html index 8cffb8fd40..b8c61177be 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.artifacts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.html index a113c2351a..d5f885e829 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists Contexts on the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -354,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.operations.html index 6d9a3dc247..0c859f1539 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.contexts.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.html index 0022da9ac9..f0ba4ed899 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Executions in the MetadataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -317,17 +317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.operations.html index 4f51f09a66..331ba3b30e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.executions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.html index 9d55b8416b..13517f02ad 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.html @@ -115,7 +115,7 @@

Instance Methods

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

Lists MetadataStores for a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.metadataStores.metadataSchemas.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.metadataSchemas.html index 849f149346..c10adccae1 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.metadataSchemas.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.metadataSchemas.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists MetadataSchemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -189,17 +189,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.metadataStores.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.operations.html index 320cb5c974..b9da9746a9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.metadataStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.html b/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.html index 90edfc41c3..99d721ce7b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.html @@ -89,7 +89,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and ml.googleapis.com that can be migrated to Vertex AI's given location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.migratableResources.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.operations.html index 7aa5b3aecf..9aff109cdd 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.migratableResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.html index f0be3566ac..a0f819f610 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists ModelDeploymentMonitoringJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -110,7 +110,7 @@

Instance Methods

searchModelDeploymentMonitoringStatsAnomalies(modelDeploymentMonitoringJob, body=None, x__xgafv=None)

Searches Model Monitoring Statistics generated within a given time window.

- searchModelDeploymentMonitoringStatsAnomalies_next(previous_request, previous_response)

+ searchModelDeploymentMonitoringStatsAnomalies_next()

Retrieves the next page of results.

Method Details

@@ -783,17 +783,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1099,17 +1099,17 @@

Method Details

- searchModelDeploymentMonitoringStatsAnomalies_next(previous_request, previous_response) + searchModelDeploymentMonitoringStatsAnomalies_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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.operations.html index cfd8aa5ef0..0a87e6511f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.modelDeploymentMonitoringJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.html b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.html index 324b987075..24ed7f8773 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists ModelMonitors in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -109,13 +109,13 @@

Instance Methods

searchModelMonitoringAlerts(modelMonitor, body=None, x__xgafv=None)

Returns the Model Monitoring alerts.

- searchModelMonitoringAlerts_next(previous_request, previous_response)

+ searchModelMonitoringAlerts_next()

Retrieves the next page of results.

searchModelMonitoringStats(modelMonitor, body=None, x__xgafv=None)

Searches Model Monitoring Stats generated within a given time window.

- searchModelMonitoringStats_next(previous_request, previous_response)

+ searchModelMonitoringStats_next()

Retrieves the next page of results.

Method Details

@@ -1069,17 +1069,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1454,17 +1454,17 @@

Method Details

- searchModelMonitoringAlerts_next(previous_request, previous_response) + searchModelMonitoringAlerts_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)
+        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.
-
+ 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. +
@@ -1540,17 +1540,17 @@

Method Details

- searchModelMonitoringStats_next(previous_request, previous_response) + searchModelMonitoringStats_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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.modelMonitors.modelMonitoringJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.modelMonitoringJobs.html index 630e101fcb..51fd39eb4f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.modelMonitoringJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.modelMonitoringJobs.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists ModelMonitoringJobs. Callers may choose to read across multiple Monitors as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of modelMonitor id in the parent. Format `projects/{project_id}/locations/{location}/moodelMonitors/-/modelMonitoringJobs`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1472,17 +1472,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.modelMonitors.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.operations.html index 9ba065abc6..7cca8b5242 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.modelMonitors.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.html index c97b3ef5e9..8a00c876d7 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists ModelEvaluations in a Model.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -825,17 +825,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.models.evaluations.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.operations.html index ebbfc7fab4..849ca06496 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.slices.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.slices.html index 8322fe3e29..3dd691a310 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.slices.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.evaluations.slices.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists ModelEvaluationSlices in a ModelEvaluation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.models.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.html index c5aa07b863..4a8a2e7eef 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.html @@ -112,16 +112,16 @@

Instance Methods

listCheckpoints(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists checkpoints of the specified model version.

- listCheckpoints_next(previous_request, previous_response)

+ listCheckpoints_next()

Retrieves the next page of results.

listVersions(name, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists versions of the specified model.

- listVersions_next(previous_request, previous_response)

+ listVersions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mergeVersionAliases(name, body=None, x__xgafv=None)

@@ -1062,17 +1062,17 @@

Method Details

- listCheckpoints_next(previous_request, previous_response) + listCheckpoints_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)
+        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.
-
+ 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. +
@@ -1423,31 +1423,31 @@

Method Details

- listVersions_next(previous_request, previous_response) + listVersions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.models.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.operations.html index 6dc5e7647e..78dce53969 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.html index 46f0349409..54551dc604 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists AnalyzedInvocations in a MonitoredAgent's AnalyzedSession.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.html index bee324a5a6..4fcbb59c35 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.analyzedSessions.html @@ -83,7 +83,7 @@

Instance Methods

aggregate(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Aggregates AnalyzedSessions across MonitoredAgents. To aggregate across all MonitoredAgents in a location, use the following format for the parent field: `projects/{project}/locations/{location}/monitoredAgents/-`

- aggregate_next(previous_request, previous_response)

+ aggregate_next()

Retrieves the next page of results.

close()

@@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists AnalyzedSessions in a MonitoredAgent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- aggregate_next(previous_request, previous_response) + aggregate_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)
+        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.
-
+ 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. +
@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.monitoredAgents.html b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.html index 8715419d88..3a3d1e313d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.monitoredAgents.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists MonitoredAgents in a specific Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -299,17 +299,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.nasJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.html index 678111bf4f..9fba5c61e0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists NasJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1439,17 +1439,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.nasJobs.nasTrialDetails.html b/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.nasTrialDetails.html index 43f8910756..152182179c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.nasTrialDetails.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.nasJobs.nasTrialDetails.html @@ -84,7 +84,7 @@

Instance Methods

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

List top NasTrialDetails of a NasJob.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.html index 73d1f905ef..84fc9fb6fe 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists NotebookExecutionJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reportEvent(name, body=None, x__xgafv=None)

@@ -514,17 +514,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.operations.html index 4e2b22e5d2..aee537981a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookExecutionJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.html index a8f2fb4b8b..4d325d248d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists NotebookRuntimeTemplates in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -508,17 +508,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.operations.html index 6aae880974..8cf95e157a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimeTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.html index be536c9b2a..7cc113c67e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists NotebookRuntimes in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reportEvent(name, body=None, x__xgafv=None)

@@ -538,17 +538,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.operations.html index b180aaff8f..23a60d583b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.notebookRuntimes.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html index bce3aa1127..b668b903ee 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists the OnlineEvaluators for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1805,17 +1805,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.operations.html index b25b3653d7..500db5f919 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.operations.html index e5c1cca14d..f8e88440d8 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.html b/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.html index 6a3b969228..52edd4da83 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists PersistentResources in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -545,17 +545,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.operations.html index 036ffc3e69..d926d9cb64 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.persistentResources.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.html index b89674ccd4..54ddd455b4 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists PipelineJobs in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1451,17 +1451,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.pipelineJobs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.operations.html index 2d45e29b6b..35d40a4ef5 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.pipelineJobs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html index 046e49b3fa..0a4942f173 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html @@ -105,7 +105,7 @@

Instance Methods

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

Lists RagCorpora in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -715,17 +715,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.operations.html index 54e9fb9b67..e1df4ac1f9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragDataSchemas.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragDataSchemas.html index 1d72d6fcb7..c0c65b8196 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragDataSchemas.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragDataSchemas.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists RagDataSchemas in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.html index 25c4dd51a9..1c3264698b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists RagFiles in a RagCorpus.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -537,17 +537,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.operations.html index e9fb177e36..c291b23167 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.ragMetadata.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.ragMetadata.html index 06e8ed57ad..4db0a2e218 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.ragMetadata.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.ragFiles.ragMetadata.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists RagMetadata in a RagFile.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -367,17 +367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragEngineConfig.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragEngineConfig.operations.html index 1cf3992d19..dc4a02a942 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragEngineConfig.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragEngineConfig.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html index 8145be818c..85fe00045e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists TaskEvents for an A2aTask.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -538,17 +538,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html index abc9b8688b..7974ac2ddc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists A2aTasks for a ReasoningEngine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1847,17 +1847,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html index d043383df5..820b6f5905 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists FeedbackEntries in a ReasoningEngine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -529,17 +529,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.operations.html index 618fcff553..071c283c2e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html index 73e1bf49d2..b386629c7f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html @@ -157,7 +157,7 @@

Instance Methods

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

Lists reasoning engines in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1513,17 +1513,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html index 75ac6d874e..13ab07832e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html @@ -106,7 +106,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -716,17 +716,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.operations.html index bff4d207d4..7293ca1fd7 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.revisions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.revisions.html index 10c210560a..0b2497ba05 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.revisions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.operations.html index fd3b6bb59b..8bd95e233a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.html index 3fb9d696f2..0c5f4f6982 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists runtime revisions in a reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, body=None, x__xgafv=None)

@@ -417,17 +417,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.operations.html index ab9acfc772..583c9573e0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.runtimeRevisions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html index 20af59b662..270b8cef6a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists SandboxEnvironmentSnapshots in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.html index 08ee3f3d38..b464bb2e1e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html index 8906eb3d04..d429ffba86 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SandboxEnvironmentTemplates in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.html index eb32da28ed..b35c5db2bd 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.html index f79ce7c523..16ddcb06f0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.html @@ -104,7 +104,7 @@

Instance Methods

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

Lists SandboxEnvironments in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -445,17 +445,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.operations.html index 609fe2bb1c..f8c31262b0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sandboxEnvironments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html index 9695ab9935..c9f2595568 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists Events in a given session.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html index cf12c72880..b37828c561 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html @@ -106,7 +106,7 @@

Instance Methods

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

Lists Sessions in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -579,17 +579,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.operations.html index fa77e18ab1..e5f1ce290b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.html b/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.html index 2866b27ba8..2ddfebb44c 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists Schedules in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -3085,17 +3085,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.operations.html index 2ae1386be8..f7d688bd04 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.schedules.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.html b/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.html index 68a146653d..bb241b4e90 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SemanticGovernancePolicies in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.operations.html index 3ec2e2fb5e..7e7535fced 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.semanticGovernancePolicies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.html b/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.html index 74b46dc85c..c9685a190f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists ServingProfiles in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.operations.html index 5b68fac00f..0e13ed89c0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.servingProfiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.html b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.html index ca4ce626f6..05a1b2ec7b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.html @@ -100,7 +100,7 @@

Instance Methods

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

List Skills.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.operations.html index 15022227dd..7ba730ad0d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.revisions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.revisions.html index fcc7c94ba7..f691dd9f9f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.skills.revisions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.skills.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Skill Revisions for a Skill.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.solvers.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.solvers.operations.html index 626cba5619..dcb31d0556 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.solvers.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.solvers.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.specialistPools.html b/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.html index 0eec0cecd2..fe4001fcf9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists SpecialistPools in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.operations.html index be7a6c4372..aa17524da0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.specialistPools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.html b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.html index 63256d7c27..c36fba6fa3 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.html @@ -100,7 +100,7 @@

Instance Methods

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

Lists all the studies in a region for an associated project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, body=None, x__xgafv=None)

@@ -637,17 +637,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.operations.html index 430acc2682..7845b0288b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.html b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.html index e4f9b0a07a..23e7af57bc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.html @@ -107,7 +107,7 @@

Instance Methods

listOptimalTrials(parent, body=None, x__xgafv=None)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stop(name, body=None, x__xgafv=None)

@@ -619,17 +619,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.operations.html index 175e69504d..9168645d23 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.studies.trials.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.events.html b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.events.html index 28c215e8ad..d9461c8b02 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.events.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists TaskEvents for an A2ATaskRecord.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.html b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.html index 7d216231ad..d6b18cdbf6 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.a2aTaskRecords.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists A2ATaskRecords in a TaskStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -834,17 +834,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.taskStores.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.operations.html index b7ac076e37..c15d6fb25a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.taskStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.html index 6850c92ba7..8689197d1b 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardExperiments in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -328,17 +328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.operations.html index 8353a8fe25..d746315b88 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.html index 0d9f87ea0a..4e8b472486 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardRuns in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -314,17 +314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.operations.html index feccd8ef66..367cc100b3 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.html index 201c5339ab..80d1804f79 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.html @@ -92,7 +92,7 @@

Instance Methods

exportTensorboardTimeSeries(tensorboardTimeSeries, body=None, x__xgafv=None)

Exports a TensorboardTimeSeries' data. Data is returned in paginated responses.

- exportTensorboardTimeSeries_next(previous_request, previous_response)

+ exportTensorboardTimeSeries_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists TensorboardTimeSeries in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -257,17 +257,17 @@

Method Details

- exportTensorboardTimeSeries_next(previous_request, previous_response) + exportTensorboardTimeSeries_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)
+        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.
-
+ 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. +
@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html index 571a43cda3..e769c1d302 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.experiments.runs.timeSeries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.html index 96c7d91555..e44f633bb9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists Tensorboards in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.operations.html index 2bc1410a89..8c3d86ea87 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tensorboards.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html index b416a92c85..798fdeeaf7 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists TrainingPipelines in a Location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1779,17 +1779,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.projects.locations.trainingPipelines.operations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.operations.html index 6d571321c2..4ed953dd16 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.operations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html index fd5039a946..bc8768362d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists tuning jobs in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

optimizePrompt(parent, body=None, x__xgafv=None)

@@ -12488,17 +12488,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.publishers.models.html b/docs/dyn/aiplatform_v1beta1.publishers.models.html index 76f9e1bb9c..f35580f06b 100644 --- a/docs/dyn/aiplatform_v1beta1.publishers.models.html +++ b/docs/dyn/aiplatform_v1beta1.publishers.models.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, languageCode=None, listAllVersions=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists publisher models in Model Garden.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

predict(endpoint, body=None, x__xgafv=None)

@@ -3081,17 +3081,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.ragCorpora.operations.html b/docs/dyn/aiplatform_v1beta1.ragCorpora.operations.html index 38560ec010..32d86514e8 100644 --- a/docs/dyn/aiplatform_v1beta1.ragCorpora.operations.html +++ b/docs/dyn/aiplatform_v1beta1.ragCorpora.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.ragCorpora.ragFiles.operations.html b/docs/dyn/aiplatform_v1beta1.ragCorpora.ragFiles.operations.html index 9c969497a3..243ecd4cff 100644 --- a/docs/dyn/aiplatform_v1beta1.ragCorpora.ragFiles.operations.html +++ b/docs/dyn/aiplatform_v1beta1.ragCorpora.ragFiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.ragEngineConfig.operations.html b/docs/dyn/aiplatform_v1beta1.ragEngineConfig.operations.html index d8bfb31f2e..9c8cd5dab1 100644 --- a/docs/dyn/aiplatform_v1beta1.ragEngineConfig.operations.html +++ b/docs/dyn/aiplatform_v1beta1.ragEngineConfig.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.feedbackEntries.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.feedbackEntries.operations.html index fa095a03d1..de60acf3ea 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.feedbackEntries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.feedbackEntries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html index 3906dc467f..d55777602b 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html @@ -149,7 +149,7 @@

Instance Methods

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

Lists reasoning engines in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1464,17 +1464,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html index 5200e8d4f2..2f3a7924d9 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html @@ -106,7 +106,7 @@

Instance Methods

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

List Memories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -716,17 +716,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.operations.html index 5c59ee4485..57b875b1a3 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.revisions.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.revisions.html index 6a93df3b9b..a0bc78d0ac 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.revisions.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

List Memory Revisions for a Memory.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.reasoningEngines.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.operations.html index c0360184f7..de765a6386 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.runtimeRevisions.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.runtimeRevisions.operations.html index 8c1ce1305a..247e77f7d4 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.runtimeRevisions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.runtimeRevisions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.html index 9875646830..96ae72f636 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists SandboxEnvironmentSnapshots in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.operations.html index eba3be1904..aa5b72fbf9 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentSnapshots.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.html index 6d30eeba8a..228f2f8727 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists SandboxEnvironmentTemplates in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.operations.html index f4ad0e0229..267d92a128 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironmentTemplates.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.html index 543347e5d0..650f90f68f 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.html @@ -104,7 +104,7 @@

Instance Methods

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

Lists SandboxEnvironments in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -445,17 +445,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.operations.html index f56be6fd62..4166d84582 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sandboxEnvironments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html index 2dcd483071..feac3ac48b 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists Events in a given session.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html index 91f8c47c5b..d81af5e4ca 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists Sessions in a given reasoning engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -527,17 +527,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.operations.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.operations.html index fc0e7af8f4..ea791e83b9 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.operations.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.schedules.operations.html b/docs/dyn/aiplatform_v1beta1.schedules.operations.html index cecabf34c5..dda91befc2 100644 --- a/docs/dyn/aiplatform_v1beta1.schedules.operations.html +++ b/docs/dyn/aiplatform_v1beta1.schedules.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.semanticGovernancePolicies.operations.html b/docs/dyn/aiplatform_v1beta1.semanticGovernancePolicies.operations.html index b789be7181..6abbe667cc 100644 --- a/docs/dyn/aiplatform_v1beta1.semanticGovernancePolicies.operations.html +++ b/docs/dyn/aiplatform_v1beta1.semanticGovernancePolicies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.servingProfiles.operations.html b/docs/dyn/aiplatform_v1beta1.servingProfiles.operations.html index 4ac58ed50c..361d92d56e 100644 --- a/docs/dyn/aiplatform_v1beta1.servingProfiles.operations.html +++ b/docs/dyn/aiplatform_v1beta1.servingProfiles.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.skills.operations.html b/docs/dyn/aiplatform_v1beta1.skills.operations.html index 2522ec3e11..36c7a3b327 100644 --- a/docs/dyn/aiplatform_v1beta1.skills.operations.html +++ b/docs/dyn/aiplatform_v1beta1.skills.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.solvers.operations.html b/docs/dyn/aiplatform_v1beta1.solvers.operations.html index f90c46472a..bce20a9e5e 100644 --- a/docs/dyn/aiplatform_v1beta1.solvers.operations.html +++ b/docs/dyn/aiplatform_v1beta1.solvers.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/aiplatform_v1beta1.specialistPools.operations.html b/docs/dyn/aiplatform_v1beta1.specialistPools.operations.html index 18c1ee5120..e7559fe205 100644 --- a/docs/dyn/aiplatform_v1beta1.specialistPools.operations.html +++ b/docs/dyn/aiplatform_v1beta1.specialistPools.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.studies.operations.html b/docs/dyn/aiplatform_v1beta1.studies.operations.html index c7a97453b5..3ad63564cc 100644 --- a/docs/dyn/aiplatform_v1beta1.studies.operations.html +++ b/docs/dyn/aiplatform_v1beta1.studies.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.studies.trials.operations.html b/docs/dyn/aiplatform_v1beta1.studies.trials.operations.html index 509845dc5b..3986d514b4 100644 --- a/docs/dyn/aiplatform_v1beta1.studies.trials.operations.html +++ b/docs/dyn/aiplatform_v1beta1.studies.trials.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.taskStores.operations.html b/docs/dyn/aiplatform_v1beta1.taskStores.operations.html index fb5d9b5885..7c505cd834 100644 --- a/docs/dyn/aiplatform_v1beta1.taskStores.operations.html +++ b/docs/dyn/aiplatform_v1beta1.taskStores.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.operations.html b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.operations.html index d40c316229..ece8bd6549 100644 --- a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.operations.html +++ b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.operations.html b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.operations.html index a628efd109..6116baa7bb 100644 --- a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.operations.html +++ b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.timeSeries.operations.html b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.timeSeries.operations.html index e9c5b6bc46..d36db3b99b 100644 --- a/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.timeSeries.operations.html +++ b/docs/dyn/aiplatform_v1beta1.tensorboards.experiments.runs.timeSeries.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.tensorboards.operations.html b/docs/dyn/aiplatform_v1beta1.tensorboards.operations.html index 40b4bfd91b..1e7fe90b14 100644 --- a/docs/dyn/aiplatform_v1beta1.tensorboards.operations.html +++ b/docs/dyn/aiplatform_v1beta1.tensorboards.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/aiplatform_v1beta1.trainingPipelines.operations.html b/docs/dyn/aiplatform_v1beta1.trainingPipelines.operations.html index 61d62dabd0..dbf973ae86 100644 --- a/docs/dyn/aiplatform_v1beta1.trainingPipelines.operations.html +++ b/docs/dyn/aiplatform_v1beta1.trainingPipelines.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/airquality_v1.forecast.html b/docs/dyn/airquality_v1.forecast.html index 24f8d9303f..33f35eb9d6 100644 --- a/docs/dyn/airquality_v1.forecast.html +++ b/docs/dyn/airquality_v1.forecast.html @@ -81,7 +81,7 @@

Instance Methods

lookup(body=None, x__xgafv=None)

Returns air quality forecast for a specific location for a given time range.

- lookup_next(previous_request, previous_response)

+ lookup_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- lookup_next(previous_request, previous_response) + lookup_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)
+        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.
-
+ 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/airquality_v1.history.html b/docs/dyn/airquality_v1.history.html index 286744406b..a8b5155327 100644 --- a/docs/dyn/airquality_v1.history.html +++ b/docs/dyn/airquality_v1.history.html @@ -81,7 +81,7 @@

Instance Methods

lookup(body=None, x__xgafv=None)

Returns air quality history for a specific location for a given time range.

- lookup_next(previous_request, previous_response)

+ lookup_next()

Retrieves the next page of results.

Method Details

@@ -184,17 +184,17 @@

Method Details

- lookup_next(previous_request, previous_response) + lookup_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)
+        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.
-
+ 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/airquality_v1.html b/docs/dyn/airquality_v1.html index 7311df7a8b..234864f836 100644 --- a/docs/dyn/airquality_v1.html +++ b/docs/dyn/airquality_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/alertcenter_v1beta1.alerts.html b/docs/dyn/alertcenter_v1beta1.alerts.html index 2bd7221905..6f73bbac98 100644 --- a/docs/dyn/alertcenter_v1beta1.alerts.html +++ b/docs/dyn/alertcenter_v1beta1.alerts.html @@ -101,7 +101,7 @@

Instance Methods

list(customerId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the alerts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

undelete(alertId, body=None, x__xgafv=None)

@@ -332,17 +332,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alertcenter_v1beta1.html b/docs/dyn/alertcenter_v1beta1.html index d6f93545fa..292c889d61 100644 --- a/docs/dyn/alertcenter_v1beta1.html +++ b/docs/dyn/alertcenter_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/alloydb_v1.html b/docs/dyn/alloydb_v1.html index 0235a60589..58ee41c4ac 100644 --- a/docs/dyn/alloydb_v1.html +++ b/docs/dyn/alloydb_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/alloydb_v1.projects.locations.backups.html b/docs/dyn/alloydb_v1.projects.locations.backups.html index fbe3bd1e3b..5596289bdd 100644 --- a/docs/dyn/alloydb_v1.projects.locations.backups.html +++ b/docs/dyn/alloydb_v1.projects.locations.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Backups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1.projects.locations.clusters.html b/docs/dyn/alloydb_v1.projects.locations.clusters.html index bf68cae421..007547eb15 100644 --- a/docs/dyn/alloydb_v1.projects.locations.clusters.html +++ b/docs/dyn/alloydb_v1.projects.locations.clusters.html @@ -109,7 +109,7 @@

Instance Methods

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

Lists Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1210,17 +1210,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html index b00f4c5113..5af2dba9f5 100644 --- a/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists Instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -950,17 +950,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1.projects.locations.clusters.users.html b/docs/dyn/alloydb_v1.projects.locations.clusters.users.html index b9d2bbdba0..78fc523736 100644 --- a/docs/dyn/alloydb_v1.projects.locations.clusters.users.html +++ b/docs/dyn/alloydb_v1.projects.locations.clusters.users.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Users in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1.projects.locations.html b/docs/dyn/alloydb_v1.projects.locations.html index 9d09014e98..2183e578c9 100644 --- a/docs/dyn/alloydb_v1.projects.locations.html +++ b/docs/dyn/alloydb_v1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1.projects.locations.operations.html b/docs/dyn/alloydb_v1.projects.locations.operations.html index 183ce38f44..98660aec89 100644 --- a/docs/dyn/alloydb_v1.projects.locations.operations.html +++ b/docs/dyn/alloydb_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1.projects.locations.supportedDatabaseFlags.html b/docs/dyn/alloydb_v1.projects.locations.supportedDatabaseFlags.html index 8f603d31d9..9c6855d031 100644 --- a/docs/dyn/alloydb_v1.projects.locations.supportedDatabaseFlags.html +++ b/docs/dyn/alloydb_v1.projects.locations.supportedDatabaseFlags.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, scope=None, x__xgafv=None)

Lists SupportedDatabaseFlags for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1alpha.html b/docs/dyn/alloydb_v1alpha.html index a5d1b2cb9c..a5be98133f 100644 --- a/docs/dyn/alloydb_v1alpha.html +++ b/docs/dyn/alloydb_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.backups.html b/docs/dyn/alloydb_v1alpha.projects.locations.backups.html index e375ecff39..e82baa67b2 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.backups.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Backups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.html b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.html index 10b558fae5..c7baa7dcf0 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.html @@ -109,7 +109,7 @@

Instance Methods

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

Lists Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1234,17 +1234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html index 306eac0c44..fab20238ba 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists Instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1091,17 +1091,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.users.html b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.users.html index a2bc37a2fc..ee2319ff33 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.users.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.users.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Users in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.endpoints.html b/docs/dyn/alloydb_v1alpha.projects.locations.endpoints.html index 74ff86eea2..87d167c4fe 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.endpoints.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.endpoints.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Endpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.html b/docs/dyn/alloydb_v1alpha.projects.locations.html index 0da8680b5a..2a92fc8866 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1alpha.projects.locations.operations.html b/docs/dyn/alloydb_v1alpha.projects.locations.operations.html index 157fc40ecc..ce7232c397 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.operations.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1alpha.projects.locations.supportedDatabaseFlags.html b/docs/dyn/alloydb_v1alpha.projects.locations.supportedDatabaseFlags.html index 403bb71a5d..68705ffcd1 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.supportedDatabaseFlags.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.supportedDatabaseFlags.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, scope=None, x__xgafv=None)

Lists SupportedDatabaseFlags for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1beta.html b/docs/dyn/alloydb_v1beta.html index 8a165a6d70..e98cab3c3d 100644 --- a/docs/dyn/alloydb_v1beta.html +++ b/docs/dyn/alloydb_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/alloydb_v1beta.projects.locations.backups.html b/docs/dyn/alloydb_v1beta.projects.locations.backups.html index 39bb20731a..3b167f60f1 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.backups.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Backups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1beta.projects.locations.clusters.html b/docs/dyn/alloydb_v1beta.projects.locations.clusters.html index 51a03bd8f7..b473e529bf 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.clusters.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.clusters.html @@ -109,7 +109,7 @@

Instance Methods

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

Lists Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1230,17 +1230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html index e446569263..cfeadba0f8 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists Instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1087,17 +1087,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1beta.projects.locations.clusters.users.html b/docs/dyn/alloydb_v1beta.projects.locations.clusters.users.html index e1170da0bf..a175ae93e3 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.clusters.users.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.clusters.users.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Users in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1beta.projects.locations.endpoints.html b/docs/dyn/alloydb_v1beta.projects.locations.endpoints.html index f8bd619484..a8377131af 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.endpoints.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.endpoints.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Endpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/alloydb_v1beta.projects.locations.html b/docs/dyn/alloydb_v1beta.projects.locations.html index a4fca32a1d..25bbd3b762 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1beta.projects.locations.operations.html b/docs/dyn/alloydb_v1beta.projects.locations.operations.html index 336a7c47dc..6880f36ed3 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.operations.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alloydb_v1beta.projects.locations.supportedDatabaseFlags.html b/docs/dyn/alloydb_v1beta.projects.locations.supportedDatabaseFlags.html index d972f3f07d..c3ad2c7f44 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.supportedDatabaseFlags.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.supportedDatabaseFlags.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, scope=None, x__xgafv=None)

Lists SupportedDatabaseFlags for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.accountSummaries.html b/docs/dyn/analyticsadmin_v1alpha.accountSummaries.html index 4b052175f3..f48c7bff6b 100644 --- a/docs/dyn/analyticsadmin_v1alpha.accountSummaries.html +++ b/docs/dyn/analyticsadmin_v1alpha.accountSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Returns summaries of all accounts accessible by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.accounts.accessBindings.html b/docs/dyn/analyticsadmin_v1alpha.accounts.accessBindings.html index 771b737ba6..e0c8f2b53b 100644 --- a/docs/dyn/analyticsadmin_v1alpha.accounts.accessBindings.html +++ b/docs/dyn/analyticsadmin_v1alpha.accounts.accessBindings.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists all access bindings on an account or property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -365,17 +365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.accounts.html b/docs/dyn/analyticsadmin_v1alpha.accounts.html index 8334757b54..ca89241290 100644 --- a/docs/dyn/analyticsadmin_v1alpha.accounts.html +++ b/docs/dyn/analyticsadmin_v1alpha.accounts.html @@ -95,7 +95,7 @@

Instance Methods

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

Returns all accounts accessible by the caller. Note that these accounts might not currently have GA properties. Soft-deleted (ie: "trashed") accounts are excluded by default. Returns an empty list if no relevant accounts are found. Note: The easiest way to retrieve a list of all properties you have access to is by using `ListAccountSummaries`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -110,7 +110,7 @@

Instance Methods

searchChangeHistoryEvents(account, body=None, x__xgafv=None)

Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.

- searchChangeHistoryEvents_next(previous_request, previous_response)

+ searchChangeHistoryEvents_next()

Retrieves the next page of results.

Method Details

@@ -218,17 +218,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1620,17 +1620,17 @@

Method Details

- searchChangeHistoryEvents_next(previous_request, previous_response) + searchChangeHistoryEvents_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)
+        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.
-
+ 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/analyticsadmin_v1alpha.html b/docs/dyn/analyticsadmin_v1alpha.html index 4705b7850a..e83dda1607 100644 --- a/docs/dyn/analyticsadmin_v1alpha.html +++ b/docs/dyn/analyticsadmin_v1alpha.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.accessBindings.html b/docs/dyn/analyticsadmin_v1alpha.properties.accessBindings.html index 85a7ce0319..5134d28218 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.accessBindings.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.accessBindings.html @@ -102,7 +102,7 @@

Instance Methods

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

Lists all access bindings on an account or property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -365,17 +365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.adSenseLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.adSenseLinks.html index f35a9435be..e7435b808a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.adSenseLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.adSenseLinks.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists AdSenseLinks on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.properties.audiences.html b/docs/dyn/analyticsadmin_v1alpha.properties.audiences.html index 4e268c09da..ab5a29f813 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.audiences.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.audiences.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Audiences on a property. Audiences created before 2020 may not be supported. Default audiences will not show filter definitions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -713,17 +713,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.bigQueryLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.bigQueryLinks.html index 66c69ac3c3..58a26b67f1 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.bigQueryLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.bigQueryLinks.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists BigQuery Links on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.calculatedMetrics.html b/docs/dyn/analyticsadmin_v1alpha.properties.calculatedMetrics.html index a99507a255..9484d6bc1a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.calculatedMetrics.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.calculatedMetrics.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CalculatedMetrics on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.channelGroups.html b/docs/dyn/analyticsadmin_v1alpha.properties.channelGroups.html index a622047c4a..cc72b0f55a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.channelGroups.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.channelGroups.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists ChannelGroups on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -327,17 +327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.conversionEvents.html b/docs/dyn/analyticsadmin_v1alpha.properties.conversionEvents.html index 229d02c492..73bee4b9ab 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.conversionEvents.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.conversionEvents.html @@ -90,7 +90,7 @@

Instance Methods

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

Deprecated: Use `ListKeyEvents` instead. Returns a list of conversion events in the specified parent property. Returns an empty list if no conversion events are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.customDimensions.html b/docs/dyn/analyticsadmin_v1alpha.properties.customDimensions.html index 064e23cbec..9e7e856675 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.customDimensions.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.customDimensions.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CustomDimensions on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.customMetrics.html b/docs/dyn/analyticsadmin_v1alpha.properties.customMetrics.html index 4e6177e310..9082599b60 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.customMetrics.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.customMetrics.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CustomMetrics on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventCreateRules.html b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventCreateRules.html index 2a18572bc6..f5612b9586 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventCreateRules.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventCreateRules.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists EventCreateRules on a web data stream.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventEditRules.html b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventEditRules.html index d39fe24565..db4260f89a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventEditRules.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.eventEditRules.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists EventEditRules on a web data stream.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.html b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.html index 07aeecef75..ae55dff8ad 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.html @@ -119,7 +119,7 @@

Instance Methods

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

Lists DataStreams on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -367,17 +367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.measurementProtocolSecrets.html b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.measurementProtocolSecrets.html index 1abe81bf9a..5e883a5a43 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.measurementProtocolSecrets.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.measurementProtocolSecrets.html @@ -90,7 +90,7 @@

Instance Methods

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

Returns child MeasurementProtocolSecrets under the specified parent Property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.sKAdNetworkConversionValueSchema.html b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.sKAdNetworkConversionValueSchema.html index 7dad44e7f1..02d04e6e20 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.sKAdNetworkConversionValueSchema.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.dataStreams.sKAdNetworkConversionValueSchema.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists SKAdNetworkConversionValueSchema on a stream. Properties can have at most one SKAdNetworkConversionValueSchema.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -435,17 +435,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinkProposals.html b/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinkProposals.html index 30b89e8fd4..622032957a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinkProposals.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinkProposals.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists DisplayVideo360AdvertiserLinkProposals on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -306,17 +306,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinks.html index facd6f0f38..8e4d8dcdc5 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.displayVideo360AdvertiserLinks.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all DisplayVideo360AdvertiserLinks on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.expandedDataSets.html b/docs/dyn/analyticsadmin_v1alpha.properties.expandedDataSets.html index b0c7a67bde..0e2bc8c5e9 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.expandedDataSets.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.expandedDataSets.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists ExpandedDataSets on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.firebaseLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.firebaseLinks.html index 42a03856d9..813a87df73 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.firebaseLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.firebaseLinks.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists FirebaseLinks on a property. Properties can have at most one FirebaseLink.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.properties.googleAdsLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.googleAdsLinks.html index f2ac02d1e6..007948b6e8 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.googleAdsLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.googleAdsLinks.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists GoogleAdsLinks on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.html b/docs/dyn/analyticsadmin_v1alpha.properties.html index ccf54d9355..0a25cb52ea 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.html @@ -216,7 +216,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Returns child Properties under the specified parent Account. Properties will be excluded if the caller does not have access. Soft-deleted (ie: "trashed") properties are excluded by default. Returns an empty list if no relevant properties are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -593,17 +593,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html b/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html index 2aacae4622..9985704954 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html @@ -90,7 +90,7 @@

Instance Methods

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

Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.reportingDataAnnotations.html b/docs/dyn/analyticsadmin_v1alpha.properties.reportingDataAnnotations.html index ac5c8b8402..10612c2d7c 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.reportingDataAnnotations.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.reportingDataAnnotations.html @@ -90,7 +90,7 @@

Instance Methods

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

List all Reporting Data Annotations on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -276,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.rollupPropertySourceLinks.html b/docs/dyn/analyticsadmin_v1alpha.properties.rollupPropertySourceLinks.html index e5244015e0..666e64b2db 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.rollupPropertySourceLinks.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.rollupPropertySourceLinks.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists roll-up property source Links on a property. Only roll-up properties can have source links, so this method will throw an error if used on other types of properties.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1alpha.properties.searchAds360Links.html b/docs/dyn/analyticsadmin_v1alpha.properties.searchAds360Links.html index 7ee80a8fb4..bc8ae9bf5a 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.searchAds360Links.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.searchAds360Links.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all SearchAds360Links on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.subpropertyEventFilters.html b/docs/dyn/analyticsadmin_v1alpha.properties.subpropertyEventFilters.html index 98cec1cda7..f6944015f3 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.subpropertyEventFilters.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.subpropertyEventFilters.html @@ -90,7 +90,7 @@

Instance Methods

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

List all subproperty Event Filters on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.subpropertySyncConfigs.html b/docs/dyn/analyticsadmin_v1alpha.properties.subpropertySyncConfigs.html index 68bea36897..b2c3d4b892 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.subpropertySyncConfigs.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.subpropertySyncConfigs.html @@ -84,7 +84,7 @@

Instance Methods

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

List all `SubpropertySyncConfig` resources for a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.accountSummaries.html b/docs/dyn/analyticsadmin_v1beta.accountSummaries.html index 943f158f85..f66787f3cb 100644 --- a/docs/dyn/analyticsadmin_v1beta.accountSummaries.html +++ b/docs/dyn/analyticsadmin_v1beta.accountSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Returns summaries of all accounts accessible by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1beta.accounts.html b/docs/dyn/analyticsadmin_v1beta.accounts.html index 12e42d9d02..81f73c3c21 100644 --- a/docs/dyn/analyticsadmin_v1beta.accounts.html +++ b/docs/dyn/analyticsadmin_v1beta.accounts.html @@ -90,7 +90,7 @@

Instance Methods

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

Returns all accounts accessible by the caller. Note that these accounts might not currently have GA properties. Soft-deleted (ie: "trashed") accounts are excluded by default. Returns an empty list if no relevant accounts are found. Note: The easiest way to retrieve a list of all properties you have access to is by using `ListAccountSummaries`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -105,7 +105,7 @@

Instance Methods

searchChangeHistoryEvents(account, body=None, x__xgafv=None)

Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.

- searchChangeHistoryEvents_next(previous_request, previous_response)

+ searchChangeHistoryEvents_next()

Retrieves the next page of results.

Method Details

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -713,17 +713,17 @@

Method Details

- searchChangeHistoryEvents_next(previous_request, previous_response) + searchChangeHistoryEvents_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)
+        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.
-
+ 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/analyticsadmin_v1beta.html b/docs/dyn/analyticsadmin_v1beta.html index 9bcf1544a2..75246f47a1 100644 --- a/docs/dyn/analyticsadmin_v1beta.html +++ b/docs/dyn/analyticsadmin_v1beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/analyticsadmin_v1beta.properties.conversionEvents.html b/docs/dyn/analyticsadmin_v1beta.properties.conversionEvents.html index 7f43bf113e..e6502441a8 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.conversionEvents.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.conversionEvents.html @@ -90,7 +90,7 @@

Instance Methods

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

Deprecated: Use `ListKeyEvents` instead. Returns a list of conversion events in the specified parent property. Returns an empty list if no conversion events are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.customDimensions.html b/docs/dyn/analyticsadmin_v1beta.properties.customDimensions.html index bbb223eaf8..5ea76f26b6 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.customDimensions.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.customDimensions.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CustomDimensions on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.customMetrics.html b/docs/dyn/analyticsadmin_v1beta.properties.customMetrics.html index d2b6849987..d82d25bf85 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.customMetrics.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.customMetrics.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CustomMetrics on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.html b/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.html index 67f491f137..8aa92a073f 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists DataStreams on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.measurementProtocolSecrets.html b/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.measurementProtocolSecrets.html index fc51f66a2a..473e4d19e6 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.measurementProtocolSecrets.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.dataStreams.measurementProtocolSecrets.html @@ -90,7 +90,7 @@

Instance Methods

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

Returns child MeasurementProtocolSecrets under the specified parent Property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.firebaseLinks.html b/docs/dyn/analyticsadmin_v1beta.properties.firebaseLinks.html index b4828d7033..bbfd7c832c 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.firebaseLinks.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.firebaseLinks.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists FirebaseLinks on a property. Properties can have at most one FirebaseLink.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticsadmin_v1beta.properties.googleAdsLinks.html b/docs/dyn/analyticsadmin_v1beta.properties.googleAdsLinks.html index 4921af26a8..de83cb56bb 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.googleAdsLinks.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.googleAdsLinks.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists GoogleAdsLinks on a property.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.html b/docs/dyn/analyticsadmin_v1beta.properties.html index c6c770dcfa..7a1c590115 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.html @@ -131,7 +131,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Returns child Properties under the specified parent Account. Properties will be excluded if the caller does not have access. Soft-deleted (ie: "trashed") properties are excluded by default. Returns an empty list if no relevant properties are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html b/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html index bf94e40889..3eb6839252 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html @@ -90,7 +90,7 @@

Instance Methods

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

Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticsdata_v1beta.html b/docs/dyn/analyticsdata_v1beta.html index 16c4a46bc2..8b4a8ab3c5 100644 --- a/docs/dyn/analyticsdata_v1beta.html +++ b/docs/dyn/analyticsdata_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/analyticsdata_v1beta.properties.audienceExports.html b/docs/dyn/analyticsdata_v1beta.properties.audienceExports.html index b8dd84ae6a..5ad1316758 100644 --- a/docs/dyn/analyticsdata_v1beta.properties.audienceExports.html +++ b/docs/dyn/analyticsdata_v1beta.properties.audienceExports.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists all audience exports for a property. This method can be used for you to find and reuse existing audience exports rather than creating unnecessary new audience exports. The same audience can have multiple audience exports that represent the export of users that were in an audience on different days. See [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Exports with examples. Audience Export APIs have some methods at alpha and other methods at beta stability. The intention is to advance methods to beta stability after some feedback and adoption. To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, body=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1.html b/docs/dyn/analyticshub_v1.html index fa3632ddc8..d95beac348 100644 --- a/docs/dyn/analyticshub_v1.html +++ b/docs/dyn/analyticshub_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/analyticshub_v1.organizations.locations.dataExchanges.html b/docs/dyn/analyticshub_v1.organizations.locations.dataExchanges.html index 054b7423ee..76c8e2e67d 100644 --- a/docs/dyn/analyticshub_v1.organizations.locations.dataExchanges.html +++ b/docs/dyn/analyticshub_v1.organizations.locations.dataExchanges.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all data exchanges from projects in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -132,17 +132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticshub_v1.projects.locations.dataExchanges.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html index 96d4081778..bbd430460b 100644 --- a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html +++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html @@ -106,10 +106,10 @@

Instance Methods

listSubscriptions(resource, includeDeletedSubscriptions=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all subscriptions on a given Data Exchange or Listing.

- listSubscriptions_next(previous_request, previous_response)

+ listSubscriptions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -411,31 +411,31 @@

Method Details

- listSubscriptions_next(previous_request, previous_response) + listSubscriptions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html index d1b5a48326..a84178935b 100644 --- a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html +++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html @@ -96,10 +96,10 @@

Instance Methods

listSubscriptions(resource, includeDeletedSubscriptions=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all subscriptions on a given Data Exchange or Listing.

- listSubscriptions_next(previous_request, previous_response)

+ listSubscriptions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -614,31 +614,31 @@

Method Details

- listSubscriptions_next(previous_request, previous_response) + listSubscriptions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html index 51fd965d38..e170b7b4fb 100644 --- a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html +++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists all QueryTemplates in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1.projects.locations.subscriptions.html b/docs/dyn/analyticshub_v1.projects.locations.subscriptions.html index 7fcefdc04f..294515338a 100644 --- a/docs/dyn/analyticshub_v1.projects.locations.subscriptions.html +++ b/docs/dyn/analyticshub_v1.projects.locations.subscriptions.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all subscriptions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

refresh(name, body=None, x__xgafv=None)

@@ -333,17 +333,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1beta1.html b/docs/dyn/analyticshub_v1beta1.html index 5333c9dcc9..a236820162 100644 --- a/docs/dyn/analyticshub_v1beta1.html +++ b/docs/dyn/analyticshub_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/analyticshub_v1beta1.organizations.locations.dataExchanges.html b/docs/dyn/analyticshub_v1beta1.organizations.locations.dataExchanges.html index 981d29b436..fdcf5dd59a 100644 --- a/docs/dyn/analyticshub_v1beta1.organizations.locations.dataExchanges.html +++ b/docs/dyn/analyticshub_v1beta1.organizations.locations.dataExchanges.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all data exchanges from projects in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -122,17 +122,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/analyticshub_v1beta1.projects.locations.dataExchanges.html b/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.html index e13bdc4e4e..caf8846f7a 100644 --- a/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.html +++ b/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all data exchanges in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.listings.html b/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.listings.html index 24c4af2992..741e8d333b 100644 --- a/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.listings.html +++ b/docs/dyn/analyticshub_v1beta1.projects.locations.dataExchanges.listings.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists all listings in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -368,17 +368,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androiddeveloperidstatus_v1.html b/docs/dyn/androiddeveloperidstatus_v1.html index f7de3c1fcb..260989f696 100644 --- a/docs/dyn/androiddeveloperidstatus_v1.html +++ b/docs/dyn/androiddeveloperidstatus_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/androiddeviceprovisioning_v1.customers.devices.html b/docs/dyn/androiddeviceprovisioning_v1.customers.devices.html index a55a330854..e06469d11e 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.customers.devices.html +++ b/docs/dyn/androiddeviceprovisioning_v1.customers.devices.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists a customer's devices.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeConfiguration(parent, body=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androiddeviceprovisioning_v1.customers.html b/docs/dyn/androiddeviceprovisioning_v1.customers.html index 0c64b4e38f..68006a46dc 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.customers.html +++ b/docs/dyn/androiddeviceprovisioning_v1.customers.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists the user's customer accounts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androiddeviceprovisioning_v1.html b/docs/dyn/androiddeviceprovisioning_v1.html index 15e233c1b5..87c1329930 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.html +++ b/docs/dyn/androiddeviceprovisioning_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/androiddeviceprovisioning_v1.partners.customers.html b/docs/dyn/androiddeviceprovisioning_v1.partners.customers.html index daae59fa05..487be3b4e2 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.partners.customers.html +++ b/docs/dyn/androiddeviceprovisioning_v1.partners.customers.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists the customers that are enrolled to the reseller identified by the `partnerId` argument. This list includes customers that the reseller created and customers that enrolled themselves using the portal.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androiddeviceprovisioning_v1.partners.devices.html b/docs/dyn/androiddeviceprovisioning_v1.partners.devices.html index ca41abd661..4567cb5e22 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.partners.devices.html +++ b/docs/dyn/androiddeviceprovisioning_v1.partners.devices.html @@ -87,13 +87,13 @@

Instance Methods

findByIdentifier(partnerId, body=None, x__xgafv=None)

Finds devices by hardware identifiers, such as IMEI.

- findByIdentifier_next(previous_request, previous_response)

+ findByIdentifier_next()

Retrieves the next page of results.

findByOwner(partnerId, body=None, x__xgafv=None)

Finds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the `partnerId` argument. The customer's devices purchased from other resellers don't appear in the results.

- findByOwner_next(previous_request, previous_response)

+ findByOwner_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -308,17 +308,17 @@

Method Details

- findByIdentifier_next(previous_request, previous_response) + findByIdentifier_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)
+        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.
-
+ 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. +
@@ -391,17 +391,17 @@

Method Details

- findByOwner_next(previous_request, previous_response) + findByOwner_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.customers.html b/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.customers.html index 635d094aa3..0b902001a9 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.customers.html +++ b/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.customers.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the customers of the vendor.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -134,17 +134,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androiddeviceprovisioning_v1.partners.vendors.html b/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.html index 2c41ed95f1..1583b648f2 100644 --- a/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.html +++ b/docs/dyn/androiddeviceprovisioning_v1.partners.vendors.html @@ -86,7 +86,7 @@

Instance Methods

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

Lists the vendors of the partner.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -139,17 +139,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidenterprise_v1.html b/docs/dyn/androidenterprise_v1.html index e13d9ec90a..e5eace4087 100644 --- a/docs/dyn/androidenterprise_v1.html +++ b/docs/dyn/androidenterprise_v1.html @@ -163,7 +163,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -172,20 +172,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/androidmanagement_v1.enterprises.devices.html b/docs/dyn/androidmanagement_v1.enterprises.devices.html index bdad24f06c..a44635518d 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.devices.html +++ b/docs/dyn/androidmanagement_v1.enterprises.devices.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists devices for a given enterprise. Deleted devices are not returned in the response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -865,17 +865,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidmanagement_v1.enterprises.devices.operations.html b/docs/dyn/androidmanagement_v1.enterprises.devices.operations.html index 1d4726c491..109d2ac317 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.devices.operations.html +++ b/docs/dyn/androidmanagement_v1.enterprises.devices.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidmanagement_v1.enterprises.enrollmentTokens.html b/docs/dyn/androidmanagement_v1.enterprises.enrollmentTokens.html index 3b08e98625..1624a6ff5e 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.enrollmentTokens.html +++ b/docs/dyn/androidmanagement_v1.enterprises.enrollmentTokens.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists active, unexpired enrollment tokens for a given enterprise. The list items contain only a partial view of EnrollmentToken object. Only the following fields are populated: name, expirationTimestamp, allowPersonalUsage, value, qrCode. This method is meant to help manage active enrollment tokens lifecycle. For security reasons, it's recommended to delete active enrollment tokens as soon as they're not intended to be used anymore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidmanagement_v1.enterprises.html b/docs/dyn/androidmanagement_v1.enterprises.html index e964574942..c0af84d8e6 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.html +++ b/docs/dyn/androidmanagement_v1.enterprises.html @@ -128,7 +128,7 @@

Instance Methods

list(pageSize=None, pageToken=None, projectId=None, view=None, x__xgafv=None)

Lists EMM-managed enterprises. Only BASIC fields are returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -485,17 +485,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidmanagement_v1.enterprises.migrationTokens.html b/docs/dyn/androidmanagement_v1.enterprises.migrationTokens.html index 433926a0ab..cf3d3592f9 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.migrationTokens.html +++ b/docs/dyn/androidmanagement_v1.enterprises.migrationTokens.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists migration tokens.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidmanagement_v1.enterprises.policies.html b/docs/dyn/androidmanagement_v1.enterprises.policies.html index 28e9d7b398..4453c8f04e 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.policies.html +++ b/docs/dyn/androidmanagement_v1.enterprises.policies.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists policies for a given enterprise.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyPolicyApplications(name, body=None, x__xgafv=None)

@@ -1186,17 +1186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidmanagement_v1.enterprises.webApps.html b/docs/dyn/androidmanagement_v1.enterprises.webApps.html index de697ee6a5..6b2dada04d 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.webApps.html +++ b/docs/dyn/androidmanagement_v1.enterprises.webApps.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists web apps for a given enterprise.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidmanagement_v1.html b/docs/dyn/androidmanagement_v1.html index e9c20d97dc..a53d596178 100644 --- a/docs/dyn/androidmanagement_v1.html +++ b/docs/dyn/androidmanagement_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/androidpublisher_v3.applications.deviceTierConfigs.html b/docs/dyn/androidpublisher_v3.applications.deviceTierConfigs.html index b5c9b1f7ac..55e533fd17 100644 --- a/docs/dyn/androidpublisher_v3.applications.deviceTierConfigs.html +++ b/docs/dyn/androidpublisher_v3.applications.deviceTierConfigs.html @@ -87,7 +87,7 @@

Instance Methods

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

Returns created device tier configs, ordered by descending creation time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -405,17 +405,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidpublisher_v3.appstoreappsreview.html b/docs/dyn/androidpublisher_v3.appstoreappsreview.html index ae51e25d1c..cffd63cdde 100644 --- a/docs/dyn/androidpublisher_v3.appstoreappsreview.html +++ b/docs/dyn/androidpublisher_v3.appstoreappsreview.html @@ -280,6 +280,7 @@

Method Details

An object of the form: { # Response for updating an app record for an app store hosted app. + "updateId": "A String", # Unique identifier for the specific version of the hosted app submitted in this update. This identifier can be used to correlate publishing signals (such as those returned by ListHostedAppsPublishingSignals) with this specific app update. }
diff --git a/docs/dyn/androidpublisher_v3.appstorecatalog.recentupdateevents.html b/docs/dyn/androidpublisher_v3.appstorecatalog.recentupdateevents.html index 0a8f5d91ae..838559b6b3 100644 --- a/docs/dyn/androidpublisher_v3.appstorecatalog.recentupdateevents.html +++ b/docs/dyn/androidpublisher_v3.appstorecatalog.recentupdateevents.html @@ -81,7 +81,7 @@

Instance Methods

list(appStorePackageName, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Lists update events for eligible apps in the given time range.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidpublisher_v3.html b/docs/dyn/androidpublisher_v3.html index 7575253d1d..9170dcc0e3 100644 --- a/docs/dyn/androidpublisher_v3.html +++ b/docs/dyn/androidpublisher_v3.html @@ -163,7 +163,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -172,20 +172,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html index fc6fe2e7d2..7686ee53df 100644 --- a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html +++ b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists all one-time products under a given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(packageName, productId, allowMissing=None, body=None, latencyTolerance=None, regionsVersion_version=None, updateMask=None, x__xgafv=None)

@@ -695,17 +695,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html index ba6b96f754..592f48bf7c 100644 --- a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html +++ b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html @@ -102,7 +102,7 @@

Instance Methods

list(packageName, productId, purchaseOptionId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all offers under a given app, product, or purchase option.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -727,17 +727,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/androidpublisher_v3.monetization.subscriptions.basePlans.offers.html b/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.offers.html index a6626ad739..f5fe42e1f0 100644 --- a/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.offers.html +++ b/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.offers.html @@ -105,7 +105,7 @@

Instance Methods

list(packageName, productId, basePlanId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all offers under a given subscription.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(packageName, productId, basePlanId, offerId, allowMissing=None, body=None, latencyTolerance=None, regionsVersion_version=None, updateMask=None, x__xgafv=None)

@@ -1341,17 +1341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidpublisher_v3.monetization.subscriptions.html b/docs/dyn/androidpublisher_v3.monetization.subscriptions.html index ad0cc65a4e..403d2ca5d1 100644 --- a/docs/dyn/androidpublisher_v3.monetization.subscriptions.html +++ b/docs/dyn/androidpublisher_v3.monetization.subscriptions.html @@ -104,7 +104,7 @@

Instance Methods

list(packageName, pageSize=None, pageToken=None, showArchived=None, x__xgafv=None)

Lists all subscriptions under a given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(packageName, productId, allowMissing=None, body=None, latencyTolerance=None, regionsVersion_version=None, updateMask=None, x__xgafv=None)

@@ -1033,17 +1033,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/androidpublisher_v3.users.html b/docs/dyn/androidpublisher_v3.users.html index 3432f1bcb5..d3ada6c72a 100644 --- a/docs/dyn/androidpublisher_v3.users.html +++ b/docs/dyn/androidpublisher_v3.users.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists all users with access to a developer account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1.html b/docs/dyn/apigateway_v1.html index 0d152d622f..eb5769d9ae 100644 --- a/docs/dyn/apigateway_v1.html +++ b/docs/dyn/apigateway_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apigateway_v1.projects.locations.apis.configs.html b/docs/dyn/apigateway_v1.projects.locations.apis.configs.html index 40d5fe9f43..e4eaf37743 100644 --- a/docs/dyn/apigateway_v1.projects.locations.apis.configs.html +++ b/docs/dyn/apigateway_v1.projects.locations.apis.configs.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists ApiConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -403,17 +403,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1.projects.locations.apis.html b/docs/dyn/apigateway_v1.projects.locations.apis.html index f9e1fec47d..37697ba97f 100644 --- a/docs/dyn/apigateway_v1.projects.locations.apis.html +++ b/docs/dyn/apigateway_v1.projects.locations.apis.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Apis in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1.projects.locations.gateways.html b/docs/dyn/apigateway_v1.projects.locations.gateways.html index 03775835fe..44f2352922 100644 --- a/docs/dyn/apigateway_v1.projects.locations.gateways.html +++ b/docs/dyn/apigateway_v1.projects.locations.gateways.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Gateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1.projects.locations.html b/docs/dyn/apigateway_v1.projects.locations.html index dad4e59f5e..8121388efc 100644 --- a/docs/dyn/apigateway_v1.projects.locations.html +++ b/docs/dyn/apigateway_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigateway_v1.projects.locations.operations.html b/docs/dyn/apigateway_v1.projects.locations.operations.html index 5ffe16271a..afe6c9e96b 100644 --- a/docs/dyn/apigateway_v1.projects.locations.operations.html +++ b/docs/dyn/apigateway_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigateway_v1beta.html b/docs/dyn/apigateway_v1beta.html index 62ae9f47aa..aee4267952 100644 --- a/docs/dyn/apigateway_v1beta.html +++ b/docs/dyn/apigateway_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apigateway_v1beta.projects.locations.apis.configs.html b/docs/dyn/apigateway_v1beta.projects.locations.apis.configs.html index d468f913c0..e56dab0709 100644 --- a/docs/dyn/apigateway_v1beta.projects.locations.apis.configs.html +++ b/docs/dyn/apigateway_v1beta.projects.locations.apis.configs.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists ApiConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -418,17 +418,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1beta.projects.locations.apis.html b/docs/dyn/apigateway_v1beta.projects.locations.apis.html index 8a09c35569..e2c220a3a3 100644 --- a/docs/dyn/apigateway_v1beta.projects.locations.apis.html +++ b/docs/dyn/apigateway_v1beta.projects.locations.apis.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists Apis in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1beta.projects.locations.gateways.html b/docs/dyn/apigateway_v1beta.projects.locations.gateways.html index b79d519833..0f6976a186 100644 --- a/docs/dyn/apigateway_v1beta.projects.locations.gateways.html +++ b/docs/dyn/apigateway_v1beta.projects.locations.gateways.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Gateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigateway_v1beta.projects.locations.html b/docs/dyn/apigateway_v1beta.projects.locations.html index 35fe92a26c..09833e3297 100644 --- a/docs/dyn/apigateway_v1beta.projects.locations.html +++ b/docs/dyn/apigateway_v1beta.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigateway_v1beta.projects.locations.operations.html b/docs/dyn/apigateway_v1beta.projects.locations.operations.html index 98618ee7b2..fc2faa6b37 100644 --- a/docs/dyn/apigateway_v1beta.projects.locations.operations.html +++ b/docs/dyn/apigateway_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.html b/docs/dyn/apigee_v1.html index fe40610efc..9687d701e6 100644 --- a/docs/dyn/apigee_v1.html +++ b/docs/dyn/apigee_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apigee_v1.organizations.apimServiceExtensions.html b/docs/dyn/apigee_v1.organizations.apimServiceExtensions.html index 285cd06dd0..56d4d3b7a8 100644 --- a/docs/dyn/apigee_v1.organizations.apimServiceExtensions.html +++ b/docs/dyn/apigee_v1.organizations.apimServiceExtensions.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all APIM service extensions in an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.apis.debugsessions.html b/docs/dyn/apigee_v1.organizations.apis.debugsessions.html index 39a59e9fad..08d8541105 100644 --- a/docs/dyn/apigee_v1.organizations.apis.debugsessions.html +++ b/docs/dyn/apigee_v1.organizations.apis.debugsessions.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists debug sessions that are currently active in the given API Proxy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.apis.keyvaluemaps.entries.html b/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.entries.html index 3251ad3fd5..3ebd5c6984 100644 --- a/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.entries.html +++ b/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.entries.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.appgroups.apps.html b/docs/dyn/apigee_v1.organizations.appgroups.apps.html index f4430075db..4782f3c8b9 100644 --- a/docs/dyn/apigee_v1.organizations.appgroups.apps.html +++ b/docs/dyn/apigee_v1.organizations.appgroups.apps.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists all apps created by an AppGroup in an Apigee organization. Optionally, you can request an expanded view of the AppGroup apps. Lists all AppGroupApps in an AppGroup. A maximum of 1000 AppGroup apps are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, action=None, body=None, x__xgafv=None)

@@ -412,17 +412,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.appgroups.html b/docs/dyn/apigee_v1.organizations.appgroups.html index 05617a59bc..a7c0ef71fd 100644 --- a/docs/dyn/apigee_v1.organizations.appgroups.html +++ b/docs/dyn/apigee_v1.organizations.appgroups.html @@ -111,7 +111,7 @@

Instance Methods

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

Lists all AppGroups in an organization. A maximum of 1000 AppGroups are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, action=None, body=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.appgroups.subscriptions.html b/docs/dyn/apigee_v1.organizations.appgroups.subscriptions.html index 7f6d64cf1f..cb4de93638 100644 --- a/docs/dyn/apigee_v1.organizations.appgroups.subscriptions.html +++ b/docs/dyn/apigee_v1.organizations.appgroups.subscriptions.html @@ -90,7 +90,7 @@

Instance Methods

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

List all api product subscriptions for an appgroup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.apps.html b/docs/dyn/apigee_v1.organizations.apps.html index 59d80067cc..77f68b2183 100644 --- a/docs/dyn/apigee_v1.organizations.apps.html +++ b/docs/dyn/apigee_v1.organizations.apps.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, apiProduct=None, apptype=None, expand=None, filter=None, ids=None, includeCred=None, keyStatus=None, pageSize=None, pageToken=None, rows=None, startKey=None, status=None, x__xgafv=None)

Lists IDs of apps within an organization that have the specified app status (approved or revoked) or are of the specified app type (developer or company).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -247,17 +247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.datacollectors.html b/docs/dyn/apigee_v1.organizations.datacollectors.html index 20c9eb68be..0e37363b9e 100644 --- a/docs/dyn/apigee_v1.organizations.datacollectors.html +++ b/docs/dyn/apigee_v1.organizations.datacollectors.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all data collectors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.dnsZones.html b/docs/dyn/apigee_v1.organizations.dnsZones.html index 9ecb9539ae..755d012386 100644 --- a/docs/dyn/apigee_v1.organizations.dnsZones.html +++ b/docs/dyn/apigee_v1.organizations.dnsZones.html @@ -90,7 +90,7 @@

Instance Methods

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

Enumerates DNS zones that have been created but not yet deleted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.endpointAttachments.html b/docs/dyn/apigee_v1.organizations.endpointAttachments.html index 3c135b99f0..48e631af44 100644 --- a/docs/dyn/apigee_v1.organizations.endpointAttachments.html +++ b/docs/dyn/apigee_v1.organizations.endpointAttachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists the endpoint attachments in an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.envgroups.attachments.html b/docs/dyn/apigee_v1.organizations.envgroups.attachments.html index ffaf65bc7e..0974cb6a1e 100644 --- a/docs/dyn/apigee_v1.organizations.envgroups.attachments.html +++ b/docs/dyn/apigee_v1.organizations.envgroups.attachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all attachments of an environment group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -230,17 +230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.envgroups.html b/docs/dyn/apigee_v1.organizations.envgroups.html index d9042dcfc4..bd08057266 100644 --- a/docs/dyn/apigee_v1.organizations.envgroups.html +++ b/docs/dyn/apigee_v1.organizations.envgroups.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all environment groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html index baeabedfd9..1377380c6a 100644 --- a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html +++ b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists debug sessions that are currently active in the given API Proxy revision.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.environments.archiveDeployments.html b/docs/dyn/apigee_v1.organizations.environments.archiveDeployments.html index 7292cf1d19..bbf842fb12 100644 --- a/docs/dyn/apigee_v1.organizations.environments.archiveDeployments.html +++ b/docs/dyn/apigee_v1.organizations.environments.archiveDeployments.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists the ArchiveDeployments in the specified Environment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -285,17 +285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.entries.html b/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.entries.html index 1e74a9ff09..fedb5703b4 100644 --- a/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.entries.html +++ b/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.entries.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.environments.securityActions.html b/docs/dyn/apigee_v1.organizations.environments.securityActions.html index 2c14ee79b5..06ae6f35ea 100644 --- a/docs/dyn/apigee_v1.organizations.environments.securityActions.html +++ b/docs/dyn/apigee_v1.organizations.environments.securityActions.html @@ -96,7 +96,7 @@

Instance Methods

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

Returns a list of SecurityActions. This returns both enabled and disabled actions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -591,17 +591,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.environments.securityIncidents.html b/docs/dyn/apigee_v1.organizations.environments.securityIncidents.html index 7fde099a7a..8a8812a605 100644 --- a/docs/dyn/apigee_v1.organizations.environments.securityIncidents.html +++ b/docs/dyn/apigee_v1.organizations.environments.securityIncidents.html @@ -87,7 +87,7 @@

Instance Methods

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

ListSecurityIncidents lists all the security incident associated with the environment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -222,17 +222,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.environments.securityReports.html b/docs/dyn/apigee_v1.organizations.environments.securityReports.html index 2499185623..86f3a2b2e0 100644 --- a/docs/dyn/apigee_v1.organizations.environments.securityReports.html +++ b/docs/dyn/apigee_v1.organizations.environments.securityReports.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, dataset=None, from=None, pageSize=None, pageToken=None, status=None, submittedBy=None, to=None, x__xgafv=None)

Return a list of Security Reports

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -337,17 +337,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.environments.securityStats.html b/docs/dyn/apigee_v1.organizations.environments.securityStats.html index 7752b2c3e6..af3a4f17b1 100644 --- a/docs/dyn/apigee_v1.organizations.environments.securityStats.html +++ b/docs/dyn/apigee_v1.organizations.environments.securityStats.html @@ -81,13 +81,13 @@

Instance Methods

queryTabularStats(orgenv, body=None, x__xgafv=None)

Retrieve security statistics as tabular rows.

- queryTabularStats_next(previous_request, previous_response)

+ queryTabularStats_next()

Retrieves the next page of results.

queryTimeSeriesStats(orgenv, body=None, x__xgafv=None)

Retrieve security statistics as a collection of time series.

- queryTimeSeriesStats_next(previous_request, previous_response)

+ queryTimeSeriesStats_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- queryTabularStats_next(previous_request, previous_response) + queryTabularStats_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)
+        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.
-
+ 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. +
@@ -219,17 +219,17 @@

Method Details

- queryTimeSeriesStats_next(previous_request, previous_response) + queryTimeSeriesStats_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)
+        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.
-
+ 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/apigee_v1.organizations.environments.targetservers.html b/docs/dyn/apigee_v1.organizations.environments.targetservers.html index 6a721737eb..b906cddf6f 100644 --- a/docs/dyn/apigee_v1.organizations.environments.targetservers.html +++ b/docs/dyn/apigee_v1.organizations.environments.targetservers.html @@ -108,7 +108,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. @@ -145,7 +145,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. @@ -188,7 +188,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. @@ -231,7 +231,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. @@ -269,7 +269,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. @@ -305,7 +305,7 @@

Method Details

"description": "A String", # Optional. A human-readable description of this TargetServer. "host": "A String", # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123. "isEnabled": True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true. - "name": "A String", # Required. The resource id of this target server. Values must match the regular expression + "name": "A String", # Required. The resource id of this target server. "port": 42, # Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive. "protocol": "A String", # Immutable. The protocol used by this TargetServer. "sSLInfo": { # TLS configuration information for virtual hosts and TargetServers. # Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration. diff --git a/docs/dyn/apigee_v1.organizations.environments.traceConfig.overrides.html b/docs/dyn/apigee_v1.organizations.environments.traceConfig.overrides.html index df420d3df9..55b442a20e 100644 --- a/docs/dyn/apigee_v1.organizations.environments.traceConfig.overrides.html +++ b/docs/dyn/apigee_v1.organizations.environments.traceConfig.overrides.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all of the distributed trace configuration overrides in an environment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.hostSecurityReports.html b/docs/dyn/apigee_v1.organizations.hostSecurityReports.html index 571f18eae7..ce524ef29c 100644 --- a/docs/dyn/apigee_v1.organizations.hostSecurityReports.html +++ b/docs/dyn/apigee_v1.organizations.hostSecurityReports.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, dataset=None, envgroupHostname=None, from=None, pageSize=None, pageToken=None, status=None, submittedBy=None, to=None, x__xgafv=None)

Return a list of Security Reports at host level.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -338,17 +338,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.instances.attachments.html b/docs/dyn/apigee_v1.organizations.instances.attachments.html index ddc1860037..a7b122b699 100644 --- a/docs/dyn/apigee_v1.organizations.instances.attachments.html +++ b/docs/dyn/apigee_v1.organizations.instances.attachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all attachments to an instance. **Note:** Not supported for Apigee hybrid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.instances.html b/docs/dyn/apigee_v1.organizations.instances.html index b2a16f694c..7409e8013d 100644 --- a/docs/dyn/apigee_v1.organizations.instances.html +++ b/docs/dyn/apigee_v1.organizations.instances.html @@ -105,7 +105,7 @@

Instance Methods

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

Lists all Apigee runtime instances for the organization. **Note:** Not supported for Apigee hybrid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -356,17 +356,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.instances.natAddresses.html b/docs/dyn/apigee_v1.organizations.instances.natAddresses.html index 8c1237f2a9..9f90cf1dab 100644 --- a/docs/dyn/apigee_v1.organizations.instances.natAddresses.html +++ b/docs/dyn/apigee_v1.organizations.instances.natAddresses.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists the NAT addresses for an Apigee instance. **Note:** Not supported for Apigee hybrid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -271,17 +271,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.keyvaluemaps.entries.html b/docs/dyn/apigee_v1.organizations.keyvaluemaps.entries.html index d2c2f7a32c..a82c8ee695 100644 --- a/docs/dyn/apigee_v1.organizations.keyvaluemaps.entries.html +++ b/docs/dyn/apigee_v1.organizations.keyvaluemaps.entries.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.operations.html b/docs/dyn/apigee_v1.organizations.operations.html index f8fbdfaf79..351fc2b239 100644 --- a/docs/dyn/apigee_v1.organizations.operations.html +++ b/docs/dyn/apigee_v1.organizations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apigee_v1.organizations.securityAssessmentResults.html b/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html index e427bff1df..1f6e058df6 100644 --- a/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html +++ b/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html @@ -78,7 +78,7 @@

Instance Methods

batchCompute(name, body=None, x__xgafv=None)

Compute RAV2 security scores for a set of resources.

- batchCompute_next(previous_request, previous_response)

+ batchCompute_next()

Retrieves the next page of results.

close()

@@ -187,17 +187,17 @@

Method Details

- batchCompute_next(previous_request, previous_response) + batchCompute_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.securityFeedback.html b/docs/dyn/apigee_v1.organizations.securityFeedback.html index c7709c9c3e..3014b0381e 100644 --- a/docs/dyn/apigee_v1.organizations.securityFeedback.html +++ b/docs/dyn/apigee_v1.organizations.securityFeedback.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all feedback reports which have already been submitted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html index da5b334363..642bccc27e 100644 --- a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html +++ b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html @@ -90,7 +90,7 @@

Instance Methods

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

List security monitoring conditions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.securityProfiles.environments.html b/docs/dyn/apigee_v1.organizations.securityProfiles.environments.html index 6cfe38e74a..feab4bba21 100644 --- a/docs/dyn/apigee_v1.organizations.securityProfiles.environments.html +++ b/docs/dyn/apigee_v1.organizations.securityProfiles.environments.html @@ -81,7 +81,7 @@

Instance Methods

computeEnvironmentScores(profileEnvironment, body=None, x__xgafv=None)

ComputeEnvironmentScores calculates scores for requested time range for the specified security profile and environment.

- computeEnvironmentScores_next(previous_request, previous_response)

+ computeEnvironmentScores_next()

Retrieves the next page of results.

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

@@ -190,17 +190,17 @@

Method Details

- computeEnvironmentScores_next(previous_request, previous_response) + computeEnvironmentScores_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.securityProfiles.html b/docs/dyn/apigee_v1.organizations.securityProfiles.html index 499298a337..bb01a75b66 100644 --- a/docs/dyn/apigee_v1.organizations.securityProfiles.html +++ b/docs/dyn/apigee_v1.organizations.securityProfiles.html @@ -98,10 +98,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, x__xgafv=None)

ListSecurityProfileRevisions lists all the revisions of the security profile.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -424,31 +424,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.securityProfilesV2.html b/docs/dyn/apigee_v1.organizations.securityProfilesV2.html index bd272c4a88..79757a41c8 100644 --- a/docs/dyn/apigee_v1.organizations.securityProfilesV2.html +++ b/docs/dyn/apigee_v1.organizations.securityProfilesV2.html @@ -90,7 +90,7 @@

Instance Methods

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

List security profiles v2.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.sites.apidocs.html b/docs/dyn/apigee_v1.organizations.sites.apidocs.html index b649180e03..61cc79195d 100644 --- a/docs/dyn/apigee_v1.organizations.sites.apidocs.html +++ b/docs/dyn/apigee_v1.organizations.sites.apidocs.html @@ -93,7 +93,7 @@

Instance Methods

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

Returns the catalog items associated with a portal.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apigee_v1.organizations.spaces.html b/docs/dyn/apigee_v1.organizations.spaces.html index 4b38920eba..435aa63e99 100644 --- a/docs/dyn/apigee_v1.organizations.spaces.html +++ b/docs/dyn/apigee_v1.organizations.spaces.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists spaces under an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.html b/docs/dyn/apihub_v1.html index 719abe8a42..91014d65f0 100644 --- a/docs/dyn/apihub_v1.html +++ b/docs/dyn/apihub_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apihub_v1.projects.locations.addons.html b/docs/dyn/apihub_v1.projects.locations.addons.html index a2167b2292..1ca5dbfee0 100644 --- a/docs/dyn/apihub_v1.projects.locations.addons.html +++ b/docs/dyn/apihub_v1.projects.locations.addons.html @@ -84,7 +84,7 @@

Instance Methods

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

List addons.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

manageConfig(name, body=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.apis.html b/docs/dyn/apihub_v1.projects.locations.apis.html index 3f04831653..c2bc759e9d 100644 --- a/docs/dyn/apihub_v1.projects.locations.apis.html +++ b/docs/dyn/apihub_v1.projects.locations.apis.html @@ -95,7 +95,7 @@

Instance Methods

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

List API resources in the API hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1327,17 +1327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.apis.versions.html b/docs/dyn/apihub_v1.projects.locations.apis.versions.html index b28397e1fa..06c1d82448 100644 --- a/docs/dyn/apihub_v1.projects.locations.apis.versions.html +++ b/docs/dyn/apihub_v1.projects.locations.apis.versions.html @@ -105,7 +105,7 @@

Instance Methods

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

List API versions of an API resource in the API hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -793,17 +793,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.apis.versions.operations.html b/docs/dyn/apihub_v1.projects.locations.apis.versions.operations.html index 7085b1a622..f85802f1a2 100644 --- a/docs/dyn/apihub_v1.projects.locations.apis.versions.operations.html +++ b/docs/dyn/apihub_v1.projects.locations.apis.versions.operations.html @@ -90,7 +90,7 @@

Instance Methods

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

List operations in an API version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -541,17 +541,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.apis.versions.specs.html b/docs/dyn/apihub_v1.projects.locations.apis.versions.specs.html index eb9ed77809..8cd42ad1f3 100644 --- a/docs/dyn/apihub_v1.projects.locations.apis.versions.specs.html +++ b/docs/dyn/apihub_v1.projects.locations.apis.versions.specs.html @@ -99,7 +99,7 @@

Instance Methods

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

List specs corresponding to a particular API resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -849,17 +849,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.attributes.html b/docs/dyn/apihub_v1.projects.locations.attributes.html index ae51fce55f..fd80df4ed8 100644 --- a/docs/dyn/apihub_v1.projects.locations.attributes.html +++ b/docs/dyn/apihub_v1.projects.locations.attributes.html @@ -90,7 +90,7 @@

Instance Methods

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

List all attributes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.curations.html b/docs/dyn/apihub_v1.projects.locations.curations.html index 89026daec1..026881166d 100644 --- a/docs/dyn/apihub_v1.projects.locations.curations.html +++ b/docs/dyn/apihub_v1.projects.locations.curations.html @@ -90,7 +90,7 @@

Instance Methods

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

List curation resources in the API hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.dependencies.html b/docs/dyn/apihub_v1.projects.locations.dependencies.html index 7f9bc6917f..444aaa6acc 100644 --- a/docs/dyn/apihub_v1.projects.locations.dependencies.html +++ b/docs/dyn/apihub_v1.projects.locations.dependencies.html @@ -90,7 +90,7 @@

Instance Methods

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

List dependencies based on the provided filter and pagination parameters.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -389,17 +389,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.deployments.html b/docs/dyn/apihub_v1.projects.locations.deployments.html index 6e917c5011..7450b04ba3 100644 --- a/docs/dyn/apihub_v1.projects.locations.deployments.html +++ b/docs/dyn/apihub_v1.projects.locations.deployments.html @@ -90,7 +90,7 @@

Instance Methods

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

List deployment resources in the API hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1013,17 +1013,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.discoveredApiOperations.html b/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.discoveredApiOperations.html index b1faa71ba1..c1dcf02e24 100644 --- a/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.discoveredApiOperations.html +++ b/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.discoveredApiOperations.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all the DiscoveredAPIOperations in a given project, location and ApiObservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apihub_v1.projects.locations.discoveredApiObservations.html b/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.html index f5fe35a501..34efb740c8 100644 --- a/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.html +++ b/docs/dyn/apihub_v1.projects.locations.discoveredApiObservations.html @@ -89,7 +89,7 @@

Instance Methods

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

Lists all the DiscoveredAPIObservations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apihub_v1.projects.locations.externalApis.html b/docs/dyn/apihub_v1.projects.locations.externalApis.html index 1f3e6ae0b7..ee89681153 100644 --- a/docs/dyn/apihub_v1.projects.locations.externalApis.html +++ b/docs/dyn/apihub_v1.projects.locations.externalApis.html @@ -90,7 +90,7 @@

Instance Methods

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

List External API resources in the API hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.hostProjectRegistrations.html b/docs/dyn/apihub_v1.projects.locations.hostProjectRegistrations.html index 1dd7c9ffd1..98517b3af8 100644 --- a/docs/dyn/apihub_v1.projects.locations.hostProjectRegistrations.html +++ b/docs/dyn/apihub_v1.projects.locations.hostProjectRegistrations.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists host project registrations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apihub_v1.projects.locations.html b/docs/dyn/apihub_v1.projects.locations.html index 7301a3fef3..45eae92853 100644 --- a/docs/dyn/apihub_v1.projects.locations.html +++ b/docs/dyn/apihub_v1.projects.locations.html @@ -157,7 +157,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupRuntimeProjectAttachment(name, x__xgafv=None)

@@ -166,13 +166,13 @@

Instance Methods

retrieveApiViews(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Retrieve API views.

- retrieveApiViews_next(previous_request, previous_response)

+ retrieveApiViews_next()

Retrieves the next page of results.

searchResources(location, body=None, x__xgafv=None)

Search across API-Hub resources.

- searchResources_next(previous_request, previous_response)

+ searchResources_next()

Retrieves the next page of results.

Method Details

@@ -1110,17 +1110,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2556,17 +2556,17 @@

Method Details

- retrieveApiViews_next(previous_request, previous_response) + retrieveApiViews_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)
+        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.
-
+ 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. +
@@ -3523,17 +3523,17 @@

Method Details

- searchResources_next(previous_request, previous_response) + searchResources_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)
+        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.
-
+ 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/apihub_v1.projects.locations.operations.html b/docs/dyn/apihub_v1.projects.locations.operations.html index 0915b5de23..7843914a53 100644 --- a/docs/dyn/apihub_v1.projects.locations.operations.html +++ b/docs/dyn/apihub_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apihub_v1.projects.locations.plugins.html b/docs/dyn/apihub_v1.projects.locations.plugins.html index 30ddefa761..7b47442174 100644 --- a/docs/dyn/apihub_v1.projects.locations.plugins.html +++ b/docs/dyn/apihub_v1.projects.locations.plugins.html @@ -109,7 +109,7 @@

Instance Methods

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

List all the plugins in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateStyleGuide(name, body=None, updateMask=None, x__xgafv=None)

@@ -801,17 +801,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.plugins.instances.html b/docs/dyn/apihub_v1.projects.locations.plugins.instances.html index 003db6efad..71a38c10f8 100644 --- a/docs/dyn/apihub_v1.projects.locations.plugins.instances.html +++ b/docs/dyn/apihub_v1.projects.locations.plugins.instances.html @@ -99,7 +99,7 @@

Instance Methods

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

List all the plugins in a given project and location. `-` can be used as wildcard value for {plugin_id}

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

manageSourceData(name, body=None, x__xgafv=None)

@@ -675,17 +675,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apihub_v1.projects.locations.runtimeProjectAttachments.html b/docs/dyn/apihub_v1.projects.locations.runtimeProjectAttachments.html index 4dbc9519ff..cc1457d085 100644 --- a/docs/dyn/apihub_v1.projects.locations.runtimeProjectAttachments.html +++ b/docs/dyn/apihub_v1.projects.locations.runtimeProjectAttachments.html @@ -90,7 +90,7 @@

Instance Methods

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

List runtime projects attached to the host project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apikeys_v2.html b/docs/dyn/apikeys_v2.html index 84d3d68e5d..40db63e66d 100644 --- a/docs/dyn/apikeys_v2.html +++ b/docs/dyn/apikeys_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apikeys_v2.projects.locations.keys.html b/docs/dyn/apikeys_v2.projects.locations.keys.html index a3e75fbcad..a00c4a207c 100644 --- a/docs/dyn/apikeys_v2.projects.locations.keys.html +++ b/docs/dyn/apikeys_v2.projects.locations.keys.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists the API keys owned by a project. The key string of the API key isn't included in the response. NOTE: Key is a global resource; hence the only supported value for location is `global`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -389,17 +389,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apim_v1alpha.html b/docs/dyn/apim_v1alpha.html index f395fb931c..11ee1f472b 100644 --- a/docs/dyn/apim_v1alpha.html +++ b/docs/dyn/apim_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apim_v1alpha.projects.locations.html b/docs/dyn/apim_v1alpha.projects.locations.html index c1b5061880..5cce5f5993 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.html +++ b/docs/dyn/apim_v1alpha.projects.locations.html @@ -105,10 +105,10 @@

Instance Methods

listApiObservationTags(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListApiObservationTags lists all extant tags on any observation in the given project.

- listApiObservationTags_next(previous_request, previous_response)

+ listApiObservationTags_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,31 +227,31 @@

Method Details

- listApiObservationTags_next(previous_request, previous_response) + listApiObservationTags_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/apim_v1alpha.projects.locations.observationJobs.apiObservations.apiOperations.html b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.apiOperations.html index 2c3ce4cf65..e4eec03677 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.apiOperations.html +++ b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.apiOperations.html @@ -84,7 +84,7 @@

Instance Methods

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

ListApiOperations gets all ApiOperations for a given project and location and ObservationJob and ApiObservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apim_v1alpha.projects.locations.observationJobs.apiObservations.html b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.html index 01f2abef4a..3712e36d21 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.html +++ b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.apiObservations.html @@ -92,7 +92,7 @@

Instance Methods

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

ListApiObservations gets all ApiObservations for a given project and location and ObservationJob.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apim_v1alpha.projects.locations.observationJobs.html b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.html index 351744c216..b8008fb41a 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.observationJobs.html +++ b/docs/dyn/apim_v1alpha.projects.locations.observationJobs.html @@ -101,7 +101,7 @@

Instance Methods

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

ListObservationJobs gets all ObservationJobs for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -337,17 +337,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apim_v1alpha.projects.locations.observationSources.html b/docs/dyn/apim_v1alpha.projects.locations.observationSources.html index 1f82d170a8..da4f26b789 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.observationSources.html +++ b/docs/dyn/apim_v1alpha.projects.locations.observationSources.html @@ -90,7 +90,7 @@

Instance Methods

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

ListObservationSources gets all ObservationSources for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apim_v1alpha.projects.locations.operations.html b/docs/dyn/apim_v1alpha.projects.locations.operations.html index b11120d182..b6e41d7e86 100644 --- a/docs/dyn/apim_v1alpha.projects.locations.operations.html +++ b/docs/dyn/apim_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.apps.authorizedCertificates.html b/docs/dyn/appengine_v1.apps.authorizedCertificates.html index 9d2c54c1c0..0ca7d97542 100644 --- a/docs/dyn/appengine_v1.apps.authorizedCertificates.html +++ b/docs/dyn/appengine_v1.apps.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(appsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.apps.authorizedDomains.html b/docs/dyn/appengine_v1.apps.authorizedDomains.html index 6412e9ec19..b90dc1d58b 100644 --- a/docs/dyn/appengine_v1.apps.authorizedDomains.html +++ b/docs/dyn/appengine_v1.apps.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.apps.domainMappings.html b/docs/dyn/appengine_v1.apps.domainMappings.html index ba9d692c5d..676db1bbbe 100644 --- a/docs/dyn/appengine_v1.apps.domainMappings.html +++ b/docs/dyn/appengine_v1.apps.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, domainMappingsId, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.apps.firewall.ingressRules.html b/docs/dyn/appengine_v1.apps.firewall.ingressRules.html index d1ce9b7f4f..e0b21744c0 100644 --- a/docs/dyn/appengine_v1.apps.firewall.ingressRules.html +++ b/docs/dyn/appengine_v1.apps.firewall.ingressRules.html @@ -93,7 +93,7 @@

Instance Methods

list(appsId, matchingAddress=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the firewall rules of an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, ingressRulesId, body=None, updateMask=None, x__xgafv=None)

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.apps.locations.html b/docs/dyn/appengine_v1.apps.locations.html index 368c0d4c12..465113c813 100644 --- a/docs/dyn/appengine_v1.apps.locations.html +++ b/docs/dyn/appengine_v1.apps.locations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.apps.operations.html b/docs/dyn/appengine_v1.apps.operations.html index 7d77e9250c..421543a823 100644 --- a/docs/dyn/appengine_v1.apps.operations.html +++ b/docs/dyn/appengine_v1.apps.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.apps.services.html b/docs/dyn/appengine_v1.apps.services.html index c431b6eb47..153b2aa0f8 100644 --- a/docs/dyn/appengine_v1.apps.services.html +++ b/docs/dyn/appengine_v1.apps.services.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists all the services in the application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, servicesId, body=None, migrateTraffic=None, updateMask=None, x__xgafv=None)

@@ -218,17 +218,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.apps.services.versions.html b/docs/dyn/appengine_v1.apps.services.versions.html index c6cc9e3fc9..fab2c353a4 100644 --- a/docs/dyn/appengine_v1.apps.services.versions.html +++ b/docs/dyn/appengine_v1.apps.services.versions.html @@ -98,7 +98,7 @@

Instance Methods

list(appsId, servicesId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the versions of a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, servicesId, versionsId, body=None, updateMask=None, x__xgafv=None)

@@ -935,17 +935,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.apps.services.versions.instances.html b/docs/dyn/appengine_v1.apps.services.versions.instances.html index 2c9c57d8e0..0116c9b544 100644 --- a/docs/dyn/appengine_v1.apps.services.versions.instances.html +++ b/docs/dyn/appengine_v1.apps.services.versions.instances.html @@ -90,7 +90,7 @@

Instance Methods

list(appsId, servicesId, versionsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.html b/docs/dyn/appengine_v1.html index 9c512840bb..e3a584d120 100644 --- a/docs/dyn/appengine_v1.html +++ b/docs/dyn/appengine_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html index c767f7602d..ae16f09aab 100644 --- a/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html +++ b/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html index 02e068f5ca..0a899bda0a 100644 --- a/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html +++ b/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html index ede048ee0a..ef6d51d550 100644 --- a/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html +++ b/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, domainMappingsId, body=None, updateMask=None, x__xgafv=None)

@@ -278,17 +278,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html b/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html index b1e807bcf7..9d53ae49e0 100644 --- a/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html +++ b/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(appsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html b/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html index a50e77f496..7c4ea561d7 100644 --- a/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html +++ b/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1alpha.apps.domainMappings.html b/docs/dyn/appengine_v1alpha.apps.domainMappings.html index af67dfe946..cb089e828c 100644 --- a/docs/dyn/appengine_v1alpha.apps.domainMappings.html +++ b/docs/dyn/appengine_v1alpha.apps.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, domainMappingsId, body=None, noManagedCertificate=None, updateMask=None, x__xgafv=None)

@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1alpha.apps.locations.html b/docs/dyn/appengine_v1alpha.apps.locations.html index db286f6bde..e3b9ffd77e 100644 --- a/docs/dyn/appengine_v1alpha.apps.locations.html +++ b/docs/dyn/appengine_v1alpha.apps.locations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1alpha.apps.operations.html b/docs/dyn/appengine_v1alpha.apps.operations.html index 8d0fbe5f58..f80b196d91 100644 --- a/docs/dyn/appengine_v1alpha.apps.operations.html +++ b/docs/dyn/appengine_v1alpha.apps.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1alpha.html b/docs/dyn/appengine_v1alpha.html index baf42515c3..1abaa2c1ec 100644 --- a/docs/dyn/appengine_v1alpha.html +++ b/docs/dyn/appengine_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html index 39b1024c67..218dc69740 100644 --- a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html +++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html index 4d1cb8bcbe..46fc10ec36 100644 --- a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html +++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1alpha.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html index 4340d2fb7c..128845d3a7 100644 --- a/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html +++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, domainMappingsId, body=None, noManagedCertificate=None, updateMask=None, x__xgafv=None)

@@ -276,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1alpha.projects.locations.html b/docs/dyn/appengine_v1alpha.projects.locations.html index 54756dec19..eca728a90c 100644 --- a/docs/dyn/appengine_v1alpha.projects.locations.html +++ b/docs/dyn/appengine_v1alpha.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(projectsId, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1alpha.projects.locations.operations.html b/docs/dyn/appengine_v1alpha.projects.locations.operations.html index 3f33e6ece8..c60d029c10 100644 --- a/docs/dyn/appengine_v1alpha.projects.locations.operations.html +++ b/docs/dyn/appengine_v1alpha.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(projectsId, locationsId, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.apps.authorizedCertificates.html b/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html index 680cec3ba4..cc8465943a 100644 --- a/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html +++ b/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(appsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.apps.authorizedDomains.html b/docs/dyn/appengine_v1beta.apps.authorizedDomains.html index b1b00d78cf..5dc467e73a 100644 --- a/docs/dyn/appengine_v1beta.apps.authorizedDomains.html +++ b/docs/dyn/appengine_v1beta.apps.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.apps.domainMappings.html b/docs/dyn/appengine_v1beta.apps.domainMappings.html index 13776091fe..90c0674da0 100644 --- a/docs/dyn/appengine_v1beta.apps.domainMappings.html +++ b/docs/dyn/appengine_v1beta.apps.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, domainMappingsId, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html b/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html index 54e3d536d2..8030a6032d 100644 --- a/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html +++ b/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html @@ -93,7 +93,7 @@

Instance Methods

list(appsId, matchingAddress=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the firewall rules of an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, ingressRulesId, body=None, updateMask=None, x__xgafv=None)

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.apps.locations.html b/docs/dyn/appengine_v1beta.apps.locations.html index de6d34c1a6..69a376a095 100644 --- a/docs/dyn/appengine_v1beta.apps.locations.html +++ b/docs/dyn/appengine_v1beta.apps.locations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.apps.operations.html b/docs/dyn/appengine_v1beta.apps.operations.html index 81b4d088a6..13c22649c1 100644 --- a/docs/dyn/appengine_v1beta.apps.operations.html +++ b/docs/dyn/appengine_v1beta.apps.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(appsId, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.apps.services.html b/docs/dyn/appengine_v1beta.apps.services.html index 724f817a20..c97afb2e38 100644 --- a/docs/dyn/appengine_v1beta.apps.services.html +++ b/docs/dyn/appengine_v1beta.apps.services.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists all the services in the application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, servicesId, body=None, migrateTraffic=None, updateMask=None, x__xgafv=None)

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.apps.services.versions.html b/docs/dyn/appengine_v1beta.apps.services.versions.html index 14388dd138..65a401519d 100644 --- a/docs/dyn/appengine_v1beta.apps.services.versions.html +++ b/docs/dyn/appengine_v1beta.apps.services.versions.html @@ -98,7 +98,7 @@

Instance Methods

list(appsId, servicesId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the versions of a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(appsId, servicesId, versionsId, body=None, updateMask=None, x__xgafv=None)

@@ -1012,17 +1012,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.apps.services.versions.instances.html b/docs/dyn/appengine_v1beta.apps.services.versions.instances.html index 5e8dcaef34..62ac17e343 100644 --- a/docs/dyn/appengine_v1beta.apps.services.versions.instances.html +++ b/docs/dyn/appengine_v1beta.apps.services.versions.instances.html @@ -90,7 +90,7 @@

Instance Methods

list(appsId, servicesId, versionsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.html b/docs/dyn/appengine_v1beta.html index c576983f31..5896b1d234 100644 --- a/docs/dyn/appengine_v1beta.html +++ b/docs/dyn/appengine_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html index 315a8e269b..dabbdd8690 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html +++ b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all SSL certificates the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, authorizedCertificatesId, body=None, updateMask=None, x__xgafv=None)

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html index cc4c00d0e9..4bf7899718 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html +++ b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html @@ -81,7 +81,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all domains the user is authorized to administer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html index 44a6ebcb04..b161429125 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html +++ b/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html @@ -90,7 +90,7 @@

Instance Methods

list(projectsId, locationsId, applicationsId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domain mappings on an application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectsId, locationsId, applicationsId, domainMappingsId, body=None, updateMask=None, x__xgafv=None)

@@ -278,17 +278,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/appengine_v1beta.projects.locations.html b/docs/dyn/appengine_v1beta.projects.locations.html index a343e1a6a4..b755b3b9d8 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.html +++ b/docs/dyn/appengine_v1beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(projectsId, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appengine_v1beta.projects.locations.operations.html b/docs/dyn/appengine_v1beta.projects.locations.operations.html index 94c3c202bf..004bdaabe6 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.operations.html +++ b/docs/dyn/appengine_v1beta.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(projectsId, locationsId, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1.html b/docs/dyn/apphub_v1.html index 06bf2f2c36..a58e94025b 100644 --- a/docs/dyn/apphub_v1.html +++ b/docs/dyn/apphub_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apphub_v1.projects.locations.applications.html b/docs/dyn/apphub_v1.projects.locations.applications.html index 3ad7f3894e..c94e2a82fd 100644 --- a/docs/dyn/apphub_v1.projects.locations.applications.html +++ b/docs/dyn/apphub_v1.projects.locations.applications.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists Applications in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.applications.services.html b/docs/dyn/apphub_v1.projects.locations.applications.services.html index c0eba7650d..3c1ed75af5 100644 --- a/docs/dyn/apphub_v1.projects.locations.applications.services.html +++ b/docs/dyn/apphub_v1.projects.locations.applications.services.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Services in an Application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -403,17 +403,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.applications.workloads.html b/docs/dyn/apphub_v1.projects.locations.applications.workloads.html index 8dc8bb9e37..6818dd6334 100644 --- a/docs/dyn/apphub_v1.projects.locations.applications.workloads.html +++ b/docs/dyn/apphub_v1.projects.locations.applications.workloads.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Workloads in an Application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.discoveredServices.html b/docs/dyn/apphub_v1.projects.locations.discoveredServices.html index e5406cfb22..c9b6a6ae53 100644 --- a/docs/dyn/apphub_v1.projects.locations.discoveredServices.html +++ b/docs/dyn/apphub_v1.projects.locations.discoveredServices.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Discovered Services that can be added to an Application in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, uri=None, x__xgafv=None)

@@ -194,17 +194,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.discoveredWorkloads.html b/docs/dyn/apphub_v1.projects.locations.discoveredWorkloads.html index b3009e91d7..3b7473b0df 100644 --- a/docs/dyn/apphub_v1.projects.locations.discoveredWorkloads.html +++ b/docs/dyn/apphub_v1.projects.locations.discoveredWorkloads.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Discovered Workloads that can be added to an Application in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, uri=None, x__xgafv=None)

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.extendedMetadataSchemas.html b/docs/dyn/apphub_v1.projects.locations.extendedMetadataSchemas.html index d6a3d605f7..a5bc6365ee 100644 --- a/docs/dyn/apphub_v1.projects.locations.extendedMetadataSchemas.html +++ b/docs/dyn/apphub_v1.projects.locations.extendedMetadataSchemas.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Extended Metadata Schemas available in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1.projects.locations.html b/docs/dyn/apphub_v1.projects.locations.html index 3d47a4afff..59b7614d3c 100644 --- a/docs/dyn/apphub_v1.projects.locations.html +++ b/docs/dyn/apphub_v1.projects.locations.html @@ -120,7 +120,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupServiceProjectAttachment(name, x__xgafv=None)

@@ -245,17 +245,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1.projects.locations.operations.html b/docs/dyn/apphub_v1.projects.locations.operations.html index d05e2365f1..f4235465de 100644 --- a/docs/dyn/apphub_v1.projects.locations.operations.html +++ b/docs/dyn/apphub_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1.projects.locations.serviceProjectAttachments.html b/docs/dyn/apphub_v1.projects.locations.serviceProjectAttachments.html index 8b06bdca14..ef08bc3021 100644 --- a/docs/dyn/apphub_v1.projects.locations.serviceProjectAttachments.html +++ b/docs/dyn/apphub_v1.projects.locations.serviceProjectAttachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists service projects attached to the host project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -241,17 +241,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1alpha.html b/docs/dyn/apphub_v1alpha.html index f5705668de..40ac8f425a 100644 --- a/docs/dyn/apphub_v1alpha.html +++ b/docs/dyn/apphub_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/apphub_v1alpha.projects.locations.applications.html b/docs/dyn/apphub_v1alpha.projects.locations.applications.html index d983abd062..3c3299db50 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.applications.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.applications.html @@ -103,7 +103,7 @@

Instance Methods

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

Lists Applications in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -440,17 +440,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.applications.services.html b/docs/dyn/apphub_v1alpha.projects.locations.applications.services.html index eeaea09b2a..02bbf8d3fb 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.applications.services.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.applications.services.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Services in an Application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -442,17 +442,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.applications.workloads.html b/docs/dyn/apphub_v1alpha.projects.locations.applications.workloads.html index b98f6729e3..38c617b8bb 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.applications.workloads.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.applications.workloads.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Workloads in an Application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -430,17 +430,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.discoveredServices.html b/docs/dyn/apphub_v1alpha.projects.locations.discoveredServices.html index e54cb00e60..35258d24f7 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.discoveredServices.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.discoveredServices.html @@ -81,7 +81,7 @@

Instance Methods

findUnregistered(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Finds unregistered services in a host project and location.

- findUnregistered_next(previous_request, previous_response)

+ findUnregistered_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

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

Lists Discovered Services that can be added to an Application in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, uri=None, x__xgafv=None)

@@ -158,17 +158,17 @@

Method Details

- findUnregistered_next(previous_request, previous_response) + findUnregistered_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)
+        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.
-
+ 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. +
@@ -272,17 +272,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.discoveredWorkloads.html b/docs/dyn/apphub_v1alpha.projects.locations.discoveredWorkloads.html index a28322ecce..d70773a123 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.discoveredWorkloads.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.discoveredWorkloads.html @@ -81,7 +81,7 @@

Instance Methods

findUnregistered(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Finds unregistered workloads in a host project and location.

- findUnregistered_next(previous_request, previous_response)

+ findUnregistered_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

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

Lists Discovered Workloads that can be added to an Application in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, uri=None, x__xgafv=None)

@@ -154,17 +154,17 @@

Method Details

- findUnregistered_next(previous_request, previous_response) + findUnregistered_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)
+        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.
-
+ 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. +
@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.extendedMetadataSchemas.html b/docs/dyn/apphub_v1alpha.projects.locations.extendedMetadataSchemas.html index 9fe958be65..3cd76012c8 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.extendedMetadataSchemas.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.extendedMetadataSchemas.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Extended Metadata Schemas available in a host project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1alpha.projects.locations.html b/docs/dyn/apphub_v1alpha.projects.locations.html index b4a742f25b..e7d9c06e94 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.html @@ -120,7 +120,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupServiceProjectAttachment(name, x__xgafv=None)

@@ -245,17 +245,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.operations.html b/docs/dyn/apphub_v1alpha.projects.locations.operations.html index 55b4b3c4a0..aa1bf18a7c 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.operations.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/apphub_v1alpha.projects.locations.serviceProjectAttachments.html b/docs/dyn/apphub_v1alpha.projects.locations.serviceProjectAttachments.html index 093172e488..013cd58677 100644 --- a/docs/dyn/apphub_v1alpha.projects.locations.serviceProjectAttachments.html +++ b/docs/dyn/apphub_v1alpha.projects.locations.serviceProjectAttachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists service projects attached to the host project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -241,17 +241,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/appsmarket_v2.html b/docs/dyn/appsmarket_v2.html index 38e8284923..2185a65992 100644 --- a/docs/dyn/appsmarket_v2.html +++ b/docs/dyn/appsmarket_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/areainsights_v1.html b/docs/dyn/areainsights_v1.html index 5c0789d136..702c0fd34b 100644 --- a/docs/dyn/areainsights_v1.html +++ b/docs/dyn/areainsights_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/artifactregistry_v1.html b/docs/dyn/artifactregistry_v1.html index 75234f1092..9cd086ebfb 100644 --- a/docs/dyn/artifactregistry_v1.html +++ b/docs/dyn/artifactregistry_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/artifactregistry_v1.projects.locations.html b/docs/dyn/artifactregistry_v1.projects.locations.html index 2cecb1cb73..0bda179824 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.html @@ -100,7 +100,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateProjectConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.attachments.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.attachments.html index d7f1956aeb..b1e2798437 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.attachments.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.attachments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists attachments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.dockerImages.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.dockerImages.html index 4595f8a84e..0a1705594f 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.dockerImages.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.dockerImages.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists docker images.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.files.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.files.html index 183fa298fa..2d02ec5f48 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.files.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.files.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists files.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.html index 5a6d52186b..8e0e1407e8 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.html @@ -174,7 +174,7 @@

Instance Methods

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

Lists repositories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -806,17 +806,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.mavenArtifacts.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.mavenArtifacts.html index e4025ea0c0..87ba492888 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.mavenArtifacts.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.mavenArtifacts.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists maven artifacts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.npmPackages.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.npmPackages.html index d3108b683d..4e7ba5979f 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.npmPackages.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.npmPackages.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists npm packages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.packages.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.html index 81c47585fc..7bfb38f330 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.html @@ -97,7 +97,7 @@

Instance Methods

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

Lists packages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.tags.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.tags.html index 0ba8bb3a98..cea6649e8a 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.tags.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.tags.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists tags.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.versions.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.versions.html index 489cfd1e86..f8c428064b 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.versions.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.packages.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists versions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1.projects.locations.repositories.prewarmedArtifacts.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.prewarmedArtifacts.html index 16bb7e4ed9..b57c36119a 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.prewarmedArtifacts.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.prewarmedArtifacts.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all streamed artifacts in a repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.pythonPackages.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.pythonPackages.html index ab1cd983ca..b248ecbc6e 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.pythonPackages.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.pythonPackages.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists python packages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1.projects.locations.repositories.rules.html b/docs/dyn/artifactregistry_v1.projects.locations.repositories.rules.html index 4cf733134b..07bc6a9ca9 100644 --- a/docs/dyn/artifactregistry_v1.projects.locations.repositories.rules.html +++ b/docs/dyn/artifactregistry_v1.projects.locations.repositories.rules.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists rules.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta1.html b/docs/dyn/artifactregistry_v1beta1.html index ef09319f14..8082eea646 100644 --- a/docs/dyn/artifactregistry_v1beta1.html +++ b/docs/dyn/artifactregistry_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/artifactregistry_v1beta1.projects.locations.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.html index 381f36d0fb..85a63bf71c 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta1.projects.locations.repositories.files.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.files.html index 73a3b43aed..0279b548e3 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.files.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.files.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists files.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta1.projects.locations.repositories.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.html index 2b8c4fa0a0..bd98033e1f 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists repositories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.html index ab00d6ee6b..35a4e11f69 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists packages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -193,17 +193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta1.projects.locations.repositories.packages.tags.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.tags.html index 10b2de0c27..c44dbc10b2 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.tags.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.tags.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists tags.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.versions.html b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.versions.html index 11be8575af..ba1fc092dd 100644 --- a/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.versions.html +++ b/docs/dyn/artifactregistry_v1beta1.projects.locations.repositories.packages.versions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists versions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta2.html b/docs/dyn/artifactregistry_v1beta2.html index 20010a1d6e..9275536b98 100644 --- a/docs/dyn/artifactregistry_v1beta2.html +++ b/docs/dyn/artifactregistry_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/artifactregistry_v1beta2.projects.locations.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.html index d4a0003549..39f285e15e 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta2.projects.locations.repositories.files.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.files.html index 5eb56eecc3..ffdd9ad599 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.files.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.files.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists files.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -200,17 +200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/artifactregistry_v1beta2.projects.locations.repositories.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.html index 9f5494b7e6..6b9d5f873f 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.html @@ -113,7 +113,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists repositories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.html index 73b8d18e57..b89671e474 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists packages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.tags.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.tags.html index 2e24d29926..b0f3e1a4ff 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.tags.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.tags.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists tags.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.versions.html b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.versions.html index 716a14e30c..43e0c4af5e 100644 --- a/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.versions.html +++ b/docs/dyn/artifactregistry_v1beta2.projects.locations.repositories.packages.versions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists versions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.folders.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1.folders.locations.dbFindingSummaries.html index bfd4ae5c30..e31f9ac318 100644 --- a/docs/dyn/assuredworkloads_v1.folders.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1.folders.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index 5e4c8706b1..016dadc075 100644 --- a/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.folders.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceSummaries.html index 973fea3fcc..1bf989966b 100644 --- a/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.folders.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.html b/docs/dyn/assuredworkloads_v1.html index 6fecf0415a..bf26bb0600 100644 --- a/docs/dyn/assuredworkloads_v1.html +++ b/docs/dyn/assuredworkloads_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/assuredworkloads_v1.organizations.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFindingSummaries.html index c0118ce302..72292d2152 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index b891bc7582..fd81987869 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceSummaries.html index 1d4348aac9..096ea3ba9c 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.organizations.locations.operations.html b/docs/dyn/assuredworkloads_v1.organizations.locations.operations.html index 6ddd9797c6..3fb1d33ffd 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.operations.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.organizations.locations.workloads.html b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.html index 3930306e93..94e023bb0e 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.html @@ -88,7 +88,7 @@

Instance Methods

analyzeWorkloadMove(target, assetTypes=None, pageSize=None, pageToken=None, project=None, x__xgafv=None)

Analyzes a hypothetical move of a source resource to a target workload to surface compliance risks. The analysis is best effort and is not guaranteed to be exhaustive.

- analyzeWorkloadMove_next(previous_request, previous_response)

+ analyzeWorkloadMove_next()

Retrieves the next page of results.

close()

@@ -112,7 +112,7 @@

Instance Methods

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

Lists Assured Workloads under a CRM Node.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mutatePartnerPermissions(name, body=None, x__xgafv=None)

@@ -180,17 +180,17 @@

Method Details

- analyzeWorkloadMove_next(previous_request, previous_response) + analyzeWorkloadMove_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)
+        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.
-
+ 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. +
@@ -526,17 +526,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.updates.html b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.updates.html index bee7953d16..552018b3fd 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.updates.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.updates.html @@ -84,7 +84,7 @@

Instance Methods

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

This endpoint lists all updates for the given workload.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.organizations.locations.workloads.violations.html b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.violations.html index ac865d1a89..c7dcfbb4b5 100644 --- a/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.violations.html +++ b/docs/dyn/assuredworkloads_v1.organizations.locations.workloads.violations.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Violations in the AssuredWorkload Environment. Callers may also choose to read across multiple Workloads as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of workload-id in the parent. Format `organizations/{org_id}/locations/{location}/workloads/-`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.projects.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1.projects.locations.dbFindingSummaries.html index e18362887b..8cad0fdd8f 100644 --- a/docs/dyn/assuredworkloads_v1.projects.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1.projects.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index 55b0102930..872188d8e3 100644 --- a/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1.projects.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceSummaries.html index 2b237d1059..997e08671e 100644 --- a/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1.projects.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.folders.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFindingSummaries.html index 7a38fc8f7a..35f165aca6 100644 --- a/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index 2dd0cd3e9a..697faecdd5 100644 --- a/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceSummaries.html index 6dda30d278..0ade7cd1b1 100644 --- a/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.folders.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.html b/docs/dyn/assuredworkloads_v1beta1.html index 075e3b296d..4d92b2d6a6 100644 --- a/docs/dyn/assuredworkloads_v1beta1.html +++ b/docs/dyn/assuredworkloads_v1beta1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFindingSummaries.html index 9cef6ea61d..3b5a728798 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index e0d55aed54..153f591edd 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceSummaries.html index a033e2ae8b..f88df0df09 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.organizations.locations.operations.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.operations.html index 3c74311707..03f27c4b03 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.operations.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.organizations.locations.workloads.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.html index 8b3185a43c..af87030515 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.html @@ -88,7 +88,7 @@

Instance Methods

analyzeWorkloadMove(target, assetTypes=None, pageSize=None, pageToken=None, project=None, x__xgafv=None)

Analyzes a hypothetical move of a source resource to a target workload to surface compliance risks. The analysis is best effort and is not guaranteed to be exhaustive.

- analyzeWorkloadMove_next(previous_request, previous_response)

+ analyzeWorkloadMove_next()

Retrieves the next page of results.

close()

@@ -112,7 +112,7 @@

Instance Methods

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

Lists Assured Workloads under a CRM Node.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -177,17 +177,17 @@

Method Details

- analyzeWorkloadMove_next(previous_request, previous_response) + analyzeWorkloadMove_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)
+        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.
-
+ 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. +
@@ -601,17 +601,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.updates.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.updates.html index 1ee054758a..fe01c44110 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.updates.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.updates.html @@ -84,7 +84,7 @@

Instance Methods

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

This endpoint lists all updates for the given workload.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.organizations.locations.workloads.violations.html b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.violations.html index dc4fe32c2d..6760d62a74 100644 --- a/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.violations.html +++ b/docs/dyn/assuredworkloads_v1beta1.organizations.locations.workloads.violations.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Violations in the AssuredWorkload Environment. Callers may also choose to read across multiple Workloads as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of workload-id in the parent. Format `organizations/{org_id}/locations/{location}/workloads/-`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.projects.locations.dbFindingSummaries.html b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFindingSummaries.html index 63f8ffd200..9308f3d68f 100644 --- a/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFindingSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFindingSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the finding summary by category for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html index 3abeed4c21..45ba07b857 100644 --- a/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceReports.dbControlComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the control compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceSummaries.html b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceSummaries.html index 82e927b188..2d01a1f7f8 100644 --- a/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceSummaries.html +++ b/docs/dyn/assuredworkloads_v1beta1.projects.locations.dbFrameworkComplianceSummaries.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the framework compliance summary for a given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.folders.locations.auditReports.html b/docs/dyn/auditmanager_v1.folders.locations.auditReports.html index 2d51010b38..66f585c1c8 100644 --- a/docs/dyn/auditmanager_v1.folders.locations.auditReports.html +++ b/docs/dyn/auditmanager_v1.folders.locations.auditReports.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists the audit reports for the organization, folder, or project that you specify as the parent scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.folders.locations.auditSchedules.html b/docs/dyn/auditmanager_v1.folders.locations.auditSchedules.html index 275a410854..25f1eeaca9 100644 --- a/docs/dyn/auditmanager_v1.folders.locations.auditSchedules.html +++ b/docs/dyn/auditmanager_v1.folders.locations.auditSchedules.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists audit schedules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/auditmanager_v1.folders.locations.resourceEnrollmentStatuses.html b/docs/dyn/auditmanager_v1.folders.locations.resourceEnrollmentStatuses.html index 8965132844..b1ffee0538 100644 --- a/docs/dyn/auditmanager_v1.folders.locations.resourceEnrollmentStatuses.html +++ b/docs/dyn/auditmanager_v1.folders.locations.resourceEnrollmentStatuses.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all the folders and projects in an organization or folder, along with their enrollments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -160,17 +160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.folders.locations.standards.controls.html b/docs/dyn/auditmanager_v1.folders.locations.standards.controls.html index 62a7569024..ba05ef0eeb 100644 --- a/docs/dyn/auditmanager_v1.folders.locations.standards.controls.html +++ b/docs/dyn/auditmanager_v1.folders.locations.standards.controls.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the controls that you must implement to become compliant to a regulatory standard.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.html b/docs/dyn/auditmanager_v1.html index 022e3b826c..95d71990b7 100644 --- a/docs/dyn/auditmanager_v1.html +++ b/docs/dyn/auditmanager_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/auditmanager_v1.organizations.locations.auditReports.html b/docs/dyn/auditmanager_v1.organizations.locations.auditReports.html index 0761212e3d..10769db0a1 100644 --- a/docs/dyn/auditmanager_v1.organizations.locations.auditReports.html +++ b/docs/dyn/auditmanager_v1.organizations.locations.auditReports.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists the audit reports for the organization, folder, or project that you specify as the parent scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.organizations.locations.auditSchedules.html b/docs/dyn/auditmanager_v1.organizations.locations.auditSchedules.html index 3ed82ccb02..a99801a98c 100644 --- a/docs/dyn/auditmanager_v1.organizations.locations.auditSchedules.html +++ b/docs/dyn/auditmanager_v1.organizations.locations.auditSchedules.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists audit schedules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/auditmanager_v1.organizations.locations.operations.html b/docs/dyn/auditmanager_v1.organizations.locations.operations.html index 93979d5e20..bee41bc4e1 100644 --- a/docs/dyn/auditmanager_v1.organizations.locations.operations.html +++ b/docs/dyn/auditmanager_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.organizations.locations.resourceEnrollmentStatuses.html b/docs/dyn/auditmanager_v1.organizations.locations.resourceEnrollmentStatuses.html index f1cee770eb..685ec38d4a 100644 --- a/docs/dyn/auditmanager_v1.organizations.locations.resourceEnrollmentStatuses.html +++ b/docs/dyn/auditmanager_v1.organizations.locations.resourceEnrollmentStatuses.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists all the folders and projects in an organization or folder, along with their enrollments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -160,17 +160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.organizations.locations.standards.controls.html b/docs/dyn/auditmanager_v1.organizations.locations.standards.controls.html index a0d8c0cdf7..65d306360a 100644 --- a/docs/dyn/auditmanager_v1.organizations.locations.standards.controls.html +++ b/docs/dyn/auditmanager_v1.organizations.locations.standards.controls.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the controls that you must implement to become compliant to a regulatory standard.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.projects.locations.auditReports.html b/docs/dyn/auditmanager_v1.projects.locations.auditReports.html index 243ff0427a..cff8237e7a 100644 --- a/docs/dyn/auditmanager_v1.projects.locations.auditReports.html +++ b/docs/dyn/auditmanager_v1.projects.locations.auditReports.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists the audit reports for the organization, folder, or project that you specify as the parent scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.projects.locations.auditSchedules.html b/docs/dyn/auditmanager_v1.projects.locations.auditSchedules.html index e90f9f8a81..667219b096 100644 --- a/docs/dyn/auditmanager_v1.projects.locations.auditSchedules.html +++ b/docs/dyn/auditmanager_v1.projects.locations.auditSchedules.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists audit schedules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/auditmanager_v1.projects.locations.html b/docs/dyn/auditmanager_v1.projects.locations.html index 72623a6278..74333a61db 100644 --- a/docs/dyn/auditmanager_v1.projects.locations.html +++ b/docs/dyn/auditmanager_v1.projects.locations.html @@ -127,7 +127,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.projects.locations.operations.html b/docs/dyn/auditmanager_v1.projects.locations.operations.html index 1c7f41ef52..b9095f9efc 100644 --- a/docs/dyn/auditmanager_v1.projects.locations.operations.html +++ b/docs/dyn/auditmanager_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/auditmanager_v1.projects.locations.standards.controls.html b/docs/dyn/auditmanager_v1.projects.locations.standards.controls.html index de4d20948d..632c2d3367 100644 --- a/docs/dyn/auditmanager_v1.projects.locations.standards.controls.html +++ b/docs/dyn/auditmanager_v1.projects.locations.standards.controls.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists the controls that you must implement to become compliant to a regulatory standard.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1.bidders.auctionPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1.bidders.auctionPackages.html index 5aba13a7de..a9d29e0dde 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.bidders.auctionPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.bidders.auctionPackages.html @@ -81,7 +81,7 @@

Instance Methods

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

List the auction packages. Buyers can use the URL path "/v1/buyers/{accountId}/auctionPackages" to list auction packages for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/auctionPackages" to list auction packages for the bidder, its media planners, its buyers, and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1.bidders.finalizedDeals.html b/docs/dyn/authorizedbuyersmarketplace_v1.bidders.finalizedDeals.html index 378138fa7d..679c4e0f2e 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.bidders.finalizedDeals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.bidders.finalizedDeals.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists finalized deals. Use the URL path "/v1/buyers/{accountId}/finalizedDeals" to list finalized deals for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/finalizedDeals" to list finalized deals for the bidder, its buyers and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setReadyToServe(deal, body=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.auctionPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.auctionPackages.html index f25039e3fb..84efc99e73 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.auctionPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.auctionPackages.html @@ -84,7 +84,7 @@

Instance Methods

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

List the auction packages. Buyers can use the URL path "/v1/buyers/{accountId}/auctionPackages" to list auction packages for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/auctionPackages" to list auction packages for the bidder, its media planners, its buyers, and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

subscribe(name, body=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.html index 503b569526..456bb9bd85 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all the clients for the current buyer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.users.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.users.html index 9fa660b647..b3368ddb5b 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.users.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.clients.users.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists all client users for a specified client.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1.buyers.finalizedDeals.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.finalizedDeals.html index db62c2d9e9..83ab44e89c 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.finalizedDeals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.finalizedDeals.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists finalized deals. Use the URL path "/v1/buyers/{accountId}/finalizedDeals" to list finalized deals for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/finalizedDeals" to list finalized deals for the bidder, its buyers and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -904,17 +904,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.deals.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.deals.html index 7c3ed4a308..760e25831a 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.deals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.deals.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists all deals in a proposal. To retrieve only the finalized revision deals regardless if a deal is being renegotiated, see the FinalizedDeals resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1077,17 +1077,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.html index 8e95d970f2..2894d4e568 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.proposals.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists proposals. A filter expression using [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) may be specified to filter the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -420,17 +420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.publisherProfiles.html b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.publisherProfiles.html index d3fc18c592..68d8e567da 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.buyers.publisherProfiles.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.buyers.publisherProfiles.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1.html b/docs/dyn/authorizedbuyersmarketplace_v1.html index 0d26fff206..693c116ce1 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.auctionPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.auctionPackages.html index c025d04ebf..b5a21ecd74 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.auctionPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.auctionPackages.html @@ -81,7 +81,7 @@

Instance Methods

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

List the auction packages. Buyers can use the URL path "/v1alpha/buyers/{accountId}/auctionPackages" to list auction packages for the current buyer and its clients. Bidders can use the URL path "/v1alpha/bidders/{accountId}/auctionPackages" to list auction packages for the bidder, its media planners, its buyers, and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1alpha.bidders.finalizedDeals.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.finalizedDeals.html index 0045d08976..58bac7f193 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.finalizedDeals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.bidders.finalizedDeals.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists finalized deals. Use the URL path "/v1alpha/buyers/{accountId}/finalizedDeals" to list finalized deals for the current buyer and its clients. Bidders can use the URL path "/v1alpha/bidders/{accountId}/finalizedDeals" to list finalized deals for the bidder, its buyers and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setReadyToServe(deal, body=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.auctionPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.auctionPackages.html index 54bcb371f8..196724eae9 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.auctionPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.auctionPackages.html @@ -84,7 +84,7 @@

Instance Methods

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

List the auction packages. Buyers can use the URL path "/v1alpha/buyers/{accountId}/auctionPackages" to list auction packages for the current buyer and its clients. Bidders can use the URL path "/v1alpha/bidders/{accountId}/auctionPackages" to list auction packages for the bidder, its media planners, its buyers, and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

subscribe(name, body=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.html index 4d5dc85647..76696aa453 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all the clients for the current buyer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.users.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.users.html index 6021e35822..6d95bba345 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.users.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.clients.users.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists all client users for a specified client.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1alpha.buyers.dataSegments.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.dataSegments.html index ba1a271abb..2ce1b0c7b6 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.dataSegments.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.dataSegments.html @@ -93,7 +93,7 @@

Instance Methods

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

List the data segments owned by a curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.finalizedDeals.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.finalizedDeals.html index f4e5bd1f97..ea66515431 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.finalizedDeals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.finalizedDeals.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists finalized deals. Use the URL path "/v1alpha/buyers/{accountId}/finalizedDeals" to list finalized deals for the current buyer and its clients. Bidders can use the URL path "/v1alpha/bidders/{accountId}/finalizedDeals" to list finalized deals for the bidder, its buyers and all their clients.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -904,17 +904,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.deals.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.deals.html index a7d661c097..0cfa23596f 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.deals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.deals.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists all deals in a proposal. To retrieve only the finalized revision deals regardless if a deal is being renegotiated, see the FinalizedDeals resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1077,17 +1077,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.html index 169e1c846a..d6b314ee16 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.proposals.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists proposals. A filter expression using [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) may be specified to filter the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -420,17 +420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.publisherProfiles.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.publisherProfiles.html index ff54f6926b..f81b3defa2 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.publisherProfiles.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.buyers.publisherProfiles.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1alpha.curators.curatedPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.curators.curatedPackages.html index bce08df4d2..55959fdfe3 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.curators.curatedPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.curators.curatedPackages.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists curated packages owned by the specified curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.html index 80c0b93ed4..0832ddb8f3 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/authorizedbuyersmarketplace_v1alpha.mediaPlanners.html b/docs/dyn/authorizedbuyersmarketplace_v1alpha.mediaPlanners.html index 80d6188b86..cd8087df76 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1alpha.mediaPlanners.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1alpha.mediaPlanners.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all media planner accounts that the caller has access to. For curators, this will return all media planners that have accepted curator terms. For other accounts, attempting to list media planners will return an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/authorizedbuyersmarketplace_v1beta.curators.curatedPackages.html b/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.curatedPackages.html index 0d752f3b20..ea3ae536c9 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.curatedPackages.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.curatedPackages.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists curated packages owned by the specified curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.dataSegments.html b/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.dataSegments.html index ddba09bdef..0cd60648a1 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.dataSegments.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1beta.curators.dataSegments.html @@ -93,7 +93,7 @@

Instance Methods

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

List the data segments owned by a curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/authorizedbuyersmarketplace_v1beta.html b/docs/dyn/authorizedbuyersmarketplace_v1beta.html index d883eb31a6..73b3e69418 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1beta.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/authorizedbuyersmarketplace_v1beta.mediaPlanners.html b/docs/dyn/authorizedbuyersmarketplace_v1beta.mediaPlanners.html index a6e8a940c5..2e3064fc61 100644 --- a/docs/dyn/authorizedbuyersmarketplace_v1beta.mediaPlanners.html +++ b/docs/dyn/authorizedbuyersmarketplace_v1beta.mediaPlanners.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists all media planner accounts that the caller has access to. For curators, this will return all media planners that have accepted curator terms. For other accounts, attempting to list media planners will return an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1.folders.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1.folders.locations.resourceBackupConfigs.html index 2d6921e3d1..e404c180d9 100644 --- a/docs/dyn/backupdr_v1.folders.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1.folders.locations.resourceBackupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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/backupdr_v1.html b/docs/dyn/backupdr_v1.html index 8881695cbf..e8d0384155 100644 --- a/docs/dyn/backupdr_v1.html +++ b/docs/dyn/backupdr_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/backupdr_v1.organizations.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1.organizations.locations.resourceBackupConfigs.html index 94d7c8d6e5..a092614fa2 100644 --- a/docs/dyn/backupdr_v1.organizations.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1.organizations.locations.resourceBackupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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/backupdr_v1.projects.locations.backupPlanAssociations.html b/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html index 36d0e69604..63a8f42a03 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html @@ -87,7 +87,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, x__xgafv=None)

List BackupPlanAssociations for a given resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

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

Lists BackupPlanAssociations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -288,17 +288,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.backupPlans.html b/docs/dyn/backupdr_v1.projects.locations.backupPlans.html index 3e29fa1668..9420cfea5c 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlans.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlans.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists BackupPlans in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -420,17 +420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html b/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html index 4b1c1c846c..08596d8b65 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists BackupPlanRevisions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html index 044c397127..981e092658 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html @@ -84,7 +84,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, view=None, x__xgafv=None)

Fetch Backups for a given resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Backups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -441,17 +441,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -1041,17 +1041,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html index 6cd97d480f..0e96704a7a 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists DataSources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -499,17 +499,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.backupVaults.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.html index 03b86add8b..f182d4c460 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.html @@ -92,7 +92,7 @@

Instance Methods

fetchUsable(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

FetchUsableBackupVaults lists usable BackupVaults in a given project and location. Usable BackupVault are the ones that user has backupdr.backupVaults.get permission.

- fetchUsable_next(previous_request, previous_response)

+ fetchUsable_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists BackupVaults in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceUpdateAccessRestriction=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -279,17 +279,17 @@

Method Details

- fetchUsable_next(previous_request, previous_response) + fetchUsable_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)
+        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.
-
+ 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. +
@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html b/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html index 091a548ff4..73510c710a 100644 --- a/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html +++ b/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html @@ -81,7 +81,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, x__xgafv=None)

Fetch DataSourceReferences for a given project, location and resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

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

Lists DataSourceReferences for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1.projects.locations.html b/docs/dyn/backupdr_v1.projects.locations.html index 5a0fb41422..2c5d8882a4 100644 --- a/docs/dyn/backupdr_v1.projects.locations.html +++ b/docs/dyn/backupdr_v1.projects.locations.html @@ -132,7 +132,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1.projects.locations.managementServers.html b/docs/dyn/backupdr_v1.projects.locations.managementServers.html index 1a9edb1aff..08c88b76ab 100644 --- a/docs/dyn/backupdr_v1.projects.locations.managementServers.html +++ b/docs/dyn/backupdr_v1.projects.locations.managementServers.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists ManagementServers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

msComplianceMetadata(parent, body=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1.projects.locations.operations.html b/docs/dyn/backupdr_v1.projects.locations.operations.html index b412e7a2bf..9715cf6f48 100644 --- a/docs/dyn/backupdr_v1.projects.locations.operations.html +++ b/docs/dyn/backupdr_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1.projects.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1.projects.locations.resourceBackupConfigs.html index 775d606cb6..290212c347 100644 --- a/docs/dyn/backupdr_v1.projects.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1.projects.locations.resourceBackupConfigs.html @@ -81,13 +81,13 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

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

Lists ResourceBackupConfigs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -165,17 +165,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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. +
@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.folders.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1beta.folders.locations.resourceBackupConfigs.html index c73db02c64..e57509b065 100644 --- a/docs/dyn/backupdr_v1beta.folders.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1beta.folders.locations.resourceBackupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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/backupdr_v1beta.html b/docs/dyn/backupdr_v1beta.html index 042043c7b1..ce8f1371c9 100644 --- a/docs/dyn/backupdr_v1beta.html +++ b/docs/dyn/backupdr_v1beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/backupdr_v1beta.organizations.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1beta.organizations.locations.resourceBackupConfigs.html index 8621ae6172..b71534498a 100644 --- a/docs/dyn/backupdr_v1beta.organizations.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1beta.organizations.locations.resourceBackupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.appliedAutoProtectionPolicies.html b/docs/dyn/backupdr_v1beta.projects.locations.appliedAutoProtectionPolicies.html index b3de01c69f..795a4cf608 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.appliedAutoProtectionPolicies.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.appliedAutoProtectionPolicies.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists AppliedAutoProtectionPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.html b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.html index bdcf6d7847..ccc9a0d645 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.html @@ -95,7 +95,7 @@

Instance Methods

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

Returns the auto protection policy bindings read from the CCFE tables.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -271,17 +271,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.matchingResources.html b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.matchingResources.html index 4123543fe1..5708b4329a 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.matchingResources.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.bindings.matchingResources.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists Binding Matching Resources for a given AutoProtectionPolicyBinding.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.autoProtectionPolicies.html b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.html index eda3cdd0c8..5a9730b6f6 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.autoProtectionPolicies.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists AutoProtectionPolicies for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -329,17 +329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html b/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html index 1b7a915843..4b3dd3027a 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html @@ -87,7 +87,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, x__xgafv=None)

List BackupPlanAssociations for a given resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

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

Lists BackupPlanAssociations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -291,17 +291,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -424,17 +424,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.html b/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.html index af82b793ce..83c27aa18d 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists BackupPlans in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.revisions.html b/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.revisions.html index 9d67f24e58..14e2f05eb0 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.revisions.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupPlans.revisions.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists BackupPlanRevisions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -257,17 +257,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html index 0377314ce6..e3d9e531fe 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html @@ -84,7 +84,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, view=None, x__xgafv=None)

Fetch Backups for a given resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Backups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -435,17 +435,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -1023,17 +1023,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html index 94bbf4ed53..fb9df1f68d 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists DataSources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -501,17 +501,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.html b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.html index c6a6e93bf3..314a77c375 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.html @@ -92,7 +92,7 @@

Instance Methods

fetchUsable(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

FetchUsableBackupVaults lists usable BackupVaults in a given project and location. Usable BackupVault are the ones that user has backupdr.backupVaults.get permission.

- fetchUsable_next(previous_request, previous_response)

+ fetchUsable_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists BackupVaults in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceUpdateAccessRestriction=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -279,17 +279,17 @@

Method Details

- fetchUsable_next(previous_request, previous_response) + fetchUsable_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)
+        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.
-
+ 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. +
@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html b/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html index 38fa559cb3..22999a7cae 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html @@ -81,7 +81,7 @@

Instance Methods

fetchForResourceType(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, resourceType=None, x__xgafv=None)

Fetch DataSourceReferences for a given project, location and resource type.

- fetchForResourceType_next(previous_request, previous_response)

+ fetchForResourceType_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

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

Lists DataSourceReferences for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- fetchForResourceType_next(previous_request, previous_response) + fetchForResourceType_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)
+        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.
-
+ 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. +
@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.html b/docs/dyn/backupdr_v1beta.projects.locations.html index 82988baf60..aa22d7be3a 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.html @@ -142,7 +142,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.managementServers.html b/docs/dyn/backupdr_v1beta.projects.locations.managementServers.html index 7937df586b..ef3c19721d 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.managementServers.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.managementServers.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists ManagementServers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

msComplianceMetadata(parent, body=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/backupdr_v1beta.projects.locations.operations.html b/docs/dyn/backupdr_v1beta.projects.locations.operations.html index e564e51f71..e757699c2c 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.operations.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/backupdr_v1beta.projects.locations.resourceBackupConfigs.html b/docs/dyn/backupdr_v1beta.projects.locations.resourceBackupConfigs.html index ca38635e52..13ff12adc7 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.resourceBackupConfigs.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.resourceBackupConfigs.html @@ -81,13 +81,13 @@

Instance Methods

fetch(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches ResourceBackupConfigs.

- fetch_next(previous_request, previous_response)

+ fetch_next()

Retrieves the next page of results.

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

Lists ResourceBackupConfigs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -165,17 +165,17 @@

Method Details

- fetch_next(previous_request, previous_response) + fetch_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)
+        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.
-
+ 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. +
@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.html b/docs/dyn/baremetalsolution_v2.html index e0b59d6ee4..004cdfbb27 100644 --- a/docs/dyn/baremetalsolution_v2.html +++ b/docs/dyn/baremetalsolution_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.html b/docs/dyn/baremetalsolution_v2.projects.locations.html index a32875cfa8..a29f32949f 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.html @@ -129,7 +129,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -201,17 +201,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.projects.locations.instances.html b/docs/dyn/baremetalsolution_v2.projects.locations.instances.html index 21be33329e..41dca123ae 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.instances.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.instances.html @@ -99,7 +99,7 @@

Instance Methods

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

List servers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

loadAuthInfo(name, x__xgafv=None)

@@ -679,17 +679,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.networks.html b/docs/dyn/baremetalsolution_v2.projects.locations.networks.html index 666330a323..704430f89d 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.networks.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.networks.html @@ -87,7 +87,7 @@

Instance Methods

listNetworkUsage(location, x__xgafv=None)

List all Networks (and used IPs for each Network) in the vendor account associated with the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.nfsShares.html b/docs/dyn/baremetalsolution_v2.projects.locations.nfsShares.html index 83398db9d0..a0f10ccb4f 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.nfsShares.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.nfsShares.html @@ -90,7 +90,7 @@

Instance Methods

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

List NFS shares.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.osImages.html b/docs/dyn/baremetalsolution_v2.projects.locations.osImages.html index 3bf185aba1..96dab1225e 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.osImages.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.osImages.html @@ -84,7 +84,7 @@

Instance Methods

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

Retrieves the list of OS images which are currently approved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.projects.locations.provisioningQuotas.html b/docs/dyn/baremetalsolution_v2.projects.locations.provisioningQuotas.html index 198800b0e8..75a98452df 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.provisioningQuotas.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.provisioningQuotas.html @@ -81,7 +81,7 @@

Instance Methods

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

List the budget details to provision resources on a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -130,17 +130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.projects.locations.sshKeys.html b/docs/dyn/baremetalsolution_v2.projects.locations.sshKeys.html index 6a75c9fbfc..c61afaf15f 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.sshKeys.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.sshKeys.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists the public SSH keys registered for the specified project. These SSH keys are used only for the interactive serial console feature.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.projects.locations.volumes.html b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html index 9577c89607..16028183dd 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html @@ -97,7 +97,7 @@

Instance Methods

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

List storage volumes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.luns.html b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.luns.html index 0b98d6803d..cea3d93b14 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.luns.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.luns.html @@ -87,7 +87,7 @@

Instance Methods

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

List storage volume luns for given storage volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/baremetalsolution_v2.projects.locations.volumes.snapshots.html b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html index 9597a4a698..fc55b73a9c 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html @@ -90,7 +90,7 @@

Instance Methods

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

Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

restoreVolumeSnapshot(volumeSnapshot, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/batch_v1.html b/docs/dyn/batch_v1.html index 7670e27389..1d4a16c12f 100644 --- a/docs/dyn/batch_v1.html +++ b/docs/dyn/batch_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/batch_v1.projects.locations.html b/docs/dyn/batch_v1.projects.locations.html index 4373bd9a9a..a49c5ce6ef 100644 --- a/docs/dyn/batch_v1.projects.locations.html +++ b/docs/dyn/batch_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/batch_v1.projects.locations.jobs.html b/docs/dyn/batch_v1.projects.locations.jobs.html index 7ed401ebce..4ab4ace307 100644 --- a/docs/dyn/batch_v1.projects.locations.jobs.html +++ b/docs/dyn/batch_v1.projects.locations.jobs.html @@ -98,7 +98,7 @@

Instance Methods

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

List all Jobs for a project within a region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1292,17 +1292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/batch_v1.projects.locations.jobs.taskGroups.tasks.html b/docs/dyn/batch_v1.projects.locations.jobs.taskGroups.tasks.html index 6652975050..7098834962 100644 --- a/docs/dyn/batch_v1.projects.locations.jobs.taskGroups.tasks.html +++ b/docs/dyn/batch_v1.projects.locations.jobs.taskGroups.tasks.html @@ -84,7 +84,7 @@

Instance Methods

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

List Tasks associated with a job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/batch_v1.projects.locations.operations.html b/docs/dyn/batch_v1.projects.locations.operations.html index d144a2751d..8d326ddc16 100644 --- a/docs/dyn/batch_v1.projects.locations.operations.html +++ b/docs/dyn/batch_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1.html b/docs/dyn/beyondcorp_v1.html index 5ac36e246b..75b3d67705 100644 --- a/docs/dyn/beyondcorp_v1.html +++ b/docs/dyn/beyondcorp_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/beyondcorp_v1.organizations.locations.operations.html b/docs/dyn/beyondcorp_v1.organizations.locations.operations.html index c2c191dc34..590917b29f 100644 --- a/docs/dyn/beyondcorp_v1.organizations.locations.operations.html +++ b/docs/dyn/beyondcorp_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1.projects.locations.appConnections.html b/docs/dyn/beyondcorp_v1.projects.locations.appConnections.html index d30c18fb26..f2eb0c3312 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.appConnections.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.appConnections.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppConnections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -102,7 +102,7 @@

Instance Methods

resolve(parent, appConnectorId=None, pageSize=None, pageToken=None, x__xgafv=None)

Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.

- resolve_next(previous_request, previous_response)

+ resolve_next()

Retrieves the next page of results.

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

@@ -372,17 +372,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -517,17 +517,17 @@

Method Details

- resolve_next(previous_request, previous_response) + resolve_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1.projects.locations.appConnectors.html b/docs/dyn/beyondcorp_v1.projects.locations.appConnectors.html index 7584b1c3ff..81748e316e 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.appConnectors.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.appConnectors.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppConnectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1.projects.locations.appGateways.html b/docs/dyn/beyondcorp_v1.projects.locations.appGateways.html index 90531db215..caca9d7388 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.appGateways.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.appGateways.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1.projects.locations.html b/docs/dyn/beyondcorp_v1.projects.locations.html index 914415f71e..4b86078aa7 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1.projects.locations.operations.html b/docs/dyn/beyondcorp_v1.projects.locations.operations.html index 23898f4ecb..0a1506f715 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.operations.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1.projects.locations.securityGateways.applications.html b/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.applications.html index 919519596e..7a50a2c222 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.applications.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.applications.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Applications in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -461,17 +461,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.html b/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.html index c14c893ea3..019b77cd81 100644 --- a/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.html +++ b/docs/dyn/beyondcorp_v1.projects.locations.securityGateways.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists SecurityGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.html b/docs/dyn/beyondcorp_v1alpha.html index a514f6808a..dc1e836729 100644 --- a/docs/dyn/beyondcorp_v1alpha.html +++ b/docs/dyn/beyondcorp_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/beyondcorp_v1alpha.organizations.locations.insights.html b/docs/dyn/beyondcorp_v1alpha.organizations.locations.insights.html index a567a5d2ad..0d4d79235b 100644 --- a/docs/dyn/beyondcorp_v1alpha.organizations.locations.insights.html +++ b/docs/dyn/beyondcorp_v1alpha.organizations.locations.insights.html @@ -81,7 +81,7 @@

Instance Methods

configuredInsight(insight, aggregation=None, customGrouping_fieldFilter=None, customGrouping_groupFields=None, endTime=None, fieldFilter=None, group=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Gets the value for a selected particular insight based on the provided filters. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project.

- configuredInsight_next(previous_request, previous_response)

+ configuredInsight_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

list(parent, aggregation=None, endTime=None, filter=None, orderBy=None, pageSize=None, pageToken=None, startTime=None, view=None, x__xgafv=None)

Lists for all the available insights that could be fetched from the system. Allows to filter using category. Setting the `view` to `BASIC` will let you iterate over the list of insight metadatas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- configuredInsight_next(previous_request, previous_response) + configuredInsight_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)
+        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.
-
+ 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. +
@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1alpha.organizations.locations.operations.html b/docs/dyn/beyondcorp_v1alpha.organizations.locations.operations.html index 33804c3089..d86a6940f2 100644 --- a/docs/dyn/beyondcorp_v1alpha.organizations.locations.operations.html +++ b/docs/dyn/beyondcorp_v1alpha.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1alpha.organizations.locations.subscriptions.html b/docs/dyn/beyondcorp_v1alpha.organizations.locations.subscriptions.html index b0aaf21462..416138af17 100644 --- a/docs/dyn/beyondcorp_v1alpha.organizations.locations.subscriptions.html +++ b/docs/dyn/beyondcorp_v1alpha.organizations.locations.subscriptions.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Subscriptions in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnections.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnections.html index 269bbe9875..f9d1385f2d 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnections.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnections.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppConnections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -102,7 +102,7 @@

Instance Methods

resolve(parent, appConnectorId=None, pageSize=None, pageToken=None, x__xgafv=None)

Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.

- resolve_next(previous_request, previous_response)

+ resolve_next()

Retrieves the next page of results.

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

@@ -372,17 +372,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -517,17 +517,17 @@

Method Details

- resolve_next(previous_request, previous_response) + resolve_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnectors.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnectors.html index 489bfb3105..0801b58a9c 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnectors.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.appConnectors.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppConnectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.appGateways.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.appGateways.html index af6a1ae5d6..67e642acef 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.appGateways.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.appGateways.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists AppGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.connections.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.connections.html index 94df2f5e43..19572f75af 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.connections.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.connections.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Connections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -102,7 +102,7 @@

Instance Methods

resolve(parent, connectorId=None, pageSize=None, pageToken=None, x__xgafv=None)

Resolves connections details for a given connector. An internal method called by a connector to find connections to connect to.

- resolve_next(previous_request, previous_response)

+ resolve_next()

Retrieves the next page of results.

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

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -494,17 +494,17 @@

Method Details

- resolve_next(previous_request, previous_response) + resolve_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.connectors.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.connectors.html index 12d54921f9..1de2818e1b 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.connectors.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.connectors.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Connectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -366,17 +366,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.html index a0e7293d07..d46bfc392c 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.html @@ -134,7 +134,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1alpha.projects.locations.insights.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.insights.html index a94a847d52..95acf9b157 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.insights.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.insights.html @@ -81,7 +81,7 @@

Instance Methods

configuredInsight(insight, aggregation=None, customGrouping_fieldFilter=None, customGrouping_groupFields=None, endTime=None, fieldFilter=None, group=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Gets the value for a selected particular insight based on the provided filters. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project.

- configuredInsight_next(previous_request, previous_response)

+ configuredInsight_next()

Retrieves the next page of results.

get(name, view=None, x__xgafv=None)

@@ -90,7 +90,7 @@

Instance Methods

list(parent, aggregation=None, endTime=None, filter=None, orderBy=None, pageSize=None, pageToken=None, startTime=None, view=None, x__xgafv=None)

Lists for all the available insights that could be fetched from the system. Allows to filter using category. Setting the `view` to `BASIC` will let you iterate over the list of insight metadatas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- configuredInsight_next(previous_request, previous_response) + configuredInsight_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)
+        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.
-
+ 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. +
@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1alpha.projects.locations.operations.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.operations.html index 721b24114b..56263b8416 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.operations.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html index e1c739e17c..0a7665ee37 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists Applications in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -461,17 +461,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html index 4ca4c86dc9..1df92638f0 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists SecurityGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/biglake_v1.html b/docs/dyn/biglake_v1.html index a93f909f38..f003966d7c 100644 --- a/docs/dyn/biglake_v1.html +++ b/docs/dyn/biglake_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/biglake_v1.projects.locations.catalogs.databases.html b/docs/dyn/biglake_v1.projects.locations.catalogs.databases.html index 5b3a29b2d2..341a831303 100644 --- a/docs/dyn/biglake_v1.projects.locations.catalogs.databases.html +++ b/docs/dyn/biglake_v1.projects.locations.catalogs.databases.html @@ -95,7 +95,7 @@

Instance Methods

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

List all databases in a specified catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/biglake_v1.projects.locations.catalogs.databases.tables.html b/docs/dyn/biglake_v1.projects.locations.catalogs.databases.tables.html index 7351fb0afe..7f0a66377d 100644 --- a/docs/dyn/biglake_v1.projects.locations.catalogs.databases.tables.html +++ b/docs/dyn/biglake_v1.projects.locations.catalogs.databases.tables.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List all tables in a specified database.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/biglake_v1.projects.locations.catalogs.html b/docs/dyn/biglake_v1.projects.locations.catalogs.html index b8884a78ae..07d3f01f9a 100644 --- a/docs/dyn/biglake_v1.projects.locations.catalogs.html +++ b/docs/dyn/biglake_v1.projects.locations.catalogs.html @@ -95,7 +95,7 @@

Instance Methods

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

List all catalogs in a specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquery_v2.datasets.html b/docs/dyn/bigquery_v2.datasets.html index c72291cc03..cbf8cef203 100644 --- a/docs/dyn/bigquery_v2.datasets.html +++ b/docs/dyn/bigquery_v2.datasets.html @@ -90,7 +90,7 @@

Instance Methods

list(projectId, all=None, filter=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists all datasets in the specified project to which the user has been granted the READER dataset role. # IAM Permissions Requires no specific IAM permission(s) to use this method. Results are filtered to only include datasets on which the caller has the `bigquery.datasets.get` permission.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, datasetId, accessPolicyVersion=None, body=None, updateMode=None, x__xgafv=None)

@@ -511,17 +511,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquery_v2.html b/docs/dyn/bigquery_v2.html index 51321611f1..2291ce210e 100644 --- a/docs/dyn/bigquery_v2.html +++ b/docs/dyn/bigquery_v2.html @@ -118,7 +118,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -127,20 +127,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html index babd4643c9..cc82b42af7 100644 --- a/docs/dyn/bigquery_v2.jobs.html +++ b/docs/dyn/bigquery_v2.jobs.html @@ -90,7 +90,7 @@

Instance Methods

getQueryResults(projectId, jobId, formatOptions_timestampOutputFormat=None, formatOptions_useInt64Timestamp=None, location=None, maxResults=None, pageToken=None, startIndex=None, timeoutMs=None, x__xgafv=None)

RPC to get the results of a query job. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.jobs.get` on the job. - `bigquery.tables.getData` on the destination table. If the user matches the creator of the job, the following IAM permission(s) are required instead: - `bigquery.jobs.create` on the project. - `bigquery.tables.getData` on the destination table.

- getQueryResults_next(previous_request, previous_response)

+ getQueryResults_next()

Retrieves the next page of results.

insert(projectId, body=None, media_body=None, media_mime_type=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(projectId, allUsers=None, maxCreationTime=None, maxResults=None, minCreationTime=None, pageToken=None, parentJobId=None, projection=None, stateFilter=None, x__xgafv=None)

Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property. # IAM Permissions Requires no specific IAM permission(s) to use this method. Users are able to list the jobs they created. Additional access is granted based on the following permissions: - Users with the `bigquery.jobs.listAll` permission can list all jobs with all metadata. - Users with the `bigquery.jobs.list` permission can list all jobs, but with redacted information for jobs they did not create.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(projectId, body=None, x__xgafv=None)

@@ -3518,17 +3518,17 @@

Method Details

- getQueryResults_next(previous_request, previous_response) + getQueryResults_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)
+        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.
-
+ 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. +
@@ -8442,17 +8442,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquery_v2.models.html b/docs/dyn/bigquery_v2.models.html index ff4f03e775..10683f8910 100644 --- a/docs/dyn/bigquery_v2.models.html +++ b/docs/dyn/bigquery_v2.models.html @@ -87,7 +87,7 @@

Instance Methods

list(projectId, datasetId, maxResults=None, pageToken=None, x__xgafv=None)

Lists all models in the specified dataset. Requires the READER dataset role. After retrieving the list of models, you can get information about a particular model by calling the models.get method. # IAM Permissions Requires the `bigquery.models.list` permission on the dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, datasetId, modelId, body=None, x__xgafv=None)

@@ -2318,17 +2318,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquery_v2.projects.html b/docs/dyn/bigquery_v2.projects.html index 41c1611a8f..83052aec36 100644 --- a/docs/dyn/bigquery_v2.projects.html +++ b/docs/dyn/bigquery_v2.projects.html @@ -84,7 +84,7 @@

Instance Methods

list(maxResults=None, pageToken=None, x__xgafv=None)

RPC to list projects to which the user has been granted any project role. Users of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities. # IAM Permissions Requires no specific IAM permission(s) to use this method. The results are filtered to only include projects on which the caller has been granted a project-level role such as a BigQuery predefined IAM role or a basic role such as Viewer or Owner.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquery_v2.routines.html b/docs/dyn/bigquery_v2.routines.html index f6275bfe7a..09e75527ce 100644 --- a/docs/dyn/bigquery_v2.routines.html +++ b/docs/dyn/bigquery_v2.routines.html @@ -93,7 +93,7 @@

Instance Methods

list(projectId, datasetId, filter=None, maxResults=None, pageToken=None, readMask=None, x__xgafv=None)

Lists all routines in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.routines.list` permission on the dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -756,17 +756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquery_v2.rowAccessPolicies.html b/docs/dyn/bigquery_v2.rowAccessPolicies.html index db7afbe60d..10b832afaa 100644 --- a/docs/dyn/bigquery_v2.rowAccessPolicies.html +++ b/docs/dyn/bigquery_v2.rowAccessPolicies.html @@ -96,7 +96,7 @@

Instance Methods

list(projectId, datasetId, tableId, pageSize=None, pageToken=None, x__xgafv=None)

Lists all row access policies on the specified table. # IAM Permissions Requires the `bigquery.rowAccessPolicies.list` permission on the table.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquery_v2.tabledata.html b/docs/dyn/bigquery_v2.tabledata.html index 4d915b91dd..77750367fe 100644 --- a/docs/dyn/bigquery_v2.tabledata.html +++ b/docs/dyn/bigquery_v2.tabledata.html @@ -84,7 +84,7 @@

Instance Methods

list(projectId, datasetId, tableId, formatOptions_timestampOutputFormat=None, formatOptions_useInt64Timestamp=None, maxResults=None, pageToken=None, selectedFields=None, startIndex=None, x__xgafv=None)

List the content of a table in rows. # IAM Permissions Requires the `bigquery.tables.getData` permission on the table.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquery_v2.tables.html b/docs/dyn/bigquery_v2.tables.html index 8c4cbe9b73..ed24f5f3ec 100644 --- a/docs/dyn/bigquery_v2.tables.html +++ b/docs/dyn/bigquery_v2.tables.html @@ -93,7 +93,7 @@

Instance Methods

list(projectId, datasetId, maxResults=None, pageToken=None, x__xgafv=None)

Lists all tables in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.tables.list` permission on the dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, datasetId, tableId, autodetect_schema=None, body=None, x__xgafv=None)

@@ -1752,17 +1752,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryconnection_v1.html b/docs/dyn/bigqueryconnection_v1.html index b77e0fd947..4feb57562f 100644 --- a/docs/dyn/bigqueryconnection_v1.html +++ b/docs/dyn/bigqueryconnection_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigqueryconnection_v1.projects.locations.connections.html b/docs/dyn/bigqueryconnection_v1.projects.locations.connections.html index 938483e7c3..528e960679 100644 --- a/docs/dyn/bigqueryconnection_v1.projects.locations.connections.html +++ b/docs/dyn/bigqueryconnection_v1.projects.locations.connections.html @@ -93,7 +93,7 @@

Instance Methods

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

Returns a list of connections in the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -709,17 +709,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryconnection_v1beta1.html b/docs/dyn/bigqueryconnection_v1beta1.html index 6f701d0281..8b04f34266 100644 --- a/docs/dyn/bigqueryconnection_v1beta1.html +++ b/docs/dyn/bigqueryconnection_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigqueryconnection_v1beta1.projects.locations.connections.html b/docs/dyn/bigqueryconnection_v1beta1.projects.locations.connections.html index 0b3c5ce770..f2e0076f1e 100644 --- a/docs/dyn/bigqueryconnection_v1beta1.projects.locations.connections.html +++ b/docs/dyn/bigqueryconnection_v1beta1.projects.locations.connections.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, maxResults=None, pageToken=None, x__xgafv=None)

Returns a list of connections in the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatapolicy_v1.html b/docs/dyn/bigquerydatapolicy_v1.html index 0c9ee3e248..ea7da94389 100644 --- a/docs/dyn/bigquerydatapolicy_v1.html +++ b/docs/dyn/bigquerydatapolicy_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigquerydatapolicy_v1.projects.locations.dataPolicies.html b/docs/dyn/bigquerydatapolicy_v1.projects.locations.dataPolicies.html index 16e02c46d8..2f8d910eec 100644 --- a/docs/dyn/bigquerydatapolicy_v1.projects.locations.dataPolicies.html +++ b/docs/dyn/bigquerydatapolicy_v1.projects.locations.dataPolicies.html @@ -93,7 +93,7 @@

Instance Methods

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

List all of the data policies in the specified parent project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -289,17 +289,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatapolicy_v2.html b/docs/dyn/bigquerydatapolicy_v2.html index 617c7c7f9b..ffe6c6438c 100644 --- a/docs/dyn/bigquerydatapolicy_v2.html +++ b/docs/dyn/bigquerydatapolicy_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigquerydatapolicy_v2.projects.locations.dataPolicies.html b/docs/dyn/bigquerydatapolicy_v2.projects.locations.dataPolicies.html index 8f7501c26e..95ee968673 100644 --- a/docs/dyn/bigquerydatapolicy_v2.projects.locations.dataPolicies.html +++ b/docs/dyn/bigquerydatapolicy_v2.projects.locations.dataPolicies.html @@ -96,7 +96,7 @@

Instance Methods

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

List all of the data policies in the specified parent project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -374,17 +374,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatatransfer_v1.html b/docs/dyn/bigquerydatatransfer_v1.html index 064c4170d1..abe3fe0e68 100644 --- a/docs/dyn/bigquerydatatransfer_v1.html +++ b/docs/dyn/bigquerydatatransfer_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigquerydatatransfer_v1.projects.dataSources.html b/docs/dyn/bigquerydatatransfer_v1.projects.dataSources.html index 2dd923494a..1ca1585b05 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.dataSources.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.dataSources.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists supported data sources and returns their settings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.locations.dataSources.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.dataSources.html index 5903639c64..573ef24602 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.dataSources.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.dataSources.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists supported data sources and returns their settings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.locations.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.html index 96f8badf02..5e491dfcd5 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

unenrollDataSources(name, body=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.html index 409aa9e7ef..f3ae2c7f02 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, dataSourceIds=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns information about all transfer configs owned by a project in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, authorizationCode=None, body=None, serviceAccountName=None, updateMask=None, versionInfo=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.html index 23a898c7c3..08ca7415af 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, runAttempt=None, states=None, x__xgafv=None)

Returns information about running and completed transfer runs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.transferLogs.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.transferLogs.html index accded248a..22c9bc83aa 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.transferLogs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.runs.transferLogs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, messageTypes=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns log messages for the transfer run.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.locations.transferConfigs.transferResources.html b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.transferResources.html index 3818a448da..86ceeebffa 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.transferResources.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.locations.transferConfigs.transferResources.html @@ -84,7 +84,7 @@

Instance Methods

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

Returns information about transfer resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.transferConfigs.html b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html index 6c11522917..e8ccac443a 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, dataSourceIds=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns information about all transfer configs owned by a project in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, authorizationCode=None, body=None, serviceAccountName=None, updateMask=None, versionInfo=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.html b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.html index 662d43122f..611322d397 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, runAttempt=None, states=None, x__xgafv=None)

Returns information about running and completed transfer runs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.transferConfigs.runs.transferLogs.html b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.transferLogs.html index 2327c2962a..50e27023be 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.transferLogs.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.runs.transferLogs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, messageTypes=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns log messages for the transfer run.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigquerydatatransfer_v1.projects.transferConfigs.transferResources.html b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.transferResources.html index 55404011aa..189f672b23 100644 --- a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.transferResources.html +++ b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.transferResources.html @@ -84,7 +84,7 @@

Instance Methods

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

Returns information about transfer resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigqueryreservation_v1.html b/docs/dyn/bigqueryreservation_v1.html index ce5be70c9f..c4ee4c5d97 100644 --- a/docs/dyn/bigqueryreservation_v1.html +++ b/docs/dyn/bigqueryreservation_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html index 42eaf03ee7..bbec0f41f1 100644 --- a/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html +++ b/docs/dyn/bigqueryreservation_v1.projects.locations.capacityCommitments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all the capacity commitments for the admin project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

merge(parent, body=None, x__xgafv=None)

@@ -272,17 +272,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.html b/docs/dyn/bigqueryreservation_v1.projects.locations.html index 78573ad61e..ec0ca4a472 100644 --- a/docs/dyn/bigqueryreservation_v1.projects.locations.html +++ b/docs/dyn/bigqueryreservation_v1.projects.locations.html @@ -99,13 +99,13 @@

Instance Methods

searchAllAssignments(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Looks up assignments for a specified resource for a particular region. If the request is about a project: 1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. The same logic applies if the request is about a folder. If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). Comparing to ListAssignments, there are some behavior differences: 1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project->folder->organization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`.

- searchAllAssignments_next(previous_request, previous_response)

+ searchAllAssignments_next()

Retrieves the next page of results.

searchAssignments(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project: 1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. The same logic applies if the request is about a folder. If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). Comparing to ListAssignments, there are some behavior differences: 1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project->folder->organization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`. **Note** "-" cannot be used for projects nor locations.

- searchAssignments_next(previous_request, previous_response)

+ searchAssignments_next()

Retrieves the next page of results.

updateBiReservation(name, body=None, updateMask=None, x__xgafv=None)

@@ -188,17 +188,17 @@

Method Details

- searchAllAssignments_next(previous_request, previous_response) + searchAllAssignments_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)
+        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.
-
+ 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. +
@@ -245,17 +245,17 @@

Method Details

- searchAssignments_next(previous_request, previous_response) + searchAssignments_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservationGroups.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservationGroups.html index f97563d737..16c3509d59 100644 --- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservationGroups.html +++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservationGroups.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all the reservation groups for the project in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.assignments.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.assignments.html index 6ad5a34530..a4509e4291 100644 --- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.assignments.html +++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.assignments.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists assignments. Only explicitly created assignments will be returned. Example: * Organization `organizationA` contains two projects, `project1` and `project2`. * Reservation `res1` exists and was created previously. * CreateAssignment was used previously to define the following associations between entities and reservations: `` and `` In this example, ListAssignments will just return the above two assignments for reservation `res1`, and no expansion/merge will happen. The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed. **Note** "-" cannot be used for projects nor locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -278,17 +278,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html index 17c99150e8..13dd099e74 100644 --- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html +++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html @@ -101,7 +101,7 @@

Instance Methods

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

Lists all the reservations for the project in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -488,17 +488,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.html b/docs/dyn/bigtableadmin_v2.html index f671cdf4f4..0007951dc5 100644 --- a/docs/dyn/bigtableadmin_v2.html +++ b/docs/dyn/bigtableadmin_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/bigtableadmin_v2.operations.projects.operations.html b/docs/dyn/bigtableadmin_v2.operations.projects.operations.html index 726c133672..667c72ff4c 100644 --- a/docs/dyn/bigtableadmin_v2.operations.projects.operations.html +++ b/docs/dyn/bigtableadmin_v2.operations.projects.operations.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigtableadmin_v2.projects.instances.appProfiles.html b/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html index 820120cde8..08b9e3c1b6 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists information about app profiles in an instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -285,17 +285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html index 40c2d82c74..32d3f8373d 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html @@ -96,7 +96,7 @@

Instance Methods

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

Lists Cloud Bigtable backups. Returns both completed and pending backups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.hotTablets.html b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.hotTablets.html index 89f42e75a2..f64fde243b 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.hotTablets.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.hotTablets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigtableadmin_v2.projects.instances.clusters.html b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.html index 7839d527b0..839e631e83 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists information about clusters in an instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

partialUpdateCluster(name, body=None, updateMask=None, x__xgafv=None)

@@ -318,17 +318,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.memoryLayers.html b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.memoryLayers.html index 444ad8b151..b22a14e2a7 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.memoryLayers.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.memoryLayers.html @@ -81,7 +81,7 @@

Instance Methods

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

Lists information about memory layers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/bigtableadmin_v2.projects.instances.html b/docs/dyn/bigtableadmin_v2.projects.instances.html index 36e6ed00e0..f14ef5cc55 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.html @@ -118,7 +118,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists information about instances in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

partialUpdateInstance(name, body=None, updateMask=None, x__xgafv=None)

@@ -373,17 +373,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.logicalViews.html b/docs/dyn/bigtableadmin_v2.projects.instances.logicalViews.html index 628b4928ae..d4d6f0c777 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.logicalViews.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.logicalViews.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists information about logical views in an instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.materializedViews.html b/docs/dyn/bigtableadmin_v2.projects.instances.materializedViews.html index e87f4ee65a..af0a136abf 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.materializedViews.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.materializedViews.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists information about materialized views in an instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.tables.authorizedViews.html b/docs/dyn/bigtableadmin_v2.projects.instances.tables.authorizedViews.html index 1791cd16e8..51c019a2c3 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.tables.authorizedViews.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.tables.authorizedViews.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all AuthorizedViews from a specific table.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -337,17 +337,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.tables.html b/docs/dyn/bigtableadmin_v2.projects.instances.tables.html index 3b3aac9d6f..43b47369b8 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.tables.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.tables.html @@ -112,7 +112,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all tables served from a specified instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyColumnFamilies(name, body=None, x__xgafv=None)

@@ -1227,17 +1227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.tables.schemaBundles.html b/docs/dyn/bigtableadmin_v2.projects.instances.tables.schemaBundles.html index dd15f63932..5f088eb8f7 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.tables.schemaBundles.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.tables.schemaBundles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all schema bundles associated with the specified table.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -120,6 +120,11 @@

Method Details

The object takes the form of: { # A named collection of related schemas. + "avroSchema": { # Represents a collection of Avro schemas. # Optional. Schema for Avros. + "jsonSchemas": [ # Required. The Avro schemas in JSON format. Each element must be the content of a valid, self-contained Avro schema file (.avsc), as described in https://avro.apache.org/docs/1.8.1/spec.html. Use repeated elements to include multiple Avro schema files in a single bundle. + "A String", + ], + }, "etag": "A String", # Optional. The etag for this schema bundle. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag. "name": "A String", # Identifier. The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}` "protoSchema": { # Represents a collection of protobuf schemas. # Schema for Protobufs. @@ -191,6 +196,11 @@

Method Details

An object of the form: { # A named collection of related schemas. + "avroSchema": { # Represents a collection of Avro schemas. # Optional. Schema for Avros. + "jsonSchemas": [ # Required. The Avro schemas in JSON format. Each element must be the content of a valid, self-contained Avro schema file (.avsc), as described in https://avro.apache.org/docs/1.8.1/spec.html. Use repeated elements to include multiple Avro schema files in a single bundle. + "A String", + ], + }, "etag": "A String", # Optional. The etag for this schema bundle. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag. "name": "A String", # Identifier. The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}` "protoSchema": { # Represents a collection of protobuf schemas. # Schema for Protobufs. @@ -281,6 +291,11 @@

Method Details

"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. "schemaBundles": [ # The schema bundles from the specified table. { # A named collection of related schemas. + "avroSchema": { # Represents a collection of Avro schemas. # Optional. Schema for Avros. + "jsonSchemas": [ # Required. The Avro schemas in JSON format. Each element must be the content of a valid, self-contained Avro schema file (.avsc), as described in https://avro.apache.org/docs/1.8.1/spec.html. Use repeated elements to include multiple Avro schema files in a single bundle. + "A String", + ], + }, "etag": "A String", # Optional. The etag for this schema bundle. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag. "name": "A String", # Identifier. The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}` "protoSchema": { # Represents a collection of protobuf schemas. # Schema for Protobufs. @@ -292,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -315,6 +330,11 @@

Method Details

The object takes the form of: { # A named collection of related schemas. + "avroSchema": { # Represents a collection of Avro schemas. # Optional. Schema for Avros. + "jsonSchemas": [ # Required. The Avro schemas in JSON format. Each element must be the content of a valid, self-contained Avro schema file (.avsc), as described in https://avro.apache.org/docs/1.8.1/spec.html. Use repeated elements to include multiple Avro schema files in a single bundle. + "A String", + ], + }, "etag": "A String", # Optional. The etag for this schema bundle. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag. "name": "A String", # Identifier. The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}` "protoSchema": { # Represents a collection of protobuf schemas. # Schema for Protobufs. diff --git a/docs/dyn/bigtableadmin_v2.projects.locations.html b/docs/dyn/bigtableadmin_v2.projects.locations.html index 12b072b365..33bab48978 100644 --- a/docs/dyn/bigtableadmin_v2.projects.locations.html +++ b/docs/dyn/bigtableadmin_v2.projects.locations.html @@ -81,7 +81,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/billingbudgets_v1.billingAccounts.budgets.html b/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html index f54ac60c09..abb7e06771 100644 --- a/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html +++ b/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, scope=None, x__xgafv=None)

Returns a list of budgets for a billing account. WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -444,17 +444,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/billingbudgets_v1.html b/docs/dyn/billingbudgets_v1.html index be4d40581d..2100915202 100644 --- a/docs/dyn/billingbudgets_v1.html +++ b/docs/dyn/billingbudgets_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/billingbudgets_v1beta1.billingAccounts.budgets.html b/docs/dyn/billingbudgets_v1beta1.billingAccounts.budgets.html index 43db15b847..0810360cd9 100644 --- a/docs/dyn/billingbudgets_v1beta1.billingAccounts.budgets.html +++ b/docs/dyn/billingbudgets_v1beta1.billingAccounts.budgets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, scope=None, x__xgafv=None)

Returns a list of budgets for a billing account. WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, x__xgafv=None)

@@ -446,17 +446,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/billingbudgets_v1beta1.html b/docs/dyn/billingbudgets_v1beta1.html index ce3474f5d0..0957ba20b8 100644 --- a/docs/dyn/billingbudgets_v1beta1.html +++ b/docs/dyn/billingbudgets_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/binaryauthorization_v1.html b/docs/dyn/binaryauthorization_v1.html index f3a5d88f71..973a1bb0ef 100644 --- a/docs/dyn/binaryauthorization_v1.html +++ b/docs/dyn/binaryauthorization_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/binaryauthorization_v1.projects.attestors.html b/docs/dyn/binaryauthorization_v1.projects.attestors.html index e86cd70849..8bdc26ca7d 100644 --- a/docs/dyn/binaryauthorization_v1.projects.attestors.html +++ b/docs/dyn/binaryauthorization_v1.projects.attestors.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists attestors. Returns `INVALID_ARGUMENT` if the project does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/binaryauthorization_v1.projects.platforms.policies.html b/docs/dyn/binaryauthorization_v1.projects.platforms.policies.html index ce5e42fa69..c604a358a6 100644 --- a/docs/dyn/binaryauthorization_v1.projects.platforms.policies.html +++ b/docs/dyn/binaryauthorization_v1.projects.platforms.policies.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists platform policies owned by a project in the specified platform. Returns `INVALID_ARGUMENT` if the project or the platform doesn't exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replacePlatformPolicy(name, body=None, x__xgafv=None)

@@ -617,17 +617,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/binaryauthorization_v1beta1.html b/docs/dyn/binaryauthorization_v1beta1.html index cada8d2c21..84838b55c7 100644 --- a/docs/dyn/binaryauthorization_v1beta1.html +++ b/docs/dyn/binaryauthorization_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/binaryauthorization_v1beta1.projects.attestors.html b/docs/dyn/binaryauthorization_v1beta1.projects.attestors.html index 73b9fc7415..8d0506232b 100644 --- a/docs/dyn/binaryauthorization_v1beta1.projects.attestors.html +++ b/docs/dyn/binaryauthorization_v1beta1.projects.attestors.html @@ -93,7 +93,7 @@

Instance Methods

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

Lists attestors. Returns INVALID_ARGUMENT if the project does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/blockchainnodeengine_v1.html b/docs/dyn/blockchainnodeengine_v1.html index d1ee5b8d2d..c7392e6e51 100644 --- a/docs/dyn/blockchainnodeengine_v1.html +++ b/docs/dyn/blockchainnodeengine_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/blockchainnodeengine_v1.projects.locations.blockchainNodes.html b/docs/dyn/blockchainnodeengine_v1.projects.locations.blockchainNodes.html index b86121174f..4a0f1289b7 100644 --- a/docs/dyn/blockchainnodeengine_v1.projects.locations.blockchainNodes.html +++ b/docs/dyn/blockchainnodeengine_v1.projects.locations.blockchainNodes.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists blockchain nodes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/blockchainnodeengine_v1.projects.locations.html b/docs/dyn/blockchainnodeengine_v1.projects.locations.html index 8c9ac07753..987de5f0cd 100644 --- a/docs/dyn/blockchainnodeengine_v1.projects.locations.html +++ b/docs/dyn/blockchainnodeengine_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/blockchainnodeengine_v1.projects.locations.operations.html b/docs/dyn/blockchainnodeengine_v1.projects.locations.operations.html index 3c1b515f37..70f46d19ed 100644 --- a/docs/dyn/blockchainnodeengine_v1.projects.locations.operations.html +++ b/docs/dyn/blockchainnodeengine_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/blogger_v3.comments.html b/docs/dyn/blogger_v3.comments.html index e08d772d6d..880f66cf76 100644 --- a/docs/dyn/blogger_v3.comments.html +++ b/docs/dyn/blogger_v3.comments.html @@ -93,10 +93,10 @@

Instance Methods

listByBlog(blogId, endDate=None, fetchBodies=None, maxResults=None, pageToken=None, startDate=None, status=None, x__xgafv=None)

Lists comments by blog.

- listByBlog_next(previous_request, previous_response)

+ listByBlog_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAsSpam(blogId, postId, commentId, x__xgafv=None)

@@ -349,31 +349,31 @@

Method Details

- listByBlog_next(previous_request, previous_response) + listByBlog_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/blogger_v3.html b/docs/dyn/blogger_v3.html index 8aba7f6d3e..9f14da132f 100644 --- a/docs/dyn/blogger_v3.html +++ b/docs/dyn/blogger_v3.html @@ -118,7 +118,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -127,20 +127,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/blogger_v3.pages.html b/docs/dyn/blogger_v3.pages.html index 0291ca19dd..6ee70433c0 100644 --- a/docs/dyn/blogger_v3.pages.html +++ b/docs/dyn/blogger_v3.pages.html @@ -90,7 +90,7 @@

Instance Methods

list(blogId, fetchBodies=None, maxResults=None, pageToken=None, status=None, view=None, x__xgafv=None)

Lists pages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(blogId, pageId, body=None, publish=None, revert=None, x__xgafv=None)

@@ -303,17 +303,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/blogger_v3.postUserInfos.html b/docs/dyn/blogger_v3.postUserInfos.html index f02b6a2e3e..3a32ba2537 100644 --- a/docs/dyn/blogger_v3.postUserInfos.html +++ b/docs/dyn/blogger_v3.postUserInfos.html @@ -84,7 +84,7 @@

Instance Methods

list(userId, blogId, endDate=None, fetchBodies=None, labels=None, maxResults=None, orderBy=None, pageToken=None, startDate=None, status=None, view=None, x__xgafv=None)

Lists post and user info pairs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/blogger_v3.posts.html b/docs/dyn/blogger_v3.posts.html index 30a776d455..ffd9d2ccf1 100644 --- a/docs/dyn/blogger_v3.posts.html +++ b/docs/dyn/blogger_v3.posts.html @@ -93,7 +93,7 @@

Instance Methods

list(blogId, endDate=None, fetchBodies=None, fetchImages=None, labels=None, maxResults=None, orderBy=None, pageToken=None, sortOption=None, startDate=None, status=None, view=None, x__xgafv=None)

Lists posts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(blogId, postId, body=None, fetchBody=None, fetchImages=None, maxComments=None, publish=None, revert=None, x__xgafv=None)

@@ -623,17 +623,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/books_v1.html b/docs/dyn/books_v1.html index eb17d157a8..6b0395186a 100644 --- a/docs/dyn/books_v1.html +++ b/docs/dyn/books_v1.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/books_v1.layers.annotationData.html b/docs/dyn/books_v1.layers.annotationData.html index 09effa8214..97757dfff0 100644 --- a/docs/dyn/books_v1.layers.annotationData.html +++ b/docs/dyn/books_v1.layers.annotationData.html @@ -84,7 +84,7 @@

Instance Methods

list(volumeId, layerId, contentVersion, annotationDataId=None, h=None, locale=None, maxResults=None, pageToken=None, scale=None, source=None, updatedMax=None, updatedMin=None, w=None, x__xgafv=None)

Gets the annotation data for a volume and layer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/books_v1.layers.volumeAnnotations.html b/docs/dyn/books_v1.layers.volumeAnnotations.html index 820fab5902..5a396949c8 100644 --- a/docs/dyn/books_v1.layers.volumeAnnotations.html +++ b/docs/dyn/books_v1.layers.volumeAnnotations.html @@ -84,7 +84,7 @@

Instance Methods

list(volumeId, layerId, contentVersion, endOffset=None, endPosition=None, locale=None, maxResults=None, pageToken=None, showDeleted=None, source=None, startOffset=None, startPosition=None, updatedMax=None, updatedMin=None, volumeAnnotationsVersion=None, x__xgafv=None)

Gets the volume annotations for a volume and layer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/books_v1.mylibrary.annotations.html b/docs/dyn/books_v1.mylibrary.annotations.html index 927f040311..8e6bc5d45c 100644 --- a/docs/dyn/books_v1.mylibrary.annotations.html +++ b/docs/dyn/books_v1.mylibrary.annotations.html @@ -87,7 +87,7 @@

Instance Methods

list(contentVersion=None, layerId=None, layerIds=None, maxResults=None, pageToken=None, showDeleted=None, source=None, updatedMax=None, updatedMin=None, volumeId=None, x__xgafv=None)

Retrieves a list of annotations, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

summary(layerIds, volumeId, source=None, x__xgafv=None)

@@ -407,17 +407,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/books_v1.onboarding.html b/docs/dyn/books_v1.onboarding.html index 7597fb6648..ad2ef36229 100644 --- a/docs/dyn/books_v1.onboarding.html +++ b/docs/dyn/books_v1.onboarding.html @@ -84,7 +84,7 @@

Instance Methods

listCategoryVolumes(categoryId=None, locale=None, maxAllowedMaturityRating=None, pageSize=None, pageToken=None, x__xgafv=None)

List available volumes under categories for onboarding experience.

- listCategoryVolumes_next(previous_request, previous_response)

+ listCategoryVolumes_next()

Retrieves the next page of results.

Method Details

@@ -374,17 +374,17 @@

Method Details

- listCategoryVolumes_next(previous_request, previous_response) + listCategoryVolumes_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)
+        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.
-
+ 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/businessprofileperformance_v1.html b/docs/dyn/businessprofileperformance_v1.html index b50451114e..96dd5bfd61 100644 --- a/docs/dyn/businessprofileperformance_v1.html +++ b/docs/dyn/businessprofileperformance_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/businessprofileperformance_v1.locations.searchkeywords.impressions.monthly.html b/docs/dyn/businessprofileperformance_v1.locations.searchkeywords.impressions.monthly.html index 457f358ed7..b795c6b284 100644 --- a/docs/dyn/businessprofileperformance_v1.locations.searchkeywords.impressions.monthly.html +++ b/docs/dyn/businessprofileperformance_v1.locations.searchkeywords.impressions.monthly.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, monthlyRange_endMonth_day=None, monthlyRange_endMonth_month=None, monthlyRange_endMonth_year=None, monthlyRange_startMonth_day=None, monthlyRange_startMonth_month=None, monthlyRange_startMonth_year=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/calendar_v3.acl.html b/docs/dyn/calendar_v3.acl.html index cff079a55b..948b9abc3e 100644 --- a/docs/dyn/calendar_v3.acl.html +++ b/docs/dyn/calendar_v3.acl.html @@ -90,7 +90,7 @@

Instance Methods

list(calendarId, maxResults=None, pageToken=None, showDeleted=None, syncToken=None)

Returns the rules in the access control list for the calendar.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(calendarId, ruleId, body=None, sendNotifications=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/calendar_v3.calendarList.html b/docs/dyn/calendar_v3.calendarList.html index f38ff131c1..68b04b65ba 100644 --- a/docs/dyn/calendar_v3.calendarList.html +++ b/docs/dyn/calendar_v3.calendarList.html @@ -90,7 +90,7 @@

Instance Methods

list(maxResults=None, minAccessRole=None, pageToken=None, showDeleted=None, showHidden=None, showOwnOrganizationOnly=None, syncToken=None)

Returns the calendars on the user's calendar list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(calendarId, body=None, colorRgbFormat=None)

@@ -425,17 +425,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/calendar_v3.events.html b/docs/dyn/calendar_v3.events.html index 81a88b62db..0fbc9b43b5 100644 --- a/docs/dyn/calendar_v3.events.html +++ b/docs/dyn/calendar_v3.events.html @@ -93,13 +93,13 @@

Instance Methods

instances(calendarId, eventId, alwaysIncludeEmail=None, maxAttendees=None, maxResults=None, originalStart=None, pageToken=None, showDeleted=None, timeMax=None, timeMin=None, timeZone=None)

Returns instances of the specified recurring event.

- instances_next(previous_request, previous_response)

+ instances_next()

Retrieves the next page of results.

list(calendarId, alwaysIncludeEmail=None, eventTypes=None, iCalUID=None, maxAttendees=None, maxResults=None, orderBy=None, pageToken=None, privateExtendedProperty=None, q=None, sharedExtendedProperty=None, showDeleted=None, showHiddenInvitations=None, singleEvents=None, syncToken=None, timeMax=None, timeMin=None, timeZone=None, updatedMin=None)

Returns events on the specified calendar.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(calendarId, eventId, destination, sendNotifications=None, sendUpdates=None)

@@ -2075,17 +2075,17 @@

Method Details

- instances_next(previous_request, previous_response) + instances_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)
+        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.
-
+ 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. +
@@ -2488,17 +2488,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/calendar_v3.html b/docs/dyn/calendar_v3.html index ac7d1e092a..e8cbf39d35 100644 --- a/docs/dyn/calendar_v3.html +++ b/docs/dyn/calendar_v3.html @@ -118,7 +118,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -127,20 +127,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/calendar_v3.settings.html b/docs/dyn/calendar_v3.settings.html index 9b7a3e3209..42102842ee 100644 --- a/docs/dyn/calendar_v3.settings.html +++ b/docs/dyn/calendar_v3.settings.html @@ -84,7 +84,7 @@

Instance Methods

list(maxResults=None, pageToken=None, syncToken=None)

Returns all user settings for the authenticated user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

watch(body=None, maxResults=None, pageToken=None, syncToken=None)

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.html b/docs/dyn/certificatemanager_v1.html index 339b9e2d9e..d0320188ac 100644 --- a/docs/dyn/certificatemanager_v1.html +++ b/docs/dyn/certificatemanager_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/certificatemanager_v1.projects.locations.certificateIssuanceConfigs.html b/docs/dyn/certificatemanager_v1.projects.locations.certificateIssuanceConfigs.html index 4f5b6a6c4f..07faf23ea5 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.certificateIssuanceConfigs.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.certificateIssuanceConfigs.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CertificateIssuanceConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.certificateMapEntries.html b/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.certificateMapEntries.html index 1a4006b6a6..3033c60c0d 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.certificateMapEntries.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.certificateMapEntries.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists CertificateMapEntries in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.html b/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.html index 1cef21c70e..15d6f4a1dd 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.certificateMaps.html @@ -95,7 +95,7 @@

Instance Methods

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

Lists CertificateMaps in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.projects.locations.certificates.html b/docs/dyn/certificatemanager_v1.projects.locations.certificates.html index 01b414d866..61893917f3 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.certificates.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.certificates.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists Certificates in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -464,17 +464,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.projects.locations.dnsAuthorizations.html b/docs/dyn/certificatemanager_v1.projects.locations.dnsAuthorizations.html index 83a067d98d..223eef0653 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.dnsAuthorizations.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.dnsAuthorizations.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists DnsAuthorizations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -278,17 +278,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/certificatemanager_v1.projects.locations.html b/docs/dyn/certificatemanager_v1.projects.locations.html index 788111e284..58d48791f3 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.html @@ -114,7 +114,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/certificatemanager_v1.projects.locations.operations.html b/docs/dyn/certificatemanager_v1.projects.locations.operations.html index cb2b711639..8dd63d1440 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.operations.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/certificatemanager_v1.projects.locations.trustConfigs.html b/docs/dyn/certificatemanager_v1.projects.locations.trustConfigs.html index a8ddeaed7a..170487f74d 100644 --- a/docs/dyn/certificatemanager_v1.projects.locations.trustConfigs.html +++ b/docs/dyn/certificatemanager_v1.projects.locations.trustConfigs.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists TrustConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.html b/docs/dyn/ces_v1.html index ec4cac8c2f..f07dd0a9ef 100644 --- a/docs/dyn/ces_v1.html +++ b/docs/dyn/ces_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ces_v1.projects.locations.apps.agents.html b/docs/dyn/ces_v1.projects.locations.apps.agents.html index 92d9beb190..83759a8c4d 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.agents.html +++ b/docs/dyn/ces_v1.projects.locations.apps.agents.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists agents in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -936,17 +936,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.changelogs.html b/docs/dyn/ces_v1.projects.locations.apps.changelogs.html index 7da40930f8..1f574482bb 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.changelogs.html +++ b/docs/dyn/ces_v1.projects.locations.apps.changelogs.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists the changelogs of the specified app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1.projects.locations.apps.conversations.html b/docs/dyn/ces_v1.projects.locations.apps.conversations.html index b2462c6e03..084313d544 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.conversations.html +++ b/docs/dyn/ces_v1.projects.locations.apps.conversations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, source=None, sources=None, x__xgafv=None)

Lists conversations in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -541,17 +541,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1.projects.locations.apps.deployments.html b/docs/dyn/ces_v1.projects.locations.apps.deployments.html index 5df3098580..ed682a733e 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.deployments.html +++ b/docs/dyn/ces_v1.projects.locations.apps.deployments.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -669,17 +669,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.examples.html b/docs/dyn/ces_v1.projects.locations.apps.examples.html index 77425de981..1b828edfe7 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.examples.html +++ b/docs/dyn/ces_v1.projects.locations.apps.examples.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists examples in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -471,17 +471,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.guardrails.html b/docs/dyn/ces_v1.projects.locations.apps.guardrails.html index 325890ec69..ba0c1f833e 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.guardrails.html +++ b/docs/dyn/ces_v1.projects.locations.apps.guardrails.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists guardrails in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -600,17 +600,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.html b/docs/dyn/ces_v1.projects.locations.apps.html index ba0edb8d30..85e64f6c24 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.html +++ b/docs/dyn/ces_v1.projects.locations.apps.html @@ -157,7 +157,7 @@

Instance Methods

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

Lists apps in the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1485,17 +1485,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.tools.html b/docs/dyn/ces_v1.projects.locations.apps.tools.html index d446d7c1f9..255e10de42 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.tools.html +++ b/docs/dyn/ces_v1.projects.locations.apps.tools.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists tools in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -2356,17 +2356,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.toolsets.html b/docs/dyn/ces_v1.projects.locations.apps.toolsets.html index db1a7e81d6..32f64bf75e 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.toolsets.html +++ b/docs/dyn/ces_v1.projects.locations.apps.toolsets.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists toolsets in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1015,17 +1015,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.apps.versions.html b/docs/dyn/ces_v1.projects.locations.apps.versions.html index f6c0984ded..4cef823aaf 100644 --- a/docs/dyn/ces_v1.projects.locations.apps.versions.html +++ b/docs/dyn/ces_v1.projects.locations.apps.versions.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all app versions in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -6009,17 +6009,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1.projects.locations.html b/docs/dyn/ces_v1.projects.locations.html index 1bbc454404..6c3bc48370 100644 --- a/docs/dyn/ces_v1.projects.locations.html +++ b/docs/dyn/ces_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1.projects.locations.operations.html b/docs/dyn/ces_v1.projects.locations.operations.html index 8024927f9e..68d0058285 100644 --- a/docs/dyn/ces_v1.projects.locations.operations.html +++ b/docs/dyn/ces_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1beta.html b/docs/dyn/ces_v1beta.html index da89a51919..c5c3041124 100644 --- a/docs/dyn/ces_v1beta.html +++ b/docs/dyn/ces_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.agents.html b/docs/dyn/ces_v1beta.projects.locations.apps.agents.html index 8aedaaac42..1c5229dcad 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.agents.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.agents.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists agents in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -936,17 +936,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.changelogs.html b/docs/dyn/ces_v1beta.projects.locations.apps.changelogs.html index 6175078fe4..66507898f1 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.changelogs.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.changelogs.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists the changelogs of the specified app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1beta.projects.locations.apps.conversations.html b/docs/dyn/ces_v1beta.projects.locations.apps.conversations.html index 4dea022b3c..f328710512 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.conversations.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, source=None, sources=None, x__xgafv=None)

Lists conversations in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -587,17 +587,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1beta.projects.locations.apps.deployments.html b/docs/dyn/ces_v1beta.projects.locations.apps.deployments.html index a61a81a71d..a082aeaa05 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.deployments.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.deployments.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -669,17 +669,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationDatasets.html b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationDatasets.html index 15d2703741..ca86917532 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationDatasets.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationDatasets.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all evaluation datasets in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -511,17 +511,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationExpectations.html b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationExpectations.html index 31fe67c94e..d43fc8f1e0 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationExpectations.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationExpectations.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all evaluation expectations in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationRuns.html b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationRuns.html index 34755642a8..58f76393c4 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.evaluationRuns.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.evaluationRuns.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all evaluation runs in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -495,17 +495,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ces_v1beta.projects.locations.apps.evaluations.html b/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.html index 1ed928c1e6..c51a675c65 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, evaluationFilter=None, evaluationRunFilter=None, filter=None, lastTenResults=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all evaluations in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -7152,17 +7152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.results.html b/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.results.html index a3cbc744ef..40eab22a25 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.results.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.evaluations.results.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all evaluation results for a given evaluation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

runEvaluationResultMetrics(evaluationResultId, body=None, x__xgafv=None)

@@ -1487,17 +1487,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.examples.html b/docs/dyn/ces_v1beta.projects.locations.apps.examples.html index b53c1d8b9a..632c69d4c5 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.examples.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.examples.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists examples in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -471,17 +471,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.guardrails.html b/docs/dyn/ces_v1beta.projects.locations.apps.guardrails.html index 6eb2bd2018..d913a63a9c 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.guardrails.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.guardrails.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists guardrails in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -600,17 +600,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.html b/docs/dyn/ces_v1beta.projects.locations.apps.html index 4480f468fa..d35b75742a 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.html @@ -188,7 +188,7 @@

Instance Methods

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

Lists apps in the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -2769,17 +2769,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.scheduledEvaluationRuns.html b/docs/dyn/ces_v1beta.projects.locations.apps.scheduledEvaluationRuns.html index 20ad601417..a60926eca4 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.scheduledEvaluationRuns.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.scheduledEvaluationRuns.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists all scheduled evaluation runs in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -451,17 +451,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.tools.html b/docs/dyn/ces_v1beta.projects.locations.apps.tools.html index e7be6ba902..b1768f1e4b 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.tools.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.tools.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists tools in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -2356,17 +2356,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.toolsets.html b/docs/dyn/ces_v1beta.projects.locations.apps.toolsets.html index c50227cd65..7e49b9768d 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.toolsets.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.toolsets.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists toolsets in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -1015,17 +1015,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.apps.versions.html b/docs/dyn/ces_v1beta.projects.locations.apps.versions.html index 80112c2abd..237c62ef3d 100644 --- a/docs/dyn/ces_v1beta.projects.locations.apps.versions.html +++ b/docs/dyn/ces_v1beta.projects.locations.apps.versions.html @@ -98,7 +98,7 @@

Instance Methods

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

Lists all app versions in the given app.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -6185,17 +6185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.html b/docs/dyn/ces_v1beta.projects.locations.html index 063cfb5dcf..bbad7d1f7a 100644 --- a/docs/dyn/ces_v1beta.projects.locations.html +++ b/docs/dyn/ces_v1beta.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSecuritySettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -200,17 +200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ces_v1beta.projects.locations.operations.html b/docs/dyn/ces_v1beta.projects.locations.operations.html index 3589910e74..95aaeb5af4 100644 --- a/docs/dyn/ces_v1beta.projects.locations.operations.html +++ b/docs/dyn/ces_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chat_v1.customEmojis.html b/docs/dyn/chat_v1.customEmojis.html index 2e5fb547ec..e6a4bfe4b3 100644 --- a/docs/dyn/chat_v1.customEmojis.html +++ b/docs/dyn/chat_v1.customEmojis.html @@ -90,7 +90,7 @@

Instance Methods

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

Lists custom emojis visible to the authenticated user. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.customemojis.readonly` - `https://www.googleapis.com/auth/chat.customemojis`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chat_v1.html b/docs/dyn/chat_v1.html index d6d9a0e9d5..22a8d24cee 100644 --- a/docs/dyn/chat_v1.html +++ b/docs/dyn/chat_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html index 4bbbfd17bd..4e219f5daf 100644 --- a/docs/dyn/chat_v1.spaces.html +++ b/docs/dyn/chat_v1.spaces.html @@ -113,7 +113,7 @@

Instance Methods

findGroupChats(pageSize=None, pageToken=None, spaceView=None, users=None, x__xgafv=None)

Returns all spaces with `spaceType == GROUP_CHAT`, whose human memberships contain exactly the calling user, and the users specified in `FindGroupChatsRequest.users`. Only members that have joined the conversation are supported. For an example, see [Find group chats](https://developers.google.com/workspace/chat/find-group-chats). If the calling user blocks, or is blocked by, some users, and no spaces with the entire specified set of users are found, this method returns spaces that don't include the blocked or blocking users. The specified set of users must contain only human (non-app) memberships. A request that contains non-human users doesn't return any spaces. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships`

- findGroupChats_next(previous_request, previous_response)

+ findGroupChats_next()

Retrieves the next page of results.

get(name, useAdminAccess=None, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

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

Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` To list all named spaces by Google Workspace organization, use the [`spaces.search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search) method using Workspace administrator privileges instead.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -131,7 +131,7 @@

Instance Methods

search(orderBy=None, pageSize=None, pageToken=None, query=None, useAdminAccess=None, x__xgafv=None)

Returns a list of spaces in a Google Workspace organization. For an example, see [Search for and manage spaces](https://developers.google.com/workspace/chat/search-manage-admin). When `use_admin_access` is set to `false`, the results are limited to spaces where the calling user is a joined member. To search with administrator privileges, set `use_admin_access` to `true`. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` - [User authentication with administrator privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges) and one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.admin.spaces.readonly` - `https://www.googleapis.com/auth/chat.admin.spaces`

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setup(body=None, x__xgafv=None)

@@ -785,17 +785,17 @@

Method Details

- findGroupChats_next(previous_request, previous_response) + findGroupChats_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)
+        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.
-
+ 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. +
@@ -1053,17 +1053,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1547,17 +1547,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1578,8 +1578,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. diff --git a/docs/dyn/chat_v1.spaces.members.html b/docs/dyn/chat_v1.spaces.members.html index 7af3360374..1d86ad9c03 100644 --- a/docs/dyn/chat_v1.spaces.members.html +++ b/docs/dyn/chat_v1.spaces.members.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, showGroups=None, showInvited=None, useAdminAccess=None, x__xgafv=None)

Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -118,8 +118,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -146,8 +148,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -181,8 +185,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -216,8 +222,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -258,8 +266,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -274,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -304,8 +314,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -333,8 +345,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. diff --git a/docs/dyn/chat_v1.spaces.messagePins.html b/docs/dyn/chat_v1.spaces.messagePins.html index 4f1182d3fa..e6f6ff39d9 100644 --- a/docs/dyn/chat_v1.spaces.messagePins.html +++ b/docs/dyn/chat_v1.spaces.messagePins.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists message pins in a space. Users can pin important messages in spaces for easy access. For more information, see [Pin or unpin a conversation in Google Chat](https://support.google.com/chat/answer/15622437). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.pins.readonly` - `https://www.googleapis.com/auth/chat.spaces.pins` - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html index dd9bd35a51..0ac5602985 100644 --- a/docs/dyn/chat_v1.spaces.messages.html +++ b/docs/dyn/chat_v1.spaces.messages.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, markupSyntax=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. System messages, like those announcing new space members, aren't included. If you list messages from a space with no messages, the response is an empty object. When using a REST/HTTP interface, the response contains an empty JSON object, `{}`. For an example, see [List messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with the authorization scope: - `https://www.googleapis.com/auth/chat.app.messages.readonly`. When using this authentication scope, this method only returns public messages in a space. It doesn't include private messages. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.messages.readonly` - `https://www.googleapis.com/auth/chat.messages` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -109,7 +109,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Searches for messages in Google Chat that the calling user has access to. Returns a list of messages matching the search criteria. To search across all spaces the user has access to, set `parent` to `spaces/-`. Using any other value for `parent` results in an `INVALID_ARGUMENT` error. The returned messages have their `name` field populated with the full resource name, which includes the specific `space` in which the message resides. This API doesn't return all message types. The types of messages listed below aren't included in the response. Use ListMessages to list all messages. - Private Messages that are visible to the authenticated user. - Messages posted by Chat apps in spaces or group chats. - Messages in a Chat app DM. - Messages from blocked users. - Messages in spaces that the caller has muted. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.messages.readonly` - `https://www.googleapis.com/auth/chat.messages`

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

update(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -1903,8 +1903,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -1919,8 +1921,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -2956,8 +2960,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3012,8 +3018,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3028,8 +3036,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3060,8 +3070,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -4980,8 +4992,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -4996,8 +5010,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6033,8 +6049,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6089,8 +6107,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6105,8 +6125,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6137,8 +6159,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -8075,8 +8099,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -8091,8 +8117,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9128,8 +9156,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9184,8 +9214,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9200,8 +9232,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9232,8 +9266,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -11158,8 +11194,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -11174,8 +11212,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12211,8 +12251,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12267,8 +12309,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12283,8 +12327,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12315,8 +12361,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12445,17 +12493,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -14241,8 +14289,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -14257,8 +14307,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15294,8 +15346,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15350,8 +15404,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15366,8 +15422,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15398,8 +15456,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -17307,8 +17367,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -17323,8 +17385,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18360,8 +18424,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18416,8 +18482,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18432,8 +18500,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18464,8 +18534,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18600,7 +18672,7 @@

Method Details

The object takes the form of: { # Request message for searching messages. - "filter": "A String", # Required. A search query. The query can specify one or more search keywords, which are used to filter the results, You can also filter the results using the following message fields: - `create_time`: Accepts a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported comparison operators are: `<` and `>=`. - `sender.name`: The resource name of the sender (`users/{user}`). Only supports `=`. You can use the e-mail as an alias for `{user}`. For example, `users/example@gmail.com`, where `example@gmail.com` is the e-mail of the Google Chat user. - `space.name`: The resource name of the space where the message is posted. (`spaces/{space}`). Only supports `=`. If this filter is not set, the search is performed across all direct messages and spaces the user has access to as a space member. - `space.display_name`: Supports the operator `:` (has) and filters spaces based on a partial match of their display name. Results are limited to the top five space matches. For example, `space.display_name:Project` searches for messages in the top five spaces that contain the word "Project" in their display names. - `attachment`: Supports the operator `:*` (has any) to check for the presence of attachments. If `attachment:*` is specified, only messages that have at least one attachment are returned. - `annotations.user_mentions.user.name`: The resource name of the mentioned user (`users/{user}`). Only supports `:` (has). For example: `annotations.user_mentions.user.name:"users/1234567890"` returns only messages that contain a mention to the specified user. Alternatively, the alias `me` can be used to filter for messages that mention the caller user, for example: `annotations.user_mentions.user.name:users/me`. You can also use the e-mail as an alias for `{user}`, for example, `users/example@gmail.com`. For advanced filtering, the following functions are also available: - `has_link()`: Returns only messages that have at least one hyperlink in the message text. - `is_unread()`: Filters out messages that have been read by the calling user. Using the `space.display_name` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` Using the `is_unread()` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.readstate.readonly` - `https://www.googleapis.com/auth/chat.users.readstate` Across different fields, only `AND` operators are supported. A valid example is `sender.name = "users/1234567890" AND is_unread()`. The word `AND` is optional and is implied if omitted. For example, `sender.name = "users/1234567890" is_unread()` is valid and is equivalent to the previous example. An invalid example is `sender.name = "users/1234567890" OR is_unread()` because `OR` is not supported between different fields. Among the same field: - `create_time` supports only `AND`, and can only be used to represent an interval, such as `create_time >= "2022-01-01T00:00:00+00:00" AND create_time < "2023-01-01T00:00:00+00:00"`. - `sender.name` supports only the `OR` operator, for example: `sender.name = "users/1234567890" OR sender.name = "users/0987654321"`. - `space.name` supports only the `OR` operator, for example: `space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI"`. - `space.display_name` supports the operators `AND` and `OR`, but not a mix of both. For example: `space.display_name:Project AND space.display_name:Tasks` returns messages that are in spaces with display names containing both `Project` and `Tasks`, whereas `space.display_name:Project OR space.display_name:Tasks` returns messages that are in spaces with display names containing either `Project` or `Tasks` or both. - `annotations.user_mentions.user.name` supports the operators `AND` and `OR`, but not a mix of both. For example: `annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321"` returns only messages that mentions both users, whereas `annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321"` returns messages that mention either user or both. Parentheses are required to disambiguate operator precedence when combining `AND` and `OR` operators in the same query. For example: `(sender.name="users/me" OR sender.name="users/123456") AND is_unread()`. Otherwise, parentheses are optional. The following example queries are valid: ``` "Pending reports" AND create_time >= "2023-01-01T00:00:00Z" sender.name = "users/example@gmail.com" annotations.user_mentions.user.name:"users/0987654321" attachment:* AND space.name = "spaces/ABCDEFGH" tasks AND is_unread() AND sender.name = "users/1234567890" "things to do" "urgent" (sender.name = "users/1234567890") AND (create_time < "2023-05-01T00:00:00Z") tasks AND space.name = "spaces/ABCDEFGH" AND has_link() "project one" is_unread() space.display_name:Project tasks ``` The maximum query length is 1,000 characters. Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error. + "filter": "A String", # Required. A search query. The query can specify one or more search keywords, which are used to filter the results, You can also filter the results using the following message fields: - `create_time`: Accepts a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported comparison operators are: `<` and `>=`. - `sender.name`: The resource name of the sender (`users/{user}`). Only supports `=`. You can use the e-mail as an alias for `{user}`. For example, `users/example@gmail.com`, where `example@gmail.com` is the e-mail of the Google Chat user. - `space.name`: The resource name of the space where the message is posted. (`spaces/{space}`). Only supports `=`. If this filter is not set, the search is performed across all direct messages and spaces the user has access to as a space member. - `space.display_name`: Supports the operator `:` (has) and filters spaces based on a partial match of their display name. Results are limited to the top five space matches. For example, `space.display_name:Project` searches for messages in the top five spaces that contain the word "Project" in their display names. - `space.space_type`: The type of the space. Only supports `=`. For example, `space.space_type="DIRECT_MESSAGE"` returns only messages from direct messages. The possible values are `DIRECT_MESSAGE`, `GROUP_CHAT`, and `SPACE`. - `attachment`: Supports the operator `:*` (has any) to check for the presence of attachments. If `attachment:*` is specified, only messages that have at least one attachment are returned. - `annotations.user_mentions.user.name`: The resource name of the mentioned user (`users/{user}`). Only supports `:` (has). For example: `annotations.user_mentions.user.name:"users/1234567890"` returns only messages that contain a mention to the specified user. Alternatively, the alias `me` can be used to filter for messages that mention the caller user, for example: `annotations.user_mentions.user.name:users/me`. You can also use the e-mail as an alias for `{user}`, for example, `users/example@gmail.com`. For advanced filtering, the following functions are also available: - `has_link()`: Returns only messages that have at least one hyperlink in the message text. - `is_unread()`: Filters out messages that have been read by the calling user. Using the `space.display_name` or the `space.space_type` filters requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` Using the `is_unread()` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.readstate.readonly` - `https://www.googleapis.com/auth/chat.users.readstate` Across different fields, only `AND` operators are supported. A valid example is `sender.name = "users/1234567890" AND is_unread()`. The word `AND` is optional and is implied if omitted. For example, `sender.name = "users/1234567890" is_unread()` is valid and is equivalent to the previous example. An invalid example is `sender.name = "users/1234567890" OR is_unread()` because `OR` is not supported between different fields. Among the same field: - `create_time` supports only `AND`, and can only be used to represent an interval, such as `create_time >= "2022-01-01T00:00:00+00:00" AND create_time < "2023-01-01T00:00:00+00:00"`. - `sender.name` supports only the `OR` operator, for example: `sender.name = "users/1234567890" OR sender.name = "users/0987654321"`. - `space.name` supports only the `OR` operator, for example: `space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI"`. - `space.display_name` supports the operators `AND` and `OR`, but not a mix of both. For example: `space.display_name:Project AND space.display_name:Tasks` returns messages that are in spaces with display names containing both `Project` and `Tasks`, whereas `space.display_name:Project OR space.display_name:Tasks` returns messages that are in spaces with display names containing either `Project` or `Tasks` or both. - `space.space_type` supports only the `OR` operator, for example: `space.space_type = "DIRECT_MESSAGE" OR space.space_type = "GROUP_CHAT"`. - `annotations.user_mentions.user.name` supports the operators `AND` and `OR`, but not a mix of both. For example: `annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321"` returns only messages that mentions both users, whereas `annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321"` returns messages that mention either user or both. Parentheses are required to disambiguate operator precedence when combining `AND` and `OR` operators in the same query. For example: `(sender.name="users/me" OR sender.name="users/123456") AND is_unread()`. Otherwise, parentheses are optional. The following example queries are valid: ``` "Pending reports" AND create_time >= "2023-01-01T00:00:00Z" sender.name = "users/example@gmail.com" annotations.user_mentions.user.name:"users/0987654321" attachment:* AND space.name = "spaces/ABCDEFGH" tasks AND is_unread() AND sender.name = "users/1234567890" "things to do" "urgent" (sender.name = "users/1234567890") AND (create_time < "2023-05-01T00:00:00Z") tasks AND space.name = "spaces/ABCDEFGH" AND has_link() "project one" is_unread() space.display_name:Project tasks ``` The maximum query length is 1,000 characters. Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error. "markupSyntax": "A String", # Optional. Specifies the desired output syntax for the Chat message `formatted_text` field. "orderBy": "A String", # Optional. How the results list is ordered. Supported attributes to order by are: - `create_time`: Sorts the results by the time of the message creation. Default value. - `relevance`: Sorts the results by relevance. [Developer Preview](https://developers.google.com/workspace/preview). The default ordering is `create_time desc`. Only a single order per query (`create_time` or `relevance`) is supported. Only descending order (`desc`) is supported, and it must be specified after the order attribute. "pageSize": 42, # Optional. The maximum number of results to return. The service may return fewer than this value. If unspecified, at most 25 are returned. The maximum value is 100. If you use a value more than 100, it's automatically changed to 100. @@ -20394,8 +20466,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -20410,8 +20484,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21447,8 +21523,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21503,8 +21581,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21519,8 +21599,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21551,8 +21633,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21683,17 +21767,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -23479,8 +23563,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -23495,8 +23581,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -24532,8 +24620,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -24588,8 +24678,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -24604,8 +24696,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -24636,8 +24730,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -26545,8 +26641,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -26561,8 +26659,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -27598,8 +27698,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -27654,8 +27756,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -27670,8 +27774,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -27702,8 +27808,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. diff --git a/docs/dyn/chat_v1.spaces.messages.reactions.html b/docs/dyn/chat_v1.spaces.messages.reactions.html index 70e1d76513..b0014fc7b5 100644 --- a/docs/dyn/chat_v1.spaces.messages.reactions.html +++ b/docs/dyn/chat_v1.spaces.messages.reactions.html @@ -87,7 +87,7 @@

Instance Methods

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

Lists reactions to a message. For an example, see [List reactions for a message](https://developers.google.com/workspace/chat/list-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.messages.reactions.readonly` - `https://www.googleapis.com/auth/chat.messages.reactions` - `https://www.googleapis.com/auth/chat.messages.readonly` - `https://www.googleapis.com/auth/chat.messages`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,8 +120,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -152,8 +154,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -215,8 +219,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -227,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chat_v1.spaces.spaceEvents.html b/docs/dyn/chat_v1.spaces.spaceEvents.html index dc933d8118..de65d93d4e 100644 --- a/docs/dyn/chat_v1.spaces.spaceEvents.html +++ b/docs/dyn/chat_v1.spaces.spaceEvents.html @@ -84,7 +84,7 @@

Instance Methods

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

Lists events from a Google Chat space. For each event, the [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the Chat resource. For example, if you list events about new space members, the server returns `Membership` resources that contain the latest membership details. If new members were removed during the requested period, the event payload contains an empty `Membership` resource. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) with an [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes) appropriate for reading the requested data: - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.app.spaces` - `https://www.googleapis.com/auth/chat.app.spaces.readonly` - `https://www.googleapis.com/auth/chat.app.messages.readonly` - `https://www.googleapis.com/auth/chat.app.memberships` - `https://www.googleapis.com/auth/chat.app.memberships.readonly` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` - `https://www.googleapis.com/auth/chat.messages.readonly` - `https://www.googleapis.com/auth/chat.messages` - `https://www.googleapis.com/auth/chat.messages.reactions.readonly` - `https://www.googleapis.com/auth/chat.messages.reactions` - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` To list events, the authenticated caller must be a member of the space. For an example, see [List events from a Google Chat space](https://developers.google.com/workspace/chat/list-space-events).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,8 +120,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -144,8 +146,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -168,8 +172,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -190,8 +196,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -210,8 +218,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -230,8 +240,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -2018,8 +2030,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -2034,8 +2048,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3071,8 +3087,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3127,8 +3145,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3143,8 +3163,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -3175,8 +3197,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -5079,8 +5103,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -5095,8 +5121,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6132,8 +6160,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6188,8 +6218,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6204,8 +6236,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -6236,8 +6270,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -8140,8 +8176,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -8156,8 +8194,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9193,8 +9233,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9249,8 +9291,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9265,8 +9309,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -9297,8 +9343,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -11199,8 +11247,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -11215,8 +11265,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12252,8 +12304,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12308,8 +12362,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12324,8 +12380,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -12356,8 +12414,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -14256,8 +14316,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -14272,8 +14334,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15309,8 +15373,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15365,8 +15431,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15381,8 +15449,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -15413,8 +15483,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -17313,8 +17385,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -17329,8 +17403,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18366,8 +18442,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18422,8 +18500,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18438,8 +18518,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18470,8 +18552,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18615,8 +18699,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18644,8 +18730,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18671,8 +18759,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18696,8 +18786,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18963,8 +19055,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -18987,8 +19081,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -19011,8 +19107,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -19033,8 +19131,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -19053,8 +19153,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -19073,8 +19175,10 @@

Method Details

"name": "A String", # Resource name for a Google Group. Represents a [group](https://cloud.google.com/identity/docs/reference/rest/v1/groups) in Cloud Identity Groups API. Format: groups/{group} }, "member": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -20861,8 +20965,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -20877,8 +20983,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21914,8 +22022,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21970,8 +22080,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -21986,8 +22098,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -22018,8 +22132,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -23922,8 +24038,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -23938,8 +24056,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -24975,8 +25095,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -25031,8 +25153,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -25047,8 +25171,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -25079,8 +25205,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -26983,8 +27111,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -26999,8 +27129,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -28036,8 +28168,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -28092,8 +28226,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -28108,8 +28244,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -28140,8 +28278,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -30042,8 +30182,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -30058,8 +30200,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -31095,8 +31239,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -31151,8 +31297,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -31167,8 +31315,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -31199,8 +31349,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -33099,8 +33251,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -33115,8 +33269,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -34152,8 +34308,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -34208,8 +34366,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -34224,8 +34384,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -34256,8 +34418,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -36156,8 +36320,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -36172,8 +36338,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37209,8 +37377,10 @@

Method Details

}, "name": "A String", # Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message). "privateMessageViewer": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private). + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37265,8 +37435,10 @@

Method Details

}, "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command. "bot": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The Chat app whose command was invoked. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37281,8 +37453,10 @@

Method Details

"userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention. "type": "A String", # The type of user mention. "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # The user mentioned. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37313,8 +37487,10 @@

Method Details

}, }, "sender": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type` fields for both internal and external users, unless they are members of the space or have a prior affinity, like a direct message (DM) conversation, with the calling user. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37458,8 +37634,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37487,8 +37665,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37514,8 +37694,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37539,8 +37721,10 @@

Method Details

}, "name": "A String", # Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` "user": { # If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user. # Output only. The user who created the reaction. + "avatarUrl": "A String", # Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "displayName": "A String", # Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "domainId": "A String", # Unique identifier of the user's Google Workspace domain. + "email": "A String", # Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user. "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user. "name": "A String", # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API. "type": "A String", # User type. @@ -37775,17 +37959,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chat_v1.users.sections.html b/docs/dyn/chat_v1.users.sections.html index c45ed8b81c..485538f972 100644 --- a/docs/dyn/chat_v1.users.sections.html +++ b/docs/dyn/chat_v1.users.sections.html @@ -92,7 +92,7 @@

Instance Methods

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

Lists sections available to the Chat user. Sections help users group their conversations and customize the list of spaces displayed in Chat navigation panel. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections` - `https://www.googleapis.com/auth/chat.users.sections.readonly`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

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

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/chat_v1.users.sections.items.html b/docs/dyn/chat_v1.users.sections.items.html index 7849fec312..1542886c27 100644 --- a/docs/dyn/chat_v1.users.sections.items.html +++ b/docs/dyn/chat_v1.users.sections.items.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists items in a section. Only spaces can be section items. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections` - `https://www.googleapis.com/auth/chat.users.sections.readonly`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/checks_v1alpha.accounts.apps.html b/docs/dyn/checks_v1alpha.accounts.apps.html index 6618a24fd3..d818a08309 100644 --- a/docs/dyn/checks_v1alpha.accounts.apps.html +++ b/docs/dyn/checks_v1alpha.accounts.apps.html @@ -94,7 +94,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the apps under the given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/checks_v1alpha.accounts.apps.operations.html b/docs/dyn/checks_v1alpha.accounts.apps.operations.html index 367960b044..a3a6b866fa 100644 --- a/docs/dyn/checks_v1alpha.accounts.apps.operations.html +++ b/docs/dyn/checks_v1alpha.accounts.apps.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/checks_v1alpha.accounts.apps.reports.html b/docs/dyn/checks_v1alpha.accounts.apps.reports.html index d18ff03ef5..53cde5cfa1 100644 --- a/docs/dyn/checks_v1alpha.accounts.apps.reports.html +++ b/docs/dyn/checks_v1alpha.accounts.apps.reports.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, checksFilter=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists reports for the specified app. By default, only the name and results_uri fields are returned. You can include other fields by listing them in the `fields` URL query parameter. For example, `?fields=reports(name,checks)` will return the name and checks fields.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -635,17 +635,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/checks_v1alpha.accounts.repos.scans.html b/docs/dyn/checks_v1alpha.accounts.repos.scans.html index 4b47e6d645..75eda3055e 100644 --- a/docs/dyn/checks_v1alpha.accounts.repos.scans.html +++ b/docs/dyn/checks_v1alpha.accounts.repos.scans.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists repo scans for the specified repo.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -272,17 +272,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/checks_v1alpha.html b/docs/dyn/checks_v1alpha.html index 02a2d499a6..5a5cbad0a3 100644 --- a/docs/dyn/checks_v1alpha.html +++ b/docs/dyn/checks_v1alpha.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromemanagement_v1.customers.apps.html b/docs/dyn/chromemanagement_v1.customers.apps.html index 7e21b7aaa9..c116650aa0 100644 --- a/docs/dyn/chromemanagement_v1.customers.apps.html +++ b/docs/dyn/chromemanagement_v1.customers.apps.html @@ -96,19 +96,19 @@

Instance Methods

countChromeAppRequests(customer, orderBy=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate summary of app installation requests.

- countChromeAppRequests_next(previous_request, previous_response)

+ countChromeAppRequests_next()

Retrieves the next page of results.

fetchDevicesRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of devices that have requested to install an extension.

- fetchDevicesRequestingExtension_next(previous_request, previous_response)

+ fetchDevicesRequestingExtension_next()

Retrieves the next page of results.

fetchUsersRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of users that have requested to install an extension.

- fetchUsersRequestingExtension_next(previous_request, previous_response)

+ fetchUsersRequestingExtension_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- countChromeAppRequests_next(previous_request, previous_response) + countChromeAppRequests_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)
+        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.
-
+ 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. +
@@ -196,17 +196,17 @@

Method Details

- fetchDevicesRequestingExtension_next(previous_request, previous_response) + fetchDevicesRequestingExtension_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)
+        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.
-
+ 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. +
@@ -240,17 +240,17 @@

Method Details

- fetchUsersRequestingExtension_next(previous_request, previous_response) + fetchUsersRequestingExtension_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)
+        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.
-
+ 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/chromemanagement_v1.customers.connectorConfigs.html b/docs/dyn/chromemanagement_v1.customers.connectorConfigs.html index 27ffd3a5ac..a2f98bf366 100644 --- a/docs/dyn/chromemanagement_v1.customers.connectorConfigs.html +++ b/docs/dyn/chromemanagement_v1.customers.connectorConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists connector configs of a customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -736,17 +736,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/chromemanagement_v1.customers.enterprise.securityInsights.html b/docs/dyn/chromemanagement_v1.customers.enterprise.securityInsights.html index c99bcd16cc..4385785301 100644 --- a/docs/dyn/chromemanagement_v1.customers.enterprise.securityInsights.html +++ b/docs/dyn/chromemanagement_v1.customers.enterprise.securityInsights.html @@ -93,7 +93,7 @@

Instance Methods

queryContentTransfersBreakdowns(customer, breakdown=None, filter=None, fixedTimeRange=None, metric=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns summaries of content transfers for a given metric and breakdown dimension.

- queryContentTransfersBreakdowns_next(previous_request, previous_response)

+ queryContentTransfersBreakdowns_next()

Retrieves the next page of results.

queryUrlVisits(customer, filter=None, x__xgafv=None)

@@ -102,7 +102,7 @@

Instance Methods

queryUrlVisitsBreakdowns(customer, breakdown=None, filter=None, fixedTimeRange=None, metric=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns summaries of URL visits for a given metric and breakdown dimension. Requires a Chrome Enterprise Premium subscription. If the customer does not have this subscription, query results will be empty.

- queryUrlVisitsBreakdowns_next(previous_request, previous_response)

+ queryUrlVisitsBreakdowns_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- queryContentTransfersBreakdowns_next(previous_request, previous_response) + queryContentTransfersBreakdowns_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)
+        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.
-
+ 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. +
@@ -355,17 +355,17 @@

Method Details

- queryUrlVisitsBreakdowns_next(previous_request, previous_response) + queryUrlVisitsBreakdowns_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)
+        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.
-
+ 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/chromemanagement_v1.customers.profiles.commands.html b/docs/dyn/chromemanagement_v1.customers.profiles.commands.html index 2044ac9fc4..0dd2537c2a 100644 --- a/docs/dyn/chromemanagement_v1.customers.profiles.commands.html +++ b/docs/dyn/chromemanagement_v1.customers.profiles.commands.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists remote commands of a Chrome browser profile.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.customers.profiles.html b/docs/dyn/chromemanagement_v1.customers.profiles.html index a487231965..5d47159579 100644 --- a/docs/dyn/chromemanagement_v1.customers.profiles.html +++ b/docs/dyn/chromemanagement_v1.customers.profiles.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Chrome browser profiles of a customer based on the given search and sorting criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.customers.reports.html b/docs/dyn/chromemanagement_v1.customers.reports.html index 38d63b3b87..66114b9cdc 100644 --- a/docs/dyn/chromemanagement_v1.customers.reports.html +++ b/docs/dyn/chromemanagement_v1.customers.reports.html @@ -99,13 +99,13 @@

Instance Methods

countChromeProfileVersions(customer, filter=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate report of installed Chrome versions on managed profiles.

- countChromeProfileVersions_next(previous_request, previous_response)

+ countChromeProfileVersions_next()

Retrieves the next page of results.

countChromeVersions(customer, filter=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate report of installed Chrome versions.

- countChromeVersions_next(previous_request, previous_response)

+ countChromeVersions_next()

Retrieves the next page of results.

countDevicesPerBootType(customer, date_day=None, date_month=None, date_year=None, x__xgafv=None)

@@ -117,37 +117,37 @@

Instance Methods

countInstalledApps(customer, filter=None, orderBy=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate report of app installations.

- countInstalledApps_next(previous_request, previous_response)

+ countInstalledApps_next()

Retrieves the next page of results.

countPrintJobsByPrinter(customer, filter=None, orderBy=None, pageSize=None, pageToken=None, printerOrgUnitId=None, x__xgafv=None)

Get a summary of printing done by each printer.

- countPrintJobsByPrinter_next(previous_request, previous_response)

+ countPrintJobsByPrinter_next()

Retrieves the next page of results.

countPrintJobsByUser(customer, filter=None, orderBy=None, pageSize=None, pageToken=None, printerOrgUnitId=None, x__xgafv=None)

Get a summary of printing done by each user.

- countPrintJobsByUser_next(previous_request, previous_response)

+ countPrintJobsByUser_next()

Retrieves the next page of results.

enumeratePrintJobs(customer, filter=None, orderBy=None, pageSize=None, pageToken=None, printerOrgUnitId=None, x__xgafv=None)

Get a list of print jobs.

- enumeratePrintJobs_next(previous_request, previous_response)

+ enumeratePrintJobs_next()

Retrieves the next page of results.

findInstalledAppDevices(customer, appId=None, appType=None, filter=None, orderBy=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate report of managed Chrome browser devices that have a specified app installed.

- findInstalledAppDevices_next(previous_request, previous_response)

+ findInstalledAppDevices_next()

Retrieves the next page of results.

findInstalledAppProfiles(customer, appId=None, appType=None, filter=None, orderBy=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

Generate report of managed Chrome profiles that have a specified app installed.

- findInstalledAppProfiles_next(previous_request, previous_response)

+ findInstalledAppProfiles_next()

Retrieves the next page of results.

findSaasUsage(customer, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

@@ -156,16 +156,16 @@

Instance Methods

findSaasUsageBrowsers(customer, app=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Find SaaS usage reports of a customer grouped by browsers based on the given search and sorting criteria.

- findSaasUsageBrowsers_next(previous_request, previous_response)

+ findSaasUsageBrowsers_next()

Retrieves the next page of results.

findSaasUsageProfiles(customer, app=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Find SaaS usage reports of a customer grouped by profiles based on the given search and sorting criteria.

- findSaasUsageProfiles_next(previous_request, previous_response)

+ findSaasUsageProfiles_next()

Retrieves the next page of results.

- findSaasUsage_next(previous_request, previous_response)

+ findSaasUsage_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- countChromeProfileVersions_next(previous_request, previous_response) + countChromeProfileVersions_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)
+        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.
-
+ 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. +
@@ -430,17 +430,17 @@

Method Details

- countChromeVersions_next(previous_request, previous_response) + countChromeVersions_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)
+        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.
-
+ 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. +
@@ -554,17 +554,17 @@

Method Details

- countInstalledApps_next(previous_request, previous_response) + countInstalledApps_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)
+        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.
-
+ 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. +
@@ -603,17 +603,17 @@

Method Details

- countPrintJobsByPrinter_next(previous_request, previous_response) + countPrintJobsByPrinter_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)
+        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.
-
+ 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. +
@@ -651,17 +651,17 @@

Method Details

- countPrintJobsByUser_next(previous_request, previous_response) + countPrintJobsByUser_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)
+        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.
-
+ 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. +
@@ -707,17 +707,17 @@

Method Details

- enumeratePrintJobs_next(previous_request, previous_response) + enumeratePrintJobs_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)
+        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.
-
+ 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. +
@@ -761,17 +761,17 @@

Method Details

- findInstalledAppDevices_next(previous_request, previous_response) + findInstalledAppDevices_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)
+        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.
-
+ 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. +
@@ -817,17 +817,17 @@

Method Details

- findInstalledAppProfiles_next(previous_request, previous_response) + findInstalledAppProfiles_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)
+        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.
-
+ 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. +
@@ -916,17 +916,17 @@

Method Details

- findSaasUsageBrowsers_next(previous_request, previous_response) + findSaasUsageBrowsers_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)
+        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.
-
+ 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. +
@@ -966,31 +966,31 @@

Method Details

- findSaasUsageProfiles_next(previous_request, previous_response) + findSaasUsageProfiles_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)
+        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.
-
+ 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. +
- findSaasUsage_next(previous_request, previous_response) + findSaasUsage_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)
+        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.
-
+ 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/chromemanagement_v1.customers.telemetry.devices.html b/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html index 45f3f384a6..b82c758ac4 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

List all telemetry devices.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -747,17 +747,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.customers.telemetry.events.html b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html index 07eb61b24a..48eff48cb1 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.events.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

List telemetry events.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.customers.telemetry.notificationConfigs.html b/docs/dyn/chromemanagement_v1.customers.telemetry.notificationConfigs.html index 93cd4f29d1..66b3c67013 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.notificationConfigs.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.notificationConfigs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all telemetry notification configs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.customers.telemetry.users.html b/docs/dyn/chromemanagement_v1.customers.telemetry.users.html index 26cd7b7b5a..cb18664855 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.users.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.users.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

List all telemetry users.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromemanagement_v1.html b/docs/dyn/chromemanagement_v1.html index ee1c863d64..24033e3936 100644 --- a/docs/dyn/chromemanagement_v1.html +++ b/docs/dyn/chromemanagement_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromemanagement_v1.operations.html b/docs/dyn/chromemanagement_v1.operations.html index 44d6d37a8a..e7fd6b11b3 100644 --- a/docs/dyn/chromemanagement_v1.operations.html +++ b/docs/dyn/chromemanagement_v1.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromepolicy_v1.customers.policies.html b/docs/dyn/chromepolicy_v1.customers.policies.html index 7dd62958cf..c680f943f5 100644 --- a/docs/dyn/chromepolicy_v1.customers.policies.html +++ b/docs/dyn/chromepolicy_v1.customers.policies.html @@ -96,7 +96,7 @@

Instance Methods

resolve(customer, body=None, x__xgafv=None)

Gets the resolved policy values for a list of policies that match a search query.

- resolve_next(previous_request, previous_response)

+ resolve_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- resolve_next(previous_request, previous_response) + resolve_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)
+        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.
-
+ 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/chromepolicy_v1.customers.policySchemas.html b/docs/dyn/chromepolicy_v1.customers.policySchemas.html index d2ddc199df..6b48993a7d 100644 --- a/docs/dyn/chromepolicy_v1.customers.policySchemas.html +++ b/docs/dyn/chromepolicy_v1.customers.policySchemas.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of policy schemas that match a specified filter value for a given customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -449,17 +449,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/chromepolicy_v1.html b/docs/dyn/chromepolicy_v1.html index 056d0dab0d..f589f50aae 100644 --- a/docs/dyn/chromepolicy_v1.html +++ b/docs/dyn/chromepolicy_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromeuxreport_v1.html b/docs/dyn/chromeuxreport_v1.html index 1c15afad38..5554de9883 100644 --- a/docs/dyn/chromeuxreport_v1.html +++ b/docs/dyn/chromeuxreport_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromewebstore_v1_1.html b/docs/dyn/chromewebstore_v1_1.html index 273e12e407..64c1f2b80b 100644 --- a/docs/dyn/chromewebstore_v1_1.html +++ b/docs/dyn/chromewebstore_v1_1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromewebstore_v2.html b/docs/dyn/chromewebstore_v2.html index e1e3e6f65a..3fde03a33a 100644 --- a/docs/dyn/chromewebstore_v2.html +++ b/docs/dyn/chromewebstore_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/chromewebstore_v2.publishers.items.html b/docs/dyn/chromewebstore_v2.publishers.items.html index 5da48a83bb..d2777a87c0 100644 --- a/docs/dyn/chromewebstore_v2.publishers.items.html +++ b/docs/dyn/chromewebstore_v2.publishers.items.html @@ -84,7 +84,7 @@

Instance Methods

fetchReviews(name, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetch user reviews for an item.

- fetchReviews_next(previous_request, previous_response)

+ fetchReviews_next()

Retrieves the next page of results.

fetchStatus(name, x__xgafv=None)

@@ -161,17 +161,17 @@

Method Details

- fetchReviews_next(previous_request, previous_response) + fetchReviews_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/civicinfo_v2.html b/docs/dyn/civicinfo_v2.html index a484d3fb05..d288784c35 100644 --- a/docs/dyn/civicinfo_v2.html +++ b/docs/dyn/civicinfo_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/classroom_v1.courses.aliases.html b/docs/dyn/classroom_v1.courses.aliases.html index 4fb06317fa..f6f014b568 100644 --- a/docs/dyn/classroom_v1.courses.aliases.html +++ b/docs/dyn/classroom_v1.courses.aliases.html @@ -87,7 +87,7 @@

Instance Methods

list(courseId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of aliases for a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the course or for access errors. * `NOT_FOUND` if the course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/classroom_v1.courses.announcements.addOnAttachments.html b/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html index 1a1b715753..5d2f3b5c17 100644 --- a/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html +++ b/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, itemId, pageSize=None, pageToken=None, postId=None, x__xgafv=None)

Returns all attachments created by an add-on under the post. Requires the add-on to have active attachments on the post or have permission to create new attachments on the post. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if one of the identified resources does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, itemId, attachmentId, body=None, postId=None, updateMask=None, x__xgafv=None)

@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.announcements.html b/docs/dyn/classroom_v1.courses.announcements.html index caec38e375..04718ba161 100644 --- a/docs/dyn/classroom_v1.courses.announcements.html +++ b/docs/dyn/classroom_v1.courses.announcements.html @@ -98,7 +98,7 @@

Instance Methods

list(courseId, announcementStates=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of announcements that the requester is permitted to view. Course students may only view `PUBLISHED` announcements. Course teachers and domain administrators may view all announcements. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAssignees(courseId, id, body=None, x__xgafv=None)

@@ -458,17 +458,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html index 15c7759b4f..36395e623c 100644 --- a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html +++ b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html @@ -95,7 +95,7 @@

Instance Methods

list(courseId, itemId, pageSize=None, pageToken=None, postId=None, x__xgafv=None)

Returns all attachments created by an add-on under the post. Requires the add-on to have active attachments on the post or have permission to create new attachments on the post. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if one of the identified resources does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, itemId, attachmentId, body=None, postId=None, updateMask=None, x__xgafv=None)

@@ -339,17 +339,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWork.html b/docs/dyn/classroom_v1.courses.courseWork.html index 335b64afef..1de52daaf1 100644 --- a/docs/dyn/classroom_v1.courses.courseWork.html +++ b/docs/dyn/classroom_v1.courses.courseWork.html @@ -108,7 +108,7 @@

Instance Methods

list(courseId, courseWorkStates=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of course work that the requester is permitted to view. Course students may only view `PUBLISHED` course work. Course teachers and domain administrators may view all course work. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAssignees(courseId, id, body=None, x__xgafv=None)

@@ -615,17 +615,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWork.rubrics.html b/docs/dyn/classroom_v1.courses.courseWork.rubrics.html index 954792bc09..8a3541f7b9 100644 --- a/docs/dyn/classroom_v1.courses.courseWork.rubrics.html +++ b/docs/dyn/classroom_v1.courses.courseWork.rubrics.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, courseWorkId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of rubrics that the requester is permitted to view. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course or course work doesn't exist or if the user doesn't have access to the corresponding course work.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, courseWorkId, id, body=None, updateMask=None, x__xgafv=None)

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWork.studentSubmissions.html b/docs/dyn/classroom_v1.courses.courseWork.studentSubmissions.html index a35d3c290d..139da06fe4 100644 --- a/docs/dyn/classroom_v1.courses.courseWork.studentSubmissions.html +++ b/docs/dyn/classroom_v1.courses.courseWork.studentSubmissions.html @@ -84,7 +84,7 @@

Instance Methods

list(courseId, courseWorkId, late=None, pageSize=None, pageToken=None, states=None, userId=None, x__xgafv=None)

Returns a list of student submissions that the requester is permitted to view, factoring in the OAuth scopes of the request. A hyphen (`-`) may be specified as the `course_work_id` to include student submissions for multiple course work items. Course students may only view their own work. Course teachers and domain administrators may view all student submissions. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAttachments(courseId, courseWorkId, id, body=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html b/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html index 2e66239c6f..a536b3da7d 100644 --- a/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html +++ b/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, itemId, pageSize=None, pageToken=None, postId=None, x__xgafv=None)

Returns all attachments created by an add-on under the post. Requires the add-on to have active attachments on the post or have permission to create new attachments on the post. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if one of the identified resources does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, itemId, attachmentId, body=None, postId=None, updateMask=None, x__xgafv=None)

@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.courseWorkMaterials.html b/docs/dyn/classroom_v1.courses.courseWorkMaterials.html index 48ee6ddda8..40c130a2bd 100644 --- a/docs/dyn/classroom_v1.courses.courseWorkMaterials.html +++ b/docs/dyn/classroom_v1.courses.courseWorkMaterials.html @@ -98,7 +98,7 @@

Instance Methods

list(courseId, courseWorkMaterialStates=None, materialDriveId=None, materialLink=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of course work material that the requester is permitted to view. Course students may only view `PUBLISHED` course work material. Course teachers and domain administrators may view all course work material. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, id, body=None, updateMask=None, x__xgafv=None)

@@ -465,17 +465,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.html b/docs/dyn/classroom_v1.courses.html index 744120b31f..26c1824921 100644 --- a/docs/dyn/classroom_v1.courses.html +++ b/docs/dyn/classroom_v1.courses.html @@ -138,7 +138,7 @@

Instance Methods

list(courseStates=None, pageSize=None, pageToken=None, studentId=None, teacherId=None, x__xgafv=None)

Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request. Returned courses are ordered by creation time, with the most recently created coming first. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the query argument is malformed. * `NOT_FOUND` if any users specified in the query arguments do not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(id, body=None, updateMask=None, x__xgafv=None)

@@ -552,17 +552,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html index e6bc393c57..2f7e3aa269 100644 --- a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html +++ b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html @@ -95,7 +95,7 @@

Instance Methods

list(courseId, postId, itemId=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns all attachments created by an add-on under the post. Requires the add-on to have active attachments on the post or have permission to create new attachments on the post. This method returns the following error codes: * `PERMISSION_DENIED` for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if one of the identified resources does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, postId, attachmentId, body=None, itemId=None, updateMask=None, x__xgafv=None)

@@ -339,17 +339,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.studentGroups.html b/docs/dyn/classroom_v1.courses.studentGroups.html index a4e0549b20..d7a7c8fbb8 100644 --- a/docs/dyn/classroom_v1.courses.studentGroups.html +++ b/docs/dyn/classroom_v1.courses.studentGroups.html @@ -92,7 +92,7 @@

Instance Methods

list(courseId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of groups in a course. This method returns the following error codes: * `NOT_FOUND` if the course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, id, body=None, updateMask=None, x__xgafv=None)

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.courses.studentGroups.studentGroupMembers.html b/docs/dyn/classroom_v1.courses.studentGroups.studentGroupMembers.html index c1d60c9fb8..fdbefbd928 100644 --- a/docs/dyn/classroom_v1.courses.studentGroups.studentGroupMembers.html +++ b/docs/dyn/classroom_v1.courses.studentGroups.studentGroupMembers.html @@ -87,7 +87,7 @@

Instance Methods

list(courseId, studentGroupId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of students in a group. This method returns the following error codes: * `NOT_FOUND` if the course or student group does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/classroom_v1.courses.students.html b/docs/dyn/classroom_v1.courses.students.html index f57f628985..1212b4ecef 100644 --- a/docs/dyn/classroom_v1.courses.students.html +++ b/docs/dyn/classroom_v1.courses.students.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of students of this course that the requester is permitted to view. This method returns the following error codes: * `NOT_FOUND` if the course does not exist. * `PERMISSION_DENIED` for access errors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/classroom_v1.courses.teachers.html b/docs/dyn/classroom_v1.courses.teachers.html index 0d4888d066..9f1ac8254b 100644 --- a/docs/dyn/classroom_v1.courses.teachers.html +++ b/docs/dyn/classroom_v1.courses.teachers.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of teachers of this course that the requester is permitted to view. This method returns the following error codes: * `NOT_FOUND` if the course does not exist. * `PERMISSION_DENIED` for access errors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/classroom_v1.courses.topics.html b/docs/dyn/classroom_v1.courses.topics.html index 8894c3d6c7..65c7530cf7 100644 --- a/docs/dyn/classroom_v1.courses.topics.html +++ b/docs/dyn/classroom_v1.courses.topics.html @@ -90,7 +90,7 @@

Instance Methods

list(courseId, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of topics that the requester is permitted to view. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(courseId, id, body=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.html b/docs/dyn/classroom_v1.html index 990ecf5105..1a72f0a586 100644 --- a/docs/dyn/classroom_v1.html +++ b/docs/dyn/classroom_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/classroom_v1.invitations.html b/docs/dyn/classroom_v1.invitations.html index 1b5550e1eb..d21b04f3d6 100644 --- a/docs/dyn/classroom_v1.invitations.html +++ b/docs/dyn/classroom_v1.invitations.html @@ -93,7 +93,7 @@

Instance Methods

list(courseId=None, pageSize=None, pageToken=None, userId=None, x__xgafv=None)

Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. *Note:* At least one of `user_id` or `course_id` must be supplied. Both fields can be supplied. This method returns the following error codes: * `PERMISSION_DENIED` for access errors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/classroom_v1.userProfiles.guardianInvitations.html b/docs/dyn/classroom_v1.userProfiles.guardianInvitations.html index 549907c367..6b94d03698 100644 --- a/docs/dyn/classroom_v1.userProfiles.guardianInvitations.html +++ b/docs/dyn/classroom_v1.userProfiles.guardianInvitations.html @@ -87,7 +87,7 @@

Instance Methods

list(studentId, invitedEmailAddress=None, pageSize=None, pageToken=None, states=None, x__xgafv=None)

Returns a list of guardian invitations that the requesting user is permitted to view, filtered by the parameters provided. This method returns the following error codes: * `PERMISSION_DENIED` if a `student_id` is specified, and the requesting user is not permitted to view guardian invitations for that student, if `"-"` is specified as the `student_id` and the user is not a domain administrator, if guardians are not enabled for the domain in question, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API, nor the literal string `me`). May also be returned if an invalid `page_token` or `state` is provided. * `NOT_FOUND` if a `student_id` is specified, and its format can be recognized, but Classroom has no record of that student.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(studentId, invitationId, body=None, updateMask=None, x__xgafv=None)

@@ -193,17 +193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/classroom_v1.userProfiles.guardians.html b/docs/dyn/classroom_v1.userProfiles.guardians.html index 75a0e105a5..2019a15f05 100644 --- a/docs/dyn/classroom_v1.userProfiles.guardians.html +++ b/docs/dyn/classroom_v1.userProfiles.guardians.html @@ -87,7 +87,7 @@

Instance Methods

list(studentId, invitedEmailAddress=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of guardians that the requesting user is permitted to view, restricted to those that match the request. To list guardians for any student that the requesting user may view guardians for, use the literal character `-` for the student ID. This method returns the following error codes: * `PERMISSION_DENIED` if a `student_id` is specified, and the requesting user is not permitted to view guardian information for that student, if `"-"` is specified as the `student_id` and the user is not a domain administrator, if guardians are not enabled for the domain in question, if the `invited_email_address` filter is set by a user who is not a domain administrator, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API, nor the literal string `me`). May also be returned if an invalid `page_token` is provided. * `NOT_FOUND` if a `student_id` is specified, and its format can be recognized, but Classroom has no record of that student.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -198,17 +198,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudasset_v1.assets.html b/docs/dyn/cloudasset_v1.assets.html index 48aca8aa1f..e1419d6728 100644 --- a/docs/dyn/cloudasset_v1.assets.html +++ b/docs/dyn/cloudasset_v1.assets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, assetTypes=None, contentType=None, pageSize=None, pageToken=None, readTime=None, relationshipTypes=None, x__xgafv=None)

Lists assets with time and resource types and returns paged results in response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -705,17 +705,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudasset_v1.html b/docs/dyn/cloudasset_v1.html index 6ee9897ca1..fb90e9a25f 100644 --- a/docs/dyn/cloudasset_v1.html +++ b/docs/dyn/cloudasset_v1.html @@ -108,7 +108,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -117,20 +117,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudasset_v1.savedQueries.html b/docs/dyn/cloudasset_v1.savedQueries.html index 179f5f4f33..44654e87fe 100644 --- a/docs/dyn/cloudasset_v1.savedQueries.html +++ b/docs/dyn/cloudasset_v1.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all saved queries in a parent project/folder/organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudasset_v1.v1.html b/docs/dyn/cloudasset_v1.v1.html index 58fa21616c..ba4daffb38 100644 --- a/docs/dyn/cloudasset_v1.v1.html +++ b/docs/dyn/cloudasset_v1.v1.html @@ -87,19 +87,19 @@

Instance Methods

analyzeOrgPolicies(scope, constraint=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Analyzes organization policies under a scope.

- analyzeOrgPolicies_next(previous_request, previous_response)

+ analyzeOrgPolicies_next()

Retrieves the next page of results.

analyzeOrgPolicyGovernedAssets(scope, constraint=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Analyzes organization policies governed assets (Google Cloud resources or policies) under a scope. This RPC supports custom constraints and the following canned constraints: * constraints/ainotebooks.accessMode * constraints/ainotebooks.disableFileDownloads * constraints/ainotebooks.disableRootAccess * constraints/ainotebooks.disableTerminal * constraints/ainotebooks.environmentOptions * constraints/ainotebooks.requireAutoUpgradeSchedule * constraints/ainotebooks.restrictVpcNetworks * constraints/compute.disableGuestAttributesAccess * constraints/compute.disableInstanceDataAccessApis * constraints/compute.disableNestedVirtualization * constraints/compute.disableSerialPortAccess * constraints/compute.disableSerialPortLogging * constraints/compute.disableVpcExternalIpv6 * constraints/compute.requireOsLogin * constraints/compute.requireShieldedVm * constraints/compute.restrictLoadBalancerCreationForTypes * constraints/compute.restrictProtocolForwardingCreationForTypes * constraints/compute.restrictXpnProjectLienRemoval * constraints/compute.setNewProjectDefaultToZonalDNSOnly * constraints/compute.skipDefaultNetworkCreation * constraints/compute.trustedImageProjects * constraints/compute.vmCanIpForward * constraints/compute.vmExternalIpAccess * constraints/gcp.detailedAuditLoggingMode * constraints/gcp.resourceLocations * constraints/iam.allowedPolicyMemberDomains * constraints/iam.automaticIamGrantsForDefaultServiceAccounts * constraints/iam.disableServiceAccountCreation * constraints/iam.disableServiceAccountKeyCreation * constraints/iam.disableServiceAccountKeyUpload * constraints/iam.restrictCrossProjectServiceAccountLienRemoval * constraints/iam.serviceAccountKeyExpiryHours * constraints/resourcemanager.accessBoundaries * constraints/resourcemanager.allowedExportDestinations * constraints/sql.restrictAuthorizedNetworks * constraints/sql.restrictNoncompliantDiagnosticDataAccess * constraints/sql.restrictNoncompliantResourceCreation * constraints/sql.restrictPublicIp * constraints/storage.publicAccessPrevention * constraints/storage.restrictAuthTypes * constraints/storage.uniformBucketLevelAccess This RPC only returns either resources of types [supported by search APIs](https://cloud.google.com/asset-inventory/docs/supported-asset-types) or IAM policies.

- analyzeOrgPolicyGovernedAssets_next(previous_request, previous_response)

+ analyzeOrgPolicyGovernedAssets_next()

Retrieves the next page of results.

analyzeOrgPolicyGovernedContainers(scope, constraint=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Analyzes organization policies governed containers (projects, folders or organization) under a scope.

- analyzeOrgPolicyGovernedContainers_next(previous_request, previous_response)

+ analyzeOrgPolicyGovernedContainers_next()

Retrieves the next page of results.

batchGetAssetsHistory(parent, assetNames=None, contentType=None, readTimeWindow_endTime=None, readTimeWindow_startTime=None, relationshipTypes=None, x__xgafv=None)

@@ -117,13 +117,13 @@

Instance Methods

searchAllIamPolicies(scope, assetTypes=None, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches all IAM policies within the specified scope, such as a project, folder, or organization. The caller must be granted the `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, otherwise the request will be rejected.

- searchAllIamPolicies_next(previous_request, previous_response)

+ searchAllIamPolicies_next()

Retrieves the next page of results.

searchAllResources(scope, assetTypes=None, orderBy=None, pageSize=None, pageToken=None, query=None, readMask=None, x__xgafv=None)

Searches all Google Cloud resources within the specified scope, such as a project, folder, or organization. The caller must be granted the `cloudasset.assets.searchAllResources` permission on the desired scope, otherwise the request will be rejected.

- searchAllResources_next(previous_request, previous_response)

+ searchAllResources_next()

Retrieves the next page of results.

Method Details

@@ -621,17 +621,17 @@

Method Details

- analyzeOrgPolicies_next(previous_request, previous_response) + analyzeOrgPolicies_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)
+        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.
-
+ 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. +
@@ -814,17 +814,17 @@

Method Details

- analyzeOrgPolicyGovernedAssets_next(previous_request, previous_response) + analyzeOrgPolicyGovernedAssets_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)
+        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.
-
+ 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. +
@@ -964,17 +964,17 @@

Method Details

- analyzeOrgPolicyGovernedContainers_next(previous_request, previous_response) + analyzeOrgPolicyGovernedContainers_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)
+        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.
-
+ 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. +
@@ -2401,17 +2401,17 @@

Method Details

- searchAllIamPolicies_next(previous_request, previous_response) + searchAllIamPolicies_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)
+        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.
-
+ 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. +
@@ -2557,17 +2557,17 @@

Method Details

- searchAllResources_next(previous_request, previous_response) + searchAllResources_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)
+        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.
-
+ 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/cloudasset_v1beta1.html b/docs/dyn/cloudasset_v1beta1.html index 2b744c90e6..a1df6c909d 100644 --- a/docs/dyn/cloudasset_v1beta1.html +++ b/docs/dyn/cloudasset_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudasset_v1p1beta1.html b/docs/dyn/cloudasset_v1p1beta1.html index de17540f27..1ebeb04c36 100644 --- a/docs/dyn/cloudasset_v1p1beta1.html +++ b/docs/dyn/cloudasset_v1p1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudasset_v1p1beta1.iamPolicies.html b/docs/dyn/cloudasset_v1p1beta1.iamPolicies.html index de4f7f7e27..3d1b14d769 100644 --- a/docs/dyn/cloudasset_v1p1beta1.iamPolicies.html +++ b/docs/dyn/cloudasset_v1p1beta1.iamPolicies.html @@ -81,7 +81,7 @@

Instance Methods

searchAll(scope, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches all the IAM policies within a given accessible Resource Manager scope (project/folder/organization). This RPC gives callers especially administrators the ability to search all the IAM policies within a scope, even if they don't have `.getIamPolicy` permission of all the IAM policies. Callers should have `cloudasset.assets.searchAllIamPolicies` permission on the requested scope, otherwise the request will be rejected.

- searchAll_next(previous_request, previous_response)

+ searchAll_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- searchAll_next(previous_request, previous_response) + searchAll_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)
+        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.
-
+ 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/cloudasset_v1p1beta1.resources.html b/docs/dyn/cloudasset_v1p1beta1.resources.html index 0037513886..671722dc71 100644 --- a/docs/dyn/cloudasset_v1p1beta1.resources.html +++ b/docs/dyn/cloudasset_v1p1beta1.resources.html @@ -81,7 +81,7 @@

Instance Methods

searchAll(scope, assetTypes=None, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches all the resources within a given accessible Resource Manager scope (project/folder/organization). This RPC gives callers especially administrators the ability to search all the resources within a scope, even if they don't have `.get` permission of all the resources. Callers should have `cloudasset.assets.searchAllResources` permission on the requested scope, otherwise the request will be rejected.

- searchAll_next(previous_request, previous_response)

+ searchAll_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- searchAll_next(previous_request, previous_response) + searchAll_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)
+        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.
-
+ 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/cloudasset_v1p5beta1.assets.html b/docs/dyn/cloudasset_v1p5beta1.assets.html index d74ac7e108..086d37ca02 100644 --- a/docs/dyn/cloudasset_v1p5beta1.assets.html +++ b/docs/dyn/cloudasset_v1p5beta1.assets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, assetTypes=None, contentType=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

Lists assets with time and resource types and returns paged results in response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -505,17 +505,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudasset_v1p5beta1.html b/docs/dyn/cloudasset_v1p5beta1.html index 9ea5da0ac3..cb3ac8dbd2 100644 --- a/docs/dyn/cloudasset_v1p5beta1.html +++ b/docs/dyn/cloudasset_v1p5beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudasset_v1p7beta1.html b/docs/dyn/cloudasset_v1p7beta1.html index 0672a6f4a4..82e0473bf8 100644 --- a/docs/dyn/cloudasset_v1p7beta1.html +++ b/docs/dyn/cloudasset_v1p7beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudbilling_v1.billingAccounts.html b/docs/dyn/cloudbilling_v1.billingAccounts.html index 6701a3459d..a9c2fc3d3c 100644 --- a/docs/dyn/cloudbilling_v1.billingAccounts.html +++ b/docs/dyn/cloudbilling_v1.billingAccounts.html @@ -100,7 +100,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbilling_v1.billingAccounts.projects.html b/docs/dyn/cloudbilling_v1.billingAccounts.projects.html index 75de07a479..682766d603 100644 --- a/docs/dyn/cloudbilling_v1.billingAccounts.projects.html +++ b/docs/dyn/cloudbilling_v1.billingAccounts.projects.html @@ -81,7 +81,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists the projects associated with a billing account. The current authenticated user must have the `billing.resourceAssociations.list` IAM permission, which is often given to billing account [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1.billingAccounts.subAccounts.html b/docs/dyn/cloudbilling_v1.billingAccounts.subAccounts.html index fcf96f39e4..f2792d5482 100644 --- a/docs/dyn/cloudbilling_v1.billingAccounts.subAccounts.html +++ b/docs/dyn/cloudbilling_v1.billingAccounts.subAccounts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1.html b/docs/dyn/cloudbilling_v1.html index 33b79ffa1f..b595089e05 100644 --- a/docs/dyn/cloudbilling_v1.html +++ b/docs/dyn/cloudbilling_v1.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudbilling_v1.organizations.billingAccounts.html b/docs/dyn/cloudbilling_v1.organizations.billingAccounts.html index fddb97662a..2e390bfb2e 100644 --- a/docs/dyn/cloudbilling_v1.organizations.billingAccounts.html +++ b/docs/dyn/cloudbilling_v1.organizations.billingAccounts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(destinationParent, name, x__xgafv=None)

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbilling_v1.services.html b/docs/dyn/cloudbilling_v1.services.html index 927a462ed0..2ba1040792 100644 --- a/docs/dyn/cloudbilling_v1.services.html +++ b/docs/dyn/cloudbilling_v1.services.html @@ -86,7 +86,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists all public cloud services.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1.services.skus.html b/docs/dyn/cloudbilling_v1.services.skus.html index 9b7aad2572..694c8ad64c 100644 --- a/docs/dyn/cloudbilling_v1.services.skus.html +++ b/docs/dyn/cloudbilling_v1.services.skus.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, currencyCode=None, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Lists all publicly available SKUs for a given cloud service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1.tasks.pushNotificationConfigs.html b/docs/dyn/cloudbilling_v1.tasks.pushNotificationConfigs.html index c47fea31b8..444838a07e 100644 --- a/docs/dyn/cloudbilling_v1.tasks.pushNotificationConfigs.html +++ b/docs/dyn/cloudbilling_v1.tasks.pushNotificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, tenant=None, x__xgafv=None)

Get a list of push notifications configured for a task.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.billingAccounts.services.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.services.html index 100f31128f..9de53076f7 100644 --- a/docs/dyn/cloudbilling_v1beta.billingAccounts.services.html +++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.services.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists services visible to a billing account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -142,17 +142,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.billingAccounts.skuGroups.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.html index 9a2e05d0d3..a18dd49cda 100644 --- a/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.html +++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SKU groups visible to a billing account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.billingAccounts.skuGroups.skus.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.skus.html index 6e3b224833..57bc08c718 100644 --- a/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.skus.html +++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.skuGroups.skus.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SKUs that is part of billing account SKU groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.billingAccounts.skus.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.html index 79d94ee9dd..219691cc98 100644 --- a/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.html +++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.html @@ -94,7 +94,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SKUs visible to a billing account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.billingAccounts.skus.prices.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.prices.html index 59743e1bc3..afd9c4dbca 100644 --- a/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.prices.html +++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.skus.prices.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, currencyCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the latest prices for SKUs available to your Cloud Billing account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.html b/docs/dyn/cloudbilling_v1beta.html index 1c49015d24..e4525c2368 100644 --- a/docs/dyn/cloudbilling_v1beta.html +++ b/docs/dyn/cloudbilling_v1beta.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudbilling_v1beta.skuGroups.html b/docs/dyn/cloudbilling_v1beta.skuGroups.html index be1c3921fd..22fb2b5458 100644 --- a/docs/dyn/cloudbilling_v1beta.skuGroups.html +++ b/docs/dyn/cloudbilling_v1beta.skuGroups.html @@ -89,7 +89,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists all publicly listed SKU groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -144,17 +144,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.skuGroups.skus.html b/docs/dyn/cloudbilling_v1beta.skuGroups.skus.html index 49bb2c91fb..e4c484c801 100644 --- a/docs/dyn/cloudbilling_v1beta.skuGroups.skus.html +++ b/docs/dyn/cloudbilling_v1beta.skuGroups.skus.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all publicly listed SKUs contained by a publicly listed SKU group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbilling_v1beta.skus.prices.html b/docs/dyn/cloudbilling_v1beta.skus.prices.html index d87b337ecd..846c7700d1 100644 --- a/docs/dyn/cloudbilling_v1beta.skus.prices.html +++ b/docs/dyn/cloudbilling_v1beta.skus.prices.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, currencyCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the latest prices for all SKUs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -144,17 +144,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbuild_v1.html b/docs/dyn/cloudbuild_v1.html index e7785cb5cc..825f0e4797 100644 --- a/docs/dyn/cloudbuild_v1.html +++ b/docs/dyn/cloudbuild_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudbuild_v1.projects.builds.html b/docs/dyn/cloudbuild_v1.projects.builds.html index db807a78fa..508eb62d92 100644 --- a/docs/dyn/cloudbuild_v1.projects.builds.html +++ b/docs/dyn/cloudbuild_v1.projects.builds.html @@ -93,7 +93,7 @@

Instance Methods

list(projectId, filter=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists previously requested builds. Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. Note: This method only lists builds in the "global" region when using the legacy resource path projects/{project_id}/builds. For all regions, use the regional resource path: `projects/{project_id}/locations/{location}/builds`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

retry(projectId, id, body=None, x__xgafv=None)

@@ -2130,17 +2130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.html b/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.html index 57c96807c8..3ca4c2ad88 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all `BitbucketServerConfigs` for a given project. This API is experimental.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.repos.html b/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.repos.html index a1c833d5cf..9a14488bbf 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.repos.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.bitbucketServerConfigs.repos.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all repositories for a given `BitbucketServerConfig`. This API is experimental.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbuild_v1.projects.locations.builds.html b/docs/dyn/cloudbuild_v1.projects.locations.builds.html index 22a5543e6b..636eda583f 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.builds.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.builds.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, projectId=None, x__xgafv=None)

Lists previously requested builds. Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. Note: This method only lists builds in the "global" region when using the legacy resource path projects/{project_id}/builds. For all regions, use the regional resource path: `projects/{project_id}/locations/{location}/builds`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

retry(name, body=None, x__xgafv=None)

@@ -2129,17 +2129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html index 0c5d2aa5b9..b8e5ad235e 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, projectId=None, x__xgafv=None)

Lists existing `BuildTrigger`s.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(resourceName, body, projectId=None, triggerId=None, updateMask=None, x__xgafv=None)

@@ -2659,17 +2659,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html index 874c7aa230..20aba41348 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `WorkerPool`s.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -310,17 +310,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html index 35cdd78aec..f98c599bcb 100644 --- a/docs/dyn/cloudbuild_v1.projects.triggers.html +++ b/docs/dyn/cloudbuild_v1.projects.triggers.html @@ -90,7 +90,7 @@

Instance Methods

list(projectId, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists existing `BuildTrigger`s.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, triggerId, body, updateMask=None, x__xgafv=None)

@@ -2659,17 +2659,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v2.html b/docs/dyn/cloudbuild_v2.html index b216cff931..2616fc8a2d 100644 --- a/docs/dyn/cloudbuild_v2.html +++ b/docs/dyn/cloudbuild_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudbuild_v2.projects.locations.connections.html b/docs/dyn/cloudbuild_v2.projects.locations.connections.html index 9f6f424a73..a68359b16c 100644 --- a/docs/dyn/cloudbuild_v2.projects.locations.connections.html +++ b/docs/dyn/cloudbuild_v2.projects.locations.connections.html @@ -92,7 +92,7 @@

Instance Methods

fetchLinkableRepositories(connection, pageSize=None, pageToken=None, x__xgafv=None)

FetchLinkableRepositories get repositories from SCM that are accessible and could be added to the connection.

- fetchLinkableRepositories_next(previous_request, previous_response)

+ fetchLinkableRepositories_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -104,7 +104,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Connections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, etag=None, updateMask=None, x__xgafv=None)

@@ -319,17 +319,17 @@

Method Details

- fetchLinkableRepositories_next(previous_request, previous_response) + fetchLinkableRepositories_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)
+        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.
-
+ 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. +
@@ -590,17 +590,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudbuild_v2.projects.locations.connections.repositories.html b/docs/dyn/cloudbuild_v2.projects.locations.connections.repositories.html index 7e2c632ef2..023db0ce79 100644 --- a/docs/dyn/cloudbuild_v2.projects.locations.connections.repositories.html +++ b/docs/dyn/cloudbuild_v2.projects.locations.connections.repositories.html @@ -96,7 +96,7 @@

Instance Methods

fetchGitRefs(repository, pageSize=None, pageToken=None, refType=None, x__xgafv=None)

Fetch the list of branches or tags for a given repository.

- fetchGitRefs_next(previous_request, previous_response)

+ fetchGitRefs_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Repositories in a given connection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -341,17 +341,17 @@

Method Details

- fetchGitRefs_next(previous_request, previous_response) + fetchGitRefs_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)
+        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.
-
+ 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. +
@@ -421,17 +421,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudbuild_v2.projects.locations.html b/docs/dyn/cloudbuild_v2.projects.locations.html index 41aa488835..a05e85e9a7 100644 --- a/docs/dyn/cloudbuild_v2.projects.locations.html +++ b/docs/dyn/cloudbuild_v2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.html b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.html index 2e61716e0f..54a8a528fe 100644 --- a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.html +++ b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about how a Reseller modifies their bill before sending it to a ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * NOT_FOUND: The ChannelPartnerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the ChannelPartnerRepricingConfig resources. The data for each resource is displayed in the ascending order of: * Channel Partner ID * RepricingConfig.effective_invoice_month * ChannelPartnerRepricingConfig.update_time If unsuccessful, returns an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html index c8c15fa143..d7baba2c0d 100644 --- a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html +++ b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Customers. Possible error codes: * PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. * INVALID_ARGUMENT: Required request parameters are missing or invalid. Return value: List of Customers, or an empty list if there are no customers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -472,17 +472,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.html b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.html index 1e0bcfb0f6..3ecabf89ca 100644 --- a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.html +++ b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List ChannelPartnerLinks belonging to a distributor. You must be a distributor to call this method. Possible error codes: * PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. * INVALID_ARGUMENT: Required request parameters are missing or invalid. Return value: The list of the distributor account's ChannelPartnerLink resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.customers.customerRepricingConfigs.html b/docs/dyn/cloudchannel_v1.accounts.customers.customerRepricingConfigs.html index ae38cedcc4..5d84fac32a 100644 --- a/docs/dyn/cloudchannel_v1.accounts.customers.customerRepricingConfigs.html +++ b/docs/dyn/cloudchannel_v1.accounts.customers.customerRepricingConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about how a Reseller modifies their bill before sending it to a Customer. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * NOT_FOUND: The CustomerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the CustomerRepricingConfig resources. The data for each resource is displayed in the ascending order of: * Customer ID * RepricingConfig.EntitlementGranularity.entitlement * RepricingConfig.effective_invoice_month * CustomerRepricingConfig.update_time If unsuccessful, returns an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.customers.entitlements.html b/docs/dyn/cloudchannel_v1.accounts.customers.entitlements.html index 26270a6d52..a702562423 100644 --- a/docs/dyn/cloudchannel_v1.accounts.customers.entitlements.html +++ b/docs/dyn/cloudchannel_v1.accounts.customers.entitlements.html @@ -105,10 +105,10 @@

Instance Methods

listEntitlementChanges(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List entitlement history. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different. * INVALID_ARGUMENT: Missing or invalid required fields in the request. * NOT_FOUND: The parent resource doesn't exist. Usually the result of an invalid name parameter. * INTERNAL: Any non-user error related to a technical issue in the backend. In this case, contact CloudChannel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. In this case, contact Cloud Channel support. Return value: List of EntitlementChanges.

- listEntitlementChanges_next(previous_request, previous_response)

+ listEntitlementChanges_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupOffer(entitlement, x__xgafv=None)

@@ -676,31 +676,31 @@

Method Details

- listEntitlementChanges_next(previous_request, previous_response) + listEntitlementChanges_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.customers.html b/docs/dyn/cloudchannel_v1.accounts.customers.html index 1074043e60..65c52e38aa 100644 --- a/docs/dyn/cloudchannel_v1.accounts.customers.html +++ b/docs/dyn/cloudchannel_v1.accounts.customers.html @@ -106,16 +106,16 @@

Instance Methods

listPurchasableOffers(customer, changeOfferPurchase_billingAccount=None, changeOfferPurchase_entitlement=None, changeOfferPurchase_newSku=None, createEntitlementPurchase_billingAccount=None, createEntitlementPurchase_sku=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the following: * Offers that you can purchase for a customer. * Offers that you can change for an entitlement. Possible error codes: * PERMISSION_DENIED: * The customer doesn't belong to the reseller * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 * INVALID_ARGUMENT: Required request parameters are missing or invalid.

- listPurchasableOffers_next(previous_request, previous_response)

+ listPurchasableOffers_next()

Retrieves the next page of results.

listPurchasableSkus(customer, changeOfferPurchase_changeType=None, changeOfferPurchase_entitlement=None, createEntitlementPurchase_product=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the following: * SKUs that you can purchase for a customer * SKUs that you can upgrade or downgrade for an entitlement. Possible error codes: * PERMISSION_DENIED: The customer doesn't belong to the reseller. * INVALID_ARGUMENT: Required request parameters are missing or invalid.

- listPurchasableSkus_next(previous_request, previous_response)

+ listPurchasableSkus_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -744,17 +744,17 @@

Method Details

- listPurchasableOffers_next(previous_request, previous_response) + listPurchasableOffers_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)
+        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.
-
+ 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. +
@@ -815,31 +815,31 @@

Method Details

- listPurchasableSkus_next(previous_request, previous_response) + listPurchasableSkus_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.html b/docs/dyn/cloudchannel_v1.accounts.html index 5c6b3b3187..c113d923fd 100644 --- a/docs/dyn/cloudchannel_v1.accounts.html +++ b/docs/dyn/cloudchannel_v1.accounts.html @@ -114,19 +114,19 @@

Instance Methods

listSubscribers(account, integrator=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.

- listSubscribers_next(previous_request, previous_response)

+ listSubscribers_next()

Retrieves the next page of results.

listTransferableOffers(parent, body=None, x__xgafv=None)

List TransferableOffers of a customer based on Cloud Identity ID or Customer Name in the request. Use this method when a reseller gets the entitlement information of an unowned customer. The reseller should provide the customer's Cloud Identity ID or Customer Name. Possible error codes: * PERMISSION_DENIED: * The customer doesn't belong to the reseller and has no auth token. * The customer provided incorrect reseller information when generating auth token. * The reseller account making the request is different from the reseller account in the query. * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 * INVALID_ARGUMENT: Required request parameters are missing or invalid. Return value: List of TransferableOffer for the given customer and SKU.

- listTransferableOffers_next(previous_request, previous_response)

+ listTransferableOffers_next()

Retrieves the next page of results.

listTransferableSkus(parent, body=None, x__xgafv=None)

List TransferableSkus of a customer based on the Cloud Identity ID or Customer Name in the request. Use this method to list the entitlements information of an unowned customer. You should provide the customer's Cloud Identity ID or Customer Name. Possible error codes: * PERMISSION_DENIED: * The customer doesn't belong to the reseller and has no auth token. * The supplied auth token is invalid. * The reseller account making the request is different from the reseller account in the query. * INVALID_ARGUMENT: Required request parameters are missing or invalid. Return value: A list of the customer's TransferableSku.

- listTransferableSkus_next(previous_request, previous_response)

+ listTransferableSkus_next()

Retrieves the next page of results.

register(account, body=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- listSubscribers_next(previous_request, previous_response) + listSubscribers_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)
+        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.
-
+ 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. +
@@ -460,17 +460,17 @@

Method Details

- listTransferableOffers_next(previous_request, previous_response) + listTransferableOffers_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)
+        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.
-
+ 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. +
@@ -562,17 +562,17 @@

Method Details

- listTransferableSkus_next(previous_request, previous_response) + listTransferableSkus_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.offers.html b/docs/dyn/cloudchannel_v1.accounts.offers.html index 1e5f3a8cbf..c22060f5ba 100644 --- a/docs/dyn/cloudchannel_v1.accounts.offers.html +++ b/docs/dyn/cloudchannel_v1.accounts.offers.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, languageCode=None, pageSize=None, pageToken=None, showFutureOffers=None, x__xgafv=None)

Lists the Offers the reseller can sell. Possible error codes: * INVALID_ARGUMENT: Required request parameters are missing or invalid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.accounts.reportJobs.html b/docs/dyn/cloudchannel_v1.accounts.reportJobs.html index c718ca6345..dbe3aea6db 100644 --- a/docs/dyn/cloudchannel_v1.accounts.reportJobs.html +++ b/docs/dyn/cloudchannel_v1.accounts.reportJobs.html @@ -81,7 +81,7 @@

Instance Methods

fetchReportResults(reportJob, body=None, x__xgafv=None)

Retrieves data generated by CloudChannelReportsService.RunReportJob. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.

- fetchReportResults_next(previous_request, previous_response)

+ fetchReportResults_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- fetchReportResults_next(previous_request, previous_response) + fetchReportResults_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)
+        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.
-
+ 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/cloudchannel_v1.accounts.reports.html b/docs/dyn/cloudchannel_v1.accounts.reports.html index 98904d5b60..acae0ba13c 100644 --- a/docs/dyn/cloudchannel_v1.accounts.reports.html +++ b/docs/dyn/cloudchannel_v1.accounts.reports.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the reports that RunReportJob can run. These reports include an ID, a description, and the list of columns that will be in the result. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.accounts.skuGroups.billableSkus.html b/docs/dyn/cloudchannel_v1.accounts.skuGroups.billableSkus.html index 56aee1d508..1d3084e727 100644 --- a/docs/dyn/cloudchannel_v1.accounts.skuGroups.billableSkus.html +++ b/docs/dyn/cloudchannel_v1.accounts.skuGroups.billableSkus.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Billable SKUs in a given SKU group. Possible error codes: PERMISSION_DENIED: If the account making the request and the account being queried for are different, or the account doesn't exist. INVALID_ARGUMENT: Missing or invalid required parameters in the request. INTERNAL: Any non-user error related to technical issue in the backend. In this case, contact cloud channel support. Return Value: If successful, the BillableSku resources. The data for each resource is displayed in the ascending order of: * BillableSku.service_display_name * BillableSku.sku_display_name If unsuccessful, returns an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.accounts.skuGroups.html b/docs/dyn/cloudchannel_v1.accounts.skuGroups.html index 2e30d1b672..279c82a8ad 100644 --- a/docs/dyn/cloudchannel_v1.accounts.skuGroups.html +++ b/docs/dyn/cloudchannel_v1.accounts.skuGroups.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Rebilling supported SKU groups the account is authorized to sell. Reference: https://cloud.google.com/skus/sku-groups Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different, or the account doesn't exist. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the SkuGroup resources. The data for each resource is displayed in the alphabetical order of SKU group display name. The data for each resource is displayed in the ascending order of SkuGroup.display_name If unsuccessful, returns an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -122,17 +122,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.html b/docs/dyn/cloudchannel_v1.html index 7f7e5a7abc..aa51f74b7e 100644 --- a/docs/dyn/cloudchannel_v1.html +++ b/docs/dyn/cloudchannel_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudchannel_v1.integrators.html b/docs/dyn/cloudchannel_v1.integrators.html index 5cf4231eae..52045ddf02 100644 --- a/docs/dyn/cloudchannel_v1.integrators.html +++ b/docs/dyn/cloudchannel_v1.integrators.html @@ -81,7 +81,7 @@

Instance Methods

listSubscribers(integrator, account=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.

- listSubscribers_next(previous_request, previous_response)

+ listSubscribers_next()

Retrieves the next page of results.

registerSubscriber(integrator, body=None, x__xgafv=None)

@@ -122,17 +122,17 @@

Method Details

- listSubscribers_next(previous_request, previous_response) + listSubscribers_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudchannel_v1.operations.html b/docs/dyn/cloudchannel_v1.operations.html index a9d068675e..5edf88be76 100644 --- a/docs/dyn/cloudchannel_v1.operations.html +++ b/docs/dyn/cloudchannel_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.products.html b/docs/dyn/cloudchannel_v1.products.html index 7988eda342..4504e5aee1 100644 --- a/docs/dyn/cloudchannel_v1.products.html +++ b/docs/dyn/cloudchannel_v1.products.html @@ -86,7 +86,7 @@

Instance Methods

list(account=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Products the reseller is authorized to sell. Possible error codes: * INVALID_ARGUMENT: Required request parameters are missing or invalid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudchannel_v1.products.skus.html b/docs/dyn/cloudchannel_v1.products.skus.html index 6db35aaae9..7fcadafeb9 100644 --- a/docs/dyn/cloudchannel_v1.products.skus.html +++ b/docs/dyn/cloudchannel_v1.products.skus.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, account=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the SKUs for a product the reseller is authorized to sell. Possible error codes: * INVALID_ARGUMENT: Required request parameters are missing or invalid.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -139,17 +139,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcommerceprocurement_v1.html b/docs/dyn/cloudcommerceprocurement_v1.html index c98ef98c05..45c192ef4a 100644 --- a/docs/dyn/cloudcommerceprocurement_v1.html +++ b/docs/dyn/cloudcommerceprocurement_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudcommerceprocurement_v1.providers.accounts.html b/docs/dyn/cloudcommerceprocurement_v1.providers.accounts.html index ac3a4804d5..3b1f8ec434 100644 --- a/docs/dyn/cloudcommerceprocurement_v1.providers.accounts.html +++ b/docs/dyn/cloudcommerceprocurement_v1.providers.accounts.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Accounts that the provider has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reject(name, body=None, x__xgafv=None)

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudcommerceprocurement_v1.providers.entitlements.html b/docs/dyn/cloudcommerceprocurement_v1.providers.entitlements.html index c48ef5f281..3d4693082b 100644 --- a/docs/dyn/cloudcommerceprocurement_v1.providers.entitlements.html +++ b/docs/dyn/cloudcommerceprocurement_v1.providers.entitlements.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Entitlements for which the provider has read access.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -276,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudcontrolspartner_v1.html b/docs/dyn/cloudcontrolspartner_v1.html index 67868bf0ce..d0ab334f6e 100644 --- a/docs/dyn/cloudcontrolspartner_v1.html +++ b/docs/dyn/cloudcontrolspartner_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html index d3f0dce31c..e4b1649ae9 100644 --- a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html +++ b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists customers of a partner identified by its Google Cloud organization ID

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.accessApprovalRequests.html b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.accessApprovalRequests.html index e411cd2521..34ae96c90d 100644 --- a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.accessApprovalRequests.html +++ b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.accessApprovalRequests.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: Only returns access approval requests directly associated with an assured workload folder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcontrolspartner_v1.organizations.locations.customers.workloads.html b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.html index 7ca208e8c7..bbc9fab452 100644 --- a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.html +++ b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists customer workloads for a given customer org id

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcontrolspartner_v1.organizations.locations.customers.workloads.violations.html b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.violations.html index e6c4980469..cc6e78695a 100644 --- a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.violations.html +++ b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.workloads.violations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Violations for a workload Callers may also choose to read across multiple Customers or for a single customer as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of {customer} & {workload}. Format: `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcontrolspartner_v1beta.html b/docs/dyn/cloudcontrolspartner_v1beta.html index d027411994..ba5d6f548e 100644 --- a/docs/dyn/cloudcontrolspartner_v1beta.html +++ b/docs/dyn/cloudcontrolspartner_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html index 68552dbd0b..22957ca7bf 100644 --- a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html +++ b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists customers of a partner identified by its Google Cloud organization ID

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.accessApprovalRequests.html b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.accessApprovalRequests.html index 47fb49b0e0..165082d0d1 100644 --- a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.accessApprovalRequests.html +++ b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.accessApprovalRequests.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: Only returns access approval requests directly associated with an assured workload folder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.html b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.html index a6217ff035..b597a0fad0 100644 --- a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.html +++ b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists customer workloads for a given customer org id

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.violations.html b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.violations.html index 3cd827bff7..1c94db8e34 100644 --- a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.violations.html +++ b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.workloads.violations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Violations for a workload Callers may also choose to read across multiple Customers or for a single customer as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of {customer} & {workload}. Format: `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}`

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouddeploy_v1.html b/docs/dyn/clouddeploy_v1.html index b14271fa32..aa8911df29 100644 --- a/docs/dyn/clouddeploy_v1.html +++ b/docs/dyn/clouddeploy_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/clouddeploy_v1.projects.locations.customTargetTypes.html b/docs/dyn/clouddeploy_v1.projects.locations.customTargetTypes.html index f0ed35beb1..463fc7c17d 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.customTargetTypes.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.customTargetTypes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CustomTargetTypes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -491,17 +491,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automationRuns.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automationRuns.html index 42e3a9c71d..87e0851ca7 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automationRuns.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automationRuns.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AutomationRuns in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -592,17 +592,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouddeploy_v1.projects.locations.deliveryPipelines.automations.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automations.html index 037b6db1eb..0c58795872 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automations.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.automations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Automations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -659,17 +659,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.html index bb421df720..abacf1bafd 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeliveryPipelines in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1506,17 +1506,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.html index d4a96c054e..5f64c934b4 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Releases in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2243,17 +2243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.html index 7a3cd0eb8b..7bd2324c7d 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Rollouts in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

retryJob(rollout, body=None, x__xgafv=None)

@@ -2794,17 +2794,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.html b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.html index 820b7bf238..7cbec0284c 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists JobRuns in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

terminate(name, body=None, x__xgafv=None)

@@ -418,17 +418,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.deployPolicies.html b/docs/dyn/clouddeploy_v1.projects.locations.deployPolicies.html index 233f34b022..89198fbeb5 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.deployPolicies.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.deployPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeployPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouddeploy_v1.projects.locations.html b/docs/dyn/clouddeploy_v1.projects.locations.html index b3b904892c..3dd59e21b0 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.html @@ -112,7 +112,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouddeploy_v1.projects.locations.operations.html b/docs/dyn/clouddeploy_v1.projects.locations.operations.html index 2ff82a39fd..1fb93e8dd3 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.operations.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouddeploy_v1.projects.locations.targets.html b/docs/dyn/clouddeploy_v1.projects.locations.targets.html index 1b5af0a71c..2a79f2d3bd 100644 --- a/docs/dyn/clouddeploy_v1.projects.locations.targets.html +++ b/docs/dyn/clouddeploy_v1.projects.locations.targets.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Targets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouderrorreporting_v1beta1.html b/docs/dyn/clouderrorreporting_v1beta1.html index 098972b5d5..2ce8f99c71 100644 --- a/docs/dyn/clouderrorreporting_v1beta1.html +++ b/docs/dyn/clouderrorreporting_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/clouderrorreporting_v1beta1.projects.events.html b/docs/dyn/clouderrorreporting_v1beta1.projects.events.html index edffe64bf4..534393fb11 100644 --- a/docs/dyn/clouderrorreporting_v1beta1.projects.events.html +++ b/docs/dyn/clouderrorreporting_v1beta1.projects.events.html @@ -81,7 +81,7 @@

Instance Methods

list(projectName, groupId=None, pageSize=None, pageToken=None, serviceFilter_resourceType=None, serviceFilter_service=None, serviceFilter_version=None, timeRange_period=None, x__xgafv=None)

Lists the specified events.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

report(projectName, body=None, x__xgafv=None)

@@ -160,17 +160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html b/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html index 336bd9fe14..a0cde10050 100644 --- a/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html +++ b/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html @@ -81,7 +81,7 @@

Instance Methods

list(projectName, alignment=None, alignmentTime=None, groupId=None, order=None, pageSize=None, pageToken=None, serviceFilter_resourceType=None, serviceFilter_service=None, serviceFilter_version=None, timeRange_period=None, timedCountDuration=None, x__xgafv=None)

Lists the specified groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouderrorreporting_v1beta1.projects.locations.events.html b/docs/dyn/clouderrorreporting_v1beta1.projects.locations.events.html index 835813fbe3..96734dbcf4 100644 --- a/docs/dyn/clouderrorreporting_v1beta1.projects.locations.events.html +++ b/docs/dyn/clouderrorreporting_v1beta1.projects.locations.events.html @@ -81,7 +81,7 @@

Instance Methods

list(projectName, groupId=None, pageSize=None, pageToken=None, serviceFilter_resourceType=None, serviceFilter_service=None, serviceFilter_version=None, timeRange_period=None, x__xgafv=None)

Lists the specified events.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/clouderrorreporting_v1beta1.projects.locations.groupStats.html b/docs/dyn/clouderrorreporting_v1beta1.projects.locations.groupStats.html index 073d263a59..81436e0eff 100644 --- a/docs/dyn/clouderrorreporting_v1beta1.projects.locations.groupStats.html +++ b/docs/dyn/clouderrorreporting_v1beta1.projects.locations.groupStats.html @@ -81,7 +81,7 @@

Instance Methods

list(projectName, alignment=None, alignmentTime=None, groupId=None, order=None, pageSize=None, pageToken=None, serviceFilter_resourceType=None, serviceFilter_service=None, serviceFilter_version=None, timeRange_period=None, timedCountDuration=None, x__xgafv=None)

Lists the specified groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v1.html b/docs/dyn/cloudfunctions_v1.html index 0b746c49f6..2e0d2d0167 100644 --- a/docs/dyn/cloudfunctions_v1.html +++ b/docs/dyn/cloudfunctions_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudfunctions_v1.operations.html b/docs/dyn/cloudfunctions_v1.operations.html index d8d52e1da8..3c7488dd8e 100644 --- a/docs/dyn/cloudfunctions_v1.operations.html +++ b/docs/dyn/cloudfunctions_v1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v1.projects.locations.functions.html b/docs/dyn/cloudfunctions_v1.projects.locations.functions.html index d5b58d631d..7e89f510cd 100644 --- a/docs/dyn/cloudfunctions_v1.projects.locations.functions.html +++ b/docs/dyn/cloudfunctions_v1.projects.locations.functions.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of functions that belong to the requested project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -611,17 +611,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudfunctions_v1.projects.locations.html b/docs/dyn/cloudfunctions_v1.projects.locations.html index ccfe088fa1..d9f1929a2e 100644 --- a/docs/dyn/cloudfunctions_v1.projects.locations.html +++ b/docs/dyn/cloudfunctions_v1.projects.locations.html @@ -86,7 +86,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2.html b/docs/dyn/cloudfunctions_v2.html index 5bd99eed2f..25859463ff 100644 --- a/docs/dyn/cloudfunctions_v2.html +++ b/docs/dyn/cloudfunctions_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudfunctions_v2.projects.locations.functions.html b/docs/dyn/cloudfunctions_v2.projects.locations.functions.html index 27efc3fdbb..306308e288 100644 --- a/docs/dyn/cloudfunctions_v2.projects.locations.functions.html +++ b/docs/dyn/cloudfunctions_v2.projects.locations.functions.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of functions that belong to the requested project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1329,17 +1329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudfunctions_v2.projects.locations.html b/docs/dyn/cloudfunctions_v2.projects.locations.html index 901d5e570c..09fe24114a 100644 --- a/docs/dyn/cloudfunctions_v2.projects.locations.html +++ b/docs/dyn/cloudfunctions_v2.projects.locations.html @@ -96,7 +96,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2.projects.locations.operations.html b/docs/dyn/cloudfunctions_v2.projects.locations.operations.html index 07a7f90a1c..125508a7cc 100644 --- a/docs/dyn/cloudfunctions_v2.projects.locations.operations.html +++ b/docs/dyn/cloudfunctions_v2.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2alpha.html b/docs/dyn/cloudfunctions_v2alpha.html index fafef411ac..43ce8ba523 100644 --- a/docs/dyn/cloudfunctions_v2alpha.html +++ b/docs/dyn/cloudfunctions_v2alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudfunctions_v2alpha.projects.locations.functions.html b/docs/dyn/cloudfunctions_v2alpha.projects.locations.functions.html index d69a9b18c0..c398dd6652 100644 --- a/docs/dyn/cloudfunctions_v2alpha.projects.locations.functions.html +++ b/docs/dyn/cloudfunctions_v2alpha.projects.locations.functions.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of functions that belong to the requested project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1329,17 +1329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudfunctions_v2alpha.projects.locations.html b/docs/dyn/cloudfunctions_v2alpha.projects.locations.html index 057b0c4722..b8bae451d2 100644 --- a/docs/dyn/cloudfunctions_v2alpha.projects.locations.html +++ b/docs/dyn/cloudfunctions_v2alpha.projects.locations.html @@ -96,7 +96,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2alpha.projects.locations.operations.html b/docs/dyn/cloudfunctions_v2alpha.projects.locations.operations.html index 838777bcdf..81324a39d5 100644 --- a/docs/dyn/cloudfunctions_v2alpha.projects.locations.operations.html +++ b/docs/dyn/cloudfunctions_v2alpha.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2beta.html b/docs/dyn/cloudfunctions_v2beta.html index ca34a10aac..651b52d4c4 100644 --- a/docs/dyn/cloudfunctions_v2beta.html +++ b/docs/dyn/cloudfunctions_v2beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudfunctions_v2beta.projects.locations.functions.html b/docs/dyn/cloudfunctions_v2beta.projects.locations.functions.html index b547c8966e..444684d7d5 100644 --- a/docs/dyn/cloudfunctions_v2beta.projects.locations.functions.html +++ b/docs/dyn/cloudfunctions_v2beta.projects.locations.functions.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of functions that belong to the requested project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1329,17 +1329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudfunctions_v2beta.projects.locations.html b/docs/dyn/cloudfunctions_v2beta.projects.locations.html index 269e57b8ff..d88137d719 100644 --- a/docs/dyn/cloudfunctions_v2beta.projects.locations.html +++ b/docs/dyn/cloudfunctions_v2beta.projects.locations.html @@ -96,7 +96,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudfunctions_v2beta.projects.locations.operations.html b/docs/dyn/cloudfunctions_v2beta.projects.locations.operations.html index 681e882630..6e9964943d 100644 --- a/docs/dyn/cloudfunctions_v2beta.projects.locations.operations.html +++ b/docs/dyn/cloudfunctions_v2beta.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudidentity_v1.allowlistedDomains.html b/docs/dyn/cloudidentity_v1.allowlistedDomains.html index 72af827e77..75bbf85fe1 100644 --- a/docs/dyn/cloudidentity_v1.allowlistedDomains.html +++ b/docs/dyn/cloudidentity_v1.allowlistedDomains.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains in the allowlist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudidentity_v1.customers.userinvitations.html b/docs/dyn/cloudidentity_v1.customers.userinvitations.html index b23177ef21..814b7e58db 100644 --- a/docs/dyn/cloudidentity_v1.customers.userinvitations.html +++ b/docs/dyn/cloudidentity_v1.customers.userinvitations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of UserInvitation resources. **Note:** New consumer accounts with the customer's verified domain created within the previous 48 hours will not appear in the result. This delay also applies to newly-verified domains.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

send(name, body=None, x__xgafv=None)

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.devices.deviceUsers.clientStates.html b/docs/dyn/cloudidentity_v1.devices.deviceUsers.clientStates.html index 1adb9e4f81..fb3463361b 100644 --- a/docs/dyn/cloudidentity_v1.devices.deviceUsers.clientStates.html +++ b/docs/dyn/cloudidentity_v1.devices.deviceUsers.clientStates.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, customer=None, filter=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists the client states for the given search query.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, customer=None, updateMask=None, x__xgafv=None)

@@ -182,17 +182,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.devices.deviceUsers.html b/docs/dyn/cloudidentity_v1.devices.deviceUsers.html index a98e6d6055..3193e56aa0 100644 --- a/docs/dyn/cloudidentity_v1.devices.deviceUsers.html +++ b/docs/dyn/cloudidentity_v1.devices.deviceUsers.html @@ -101,13 +101,13 @@

Instance Methods

list(parent, customer=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists/Searches DeviceUsers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, androidId=None, iosDeviceId=None, pageSize=None, pageToken=None, partner=None, rawResourceId=None, userId=None, x__xgafv=None)

Looks up resource names of the DeviceUsers associated with the caller's credentials, as well as the properties provided in the request. This method must be called with end-user credentials with the scope: https://www.googleapis.com/auth/cloud-identity.devices.lookup If multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND. Different platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified. - iOS: If either the `partner` or `ios_device_id` field is provided, then both fields are required. - Android: Specifying the `android_id` field is required. - Desktop: Specifying the `raw_resource_id` field is required.

- lookup_next(previous_request, previous_response)

+ lookup_next()

Retrieves the next page of results.

wipe(name, body=None, x__xgafv=None)

@@ -348,17 +348,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -392,17 +392,17 @@

Method Details

- lookup_next(previous_request, previous_response) + lookup_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.devices.html b/docs/dyn/cloudidentity_v1.devices.html index b37288a591..e5a9217227 100644 --- a/docs/dyn/cloudidentity_v1.devices.html +++ b/docs/dyn/cloudidentity_v1.devices.html @@ -98,7 +98,7 @@

Instance Methods

list(customer=None, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists/Searches devices.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wipe(name, body=None, x__xgafv=None)

@@ -544,17 +544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.groups.html b/docs/dyn/cloudidentity_v1.groups.html index 319fc6a723..b1ce7c725b 100644 --- a/docs/dyn/cloudidentity_v1.groups.html +++ b/docs/dyn/cloudidentity_v1.groups.html @@ -98,7 +98,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, view=None, x__xgafv=None)

Lists the `Group` resources under a customer or namespace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(groupKey_id=None, groupKey_namespace=None, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

search(pageSize=None, pageToken=None, query=None, view=None, x__xgafv=None)

Searches for `Group` resources matching a specified query.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

updateSecuritySettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -151,10 +151,10 @@

Method Details

"statusTime": "A String", # The latest time at which the dynamic group is guaranteed to be in the given status. If status is `UP_TO_DATE`, the latest time at which the dynamic group was confirmed to be up-to-date. If status is `UPDATING_MEMBERSHIPS`, the time at which dynamic group was created. }, }, - "externalIds": [ # Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `"system/external"`. - { # An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory. - "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace. - "namespace": "A String", # Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `"system/external"`. + "externalIds": [ # Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`. + { # Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider. + "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace. + "namespace": "A String", # Required. The namespace in which the entity exists. The only supported namespace is `system/external`. }, ], "groupKey": { # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s. # Required. The `EntityKey` of the `Group`. @@ -274,10 +274,10 @@

Method Details

"statusTime": "A String", # The latest time at which the dynamic group is guaranteed to be in the given status. If status is `UP_TO_DATE`, the latest time at which the dynamic group was confirmed to be up-to-date. If status is `UPDATING_MEMBERSHIPS`, the time at which dynamic group was created. }, }, - "externalIds": [ # Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `"system/external"`. - { # An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory. - "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace. - "namespace": "A String", # Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `"system/external"`. + "externalIds": [ # Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`. + { # Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider. + "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace. + "namespace": "A String", # Required. The namespace in which the entity exists. The only supported namespace is `system/external`. }, ], "groupKey": { # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s. # Required. The `EntityKey` of the `Group`. @@ -364,10 +364,10 @@

Method Details

"statusTime": "A String", # The latest time at which the dynamic group is guaranteed to be in the given status. If status is `UP_TO_DATE`, the latest time at which the dynamic group was confirmed to be up-to-date. If status is `UPDATING_MEMBERSHIPS`, the time at which dynamic group was created. }, }, - "externalIds": [ # Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `"system/external"`. - { # An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory. - "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace. - "namespace": "A String", # Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `"system/external"`. + "externalIds": [ # Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`. + { # Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider. + "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace. + "namespace": "A String", # Required. The namespace in which the entity exists. The only supported namespace is `system/external`. }, ], "groupKey": { # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s. # Required. The `EntityKey` of the `Group`. @@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -451,10 +451,10 @@

Method Details

"statusTime": "A String", # The latest time at which the dynamic group is guaranteed to be in the given status. If status is `UP_TO_DATE`, the latest time at which the dynamic group was confirmed to be up-to-date. If status is `UPDATING_MEMBERSHIPS`, the time at which dynamic group was created. }, }, - "externalIds": [ # Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `"system/external"`. - { # An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory. - "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace. - "namespace": "A String", # Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `"system/external"`. + "externalIds": [ # Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`. + { # Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider. + "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace. + "namespace": "A String", # Required. The namespace in which the entity exists. The only supported namespace is `system/external`. }, ], "groupKey": { # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s. # Required. The `EntityKey` of the `Group`. @@ -544,10 +544,10 @@

Method Details

"statusTime": "A String", # The latest time at which the dynamic group is guaranteed to be in the given status. If status is `UP_TO_DATE`, the latest time at which the dynamic group was confirmed to be up-to-date. If status is `UPDATING_MEMBERSHIPS`, the time at which dynamic group was created. }, }, - "externalIds": [ # Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `"system/external"`. - { # An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory. - "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace. - "namespace": "A String", # Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `"system/external"`. + "externalIds": [ # Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`. + { # Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider. + "id": "A String", # Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace. + "namespace": "A String", # Required. The namespace in which the entity exists. The only supported namespace is `system/external`. }, ], "groupKey": { # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s. # Required. The `EntityKey` of the `Group`. @@ -567,17 +567,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.groups.memberships.html b/docs/dyn/cloudidentity_v1.groups.memberships.html index 27bc4c936e..6b1352cbfd 100644 --- a/docs/dyn/cloudidentity_v1.groups.memberships.html +++ b/docs/dyn/cloudidentity_v1.groups.memberships.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the `Membership`s within a `Group`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, memberKey_id=None, memberKey_namespace=None, x__xgafv=None)

@@ -108,19 +108,19 @@

Instance Methods

searchDirectGroups(parent, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches direct groups of a member. Groups for which the actor does not have the permission to view memberships are silently filtered out.

- searchDirectGroups_next(previous_request, previous_response)

+ searchDirectGroups_next()

Retrieves the next page of results.

searchTransitiveGroups(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search transitive groups of a member. **Note:** This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. If the account of the member is not one of these, a 403 (PERMISSION_DENIED) HTTP status code will be returned. A transitive group is any group that has a direct or indirect membership to the member. Actor must have view permissions all transitive groups.

- searchTransitiveGroups_next(previous_request, previous_response)

+ searchTransitiveGroups_next()

Retrieves the next page of results.

searchTransitiveMemberships(parent, pageSize=None, pageToken=None, x__xgafv=None)

Search transitive memberships of a group. **Note:** This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. If the account of the group is not one of these, a 403 (PERMISSION_DENIED) HTTP status code will be returned. A transitive membership is any direct or indirect membership of a group. Actor must have view permissions to all transitive memberships.

- searchTransitiveMemberships_next(previous_request, previous_response)

+ searchTransitiveMemberships_next()

Retrieves the next page of results.

Method Details

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -541,17 +541,17 @@

Method Details

- searchDirectGroups_next(previous_request, previous_response) + searchDirectGroups_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)
+        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.
-
+ 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. +
@@ -596,17 +596,17 @@

Method Details

- searchTransitiveGroups_next(previous_request, previous_response) + searchTransitiveGroups_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)
+        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.
-
+ 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. +
@@ -648,17 +648,17 @@

Method Details

- searchTransitiveMemberships_next(previous_request, previous_response) + searchTransitiveMemberships_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)
+        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.
-
+ 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/cloudidentity_v1.html b/docs/dyn/cloudidentity_v1.html index 1b3196b42c..8222a42612 100644 --- a/docs/dyn/cloudidentity_v1.html +++ b/docs/dyn/cloudidentity_v1.html @@ -118,7 +118,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -127,20 +127,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html b/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html index f12163ba97..89889e8bd1 100644 --- a/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html +++ b/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InboundOidcSsoProfile objects for a Google enterprise customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.html b/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.html index 4ca03c9451..4a4bea8d3f 100644 --- a/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.html +++ b/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.html @@ -95,7 +95,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InboundSamlSsoProfiles for a customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.idpCredentials.html b/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.idpCredentials.html index 6788cd29f1..89437c9c7e 100644 --- a/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.idpCredentials.html +++ b/docs/dyn/cloudidentity_v1.inboundSamlSsoProfiles.idpCredentials.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of IdpCredentials in an InboundSamlSsoProfile.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudidentity_v1.inboundSsoAssignments.html b/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html index 37e241944d..f3d89e669f 100644 --- a/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html +++ b/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the InboundSsoAssignments for a `Customer`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1.policies.html b/docs/dyn/cloudidentity_v1.policies.html index 6b66372568..9bd84233d8 100644 --- a/docs/dyn/cloudidentity_v1.policies.html +++ b/docs/dyn/cloudidentity_v1.policies.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.allowlistedDomains.html b/docs/dyn/cloudidentity_v1beta1.allowlistedDomains.html index 4cac24a48b..f77f60236d 100644 --- a/docs/dyn/cloudidentity_v1beta1.allowlistedDomains.html +++ b/docs/dyn/cloudidentity_v1beta1.allowlistedDomains.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains in the allowlist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudidentity_v1beta1.customers.userinvitations.html b/docs/dyn/cloudidentity_v1beta1.customers.userinvitations.html index 5619aa8cdf..94f10e6568 100644 --- a/docs/dyn/cloudidentity_v1beta1.customers.userinvitations.html +++ b/docs/dyn/cloudidentity_v1beta1.customers.userinvitations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of UserInvitation resources. **Note:** New consumer accounts with the customer's verified domain created within the previous 48 hours will not appear in the result. This delay also applies to newly-verified domains.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

send(name, body=None, x__xgafv=None)

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.devices.deviceUsers.html b/docs/dyn/cloudidentity_v1beta1.devices.deviceUsers.html index 101a22ec87..55d3688a5c 100644 --- a/docs/dyn/cloudidentity_v1beta1.devices.deviceUsers.html +++ b/docs/dyn/cloudidentity_v1beta1.devices.deviceUsers.html @@ -101,13 +101,13 @@

Instance Methods

list(parent, customer=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists/Searches DeviceUsers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, androidId=None, iosDeviceId=None, pageSize=None, pageToken=None, partner=None, rawResourceId=None, userId=None, x__xgafv=None)

Looks up resource names of the DeviceUsers associated with the caller's credentials, as well as the properties provided in the request. This method must be called with end-user credentials with the scope: https://www.googleapis.com/auth/cloud-identity.devices.lookup If multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND. Different platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified. - iOS: If either the `partner` or `ios_device_id` field is provided, then both fields are required. - Android: Specifying the `android_id` field is required. - Desktop: Specifying the `raw_resource_id` field is required.

- lookup_next(previous_request, previous_response)

+ lookup_next()

Retrieves the next page of results.

wipe(name, body=None, x__xgafv=None)

@@ -348,17 +348,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -392,17 +392,17 @@

Method Details

- lookup_next(previous_request, previous_response) + lookup_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.devices.html b/docs/dyn/cloudidentity_v1beta1.devices.html index 9f7db3cc51..b53ddb7632 100644 --- a/docs/dyn/cloudidentity_v1beta1.devices.html +++ b/docs/dyn/cloudidentity_v1beta1.devices.html @@ -98,7 +98,7 @@

Instance Methods

list(customer=None, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists/Searches devices.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wipe(name, body=None, x__xgafv=None)

@@ -759,17 +759,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.groups.html b/docs/dyn/cloudidentity_v1beta1.groups.html index aea15724a5..7a106a86bd 100644 --- a/docs/dyn/cloudidentity_v1beta1.groups.html +++ b/docs/dyn/cloudidentity_v1beta1.groups.html @@ -98,7 +98,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, view=None, x__xgafv=None)

Lists the `Group` resources under a customer or namespace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(groupKey_id=None, groupKey_namespace=None, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

search(orderBy=None, pageSize=None, pageToken=None, query=None, view=None, x__xgafv=None)

Searches for `Group` resources matching a specified query.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

updateSecuritySettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -408,17 +408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -602,17 +602,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.groups.memberships.html b/docs/dyn/cloudidentity_v1beta1.groups.memberships.html index b91f774c3c..d9ba3e606e 100644 --- a/docs/dyn/cloudidentity_v1beta1.groups.memberships.html +++ b/docs/dyn/cloudidentity_v1beta1.groups.memberships.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the `Membership`s within a `Group`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, memberKey_id=None, memberKey_namespace=None, x__xgafv=None)

@@ -108,19 +108,19 @@

Instance Methods

searchDirectGroups(parent, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches direct groups of a member. Groups for which the actor does not have the permission to view memberships are silently filtered out.

- searchDirectGroups_next(previous_request, previous_response)

+ searchDirectGroups_next()

Retrieves the next page of results.

searchTransitiveGroups(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search transitive groups of a member. **Note:** This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. A transitive group is any group that has a direct or indirect membership to the member. Actor must have view permissions all transitive groups.

- searchTransitiveGroups_next(previous_request, previous_response)

+ searchTransitiveGroups_next()

Retrieves the next page of results.

searchTransitiveMemberships(parent, pageSize=None, pageToken=None, x__xgafv=None)

Search transitive memberships of a group. **Note:** This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. A transitive membership is any direct or indirect membership of a group. Actor must have view permissions to all transitive memberships.

- searchTransitiveMemberships_next(previous_request, previous_response)

+ searchTransitiveMemberships_next()

Retrieves the next page of results.

Method Details

@@ -386,17 +386,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -556,17 +556,17 @@

Method Details

- searchDirectGroups_next(previous_request, previous_response) + searchDirectGroups_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)
+        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.
-
+ 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. +
@@ -611,17 +611,17 @@

Method Details

- searchTransitiveGroups_next(previous_request, previous_response) + searchTransitiveGroups_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)
+        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.
-
+ 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. +
@@ -663,17 +663,17 @@

Method Details

- searchTransitiveMemberships_next(previous_request, previous_response) + searchTransitiveMemberships_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)
+        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.
-
+ 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/cloudidentity_v1beta1.html b/docs/dyn/cloudidentity_v1beta1.html index 74fa970a8f..a16582f709 100644 --- a/docs/dyn/cloudidentity_v1beta1.html +++ b/docs/dyn/cloudidentity_v1beta1.html @@ -123,7 +123,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -132,20 +132,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html b/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html index 9ffa58edc4..f6543194f8 100644 --- a/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html +++ b/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InboundOidcSsoProfile objects for a Google enterprise customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.html b/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.html index 5711642892..c5380ba35f 100644 --- a/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.html +++ b/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.html @@ -95,7 +95,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InboundSamlSsoProfiles for a customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.idpCredentials.html b/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.idpCredentials.html index 618514f96c..3b6bc9f89e 100644 --- a/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.idpCredentials.html +++ b/docs/dyn/cloudidentity_v1beta1.inboundSamlSsoProfiles.idpCredentials.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of IdpCredentials in an InboundSamlSsoProfile.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudidentity_v1beta1.inboundSsoAssignments.html b/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html index d921c26ed1..c13d81a776 100644 --- a/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html +++ b/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the InboundSsoAssignments for a `Customer`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.orgUnits.memberships.html b/docs/dyn/cloudidentity_v1beta1.orgUnits.memberships.html index 6b783ba79b..5296301b8a 100644 --- a/docs/dyn/cloudidentity_v1beta1.orgUnits.memberships.html +++ b/docs/dyn/cloudidentity_v1beta1.orgUnits.memberships.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, customer=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List OrgMembership resources in an OrgUnit treated as 'parent'. Parent format: orgUnits/{$orgUnitId} where `$orgUnitId` is the `orgUnitId` from the [Admin SDK `OrgUnit` resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/orgunits)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudidentity_v1beta1.policies.html b/docs/dyn/cloudidentity_v1beta1.policies.html index 240fdf4f2a..4be51a64ab 100644 --- a/docs/dyn/cloudidentity_v1beta1.policies.html +++ b/docs/dyn/cloudidentity_v1beta1.policies.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.html b/docs/dyn/cloudkms_v1.html index 690884beb6..20075d76e7 100644 --- a/docs/dyn/cloudkms_v1.html +++ b/docs/dyn/cloudkms_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudkms_v1.projects.locations.ekmConnections.html b/docs/dyn/cloudkms_v1.projects.locations.ekmConnections.html index 023913d692..d6c43078c7 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.ekmConnections.html +++ b/docs/dyn/cloudkms_v1.projects.locations.ekmConnections.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists EkmConnections.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -338,17 +338,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.html b/docs/dyn/cloudkms_v1.projects.locations.html index 863392fb19..b4b1921402 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.html +++ b/docs/dyn/cloudkms_v1.projects.locations.html @@ -125,7 +125,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateEkmConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html b/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html index e93d72f151..8d9af360b3 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyHandles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists KeyHandles.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html index f0213f2b20..591aa81c78 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html @@ -114,7 +114,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists CryptoKeyVersions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

macSign(name, body=None, x__xgafv=None)

@@ -740,17 +740,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html index d2bc77568f..2cfca1b426 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, versionView=None, x__xgafv=None)

Lists CryptoKeys.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -583,17 +583,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.html index fae185e4e2..cc0edc32c9 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists KeyRings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.importJobs.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.importJobs.html index 512eef43f8..1a9457bb34 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.importJobs.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.importJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ImportJobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -347,17 +347,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudkms_v1.projects.locations.retiredResources.html b/docs/dyn/cloudkms_v1.projects.locations.retiredResources.html index 8efd9f5318..a9506b1662 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.retiredResources.html +++ b/docs/dyn/cloudkms_v1.projects.locations.retiredResources.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the RetiredResources which are the records of deleted CryptoKeys. RetiredResources prevent the reuse of these resource names after deletion.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudkms_v1.projects.locations.singleTenantHsmInstances.html b/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.html index d2326f28a6..bd059b600d 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.html +++ b/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists SingleTenantHsmInstances.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudkms_v1.projects.locations.singleTenantHsmInstances.proposals.html b/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.proposals.html index d1c03fd17a..400fb6ebe1 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.proposals.html +++ b/docs/dyn/cloudkms_v1.projects.locations.singleTenantHsmInstances.proposals.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists SingleTenantHsmInstanceProposals.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -485,17 +485,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudlocationfinder_v1.html b/docs/dyn/cloudlocationfinder_v1.html index fbdb77f2ba..91ddb7c55f 100644 --- a/docs/dyn/cloudlocationfinder_v1.html +++ b/docs/dyn/cloudlocationfinder_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudlocationfinder_v1.projects.locations.cloudLocations.html b/docs/dyn/cloudlocationfinder_v1.projects.locations.cloudLocations.html index dc245e347c..bbc77eff1e 100644 --- a/docs/dyn/cloudlocationfinder_v1.projects.locations.cloudLocations.html +++ b/docs/dyn/cloudlocationfinder_v1.projects.locations.cloudLocations.html @@ -84,13 +84,13 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists cloud locations under a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, pageSize=None, pageToken=None, query=None, sourceCloudLocation=None, x__xgafv=None)

Searches for cloud locations from a given source location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -163,17 +163,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -214,17 +214,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudlocationfinder_v1.projects.locations.html b/docs/dyn/cloudlocationfinder_v1.projects.locations.html index 8f172d65bc..16dcb0a4e4 100644 --- a/docs/dyn/cloudlocationfinder_v1.projects.locations.html +++ b/docs/dyn/cloudlocationfinder_v1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudlocationfinder_v1alpha.html b/docs/dyn/cloudlocationfinder_v1alpha.html index 3456a9671c..53b218efe2 100644 --- a/docs/dyn/cloudlocationfinder_v1alpha.html +++ b/docs/dyn/cloudlocationfinder_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.cloudLocations.html b/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.cloudLocations.html index 34ea380f75..d388f2e034 100644 --- a/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.cloudLocations.html +++ b/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.cloudLocations.html @@ -84,13 +84,13 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists cloud locations under a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, pageSize=None, pageToken=None, query=None, sourceCloudLocation=None, x__xgafv=None)

Searches for cloud locations from a given source location.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -163,17 +163,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -214,17 +214,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudlocationfinder_v1alpha.projects.locations.html b/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.html index c10f91bf52..f08a4e7d0b 100644 --- a/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.html +++ b/docs/dyn/cloudlocationfinder_v1alpha.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudnumberregistry_v1alpha.html b/docs/dyn/cloudnumberregistry_v1alpha.html index 761b8cdb33..713780fdca 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.operations.html b/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.operations.html index 5eae545971..6e5d0400aa 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.operations.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudnumberregistry_v1alpha.organizations.locations.orgNumberRegistries.html b/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.orgNumberRegistries.html index 3eb06321bc..248faad87e 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.orgNumberRegistries.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.organizations.locations.orgNumberRegistries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists OrgNumberRegistries in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudnumberregistry_v1alpha.projects.locations.customRanges.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.customRanges.html index 7400d41abc..d0c1bb8f4b 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.customRanges.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.customRanges.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CustomRanges in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -308,17 +308,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.discoveredRanges.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.discoveredRanges.html index 147310ccd1..d642e11a27 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.discoveredRanges.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.discoveredRanges.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DiscoveredRanges in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

showUtilization(name, x__xgafv=None)

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.html index bae6328406..648cce03b1 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.html @@ -114,7 +114,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudnumberregistry_v1alpha.projects.locations.ipamAdminScopes.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.ipamAdminScopes.html index 52990f4c43..2eb718ae5f 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.ipamAdminScopes.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.ipamAdminScopes.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists IpamAdminScopes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.operations.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.operations.html index c27f89bc9c..ffcea2d5f9 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.operations.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudnumberregistry_v1alpha.projects.locations.realms.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.realms.html index 4eac555096..3e172a88ed 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.realms.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.realms.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Realms in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -314,17 +314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.registryBooks.html b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.registryBooks.html index 0ef75b2d1f..7042323006 100644 --- a/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.registryBooks.html +++ b/docs/dyn/cloudnumberregistry_v1alpha.projects.locations.registryBooks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists RegistryBooks in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

searchIpResources(name, body=None, x__xgafv=None)

Searches IP resources in a given RegistryBook.

- searchIpResources_next(previous_request, previous_response)

+ searchIpResources_next()

Retrieves the next page of results.

Method Details

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -581,17 +581,17 @@

Method Details

- searchIpResources_next(previous_request, previous_response) + searchIpResources_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)
+        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.
-
+ 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/cloudproductregistry_v1.html b/docs/dyn/cloudproductregistry_v1.html index 20c801f687..8f09abc806 100644 --- a/docs/dyn/cloudproductregistry_v1.html +++ b/docs/dyn/cloudproductregistry_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudproductregistry_v1.logicalProducts.html b/docs/dyn/cloudproductregistry_v1.logicalProducts.html index 863e72c073..c391e92919 100644 --- a/docs/dyn/cloudproductregistry_v1.logicalProducts.html +++ b/docs/dyn/cloudproductregistry_v1.logicalProducts.html @@ -89,7 +89,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists LogicalProducts matching given criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupEntity(lookupUri, x__xgafv=None)

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudproductregistry_v1.logicalProducts.variants.html b/docs/dyn/cloudproductregistry_v1.logicalProducts.variants.html index f394174093..60915587b3 100644 --- a/docs/dyn/cloudproductregistry_v1.logicalProducts.variants.html +++ b/docs/dyn/cloudproductregistry_v1.logicalProducts.variants.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists LogicalProductVariants matching given criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupEntity(lookupUri, x__xgafv=None)

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudproductregistry_v1.productSuites.html b/docs/dyn/cloudproductregistry_v1.productSuites.html index 31c2439b69..b9f7023cf6 100644 --- a/docs/dyn/cloudproductregistry_v1.productSuites.html +++ b/docs/dyn/cloudproductregistry_v1.productSuites.html @@ -84,7 +84,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists ProductSuites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupEntity(lookupUri, x__xgafv=None)

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudprofiler_v2.html b/docs/dyn/cloudprofiler_v2.html index aa9c4eb963..642c6c5e0a 100644 --- a/docs/dyn/cloudprofiler_v2.html +++ b/docs/dyn/cloudprofiler_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudprofiler_v2.projects.profiles.html b/docs/dyn/cloudprofiler_v2.projects.profiles.html index ecf02c2743..0fcf93b8ca 100644 --- a/docs/dyn/cloudprofiler_v2.projects.profiles.html +++ b/docs/dyn/cloudprofiler_v2.projects.profiles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists profiles which have been collected so far and for which the caller has permission to view.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v1.folders.html b/docs/dyn/cloudresourcemanager_v1.folders.html index 12330ea70b..a703f01bef 100644 --- a/docs/dyn/cloudresourcemanager_v1.folders.html +++ b/docs/dyn/cloudresourcemanager_v1.folders.html @@ -90,13 +90,13 @@

Instance Methods

listAvailableOrgPolicyConstraints(resource, body=None, x__xgafv=None)

Lists `Constraints` that could be applied on the specified resource.

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response)

+ listAvailableOrgPolicyConstraints_next()

Retrieves the next page of results.

listOrgPolicies(resource, body=None, x__xgafv=None)

Lists all the `Policies` set for a particular resource.

- listOrgPolicies_next(previous_request, previous_response)

+ listOrgPolicies_next()

Retrieves the next page of results.

setOrgPolicy(resource, body=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response) + listAvailableOrgPolicyConstraints_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)
+        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.
-
+ 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. +
@@ -331,17 +331,17 @@

Method Details

- listOrgPolicies_next(previous_request, previous_response) + listOrgPolicies_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v1.html b/docs/dyn/cloudresourcemanager_v1.html index bc81b03303..a37b642f2e 100644 --- a/docs/dyn/cloudresourcemanager_v1.html +++ b/docs/dyn/cloudresourcemanager_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudresourcemanager_v1.liens.html b/docs/dyn/cloudresourcemanager_v1.liens.html index ca55fdf876..53ff32e936 100644 --- a/docs/dyn/cloudresourcemanager_v1.liens.html +++ b/docs/dyn/cloudresourcemanager_v1.liens.html @@ -90,7 +90,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

List all Liens applied to the `parent` resource. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.get`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudresourcemanager_v1.organizations.html b/docs/dyn/cloudresourcemanager_v1.organizations.html index 80a547080f..c6bf68d2a4 100644 --- a/docs/dyn/cloudresourcemanager_v1.organizations.html +++ b/docs/dyn/cloudresourcemanager_v1.organizations.html @@ -96,19 +96,19 @@

Instance Methods

listAvailableOrgPolicyConstraints(resource, body=None, x__xgafv=None)

Lists `Constraints` that could be applied on the specified resource.

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response)

+ listAvailableOrgPolicyConstraints_next()

Retrieves the next page of results.

listOrgPolicies(resource, body=None, x__xgafv=None)

Lists all the `Policies` set for a particular resource.

- listOrgPolicies_next(previous_request, previous_response)

+ listOrgPolicies_next()

Retrieves the next page of results.

search(body=None, x__xgafv=None)

Searches Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the results. Search will only return organizations on which the user has the permission `resourcemanager.organizations.get` or has super admin privileges.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -365,17 +365,17 @@

Method Details

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response) + listAvailableOrgPolicyConstraints_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)
+        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.
-
+ 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. +
@@ -430,17 +430,17 @@

Method Details

- listOrgPolicies_next(previous_request, previous_response) + listOrgPolicies_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)
+        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.
-
+ 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. +
@@ -482,17 +482,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v1.projects.html b/docs/dyn/cloudresourcemanager_v1.projects.html index 8033eb6641..4ae182acef 100644 --- a/docs/dyn/cloudresourcemanager_v1.projects.html +++ b/docs/dyn/cloudresourcemanager_v1.projects.html @@ -108,16 +108,16 @@

Instance Methods

listAvailableOrgPolicyConstraints(resource, body=None, x__xgafv=None)

Lists `Constraints` that could be applied on the specified resource.

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response)

+ listAvailableOrgPolicyConstraints_next()

Retrieves the next page of results.

listOrgPolicies(resource, body=None, x__xgafv=None)

Lists all the `Policies` set for a particular resource.

- listOrgPolicies_next(previous_request, previous_response)

+ listOrgPolicies_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -545,17 +545,17 @@

Method Details

- listAvailableOrgPolicyConstraints_next(previous_request, previous_response) + listAvailableOrgPolicyConstraints_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)
+        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.
-
+ 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. +
@@ -610,31 +610,31 @@

Method Details

- listOrgPolicies_next(previous_request, previous_response) + listOrgPolicies_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v1beta1.html b/docs/dyn/cloudresourcemanager_v1beta1.html index 098d873824..14cbd61d58 100644 --- a/docs/dyn/cloudresourcemanager_v1beta1.html +++ b/docs/dyn/cloudresourcemanager_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudresourcemanager_v1beta1.organizations.html b/docs/dyn/cloudresourcemanager_v1beta1.organizations.html index c806c41f3e..454831e112 100644 --- a/docs/dyn/cloudresourcemanager_v1beta1.organizations.html +++ b/docs/dyn/cloudresourcemanager_v1beta1.organizations.html @@ -87,7 +87,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v1beta1.projects.html b/docs/dyn/cloudresourcemanager_v1beta1.projects.html index 25cd588cc5..b142f5569d 100644 --- a/docs/dyn/cloudresourcemanager_v1beta1.projects.html +++ b/docs/dyn/cloudresourcemanager_v1beta1.projects.html @@ -96,7 +96,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Projects that the caller has the `resourcemanager.projects.get` permission on and satisfy the specified filter. This method returns Projects in an unspecified order. This method is eventually consistent with project mutations; this means that a newly created project may not appear in the results or recent updates to an existing project may not be reflected in the results. To retrieve the latest state of a project, use the GetProject method. NOTE: If the request filter contains a `parent.type` and `parent.id` and the caller has the `resourcemanager.projects.list` permission on the parent, the results will be drawn from an alternate index which provides more consistent results. In future versions of this API, this List method will be split into List and Search to properly capture the behavioral difference.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -354,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v2.folders.html b/docs/dyn/cloudresourcemanager_v2.folders.html index dd48a157f5..cbee20f578 100644 --- a/docs/dyn/cloudresourcemanager_v2.folders.html +++ b/docs/dyn/cloudresourcemanager_v2.folders.html @@ -93,7 +93,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, showDeleted=None, x__xgafv=None)

Lists the Folders that are direct descendants of supplied parent resource. List provides a strongly consistent view of the Folders underneath the specified parent resource. List returns Folders sorted based upon the (ascending) lexical ordering of their display_name. The caller must have `resourcemanager.folders.list` permission on the identified parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -105,7 +105,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Search for folders that match specific filter criteria. Search provides an eventually consistent view of the folders a user has access to which meet the specified filter criteria. This will only return folders on which the caller has the permission `resourcemanager.folders.get`.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -330,17 +330,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -478,17 +478,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v2.html b/docs/dyn/cloudresourcemanager_v2.html index d3e3e21d3e..083e6ff687 100644 --- a/docs/dyn/cloudresourcemanager_v2.html +++ b/docs/dyn/cloudresourcemanager_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudresourcemanager_v2beta1.folders.html b/docs/dyn/cloudresourcemanager_v2beta1.folders.html index b8df40d526..575ad4a665 100644 --- a/docs/dyn/cloudresourcemanager_v2beta1.folders.html +++ b/docs/dyn/cloudresourcemanager_v2beta1.folders.html @@ -93,7 +93,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, showDeleted=None, x__xgafv=None)

Lists the Folders that are direct descendants of supplied parent resource. List provides a strongly consistent view of the Folders underneath the specified parent resource. List returns Folders sorted based upon the (ascending) lexical ordering of their display_name. The caller must have `resourcemanager.folders.list` permission on the identified parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -105,7 +105,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Search for folders that match specific filter criteria. Search provides an eventually consistent view of the folders a user has access to which meet the specified filter criteria. This will only return folders on which the caller has the permission `resourcemanager.folders.get`.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -330,17 +330,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -478,17 +478,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v2beta1.html b/docs/dyn/cloudresourcemanager_v2beta1.html index e20a0b0b0a..8dc17078be 100644 --- a/docs/dyn/cloudresourcemanager_v2beta1.html +++ b/docs/dyn/cloudresourcemanager_v2beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudresourcemanager_v3.effectiveTags.html b/docs/dyn/cloudresourcemanager_v3.effectiveTags.html index f1f6209739..bfa189c3da 100644 --- a/docs/dyn/cloudresourcemanager_v3.effectiveTags.html +++ b/docs/dyn/cloudresourcemanager_v3.effectiveTags.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Return a list of effective tags for the given Google Cloud resource, as specified in `parent`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudresourcemanager_v3.folders.capabilityConfigs.html b/docs/dyn/cloudresourcemanager_v3.folders.capabilityConfigs.html index 50b3de908f..c9cecdcd79 100644 --- a/docs/dyn/cloudresourcemanager_v3.folders.capabilityConfigs.html +++ b/docs/dyn/cloudresourcemanager_v3.folders.capabilityConfigs.html @@ -85,12 +85,12 @@

Instance Methods

Deletes the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

get(name, x__xgafv=None)

-

Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

+

Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists CapabilityConfigs that are direct children of the specified organization, folder or project resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` @@ -193,7 +193,7 @@

Method Details

get(name, x__xgafv=None) - 
Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
+  
Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
 
 Args:
   name: string, Required. The name of the CapabilityConfig to retrieve. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` Example: `folders/123456789/capabilityConfigs/my-capability-config` (required)
@@ -210,7 +210,7 @@ 
Method Details

     "A String",
   ],
   "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
   "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
   "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
   "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -245,7 +245,7 @@ 
Method Details

         "A String",
       ],
       "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
       "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
       "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
       "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -261,17 +261,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -288,7 +288,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` diff --git a/docs/dyn/cloudresourcemanager_v3.folders.html b/docs/dyn/cloudresourcemanager_v3.folders.html index 32f35b3e0f..30206a0b3e 100644 --- a/docs/dyn/cloudresourcemanager_v3.folders.html +++ b/docs/dyn/cloudresourcemanager_v3.folders.html @@ -103,7 +103,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, showDeleted=None, x__xgafv=None)

Lists the folders that are direct descendants of supplied parent resource. `list()` provides a strongly consistent view of the folders underneath the specified parent resource. `list()` returns folders sorted based upon the (ascending) lexical ordering of their display_name. The caller must have `resourcemanager.folders.list` permission on the identified parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Instance Methods

search(pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search for folders that match specific filter criteria. `search()` provides an eventually consistent view of the folders a user has access to which meet the specified filter criteria. This will only return folders on which the caller has the permission `resourcemanager.folders.get`.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -353,17 +353,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -506,17 +506,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v3.html b/docs/dyn/cloudresourcemanager_v3.html index 0f54d9f3a2..0ab14f3a1b 100644 --- a/docs/dyn/cloudresourcemanager_v3.html +++ b/docs/dyn/cloudresourcemanager_v3.html @@ -133,7 +133,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -142,20 +142,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudresourcemanager_v3.liens.html b/docs/dyn/cloudresourcemanager_v3.liens.html index ca3a489fd5..1b5f3493e4 100644 --- a/docs/dyn/cloudresourcemanager_v3.liens.html +++ b/docs/dyn/cloudresourcemanager_v3.liens.html @@ -90,7 +90,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

List all Liens applied to the `parent` resource. Callers of this method will require permission on the `parent` resource. For example, a Lien with a `parent` of `projects/1234` requires permission `resourcemanager.projects.get`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudresourcemanager_v3.organizations.capabilityConfigs.html b/docs/dyn/cloudresourcemanager_v3.organizations.capabilityConfigs.html index 014714d364..47864074af 100644 --- a/docs/dyn/cloudresourcemanager_v3.organizations.capabilityConfigs.html +++ b/docs/dyn/cloudresourcemanager_v3.organizations.capabilityConfigs.html @@ -85,12 +85,12 @@

Instance Methods

Deletes the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

get(name, x__xgafv=None)

-

Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

+

Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists CapabilityConfigs that are direct children of the specified organization, folder or project resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` @@ -193,7 +193,7 @@

Method Details

get(name, x__xgafv=None) - 
Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
+  
Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
 
 Args:
   name: string, Required. The name of the CapabilityConfig to retrieve. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` Example: `folders/123456789/capabilityConfigs/my-capability-config` (required)
@@ -210,7 +210,7 @@ 
Method Details

     "A String",
   ],
   "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
   "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
   "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
   "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -245,7 +245,7 @@ 
Method Details

         "A String",
       ],
       "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
       "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
       "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
       "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -261,17 +261,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -288,7 +288,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` diff --git a/docs/dyn/cloudresourcemanager_v3.organizations.html b/docs/dyn/cloudresourcemanager_v3.organizations.html index 90ae404aa8..fb618f92a2 100644 --- a/docs/dyn/cloudresourcemanager_v3.organizations.html +++ b/docs/dyn/cloudresourcemanager_v3.organizations.html @@ -92,7 +92,7 @@

Instance Methods

search(pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches organization resources that are visible to the user and satisfy the specified filter. This method returns organizations in an unspecified order. New organizations do not necessarily appear at the end of the results, and may take a small amount of time to appear. Search will only return organizations on which the user has the permission `resourcemanager.organizations.get` or has super admin privileges.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -222,17 +222,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v3.projects.capabilityConfigs.html b/docs/dyn/cloudresourcemanager_v3.projects.capabilityConfigs.html index 5776bca0bc..9b6b22eb0e 100644 --- a/docs/dyn/cloudresourcemanager_v3.projects.capabilityConfigs.html +++ b/docs/dyn/cloudresourcemanager_v3.projects.capabilityConfigs.html @@ -85,12 +85,12 @@

Instance Methods

Deletes the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

get(name, x__xgafv=None)

-

Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

+

Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists CapabilityConfigs that are direct children of the specified organization, folder or project resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` @@ -193,7 +193,7 @@

Method Details

get(name, x__xgafv=None) - 
Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
+  
Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).
 
 Args:
   name: string, Required. The name of the CapabilityConfig to retrieve. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` Example: `folders/123456789/capabilityConfigs/my-capability-config` (required)
@@ -210,7 +210,7 @@ 
Method Details

     "A String",
   ],
   "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+  "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
   "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
   "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
   "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -245,7 +245,7 @@ 
Method Details

         "A String",
       ],
       "createTime": "A String", # Output only. The creation time of the CapabilityConfig.
-      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`
+      "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`
       "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
       "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012`
       "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}`
@@ -261,17 +261,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -288,7 +288,7 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the CapabilityConfig. - "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config` + "displayName": "A String", # Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig` "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "managementProject": "A String", # Optional. Immutable. The Management Project associated with this CapabilityConfig. If not provided during creation, a management project will be automatically created. Cannot be modified after creation. Format: `projects/{project_number}` Example: `projects/123456789012` "name": "A String", # Identifier. The unique resource name of the CapabilityConfig. Format: `organizations/{organization}/capabilityConfigs/{capabilityConfig}` or, `folders/{folder}/capabilityConfigs/{capabilityConfig}` or, `projects/{project}/capabilityConfigs/{capabilityConfig}` diff --git a/docs/dyn/cloudresourcemanager_v3.projects.html b/docs/dyn/cloudresourcemanager_v3.projects.html index c9c4b4e043..c008ece099 100644 --- a/docs/dyn/cloudresourcemanager_v3.projects.html +++ b/docs/dyn/cloudresourcemanager_v3.projects.html @@ -98,7 +98,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, showDeleted=None, x__xgafv=None)

Lists projects that are direct children of the specified folder or organization resource. `list()` provides a strongly consistent view of the projects underneath the specified parent resource. `list()` returns projects sorted based upon the (ascending) lexical ordering of their `display_name`. The caller must have `resourcemanager.projects.list` permission on the identified parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

search(pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search for projects that the caller has the `resourcemanager.projects.get` permission on, and also satisfy the specified query. This method returns projects in an unspecified order. This method is eventually consistent with project mutations; this means that a newly created project may not appear in the results or recent updates to an existing project may not be reflected in the results. To retrieve the latest state of a project, use the GetProject method.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -521,17 +521,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v3.tagBindings.html b/docs/dyn/cloudresourcemanager_v3.tagBindings.html index 382898cd3d..d8faa4b35d 100644 --- a/docs/dyn/cloudresourcemanager_v3.tagBindings.html +++ b/docs/dyn/cloudresourcemanager_v3.tagBindings.html @@ -87,7 +87,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists the TagBindings for the given Google Cloud resource, as specified with `parent`. NOTE: The `parent` field is expected to be a full resource name: https://cloud.google.com/apis/design/resource_names#full_resource_name

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudresourcemanager_v3.tagKeys.html b/docs/dyn/cloudresourcemanager_v3.tagKeys.html index c3b8df56a5..74305a1e1f 100644 --- a/docs/dyn/cloudresourcemanager_v3.tagKeys.html +++ b/docs/dyn/cloudresourcemanager_v3.tagKeys.html @@ -96,7 +96,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists all TagKeys for a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -361,17 +361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v3.tagValues.html b/docs/dyn/cloudresourcemanager_v3.tagValues.html index bb48846a38..0256af4611 100644 --- a/docs/dyn/cloudresourcemanager_v3.tagValues.html +++ b/docs/dyn/cloudresourcemanager_v3.tagValues.html @@ -101,7 +101,7 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists all TagValues for a specific TagKey.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudresourcemanager_v3.tagValues.tagHolds.html b/docs/dyn/cloudresourcemanager_v3.tagValues.tagHolds.html index a2c16d7acf..a252fb1bbb 100644 --- a/docs/dyn/cloudresourcemanager_v3.tagValues.tagHolds.html +++ b/docs/dyn/cloudresourcemanager_v3.tagValues.tagHolds.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TagHolds under a TagValue.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -210,17 +210,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudscheduler_v1.html b/docs/dyn/cloudscheduler_v1.html index 83c04e6587..cebf73c9ff 100644 --- a/docs/dyn/cloudscheduler_v1.html +++ b/docs/dyn/cloudscheduler_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudscheduler_v1.projects.locations.html b/docs/dyn/cloudscheduler_v1.projects.locations.html index 4d70166021..30c155f283 100644 --- a/docs/dyn/cloudscheduler_v1.projects.locations.html +++ b/docs/dyn/cloudscheduler_v1.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateCmekConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudscheduler_v1.projects.locations.jobs.html b/docs/dyn/cloudscheduler_v1.projects.locations.jobs.html index aa800cb3d8..d83a33cf0f 100644 --- a/docs/dyn/cloudscheduler_v1.projects.locations.jobs.html +++ b/docs/dyn/cloudscheduler_v1.projects.locations.jobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudscheduler_v1.projects.locations.operations.html b/docs/dyn/cloudscheduler_v1.projects.locations.operations.html index 626ef33d4f..26c9910d19 100644 --- a/docs/dyn/cloudscheduler_v1.projects.locations.operations.html +++ b/docs/dyn/cloudscheduler_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudscheduler_v1beta1.html b/docs/dyn/cloudscheduler_v1beta1.html index 5915660347..86c955a937 100644 --- a/docs/dyn/cloudscheduler_v1beta1.html +++ b/docs/dyn/cloudscheduler_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudscheduler_v1beta1.projects.locations.html b/docs/dyn/cloudscheduler_v1beta1.projects.locations.html index 43fef6e3d2..50872ef5fd 100644 --- a/docs/dyn/cloudscheduler_v1beta1.projects.locations.html +++ b/docs/dyn/cloudscheduler_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudscheduler_v1beta1.projects.locations.jobs.html b/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html index fed9f4bad2..03e0153e2c 100644 --- a/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html +++ b/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, legacyAppEngineCron=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudscheduler_v1beta1.projects.locations.operations.html b/docs/dyn/cloudscheduler_v1beta1.projects.locations.operations.html index 90b36b41da..105dc44f4a 100644 --- a/docs/dyn/cloudscheduler_v1beta1.projects.locations.operations.html +++ b/docs/dyn/cloudscheduler_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsearch_v1.debug.datasources.items.html b/docs/dyn/cloudsearch_v1.debug.datasources.items.html index 07afbd2593..925752b040 100644 --- a/docs/dyn/cloudsearch_v1.debug.datasources.items.html +++ b/docs/dyn/cloudsearch_v1.debug.datasources.items.html @@ -89,7 +89,7 @@

Instance Methods

searchByViewUrl(name, body=None, x__xgafv=None)

Fetches the item whose viewUrl exactly matches that of the URL provided in the request. **Note:** This API requires an admin account to execute.

- searchByViewUrl_next(previous_request, previous_response)

+ searchByViewUrl_next()

Retrieves the next page of results.

Method Details

@@ -332,17 +332,17 @@

Method Details

- searchByViewUrl_next(previous_request, previous_response) + searchByViewUrl_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)
+        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.
-
+ 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/cloudsearch_v1.debug.datasources.items.unmappedids.html b/docs/dyn/cloudsearch_v1.debug.datasources.items.unmappedids.html index 07c0eb375e..c1f90b6681 100644 --- a/docs/dyn/cloudsearch_v1.debug.datasources.items.unmappedids.html +++ b/docs/dyn/cloudsearch_v1.debug.datasources.items.unmappedids.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, debugOptions_enableDebugging=None, pageSize=None, pageToken=None, x__xgafv=None)

List all unmapped identities for a specific item. **Note:** This API requires an admin account to execute.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsearch_v1.debug.identitysources.items.html b/docs/dyn/cloudsearch_v1.debug.identitysources.items.html index eaed048a7a..8ccf98cbc9 100644 --- a/docs/dyn/cloudsearch_v1.debug.identitysources.items.html +++ b/docs/dyn/cloudsearch_v1.debug.identitysources.items.html @@ -81,7 +81,7 @@

Instance Methods

listForunmappedidentity(parent, debugOptions_enableDebugging=None, groupResourceName=None, pageSize=None, pageToken=None, userResourceName=None, x__xgafv=None)

Lists names of items associated with an unmapped identity. **Note:** This API requires an admin account to execute.

- listForunmappedidentity_next(previous_request, previous_response)

+ listForunmappedidentity_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- listForunmappedidentity_next(previous_request, previous_response) + listForunmappedidentity_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)
+        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.
-
+ 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/cloudsearch_v1.debug.identitysources.unmappedids.html b/docs/dyn/cloudsearch_v1.debug.identitysources.unmappedids.html index 45155bf61c..4201487ce8 100644 --- a/docs/dyn/cloudsearch_v1.debug.identitysources.unmappedids.html +++ b/docs/dyn/cloudsearch_v1.debug.identitysources.unmappedids.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, debugOptions_enableDebugging=None, pageSize=None, pageToken=None, resolutionStatusCode=None, x__xgafv=None)

Lists unmapped user identities for an identity source. **Note:** This API requires an admin account to execute.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -134,17 +134,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsearch_v1.html b/docs/dyn/cloudsearch_v1.html index e1b900e1ab..f0ebc221b6 100644 --- a/docs/dyn/cloudsearch_v1.html +++ b/docs/dyn/cloudsearch_v1.html @@ -118,7 +118,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -127,20 +127,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudsearch_v1.indexing.datasources.items.html b/docs/dyn/cloudsearch_v1.indexing.datasources.items.html index a7dc6e17a1..c93fe9d1bc 100644 --- a/docs/dyn/cloudsearch_v1.indexing.datasources.items.html +++ b/docs/dyn/cloudsearch_v1.indexing.datasources.items.html @@ -93,7 +93,7 @@

Instance Methods

list(name, brief=None, connectorName=None, debugOptions_enableDebugging=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all or a subset of Item resources. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

poll(name, body=None, x__xgafv=None)

@@ -803,17 +803,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudsearch_v1.operations.lro.html b/docs/dyn/cloudsearch_v1.operations.lro.html index d91909073a..566eeb0e94 100644 --- a/docs/dyn/cloudsearch_v1.operations.lro.html +++ b/docs/dyn/cloudsearch_v1.operations.lro.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsearch_v1.query.sources.html b/docs/dyn/cloudsearch_v1.query.sources.html index da9e774653..60a31a37b4 100644 --- a/docs/dyn/cloudsearch_v1.query.sources.html +++ b/docs/dyn/cloudsearch_v1.query.sources.html @@ -81,7 +81,7 @@

Instance Methods

list(pageToken=None, requestOptions_clientDisplayLanguageCode=None, requestOptions_countryCode=None, requestOptions_debugOptions_enableDebugging=None, requestOptions_languageCode=None, requestOptions_searchApplicationId=None, requestOptions_timeZone=None, x__xgafv=None)

Returns list of sources that user can use for Search and Suggest APIs. **Note:** This API requires a standard end user account to execute. A service account can't perform Query API requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](https://developers.google.com/workspace/cloud-search/docs/guides/delegation/).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -143,17 +143,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsearch_v1.settings.datasources.html b/docs/dyn/cloudsearch_v1.settings.datasources.html index 951d6669a5..8eae2e96c4 100644 --- a/docs/dyn/cloudsearch_v1.settings.datasources.html +++ b/docs/dyn/cloudsearch_v1.settings.datasources.html @@ -90,7 +90,7 @@

Instance Methods

list(debugOptions_enableDebugging=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists datasources. **Note:** This API requires an admin account to execute.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, debugOptions_enableDebugging=None, updateMask=None, x__xgafv=None)

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudsearch_v1.settings.searchapplications.html b/docs/dyn/cloudsearch_v1.settings.searchapplications.html index 816ece55e6..830d84fc53 100644 --- a/docs/dyn/cloudsearch_v1.settings.searchapplications.html +++ b/docs/dyn/cloudsearch_v1.settings.searchapplications.html @@ -90,7 +90,7 @@

Instance Methods

list(debugOptions_enableDebugging=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all search applications. **Note:** This API requires an admin account to execute.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -477,17 +477,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudshell_v1.html b/docs/dyn/cloudshell_v1.html index 7ab5deaac4..e60123ab43 100644 --- a/docs/dyn/cloudshell_v1.html +++ b/docs/dyn/cloudshell_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudshell_v1.operations.html b/docs/dyn/cloudshell_v1.operations.html index 92846397ac..464dafa519 100644 --- a/docs/dyn/cloudshell_v1.operations.html +++ b/docs/dyn/cloudshell_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2.caseClassifications.html b/docs/dyn/cloudsupport_v2.caseClassifications.html index f62046c4eb..6691607eb7 100644 --- a/docs/dyn/cloudsupport_v2.caseClassifications.html +++ b/docs/dyn/cloudsupport_v2.caseClassifications.html @@ -81,7 +81,7 @@

Instance Methods

search(pageSize=None, pageToken=None, query=None, x__xgafv=None)

Retrieve valid classifications to use when creating a support case. Classifications are hierarchical. Each classification is a string containing all levels of the hierarchy separated by `" > "`. For example, `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by this endpoint are valid for at least six months. When a classification is deactivated, this endpoint immediately stops returning it. After six months, `case.create` requests using the classification will fail. EXAMPLES: cURL: ```shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ``` Python: ```python import googleapiclient.discovery supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version="v2", discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=v2", ) request = supportApiService.caseClassifications().search( query='display_name:"*Compute Engine*"' ) print(request.execute()) ```

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2.cases.attachments.html b/docs/dyn/cloudsupport_v2.cases.attachments.html index 12f040fe8c..d73f6f2ec2 100644 --- a/docs/dyn/cloudsupport_v2.cases.attachments.html +++ b/docs/dyn/cloudsupport_v2.cases.attachments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2.cases.comments.html b/docs/dyn/cloudsupport_v2.cases.comments.html index a2e97871c4..776bf57deb 100644 --- a/docs/dyn/cloudsupport_v2.cases.comments.html +++ b/docs/dyn/cloudsupport_v2.cases.comments.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the comments associated with a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2.cases.html b/docs/dyn/cloudsupport_v2.cases.html index d4908d1f26..775cbaebfc 100644 --- a/docs/dyn/cloudsupport_v2.cases.html +++ b/docs/dyn/cloudsupport_v2.cases.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve all cases under a parent, but not its children. For example, listing cases under an organization only returns the cases that are directly parented by that organization. To retrieve cases under an organization and its projects, use `cases.search`. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().list(parent="projects/some-project") print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -109,7 +109,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search for cases using a query. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().search( parent="projects/some-project", query="state=OPEN" ) print(request.execute()) ```

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -523,17 +523,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2.html b/docs/dyn/cloudsupport_v2.html index d0cc091ec4..f0d1515f27 100644 --- a/docs/dyn/cloudsupport_v2.html +++ b/docs/dyn/cloudsupport_v2.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudsupport_v2.organizations.supportEventSubscriptions.html b/docs/dyn/cloudsupport_v2.organizations.supportEventSubscriptions.html index a6313ddcd3..9f4531bc74 100644 --- a/docs/dyn/cloudsupport_v2.organizations.supportEventSubscriptions.html +++ b/docs/dyn/cloudsupport_v2.organizations.supportEventSubscriptions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists support event subscriptions. EXAMPLES: cURL: ```shell parent="organizations/123456789" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/supportEventSubscriptions" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.supportEventSubscriptions().list( parent="organizations/123456789" ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudsupport_v2beta.caseClassifications.html b/docs/dyn/cloudsupport_v2beta.caseClassifications.html index 473f4aedc2..8d9cd46da5 100644 --- a/docs/dyn/cloudsupport_v2beta.caseClassifications.html +++ b/docs/dyn/cloudsupport_v2beta.caseClassifications.html @@ -81,7 +81,7 @@

Instance Methods

search(pageSize=None, pageToken=None, product_productLine=None, query=None, x__xgafv=None)

Retrieve valid classifications to use when creating a support case. Classifications are hierarchical. Each classification is a string containing all levels of the hierarchy separated by `" > "`. For example, `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by this endpoint are valid for at least six months. When a classification is deactivated, this endpoint immediately stops returning it. After six months, `case.create` requests using the classification will fail. EXAMPLES: cURL: ```shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ 'https://cloudsupport.googleapis.com/v2beta/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ``` Python: ```python import googleapiclient.discovery supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version="v2beta", discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=v2", ) request = supportApiService.caseClassifications().search( query='display_name:"*Compute Engine*"' ) print(request.execute()) ```

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2beta.cases.attachments.html b/docs/dyn/cloudsupport_v2beta.cases.attachments.html index e61e208b45..d7eb7ea96d 100644 --- a/docs/dyn/cloudsupport_v2beta.cases.attachments.html +++ b/docs/dyn/cloudsupport_v2beta.cases.attachments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2beta/$case/attachments" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2beta.cases.comments.html b/docs/dyn/cloudsupport_v2beta.cases.comments.html index d3d27409ac..71ee5135e6 100644 --- a/docs/dyn/cloudsupport_v2beta.cases.comments.html +++ b/docs/dyn/cloudsupport_v2beta.cases.comments.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the comments associated with a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2beta/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudsupport_v2beta.cases.html b/docs/dyn/cloudsupport_v2beta.cases.html index ca75fc7d26..842c33d41c 100644 --- a/docs/dyn/cloudsupport_v2beta.cases.html +++ b/docs/dyn/cloudsupport_v2beta.cases.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, productLine=None, x__xgafv=None)

Retrieve all cases under a parent, but not its children. For example, listing cases under an organization only returns the cases that are directly parented by that organization. To retrieve cases under an organization and its projects, use `cases.search`. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2beta/$parent/cases" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().list(parent="projects/some-project") print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -109,13 +109,13 @@

Instance Methods

search(pageSize=None, pageToken=None, parent=None, query=None, x__xgafv=None)

Search for cases using a query. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2beta/$parent/cases:search" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().search( parent="projects/some-project", query="state=OPEN" ) print(request.execute()) ```

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

showFeed(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Show items in the feed of this case, including case emails, attachments, and comments.

- showFeed_next(previous_request, previous_response)

+ showFeed_next()

Retrieves the next page of results.

Method Details

@@ -418,17 +418,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -570,17 +570,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -669,17 +669,17 @@

Method Details

- showFeed_next(previous_request, previous_response) + showFeed_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)
+        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.
-
+ 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/cloudsupport_v2beta.html b/docs/dyn/cloudsupport_v2beta.html index 398d47eaa4..440a6f88e4 100644 --- a/docs/dyn/cloudsupport_v2beta.html +++ b/docs/dyn/cloudsupport_v2beta.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudsupport_v2beta.organizations.supportEventSubscriptions.html b/docs/dyn/cloudsupport_v2beta.organizations.supportEventSubscriptions.html index 32c80beb16..bf4c7f3aad 100644 --- a/docs/dyn/cloudsupport_v2beta.organizations.supportEventSubscriptions.html +++ b/docs/dyn/cloudsupport_v2beta.organizations.supportEventSubscriptions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists support event subscriptions. EXAMPLES: cURL: ```shell parent="organizations/123456789" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2beta/$parent/supportEventSubscriptions" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.supportEventSubscriptions().list( parent="organizations/123456789" ) print(request.execute()) ```

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2.html b/docs/dyn/cloudtasks_v2.html index 55664bc67b..dbabb327a1 100644 --- a/docs/dyn/cloudtasks_v2.html +++ b/docs/dyn/cloudtasks_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtasks_v2.projects.locations.html b/docs/dyn/cloudtasks_v2.projects.locations.html index d4d2fc1603..e28b97968e 100644 --- a/docs/dyn/cloudtasks_v2.projects.locations.html +++ b/docs/dyn/cloudtasks_v2.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateCmekConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.html index b57ad9a140..e16768990b 100644 --- a/docs/dyn/cloudtasks_v2.projects.locations.queues.html +++ b/docs/dyn/cloudtasks_v2.projects.locations.queues.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists queues. Queues are returned in lexicographical order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -474,17 +474,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html index 19fc2f1ea7..11e72a2a17 100644 --- a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html +++ b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, responseView=None, x__xgafv=None)

Lists the tasks in a queue. By default, only the BASIC view is retrieved due to performance considerations; response_view controls the subset of information which is returned. The tasks may be returned in any order. The ordering may change at any time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -564,17 +564,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta2.html b/docs/dyn/cloudtasks_v2beta2.html index ccf0717c42..52d0ca7251 100644 --- a/docs/dyn/cloudtasks_v2beta2.html +++ b/docs/dyn/cloudtasks_v2beta2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtasks_v2beta2.projects.locations.html b/docs/dyn/cloudtasks_v2beta2.projects.locations.html index 35acd53e54..73ca52e164 100644 --- a/docs/dyn/cloudtasks_v2beta2.projects.locations.html +++ b/docs/dyn/cloudtasks_v2beta2.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateCmekConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.html b/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.html index 2ffb335e92..929d7e5bd0 100644 --- a/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.html +++ b/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists queues. Queues are returned in lexicographical order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -520,17 +520,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.tasks.html index 5593a36499..5601b0e00b 100644 --- a/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.tasks.html +++ b/docs/dyn/cloudtasks_v2beta2.projects.locations.queues.tasks.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, responseView=None, x__xgafv=None)

Lists the tasks in a queue. By default, only the BASIC view is retrieved due to performance considerations; response_view controls the subset of information which is returned. The tasks may be returned in any order. The ordering may change at any time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

renewLease(name, body=None, x__xgafv=None)

@@ -1060,17 +1060,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta3.html b/docs/dyn/cloudtasks_v2beta3.html index 244b2e3de5..c70bd3b35f 100644 --- a/docs/dyn/cloudtasks_v2beta3.html +++ b/docs/dyn/cloudtasks_v2beta3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtasks_v2beta3.projects.locations.html b/docs/dyn/cloudtasks_v2beta3.projects.locations.html index c6f60d22e1..cdd56969bb 100644 --- a/docs/dyn/cloudtasks_v2beta3.projects.locations.html +++ b/docs/dyn/cloudtasks_v2beta3.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateCmekConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -192,17 +192,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html index 99a48fff3a..3272c88af1 100644 --- a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html +++ b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists queues. Queues are returned in lexicographical order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -524,17 +524,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html index bb7996e816..0f32672648 100644 --- a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html +++ b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, responseView=None, x__xgafv=None)

Lists the tasks in a queue. By default, only the BASIC view is retrieved due to performance considerations; response_view controls the subset of information which is returned. The tasks may be returned in any order. The ordering may change at any time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -797,17 +797,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/cloudtrace_v1.html b/docs/dyn/cloudtrace_v1.html index bd8a70babc..3fa2ab602b 100644 --- a/docs/dyn/cloudtrace_v1.html +++ b/docs/dyn/cloudtrace_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtrace_v1.projects.traces.html b/docs/dyn/cloudtrace_v1.projects.traces.html index 2a799e90b6..cad4df9b6f 100644 --- a/docs/dyn/cloudtrace_v1.projects.traces.html +++ b/docs/dyn/cloudtrace_v1.projects.traces.html @@ -84,7 +84,7 @@

Instance Methods

list(projectId, endTime=None, filter=None, orderBy=None, pageSize=None, pageToken=None, startTime=None, view=None, x__xgafv=None)

Returns a list of traces that match the specified filter conditions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/cloudtrace_v2.html b/docs/dyn/cloudtrace_v2.html index 3f40ddd652..0f5ab327f2 100644 --- a/docs/dyn/cloudtrace_v2.html +++ b/docs/dyn/cloudtrace_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtrace_v2beta1.html b/docs/dyn/cloudtrace_v2beta1.html index 884d255aeb..622891c0d6 100644 --- a/docs/dyn/cloudtrace_v2beta1.html +++ b/docs/dyn/cloudtrace_v2beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/cloudtrace_v2beta1.projects.traceSinks.html b/docs/dyn/cloudtrace_v2beta1.projects.traceSinks.html index 07dfecc3de..1967ebdddc 100644 --- a/docs/dyn/cloudtrace_v2beta1.projects.traceSinks.html +++ b/docs/dyn/cloudtrace_v2beta1.projects.traceSinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all sinks for the parent resource (GCP project).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1.html b/docs/dyn/composer_v1.html index 0fc72db73c..38a05d18a6 100644 --- a/docs/dyn/composer_v1.html +++ b/docs/dyn/composer_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/composer_v1.projects.locations.environments.html b/docs/dyn/composer_v1.projects.locations.environments.html index f5ed56fa5a..c565d9aaec 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.html +++ b/docs/dyn/composer_v1.projects.locations.environments.html @@ -117,7 +117,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List environments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

loadSnapshot(environment, body=None, x__xgafv=None)

@@ -898,17 +898,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsConfigMaps.html b/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsConfigMaps.html index 68561c396b..cd22345aac 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsConfigMaps.html +++ b/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsConfigMaps.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists user workloads ConfigMaps. This method is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsSecrets.html b/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsSecrets.html index 8ac2e3d2f9..d821c01508 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsSecrets.html +++ b/docs/dyn/composer_v1.projects.locations.environments.userWorkloadsSecrets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists user workloads Secrets. This method is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1.projects.locations.environments.workloads.html b/docs/dyn/composer_v1.projects.locations.environments.workloads.html index adadd91cc7..2ecdbad8c0 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.workloads.html +++ b/docs/dyn/composer_v1.projects.locations.environments.workloads.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists workloads in a Cloud Composer environment. Workload is a unit that runs a single Composer component. This method is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/composer_v1.projects.locations.imageVersions.html b/docs/dyn/composer_v1.projects.locations.imageVersions.html index 197341d553..e50dac31bf 100644 --- a/docs/dyn/composer_v1.projects.locations.imageVersions.html +++ b/docs/dyn/composer_v1.projects.locations.imageVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, includePastReleases=None, pageSize=None, pageToken=None, x__xgafv=None)

List ImageVersions for provided location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/composer_v1.projects.locations.operations.html b/docs/dyn/composer_v1.projects.locations.operations.html index 5ac7f8e8e5..512d8bf49f 100644 --- a/docs/dyn/composer_v1.projects.locations.operations.html +++ b/docs/dyn/composer_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/composer_v1beta1.html b/docs/dyn/composer_v1beta1.html index 7e1997ddfe..a2a8c8b9f4 100644 --- a/docs/dyn/composer_v1beta1.html +++ b/docs/dyn/composer_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.html b/docs/dyn/composer_v1beta1.projects.locations.environments.html index dd9896e2a4..f68ff28f9a 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.environments.html +++ b/docs/dyn/composer_v1beta1.projects.locations.environments.html @@ -120,7 +120,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List environments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

loadSnapshot(environment, body=None, x__xgafv=None)

@@ -960,17 +960,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsConfigMaps.html b/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsConfigMaps.html index 827a91c2c6..f9c9f0d09c 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsConfigMaps.html +++ b/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsConfigMaps.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists user workloads ConfigMaps. This method is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsSecrets.html b/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsSecrets.html index 45174c2082..0bb879987c 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsSecrets.html +++ b/docs/dyn/composer_v1beta1.projects.locations.environments.userWorkloadsSecrets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists user workloads Secrets. This method is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.workloads.html b/docs/dyn/composer_v1beta1.projects.locations.environments.workloads.html index 7aa0f88407..54353d1941 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.environments.workloads.html +++ b/docs/dyn/composer_v1beta1.projects.locations.environments.workloads.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists workloads in a Cloud Composer environment. Workload is a unit that runs a single Composer component. This method is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/composer_v1beta1.projects.locations.imageVersions.html b/docs/dyn/composer_v1beta1.projects.locations.imageVersions.html index d12db673f3..01ee239cec 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.imageVersions.html +++ b/docs/dyn/composer_v1beta1.projects.locations.imageVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, includePastReleases=None, pageSize=None, pageToken=None, x__xgafv=None)

List ImageVersions for provided location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -128,17 +128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/composer_v1beta1.projects.locations.operations.html b/docs/dyn/composer_v1beta1.projects.locations.operations.html index ef53cbc25e..3f4fd74bca 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.operations.html +++ b/docs/dyn/composer_v1beta1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.acceleratorPodControllers.html b/docs/dyn/compute_alpha.acceleratorPodControllers.html index ba7d755551..b7051e3d00 100644 --- a/docs/dyn/compute_alpha.acceleratorPodControllers.html +++ b/docs/dyn/compute_alpha.acceleratorPodControllers.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the AcceleratorPodController resources in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, resourceId, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1009,17 +1009,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.acceleratorTypes.html b/docs/dyn/compute_alpha.acceleratorTypes.html index 4297b73491..8ec0913274 100644 --- a/docs/dyn/compute_alpha.acceleratorTypes.html +++ b/docs/dyn/compute_alpha.acceleratorTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of accelerator types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of accelerator types that are available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -337,17 +337,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -634,17 +634,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.addresses.html b/docs/dyn/compute_alpha.addresses.html index b871c2e611..a1749d5e86 100644 --- a/docs/dyn/compute_alpha.addresses.html +++ b/docs/dyn/compute_alpha.addresses.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of addresses.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of addresses contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, region, address, body=None, requestId=None, x__xgafv=None)

@@ -436,17 +436,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1664,17 +1664,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.autoscalers.html b/docs/dyn/compute_alpha.autoscalers.html index c140e506fd..f3b472003c 100644 --- a/docs/dyn/compute_alpha.autoscalers.html +++ b/docs/dyn/compute_alpha.autoscalers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of autoscalers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -720,17 +720,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2806,17 +2806,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.backendBuckets.html b/docs/dyn/compute_alpha.backendBuckets.html index 2f448fecad..80542fd321 100644 --- a/docs/dyn/compute_alpha.backendBuckets.html +++ b/docs/dyn/compute_alpha.backendBuckets.html @@ -81,7 +81,7 @@

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 BackendBucket resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -830,17 +830,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3225,31 +3225,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.backendServices.html b/docs/dyn/compute_alpha.backendServices.html index 9f79bff479..f84c71eee2 100644 --- a/docs/dyn/compute_alpha.backendServices.html +++ b/docs/dyn/compute_alpha.backendServices.html @@ -81,7 +81,7 @@

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 BackendService resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -114,10 +114,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendService, body=None, requestId=None, x__xgafv=None)

@@ -2447,17 +2447,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -12101,31 +12101,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.crossSiteNetworks.html b/docs/dyn/compute_alpha.crossSiteNetworks.html index 8d246dc669..76f8b27200 100644 --- a/docs/dyn/compute_alpha.crossSiteNetworks.html +++ b/docs/dyn/compute_alpha.crossSiteNetworks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the cross-site networks for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -947,17 +947,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.dhcpOptionsConfigs.html b/docs/dyn/compute_alpha.dhcpOptionsConfigs.html index 3096d8daa0..ff12a0533a 100644 --- a/docs/dyn/compute_alpha.dhcpOptionsConfigs.html +++ b/docs/dyn/compute_alpha.dhcpOptionsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the DhcpOptionsConfigs for a project in the given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, dhcpOptionsConfig, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1158,17 +1158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.diskTypes.html b/docs/dyn/compute_alpha.diskTypes.html index 6b75673ac9..4ac4a27445 100644 --- a/docs/dyn/compute_alpha.diskTypes.html +++ b/docs/dyn/compute_alpha.diskTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of disk types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of disk types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -354,17 +354,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -688,17 +688,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.disks.html b/docs/dyn/compute_alpha.disks.html index 7513685de6..a8443beb6a 100644 --- a/docs/dyn/compute_alpha.disks.html +++ b/docs/dyn/compute_alpha.disks.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of persistent disks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)

@@ -117,7 +117,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)

@@ -1281,17 +1281,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -6070,17 +6070,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.externalVpnGateways.html b/docs/dyn/compute_alpha.externalVpnGateways.html index 1b4e36940e..0699c00bc8 100644 --- a/docs/dyn/compute_alpha.externalVpnGateways.html +++ b/docs/dyn/compute_alpha.externalVpnGateways.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of ExternalVpnGateway available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, resource, body=None, x__xgafv=None)

@@ -1143,17 +1143,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.firewallPolicies.html b/docs/dyn/compute_alpha.firewallPolicies.html index 8785ad9d3b..01a368b343 100644 --- a/docs/dyn/compute_alpha.firewallPolicies.html +++ b/docs/dyn/compute_alpha.firewallPolicies.html @@ -120,7 +120,7 @@

Instance Methods

listAssociations(includeInheritedPolicies=None, targetResource=None, x__xgafv=None)

Lists associations of a specified target, i.e., organization or folder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(firewallPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -5279,17 +5279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.firewalls.html b/docs/dyn/compute_alpha.firewalls.html index c3de42c119..01adae029c 100644 --- a/docs/dyn/compute_alpha.firewalls.html +++ b/docs/dyn/compute_alpha.firewalls.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of firewall rules available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewall, body=None, requestId=None, x__xgafv=None)

@@ -1394,17 +1394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.folderGlobalVmExtensionPolicies.html b/docs/dyn/compute_alpha.folderGlobalVmExtensionPolicies.html index 0f3d45ee0a..7fa3668763 100644 --- a/docs/dyn/compute_alpha.folderGlobalVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.folderGlobalVmExtensionPolicies.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(folder, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves the list of all folder level VM Extension Policy resources

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listVmExtensions(folder, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within a folder.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(folder, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1813,31 +1813,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.folderZoneVmExtensionPolicies.html b/docs/dyn/compute_alpha.folderZoneVmExtensionPolicies.html index 2a13575188..d5e6d4ee08 100644 --- a/docs/dyn/compute_alpha.folderZoneVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.folderZoneVmExtensionPolicies.html @@ -96,10 +96,10 @@

Instance Methods

listVmExtensions(folder, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within a specific zone for a folder.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(folder, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1295,31 +1295,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.forwardingRules.html b/docs/dyn/compute_alpha.forwardingRules.html index 450610a25d..c5abde05fc 100644 --- a/docs/dyn/compute_alpha.forwardingRules.html +++ b/docs/dyn/compute_alpha.forwardingRules.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of forwarding rules.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of ForwardingRule resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -821,17 +821,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3211,17 +3211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.futureReservations.html b/docs/dyn/compute_alpha.futureReservations.html index 97121b24eb..c9668c5762 100644 --- a/docs/dyn/compute_alpha.futureReservations.html +++ b/docs/dyn/compute_alpha.futureReservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of future reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the future reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, futureReservation, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -665,17 +665,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2910,17 +2910,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.globalAddresses.html b/docs/dyn/compute_alpha.globalAddresses.html index e2f8196fbe..c1f881824e 100644 --- a/docs/dyn/compute_alpha.globalAddresses.html +++ b/docs/dyn/compute_alpha.globalAddresses.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of global addresses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, address, body=None, requestId=None, x__xgafv=None)

@@ -1335,17 +1335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.globalFolderOperations.html b/docs/dyn/compute_alpha.globalFolderOperations.html index dcf857142a..b530f3666b 100644 --- a/docs/dyn/compute_alpha.globalFolderOperations.html +++ b/docs/dyn/compute_alpha.globalFolderOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(folder, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -810,17 +810,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.globalForwardingRules.html b/docs/dyn/compute_alpha.globalForwardingRules.html index eee1e66c00..f2011a4909 100644 --- a/docs/dyn/compute_alpha.globalForwardingRules.html +++ b/docs/dyn/compute_alpha.globalForwardingRules.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of GlobalForwardingRule resources available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -2479,17 +2479,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.globalNetworkEndpointGroups.html b/docs/dyn/compute_alpha.globalNetworkEndpointGroups.html index 5cc59e7031..018690d860 100644 --- a/docs/dyn/compute_alpha.globalNetworkEndpointGroups.html +++ b/docs/dyn/compute_alpha.globalNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2507,31 +2507,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.globalOperations.html b/docs/dyn/compute_alpha.globalOperations.html index a7ee2841d0..4444af8264 100644 --- a/docs/dyn/compute_alpha.globalOperations.html +++ b/docs/dyn/compute_alpha.globalOperations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all operations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, operation, x__xgafv=None)

@@ -564,17 +564,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1316,17 +1316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.globalOrganizationOperations.html b/docs/dyn/compute_alpha.globalOrganizationOperations.html index ec5419d800..551578e789 100644 --- a/docs/dyn/compute_alpha.globalOrganizationOperations.html +++ b/docs/dyn/compute_alpha.globalOrganizationOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -830,17 +830,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.globalPublicDelegatedPrefixes.html b/docs/dyn/compute_alpha.globalPublicDelegatedPrefixes.html index b87265967f..f2e41fa0cd 100644 --- a/docs/dyn/compute_alpha.globalPublicDelegatedPrefixes.html +++ b/docs/dyn/compute_alpha.globalPublicDelegatedPrefixes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the global PublicDelegatedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1213,17 +1213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.globalVmExtensionPolicies.html b/docs/dyn/compute_alpha.globalVmExtensionPolicies.html index 1701e8af28..052ec1f67a 100644 --- a/docs/dyn/compute_alpha.globalVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.globalVmExtensionPolicies.html @@ -78,7 +78,7 @@

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 VM Extension Policy resources

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listVmExtensions(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within a specific zone for a project.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1813,31 +1813,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.haControllers.html b/docs/dyn/compute_alpha.haControllers.html index 2e8435acad..d6450ad27a 100644 --- a/docs/dyn/compute_alpha.haControllers.html +++ b/docs/dyn/compute_alpha.haControllers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the HaControllers in the specified

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all HaControllers in the specified project in the specified region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, haController, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -725,17 +725,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3132,17 +3132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.healthChecks.html b/docs/dyn/compute_alpha.healthChecks.html index 53c33589d1..55216eb7bc 100644 --- a/docs/dyn/compute_alpha.healthChecks.html +++ b/docs/dyn/compute_alpha.healthChecks.html @@ -78,7 +78,7 @@

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 HealthCheck resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -652,17 +652,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2532,17 +2532,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.hosts.html b/docs/dyn/compute_alpha.hosts.html index a3ebee7e9d..6152bbf5b1 100644 --- a/docs/dyn/compute_alpha.hosts.html +++ b/docs/dyn/compute_alpha.hosts.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, association, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of hosts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -641,17 +641,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.html b/docs/dyn/compute_alpha.html index 48dee88a34..5e146ab98d 100644 --- a/docs/dyn/compute_alpha.html +++ b/docs/dyn/compute_alpha.html @@ -858,7 +858,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -867,20 +867,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/compute_alpha.httpHealthChecks.html b/docs/dyn/compute_alpha.httpHealthChecks.html index cca7b9e9bf..ae7fdc7fbf 100644 --- a/docs/dyn/compute_alpha.httpHealthChecks.html +++ b/docs/dyn/compute_alpha.httpHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -1003,17 +1003,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.httpsHealthChecks.html b/docs/dyn/compute_alpha.httpsHealthChecks.html index 555ad2c721..c34f8eb367 100644 --- a/docs/dyn/compute_alpha.httpsHealthChecks.html +++ b/docs/dyn/compute_alpha.httpsHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpsHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -1015,17 +1015,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.imageViews.html b/docs/dyn/compute_alpha.imageViews.html index 9ad8d4eb9d..e16f7529b2 100644 --- a/docs/dyn/compute_alpha.imageViews.html +++ b/docs/dyn/compute_alpha.imageViews.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns a list of global ImageView resources, with a regional

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1352,17 +1352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.images.html b/docs/dyn/compute_alpha.images.html index 52a2c61020..87327f74d2 100644 --- a/docs/dyn/compute_alpha.images.html +++ b/docs/dyn/compute_alpha.images.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None, zone=None)

Retrieves the list of custom images

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, image, body=None, requestId=None, x__xgafv=None)

@@ -3847,17 +3847,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instanceGroupManagerResizeRequests.html b/docs/dyn/compute_alpha.instanceGroupManagerResizeRequests.html index e12beec393..b6ed05641e 100644 --- a/docs/dyn/compute_alpha.instanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_alpha.instanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resize requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2305,17 +2305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.instanceGroupManagers.html b/docs/dyn/compute_alpha.instanceGroupManagers.html index 1cf2e8a325..c34bd51b16 100644 --- a/docs/dyn/compute_alpha.instanceGroupManagers.html +++ b/docs/dyn/compute_alpha.instanceGroupManagers.html @@ -81,7 +81,7 @@

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 managed instance groups and groups them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)

@@ -120,22 +120,22 @@

Instance Methods

listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given managed

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the instances in the managed instance group. Each instance

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -2646,17 +2646,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -11321,17 +11321,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -12835,17 +12835,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -13053,31 +13053,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instanceGroups.html b/docs/dyn/compute_alpha.instanceGroups.html index 144502b710..9d158acd48 100644 --- a/docs/dyn/compute_alpha.instanceGroups.html +++ b/docs/dyn/compute_alpha.instanceGroups.html @@ -81,7 +81,7 @@

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 instance groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listInstances(project, zone, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group.

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -688,17 +688,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1849,31 +1849,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instanceTemplates.html b/docs/dyn/compute_alpha.instanceTemplates.html index 42d3d59377..94359142cd 100644 --- a/docs/dyn/compute_alpha.instanceTemplates.html +++ b/docs/dyn/compute_alpha.instanceTemplates.html @@ -78,7 +78,7 @@

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 InstanceTemplates resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, view=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1514,17 +1514,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -6370,17 +6370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instances.html b/docs/dyn/compute_alpha.instances.html index ac07bb49a1..f9f7eebce6 100644 --- a/docs/dyn/compute_alpha.instances.html +++ b/docs/dyn/compute_alpha.instances.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the instances in your project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachDisk(project, zone, instance, body=None, forceAttach=None, requestId=None, x__xgafv=None)

@@ -150,16 +150,16 @@

Instance Methods

listReferrers(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resources that refer to the VM instance specified in

- listReferrers_next(previous_request, previous_response)

+ listReferrers_next()

Retrieves the next page of results.

listVmExtensionStates(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions states for a specific instance.

- listVmExtensionStates_next(previous_request, previous_response)

+ listVmExtensionStates_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patchPartnerMetadata(project, zone, instance, body=None, requestId=None, x__xgafv=None)

@@ -3300,17 +3300,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -14681,17 +14681,17 @@

Method Details

- listReferrers_next(previous_request, previous_response) + listReferrers_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)
+        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.
-
+ 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. +
@@ -14855,31 +14855,31 @@

Method Details

- listVmExtensionStates_next(previous_request, previous_response) + listVmExtensionStates_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instantSnapshotGroups.html b/docs/dyn/compute_alpha.instantSnapshotGroups.html index 8ac72baff1..b66f38a0db 100644 --- a/docs/dyn/compute_alpha.instantSnapshotGroups.html +++ b/docs/dyn/compute_alpha.instantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -1375,17 +1375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.instantSnapshots.html b/docs/dyn/compute_alpha.instantSnapshots.html index 8e67573b2b..b7b6e9e9a6 100644 --- a/docs/dyn/compute_alpha.instantSnapshots.html +++ b/docs/dyn/compute_alpha.instantSnapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of instantSnapshots.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -390,17 +390,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1854,17 +1854,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.interconnectAttachmentGroups.html b/docs/dyn/compute_alpha.interconnectAttachmentGroups.html index a11b331fbe..2af1c24569 100644 --- a/docs/dyn/compute_alpha.interconnectAttachmentGroups.html +++ b/docs/dyn/compute_alpha.interconnectAttachmentGroups.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectAttachmentGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectAttachmentGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2538,17 +2538,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.interconnectAttachments.html b/docs/dyn/compute_alpha.interconnectAttachments.html index d21340deae..0447a8c24f 100644 --- a/docs/dyn/compute_alpha.interconnectAttachments.html +++ b/docs/dyn/compute_alpha.interconnectAttachments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of interconnect attachments.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect attachments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, interconnectAttachment, body=None, requestId=None, x__xgafv=None)

@@ -677,17 +677,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2990,17 +2990,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.interconnectGroups.html b/docs/dyn/compute_alpha.interconnectGroups.html index 5a75cd930b..c09f51290d 100644 --- a/docs/dyn/compute_alpha.interconnectGroups.html +++ b/docs/dyn/compute_alpha.interconnectGroups.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2227,17 +2227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.interconnectLocations.html b/docs/dyn/compute_alpha.interconnectLocations.html index c57edf06b2..1ef21a7af8 100644 --- a/docs/dyn/compute_alpha.interconnectLocations.html +++ b/docs/dyn/compute_alpha.interconnectLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect locations available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -439,17 +439,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.interconnectRemoteLocations.html b/docs/dyn/compute_alpha.interconnectRemoteLocations.html index 3f8a7e1ffd..e6734ccf21 100644 --- a/docs/dyn/compute_alpha.interconnectRemoteLocations.html +++ b/docs/dyn/compute_alpha.interconnectRemoteLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect remote locations available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -496,17 +496,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.interconnects.html b/docs/dyn/compute_alpha.interconnects.html index 98760753e0..a9977fea96 100644 --- a/docs/dyn/compute_alpha.interconnects.html +++ b/docs/dyn/compute_alpha.interconnects.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Interconnects available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnect, body=None, requestId=None, x__xgafv=None)

@@ -2277,17 +2277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.licenses.html b/docs/dyn/compute_alpha.licenses.html index aef5d4fae8..fe6c5a86bd 100644 --- a/docs/dyn/compute_alpha.licenses.html +++ b/docs/dyn/compute_alpha.licenses.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of licenses

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1514,17 +1514,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.machineImages.html b/docs/dyn/compute_alpha.machineImages.html index 59c4299e37..9ee48309ab 100644 --- a/docs/dyn/compute_alpha.machineImages.html +++ b/docs/dyn/compute_alpha.machineImages.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine images that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -7244,17 +7244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.machineTypes.html b/docs/dyn/compute_alpha.machineTypes.html index 58a323fd99..edc6fdf281 100644 --- a/docs/dyn/compute_alpha.machineTypes.html +++ b/docs/dyn/compute_alpha.machineTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of machine types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -355,17 +355,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -689,17 +689,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.managedRulesets.html b/docs/dyn/compute_alpha.managedRulesets.html index 99025c1299..dc9d83d00e 100644 --- a/docs/dyn/compute_alpha.managedRulesets.html +++ b/docs/dyn/compute_alpha.managedRulesets.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of all the managed rulesets available.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -292,17 +292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.networkAttachments.html b/docs/dyn/compute_alpha.networkAttachments.html index 297ae21d8b..f35ce22d2a 100644 --- a/docs/dyn/compute_alpha.networkAttachments.html +++ b/docs/dyn/compute_alpha.networkAttachments.html @@ -78,7 +78,7 @@

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 NetworkAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NetworkAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, networkAttachment, body=None, requestId=None, x__xgafv=None)

@@ -359,17 +359,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1734,17 +1734,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.networkEdgeSecurityServices.html b/docs/dyn/compute_alpha.networkEdgeSecurityServices.html index 44ded0765e..e53a76144c 100644 --- a/docs/dyn/compute_alpha.networkEdgeSecurityServices.html +++ b/docs/dyn/compute_alpha.networkEdgeSecurityServices.html @@ -78,7 +78,7 @@

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 NetworkEdgeSecurityService resources available to

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -313,17 +313,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.networkEndpointGroups.html b/docs/dyn/compute_alpha.networkEndpointGroups.html index 6c7da7ca84..29f337868d 100644 --- a/docs/dyn/compute_alpha.networkEndpointGroups.html +++ b/docs/dyn/compute_alpha.networkEndpointGroups.html @@ -78,7 +78,7 @@

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 network endpoint groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

@@ -105,10 +105,10 @@

Instance Methods

listNetworkEndpoints(project, zone, networkEndpointGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

@@ -524,17 +524,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3010,31 +3010,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.networkFirewallPolicies.html b/docs/dyn/compute_alpha.networkFirewallPolicies.html index 71a1095868..ec98898f03 100644 --- a/docs/dyn/compute_alpha.networkFirewallPolicies.html +++ b/docs/dyn/compute_alpha.networkFirewallPolicies.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of network firewall policies, listing network

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cloneRules(project, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

@@ -120,7 +120,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the policies that have been configured for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -2200,17 +2200,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5675,17 +5675,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.networkProfiles.html b/docs/dyn/compute_alpha.networkProfiles.html index 1e81fd3241..1a5eaa7d12 100644 --- a/docs/dyn/compute_alpha.networkProfiles.html +++ b/docs/dyn/compute_alpha.networkProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of network profiles available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.networks.html b/docs/dyn/compute_alpha.networks.html index afcea1be69..d1093c46a1 100644 --- a/docs/dyn/compute_alpha.networks.html +++ b/docs/dyn/compute_alpha.networks.html @@ -102,22 +102,22 @@

Instance Methods

listIpAddresses(project, network, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, types=None, x__xgafv=None)

Lists the internal IP addresses in the specified network.

- listIpAddresses_next(previous_request, previous_response)

+ listIpAddresses_next()

Retrieves the next page of results.

listIpOwners(project, network, filter=None, ipCidrRange=None, maxResults=None, orderBy=None, ownerProjects=None, ownerTypes=None, pageToken=None, returnPartialSuccess=None, subnetName=None, subnetRegion=None, x__xgafv=None)

Lists the internal IP owners in the specified network.

- listIpOwners_next(previous_request, previous_response)

+ listIpOwners_next()

Retrieves the next page of results.

listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, returnPartialSuccess=None, x__xgafv=None)

Lists the peering routes exchanged over peering connection.

- listPeeringRoutes_next(previous_request, previous_response)

+ listPeeringRoutes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, network, body=None, requestId=None, x__xgafv=None)

@@ -3451,17 +3451,17 @@

Method Details

- listIpAddresses_next(previous_request, previous_response) + listIpAddresses_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)
+        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.
-
+ 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. +
@@ -3618,17 +3618,17 @@

Method Details

- listIpOwners_next(previous_request, previous_response) + listIpOwners_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)
+        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.
-
+ 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. +
@@ -3788,31 +3788,31 @@

Method Details

- listPeeringRoutes_next(previous_request, previous_response) + listPeeringRoutes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.nodeGroups.html b/docs/dyn/compute_alpha.nodeGroups.html index 873a200b87..72eb9f1cb5 100644 --- a/docs/dyn/compute_alpha.nodeGroups.html +++ b/docs/dyn/compute_alpha.nodeGroups.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node groups.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listNodes(project, zone, nodeGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists nodes in the node group.

- listNodes_next(previous_request, previous_response)

+ listNodes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

@@ -730,17 +730,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2748,31 +2748,31 @@

Method Details

- listNodes_next(previous_request, previous_response) + listNodes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.nodeTemplates.html b/docs/dyn/compute_alpha.nodeTemplates.html index ad0d1300fa..570f1d8055 100644 --- a/docs/dyn/compute_alpha.nodeTemplates.html +++ b/docs/dyn/compute_alpha.nodeTemplates.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node templates.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node templates available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1754,17 +1754,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.nodeTypes.html b/docs/dyn/compute_alpha.nodeTypes.html index b968e1b393..352e6aa52b 100644 --- a/docs/dyn/compute_alpha.nodeTypes.html +++ b/docs/dyn/compute_alpha.nodeTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -344,17 +344,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -656,17 +656,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.organizationGlobalVmExtensionPolicies.html b/docs/dyn/compute_alpha.organizationGlobalVmExtensionPolicies.html index e2aee74e5d..0669a14f4a 100644 --- a/docs/dyn/compute_alpha.organizationGlobalVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.organizationGlobalVmExtensionPolicies.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(organization, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves the list of all organization level VM Extension Policy resources

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listVmExtensions(organization, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within an organization.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(organization, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1813,31 +1813,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.organizationRolloutPlans.html b/docs/dyn/compute_alpha.organizationRolloutPlans.html index 4980237fca..7f315ba12e 100644 --- a/docs/dyn/compute_alpha.organizationRolloutPlans.html +++ b/docs/dyn/compute_alpha.organizationRolloutPlans.html @@ -90,7 +90,7 @@

Instance Methods

list(organization, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists OrganizationRolloutPlans in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1164,17 +1164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.organizationRollouts.html b/docs/dyn/compute_alpha.organizationRollouts.html index 42da16bbe0..b12741d265 100644 --- a/docs/dyn/compute_alpha.organizationRollouts.html +++ b/docs/dyn/compute_alpha.organizationRollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(organization, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Rollouts in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(organization, rollout, etag=None, requestId=None, x__xgafv=None)

@@ -1370,17 +1370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.organizationSecurityPolicies.html b/docs/dyn/compute_alpha.organizationSecurityPolicies.html index ddb8163090..c542cab570 100644 --- a/docs/dyn/compute_alpha.organizationSecurityPolicies.html +++ b/docs/dyn/compute_alpha.organizationSecurityPolicies.html @@ -111,7 +111,7 @@

Instance Methods

listPreconfiguredExpressionSets(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(securityPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -5399,17 +5399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.organizationZoneVmExtensionPolicies.html b/docs/dyn/compute_alpha.organizationZoneVmExtensionPolicies.html index c88037968b..ae61418a26 100644 --- a/docs/dyn/compute_alpha.organizationZoneVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.organizationZoneVmExtensionPolicies.html @@ -93,10 +93,10 @@

Instance Methods

listVmExtensions(organization, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within a specific zone for an organization.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(organization, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -982,31 +982,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.packetMirrorings.html b/docs/dyn/compute_alpha.packetMirrorings.html index 7a3d060c28..e7199e69f0 100644 --- a/docs/dyn/compute_alpha.packetMirrorings.html +++ b/docs/dyn/compute_alpha.packetMirrorings.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of packetMirrorings.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of PacketMirroring resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, packetMirroring, body=None, requestId=None, x__xgafv=None)

@@ -390,17 +390,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1501,17 +1501,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.previewFeatures.html b/docs/dyn/compute_alpha.previewFeatures.html index e4f652af1e..6aa6e99736 100644 --- a/docs/dyn/compute_alpha.previewFeatures.html +++ b/docs/dyn/compute_alpha.previewFeatures.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns the details of the given PreviewFeature.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, previewFeature, body=None, requestId=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.projects.html b/docs/dyn/compute_alpha.projects.html index aa3765e5c5..a6c3fd3fe6 100644 --- a/docs/dyn/compute_alpha.projects.html +++ b/docs/dyn/compute_alpha.projects.html @@ -99,13 +99,13 @@

Instance Methods

getXpnResources(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets service resources (a.k.a service project) associated with this host

- getXpnResources_next(previous_request, previous_response)

+ getXpnResources_next()

Retrieves the next page of results.

listXpnHosts(project, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all shared VPC host projects visible to the user in an organization.

- listXpnHosts_next(previous_request, previous_response)

+ listXpnHosts_next()

Retrieves the next page of results.

moveDisk(project, body=None, requestId=None, x__xgafv=None)

@@ -1734,17 +1734,17 @@

Method Details

- getXpnResources_next(previous_request, previous_response) + getXpnResources_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)
+        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.
-
+ 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. +
@@ -1986,17 +1986,17 @@

Method Details

- listXpnHosts_next(previous_request, previous_response) + listXpnHosts_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.publicAdvertisedPrefixes.html b/docs/dyn/compute_alpha.publicAdvertisedPrefixes.html index 1d8c213ef0..95eff463ae 100644 --- a/docs/dyn/compute_alpha.publicAdvertisedPrefixes.html +++ b/docs/dyn/compute_alpha.publicAdvertisedPrefixes.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicAdvertisedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicAdvertisedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1414,17 +1414,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.publicDelegatedPrefixes.html b/docs/dyn/compute_alpha.publicDelegatedPrefixes.html index e9fddd00ac..8d463f08b7 100644 --- a/docs/dyn/compute_alpha.publicDelegatedPrefixes.html +++ b/docs/dyn/compute_alpha.publicDelegatedPrefixes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Lists all PublicDelegatedPrefix resources owned by the specific project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

announce(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicDelegatedPrefixes for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -404,17 +404,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1850,17 +1850,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.recoverableSnapshots.html b/docs/dyn/compute_alpha.recoverableSnapshots.html index 8c298f82a2..38064b6a1a 100644 --- a/docs/dyn/compute_alpha.recoverableSnapshots.html +++ b/docs/dyn/compute_alpha.recoverableSnapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the RecoverableSnapshots in your

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all of the RecoverableSnapshots in your project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

recover(project, recoverableSnapshot, requestId=None, snapshotName=None, x__xgafv=None)

@@ -618,17 +618,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2125,17 +2125,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionAutoscalers.html b/docs/dyn/compute_alpha.regionAutoscalers.html index 8647186207..3da83aa4ca 100644 --- a/docs/dyn/compute_alpha.regionAutoscalers.html +++ b/docs/dyn/compute_alpha.regionAutoscalers.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -2174,17 +2174,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionBackendBuckets.html b/docs/dyn/compute_alpha.regionBackendBuckets.html index 93656b6e50..f60cbf9350 100644 --- a/docs/dyn/compute_alpha.regionBackendBuckets.html +++ b/docs/dyn/compute_alpha.regionBackendBuckets.html @@ -96,10 +96,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project in

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -2192,31 +2192,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionBackendServices.html b/docs/dyn/compute_alpha.regionBackendServices.html index 379a73a175..b6b04524f5 100644 --- a/docs/dyn/compute_alpha.regionBackendServices.html +++ b/docs/dyn/compute_alpha.regionBackendServices.html @@ -99,10 +99,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendService, body=None, requestId=None, x__xgafv=None)

@@ -8676,31 +8676,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionCommitments.html b/docs/dyn/compute_alpha.regionCommitments.html index 6a4b951b4f..8f2a50119d 100644 --- a/docs/dyn/compute_alpha.regionCommitments.html +++ b/docs/dyn/compute_alpha.regionCommitments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of commitments by region.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

calculateCancellationFee(project, region, commitment, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of commitments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -761,17 +761,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3275,17 +3275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionCompositeHealthChecks.html b/docs/dyn/compute_alpha.regionCompositeHealthChecks.html index 40295a4ddb..236b8638e4 100644 --- a/docs/dyn/compute_alpha.regionCompositeHealthChecks.html +++ b/docs/dyn/compute_alpha.regionCompositeHealthChecks.html @@ -78,7 +78,7 @@

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 CompositeHealthCheck resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the CompositeHealthChecks for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, compositeHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -333,17 +333,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1289,17 +1289,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionDiskTypes.html b/docs/dyn/compute_alpha.regionDiskTypes.html index 7be8b841e9..5b7f28aec2 100644 --- a/docs/dyn/compute_alpha.regionDiskTypes.html +++ b/docs/dyn/compute_alpha.regionDiskTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of regional disk types available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -406,17 +406,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionDisks.html b/docs/dyn/compute_alpha.regionDisks.html index b15b7551ed..24c2d8a4f4 100644 --- a/docs/dyn/compute_alpha.regionDisks.html +++ b/docs/dyn/compute_alpha.regionDisks.html @@ -105,7 +105,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)

@@ -4580,17 +4580,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html b/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html index 27d1b91d0c..334aad52cf 100644 --- a/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html +++ b/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html @@ -78,7 +78,7 @@

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(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthAggregationPolicy, body=None, requestId=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1321,17 +1321,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionHealthCheckServices.html b/docs/dyn/compute_alpha.regionHealthCheckServices.html index 0719abc686..357241d20f 100644 --- a/docs/dyn/compute_alpha.regionHealthCheckServices.html +++ b/docs/dyn/compute_alpha.regionHealthCheckServices.html @@ -78,7 +78,7 @@

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 HealthCheckService resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the HealthCheckService resources that have been

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheckService, body=None, requestId=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1392,17 +1392,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionHealthChecks.html b/docs/dyn/compute_alpha.regionHealthChecks.html index 530828ec2a..352097a770 100644 --- a/docs/dyn/compute_alpha.regionHealthChecks.html +++ b/docs/dyn/compute_alpha.regionHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -1973,17 +1973,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionHealthSources.html b/docs/dyn/compute_alpha.regionHealthSources.html index 7ea87b1ca6..172e345c1d 100644 --- a/docs/dyn/compute_alpha.regionHealthSources.html +++ b/docs/dyn/compute_alpha.regionHealthSources.html @@ -78,7 +78,7 @@

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 HealthSource resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the HealthSources for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthSource, body=None, requestId=None, x__xgafv=None)

@@ -336,17 +336,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1314,17 +1314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionInstanceGroupManagerResizeRequests.html b/docs/dyn/compute_alpha.regionInstanceGroupManagerResizeRequests.html index d423e536ec..be22230caa 100644 --- a/docs/dyn/compute_alpha.regionInstanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_alpha.regionInstanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Resize Requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2309,17 +2309,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionInstanceGroupManagers.html b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html index b282884eed..2b8a830b3e 100644 --- a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html @@ -111,22 +111,22 @@

Instance Methods

listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given regional

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the managed instance group and instances that are

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -9062,17 +9062,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -10572,17 +10572,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -10788,31 +10788,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionInstanceGroups.html b/docs/dyn/compute_alpha.regionInstanceGroups.html index 2082f77bb3..9d02cfb127 100644 --- a/docs/dyn/compute_alpha.regionInstanceGroups.html +++ b/docs/dyn/compute_alpha.regionInstanceGroups.html @@ -87,10 +87,10 @@

Instance Methods

listInstances(project, region, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group and displays

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setNamedPorts(project, region, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -546,31 +546,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionInstanceTemplates.html b/docs/dyn/compute_alpha.regionInstanceTemplates.html index bbd41a6579..53ba320849 100644 --- a/docs/dyn/compute_alpha.regionInstanceTemplates.html +++ b/docs/dyn/compute_alpha.regionInstanceTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, view=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -4568,17 +4568,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionInstantSnapshotGroups.html b/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html index 9ec22c370f..382c06735e 100644 --- a/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html +++ b/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1376,17 +1376,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionInstantSnapshots.html b/docs/dyn/compute_alpha.regionInstantSnapshots.html index 04d3332f4c..91bda122bc 100644 --- a/docs/dyn/compute_alpha.regionInstantSnapshots.html +++ b/docs/dyn/compute_alpha.regionInstantSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1556,17 +1556,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionMultiMigMembers.html b/docs/dyn/compute_alpha.regionMultiMigMembers.html index 902c3d6c68..f8a4ca00b6 100644 --- a/docs/dyn/compute_alpha.regionMultiMigMembers.html +++ b/docs/dyn/compute_alpha.regionMultiMigMembers.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, multiMig, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of members of a specific multi-MIG.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionMultiMigs.html b/docs/dyn/compute_alpha.regionMultiMigs.html index f1eecce45f..ef745dd1b6 100644 --- a/docs/dyn/compute_alpha.regionMultiMigs.html +++ b/docs/dyn/compute_alpha.regionMultiMigs.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of multi-MIGs in a project and region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1328,17 +1328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionNetworkEndpointGroups.html b/docs/dyn/compute_alpha.regionNetworkEndpointGroups.html index d0b9c204f1..54cac31e94 100644 --- a/docs/dyn/compute_alpha.regionNetworkEndpointGroups.html +++ b/docs/dyn/compute_alpha.regionNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, region, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2525,31 +2525,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regionNetworkFirewallPolicies.html b/docs/dyn/compute_alpha.regionNetworkFirewallPolicies.html index 6bd3729f7b..0472cff8ae 100644 --- a/docs/dyn/compute_alpha.regionNetworkFirewallPolicies.html +++ b/docs/dyn/compute_alpha.regionNetworkFirewallPolicies.html @@ -111,7 +111,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the network firewall policies that have been configured

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -4825,17 +4825,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionNetworkPolicies.html b/docs/dyn/compute_alpha.regionNetworkPolicies.html index 76b1921b2f..a9d619d360 100644 --- a/docs/dyn/compute_alpha.regionNetworkPolicies.html +++ b/docs/dyn/compute_alpha.regionNetworkPolicies.html @@ -84,7 +84,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of network policies.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,7 +108,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the policies that have been configured for the specified project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, networkPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1132,17 +1132,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2384,17 +2384,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionNotificationEndpoints.html b/docs/dyn/compute_alpha.regionNotificationEndpoints.html index f77f5dd31f..573495f12f 100644 --- a/docs/dyn/compute_alpha.regionNotificationEndpoints.html +++ b/docs/dyn/compute_alpha.regionNotificationEndpoints.html @@ -78,7 +78,7 @@

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 NotificationEndpoint resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NotificationEndpoints for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1314,17 +1314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionOperations.html b/docs/dyn/compute_alpha.regionOperations.html index 9186f2e28b..04753830b2 100644 --- a/docs/dyn/compute_alpha.regionOperations.html +++ b/docs/dyn/compute_alpha.regionOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, region, operation, x__xgafv=None)

@@ -835,17 +835,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionRecoverableSnapshots.html b/docs/dyn/compute_alpha.regionRecoverableSnapshots.html index 3604004204..9396a27217 100644 --- a/docs/dyn/compute_alpha.regionRecoverableSnapshots.html +++ b/docs/dyn/compute_alpha.regionRecoverableSnapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of RecoverableSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

recover(project, region, recoverableSnapshot, requestId=None, snapshotName=None, x__xgafv=None)

@@ -1601,17 +1601,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionSecurityPolicies.html b/docs/dyn/compute_alpha.regionSecurityPolicies.html index f4ff646b6a..7ca90fe98c 100644 --- a/docs/dyn/compute_alpha.regionSecurityPolicies.html +++ b/docs/dyn/compute_alpha.regionSecurityPolicies.html @@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

List all the policies that have been configured for the specified project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, securityPolicy, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -4490,17 +4490,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionSnapshots.html b/docs/dyn/compute_alpha.regionSnapshots.html index de1db5423d..7eb8de6b79 100644 --- a/docs/dyn/compute_alpha.regionSnapshots.html +++ b/docs/dyn/compute_alpha.regionSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -2295,17 +2295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionSslCertificates.html b/docs/dyn/compute_alpha.regionSslCertificates.html index 7ead8cb65b..401ec3e9bf 100644 --- a/docs/dyn/compute_alpha.regionSslCertificates.html +++ b/docs/dyn/compute_alpha.regionSslCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -1141,17 +1141,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionSslPolicies.html b/docs/dyn/compute_alpha.regionSslPolicies.html index 424db09454..64a70f7ac5 100644 --- a/docs/dyn/compute_alpha.regionSslPolicies.html +++ b/docs/dyn/compute_alpha.regionSslPolicies.html @@ -96,7 +96,7 @@

Instance Methods

listAvailableFeatures(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1960,17 +1960,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionTargetHttpProxies.html b/docs/dyn/compute_alpha.regionTargetHttpProxies.html index f390f9ae45..7d29b0960d 100644 --- a/docs/dyn/compute_alpha.regionTargetHttpProxies.html +++ b/docs/dyn/compute_alpha.regionTargetHttpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setUrlMap(project, region, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -1131,17 +1131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionTargetHttpsProxies.html b/docs/dyn/compute_alpha.regionTargetHttpsProxies.html index 48e67a26d3..18652ebd3a 100644 --- a/docs/dyn/compute_alpha.regionTargetHttpsProxies.html +++ b/docs/dyn/compute_alpha.regionTargetHttpsProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -1431,17 +1431,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionTargetTcpProxies.html b/docs/dyn/compute_alpha.regionTargetTcpProxies.html index f9b54df079..136e02453e 100644 --- a/docs/dyn/compute_alpha.regionTargetTcpProxies.html +++ b/docs/dyn/compute_alpha.regionTargetTcpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -1004,17 +1004,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionUrlMaps.html b/docs/dyn/compute_alpha.regionUrlMaps.html index e11bc1f00e..75c7c60576 100644 --- a/docs/dyn/compute_alpha.regionUrlMaps.html +++ b/docs/dyn/compute_alpha.regionUrlMaps.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -12543,17 +12543,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.regionZones.html b/docs/dyn/compute_alpha.regionZones.html index 34d3bb1759..00731824d8 100644 --- a/docs/dyn/compute_alpha.regionZones.html +++ b/docs/dyn/compute_alpha.regionZones.html @@ -81,7 +81,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources under the specific region available to

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.regions.html b/docs/dyn/compute_alpha.regions.html index 57b061be7a..65e2290617 100644 --- a/docs/dyn/compute_alpha.regions.html +++ b/docs/dyn/compute_alpha.regions.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of region resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -480,17 +480,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.reliabilityRisks.html b/docs/dyn/compute_alpha.reliabilityRisks.html index 285b77e7af..4f68f859ba 100644 --- a/docs/dyn/compute_alpha.reliabilityRisks.html +++ b/docs/dyn/compute_alpha.reliabilityRisks.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of reliabilityRisks available in the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -312,17 +312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.reservationBlocks.html b/docs/dyn/compute_alpha.reservationBlocks.html index 1af2f8cd58..1f8972e878 100644 --- a/docs/dyn/compute_alpha.reservationBlocks.html +++ b/docs/dyn/compute_alpha.reservationBlocks.html @@ -84,7 +84,7 @@

Instance Methods

list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation blocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, reservationBlock, body=None, requestId=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.reservationConsumedInstances.html b/docs/dyn/compute_alpha.reservationConsumedInstances.html index 4ad9994095..e0a52b8113 100644 --- a/docs/dyn/compute_alpha.reservationConsumedInstances.html +++ b/docs/dyn/compute_alpha.reservationConsumedInstances.html @@ -81,7 +81,7 @@

Instance Methods

list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances consuming capacity from a specific reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -332,17 +332,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.reservationSlots.html b/docs/dyn/compute_alpha.reservationSlots.html index b5fbacf203..1a9e1e9e97 100644 --- a/docs/dyn/compute_alpha.reservationSlots.html +++ b/docs/dyn/compute_alpha.reservationSlots.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation slots under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, parentName, reservationSlot, body=None, updateMask=None, x__xgafv=None)

@@ -1009,17 +1009,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.reservationSubBlocks.html b/docs/dyn/compute_alpha.reservationSubBlocks.html index 0280139be5..d38b2ec648 100644 --- a/docs/dyn/compute_alpha.reservationSubBlocks.html +++ b/docs/dyn/compute_alpha.reservationSubBlocks.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation subBlocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)

@@ -790,17 +790,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.reservations.html b/docs/dyn/compute_alpha.reservations.html index 419ab6fd41..2d26b466a1 100644 --- a/docs/dyn/compute_alpha.reservations.html +++ b/docs/dyn/compute_alpha.reservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, body=None, requestId=None, x__xgafv=None)

@@ -573,17 +573,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2567,17 +2567,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.resourcePolicies.html b/docs/dyn/compute_alpha.resourcePolicies.html index a9616de114..7dc2e5eedd 100644 --- a/docs/dyn/compute_alpha.resourcePolicies.html +++ b/docs/dyn/compute_alpha.resourcePolicies.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of resource policies.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list all the resource policies that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, resourcePolicy, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -454,17 +454,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2105,17 +2105,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.rolloutPlans.html b/docs/dyn/compute_alpha.rolloutPlans.html index 0bba1326f7..6548d01840 100644 --- a/docs/dyn/compute_alpha.rolloutPlans.html +++ b/docs/dyn/compute_alpha.rolloutPlans.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists RolloutPlans in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1164,17 +1164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.rollouts.html b/docs/dyn/compute_alpha.rollouts.html index 952f5e21fc..0864b63efe 100644 --- a/docs/dyn/compute_alpha.rollouts.html +++ b/docs/dyn/compute_alpha.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Rollouts in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(project, rollout, etag=None, requestId=None, x__xgafv=None)

@@ -1370,17 +1370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.routers.html b/docs/dyn/compute_alpha.routers.html index cfdd8cbcf6..3deb22cc76 100644 --- a/docs/dyn/compute_alpha.routers.html +++ b/docs/dyn/compute_alpha.routers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of routers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

getNatMappingInfo(project, region, router, filter=None, maxResults=None, natName=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves runtime Nat mapping information of VM endpoints.

- getNatMappingInfo_next(previous_request, previous_response)

+ getNatMappingInfo_next()

Retrieves the next page of results.

getRoutePolicy(project, region, router, policy=None, x__xgafv=None)

@@ -123,22 +123,22 @@

Instance Methods

listBgpRoutes(project, region, router, addressFamily=None, destinationPrefix=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peer=None, policyApplied=None, returnPartialSuccess=None, routeType=None, x__xgafv=None)

Retrieves a list of router bgp routes available to the specified project.

- listBgpRoutes_next(previous_request, previous_response)

+ 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(previous_request, previous_response)

+ 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

- listRoutePolicies_next(previous_request, previous_response)

+ listRoutePolicies_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, router, body=None, requestId=None, x__xgafv=None)

@@ -895,17 +895,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2736,17 +2736,17 @@

Method Details

- getNatMappingInfo_next(previous_request, previous_response) + getNatMappingInfo_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)
+        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.
-
+ 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. +
@@ -5373,17 +5373,17 @@

Method Details

- listBgpRoutes_next(previous_request, previous_response) + listBgpRoutes_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)
+        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.
-
+ 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. +
@@ -5591,17 +5591,17 @@

Method Details

- listNamedSets_next(previous_request, previous_response) + listNamedSets_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)
+        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.
-
+ 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. +
@@ -5859,31 +5859,31 @@

Method Details

- listRoutePolicies_next(previous_request, previous_response) + 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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.routes.html b/docs/dyn/compute_alpha.routes.html index 44efa000da..e0a7a9856b 100644 --- a/docs/dyn/compute_alpha.routes.html +++ b/docs/dyn/compute_alpha.routes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Route resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, resource, body=None, x__xgafv=None)

@@ -1389,17 +1389,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.securityPolicies.html b/docs/dyn/compute_alpha.securityPolicies.html index 157762af1b..9767420c92 100644 --- a/docs/dyn/compute_alpha.securityPolicies.html +++ b/docs/dyn/compute_alpha.securityPolicies.html @@ -81,7 +81,7 @@

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 SecurityPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

listPreconfiguredExpressionSets(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, securityPolicy, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1866,17 +1866,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5581,17 +5581,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.serviceAttachments.html b/docs/dyn/compute_alpha.serviceAttachments.html index 64afbe633f..7fe6a429db 100644 --- a/docs/dyn/compute_alpha.serviceAttachments.html +++ b/docs/dyn/compute_alpha.serviceAttachments.html @@ -78,7 +78,7 @@

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 ServiceAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the ServiceAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, serviceAttachment, body=None, requestId=None, x__xgafv=None)

@@ -440,17 +440,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2048,17 +2048,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.snapshotGroups.html b/docs/dyn/compute_alpha.snapshotGroups.html index 3319ec0edc..2b38539fe7 100644 --- a/docs/dyn/compute_alpha.snapshotGroups.html +++ b/docs/dyn/compute_alpha.snapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1355,17 +1355,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.snapshots.html b/docs/dyn/compute_alpha.snapshots.html index 8137586bde..e748f69dc2 100644 --- a/docs/dyn/compute_alpha.snapshots.html +++ b/docs/dyn/compute_alpha.snapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the snapshots in your project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,7 +102,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -643,17 +643,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2863,17 +2863,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.sslCertificates.html b/docs/dyn/compute_alpha.sslCertificates.html index 74a4321498..347adfed5c 100644 --- a/docs/dyn/compute_alpha.sslCertificates.html +++ b/docs/dyn/compute_alpha.sslCertificates.html @@ -78,7 +78,7 @@

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 SslCertificate resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, resource, body=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1423,17 +1423,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.sslPolicies.html b/docs/dyn/compute_alpha.sslPolicies.html index e6e551867b..6c9d9ec4c9 100644 --- a/docs/dyn/compute_alpha.sslPolicies.html +++ b/docs/dyn/compute_alpha.sslPolicies.html @@ -78,7 +78,7 @@

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 SslPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,7 +102,7 @@

Instance Methods

listAvailableFeatures(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -493,17 +493,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2351,17 +2351,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.storagePoolTypes.html b/docs/dyn/compute_alpha.storagePoolTypes.html index 1166400414..89a9fc4626 100644 --- a/docs/dyn/compute_alpha.storagePoolTypes.html +++ b/docs/dyn/compute_alpha.storagePoolTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pool types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of storage pool types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -340,17 +340,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -651,17 +651,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.storagePools.html b/docs/dyn/compute_alpha.storagePools.html index 6e3704156f..a42ca14d34 100644 --- a/docs/dyn/compute_alpha.storagePools.html +++ b/docs/dyn/compute_alpha.storagePools.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listDisks(project, zone, storagePool, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the disks in a specified storage pool.

- listDisks_next(previous_request, previous_response)

+ listDisks_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2252,31 +2252,31 @@

Method Details

- listDisks_next(previous_request, previous_response) + listDisks_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.subnetworks.html b/docs/dyn/compute_alpha.subnetworks.html index 38f9fb9362..825dee9d84 100644 --- a/docs/dyn/compute_alpha.subnetworks.html +++ b/docs/dyn/compute_alpha.subnetworks.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, views=None, x__xgafv=None)

Retrieves an aggregated list of subnetworks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,10 +105,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProject=None, x__xgafv=None)

Retrieves an aggregated list of all usable subnetworks in the project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, subnetwork, body=None, drainTimeoutSeconds=None, requestId=None, x__xgafv=None)

@@ -605,17 +605,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3197,31 +3197,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetGrpcProxies.html b/docs/dyn/compute_alpha.targetGrpcProxies.html index a66e731a92..479c37c1c9 100644 --- a/docs/dyn/compute_alpha.targetGrpcProxies.html +++ b/docs/dyn/compute_alpha.targetGrpcProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the TargetGrpcProxies for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetGrpcProxy, body=None, requestId=None, x__xgafv=None)

@@ -1014,17 +1014,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetHttpProxies.html b/docs/dyn/compute_alpha.targetHttpProxies.html index 9eb0b6f5cc..6db7c106d1 100644 --- a/docs/dyn/compute_alpha.targetHttpProxies.html +++ b/docs/dyn/compute_alpha.targetHttpProxies.html @@ -78,7 +78,7 @@

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 TargetHttpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -373,17 +373,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1414,17 +1414,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetHttpsProxies.html b/docs/dyn/compute_alpha.targetHttpsProxies.html index b4aacb9162..0a95004b08 100644 --- a/docs/dyn/compute_alpha.targetHttpsProxies.html +++ b/docs/dyn/compute_alpha.targetHttpsProxies.html @@ -78,7 +78,7 @@

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 TargetHttpsProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -483,17 +483,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1818,17 +1818,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetInstances.html b/docs/dyn/compute_alpha.targetInstances.html index d1a1d478c6..795238794b 100644 --- a/docs/dyn/compute_alpha.targetInstances.html +++ b/docs/dyn/compute_alpha.targetInstances.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target instances.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetInstance resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setSecurityPolicy(project, zone, targetInstance, body=None, requestId=None, x__xgafv=None)

@@ -330,17 +330,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1260,17 +1260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetPools.html b/docs/dyn/compute_alpha.targetPools.html index cab904cb7d..3b50bb9aff 100644 --- a/docs/dyn/compute_alpha.targetPools.html +++ b/docs/dyn/compute_alpha.targetPools.html @@ -84,7 +84,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target pools available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

@@ -1036,17 +1036,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2115,17 +2115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetSslProxies.html b/docs/dyn/compute_alpha.targetSslProxies.html index c453982e28..dbc1bd0f69 100644 --- a/docs/dyn/compute_alpha.targetSslProxies.html +++ b/docs/dyn/compute_alpha.targetSslProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetSslProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

@@ -1021,17 +1021,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetTcpProxies.html b/docs/dyn/compute_alpha.targetTcpProxies.html index 5ceda56c3b..f8b1df8e73 100644 --- a/docs/dyn/compute_alpha.targetTcpProxies.html +++ b/docs/dyn/compute_alpha.targetTcpProxies.html @@ -78,7 +78,7 @@

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 TargetTcpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None)

@@ -332,17 +332,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1249,17 +1249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.targetVpnGateways.html b/docs/dyn/compute_alpha.targetVpnGateways.html index c1a01f782d..6276f7d8f6 100644 --- a/docs/dyn/compute_alpha.targetVpnGateways.html +++ b/docs/dyn/compute_alpha.targetVpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1368,17 +1368,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.urlMaps.html b/docs/dyn/compute_alpha.urlMaps.html index b57ae70c2c..3b8859c70f 100644 --- a/docs/dyn/compute_alpha.urlMaps.html +++ b/docs/dyn/compute_alpha.urlMaps.html @@ -78,7 +78,7 @@

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 UrlMap resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -4074,17 +4074,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -16550,17 +16550,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.vpnGateways.html b/docs/dyn/compute_alpha.vpnGateways.html index 964418f04b..af1daca3fd 100644 --- a/docs/dyn/compute_alpha.vpnGateways.html +++ b/docs/dyn/compute_alpha.vpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1500,17 +1500,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.vpnTunnels.html b/docs/dyn/compute_alpha.vpnTunnels.html index 023a95e8d5..21d1f51b5e 100644 --- a/docs/dyn/compute_alpha.vpnTunnels.html +++ b/docs/dyn/compute_alpha.vpnTunnels.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN tunnels.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VpnTunnel resources contained in the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -508,17 +508,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1970,17 +1970,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.wireGroups.html b/docs/dyn/compute_alpha.wireGroups.html index a08c6f793b..3f3188f1b1 100644 --- a/docs/dyn/compute_alpha.wireGroups.html +++ b/docs/dyn/compute_alpha.wireGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(project, crossSiteNetwork, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the wire groups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, wireGroup, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1572,17 +1572,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.zoneFolderOperations.html b/docs/dyn/compute_alpha.zoneFolderOperations.html index fb33671c72..b04f688547 100644 --- a/docs/dyn/compute_alpha.zoneFolderOperations.html +++ b/docs/dyn/compute_alpha.zoneFolderOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(folder, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -812,17 +812,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.zoneOperations.html b/docs/dyn/compute_alpha.zoneOperations.html index 4c4bf566dc..b33cde7cbf 100644 --- a/docs/dyn/compute_alpha.zoneOperations.html +++ b/docs/dyn/compute_alpha.zoneOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, zone, operation, x__xgafv=None)

@@ -835,17 +835,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.zoneOrganizationOperations.html b/docs/dyn/compute_alpha.zoneOrganizationOperations.html index 838bfcbd20..4d72df8889 100644 --- a/docs/dyn/compute_alpha.zoneOrganizationOperations.html +++ b/docs/dyn/compute_alpha.zoneOrganizationOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(organization, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -813,17 +813,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.zoneQueuedResources.html b/docs/dyn/compute_alpha.zoneQueuedResources.html index ca91a94dd4..0f2ff93109 100644 --- a/docs/dyn/compute_alpha.zoneQueuedResources.html +++ b/docs/dyn/compute_alpha.zoneQueuedResources.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the queued resources in a project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cancel(project, zone, queuedResource, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of QueuedResource resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2237,17 +2237,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -9207,17 +9207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_alpha.zoneVmExtensionPolicies.html b/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html index ceaaf55543..1bbe211d08 100644 --- a/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html @@ -96,10 +96,10 @@

Instance Methods

listVmExtensions(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions within a specific zone for a project.

- listVmExtensions_next(previous_request, previous_response)

+ listVmExtensions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1295,31 +1295,31 @@

Method Details

- listVmExtensions_next(previous_request, previous_response) + listVmExtensions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_alpha.zones.html b/docs/dyn/compute_alpha.zones.html index a616ea4492..34a57ede66 100644 --- a/docs/dyn/compute_alpha.zones.html +++ b/docs/dyn/compute_alpha.zones.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -588,17 +588,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.acceleratorTypes.html b/docs/dyn/compute_beta.acceleratorTypes.html index 0f3893141b..86883d98b4 100644 --- a/docs/dyn/compute_beta.acceleratorTypes.html +++ b/docs/dyn/compute_beta.acceleratorTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of accelerator types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of accelerator types that are available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -336,17 +336,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -631,17 +631,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.addresses.html b/docs/dyn/compute_beta.addresses.html index e309f4ddce..f797e0a73d 100644 --- a/docs/dyn/compute_beta.addresses.html +++ b/docs/dyn/compute_beta.addresses.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of addresses.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of addresses contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, region, address, body=None, requestId=None, x__xgafv=None)

@@ -423,17 +423,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1607,17 +1607,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.autoscalers.html b/docs/dyn/compute_beta.autoscalers.html index ea2ed338de..f33ceb32dc 100644 --- a/docs/dyn/compute_beta.autoscalers.html +++ b/docs/dyn/compute_beta.autoscalers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of autoscalers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -656,17 +656,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2536,17 +2536,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.backendBuckets.html b/docs/dyn/compute_beta.backendBuckets.html index efb93ea8ba..e692c2664c 100644 --- a/docs/dyn/compute_beta.backendBuckets.html +++ b/docs/dyn/compute_beta.backendBuckets.html @@ -81,7 +81,7 @@

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 BackendBucket resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -822,17 +822,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3192,31 +3192,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.backendServices.html b/docs/dyn/compute_beta.backendServices.html index 942b5f7500..4c00c76b8a 100644 --- a/docs/dyn/compute_beta.backendServices.html +++ b/docs/dyn/compute_beta.backendServices.html @@ -81,7 +81,7 @@

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 BackendService resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -114,10 +114,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendService, body=None, requestId=None, x__xgafv=None)

@@ -2028,17 +2028,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -9977,31 +9977,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.crossSiteNetworks.html b/docs/dyn/compute_beta.crossSiteNetworks.html index e38700154e..93fcc7e38a 100644 --- a/docs/dyn/compute_beta.crossSiteNetworks.html +++ b/docs/dyn/compute_beta.crossSiteNetworks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the cross-site networks for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -930,17 +930,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.dhcpOptionsConfigs.html b/docs/dyn/compute_beta.dhcpOptionsConfigs.html index 63056f680e..09edbf4585 100644 --- a/docs/dyn/compute_beta.dhcpOptionsConfigs.html +++ b/docs/dyn/compute_beta.dhcpOptionsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the DhcpOptionsConfigs for a project in the given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, dhcpOptionsConfig, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1114,17 +1114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.diskTypes.html b/docs/dyn/compute_beta.diskTypes.html index 2dce7822dc..9b7088f116 100644 --- a/docs/dyn/compute_beta.diskTypes.html +++ b/docs/dyn/compute_beta.diskTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of disk types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of disk types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -353,17 +353,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -685,17 +685,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.disks.html b/docs/dyn/compute_beta.disks.html index dcf6a6a611..852ce49c76 100644 --- a/docs/dyn/compute_beta.disks.html +++ b/docs/dyn/compute_beta.disks.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of persistent disks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)

@@ -111,7 +111,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)

@@ -1262,17 +1262,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5606,17 +5606,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.externalVpnGateways.html b/docs/dyn/compute_beta.externalVpnGateways.html index 59b8a2d442..2272300ab4 100644 --- a/docs/dyn/compute_beta.externalVpnGateways.html +++ b/docs/dyn/compute_beta.externalVpnGateways.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of ExternalVpnGateway available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, resource, body=None, x__xgafv=None)

@@ -1129,17 +1129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.firewallPolicies.html b/docs/dyn/compute_beta.firewallPolicies.html index 9b50d2d18d..684acfdf4f 100644 --- a/docs/dyn/compute_beta.firewallPolicies.html +++ b/docs/dyn/compute_beta.firewallPolicies.html @@ -117,7 +117,7 @@

Instance Methods

listAssociations(includeInheritedPolicies=None, targetResource=None, x__xgafv=None)

Lists associations of a specified target, i.e., organization or folder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(firewallPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -4775,17 +4775,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.firewalls.html b/docs/dyn/compute_beta.firewalls.html index a6e6079907..47055fa843 100644 --- a/docs/dyn/compute_beta.firewalls.html +++ b/docs/dyn/compute_beta.firewalls.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of firewall rules available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewall, body=None, requestId=None, x__xgafv=None)

@@ -1377,17 +1377,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.forwardingRules.html b/docs/dyn/compute_beta.forwardingRules.html index 9774369bdf..02e4904593 100644 --- a/docs/dyn/compute_beta.forwardingRules.html +++ b/docs/dyn/compute_beta.forwardingRules.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of forwarding rules.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of ForwardingRule resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -816,17 +816,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3176,17 +3176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.futureReservations.html b/docs/dyn/compute_beta.futureReservations.html index 9a5e73f084..2b3e704b9c 100644 --- a/docs/dyn/compute_beta.futureReservations.html +++ b/docs/dyn/compute_beta.futureReservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of future reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the future reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -665,17 +665,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2889,17 +2889,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.globalAddresses.html b/docs/dyn/compute_beta.globalAddresses.html index 274148cc2c..1020a5b6a0 100644 --- a/docs/dyn/compute_beta.globalAddresses.html +++ b/docs/dyn/compute_beta.globalAddresses.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of global addresses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, address, body=None, requestId=None, x__xgafv=None)

@@ -1268,17 +1268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.globalForwardingRules.html b/docs/dyn/compute_beta.globalForwardingRules.html index baf2a632f9..eb25bff6f4 100644 --- a/docs/dyn/compute_beta.globalForwardingRules.html +++ b/docs/dyn/compute_beta.globalForwardingRules.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of GlobalForwardingRule resources available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -2449,17 +2449,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.globalNetworkEndpointGroups.html b/docs/dyn/compute_beta.globalNetworkEndpointGroups.html index e3dd9e60d7..61aba1145b 100644 --- a/docs/dyn/compute_beta.globalNetworkEndpointGroups.html +++ b/docs/dyn/compute_beta.globalNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2473,31 +2473,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.globalOperations.html b/docs/dyn/compute_beta.globalOperations.html index a05ffbcf99..99e5137e58 100644 --- a/docs/dyn/compute_beta.globalOperations.html +++ b/docs/dyn/compute_beta.globalOperations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all operations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, operation, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1295,17 +1295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.globalOrganizationOperations.html b/docs/dyn/compute_beta.globalOrganizationOperations.html index 9e03639fd5..aa12d2f2ad 100644 --- a/docs/dyn/compute_beta.globalOrganizationOperations.html +++ b/docs/dyn/compute_beta.globalOrganizationOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -816,17 +816,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.globalPublicDelegatedPrefixes.html b/docs/dyn/compute_beta.globalPublicDelegatedPrefixes.html index 57bf21a57c..4f36481d05 100644 --- a/docs/dyn/compute_beta.globalPublicDelegatedPrefixes.html +++ b/docs/dyn/compute_beta.globalPublicDelegatedPrefixes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the global PublicDelegatedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1196,17 +1196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.globalVmExtensionPolicies.html b/docs/dyn/compute_beta.globalVmExtensionPolicies.html index 9b13ca68e3..0cbd5f5c34 100644 --- a/docs/dyn/compute_beta.globalVmExtensionPolicies.html +++ b/docs/dyn/compute_beta.globalVmExtensionPolicies.html @@ -78,7 +78,7 @@

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 VM Extension Policy resources

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists global VM extension policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -345,17 +345,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1544,17 +1544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.healthChecks.html b/docs/dyn/compute_beta.healthChecks.html index 85654252cc..b93cdd23c2 100644 --- a/docs/dyn/compute_beta.healthChecks.html +++ b/docs/dyn/compute_beta.healthChecks.html @@ -78,7 +78,7 @@

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 HealthCheck resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -639,17 +639,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2466,17 +2466,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.hosts.html b/docs/dyn/compute_beta.hosts.html index f18529d034..e970b56e47 100644 --- a/docs/dyn/compute_beta.hosts.html +++ b/docs/dyn/compute_beta.hosts.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, association, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of hosts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -634,17 +634,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.html b/docs/dyn/compute_beta.html index 8c53f83854..a4c37e6ac8 100644 --- a/docs/dyn/compute_beta.html +++ b/docs/dyn/compute_beta.html @@ -793,7 +793,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -802,20 +802,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/compute_beta.httpHealthChecks.html b/docs/dyn/compute_beta.httpHealthChecks.html index eb1cb6c5eb..ebbda733d1 100644 --- a/docs/dyn/compute_beta.httpHealthChecks.html +++ b/docs/dyn/compute_beta.httpHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -986,17 +986,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.httpsHealthChecks.html b/docs/dyn/compute_beta.httpsHealthChecks.html index 8e17888e5e..fbf11f1f98 100644 --- a/docs/dyn/compute_beta.httpsHealthChecks.html +++ b/docs/dyn/compute_beta.httpsHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpsHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -998,17 +998,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.imageViews.html b/docs/dyn/compute_beta.imageViews.html index 60580affe1..f4144fccc5 100644 --- a/docs/dyn/compute_beta.imageViews.html +++ b/docs/dyn/compute_beta.imageViews.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns a list of global ImageView resources, with a regional

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1350,17 +1350,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.images.html b/docs/dyn/compute_beta.images.html index a0e217ac7e..48d7d71589 100644 --- a/docs/dyn/compute_beta.images.html +++ b/docs/dyn/compute_beta.images.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None, zone=None)

Retrieves the list of custom images

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, image, body=None, requestId=None, x__xgafv=None)

@@ -3822,17 +3822,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instanceGroupManagerResizeRequests.html b/docs/dyn/compute_beta.instanceGroupManagerResizeRequests.html index 6d57d8362f..eb8477ec01 100644 --- a/docs/dyn/compute_beta.instanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_beta.instanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resize requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2170,17 +2170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.instanceGroupManagers.html b/docs/dyn/compute_beta.instanceGroupManagers.html index ec8cd3a872..5424133028 100644 --- a/docs/dyn/compute_beta.instanceGroupManagers.html +++ b/docs/dyn/compute_beta.instanceGroupManagers.html @@ -81,7 +81,7 @@

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 managed instance groups and groups them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)

@@ -120,22 +120,22 @@

Instance Methods

listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given managed

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the instances in the managed instance group. Each instance

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -2027,17 +2027,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -8809,17 +8809,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -9749,17 +9749,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -9967,31 +9967,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instanceGroups.html b/docs/dyn/compute_beta.instanceGroups.html index 1733703273..c11e34b3f9 100644 --- a/docs/dyn/compute_beta.instanceGroups.html +++ b/docs/dyn/compute_beta.instanceGroups.html @@ -81,7 +81,7 @@

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 instance groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listInstances(project, zone, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group.

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -680,17 +680,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1824,31 +1824,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instanceTemplates.html b/docs/dyn/compute_beta.instanceTemplates.html index 9c6a10a847..87577874b9 100644 --- a/docs/dyn/compute_beta.instanceTemplates.html +++ b/docs/dyn/compute_beta.instanceTemplates.html @@ -78,7 +78,7 @@

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 InstanceTemplates resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, view=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1409,17 +1409,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5936,17 +5936,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instances.html b/docs/dyn/compute_beta.instances.html index 2c5784d2d4..ce1cd07e3e 100644 --- a/docs/dyn/compute_beta.instances.html +++ b/docs/dyn/compute_beta.instances.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the instances in your project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachDisk(project, zone, instance, body=None, forceAttach=None, requestId=None, x__xgafv=None)

@@ -150,16 +150,16 @@

Instance Methods

listReferrers(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resources that refer to the VM instance specified in

- listReferrers_next(previous_request, previous_response)

+ listReferrers_next()

Retrieves the next page of results.

listVmExtensionStates(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extensions states for a specific instance.

- listVmExtensionStates_next(previous_request, previous_response)

+ listVmExtensionStates_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patchPartnerMetadata(project, zone, instance, body=None, requestId=None, x__xgafv=None)

@@ -2996,17 +2996,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -13450,17 +13450,17 @@

Method Details

- listReferrers_next(previous_request, previous_response) + listReferrers_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)
+        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.
-
+ 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. +
@@ -13624,31 +13624,31 @@

Method Details

- listVmExtensionStates_next(previous_request, previous_response) + listVmExtensionStates_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instantSnapshotGroups.html b/docs/dyn/compute_beta.instantSnapshotGroups.html index a60d9c9936..d6ed31ea6b 100644 --- a/docs/dyn/compute_beta.instantSnapshotGroups.html +++ b/docs/dyn/compute_beta.instantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -1361,17 +1361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.instantSnapshots.html b/docs/dyn/compute_beta.instantSnapshots.html index 3c8e18eae3..d26398e55d 100644 --- a/docs/dyn/compute_beta.instantSnapshots.html +++ b/docs/dyn/compute_beta.instantSnapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of instantSnapshots.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1832,17 +1832,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.interconnectAttachmentGroups.html b/docs/dyn/compute_beta.interconnectAttachmentGroups.html index d55bc27b86..91290baae0 100644 --- a/docs/dyn/compute_beta.interconnectAttachmentGroups.html +++ b/docs/dyn/compute_beta.interconnectAttachmentGroups.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectAttachmentGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectAttachmentGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1713,17 +1713,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.interconnectAttachments.html b/docs/dyn/compute_beta.interconnectAttachments.html index 519bcf152f..43ac9e7479 100644 --- a/docs/dyn/compute_beta.interconnectAttachments.html +++ b/docs/dyn/compute_beta.interconnectAttachments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of interconnect attachments.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect attachments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, interconnectAttachment, body=None, requestId=None, x__xgafv=None)

@@ -668,17 +668,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2589,17 +2589,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.interconnectGroups.html b/docs/dyn/compute_beta.interconnectGroups.html index de8ea72ea2..8f9f49c20c 100644 --- a/docs/dyn/compute_beta.interconnectGroups.html +++ b/docs/dyn/compute_beta.interconnectGroups.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2206,17 +2206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.interconnectLocations.html b/docs/dyn/compute_beta.interconnectLocations.html index 45386143f2..9d3b64e373 100644 --- a/docs/dyn/compute_beta.interconnectLocations.html +++ b/docs/dyn/compute_beta.interconnectLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect locations available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -433,17 +433,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.interconnectRemoteLocations.html b/docs/dyn/compute_beta.interconnectRemoteLocations.html index 9832ef4b9b..b5a903e2dd 100644 --- a/docs/dyn/compute_beta.interconnectRemoteLocations.html +++ b/docs/dyn/compute_beta.interconnectRemoteLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect remote locations available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -494,17 +494,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.interconnects.html b/docs/dyn/compute_beta.interconnects.html index f88f139daf..d924177680 100644 --- a/docs/dyn/compute_beta.interconnects.html +++ b/docs/dyn/compute_beta.interconnects.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Interconnects available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnect, body=None, requestId=None, x__xgafv=None)

@@ -1886,17 +1886,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.licenses.html b/docs/dyn/compute_beta.licenses.html index e44105eeaa..abf02e512e 100644 --- a/docs/dyn/compute_beta.licenses.html +++ b/docs/dyn/compute_beta.licenses.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of licenses

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1500,17 +1500,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.machineImages.html b/docs/dyn/compute_beta.machineImages.html index d28b3ac58a..744c4245f6 100644 --- a/docs/dyn/compute_beta.machineImages.html +++ b/docs/dyn/compute_beta.machineImages.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine images that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -6696,17 +6696,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.machineTypes.html b/docs/dyn/compute_beta.machineTypes.html index 029721bfb3..c99cf1bf1a 100644 --- a/docs/dyn/compute_beta.machineTypes.html +++ b/docs/dyn/compute_beta.machineTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of machine types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -354,17 +354,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -686,17 +686,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.managedRulesets.html b/docs/dyn/compute_beta.managedRulesets.html index 46b4e50b1f..709dfc7d88 100644 --- a/docs/dyn/compute_beta.managedRulesets.html +++ b/docs/dyn/compute_beta.managedRulesets.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of all the managed rulesets available.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -292,17 +292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.networkAttachments.html b/docs/dyn/compute_beta.networkAttachments.html index 12f4a09002..8923577fe7 100644 --- a/docs/dyn/compute_beta.networkAttachments.html +++ b/docs/dyn/compute_beta.networkAttachments.html @@ -78,7 +78,7 @@

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 NetworkAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NetworkAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, networkAttachment, body=None, requestId=None, x__xgafv=None)

@@ -359,17 +359,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.networkEdgeSecurityServices.html b/docs/dyn/compute_beta.networkEdgeSecurityServices.html index a6a0c48065..3730761f16 100644 --- a/docs/dyn/compute_beta.networkEdgeSecurityServices.html +++ b/docs/dyn/compute_beta.networkEdgeSecurityServices.html @@ -78,7 +78,7 @@

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 NetworkEdgeSecurityService resources available to

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -313,17 +313,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.networkEndpointGroups.html b/docs/dyn/compute_beta.networkEndpointGroups.html index 1560748eb4..6d0f9349c5 100644 --- a/docs/dyn/compute_beta.networkEndpointGroups.html +++ b/docs/dyn/compute_beta.networkEndpointGroups.html @@ -78,7 +78,7 @@

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 network endpoint groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

@@ -105,10 +105,10 @@

Instance Methods

listNetworkEndpoints(project, zone, networkEndpointGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

@@ -522,17 +522,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2974,31 +2974,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.networkFirewallPolicies.html b/docs/dyn/compute_beta.networkFirewallPolicies.html index 0b53436abb..5a2b542db2 100644 --- a/docs/dyn/compute_beta.networkFirewallPolicies.html +++ b/docs/dyn/compute_beta.networkFirewallPolicies.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of network firewall policies, listing network

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cloneRules(project, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

@@ -120,7 +120,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the policies that have been configured for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -2119,17 +2119,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5411,17 +5411,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.networkProfiles.html b/docs/dyn/compute_beta.networkProfiles.html index 6c94633151..e864212f00 100644 --- a/docs/dyn/compute_beta.networkProfiles.html +++ b/docs/dyn/compute_beta.networkProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of network profiles available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.networks.html b/docs/dyn/compute_beta.networks.html index 3355f2af6c..032fae83ac 100644 --- a/docs/dyn/compute_beta.networks.html +++ b/docs/dyn/compute_beta.networks.html @@ -102,10 +102,10 @@

Instance Methods

listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, returnPartialSuccess=None, x__xgafv=None)

Lists the peering routes exchanged over peering connection.

- listPeeringRoutes_next(previous_request, previous_response)

+ listPeeringRoutes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, network, body=None, requestId=None, x__xgafv=None)

@@ -3353,31 +3353,31 @@

Method Details

- listPeeringRoutes_next(previous_request, previous_response) + listPeeringRoutes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.nodeGroups.html b/docs/dyn/compute_beta.nodeGroups.html index fe0eba8fbe..08a66abae7 100644 --- a/docs/dyn/compute_beta.nodeGroups.html +++ b/docs/dyn/compute_beta.nodeGroups.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node groups.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listNodes(project, zone, nodeGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists nodes in the node group.

- listNodes_next(previous_request, previous_response)

+ listNodes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

@@ -720,17 +720,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2692,31 +2692,31 @@

Method Details

- listNodes_next(previous_request, previous_response) + listNodes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.nodeTemplates.html b/docs/dyn/compute_beta.nodeTemplates.html index 94b6fd9707..4511a09e10 100644 --- a/docs/dyn/compute_beta.nodeTemplates.html +++ b/docs/dyn/compute_beta.nodeTemplates.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node templates.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node templates available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1736,17 +1736,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.nodeTypes.html b/docs/dyn/compute_beta.nodeTypes.html index adfab9dadf..77403fc292 100644 --- a/docs/dyn/compute_beta.nodeTypes.html +++ b/docs/dyn/compute_beta.nodeTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -343,17 +343,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -653,17 +653,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.organizationRolloutPlans.html b/docs/dyn/compute_beta.organizationRolloutPlans.html index 2b2e373beb..601b6831d8 100644 --- a/docs/dyn/compute_beta.organizationRolloutPlans.html +++ b/docs/dyn/compute_beta.organizationRolloutPlans.html @@ -90,7 +90,7 @@

Instance Methods

list(organization, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists OrganizationRolloutPlans in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1150,17 +1150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.organizationRollouts.html b/docs/dyn/compute_beta.organizationRollouts.html index 28158a8b90..b595bdae02 100644 --- a/docs/dyn/compute_beta.organizationRollouts.html +++ b/docs/dyn/compute_beta.organizationRollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(organization, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Rollouts in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(organization, rollout, etag=None, requestId=None, x__xgafv=None)

@@ -1349,17 +1349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.organizationSecurityPolicies.html b/docs/dyn/compute_beta.organizationSecurityPolicies.html index cd824fc8e3..0c579b84e7 100644 --- a/docs/dyn/compute_beta.organizationSecurityPolicies.html +++ b/docs/dyn/compute_beta.organizationSecurityPolicies.html @@ -111,7 +111,7 @@

Instance Methods

listPreconfiguredExpressionSets(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(securityPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -5186,17 +5186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.packetMirrorings.html b/docs/dyn/compute_beta.packetMirrorings.html index 6b3fa41fad..e257d67c63 100644 --- a/docs/dyn/compute_beta.packetMirrorings.html +++ b/docs/dyn/compute_beta.packetMirrorings.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of packetMirrorings.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of PacketMirroring resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, packetMirroring, body=None, requestId=None, x__xgafv=None)

@@ -389,17 +389,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1483,17 +1483,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.previewFeatures.html b/docs/dyn/compute_beta.previewFeatures.html index db2d262368..1cb9b52138 100644 --- a/docs/dyn/compute_beta.previewFeatures.html +++ b/docs/dyn/compute_beta.previewFeatures.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns the details of the given PreviewFeature.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, previewFeature, body=None, requestId=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.projects.html b/docs/dyn/compute_beta.projects.html index 0a64dbf908..f8ac3992e8 100644 --- a/docs/dyn/compute_beta.projects.html +++ b/docs/dyn/compute_beta.projects.html @@ -99,13 +99,13 @@

Instance Methods

getXpnResources(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets service resources (a.k.a service project) associated with this host

- getXpnResources_next(previous_request, previous_response)

+ getXpnResources_next()

Retrieves the next page of results.

listXpnHosts(project, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all shared VPC host projects visible to the user in an organization.

- listXpnHosts_next(previous_request, previous_response)

+ listXpnHosts_next()

Retrieves the next page of results.

moveDisk(project, body=None, requestId=None, x__xgafv=None)

@@ -1703,17 +1703,17 @@

Method Details

- getXpnResources_next(previous_request, previous_response) + getXpnResources_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)
+        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.
-
+ 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. +
@@ -1950,17 +1950,17 @@

Method Details

- listXpnHosts_next(previous_request, previous_response) + listXpnHosts_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.publicAdvertisedPrefixes.html b/docs/dyn/compute_beta.publicAdvertisedPrefixes.html index 35f3d490af..d5c4ce3542 100644 --- a/docs/dyn/compute_beta.publicAdvertisedPrefixes.html +++ b/docs/dyn/compute_beta.publicAdvertisedPrefixes.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicAdvertisedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicAdvertisedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1390,17 +1390,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.publicDelegatedPrefixes.html b/docs/dyn/compute_beta.publicDelegatedPrefixes.html index 8083311a9c..8c2bad5caf 100644 --- a/docs/dyn/compute_beta.publicDelegatedPrefixes.html +++ b/docs/dyn/compute_beta.publicDelegatedPrefixes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Lists all PublicDelegatedPrefix resources owned by the specific project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

announce(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicDelegatedPrefixes for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -403,17 +403,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1825,17 +1825,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.recoverableSnapshots.html b/docs/dyn/compute_beta.recoverableSnapshots.html index 2662bde070..d265527a4b 100644 --- a/docs/dyn/compute_beta.recoverableSnapshots.html +++ b/docs/dyn/compute_beta.recoverableSnapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all of the RecoverableSnapshots in your project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

recover(project, recoverableSnapshot, requestId=None, snapshotName=None, x__xgafv=None)

@@ -1589,17 +1589,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionAutoscalers.html b/docs/dyn/compute_beta.regionAutoscalers.html index a0b7d21d5a..0aeaeaf9c0 100644 --- a/docs/dyn/compute_beta.regionAutoscalers.html +++ b/docs/dyn/compute_beta.regionAutoscalers.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -1968,17 +1968,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionBackendBuckets.html b/docs/dyn/compute_beta.regionBackendBuckets.html index 576ef35293..1b5aab3e3a 100644 --- a/docs/dyn/compute_beta.regionBackendBuckets.html +++ b/docs/dyn/compute_beta.regionBackendBuckets.html @@ -96,10 +96,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project in

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -2174,31 +2174,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionBackendServices.html b/docs/dyn/compute_beta.regionBackendServices.html index 21e133b046..784c60ef49 100644 --- a/docs/dyn/compute_beta.regionBackendServices.html +++ b/docs/dyn/compute_beta.regionBackendServices.html @@ -99,10 +99,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendService, body=None, requestId=None, x__xgafv=None)

@@ -7014,31 +7014,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionCommitments.html b/docs/dyn/compute_beta.regionCommitments.html index bc8da939c5..d9192f2dcb 100644 --- a/docs/dyn/compute_beta.regionCommitments.html +++ b/docs/dyn/compute_beta.regionCommitments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of commitments by region.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of commitments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -691,17 +691,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2384,17 +2384,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionCompositeHealthChecks.html b/docs/dyn/compute_beta.regionCompositeHealthChecks.html index 5783e66b7a..8a1c6fe38c 100644 --- a/docs/dyn/compute_beta.regionCompositeHealthChecks.html +++ b/docs/dyn/compute_beta.regionCompositeHealthChecks.html @@ -78,7 +78,7 @@

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 CompositeHealthCheck resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the CompositeHealthChecks for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, compositeHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -333,17 +333,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1275,17 +1275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionDiskTypes.html b/docs/dyn/compute_beta.regionDiskTypes.html index bdb8124400..f42893732e 100644 --- a/docs/dyn/compute_beta.regionDiskTypes.html +++ b/docs/dyn/compute_beta.regionDiskTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of regional disk types available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionDisks.html b/docs/dyn/compute_beta.regionDisks.html index 6e5f6a0dc7..7bb57466fe 100644 --- a/docs/dyn/compute_beta.regionDisks.html +++ b/docs/dyn/compute_beta.regionDisks.html @@ -102,7 +102,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)

@@ -4452,17 +4452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionHealthAggregationPolicies.html b/docs/dyn/compute_beta.regionHealthAggregationPolicies.html index 878dac7de7..588ff6bbdd 100644 --- a/docs/dyn/compute_beta.regionHealthAggregationPolicies.html +++ b/docs/dyn/compute_beta.regionHealthAggregationPolicies.html @@ -78,7 +78,7 @@

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(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthAggregationPolicy, body=None, requestId=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1307,17 +1307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionHealthCheckServices.html b/docs/dyn/compute_beta.regionHealthCheckServices.html index 06a0968cc5..4bfe4dacdc 100644 --- a/docs/dyn/compute_beta.regionHealthCheckServices.html +++ b/docs/dyn/compute_beta.regionHealthCheckServices.html @@ -78,7 +78,7 @@

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 HealthCheckService resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the HealthCheckService resources that have been

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheckService, body=None, requestId=None, x__xgafv=None)

@@ -362,17 +362,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1374,17 +1374,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionHealthChecks.html b/docs/dyn/compute_beta.regionHealthChecks.html index 7abdb719bb..9d659bab97 100644 --- a/docs/dyn/compute_beta.regionHealthChecks.html +++ b/docs/dyn/compute_beta.regionHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -1920,17 +1920,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionHealthSources.html b/docs/dyn/compute_beta.regionHealthSources.html index dcf7343147..d3c945de1e 100644 --- a/docs/dyn/compute_beta.regionHealthSources.html +++ b/docs/dyn/compute_beta.regionHealthSources.html @@ -78,7 +78,7 @@

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 HealthSource resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the HealthSources for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthSource, body=None, requestId=None, x__xgafv=None)

@@ -336,17 +336,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1300,17 +1300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionInstanceGroupManagerResizeRequests.html b/docs/dyn/compute_beta.regionInstanceGroupManagerResizeRequests.html index 0a071586d7..8a45d0e6b3 100644 --- a/docs/dyn/compute_beta.regionInstanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_beta.regionInstanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Resize Requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2174,17 +2174,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionInstanceGroupManagers.html b/docs/dyn/compute_beta.regionInstanceGroupManagers.html index 51f347dec9..2d1d0d4973 100644 --- a/docs/dyn/compute_beta.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_beta.regionInstanceGroupManagers.html @@ -111,22 +111,22 @@

Instance Methods

listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given regional

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the managed instance group and instances that are

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -7167,17 +7167,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -8103,17 +8103,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -8319,31 +8319,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionInstanceGroups.html b/docs/dyn/compute_beta.regionInstanceGroups.html index aeff1f9ab4..9940d464ea 100644 --- a/docs/dyn/compute_beta.regionInstanceGroups.html +++ b/docs/dyn/compute_beta.regionInstanceGroups.html @@ -87,10 +87,10 @@

Instance Methods

listInstances(project, region, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group and displays

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setNamedPorts(project, region, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -544,31 +544,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionInstanceTemplates.html b/docs/dyn/compute_beta.regionInstanceTemplates.html index a2528271f6..47a9d10ff5 100644 --- a/docs/dyn/compute_beta.regionInstanceTemplates.html +++ b/docs/dyn/compute_beta.regionInstanceTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, view=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -4239,17 +4239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionInstantSnapshotGroups.html b/docs/dyn/compute_beta.regionInstantSnapshotGroups.html index 153f63ba33..2c7a20ddc0 100644 --- a/docs/dyn/compute_beta.regionInstantSnapshotGroups.html +++ b/docs/dyn/compute_beta.regionInstantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1362,17 +1362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionInstantSnapshots.html b/docs/dyn/compute_beta.regionInstantSnapshots.html index 309c5d4fcb..4eadafce0f 100644 --- a/docs/dyn/compute_beta.regionInstantSnapshots.html +++ b/docs/dyn/compute_beta.regionInstantSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1536,17 +1536,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionMultiMigMembers.html b/docs/dyn/compute_beta.regionMultiMigMembers.html index c32e0cc14a..7d159c5072 100644 --- a/docs/dyn/compute_beta.regionMultiMigMembers.html +++ b/docs/dyn/compute_beta.regionMultiMigMembers.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, multiMig, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of members of a specific multi-MIG.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionMultiMigs.html b/docs/dyn/compute_beta.regionMultiMigs.html index 9b1297e299..c9d6246cad 100644 --- a/docs/dyn/compute_beta.regionMultiMigs.html +++ b/docs/dyn/compute_beta.regionMultiMigs.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of multi-MIGs in a project and region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1305,17 +1305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionNetworkEndpointGroups.html b/docs/dyn/compute_beta.regionNetworkEndpointGroups.html index 841659ae7f..a74ba7ebe5 100644 --- a/docs/dyn/compute_beta.regionNetworkEndpointGroups.html +++ b/docs/dyn/compute_beta.regionNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, region, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2491,31 +2491,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regionNetworkFirewallPolicies.html b/docs/dyn/compute_beta.regionNetworkFirewallPolicies.html index 7539d6a77a..a375d9bd48 100644 --- a/docs/dyn/compute_beta.regionNetworkFirewallPolicies.html +++ b/docs/dyn/compute_beta.regionNetworkFirewallPolicies.html @@ -111,7 +111,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the network firewall policies that have been configured

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -4627,17 +4627,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionNetworkPolicies.html b/docs/dyn/compute_beta.regionNetworkPolicies.html index ab551055ef..d9b564a328 100644 --- a/docs/dyn/compute_beta.regionNetworkPolicies.html +++ b/docs/dyn/compute_beta.regionNetworkPolicies.html @@ -84,7 +84,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of network policies.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,7 +108,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the policies that have been configured for the specified project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, networkPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1106,17 +1106,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2320,17 +2320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionNotificationEndpoints.html b/docs/dyn/compute_beta.regionNotificationEndpoints.html index 4b8f9247b0..1d8584b2e9 100644 --- a/docs/dyn/compute_beta.regionNotificationEndpoints.html +++ b/docs/dyn/compute_beta.regionNotificationEndpoints.html @@ -78,7 +78,7 @@

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 NotificationEndpoint resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NotificationEndpoints for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1300,17 +1300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionOperations.html b/docs/dyn/compute_beta.regionOperations.html index 290a792dc8..eff83b6cb9 100644 --- a/docs/dyn/compute_beta.regionOperations.html +++ b/docs/dyn/compute_beta.regionOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, region, operation, x__xgafv=None)

@@ -821,17 +821,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionSecurityPolicies.html b/docs/dyn/compute_beta.regionSecurityPolicies.html index 4a1e41cf91..a649a12ebf 100644 --- a/docs/dyn/compute_beta.regionSecurityPolicies.html +++ b/docs/dyn/compute_beta.regionSecurityPolicies.html @@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

List all the policies that have been configured for the specified project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -4291,17 +4291,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionSnapshots.html b/docs/dyn/compute_beta.regionSnapshots.html index bd381bc133..4d2da92902 100644 --- a/docs/dyn/compute_beta.regionSnapshots.html +++ b/docs/dyn/compute_beta.regionSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -2260,17 +2260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionSslCertificates.html b/docs/dyn/compute_beta.regionSslCertificates.html index 4905b62250..422180aa0c 100644 --- a/docs/dyn/compute_beta.regionSslCertificates.html +++ b/docs/dyn/compute_beta.regionSslCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -1124,17 +1124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionSslPolicies.html b/docs/dyn/compute_beta.regionSslPolicies.html index 77b250edfe..f3522cc32a 100644 --- a/docs/dyn/compute_beta.regionSslPolicies.html +++ b/docs/dyn/compute_beta.regionSslPolicies.html @@ -96,7 +96,7 @@

Instance Methods

listAvailableFeatures(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1607,17 +1607,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionTargetHttpProxies.html b/docs/dyn/compute_beta.regionTargetHttpProxies.html index 9bea84bdd9..5c4d069530 100644 --- a/docs/dyn/compute_beta.regionTargetHttpProxies.html +++ b/docs/dyn/compute_beta.regionTargetHttpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setUrlMap(project, region, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -1114,17 +1114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionTargetHttpsProxies.html b/docs/dyn/compute_beta.regionTargetHttpsProxies.html index ab26ceed28..0281abc0dc 100644 --- a/docs/dyn/compute_beta.regionTargetHttpsProxies.html +++ b/docs/dyn/compute_beta.regionTargetHttpsProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -1414,17 +1414,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionTargetTcpProxies.html b/docs/dyn/compute_beta.regionTargetTcpProxies.html index 21d0a62bfa..9cac998dcc 100644 --- a/docs/dyn/compute_beta.regionTargetTcpProxies.html +++ b/docs/dyn/compute_beta.regionTargetTcpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -990,17 +990,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionUrlMaps.html b/docs/dyn/compute_beta.regionUrlMaps.html index 99011a59ad..e1190692cb 100644 --- a/docs/dyn/compute_beta.regionUrlMaps.html +++ b/docs/dyn/compute_beta.regionUrlMaps.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -12504,17 +12504,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.regionZones.html b/docs/dyn/compute_beta.regionZones.html index 88c1a8828d..c31f61b877 100644 --- a/docs/dyn/compute_beta.regionZones.html +++ b/docs/dyn/compute_beta.regionZones.html @@ -81,7 +81,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources under the specific region available to

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.regions.html b/docs/dyn/compute_beta.regions.html index 4089f19361..49bd148e46 100644 --- a/docs/dyn/compute_beta.regions.html +++ b/docs/dyn/compute_beta.regions.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of region resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -478,17 +478,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.reliabilityRisks.html b/docs/dyn/compute_beta.reliabilityRisks.html index 9bd1540e9d..70904cab46 100644 --- a/docs/dyn/compute_beta.reliabilityRisks.html +++ b/docs/dyn/compute_beta.reliabilityRisks.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of reliabilityRisks available in the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -312,17 +312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.reservationBlocks.html b/docs/dyn/compute_beta.reservationBlocks.html index 202f2e1eec..35cab62fd5 100644 --- a/docs/dyn/compute_beta.reservationBlocks.html +++ b/docs/dyn/compute_beta.reservationBlocks.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation blocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, reservationBlock, body=None, requestId=None, x__xgafv=None)

@@ -792,17 +792,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.reservationSlots.html b/docs/dyn/compute_beta.reservationSlots.html index 837baaadd3..bb859a0a6e 100644 --- a/docs/dyn/compute_beta.reservationSlots.html +++ b/docs/dyn/compute_beta.reservationSlots.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation slots under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, parentName, reservationSlot, body=None, updateMask=None, x__xgafv=None)

@@ -995,17 +995,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.reservationSubBlocks.html b/docs/dyn/compute_beta.reservationSubBlocks.html index 8503ae963f..c69b21c785 100644 --- a/docs/dyn/compute_beta.reservationSubBlocks.html +++ b/docs/dyn/compute_beta.reservationSubBlocks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation subBlocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)

@@ -1121,17 +1121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.reservations.html b/docs/dyn/compute_beta.reservations.html index 1edefc5d83..6de734eee2 100644 --- a/docs/dyn/compute_beta.reservations.html +++ b/docs/dyn/compute_beta.reservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, body=None, requestId=None, x__xgafv=None)

@@ -550,17 +550,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2461,17 +2461,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.resourcePolicies.html b/docs/dyn/compute_beta.resourcePolicies.html index 08248ab895..4bd0376baf 100644 --- a/docs/dyn/compute_beta.resourcePolicies.html +++ b/docs/dyn/compute_beta.resourcePolicies.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of resource policies.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list all the resource policies that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, resourcePolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -429,17 +429,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1991,17 +1991,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.rolloutPlans.html b/docs/dyn/compute_beta.rolloutPlans.html index f5ac9b9c60..5667f22bc4 100644 --- a/docs/dyn/compute_beta.rolloutPlans.html +++ b/docs/dyn/compute_beta.rolloutPlans.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists RolloutPlans in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1150,17 +1150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.rollouts.html b/docs/dyn/compute_beta.rollouts.html index 48f9e5883a..a1986a3022 100644 --- a/docs/dyn/compute_beta.rollouts.html +++ b/docs/dyn/compute_beta.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Rollouts in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(project, rollout, etag=None, requestId=None, x__xgafv=None)

@@ -1349,17 +1349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.routers.html b/docs/dyn/compute_beta.routers.html index 50953cdad4..8a0206cd63 100644 --- a/docs/dyn/compute_beta.routers.html +++ b/docs/dyn/compute_beta.routers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of routers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

getNatMappingInfo(project, region, router, filter=None, maxResults=None, natName=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves runtime Nat mapping information of VM endpoints.

- getNatMappingInfo_next(previous_request, previous_response)

+ getNatMappingInfo_next()

Retrieves the next page of results.

getRoutePolicy(project, region, router, policy=None, x__xgafv=None)

@@ -123,22 +123,22 @@

Instance Methods

listBgpRoutes(project, region, router, addressFamily=None, destinationPrefix=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peer=None, policyApplied=None, returnPartialSuccess=None, routeType=None, x__xgafv=None)

Retrieves a list of router bgp routes available to the specified project.

- listBgpRoutes_next(previous_request, previous_response)

+ 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(previous_request, previous_response)

+ 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

- listRoutePolicies_next(previous_request, previous_response)

+ listRoutePolicies_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, router, body=None, requestId=None, x__xgafv=None)

@@ -868,17 +868,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2661,17 +2661,17 @@

Method Details

- getNatMappingInfo_next(previous_request, previous_response) + getNatMappingInfo_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)
+        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.
-
+ 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. +
@@ -5193,17 +5193,17 @@

Method Details

- listBgpRoutes_next(previous_request, previous_response) + listBgpRoutes_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)
+        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.
-
+ 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. +
@@ -5411,17 +5411,17 @@

Method Details

- listNamedSets_next(previous_request, previous_response) + listNamedSets_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)
+        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.
-
+ 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. +
@@ -5679,31 +5679,31 @@

Method Details

- listRoutePolicies_next(previous_request, previous_response) + 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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.routes.html b/docs/dyn/compute_beta.routes.html index 9a3e7dea0a..8ee9418223 100644 --- a/docs/dyn/compute_beta.routes.html +++ b/docs/dyn/compute_beta.routes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Route resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, resource, body=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.securityPolicies.html b/docs/dyn/compute_beta.securityPolicies.html index 8a0ec9a793..3f0e8d91c4 100644 --- a/docs/dyn/compute_beta.securityPolicies.html +++ b/docs/dyn/compute_beta.securityPolicies.html @@ -81,7 +81,7 @@

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 SecurityPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

listPreconfiguredExpressionSets(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1790,17 +1790,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5346,17 +5346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.serviceAttachments.html b/docs/dyn/compute_beta.serviceAttachments.html index a491bb5119..f420d54e19 100644 --- a/docs/dyn/compute_beta.serviceAttachments.html +++ b/docs/dyn/compute_beta.serviceAttachments.html @@ -78,7 +78,7 @@

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 ServiceAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the ServiceAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, serviceAttachment, body=None, requestId=None, x__xgafv=None)

@@ -440,17 +440,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2034,17 +2034,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.snapshotGroups.html b/docs/dyn/compute_beta.snapshotGroups.html index c6963966d5..3cc81dd955 100644 --- a/docs/dyn/compute_beta.snapshotGroups.html +++ b/docs/dyn/compute_beta.snapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1341,17 +1341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.snapshots.html b/docs/dyn/compute_beta.snapshots.html index 9f8f3c925a..ff7917a21f 100644 --- a/docs/dyn/compute_beta.snapshots.html +++ b/docs/dyn/compute_beta.snapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the snapshots in your project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,7 +102,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -636,17 +636,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2821,17 +2821,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.sslCertificates.html b/docs/dyn/compute_beta.sslCertificates.html index 197648d262..7b87a0e673 100644 --- a/docs/dyn/compute_beta.sslCertificates.html +++ b/docs/dyn/compute_beta.sslCertificates.html @@ -78,7 +78,7 @@

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 SslCertificate resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, resource, body=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1405,17 +1405,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.sslPolicies.html b/docs/dyn/compute_beta.sslPolicies.html index 9fcf51e9d8..ba07ef4d30 100644 --- a/docs/dyn/compute_beta.sslPolicies.html +++ b/docs/dyn/compute_beta.sslPolicies.html @@ -78,7 +78,7 @@

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 SslPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,7 +102,7 @@

Instance Methods

listAvailableFeatures(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1885,17 +1885,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.storagePoolTypes.html b/docs/dyn/compute_beta.storagePoolTypes.html index 2d808ab3df..39ec5977c8 100644 --- a/docs/dyn/compute_beta.storagePoolTypes.html +++ b/docs/dyn/compute_beta.storagePoolTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pool types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of storage pool types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -340,17 +340,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -651,17 +651,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_beta.storagePools.html b/docs/dyn/compute_beta.storagePools.html index 51d2a73708..5a30a0cfb8 100644 --- a/docs/dyn/compute_beta.storagePools.html +++ b/docs/dyn/compute_beta.storagePools.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listDisks(project, zone, storagePool, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the disks in a specified storage pool.

- listDisks_next(previous_request, previous_response)

+ listDisks_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -435,17 +435,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2167,31 +2167,31 @@

Method Details

- listDisks_next(previous_request, previous_response) + listDisks_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.subnetworks.html b/docs/dyn/compute_beta.subnetworks.html index bd312ec8ac..b7ef3cd694 100644 --- a/docs/dyn/compute_beta.subnetworks.html +++ b/docs/dyn/compute_beta.subnetworks.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, views=None, x__xgafv=None)

Retrieves an aggregated list of subnetworks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,10 +105,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProject=None, x__xgafv=None)

Retrieves an aggregated list of all usable subnetworks in the project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, subnetwork, body=None, drainTimeoutSeconds=None, requestId=None, x__xgafv=None)

@@ -579,17 +579,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3072,31 +3072,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetGrpcProxies.html b/docs/dyn/compute_beta.targetGrpcProxies.html index c109ba2890..3bd334faf5 100644 --- a/docs/dyn/compute_beta.targetGrpcProxies.html +++ b/docs/dyn/compute_beta.targetGrpcProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the TargetGrpcProxies for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetGrpcProxy, body=None, requestId=None, x__xgafv=None)

@@ -1000,17 +1000,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetHttpProxies.html b/docs/dyn/compute_beta.targetHttpProxies.html index 8698fc1ea1..00187f5a46 100644 --- a/docs/dyn/compute_beta.targetHttpProxies.html +++ b/docs/dyn/compute_beta.targetHttpProxies.html @@ -78,7 +78,7 @@

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 TargetHttpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -372,17 +372,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1396,17 +1396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetHttpsProxies.html b/docs/dyn/compute_beta.targetHttpsProxies.html index 847cf2a7a6..53d3b38481 100644 --- a/docs/dyn/compute_beta.targetHttpsProxies.html +++ b/docs/dyn/compute_beta.targetHttpsProxies.html @@ -78,7 +78,7 @@

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 TargetHttpsProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -482,17 +482,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1800,17 +1800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetInstances.html b/docs/dyn/compute_beta.targetInstances.html index df013f1ec4..86e239b93a 100644 --- a/docs/dyn/compute_beta.targetInstances.html +++ b/docs/dyn/compute_beta.targetInstances.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target instances.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetInstance resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setSecurityPolicy(project, zone, targetInstance, body=None, requestId=None, x__xgafv=None)

@@ -329,17 +329,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1242,17 +1242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetPools.html b/docs/dyn/compute_beta.targetPools.html index 1c40629201..9f6f6159c3 100644 --- a/docs/dyn/compute_beta.targetPools.html +++ b/docs/dyn/compute_beta.targetPools.html @@ -84,7 +84,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target pools available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

@@ -1021,17 +1021,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2083,17 +2083,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetSslProxies.html b/docs/dyn/compute_beta.targetSslProxies.html index 7e8cbf92d0..c693cce677 100644 --- a/docs/dyn/compute_beta.targetSslProxies.html +++ b/docs/dyn/compute_beta.targetSslProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetSslProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

@@ -1007,17 +1007,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetTcpProxies.html b/docs/dyn/compute_beta.targetTcpProxies.html index 50739211d3..0ed14abf9a 100644 --- a/docs/dyn/compute_beta.targetTcpProxies.html +++ b/docs/dyn/compute_beta.targetTcpProxies.html @@ -78,7 +78,7 @@

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 TargetTcpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None)

@@ -332,17 +332,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1235,17 +1235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.targetVpnGateways.html b/docs/dyn/compute_beta.targetVpnGateways.html index bd1c297b65..a2fbc79fbd 100644 --- a/docs/dyn/compute_beta.targetVpnGateways.html +++ b/docs/dyn/compute_beta.targetVpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1354,17 +1354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.urlMaps.html b/docs/dyn/compute_beta.urlMaps.html index 5e5508b2a3..6fe3d1bb1c 100644 --- a/docs/dyn/compute_beta.urlMaps.html +++ b/docs/dyn/compute_beta.urlMaps.html @@ -78,7 +78,7 @@

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 UrlMap resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -4068,17 +4068,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -16505,17 +16505,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.vpnGateways.html b/docs/dyn/compute_beta.vpnGateways.html index 74fb5cbf95..cc59824989 100644 --- a/docs/dyn/compute_beta.vpnGateways.html +++ b/docs/dyn/compute_beta.vpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1486,17 +1486,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.vpnTunnels.html b/docs/dyn/compute_beta.vpnTunnels.html index 9019c33e45..0e58065907 100644 --- a/docs/dyn/compute_beta.vpnTunnels.html +++ b/docs/dyn/compute_beta.vpnTunnels.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN tunnels.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VpnTunnel resources contained in the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -454,17 +454,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1740,17 +1740,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.wireGroups.html b/docs/dyn/compute_beta.wireGroups.html index e5bff49b28..9d5c6bebd0 100644 --- a/docs/dyn/compute_beta.wireGroups.html +++ b/docs/dyn/compute_beta.wireGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(project, crossSiteNetwork, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the wire groups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, wireGroup, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.zoneOperations.html b/docs/dyn/compute_beta.zoneOperations.html index 2b1e4e6517..05e54c6554 100644 --- a/docs/dyn/compute_beta.zoneOperations.html +++ b/docs/dyn/compute_beta.zoneOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, zone, operation, x__xgafv=None)

@@ -821,17 +821,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.zoneVmExtensionPolicies.html b/docs/dyn/compute_beta.zoneVmExtensionPolicies.html index 3916f70d3f..286d601e8d 100644 --- a/docs/dyn/compute_beta.zoneVmExtensionPolicies.html +++ b/docs/dyn/compute_beta.zoneVmExtensionPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extension policies within a specific zone for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1052,17 +1052,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_beta.zones.html b/docs/dyn/compute_beta.zones.html index 94f2bedc32..cd828d2086 100644 --- a/docs/dyn/compute_beta.zones.html +++ b/docs/dyn/compute_beta.zones.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -588,17 +588,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_preview.acceleratorTypes.html b/docs/dyn/compute_preview.acceleratorTypes.html new file mode 100644 index 0000000000..befa7b3820 --- /dev/null +++ b/docs/dyn/compute_preview.acceleratorTypes.html @@ -0,0 +1,605 @@ + + + +

Compute Engine API . acceleratorTypes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of accelerator types.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, acceleratorType, x__xgafv=None)

+

Returns the specified accelerator type.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of accelerator types that are available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of accelerator types.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of AcceleratorTypesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of accelerator types.
+      "acceleratorTypes": [ # [Output Only] A list of accelerator types contained in this scope.
+        { # Represents an Accelerator Type resource.
+            #
+            # Google Cloud Platform provides graphics processing units (accelerators) that
+            # you can add to VM instances to improve or accelerate performance when working
+            # with intensive workloads. For more information, readGPUs on Compute Engine.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339 text format.
+          "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this accelerator type.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DELETED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DEPRECATED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to OBSOLETE. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+                # The suggested replacement resource must be the same kind of resource as the
+                # deprecated resource.
+            "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+                # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+                # warning indicating the deprecated resource and recommending its
+                # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+          },
+          "description": "A String", # [Output Only] An optional textual description of the resource.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#acceleratorType", # Output only. [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types.
+          "maximumCardsPerInstance": 42, # [Output Only] Maximum number of accelerator cards allowed per instance.
+          "name": "A String", # [Output Only] Name of the resource.
+          "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an AcceleratorType
+              # resource. It is populated for each instance of the AcceleratorType
+              # resource, and includes the api_version the
+              # instance was retrieved through, and its canonical
+              # resource_type name.
+            "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+                # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+            "resourceType": "A String", # The canonical resource type name in the format of a resource type
+                # as defined by [AIP-123](https://google.aip.dev/123).
+                # For example, `"compute.googleapis.com/Instance"`.
+          },
+          "selfLink": "A String", # Output only. [Output Only] Server-defined, fully qualified URL for this resource.
+          "zone": "A String", # [Output Only] The name of the zone where the accelerator type resides,
+              # such as us-central1-a.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that appears when the accelerator
+          # types 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#acceleratorTypeAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of
+      # accelerator types.
+  "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.
+
+ +
+ get(project, zone, acceleratorType, x__xgafv=None) + 
Returns the specified accelerator type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  acceleratorType: string, Name of the accelerator type 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 an Accelerator Type resource.
+    #
+    # Google Cloud Platform provides graphics processing units (accelerators) that
+    # you can add to VM instances to improve or accelerate performance when working
+    # with intensive workloads. For more information, readGPUs on Compute Engine.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339 text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this accelerator type.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional textual description of the resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#acceleratorType", # Output only. [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types.
+  "maximumCardsPerInstance": 42, # [Output Only] Maximum number of accelerator cards allowed per instance.
+  "name": "A String", # [Output Only] Name of the resource.
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an AcceleratorType
+      # resource. It is populated for each instance of the AcceleratorType
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined, fully qualified URL for this resource.
+  "zone": "A String", # [Output Only] The name of the zone where the accelerator type resides,
+      # such as us-central1-a.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of accelerator types that are available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 accelerator types.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of AcceleratorType resources.
+    { # Represents an Accelerator Type resource.
+        #
+        # Google Cloud Platform provides graphics processing units (accelerators) that
+        # you can add to VM instances to improve or accelerate performance when working
+        # with intensive workloads. For more information, readGPUs on Compute Engine.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339 text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this accelerator type.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional textual description of the resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#acceleratorType", # Output only. [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types.
+      "maximumCardsPerInstance": 42, # [Output Only] Maximum number of accelerator cards allowed per instance.
+      "name": "A String", # [Output Only] Name of the resource.
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an AcceleratorType
+          # resource. It is populated for each instance of the AcceleratorType
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "selfLink": "A String", # Output only. [Output Only] Server-defined, fully qualified URL for this resource.
+      "zone": "A String", # [Output Only] The name of the zone where the accelerator type resides,
+          # such as us-central1-a.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#acceleratorTypeList", # Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.addresses.html b/docs/dyn/compute_preview.addresses.html new file mode 100644 index 0000000000..0beee1892e --- /dev/null +++ b/docs/dyn/compute_preview.addresses.html @@ -0,0 +1,2285 @@ + + + +

Compute Engine API . addresses

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of addresses.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, address, requestId=None, x__xgafv=None)

+

Deletes the specified address resource.

+

+ get(project, region, address, x__xgafv=None)

+

Returns the specified address resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates an address resource in the specified project by using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of addresses contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ move(project, region, address, body=None, requestId=None, x__xgafv=None)

+

Moves the specified address resource.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on an Address. To learn more about labels, read theLabeling

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of addresses.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of AddressesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of addresses.
+      "addresses": [ # [Output Only] A list of addresses contained in this scope.
+        { # Represents an IP Address resource.
+            #
+            # Google Compute Engine has two IP Address resources:
+            #
+            # * [Global (external and
+            # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+            # * [Regional (external and
+            # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+            #
+            # For more information, see
+            # Reserving a static external IP address.
+          "address": "A String", # The static IP address represented by this resource.
+          "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this field 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.
+          "ipCollection": "A String", # Reference to the source of IP addresses.
+              #
+              # It supports the following cases:
+              #
+              #    -
+              #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+              #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+              #      allocations. If an IPv6 PDP is used, the PDP must be in
+              #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+              #    -
+              #      Case 2: Internal Range for global internal addresses.
+              #
+              #
+              #
+              # Use one of the following formats to specify the resource:
+              #
+              # For a Public Delegated Prefix:
+              #
+              #    -
+              #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+              #    - Partial URL:
+              #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+              #       - regions/region/publicDelegatedPrefixes/pdp-name
+              #
+              #
+              #
+              # For an Internal Range:
+              #
+              #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+              #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+          "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+          "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+              # or NETLB. This is used for deciding which type of endpoint
+              # this address can be used after the external IPv6 address reservation.
+          "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+              # addresses.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+              # essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve an Address.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "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])?`. The first character
+              # must be a lowercase letter, and all following characters (except for the
+              # last character) must be a dash, lowercase letter, or digit. The last
+              # character must be a lowercase letter or digit.
+          "network": "A String", # The URL of the network in which to reserve the address. This field can
+              # only be used with INTERNAL type with theVPC_PEERING purpose.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+              # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+              # global external IP addresses are always Premium Tier; regional external IP
+              # addresses can be either Standard or Premium Tier.
+              #
+              # If this field is not specified, it is assumed to be PREMIUM.
+          "prefixLength": 42, # The prefix length if the resource represents an IP range.
+          "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+              #
+              #
+              #      - GCE_ENDPOINT for addresses that are used by VM
+              #      instances, alias IP ranges, load balancers, and similar resources.
+              #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+              #        for a Cloud DNS  inbound
+              #        forwarder IP addresses (regional internal IP address in a subnet of
+              #        a VPC network)
+              #      - VPC_PEERING for global internal IP addresses used for
+              #
+              #           private services access allocated ranges.
+              #      - NAT_AUTO for the regional external IP addresses used by
+              #           Cloud NAT when allocating addresses using
+              #
+              #           automatic NAT IP address allocation.
+              #      - IPSEC_INTERCONNECT for addresses created from a private
+              #      IP range that are reserved for a VLAN attachment in an
+              #      *HA VPN over Cloud Interconnect* configuration. These addresses
+              #      are regional resources.
+              #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+              #      to multiple internal forwarding rules.
+              #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+              #      used to configure Private Service Connect. Only global internal addresses
+              #      can use this purpose.
+              #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+              #      that can only be assigned to global external Passthrough Network Load
+              #      Balancer forwarding rules, as an Availability Group 0 address.
+              #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+              #      can only be assigned to global external Passthrough Network Load Balancer
+              #      forwarding rules, as an Availability Group 1 address.
+          "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+              # For regional addresses, you must specify the region as a path parameter in
+              # the HTTP request URL. *This field is not applicable to global
+              # addresses.*
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+              # An address that is RESERVING is currently in the process of
+              # being reserved. A RESERVED address is currently reserved and
+              # available to use. An IN_USE address is currently being used
+              # by another resource and is not available.
+          "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+              # is specified, it must be within the subnetwork's IP range. This field can
+              # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+          "users": [ # [Output Only] The URLs of the resources that are using this address.
+            "A String",
+          ],
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of addresses
+          # 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#addressAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of
+      # addresses.
+  "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, address, requestId=None, x__xgafv=None) + 
Deletes the specified address resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  address: string, Name of the address 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, address, x__xgafv=None) + 
Returns the specified address resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  address: string, Name of the address 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 an IP Address resource.
+    #
+    # Google Compute Engine has two IP Address resources:
+    #
+    # * [Global (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+    # * [Regional (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+    #
+    # For more information, see
+    # Reserving a static external IP address.
+  "address": "A String", # The static IP address represented by this resource.
+  "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field 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.
+  "ipCollection": "A String", # Reference to the source of IP addresses.
+      #
+      # It supports the following cases:
+      #
+      #    -
+      #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+      #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+      #      allocations. If an IPv6 PDP is used, the PDP must be in
+      #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #    -
+      #      Case 2: Internal Range for global internal addresses.
+      #
+      #
+      #
+      # Use one of the following formats to specify the resource:
+      #
+      # For a Public Delegated Prefix:
+      #
+      #    -
+      #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+      #    - Partial URL:
+      #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+      #       - regions/region/publicDelegatedPrefixes/pdp-name
+      #
+      #
+      #
+      # For an Internal Range:
+      #
+      #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+      #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+  "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+  "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+      # or NETLB. This is used for deciding which type of endpoint
+      # this address can be used after the external IPv6 address reservation.
+  "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+      # addresses.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Address.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # The URL of the network in which to reserve the address. This field can
+      # only be used with INTERNAL type with theVPC_PEERING purpose.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+      # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+      # global external IP addresses are always Premium Tier; regional external IP
+      # addresses can be either Standard or Premium Tier.
+      #
+      # If this field is not specified, it is assumed to be PREMIUM.
+  "prefixLength": 42, # The prefix length if the resource represents an IP range.
+  "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+      #
+      #
+      #      - GCE_ENDPOINT for addresses that are used by VM
+      #      instances, alias IP ranges, load balancers, and similar resources.
+      #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+      #        for a Cloud DNS  inbound
+      #        forwarder IP addresses (regional internal IP address in a subnet of
+      #        a VPC network)
+      #      - VPC_PEERING for global internal IP addresses used for
+      #
+      #           private services access allocated ranges.
+      #      - NAT_AUTO for the regional external IP addresses used by
+      #           Cloud NAT when allocating addresses using
+      #
+      #           automatic NAT IP address allocation.
+      #      - IPSEC_INTERCONNECT for addresses created from a private
+      #      IP range that are reserved for a VLAN attachment in an
+      #      *HA VPN over Cloud Interconnect* configuration. These addresses
+      #      are regional resources.
+      #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+      #      to multiple internal forwarding rules.
+      #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+      #      used to configure Private Service Connect. Only global internal addresses
+      #      can use this purpose.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+      #      that can only be assigned to global external Passthrough Network Load
+      #      Balancer forwarding rules, as an Availability Group 0 address.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+      #      can only be assigned to global external Passthrough Network Load Balancer
+      #      forwarding rules, as an Availability Group 1 address.
+  "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+      # For regional addresses, you must specify the region as a path parameter in
+      # the HTTP request URL. *This field is not applicable to global
+      # addresses.*
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+      # An address that is RESERVING is currently in the process of
+      # being reserved. A RESERVED address is currently reserved and
+      # available to use. An IN_USE address is currently being used
+      # by another resource and is not available.
+  "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+      # is specified, it must be within the subnetwork's IP range. This field can
+      # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+  "users": [ # [Output Only] The URLs of the resources that are using this address.
+    "A String",
+  ],
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates an address resource in the specified project by using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an IP Address resource.
+    # 
+    # Google Compute Engine has two IP Address resources:
+    # 
+    # * [Global (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+    # * [Regional (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+    # 
+    # For more information, see
+    # Reserving a static external IP address.
+  "address": "A String", # The static IP address represented by this resource.
+  "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field 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.
+  "ipCollection": "A String", # Reference to the source of IP addresses.
+      # 
+      # It supports the following cases:
+      # 
+      #    -
+      #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+      #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+      #      allocations. If an IPv6 PDP is used, the PDP must be in
+      #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #    -
+      #      Case 2: Internal Range for global internal addresses.
+      # 
+      # 
+      # 
+      # Use one of the following formats to specify the resource:
+      # 
+      # For a Public Delegated Prefix:
+      # 
+      #    -
+      #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+      #    - Partial URL:
+      #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+      #       - regions/region/publicDelegatedPrefixes/pdp-name
+      # 
+      # 
+      # 
+      # For an Internal Range:
+      # 
+      #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+      #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+  "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+  "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+      # or NETLB. This is used for deciding which type of endpoint
+      # this address can be used after the external IPv6 address reservation.
+  "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+      # addresses.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Address.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # The URL of the network in which to reserve the address. This field can
+      # only be used with INTERNAL type with theVPC_PEERING purpose.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+      # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+      # global external IP addresses are always Premium Tier; regional external IP
+      # addresses can be either Standard or Premium Tier.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+  "prefixLength": 42, # The prefix length if the resource represents an IP range.
+  "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+      # 
+      # 
+      #      - GCE_ENDPOINT for addresses that are used by VM
+      #      instances, alias IP ranges, load balancers, and similar resources.
+      #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+      #        for a Cloud DNS  inbound
+      #        forwarder IP addresses (regional internal IP address in a subnet of
+      #        a VPC network)
+      #      - VPC_PEERING for global internal IP addresses used for
+      # 
+      #           private services access allocated ranges.
+      #      - NAT_AUTO for the regional external IP addresses used by
+      #           Cloud NAT when allocating addresses using
+      # 
+      #           automatic NAT IP address allocation.
+      #      - IPSEC_INTERCONNECT for addresses created from a private
+      #      IP range that are reserved for a VLAN attachment in an
+      #      *HA VPN over Cloud Interconnect* configuration. These addresses
+      #      are regional resources.
+      #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+      #      to multiple internal forwarding rules.
+      #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+      #      used to configure Private Service Connect. Only global internal addresses
+      #      can use this purpose.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+      #      that can only be assigned to global external Passthrough Network Load
+      #      Balancer forwarding rules, as an Availability Group 0 address.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+      #      can only be assigned to global external Passthrough Network Load Balancer
+      #      forwarding rules, as an Availability Group 1 address.
+  "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+      # For regional addresses, you must specify the region as a path parameter in
+      # the HTTP request URL. *This field is not applicable to global
+      # addresses.*
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+      # An address that is RESERVING is currently in the process of
+      # being reserved. A RESERVED address is currently reserved and
+      # available to use. An IN_USE address is currently being used
+      # by another resource and is not available.
+  "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+      # is specified, it must be within the subnetwork's IP range. This field can
+      # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+  "users": [ # [Output Only] The URLs of the resources that are using this address.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of addresses contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 addresses.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Address resources.
+    { # Represents an IP Address resource.
+        #
+        # Google Compute Engine has two IP Address resources:
+        #
+        # * [Global (external and
+        # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+        # * [Regional (external and
+        # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+        #
+        # For more information, see
+        # Reserving a static external IP address.
+      "address": "A String", # The static IP address represented by this resource.
+      "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this field 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.
+      "ipCollection": "A String", # Reference to the source of IP addresses.
+          #
+          # It supports the following cases:
+          #
+          #    -
+          #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+          #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+          #      allocations. If an IPv6 PDP is used, the PDP must be in
+          #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+          #    -
+          #      Case 2: Internal Range for global internal addresses.
+          #
+          #
+          #
+          # Use one of the following formats to specify the resource:
+          #
+          # For a Public Delegated Prefix:
+          #
+          #    -
+          #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+          #    - Partial URL:
+          #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+          #       - regions/region/publicDelegatedPrefixes/pdp-name
+          #
+          #
+          #
+          # For an Internal Range:
+          #
+          #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+          #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+      "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+      "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+          # or NETLB. This is used for deciding which type of endpoint
+          # this address can be used after the external IPv6 address reservation.
+      "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+          # addresses.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an Address.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # The URL of the network in which to reserve the address. This field can
+          # only be used with INTERNAL type with theVPC_PEERING purpose.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+          # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+          # global external IP addresses are always Premium Tier; regional external IP
+          # addresses can be either Standard or Premium Tier.
+          #
+          # If this field is not specified, it is assumed to be PREMIUM.
+      "prefixLength": 42, # The prefix length if the resource represents an IP range.
+      "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+          #
+          #
+          #      - GCE_ENDPOINT for addresses that are used by VM
+          #      instances, alias IP ranges, load balancers, and similar resources.
+          #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+          #        for a Cloud DNS  inbound
+          #        forwarder IP addresses (regional internal IP address in a subnet of
+          #        a VPC network)
+          #      - VPC_PEERING for global internal IP addresses used for
+          #
+          #           private services access allocated ranges.
+          #      - NAT_AUTO for the regional external IP addresses used by
+          #           Cloud NAT when allocating addresses using
+          #
+          #           automatic NAT IP address allocation.
+          #      - IPSEC_INTERCONNECT for addresses created from a private
+          #      IP range that are reserved for a VLAN attachment in an
+          #      *HA VPN over Cloud Interconnect* configuration. These addresses
+          #      are regional resources.
+          #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+          #      to multiple internal forwarding rules.
+          #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+          #      used to configure Private Service Connect. Only global internal addresses
+          #      can use this purpose.
+          #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+          #      that can only be assigned to global external Passthrough Network Load
+          #      Balancer forwarding rules, as an Availability Group 0 address.
+          #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+          #      can only be assigned to global external Passthrough Network Load Balancer
+          #      forwarding rules, as an Availability Group 1 address.
+      "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+          # For regional addresses, you must specify the region as a path parameter in
+          # the HTTP request URL. *This field is not applicable to global
+          # addresses.*
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+          # An address that is RESERVING is currently in the process of
+          # being reserved. A RESERVED address is currently reserved and
+          # available to use. An IN_USE address is currently being used
+          # by another resource and is not available.
+      "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+          # is specified, it must be within the subnetwork's IP range. This field can
+          # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+      "users": [ # [Output Only] The URLs of the resources that are using this address.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#addressList", # Output only. [Output Only] Type of resource. Always compute#addressList for
+      # lists of addresses.
+  "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.
+  "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.
+
+
+ +
+ move(project, region, address, body=None, requestId=None, x__xgafv=None) + 
Moves the specified address resource.
+
+Args:
+  project: string, Source project ID which the Address is moved from. (required)
+  region: string, Name of the region for this request. (required)
+  address: string, Name of the address resource to move. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "description": "A String", # An optional destination address description if intended to be different
+      # from the source.
+  "destinationAddress": "A String", # The URL of the destination address to move to. This can be a full or
+      # partial URL. For example, the following are all valid URLs to a address:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address
+      #    - projects/project/regions/region/addresses/address
+      # 
+      # 
+      # Note that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on an Address. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.advice.html b/docs/dyn/compute_preview.advice.html new file mode 100644 index 0000000000..0a46bfffc3 --- /dev/null +++ b/docs/dyn/compute_preview.advice.html @@ -0,0 +1,444 @@ + + + +

Compute Engine API . advice

+

Instance Methods

+

+ calendarMode(project, region, body=None, x__xgafv=None)

+

Advise how, where and when to create the requested amount of instances

+

+ capacity(project, region, body=None, x__xgafv=None)

+

Advice on making real-time decisions (such as choosing zone or

+

+ capacityHistory(project, region, body=None, x__xgafv=None)

+

Gets the capacity history.

+

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ calendarMode(project, region, body=None, x__xgafv=None) + 
Advise how, where and when to create the requested amount of instances
+with specified accelerators, within the specified time and location limits.
+The method recommends creating future reservations for the requested
+resources.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A request to recommend the best way to consume the specified resources in the
+    # future.
+  "futureResourcesSpecs": { # Specification of resources to create in the future.
+      # The key of the map is an arbitrary string specified by the caller.
+      # Value of the map is a specification of required resources and their
+      # constraints. Currently only one value is allowed in this map.
+    "a_key": { # Specification of resources to be created at some time in the future within an
+        # optionally specified set of locations, and within the specified time range.
+      "deploymentType": "A String", # Indicates if the reservation allocation strategy is static (DENSE) or
+          # dynamic (STANDARD). Defaults to DENSE.
+      "locationPolicy": { # Specification of locations to create resources in. # Optional location policy allowing to exclude some zone(s) in which
+          # the resources must not be created.
+        "locations": { # Preferences for specified locations.
+            # Keys of the map are locations - zones, in format of 'zones/'.
+            # Values are preferences for the zones.
+            # If a zone is not specified in this map, it is ALLOWed.
+          "a_key": { # Preference for a single specified location.
+            "preference": "A String", # Preference for this location.
+          },
+        },
+      },
+      "targetResources": { # Specification of reserved resources. # Specification of the reserved resources.
+        "aggregateResources": {
+          "acceleratorCount": "A String", # Size of the request, in accelerator (chip) count.
+          "vmFamily": "A String", # The VM family that all instances scheduled against this reservation
+              # must belong to. Use for TPU reservations.
+          "workloadType": "A String", # Workload type. Use for TPU reservations.
+        },
+        "specificSkuResources": {
+          "instanceCount": "A String", # Size of the request, in instance count.
+          "localSsdPartitions": [ # Local SSD partitions. You do not have to include SSD partitions that
+              # are built in the machine type.
+            {
+              "diskInterface": "A String", # Disk interface. Defaults to SCSI.
+              "diskSizeGb": "A String", # The size of the disk in GB.
+            },
+          ],
+          "machineType": "A String", # The machine type to use for instances that will use the reservation.
+              # This field only accepts machine type names. e.g. n2-standard-4
+              # and does not accept machine type full or partial url. e.g.
+              # projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4.
+              # Use for GPU reservations.
+        },
+      },
+      "timeRangeSpec": { # Specifies a flexible time range with flexible start time and duration. # Specification of a time range in which the resources may be created.
+          # The time range specifies start of resource use and planned end of resource
+          # use.
+          #
+          # It is possible to specify a contradictory time range that cannot be matched
+          # by any Interval. This causes a validation error.
+        "maxDuration": "A String",
+        "minDuration": "A String",
+        "startTimeNotEarlierThan": "A String",
+        "startTimeNotLaterThan": "A String",
+      },
+    },
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A response containing the recommended way of creating the specified resources
+    # in the future. It contains (will contain) multiple recommendations that can
+    # be analyzed by the customer and the best one can be picked.
+  "recommendations": [ # Recommendations where, how and when to create the requested resources
+      # in order to maximize their obtainability and minimize cost.
+    { # A single recommendation to create requested resources. Contains detailed
+        # recommendations for every future resources specification specified in
+        # CalendarModeAdviceRequest.
+      "recommendationsPerSpec": { # Recommendations for every future resource specification passed in
+          # CalendarModeAdviceRequest. Keys of the map correspond to keys
+          # specified in the request.
+        "a_key": { # Recommendation for single resources specification, to be created in the
+            # future.
+          "endTime": "A String",
+          "location": "A String", # The advised location for resource usage. When a zone, in format
+              # 'zones/'.
+              # If not set, it means that no location is recommended - see
+              # other_locations for details.
+          "otherLocations": { # List of locations in the request scope that were not
+              # recommended. Keys of the map are zones, in format 'zones/'.
+              # The values are status information indicating the recommendation status.
+            "a_key": { # Information about recommendation status for locations
+                # that were allowed but not used by the response.
+              "details": "A String", # Details (human readable) describing the situation.
+                  # For example, if status is CONDITION_NOT_MET, then
+                  # details contain information about the parameters of the time window
+                  # that did not meet the required conditions.
+              "status": "A String", # Status of recommendation in this location.
+            },
+          },
+          "recommendationId": "A String", # Unique id of the recommendation, a UUID string generated by the API.
+          "recommendationType": "A String", # Type of recommendation. Currently only FUTURE_RESERVATION is supported.
+          "startTime": "A String",
+        },
+      },
+    },
+  ],
+}
+
+ +
+ capacity(project, region, body=None, x__xgafv=None) + 
Advice on making real-time decisions (such as choosing zone or
+machine types) during deployment to maximize your chances of obtaining
+capacity.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A request to provide Assistant Scores. These scores determine VM
+    # obtainability and preemption likelihood.
+  "distributionPolicy": { # Distribution policy. # Policy specifying the distribution of instances across
+      # zones within the requested region.
+    "targetShape": "A String", # Target distribution shape. You can specify the following values:ANY, ANY_SINGLE_ZONE, or BALANCED.
+    "zones": [ # Zones where Capacity Advisor looks for capacity.
+      { # Zone configuration for the distribution policy.
+        "zone": "A String", # The URL of the zone. It can be a
+            # partial or full URL. For example, the following are valid values:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone
+            #    - projects/project/zones/zone
+            #    - zones/zone
+      },
+    ],
+  },
+  "instanceFlexibilityPolicy": { # Specification of alternative, flexible instance configurations. # Policy for instance selectors.
+    "instanceSelections": { # Named instance selections to configure properties.
+        # The key is an arbitrary, unique RFC1035 string that identifies the
+        # instance selection.
+      "a_key": { # Machine specification.
+        "disks": [ # Local SSDs.
+          { # Attached disk configuration.
+            "type": "A String", # Specifies the type of the disk.
+          },
+        ],
+        "guestAccelerators": [ # Accelerators configuration.
+          { # A specification of the type and number of accelerator cards attached to the
+              # instance.
+            "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+            "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                # If you are creating an instance template, specify only the
+                # accelerator name.
+                # See GPUs on Compute Engine
+                # for a full list of accelerator types.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "rank": "A String", # Optional. Rank when prioritizing the shape flexibilities.
+            # The instance selections are considered in the ascending order of the
+            # rank. If not set, defaults to 0.
+      },
+    },
+  },
+  "instanceProperties": { # Instance provisioning properties. # Instance properties for this request.
+    "scheduling": { # Defines the instance scheduling options. # Specifies the scheduling options.
+      "provisioningModel": "A String", # Specifies the provisioning model.
+    },
+  },
+  "size": 42, # The number of VM instances to request.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A response contains scoring recommendations.
+  "recommendations": [ # Initially the API will provide one recommendation which balances the
+      # individual scores according to the service provider's preference.
+    { # Recommendation.
+      "scores": { # Groups information about a shard of capacity. # Scores for the recommendation.
+        "estimatedUptime": "A String", # The estimated run time of the majority of Spot VMs in the request
+            # before preemption. The estimate is best-effort only. It is based on
+            # historical data and current conditions.
+        "obtainability": 3.14, # The obtainability score indicates the likelihood of successfully
+            # obtaining (provisioning) the requested number of VMs.
+            # The score range is 0.0 through 1.0. Higher is better.
+      },
+      "shards": [ # Shards represent blocks of uniform capacity in recommendations.
+        { # Shards represent blocks of uniform capacity in recommendations.
+            # Each shard is for a single zone and a single machine shape. Each shard
+            # defines a size expressed as the number of VMs.
+          "instanceCount": 42, # The number of instances.
+          "machineType": "A String", # The machine type corresponds to the instance selection in the request.
+          "provisioningModel": "A String", # The provisioning model that you want to view recommendations for.
+          "zone": "A String", # Output only. The zone name for this shard.
+        },
+      ],
+    },
+  ],
+}
+
+ +
+ capacityHistory(project, region, body=None, x__xgafv=None) + 
Gets the capacity history.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A request to get the capacity history.
+  "instanceProperties": { # Instance properties for this request. # Instance properties for this request.
+    "disks": [ # Local SSDs.
+      { # AttachedDisk modeled after Instance's AttachedDisk.
+        "type": "A String", # Specifies the type of the disk.
+      },
+    ],
+    "guestAccelerators": [ # Accelerators configuration.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "machineType": "A String", # The machine type for the VM, such as `n2-standard-4`.
+    "scheduling": { # Scheduling options. # Specifies the scheduling options.
+      "provisioningModel": "A String", # The provisioning model to get capacity history for.
+          # This field must be set to SPOT.
+          #
+          # For more information, see
+          # Compute Engine instances provisioning models.
+    },
+  },
+  "locationPolicy": { # Location policy for this request. # Location policy for this request.
+    "location": "A String", # The region or zone to get capacity history for.
+        #
+        # It can be a partial or full URL. For example, the following are valid
+        # values:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone
+        #    - projects/project/zones/zone
+        #    - zones/zone
+        #
+        #
+        #
+        # This field is optional.
+  },
+  "types": [ # List of history types to get capacity history for.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Contains the capacity history.
+  "location": "A String", # Output only. The location (region or zone) for which the capacity history is returned.
+      # It is returned as a URL - For example,https://www.googleapis.com/compute/v1/projects/project/zones/zone.
+  "machineType": "A String", # The machine type for which the capacity history is returned.
+  "preemptionHistory": [ # The preemption history for the requested machine type and location.
+    { # A record of Spot VM preemption history.
+      "interval": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a # The time interval for this preemption record.
+          # Timestamp end (exclusive).
+          #
+          # The start must be less than or equal to the end.
+          # When the start equals the end, the interval is empty (matches no time).
+          # When both start and end are unspecified, the interval matches any time.
+        "endTime": "A String", # Optional. Exclusive end of the interval.
+            #
+            # If specified, a Timestamp matching this interval will have to be before the
+            # end.
+        "startTime": "A String", # Optional. Inclusive start of the interval.
+            #
+            # If specified, a Timestamp matching this interval will have to be the same
+            # or after the start.
+      },
+      "preemptionRate": 3.14, # The preemption rate during the interval, representing the fraction of
+          # Spot VMs that were preempted. Range: 0.0 to 1.0. Preemption rate is
+          # calculated as (total preempted Spots) / (total Spots that stopped
+          # running).
+    },
+  ],
+  "priceHistory": [ # The price history for the requested machine type and location.
+    { # A record of price history.
+      "interval": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a # The time interval for this price record.
+          # Timestamp end (exclusive).
+          #
+          # The start must be less than or equal to the end.
+          # When the start equals the end, the interval is empty (matches no time).
+          # When both start and end are unspecified, the interval matches any time.
+        "endTime": "A String", # Optional. Exclusive end of the interval.
+            #
+            # If specified, a Timestamp matching this interval will have to be before the
+            # end.
+        "startTime": "A String", # Optional. Inclusive start of the interval.
+            #
+            # If specified, a Timestamp matching this interval will have to be the same
+            # or after the start.
+      },
+      "listPrice": { # Represents an amount of money with its currency type. # The Spot VM list price during the interval.
+        "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+        "nanos": 42, # Number of nano (10^-9) units of the amount.
+            # The value must be between -999,999,999 and +999,999,999 inclusive.
+            # If `units` is positive, `nanos` must be positive or zero.
+            # If `units` is zero, `nanos` can be positive, zero, or negative.
+            # If `units` is negative, `nanos` must be negative or zero.
+            # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        "units": "A String", # The whole units of the amount.
+            # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+      },
+    },
+  ],
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.autoscalers.html b/docs/dyn/compute_preview.autoscalers.html new file mode 100644 index 0000000000..a3541e5fd1 --- /dev/null +++ b/docs/dyn/compute_preview.autoscalers.html @@ -0,0 +1,3766 @@ + + + +

Compute Engine API . autoscalers

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of autoscalers.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, autoscaler, requestId=None, x__xgafv=None)

+

Deletes the specified autoscaler.

+

+ get(project, zone, autoscaler, x__xgafv=None)

+

Returns the specified autoscaler resource.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates an autoscaler in the specified project using the data

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of autoscalers contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None)

+

Updates an autoscaler in the specified project using the data

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None)

+

Updates an autoscaler in the specified project using the data

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of autoscalers.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of AutoscalersScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of autoscalers.
+      "autoscalers": [ # [Output Only] A list of autoscalers contained in this scope.
+        { # Represents an Autoscaler resource.
+            #
+            # Google Compute Engine has two Autoscaler resources:
+            #
+            # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+            # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+            #
+            # Use autoscalers to automatically add or delete instances from a
+            # managed instance group according to your defined autoscaling policy.
+            # For more information, read Autoscaling Groups of Instances.
+            #
+            # For zonal managed instance groups resource, use the autoscaler
+            # resource.
+            #
+            # For regional managed instance groups, use theregionAutoscalers resource.
+          "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+              # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+              #
+              # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+            "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+                # instance. This is referred to as the
+                # [initialization period](/compute/docs/autoscaler#cool_down_period).
+                # Specifying an accurate initialization period improves
+                # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+                # data from VMs that are still initializing because those VMs might not yet
+                # represent normal usage of your application. The default initialization
+                # period is 60 seconds.
+                #
+                # Initialization periods might vary because of numerous
+                # factors. We recommend that you test how long your application takes to
+                # initialize. To do this, create a VM and time your application's startup
+                # process.
+            "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+                # based on the average CPU utilization of a managed instance group.
+              "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+                  # Valid values are:
+                  #
+                  # * NONE (default). No predictive method is used. The autoscaler scales the
+                  # group to meet current demand based on real-time metrics.
+                  # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+                  # monitoring daily and weekly load patterns and scaling out ahead of
+                  # anticipated demand.
+              "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+                  # a float value in the range (0, 1]. If not specified, the default is0.6.
+                  #
+                  # If the CPU level is below the target utilization, the autoscaler scales
+                  # in the number of instances until it reaches the minimum number of
+                  # instances you specified or until the average CPU of your instances
+                  # reaches the target utilization.
+                  #
+                  # If the average CPU is above the target utilization, the autoscaler
+                  # scales out until it reaches the maximum number of instances you
+                  # specified or until the average utilization reaches the target
+                  # utilization.
+            },
+            "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+              { # Custom utilization metric policy.
+                "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+                    # used to select a specific TimeSeries for the purpose of autoscaling and
+                    # to determine whether the metric is exporting per-instance or
+                    # per-group data.
+                    #
+                    # For the filter to be valid for autoscaling purposes, the following rules
+                    # apply:
+                    #
+                    #
+                    #     - You can only use the AND operator for joining
+                    #        selectors.
+                    #     - You can only use direct equality comparison operator
+                    #        (=) without any functions for each selector.
+                    #     - You can specify the metric in both the filter string and in the
+                    #        metric field. However, if specified in both places, the metric must
+                    #        be identical.
+                    #     - The monitored resource type
+                    #        determines what kind of values are expected for the metric. If it is
+                    #        a gce_instance, the autoscaler expects the metric to
+                    #        include a separate TimeSeries for each instance in a group. In such a
+                    #        case, you cannot filter on resource labels.
+                    #
+                    #
+                    #    If the resource type is any other value, the autoscaler expects
+                    #        this metric to contain values that apply to the entire autoscaled
+                    #        instance group and resource label filtering can be performed to
+                    #        point autoscaler at the correct TimeSeries to scale upon. This is
+                    #        called a *per-group metric* for the purpose of autoscaling.
+                    #
+                    #        If not specified, the type defaults to
+                    #        gce_instance.
+                    #
+                    #
+                    #
+                    # Try to provide a filter that is selective enough to pick just one
+                    # TimeSeries for the autoscaled group or for each of the instances (if you
+                    # are using gce_instance resource type). If multiple
+                    # TimeSeries are returned upon the query execution, the autoscaler will sum
+                    # their respective values to obtain its scaling value.
+                "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+                    # cannot have negative values.
+                    #
+                    # The metric must have a value type of INT64 orDOUBLE.
+                "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+                    # total amount of work to be done or resource usage, set this value to an
+                    # amount assigned for a single instance of the scaled group. Autoscaler
+                    # keeps the number of instances proportional to the value of this
+                    # metric. The metric itself does not change value due to group
+                    # resizing.
+                    #
+                    # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+                    # or a custom metric exporting the total number of requests coming to
+                    # your instances.
+                    #
+                    # A bad example would be a metric exporting an average or median latency,
+                    # since this value can't include a chunk assignable to a single instance,
+                    # it could be better used with utilization_target instead.
+                "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+                    # must be a positive value. A utilization metric scales number of
+                    # virtual machines handling requests to increase or decrease
+                    # proportionally to the metric.
+                    #
+                    # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+                    # The autoscaler works to keep this value constant for each of the
+                    # instances.
+                "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+                    # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+              },
+            ],
+            "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+              "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+                  # configuration) that the autoscaler maintains. Must be a positive float
+                  # value. If not defined, the default is 0.8.
+            },
+            "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+                # is required when creating or updating an autoscaler. The maximum number
+                # of replicas must not be lower than minimal number of replicas.
+            "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+                # This cannot be less than 0. If not provided, autoscaler chooses a
+                # default value depending on maximum number of instances allowed.
+            "mode": "A String", # Defines the operating mode for this policy.
+                # The following modes are available:
+                #
+                #    - OFF: Disables the autoscaler but maintains its
+                #    configuration.
+                #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+                #    VM instances only.
+                #    - ON: Enables all autoscaler activities according to its
+                #    policy.
+                #
+                #
+                # For more information, see
+                # "Turning off or restricting an autoscaler"
+            "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+                # recommends an abrupt scale in of a MIG, it will be throttled as specified
+                # by the parameters below.
+              "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+                  # recommendation during the window autoscaler looks at when computing
+                  # recommendations. Possibly all these VMs can be deleted at once so user
+                  # service needs to be prepared to lose that many VMs in one step.
+                "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                    #
+                    #
+                    #
+                    #     - If the value is fixed, then the calculated
+                    #      value is equal to the fixed value.
+                    #     - If the value is a percent, then the
+                    #     calculated
+                    #      value is percent/100 * targetSize. For example,
+                    #      the calculated value of a 80% of a managed instance group
+                    #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                    #      is a remainder, the number is rounded.
+                "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+                "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                    # example, specify 80 for 80%.
+              },
+              "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+                  # include directives regarding slower scale in, as described above.
+            },
+            "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+                # can be set on an autoscaler, and they can overlap. During overlapping
+                # periods the greatest min_required_replicas of all scaling schedules is
+                # applied. Up to 128 scaling schedules are allowed.
+              "a_key": { # Scaling based on user-defined schedule. The message describes a single
+                  # scaling schedule. A scaling schedule changes the minimum number of VM
+                  # instances an autoscaler can recommend, which can trigger scaling out.
+                "description": "A String", # A description of a scaling schedule.
+                "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+                    # autoscaler recommendations. If set to true, then a scaling schedule has
+                    # no effect. This field is optional, and its value is false by default.
+                "durationSec": 42, # The duration of time intervals, in seconds, for which this
+                    # scaling schedule is to run. The minimum allowed value is 300.
+                    # This field is required.
+                "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+                    # recommend in time intervals starting according to schedule. This field is
+                    # required.
+                "schedule": "A String", # The start timestamps of time intervals when this scaling
+                    # schedule is to provide a scaling signal. This field uses the extended
+                    # cron format (with an optional year field). The expression can describe a
+                    # single timestamp if the optional year is set, in which case the scaling
+                    # schedule runs once. The schedule is interpreted with respect to
+                    # time_zone. This field is required. Note: These timestamps only describe
+                    # when autoscaler starts providing the scaling signal. The VMs
+                    # need additional time to become serving.
+                "timeZone": "A String", # The time zone to use when interpreting the schedule.
+                    # The value of this field must be a time zone name from the tz database:
+                    # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+                    # default value of "UTC" if left empty.
+              },
+            },
+            "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+                # making scale-in decisions. This is referred to as the
+                # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+                # This might appear as a delay in scaling in but it is an important mechanism
+                # for your application to not have fluctuating size due to short term load
+                # fluctuations.
+                #
+                # The default stabilization period is 600 seconds.
+          },
+          "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.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+              # for autoscalers.
+          "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.
+          "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+              # autoscaler. Autoscaler calculates the recommended MIG size even when the
+              # autoscaling policy mode is different from ON. This field is empty when
+              # autoscaler is not connected to an existing managed instance group or
+              # autoscaler did not generate its prediction.
+          "region": "A String", # Output only. [Output Only] URL of theregion
+              # where the instance group resides (for autoscalers living in regional
+              # scope).
+          "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+            "a_key": {
+              "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+                  # Note: this is a timestamp when a schedule actually became active, not when
+                  # it was planned to do so.
+                  # The timestamp is in RFC3339
+                  # text format.
+              "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+                  # Note: this is a timestamp when a schedule is planned to run, but the actual
+                  # time might be slightly different.
+                  # The timestamp is in RFC3339
+                  # text format.
+              "state": "A String", # [Output Only] The current state of a scaling schedule.
+            },
+          },
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+              # possible values:
+              #
+              #    - PENDING:
+              #      Autoscaler backend hasn't read new/updated configuration.
+              #    - DELETING:
+              #      Configuration is being deleted.
+              #    - ACTIVE:
+              #      Configuration is acknowledged to be effective. Some warnings might
+              #      be present in the statusDetails field.
+              #    - ERROR:
+              #      Configuration has errors. Actionable for users. Details are present in
+              #      the statusDetails field.
+              #
+              #
+              # New values might be added in the future.
+          "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+              # autoscaler. Read the documentation forCommonly
+              # returned status messages for examples of status messages you might
+              # encounter.
+            {
+              "message": "A String", # The status message.
+              "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+                  # values:
+                  #
+                  #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+                  #      All instances in the instance group are unhealthy (not in RUNNING
+                  #      state).
+                  #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+                  #      There is no backend service attached to the instance group.
+                  #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+                  #      Autoscaler recommends a size greater than maxNumReplicas.
+                  #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+                  #      The custom metric samples are not exported often enough to be
+                  #      a credible base for autoscaling.
+                  #    - CUSTOM_METRIC_INVALID (ERROR):
+                  #      The custom metric that was specified does not exist or does not have
+                  #      the necessary labels.
+                  #    - MIN_EQUALS_MAX (WARNING):
+                  #      The minNumReplicas is equal to maxNumReplicas. This means the
+                  #      autoscaler cannot add or remove instances from the instance group.
+                  #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+                  #      The autoscaler did not receive any data from the custom metric
+                  #      configured for autoscaling.
+                  #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+                  #      The autoscaler is configured to scale based on a load balancing signal
+                  #      but the instance group has not received any requests from the load
+                  #      balancer.
+                  #    - MODE_OFF (WARNING):
+                  #      Autoscaling is turned off. The number of instances in the group won't
+                  #      change automatically. The autoscaling configuration is preserved.
+                  #    - MODE_ONLY_UP (WARNING):
+                  #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+                  #      instances but not remove any.
+                  #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+                  #      The instance group cannot be autoscaled because it has more than one
+                  #      backend service attached to it.
+                  #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+                  #      There is insufficient quota for the necessary resources, such as CPU or
+                  #      number of instances.
+                  #    - REGION_RESOURCE_STOCKOUT (ERROR):
+                  #      Shown only for regional autoscalers: there is a resource stockout in
+                  #      the chosen region.
+                  #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+                  #      The target to be scaled does not exist.
+                  #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+                  #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+                  #      has been configured for maxRate.
+                  #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+                  #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+                  #      For regional autoscalers: in at least one of the zones you're using
+                  #      there is a resource stockout.
+                  #
+                  #
+                  # New values might be added in the future. Some of the values might not be
+                  # available in all API versions.
+            },
+          ],
+          "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+              # field is required when creating an autoscaler.
+          "zone": "A String", # Output only. [Output Only] URL of thezone
+              # where the instance group resides (for autoscalers living in zonal scope).
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of autoscalers
+          # 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#autoscalerAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of
+      # autoscalers.
+  "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.
+  },
+}
+
+ +
+ 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, zone, autoscaler, requestId=None, x__xgafv=None) + 
Deletes the specified autoscaler.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  autoscaler: string, Name of the autoscaler 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, autoscaler, x__xgafv=None) + 
Returns the specified autoscaler resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  autoscaler: string, Name of the autoscaler 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 an Autoscaler resource.
+    #
+    # Google Compute Engine has two Autoscaler resources:
+    #
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    #
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    #
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    #
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      #
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      #
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      #
+      #
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates an autoscaler in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of autoscalers contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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.
+  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 Autoscaler resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Autoscaler resources.
+    { # Represents an Autoscaler resource.
+        #
+        # Google Compute Engine has two Autoscaler resources:
+        #
+        # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+        # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+        #
+        # Use autoscalers to automatically add or delete instances from a
+        # managed instance group according to your defined autoscaling policy.
+        # For more information, read Autoscaling Groups of Instances.
+        #
+        # For zonal managed instance groups resource, use the autoscaler
+        # resource.
+        #
+        # For regional managed instance groups, use theregionAutoscalers resource.
+      "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+          # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+          #
+          # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+        "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+            # instance. This is referred to as the
+            # [initialization period](/compute/docs/autoscaler#cool_down_period).
+            # Specifying an accurate initialization period improves
+            # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+            # data from VMs that are still initializing because those VMs might not yet
+            # represent normal usage of your application. The default initialization
+            # period is 60 seconds.
+            #
+            # Initialization periods might vary because of numerous
+            # factors. We recommend that you test how long your application takes to
+            # initialize. To do this, create a VM and time your application's startup
+            # process.
+        "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+            # based on the average CPU utilization of a managed instance group.
+          "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+              # Valid values are:
+              #
+              # * NONE (default). No predictive method is used. The autoscaler scales the
+              # group to meet current demand based on real-time metrics.
+              # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+              # monitoring daily and weekly load patterns and scaling out ahead of
+              # anticipated demand.
+          "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+              # a float value in the range (0, 1]. If not specified, the default is0.6.
+              #
+              # If the CPU level is below the target utilization, the autoscaler scales
+              # in the number of instances until it reaches the minimum number of
+              # instances you specified or until the average CPU of your instances
+              # reaches the target utilization.
+              #
+              # If the average CPU is above the target utilization, the autoscaler
+              # scales out until it reaches the maximum number of instances you
+              # specified or until the average utilization reaches the target
+              # utilization.
+        },
+        "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+          { # Custom utilization metric policy.
+            "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+                # used to select a specific TimeSeries for the purpose of autoscaling and
+                # to determine whether the metric is exporting per-instance or
+                # per-group data.
+                #
+                # For the filter to be valid for autoscaling purposes, the following rules
+                # apply:
+                #
+                #
+                #     - You can only use the AND operator for joining
+                #        selectors.
+                #     - You can only use direct equality comparison operator
+                #        (=) without any functions for each selector.
+                #     - You can specify the metric in both the filter string and in the
+                #        metric field. However, if specified in both places, the metric must
+                #        be identical.
+                #     - The monitored resource type
+                #        determines what kind of values are expected for the metric. If it is
+                #        a gce_instance, the autoscaler expects the metric to
+                #        include a separate TimeSeries for each instance in a group. In such a
+                #        case, you cannot filter on resource labels.
+                #
+                #
+                #    If the resource type is any other value, the autoscaler expects
+                #        this metric to contain values that apply to the entire autoscaled
+                #        instance group and resource label filtering can be performed to
+                #        point autoscaler at the correct TimeSeries to scale upon. This is
+                #        called a *per-group metric* for the purpose of autoscaling.
+                #
+                #        If not specified, the type defaults to
+                #        gce_instance.
+                #
+                #
+                #
+                # Try to provide a filter that is selective enough to pick just one
+                # TimeSeries for the autoscaled group or for each of the instances (if you
+                # are using gce_instance resource type). If multiple
+                # TimeSeries are returned upon the query execution, the autoscaler will sum
+                # their respective values to obtain its scaling value.
+            "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+                # cannot have negative values.
+                #
+                # The metric must have a value type of INT64 orDOUBLE.
+            "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+                # total amount of work to be done or resource usage, set this value to an
+                # amount assigned for a single instance of the scaled group. Autoscaler
+                # keeps the number of instances proportional to the value of this
+                # metric. The metric itself does not change value due to group
+                # resizing.
+                #
+                # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+                # or a custom metric exporting the total number of requests coming to
+                # your instances.
+                #
+                # A bad example would be a metric exporting an average or median latency,
+                # since this value can't include a chunk assignable to a single instance,
+                # it could be better used with utilization_target instead.
+            "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+                # must be a positive value. A utilization metric scales number of
+                # virtual machines handling requests to increase or decrease
+                # proportionally to the metric.
+                #
+                # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+                # The autoscaler works to keep this value constant for each of the
+                # instances.
+            "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+                # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+          },
+        ],
+        "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+          "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+              # configuration) that the autoscaler maintains. Must be a positive float
+              # value. If not defined, the default is 0.8.
+        },
+        "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+            # is required when creating or updating an autoscaler. The maximum number
+            # of replicas must not be lower than minimal number of replicas.
+        "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+            # This cannot be less than 0. If not provided, autoscaler chooses a
+            # default value depending on maximum number of instances allowed.
+        "mode": "A String", # Defines the operating mode for this policy.
+            # The following modes are available:
+            #
+            #    - OFF: Disables the autoscaler but maintains its
+            #    configuration.
+            #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+            #    VM instances only.
+            #    - ON: Enables all autoscaler activities according to its
+            #    policy.
+            #
+            #
+            # For more information, see
+            # "Turning off or restricting an autoscaler"
+        "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+            # recommends an abrupt scale in of a MIG, it will be throttled as specified
+            # by the parameters below.
+          "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+              # recommendation during the window autoscaler looks at when computing
+              # recommendations. Possibly all these VMs can be deleted at once so user
+              # service needs to be prepared to lose that many VMs in one step.
+            "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                #
+                #
+                #
+                #     - If the value is fixed, then the calculated
+                #      value is equal to the fixed value.
+                #     - If the value is a percent, then the
+                #     calculated
+                #      value is percent/100 * targetSize. For example,
+                #      the calculated value of a 80% of a managed instance group
+                #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                #      is a remainder, the number is rounded.
+            "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+            "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                # example, specify 80 for 80%.
+          },
+          "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+              # include directives regarding slower scale in, as described above.
+        },
+        "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+            # can be set on an autoscaler, and they can overlap. During overlapping
+            # periods the greatest min_required_replicas of all scaling schedules is
+            # applied. Up to 128 scaling schedules are allowed.
+          "a_key": { # Scaling based on user-defined schedule. The message describes a single
+              # scaling schedule. A scaling schedule changes the minimum number of VM
+              # instances an autoscaler can recommend, which can trigger scaling out.
+            "description": "A String", # A description of a scaling schedule.
+            "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+                # autoscaler recommendations. If set to true, then a scaling schedule has
+                # no effect. This field is optional, and its value is false by default.
+            "durationSec": 42, # The duration of time intervals, in seconds, for which this
+                # scaling schedule is to run. The minimum allowed value is 300.
+                # This field is required.
+            "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+                # recommend in time intervals starting according to schedule. This field is
+                # required.
+            "schedule": "A String", # The start timestamps of time intervals when this scaling
+                # schedule is to provide a scaling signal. This field uses the extended
+                # cron format (with an optional year field). The expression can describe a
+                # single timestamp if the optional year is set, in which case the scaling
+                # schedule runs once. The schedule is interpreted with respect to
+                # time_zone. This field is required. Note: These timestamps only describe
+                # when autoscaler starts providing the scaling signal. The VMs
+                # need additional time to become serving.
+            "timeZone": "A String", # The time zone to use when interpreting the schedule.
+                # The value of this field must be a time zone name from the tz database:
+                # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+                # default value of "UTC" if left empty.
+          },
+        },
+        "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+            # making scale-in decisions. This is referred to as the
+            # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+            # This might appear as a delay in scaling in but it is an important mechanism
+            # for your application to not have fluctuating size due to short term load
+            # fluctuations.
+            #
+            # The default stabilization period is 600 seconds.
+      },
+      "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.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+          # for autoscalers.
+      "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.
+      "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+          # autoscaler. Autoscaler calculates the recommended MIG size even when the
+          # autoscaling policy mode is different from ON. This field is empty when
+          # autoscaler is not connected to an existing managed instance group or
+          # autoscaler did not generate its prediction.
+      "region": "A String", # Output only. [Output Only] URL of theregion
+          # where the instance group resides (for autoscalers living in regional
+          # scope).
+      "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+        "a_key": {
+          "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+              # Note: this is a timestamp when a schedule actually became active, not when
+              # it was planned to do so.
+              # The timestamp is in RFC3339
+              # text format.
+          "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+              # Note: this is a timestamp when a schedule is planned to run, but the actual
+              # time might be slightly different.
+              # The timestamp is in RFC3339
+              # text format.
+          "state": "A String", # [Output Only] The current state of a scaling schedule.
+        },
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+          # possible values:
+          #
+          #    - PENDING:
+          #      Autoscaler backend hasn't read new/updated configuration.
+          #    - DELETING:
+          #      Configuration is being deleted.
+          #    - ACTIVE:
+          #      Configuration is acknowledged to be effective. Some warnings might
+          #      be present in the statusDetails field.
+          #    - ERROR:
+          #      Configuration has errors. Actionable for users. Details are present in
+          #      the statusDetails field.
+          #
+          #
+          # New values might be added in the future.
+      "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+          # autoscaler. Read the documentation forCommonly
+          # returned status messages for examples of status messages you might
+          # encounter.
+        {
+          "message": "A String", # The status message.
+          "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+              # values:
+              #
+              #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+              #      All instances in the instance group are unhealthy (not in RUNNING
+              #      state).
+              #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+              #      There is no backend service attached to the instance group.
+              #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+              #      Autoscaler recommends a size greater than maxNumReplicas.
+              #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+              #      The custom metric samples are not exported often enough to be
+              #      a credible base for autoscaling.
+              #    - CUSTOM_METRIC_INVALID (ERROR):
+              #      The custom metric that was specified does not exist or does not have
+              #      the necessary labels.
+              #    - MIN_EQUALS_MAX (WARNING):
+              #      The minNumReplicas is equal to maxNumReplicas. This means the
+              #      autoscaler cannot add or remove instances from the instance group.
+              #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+              #      The autoscaler did not receive any data from the custom metric
+              #      configured for autoscaling.
+              #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+              #      The autoscaler is configured to scale based on a load balancing signal
+              #      but the instance group has not received any requests from the load
+              #      balancer.
+              #    - MODE_OFF (WARNING):
+              #      Autoscaling is turned off. The number of instances in the group won't
+              #      change automatically. The autoscaling configuration is preserved.
+              #    - MODE_ONLY_UP (WARNING):
+              #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+              #      instances but not remove any.
+              #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+              #      The instance group cannot be autoscaled because it has more than one
+              #      backend service attached to it.
+              #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+              #      There is insufficient quota for the necessary resources, such as CPU or
+              #      number of instances.
+              #    - REGION_RESOURCE_STOCKOUT (ERROR):
+              #      Shown only for regional autoscalers: there is a resource stockout in
+              #      the chosen region.
+              #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+              #      The target to be scaled does not exist.
+              #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+              #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+              #      has been configured for maxRate.
+              #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+              #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+              #      For regional autoscalers: in at least one of the zones you're using
+              #      there is a resource stockout.
+              #
+              #
+              # New values might be added in the future. Some of the values might not be
+              # available in all API versions.
+        },
+      ],
+      "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+          # field is required when creating an autoscaler.
+      "zone": "A String", # Output only. [Output Only] URL of thezone
+          # where the instance group resides (for autoscalers living in zonal scope).
+    },
+  ],
+  "kind": "compute#autoscalerList", # Output only. [Output Only] Type of resource. Always compute#autoscalerList
+      # for lists of autoscalers.
+  "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.
+  "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, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None) + 
Updates an autoscaler in the specified project using 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)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  autoscaler: string, Name of the autoscaler to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None) + 
Updates an autoscaler in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  autoscaler: string, Name of the autoscaler to update.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.backendBuckets.html b/docs/dyn/compute_preview.backendBuckets.html new file mode 100644 index 0000000000..b515262de6 --- /dev/null +++ b/docs/dyn/compute_preview.backendBuckets.html @@ -0,0 +1,5428 @@ + + + +

Compute Engine API . backendBuckets

+

Instance Methods

+

+ addSignedUrlKey(project, backendBucket, body=None, requestId=None, x__xgafv=None)

+

Adds a key for validating requests with signed URLs for this backend

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all BackendBucket resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, backendBucket, requestId=None, x__xgafv=None)

+

Deletes the specified BackendBucket resource.

+

+ deleteSignedUrlKey(project, backendBucket, keyName, requestId=None, x__xgafv=None)

+

Deletes a key for validating requests with signed URLs for this backend

+

+ get(project, backendBucket, x__xgafv=None)

+

Returns the specified BackendBucket 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 BackendBucket resource in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of BackendBucket resources available to the specified

+

+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of all usable backend buckets in the specified project.

+

+ listUsable_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, backendBucket, body=None, requestId=None, x__xgafv=None)

+

Updates the specified BackendBucket resource with the data included in the

+

+ setEdgeSecurityPolicy(project, backendBucket, body=None, requestId=None, x__xgafv=None)

+

Sets the edge security policy for the specified backend bucket.

+

+ 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.

+

+ update(project, backendBucket, body=None, requestId=None, x__xgafv=None)

+

Updates the specified BackendBucket resource with the data included in the

+

Method Details

+
+ addSignedUrlKey(project, backendBucket, body=None, requestId=None, x__xgafv=None) + 
Adds a key for validating requests with signed URLs for this backend
+bucket.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to which the Signed URL Key should be
+added. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs
+  "keyName": "A String", # Name of the key. 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.
+  "keyValue": "A String", # 128-bit key value used for signing the URL. The key value must be a validRFC
+      # 4648 Section 5 base64url encoded 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all BackendBucket 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of BackendBucketsScopedList resources.
+    "a_key": { # Name of the scope containing this set of BackendBuckets.
+      "backendBuckets": [ # A list of BackendBuckets contained in this scope.
+        { # Represents a Cloud Storage Bucket resource.
+            #
+            # This Cloud Storage bucket resource is referenced by a URL map of a load
+            # balancer. For more information, readBackend Buckets.
+          "bucketName": "A String", # Cloud Storage bucket name.
+          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+            "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+                # Pragma or Authorization headers. Up to 5 headers can be specified.
+                # The cache is bypassed for all cdnPolicy.cacheMode settings.
+              { # Bypass the cache when the specified request headers are present,
+                  # e.g. Pragma or Authorization headers. Values are case insensitive.
+                  # The presence of such a header overrides the cache_mode setting.
+                "headerName": "A String", # The header field name to match on when bypassing cache.
+                    # Values are case-insensitive.
+              },
+            ],
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+                # Cloud CDN.
+              "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                "A String",
+              ],
+              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+                  # parameters are always included. '&' and '=' will be percent encoded
+                  # and not treated as delimiters.
+                "A String",
+              ],
+            },
+            "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+                # The possible values are:
+                # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+                # headers to cache content. Responses without these headers will not be
+                # cached at Google's edge, and will require a full trip to the origin on
+                # every request, potentially impacting performance and increasing load on
+                # the origin server.
+                # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+                # "no-store" or "no-cache" directives in Cache-Control response headers.
+                # Warning: this may result in Cloud CDN caching private,
+                # per-user (user identifiable) content.
+                # CACHE_ALL_STATIC Automatically cache static content,
+                # including common image formats, media (video and audio), and web assets
+                # (JavaScript and CSS). Requests and responses that are marked as
+                # uncacheable, as well as dynamic content (including HTML), will not be
+                # cached.
+                #
+                # If no value is provided for cdnPolicy.cacheMode, it defaults
+                # to CACHE_ALL_STATIC.
+            "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+                # used to clamp the max-age (or Expires) value sent to the client.  With
+                # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+                # response max-age directive, along with a "public" directive.  For
+                # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+                # from the origin (if specified), or else sets the response max-age
+                # directive to the lesser of the client_ttl and default_ttl, and also
+                # ensures a "public" cache-control directive is present.
+                # If a client TTL is not specified, a default value (1 hour) will be used.
+                # The maximum allowed value is 31,622,400s (1 year).
+            "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+                # responses that do not have an existing valid TTL (max-age or s-maxage).
+                # Setting a TTL of "0" means "always revalidate".
+                # The value of defaultTTL cannot be set to a value greater than that of
+                # maxTTL, but can be equal.
+                # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+                # will overwrite the TTL set in all responses. The maximum allowed value is
+                # 31,622,400s (1 year), noting that infrequently accessed objects may be
+                # evicted from the cache before the defined TTL.
+            "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+                # origin.
+                # Cache directives that attempt to set a max-age or s-maxage higher than
+                # this, or an Expires header more than maxTTL seconds in the future will
+                # be capped at the value of maxTTL, as if it were the value of an
+                # s-maxage Cache-Control directive.
+                # Headers sent to the client will not be modified.
+                # Setting a TTL of "0" means "always revalidate".
+                # The maximum allowed value is 31,622,400s (1 year), noting that
+                # infrequently accessed objects may be evicted from the cache before
+                # the defined TTL.
+            "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                # to apply fine-grained caching for common errors or redirects.
+                # This can reduce the load on your origin and improve end-user
+                # experience by reducing response latency.
+                # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+                # negative caching applies to responses with the specified response code
+                # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+                # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+                # to all responses with the specified response code, and override any
+                # caching headers.
+                # By default, Cloud CDN will apply the following default TTLs to these
+                # status codes:
+                # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                # HTTP 404 (Not Found), 410 (Gone),
+                # 451 (Unavailable For Legal Reasons): 120s
+                # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+                # These defaults can be overridden in negative_caching_policy.
+            "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                # negative_caching must be enabled to configure negative_caching_policy.
+                # Omitting the policy and leaving negative_caching enabled will use
+                # Cloud CDN's default cache TTLs.
+                # Note that when specifying an explicit negative_caching_policy, you
+                # should take care to specify a cache TTL for all response codes
+                # that you wish to cache. Cloud CDN will not apply any default
+                # negative caching when a policy exists.
+              { # Specify CDN TTLs for response error codes.
+                "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                    # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                    # specified as values, and you cannot specify a status code more than
+                    # once.
+                "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                    # corresponding status code.
+                    # The maximum allowed value is 1800s (30 minutes), noting that
+                    # infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL.
+              },
+            ],
+            "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                # requests into a small number of requests to the origin.
+            "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+                # content with the origin, or when an error is encountered when refreshing
+                # the cache.
+                # This setting defines the default "max-stale" duration for any cached
+                # responses that do not specify a max-stale directive. Stale responses that
+                # exceed the TTL configured here will not be served. The default limit
+                # (max-stale) is 86400s (1 day), which will allow stale content to be
+                # served up to this limit beyond the max-age (or s-maxage) of a cached
+                # response.
+                # The maximum allowed value is 604800 (1 week).
+                # Set this to zero (0) to disable serve-while-stale.
+            "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+                # considered fresh. After this time period, the response will be
+                # revalidated before being served. Defaults to 1hr (3600s).  When serving
+                # responses to signed URL requests, Cloud CDN will internally behave as
+                # though all responses from this backend had a "Cache-Control:
+                # public, max-age=[TTL]" header, regardless of any existing
+                # Cache-Control header. The actual headers served in responses will not be
+                # altered.
+            "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+              "A String",
+            ],
+          },
+          "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+              # the client's Accept-Encoding header.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+            "A String",
+          ],
+          "description": "A String", # An optional textual description of the resource; provided by the client
+              # when the resource is created.
+          "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+              # this backend bucket.
+          "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+          "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+          "kind": "compute#backendBucket", # Output only. Type of the resource.
+          "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+              # load balancer.
+              #
+              # If loadBalancingScheme is not specified, the backend bucket can be used by
+              # classic global external load balancers, or global application external load
+              # balancers, or both.
+          "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.
+          "params": { # Additional Backend Bucket 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.
+                # 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.
+              "a_key": "A String",
+            },
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+              # resides. This field is not applicable to global backend buckets.
+              # 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.
+          "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+            {
+              "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+                  # BackendBucket.
+            },
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#backendBucketAggregatedList", # 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.
+  "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, backendBucket, requestId=None, x__xgafv=None) + 
Deletes the specified BackendBucket resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteSignedUrlKey(project, backendBucket, keyName, requestId=None, x__xgafv=None) + 
Deletes a key for validating requests with signed URLs for this backend
+bucket.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to which the Signed URL Key should be
+added. The name should conform to RFC1035. (required)
+  keyName: string, The name of the Signed URL Key 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, backendBucket, x__xgafv=None) + 
Returns the specified BackendBucket resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket 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 Storage Bucket resource.
+    #
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      #
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+ +
+ 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 BackendBucket resource 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 Cloud Storage Bucket resource.
+    # 
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      # 
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of BackendBucket resources available to 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.
+  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 BackendBucket resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendBucket resources.
+    { # Represents a Cloud Storage Bucket resource.
+        #
+        # This Cloud Storage bucket resource is referenced by a URL map of a load
+        # balancer. For more information, readBackend Buckets.
+      "bucketName": "A String", # Cloud Storage bucket name.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+            # Cloud CDN.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+              # parameters are always included. '&' and '=' will be percent encoded
+              # and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+        "A String",
+      ],
+      "description": "A String", # An optional textual description of the resource; provided by the client
+          # when the resource is created.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend bucket.
+      "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+      "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+      "kind": "compute#backendBucket", # Output only. Type of the resource.
+      "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+          # load balancer.
+          #
+          # If loadBalancingScheme is not specified, the backend bucket can be used by
+          # classic global external load balancers, or global application external load
+          # balancers, or both.
+      "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.
+      "params": { # Additional Backend Bucket 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+          # resides. This field is not applicable to global backend buckets.
+          # 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.
+      "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+              # BackendBucket.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#backendBucketList", # 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.
+  "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.
+  },
+}
+
+ +
+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of all usable backend buckets in 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.
+  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 BackendBucket resources.
+    { # Represents a Cloud Storage Bucket resource.
+        #
+        # This Cloud Storage bucket resource is referenced by a URL map of a load
+        # balancer. For more information, readBackend Buckets.
+      "bucketName": "A String", # Cloud Storage bucket name.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+            # Cloud CDN.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+              # parameters are always included. '&' and '=' will be percent encoded
+              # and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+        "A String",
+      ],
+      "description": "A String", # An optional textual description of the resource; provided by the client
+          # when the resource is created.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend bucket.
+      "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+      "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+      "kind": "compute#backendBucket", # Output only. Type of the resource.
+      "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+          # load balancer.
+          #
+          # If loadBalancingScheme is not specified, the backend bucket can be used by
+          # classic global external load balancers, or global application external load
+          # balancers, or both.
+      "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.
+      "params": { # Additional Backend Bucket 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+          # resides. This field is not applicable to global backend buckets.
+          # 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.
+      "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+              # BackendBucket.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#usableBackendBucketList", # Output only. [Output Only] Type of resource. Alwayscompute#usableBackendBucketList for lists of usable backend
+      # buckets.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable_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, backendBucket, body=None, requestId=None, x__xgafv=None) + 
Updates the specified BackendBucket 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)
+  backendBucket: string, Name of the BackendBucket resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Storage Bucket resource.
+    # 
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      # 
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setEdgeSecurityPolicy(project, backendBucket, body=None, requestId=None, x__xgafv=None) + 
Sets the edge security policy for the specified backend bucket.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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",
+  ],
+}
+
+ +
+ update(project, backendBucket, body=None, requestId=None, x__xgafv=None) + 
Updates the specified BackendBucket resource with the data included in the
+request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Storage Bucket resource.
+    # 
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      # 
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.backendServices.html b/docs/dyn/compute_preview.backendServices.html new file mode 100644 index 0000000000..3b91387ded --- /dev/null +++ b/docs/dyn/compute_preview.backendServices.html @@ -0,0 +1,13842 @@ + + + +

Compute Engine API . backendServices

+

Instance Methods

+

+ addSignedUrlKey(project, backendService, body=None, requestId=None, x__xgafv=None)

+

Adds a key for validating requests with signed URLs for this backend

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all BackendService resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, backendService, requestId=None, x__xgafv=None)

+

Deletes the specified BackendService resource.

+

+ deleteSignedUrlKey(project, backendService, keyName, requestId=None, x__xgafv=None)

+

Deletes a key for validating requests with signed URLs for this backend

+

+ get(project, backendService, x__xgafv=None)

+

Returns the specified BackendService resource.

+

+ getEffectiveSecurityPolicies(project, backendService, x__xgafv=None)

+

Returns effective security policies applied to this backend service.

+

+ getHealth(project, backendService, body=None, x__xgafv=None)

+

Gets the most recent health check results for this

+

+ 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 BackendService resource in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of BackendService resources available to the specified

+

+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of all usable backend services for Application Load

+

+ listUsable_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, backendService, body=None, requestId=None, x__xgafv=None)

+

Patches the specified BackendService resource with the data included in the

+

+ setEdgeSecurityPolicy(project, backendService, body=None, requestId=None, x__xgafv=None)

+

Sets the edge security policy for the specified backend service.

+

+ setIamPolicy(project, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setSecurityPolicy(project, backendService, body=None, requestId=None, x__xgafv=None)

+

Sets the Google Cloud Armor security policy for the specified backend

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, backendService, body=None, requestId=None, x__xgafv=None)

+

Updates the specified BackendService resource with the data included in the

+

Method Details

+
+ addSignedUrlKey(project, backendService, body=None, requestId=None, x__xgafv=None) + 
Adds a key for validating requests with signed URLs for this backend
+service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to which the Signed URL Key should be
+added. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs
+  "keyName": "A String", # Name of the key. 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.
+  "keyValue": "A String", # 128-bit key value used for signing the URL. The key value must be a validRFC
+      # 4648 Section 5 base64url encoded 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all BackendService 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.
+  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 BackendServicesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of BackendServicesScopedList resources.
+    "a_key": { # Name of the scope containing this set of BackendServices.
+      "backendServices": [ # A list of BackendServices contained in this scope.
+        { # Represents a Backend Service resource.
+            #
+            # A backend service defines how Google Cloud load balancers distribute traffic.
+            # The backend service configuration contains a set of values, such as the
+            # protocol used to connect to backends, various distribution and session
+            # settings, health checks, and timeouts. These settings provide fine-grained
+            # control over how your load balancer behaves. Most of the settings have
+            # default values that allow for easy configuration if you need to get started
+            # quickly.
+            #
+            # Backend services in Google Compute Engine can be either regionally or
+            # globally scoped.
+            #
+            # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+            # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+            #
+            # For more information, seeBackend
+            # Services.
+          "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+              # Load Balancers and Traffic Director and requires
+              # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+              #
+              # If set to 0, the cookie is non-persistent and lasts only until
+              # the end of the browser session (or equivalent). The maximum allowed value
+              # is two weeks (1,209,600).
+              #
+              # Not supported when the backend service is referenced by a URL map that is
+              # bound to target gRPC proxy that has validateForProxyless field set to true.
+          "backends": [ # The list of backends that serve this BackendService.
+            { # Message containing information of one individual backend.
+              "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+                  # handle additional traffic or is fully loaded. For usage guidelines, see
+                  # Connection balancing mode.
+                  #
+                  # Backends must use compatible balancing modes. Backends of a backend
+                  # service may use different balancing modes. For more information, see
+                  # Supported balancing modes and target capacity settings and
+                  # Restrictions and guidance for instance groups.
+                  #
+                  # Note: Currently, if you use the API to configure incompatible balancing
+                  # modes, the configuration might be accepted even though it has no impact
+                  # and is ignored. Specifically, Backend.maxUtilization is ignored when
+                  # Backend.balancingMode is RATE. In the future, this incompatible combination
+                  # will be rejected.
+              "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+                  # mode.
+                  # The default value is 1, which means the group serves up to
+                  # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+                  # completely drained, offering 0% of its available capacity. The valid ranges
+                  # are 0.0 and [0.1,1.0].
+                  # You cannot configure a setting larger than 0 and smaller than0.1.
+                  # You cannot configure a setting of 0 when there is only one
+                  # backend attached to the backend service.
+                  #
+                  # Not available with backends that don't support using abalancingMode. This includes backends such as global
+                  # internet NEGs, regional serverless NEGs, and PSC NEGs.
+              "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+                  # BalancingMode.
+                { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+                  "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+                      # Monitoring, but is not used for load balancing.
+                  "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+                      # balancing mode. The valid range is [0.0, 1.0].
+                  "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                      # long and match the regular expression
+                      # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                      # first character must be a lowercase letter, and all following
+                      # characters must be a dash, period, underscore, lowercase letter, or
+                      # digit, except the last character, which cannot be a dash, period, or
+                      # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                      # field can only be used for a global or regional backend service with the
+                      # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+                },
+              ],
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "failover": True or False, # This field designates whether this is a failover backend. More than one
+                  # failover backend can be configured for a given BackendService.
+                  #
+                  # This field can only be used for a regional external Passthrough Network
+                  # Load Balancer or a regional internal Passthrough Network Load Balancer.
+              "group": "A String", # The fully-qualified URL of aninstance
+                  # group or network endpoint
+                  # group (NEG) resource. To determine what types of backends a load
+                  # balancer supports, see the [Backend services
+                  # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+                  #
+                  # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+                  # or NEG. Partial URLs are not supported.
+                  #
+                  # If haPolicy is specified, backends must refer to NEG resources of type
+                  # GCE_VM_IP.
+              "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+                  # guidelines, seeConnection
+                  # balancing mode and Utilization
+                  # balancing mode. Not available if the backend'sbalancingMode is RATE.
+              "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+                  # guidelines, seeConnection
+                  # balancing mode and Utilization
+                  # balancing mode.
+                  #
+                  # Not available if the backend's balancingMode isRATE.
+              "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+                  # For usage guidelines, seeConnection
+                  # balancing mode and Utilization
+                  # balancing mode.
+                  #
+                  # Not available if the backend's balancingMode isRATE.
+              "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+                  # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+              "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+                  # Not available if backend's balancingMode is RATE
+                  # or CONNECTION.
+              "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+                  # Not available if backend's balancingMode is RATE
+                  # or CONNECTION.
+              "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+                  # usage guidelines, seeRate
+                  # balancing mode and Utilization
+                  # balancing mode.
+                  #
+                  # Not available if the backend's balancingMode isCONNECTION.
+              "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+                  # guidelines, seeRate
+                  # balancing mode and Utilization
+                  # balancing mode.
+                  #
+                  # Not available if the backend's balancingMode isCONNECTION.
+              "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+                  # guidelines, seeRate
+                  # balancing mode and Utilization
+                  # balancing mode.
+                  #
+                  # Not available if the backend's balancingMode isCONNECTION.
+              "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+                  #
+                  # 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:
+                  #
+                  #    - PREFERRED: Backends with this preference level will be
+                  #    filled up to their capacity limits first, based on RTT.
+                  #    - DEFAULT:  If preferred backends don't have enough
+                  #    capacity, backends in this layer would be used and traffic would be
+                  #    assigned based on the load balancing algorithm you use. This is the
+                  #    default
+                  #
+                  #
+                  #
+                  # For global external Passthrough Network Load Balancers, the following
+                  # restrictions apply:
+                  #
+                  #    - At most one backend can be marked as PREFERRED.
+                  #    - PREFERRED and DEFAULT backends cannot reside
+                  #    in the same Cloud region.
+              "trafficDuration": "A String",
+            },
+          ],
+          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+              # specified load balancer types.
+            "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+                # Pragma or Authorization headers. Up to 5 headers can be specified.
+                # The cache is bypassed for all cdnPolicy.cacheMode settings.
+              { # Bypass the cache when the specified request headers are present,
+                  # e.g. Pragma or Authorization headers. Values are case insensitive.
+                  # The presence of such a header overrides the cache_mode setting.
+                "headerName": "A String", # The header field name to match on when bypassing cache.
+                    # Values are case-insensitive.
+              },
+            ],
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+                # CDN.
+              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+              "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                "A String",
+              ],
+              "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                  # The name=value pair will be used in the cache key Cloud CDN generates.
+                "A String",
+              ],
+              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                  # query_string_whitelist and query_string_blacklist. If neither is set, the
+                  # entire query string will be included. If false, the query string will be
+                  # excluded from the cache key entirely.
+              "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+                  # parameters will be included. Either specify query_string_whitelist or
+                  # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+                  # not treated as delimiters.
+                "A String",
+              ],
+              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+                  # parameters will be excluded. Either specify query_string_whitelist or
+                  # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+                  # not treated as delimiters.
+                "A String",
+              ],
+            },
+            "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+                # The possible values are:
+                # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+                # headers to cache content. Responses without these headers will not be
+                # cached at Google's edge, and will require a full trip to the origin on
+                # every request, potentially impacting performance and increasing load on
+                # the origin server.
+                # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+                # "no-store" or "no-cache" directives in Cache-Control response headers.
+                # Warning: this may result in Cloud CDN caching private,
+                # per-user (user identifiable) content.
+                # CACHE_ALL_STATIC Automatically cache static content,
+                # including common image formats, media (video and audio), and web assets
+                # (JavaScript and CSS). Requests and responses that are marked as
+                # uncacheable, as well as dynamic content (including HTML), will not be
+                # cached.
+                #
+                # If no value is provided for cdnPolicy.cacheMode, it defaults
+                # to CACHE_ALL_STATIC.
+            "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+                # used to clamp the max-age (or Expires) value sent to the client.  With
+                # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+                # response max-age directive, along with a "public" directive.  For
+                # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+                # from the origin (if specified), or else sets the response max-age
+                # directive to the lesser of the client_ttl and default_ttl, and also
+                # ensures a "public" cache-control directive is present.
+                # If a client TTL is not specified, a default value (1 hour) will be used.
+                # The maximum allowed value is 31,622,400s (1 year).
+            "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+                # responses that do not have an existing valid TTL (max-age or s-maxage).
+                # Setting a TTL of "0" means "always revalidate".
+                # The value of defaultTTL cannot be set to a value greater than that of
+                # maxTTL, but can be equal.
+                # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+                # will overwrite the TTL set in all responses. The maximum allowed value is
+                # 31,622,400s (1 year), noting that infrequently accessed objects may be
+                # evicted from the cache before the defined TTL.
+            "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+                # origin.
+                # Cache directives that attempt to set a max-age or s-maxage higher than
+                # this, or an Expires header more than maxTTL seconds in the future will
+                # be capped at the value of maxTTL, as if it were the value of an
+                # s-maxage Cache-Control directive.
+                # Headers sent to the client will not be modified.
+                # Setting a TTL of "0" means "always revalidate".
+                # The maximum allowed value is 31,622,400s (1 year), noting that
+                # infrequently accessed objects may be evicted from the cache before
+                # the defined TTL.
+            "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                # to apply fine-grained caching for common errors or redirects.
+                # This can reduce the load on your origin and improve end-user
+                # experience by reducing response latency.
+                # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+                # negative caching applies to responses with the specified response code
+                # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+                # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+                # to all responses with the specified response code, and override any
+                # caching headers.
+                # By default, Cloud CDN will apply the following default TTLs to these
+                # status codes:
+                # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                # HTTP 404 (Not Found), 410 (Gone),
+                # 451 (Unavailable For Legal Reasons): 120s
+                # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+                # These defaults can be overridden in negative_caching_policy.
+            "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                # negative_caching must be enabled to configure negative_caching_policy.
+                # Omitting the policy and leaving negative_caching enabled will use
+                # Cloud CDN's default cache TTLs.
+                # Note that when specifying an explicit negative_caching_policy, you
+                # should take care to specify a cache TTL for all response codes
+                # that you wish to cache. Cloud CDN will not apply any default
+                # negative caching when a policy exists.
+              { # Specify CDN TTLs for response error codes.
+                "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                    # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                    # specified as values, and you cannot specify a status code more than
+                    # once.
+                "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                    # corresponding status code.
+                    # The maximum allowed value is 1800s (30 minutes), noting that
+                    # infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL.
+              },
+            ],
+            "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                # requests into a small number of requests to the origin.
+            "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+                # content with the origin, or when an error is encountered when refreshing
+                # the cache.
+                # This setting defines the default "max-stale" duration for any cached
+                # responses that do not specify a max-stale directive. Stale responses that
+                # exceed the TTL configured here will not be served. The default limit
+                # (max-stale) is 86400s (1 day), which will allow stale content to be
+                # served up to this limit beyond the max-age (or s-maxage) of a cached
+                # response.
+                # The maximum allowed value is 604800 (1 week).
+                # Set this to zero (0) to disable serve-while-stale.
+            "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+                # considered fresh. After this time period, the response will be
+                # revalidated before being served. Defaults to 1hr (3600s).  When serving
+                # responses to signed URL requests, Cloud CDN will internally behave as
+                # though all responses from this backend had a "Cache-Control:
+                # public, max-age=[TTL]" header, regardless of any existing
+                # Cache-Control header. The actual headers served in responses will not be
+                # altered.
+            "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+              "A String",
+            ],
+          },
+          "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+              # backend service.
+            "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+                # there is no limit.
+                #
+                # Not supported when the backend service is referenced by a URL map that is
+                # bound to target gRPC proxy that has validateForProxyless field set to true.
+            "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+                # not specified, there is no limit.
+                #
+                # Not supported when the backend service is referenced by a URL map that is
+                # bound to target gRPC proxy that has validateForProxyless field set to true.
+            "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+                # service. If not specified, there is no limit.
+            "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+                # This parameter is respected by both the HTTP/1.1 and HTTP/2
+                # implementations. If not specified, there is no limit. Setting this
+                # parameter to 1 will effectively disable keep alive.
+                #
+                # Not supported when the backend service is referenced by a URL map that is
+                # bound to target gRPC proxy that has validateForProxyless field set to true.
+            "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+                # not specified, the default is 1.
+                #
+                # Not supported when the backend service is referenced by a URL map that is
+                # bound to target gRPC proxy that has validateForProxyless field set to true.
+          },
+          "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+              # the client's Accept-Encoding header.
+          "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+            "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+                # instance. For supported load balancers and protocols, as described inEnabling
+                # connection draining.
+          },
+          "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+              # tracking policy settings are only available for external passthrough
+              # Network Load Balancers and internal passthrough Network Load Balancers.
+              #
+              # connectionTrackingPolicy cannot be specified with haPolicy.
+            "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+                # value is DEFAULT_FOR_PROTOCOL.
+                #
+                # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+                # persist on unhealthy backends only for connection-oriented protocols
+                # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+                # Affinity is configured for 5-tuple. They do not persist forUDP.
+                #
+                # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+                # the existing connections on the unhealthy backend are never persisted on
+                # the unhealthy backend. They are always diverted to newly selected healthy
+                # backends (unless all backends are unhealthy).
+                #
+                # If set to ALWAYS_PERSIST, existing connections always
+                # persist on unhealthy backends regardless of protocol and session
+                # affinity. It is generally not recommended to use this mode overriding the
+                # default.
+                #
+                # For more details, see [Connection Persistence for Network Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+                # and [Connection Persistence for Internal TCP/UDP Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+            "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+                # Balancers. This option is not available publicly.
+            "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+                # matching traffic (in seconds).
+                #
+                # For internal passthrough Network Load Balancers:
+                #
+                #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+                #    - It can be set only if Connection Tracking is less than 5-tuple
+                #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+                #    Mode is PER_SESSION).
+                #
+                #
+                #
+                # For external passthrough Network Load Balancers the default is 60
+                # seconds. This option is not available publicly.
+            "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+                # options:
+                #
+                #    - PER_CONNECTION: This is the default mode. The Connection
+                #    Tracking is performed as per the Connection Key (default Hash Method) for
+                #    the specific protocol.
+                #    - PER_SESSION: The Connection Tracking is performed as per
+                #    the configured Session Affinity. It matches the configured Session
+                #    Affinity.
+                #
+                #
+                #
+                # For more details, see [Tracking Mode for Network Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+                # and [Tracking Mode for Internal TCP/UDP Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+          },
+          "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+              # affinity based on HTTP headers, cookies or other properties. This load
+              # balancing policy is applicable only for HTTP connections. The affinity to a
+              # particular destination host will be lost when one or more hosts are
+              # added/removed from the destination service. This field specifies parameters
+              # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+              #
+              # This field is applicable to either:
+              #
+              #    - A regional backend service with the service protocol set to HTTP,
+              #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+              #    INTERNAL_MANAGED.
+              #    - A global backend service with the
+              #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+            "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+                # be used as the hash key for the consistent hash load balancer. If the
+                # cookie is not present, it will be generated. This field is applicable if
+                # the sessionAffinity is set to HTTP_COOKIE.
+                #
+                # Not supported when the backend service is referenced by a URL map that is
+                # bound to target gRPC proxy that has validateForProxyless field set to true.
+                # for load balancing policies that use a consistent hash.
+              "name": "A String", # Name of the cookie.
+              "path": "A String", # Path to set for the cookie.
+              "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+                # applicable if the sessionAffinity is set toHEADER_FIELD.
+            "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+                # 1024. Larger ring sizes result in more granular load distributions. If the
+                # number of hosts in the load balancing pool is larger than the ring size,
+                # each host will be assigned a single virtual node.
+          },
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+            { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+                # locality_lb_policy.
+              "dryRun": True or False, # If true, the metric data is not used for load balancing.
+              "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                  # long and match the regular expression
+                  # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                  # first character must be a lowercase letter, and all following
+                  # characters must be a dash, period, underscore, lowercase letter, or
+                  # digit, except the last character, which cannot be a dash, period, or
+                  # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                  # field can only be used for a global or regional backend service with the
+                  # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+            },
+          ],
+          "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+              # custom
+              # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+            "A String",
+          ],
+          "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+              # custom
+              # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+            "A String",
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+              # this backend service.
+          "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+              # global external Application Load Balancer.
+          "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+              # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+              #
+              # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+              # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+              # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+              # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+              # externalManagedMigrationTestingPercentage.
+              #
+              # Rolling back a migration requires the states to be set in reverse order. So
+              # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+              # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+              # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+              # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+          "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+              # external Application Load Balancer.
+              #
+              # The value of this field must be in the range [0, 100].
+              #
+              # Session affinity options will slightly affect this routing behavior, for
+              # more details, see:Session
+              # Affinity.
+              #
+              # This value can only be set if the loadBalancingScheme in the BackendService
+              # is set to EXTERNAL (when using the classic Application Load Balancer) and
+              # the migration state is TEST_BY_PERCENTAGE.
+          "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+              # as a backup (failover) backend.
+              # For load balancers that have configurable failover:
+              # [Internal passthrough Network Load
+              # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+              # and [external passthrough Network Load
+              # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+              # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+              # Network Load Balancers.
+              # failover:
+              # [Internal passthrough Network Load
+              # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+              # and [external passthrough
+              # Network Load
+              # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+              # On failover or failback, this field indicates whether connection draining
+              # will be honored. Google Cloud has a fixed connection draining timeout of
+              # 10 minutes. A setting of true terminates existing TCP
+              # connections to the active pool during failover and failback, immediately
+              # draining traffic. A setting of false allows existing TCP
+              # connections to persist, even on VMs no longer in the active pool, for up
+              # to the duration of the connection draining timeout (10 minutes).
+            "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+                #
+                # The default is false.
+            "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+                # load balancer are dropped when all primary and all backup backend VMs are
+                # unhealthy.If set to false, connections are distributed
+                # among all primary VMs when all primary and all backup backend VMs are
+                #  unhealthy.
+                # For load balancers that have configurable
+                # failover:
+                # [Internal passthrough
+                # Network Load
+                # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+                # and [external passthrough
+                # Network Load
+                # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+                # The default is false.
+            "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+                # failover when the number of healthy primary VMs equals zero.
+                # For all other values, the load balancer performs a failover when the
+                # total number of healthy primary VMs is less than this ratio.
+                # For load balancers that have configurable
+                # failover:
+                # [Internal TCP/UDP Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+                # and [external TCP/UDP Load
+                # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          },
+          "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 BackendService. An up-to-date fingerprint must be provided in
+              # order to update the BackendService, otherwise the request will
+              # fail with error 412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a BackendService.
+          "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+              # Protocol Forwarding.
+              #
+              # The backends of this regional backend service must only specify zonal
+              # network endpoint groups (NEGs) of type GCE_VM_IP.
+              #
+              # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+              # regional backend service must set the network field. All zonal NEGs must
+              # belong to the same network. However, individual NEGs can
+              # belong to different subnetworks of that network.
+              #
+              # When haPolicy is specified, the set of attached network endpoints across
+              # all backends comprise an High Availability domain from which one endpoint
+              # is selected as the active endpoint (the leader) that receives all
+              # traffic.
+              #
+              # haPolicy can be added only at backend service creation time. Once set up,
+              # it cannot be deleted.
+              #
+              # Note that haPolicy is not for load balancing, and therefore cannot be
+              # specified with sessionAffinity, connectionTrackingPolicy, and
+              # failoverPolicy.
+              #
+              # haPolicy requires customers to be responsible for tracking backend
+              # endpoint health and electing a leader among the healthy endpoints.
+              # Therefore, haPolicy cannot be specified with healthChecks.
+              # haPolicy can only be specified for External Passthrough
+              # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+              # Load Balancers.
+            "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+                # achieve it.
+                #
+                # Supported values are:
+                #
+                #    - DISABLED: Fast IP Move is disabled. You can only use the
+                #    haPolicy.leader API to update the leader.
+                #    - >GARP_RA: Provides a method to very quickly define a new network
+                #    endpoint as the leader. This method is faster than updating the leader
+                #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+                #    hosting the network endpoint that should become the new leader sends
+                #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+                #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+                #    temporarily associates the forwarding rule IP address with that VM, and
+                #    both new and in-flight packets are quickly delivered to that VM.
+                #
+                #
+                #
+                # Note the important properties of the Fast IP Move functionality:
+                #
+                #    - The GARP/RA-initiated re-routing stays active for approximately 20
+                #    minutes. After triggering fast failover, you must also
+                #    appropriately set the haPolicy.leader.
+                #    -  The new leader instance should continue to send GARP/RA packets
+                #    periodically every 10 seconds until at least 10 minutes after updating
+                #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+                #    - After triggering a fast failover, we recommend that you wait at least
+                #    3 seconds before sending another GARP/RA packet from a different VM
+                #    instance to avoid race conditions.
+                #    - Don't send GARP/RA packets from different VM
+                #    instances at the same time. If multiple instances continue to send
+                #    GARP/RA packets, traffic might be routed to different destinations in an
+                #    alternating order. This condition ceases when a single instance
+                #    issues a GARP/RA packet.
+                #    - The GARP/RA request always takes priority over the leader API.
+                #    Using the haPolicy.leader API to change the leader to a different
+                #    instance will have no effect until the GARP/RA request becomes
+                #    inactive.
+                #    - The GARP/RA packets should follow the GARP/RA
+                #    Packet Specifications..
+                #    -  When multiple forwarding rules refer to a regional backend service,
+                #    you need only send a GARP or RA packet for a single forwarding rule
+                #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+                #    backend service will also be moved to the sender of the GARP or RA
+                #    packet.
+                #
+                #
+                #
+                # The following are the Fast IP Move limitations (that is, when fastIPMove
+                # is not DISABLED):
+                #
+                #    - Multiple forwarding rules cannot use the same IP address if one of
+                #    them refers to a regional backend service with fastIPMove.
+                #    - The regional backend service must set the network field, and all
+                #    NEGs must belong to that network. However, individual
+                #    NEGs can belong to different subnetworks of that network.
+                #    - The maximum number of network endpoints across all backends of a
+                #    backend service with fastIPMove is 32.
+                #    - The maximum number of backend services with fastIPMove that can have
+                #    the same network endpoint attached to one of its backends is 64.
+                #    - The maximum number of backend services with fastIPMove in a VPC in a
+                #    region is 64.
+                #    - The network endpoints that are attached to a backend of a backend
+                #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+                #    - Traffic directed to the leader by a static route next hop will not be
+                #    redirected to a new leader by fast failover. Such traffic will only be
+                #    redirected once an haPolicy.leader update has taken effect. Only traffic
+                #    to the forwarding rule's virtual IP will be redirected to a new leader by
+                #    fast failover.
+                #
+                #
+                # haPolicy.fastIPMove can be set only at backend service creation time.
+                # Once set, it cannot be updated.
+                #
+                # By default, fastIpMove is set to DISABLED.
+            "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+                # this service as the active endpoint (the leader) that receives all
+                # traffic.
+                #
+                # When the leader changes, there is no connection draining to persist
+                # existing connections on the old leader.
+                #
+                # You are responsible for selecting a suitable endpoint as the
+                # leader. For example, preferring a healthy endpoint over unhealthy ones.
+                # Note that this service does not track backend endpoint health, and
+                # selects the configured leader unconditionally.
+              "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+                  # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+                  # that the leader is attached to.
+                  #
+                  # The leader's backendGroup must already be specified as a backend of
+                  # this backend service. Removing a backend that is designated as the
+                  # leader's backendGroup is not permitted.
+              "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+                  # designated as the leader.
+                  #
+                  # This network endpoint cannot be detached from the NEG specified in
+                  # the haPolicy.leader.backendGroup until the leader is updated with
+                  # another network endpoint, or the leader is removed from the haPolicy.
+                "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+                    # instance must already be attached to the NEG specified in the
+                    # haPolicy.leader.backendGroup.
+                    #
+                    # The value must be a valid RFC1035 name (1-63 characters) or a valid
+                    # instance URL.
+                    # Authorization requires the following IAM permission on the
+                    # specified resource instance: compute.instances.use
+              },
+            },
+          },
+          "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+              # httpsHealthChecks (legacy) resource for health checking this backend
+              # service. Not all backend services support legacy health checks. See
+              # Load balancer guide. Currently, at most one health check can be
+              # specified for each backend service. Backend services with
+              # instance group or zonal NEG backends must have a health check unless
+              # haPolicy is specified. Backend services with internet or serverless NEG
+              # backends must not have a health check.
+              #
+              # healthChecks[] cannot be specified with haPolicy.
+            "A String",
+          ],
+          "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+              # Not available for internal passthrough Network Load Balancers and external
+              # passthrough Network Load Balancers.
+            "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+                # incoming requests.
+            "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+            "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+                # For security reasons, this value cannot be retrieved via the API.
+                # Instead, the SHA-256 hash of the value is returned in the
+                # oauth2ClientSecretSha256 field.
+                #
+                # @InputOnly
+            "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+          },
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+              # from the client to the backend for proxyless gRPC).
+              # The possible values are:
+              #
+              #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+              #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+              #    Group), regardless of traffic from the client to the proxy. Only IPv4
+              #    health checks are used to check the health of the backends. This is the
+              #    default setting.
+              #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+              #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+              #    address).
+              #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+              #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+              #    Group), regardless of traffic from the client to the proxy. Only IPv6
+              #    health checks are used to check the health of the backends.
+              #
+              #
+              #
+              # This field is applicable to either:
+              #
+              #    -  Advanced global external Application Load Balancer (load balancing
+              #    scheme EXTERNAL_MANAGED),
+              #    -  Regional external Application Load
+              #    Balancer,
+              #    -  Internal proxy Network Load Balancer (load balancing
+              #    scheme INTERNAL_MANAGED),
+              #    -  Regional internal Application Load
+              #    Balancer (load balancing scheme INTERNAL_MANAGED),
+              #    -  Traffic
+              #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+              #    INTERNAL_SELF_MANAGED).
+          "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+              # for backend services.
+          "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+              # created for one type of load balancer cannot be used with another.
+              # For more information, refer to
+              # Backend services product and scheme table.
+          "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+              # preference. When you use localityLbPolicies, you must set at least one
+              # value for either the localityLbPolicies[].policy or the
+              # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+              # value set in the localityLbPolicy field.
+              #
+              # For an example of how to use this field, seeDefine
+              # a list of preferred policies.
+              #
+              # Caution: This field and its children are intended for use in a service mesh
+              # that includes gRPC clients only. Envoy proxies can't use backend services
+              # that have this configuration.
+            { # Container for either a built-in LB policy supported by gRPC or Envoy or
+                # a custom one implemented by the end user.
+              "customPolicy": { # The configuration for a custom policy implemented by the user and
+                  # deployed with the client.
+                "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+                    # by a locally installed custom policy implementation.
+                "name": "A String", # Identifies the custom policy.
+                    #
+                    # The value should match the name of a custom implementation registered
+                    # on the gRPC clients. It should follow protocol buffer message naming
+                    # conventions and include the full path (for example,
+                    # myorg.CustomLbPolicy). The maximum length is 256 characters.
+                    #
+                    # Do not specify the same custom policy more than once for a
+                    # backend. If you do, the configuration is rejected.
+                    #
+                    # For an example of how to use this field, seeUse
+                    # a custom policy.
+              },
+              "policy": { # The configuration for a built-in load balancing policy.
+                "name": "A String", # The name of a locality load-balancing policy. Valid values include
+                    # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+                    # about these values, see the description of localityLbPolicy.
+                    #
+                    # Do not specify the same policy more than once for a
+                    # backend. If you do, the configuration is rejected.
+              },
+            },
+          ],
+          "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+              # possible values are:
+              #
+              #    - ROUND_ROBIN: This is a simple policy in which each healthy
+              #    backend is selected in round robin order. This is the default.
+              #    - LEAST_REQUEST: An O(1) algorithm which
+              #    selects two random healthy hosts and picks the host which has fewer active
+              #    requests.
+              #    - RING_HASH: The ring/modulo hash load balancer implements
+              #    consistent hashing to backends. The algorithm has the property that the
+              #    addition/removal of a host from a set of N hosts only affects 1/N of the
+              #    requests.
+              #    - RANDOM: The load balancer selects a random healthy
+              #    host.
+              #    - ORIGINAL_DESTINATION: Backend host is selected
+              #    based on the client connection metadata, i.e., connections are opened to
+              #    the same address as the destination address of the incoming connection
+              #    before the connection was redirected to the load balancer.
+              #    - MAGLEV: used as a drop in replacement for the ring hash
+              #    load balancer. Maglev is not as stable as ring hash but has faster table
+              #    lookup build times and host selection times. For more information about
+              #    Maglev, see Maglev:
+              #    A Fast and Reliable Software Network Load Balancer.
+              #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+              #    Load Balancing using weights computed from Backend reported Custom Metrics.
+              #    If set, the Backend Service responses are expected to contain non-standard
+              #    HTTP response header field Endpoint-Load-Metrics. The reported
+              #    metrics to use for computing the weights are specified via thecustomMetrics field.
+              #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+              #    health check reported weights. If set, the backend service must configure
+              #    an HTTP-based Health Check, and health check replies are expected to
+              #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+              #    weights. If set, load balancing is weighted based on the per-endpoint
+              #    weights reported in the last processed health check replies, as long as
+              #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+              #    Otherwise, load balancing remains equal-weight.
+              #
+              #
+              #
+              # This field is applicable to either:
+              #
+              #    - A regional backend service with the service protocol set to HTTP,
+              #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+              #    INTERNAL_MANAGED.
+              #    - A global backend service with the
+              #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+              #    EXTERNAL_MANAGED.
+              #
+              #
+              #
+              # If sessionAffinity is not configured—that is, if session
+              # affinity remains at the default value of NONE—then the
+              # default value for localityLbPolicy
+              # is ROUND_ROBIN. If session affinity is set to a value other
+              # than NONE,
+              # then the default value for localityLbPolicy isMAGLEV.
+              #
+              # Only ROUND_ROBIN and RING_HASH are supported
+              # when the backend service is referenced by a URL map that is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              # localityLbPolicy cannot be specified with haPolicy.
+          "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+              # by this backend service. If logging is enabled, logs will be exported to
+              # Stackdriver.
+              # backend service.
+            "enable": True or False, # Denotes whether to enable logging for the load balancer
+                # traffic served by this backend service. The default value is false.
+            "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+              { # Determines which HTTP headers will be logged to Stackdriver.
+                "headerName": "A String", # The name of the header to be logged.
+              },
+            ],
+            "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+              { # Determines which HTTP headers will be logged to Stackdriver.
+                "headerName": "A String", # The name of the header to be logged.
+              },
+            ],
+            "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+                # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+                # of optional fields you want to include in the logs. For example:
+                # serverInstance, serverGkeDetails.cluster,
+                # serverGkeDetails.pod.podNamespace
+              "A String",
+            ],
+            "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+                # service. Configures whether all, none or a subset of optional fields
+                # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+                # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+            "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+                # service. The value of the field must be in [0, 1]. This configures the
+                # sampling rate of requests to the load balancer where 1.0 means all logged
+                # requests are reported and 0.0 means no logged requests are reported. The
+                # default value is 1.0.
+          },
+          "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+              # service. Duration is computed from the beginning of the stream until the
+              # response has been completely processed, including all retries. A stream
+              # that does not complete in this duration is closed.
+              #
+              # If not specified, there will be no timeout limit, i.e. the maximum
+              # duration is infinite.
+              #
+              # This value can be overridden in the PathMatcher configuration of the
+              # UrlMap that references this backend service.
+              #
+              # This field is only allowed when the loadBalancingScheme of
+              # the backend service is INTERNAL_SELF_MANAGED.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+              # controller and read by the backend RCTH
+            "a_key": "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.
+          "network": "A String", # The URL of the network to which this backend service belongs.
+              #
+              # This field must be set for Internal Passthrough Network Load Balancers when
+              # the haPolicy is enabled, and for External Passthrough Network Load
+              # Balancers when the haPolicy fastIpMove is enabled.
+              #
+              # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+          "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+              # Load Balancers.
+              #
+              # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+            "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+                # endpoints in the local zone.
+              "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+                  # possible values are:
+                  #
+                  #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+                  #    is disabled. The load balancer distributes new connections to all
+                  #    healthy backend endpoints across all zones.
+                  #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+                  #    enabled. The load balancer distributes new connections to all healthy
+                  #    backend endpoints in the local zone only. If there are no healthy
+                  #    backend endpoints in the local zone, the load balancer distributes
+                  #    new connections to all backend endpoints in the local zone.
+                  #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+                  #    enabled. The load balancer distributes new connections to all healthy
+                  #    backend endpoints in the local zone only. If there aren't enough
+                  #    healthy backend endpoints in the local zone, the load balancer
+                  #    distributes new connections to all healthy backend endpoints across all
+                  #    zones.
+              "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+                  # of healthy backend endpoints in a zone to the count of backend
+                  # endpoints in that same zone is equal to or above this threshold, the
+                  # load balancer distributes new connections to all healthy endpoints in
+                  # the local zone only. When the ratio of the count of healthy backend
+                  # endpoints in a zone to the count of backend endpoints in that same
+                  # zone is below this threshold, the load balancer distributes all new
+                  # 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
+              # considered disabled.
+              #
+              # Results of the outlier detection algorithm (ejection of endpoints from the
+              # load balancing pool and returning them back to the pool) are executed
+              # independently by each proxy instance of the load balancer. In most cases,
+              # more than one proxy instance handles the traffic received by a backend
+              # service. Thus, it is possible that an unhealthy endpoint is detected and
+              # ejected by only some of the proxies, and while this happens, other proxies
+              # may continue to send requests to the same unhealthy endpoint until they
+              # detect and eject the unhealthy endpoint.
+              #
+              # Applicable backend endpoints can be:
+              #
+              #    - VM instances in an Instance Group
+              #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+              #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+              #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+              #    Functions Services
+              #    - Private Service Connect NEGs, that resolve to
+              #    Google-managed regional API endpoints or managed services published using
+              #    Private Service Connect
+              #
+              #
+              #
+              # Applicable backend service types can be:
+              #
+              #    - A global backend service with the loadBalancingScheme set to
+              #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+              #    - A regional backend
+              #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+              #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+              #    supported for Serverless NEGs.
+              #
+              #
+              #
+              # Not supported when the backend service is referenced by a URL map that is
+              # bound to target gRPC proxy that has validateForProxyless field set to true.
+              # pool for the backend service.
+            "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+                # or 30s.
+                #
+                # After a backend endpoint is returned back to the load balancing pool, it
+                # can be ejected again in another ejection analysis. Thus, the total ejection
+                # time is equal to the base ejection time multiplied by the number of times
+                # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+                # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+                # return code qualifies as an error. Defaults to 5.
+            "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+                # connection errors that are mapped to one of those status codes) before a
+                # consecutive gateway failure ejection occurs. Defaults to 3.
+            "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+                # outlier status is detected through consecutive 5xx. This setting can be
+                # used to disable ejection or to ramp it up slowly. Defaults to 0.
+            "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+                # outlier status is detected through consecutive gateway failures. This
+                # setting can be used to disable ejection or to ramp it up slowly. Defaults
+                # to 100.
+            "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+                # outlier status is detected through success rate statistics. This setting
+                # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+                #
+                # Not supported when the backend service uses Serverless NEG.
+            "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+                # ejections and backend endpoints being returned to service. The interval is
+                # equal to the number of seconds as defined in
+                # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+                # in outlierDetection.interval.nanos. Defaults to 1 second.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+                # backend service that can be ejected if the ejection conditions are met.
+                # Defaults to 50%.
+            "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+                # enough request volume to detect success rate outliers. If the number of
+                # backend endpoints is fewer than this setting, outlier detection via success
+                # rate statistics is not performed for any backend endpoint in the load
+                # balancing pool. Defaults to 5.
+                #
+                # Not supported when the backend service uses Serverless NEG.
+            "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+                # (as defined by the interval duration above) to include this backend
+                # endpoint in success rate based outlier detection. If the volume is lower
+                # than this setting, outlier detection via success rate statistics is not
+                # performed for that backend endpoint. Defaults to 100.
+                #
+                # Not supported when the backend service uses Serverless NEG.
+            "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+                # outlier ejection. The ejection threshold is the difference between the mean
+                # success rate, and the product of this factor and the standard deviation of
+                # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+                # is divided by a thousand to get a double. That is, if the desired factor
+                # is 1.9, the runtime value should be 1900. Defaults to 1900.
+                #
+                # Not supported when the backend service uses Serverless NEG.
+          },
+          "params": { # Additional Backend Service 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.
+                # 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.
+              "a_key": "A String",
+            },
+          },
+          "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+              # the backend. The default value is 80.
+              # For internal passthrough Network Load Balancers and external passthrough
+              # Network Load Balancers, omit port.
+          "portName": "A String", # A named port on a backend instance group representing the port for
+              # communication to the backend VMs in that group. The
+              # named port must be [defined on each backend instance
+              # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+              # This parameter has no meaning if the backends are NEGs. For internal
+              # passthrough Network Load Balancers and external passthrough Network Load
+              # Balancers, omit port_name.
+          "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+              #
+              # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+              # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+              # configuration.
+              # Refer to
+              # Load balancing features for more information.
+              #
+              # Must be set to GRPC when the backend service is referenced by a URL map
+              # that is bound to target gRPC proxy.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+              # resides. This field is not applicable to global backend services.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+              # backend service.
+          "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+              # service. This field is applicable to a global backend service with the
+              # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+            "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+                # storage buckets that support AWS's Signature Version 4 for authentication.
+                # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+                # private storage buckets that support Signature Version 4 for authentication.
+                # The service name for generating the authentication header will always default
+                # to 's3'.
+              "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+                  # creating a backend that uses AWS v4 signature authentication, but will not
+                  # be returned as part of the configuration when queried with a REST API GET
+                  # request.
+                  #
+                  # @InputOnly
+              "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+              "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+                  # keep track of different iterations of your access key.
+              "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+                  # the name of the region your cloud uses to host your origin.  For example,
+                  # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+            },
+            "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+                # that describes how clients should authenticate with this service's
+                # backends.
+                #
+                #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+                # to INTERNAL_SELF_MANAGED.
+                #
+                #  If left blank, communications are not encrypted.
+            "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+                # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+                # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+                # specified values, the communication continues. Otherwise, it fails. This
+                # additional check enables the client to verify that the server is authorized
+                # to run the requested service.
+                #
+                #  Note that the contents of the server
+                # certificate's subjectAltName field are configured by the
+                # Public Key Infrastructure which provisions server identities.
+                #
+                #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+                # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+                # mode).
+              "A String",
+            ],
+          },
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+              #
+              # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+              # If set, lists of backends and health checks must be both empty.
+            "A String",
+          ],
+          "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+              #
+              # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+              # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+              # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+              # global backend service, the service lb policy must be global. For a
+              # regional backend service, the service lb policy must be regional and in the
+              # same region.
+          "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+              #
+              # Only NONE and HEADER_FIELD are supported
+              # when the backend service is referenced by a URL map that is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              # For more details, see:
+              # [Session
+              # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+              #
+              # sessionAffinity cannot be specified with haPolicy.
+          "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+              # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+            "name": "A String", # Name of the cookie.
+            "path": "A String", # Path to set for the cookie.
+            "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+              # Currently this is applicable only for Internal TCP/UDP load balancing,
+              # Internal HTTP(S) load balancing and Traffic Director.
+            "policy": "A String",
+          },
+          "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+              # type of load balancer. For more information see,
+              # Backend service settings.
+              # The default is 30 seconds.
+              # The full range of timeout values allowed goes from 1
+              # through 2,147,483,647 seconds.
+              #
+              # This value can be overridden in the PathMatcher configuration of the
+              # UrlMap that references this backend service.
+              #
+              # Not supported when the backend service is referenced by a URL map that is
+              # bound to target gRPC proxy that has validateForProxyless field set to true.
+              # Instead, use maxStreamDuration.
+          "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+              # when the backend protocol is SSL, HTTPS or HTTP2.
+            "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+                # networksecurity.googleapis.com namespace. Can be used in authenticating
+                # TLS connections to the backend, as specified by the authenticationMode
+                # field. Can only be specified if authenticationMode is not NONE.
+            "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+                #
+                #
+                # Use this property to configure the load balancer back-end to use
+                # certificates and roots of trust provisioned by the Managed Workload
+                # Identity system.
+                #
+                #  The `identity` property is the
+                # fully-specified SPIFFE ID to use in the SVID presented by the Load
+                # Balancer Workload.
+                #
+                #  The SPIFFE ID must be a resource starting with the
+                # `trustDomain` property value, followed by the path to the Managed
+                # Workload Identity.
+                #
+                #  Supported SPIFFE ID format:
+                #
+                #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+                #
+                #
+                # The Trust Domain within the Managed Identity must refer to a valid
+                # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+                # will be inherited from the Workload Identity Pool.
+                #
+                #  Restrictions:
+                #
+                #    - If you set the `identity` property, you cannot manually set
+                #    the following fields:
+                #        - tlsSettings.sni
+                #       - tlsSettings.subjectAltNames
+                #       - tlsSettings.authenticationConfig
+                #
+                #
+                # When defining a `identity` for a RegionBackendServices, the
+                # corresponding Workload Identity Pool must have a ca_pool
+                # configured in the same region.
+                #
+                #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+            "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+                # balancer sends this string as the SNI hostname in the TLS connection to
+                # the backend, and requires that this string match a Subject Alternative
+                # Name (SAN) in the backend's server certificate. With a Regional Internet
+                # NEG backend, if the SNI is specified here, the load balancer uses it
+                # regardless of whether the Regional Internet NEG is specified with FQDN or
+                # IP address and port. When both sni and subjectAltNames[] are specified,
+                # the load balancer matches the backend certificate's SAN only to
+                # subjectAltNames[].
+            "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+                # verifies during a TLS handshake with the backend. When the server
+                # presents its X.509 certificate to the Load Balancer, the Load Balancer
+                # inspects the certificate's SAN field, and requires that at least one SAN
+                # match one of the subjectAltNames in the list. This field is limited to 5
+                # entries. When both sni and subjectAltNames[] are specified, the load
+                # balancer matches the backend certificate's SAN only to subjectAltNames[].
+              { # A Subject Alternative Name that the load balancer matches against the SAN
+                  # field in the TLS certificate provided by the backend, specified as either
+                  # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+                "dnsName": "A String", # The SAN specified as a DNS Name.
+                "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+              },
+            ],
+          },
+          "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+            {
+              "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+                  # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+                  # and ForwardingRule.
+            },
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#backendServiceAggregatedList", # 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, backendService, requestId=None, x__xgafv=None) + 
Deletes the specified BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteSignedUrlKey(project, backendService, keyName, requestId=None, x__xgafv=None) + 
Deletes a key for validating requests with signed URLs for this backend
+service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to which the Signed URL Key should be
+added. The name should conform to RFC1035. (required)
+  keyName: string, The name of the Signed URL Key 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, backendService, x__xgafv=None) + 
Returns the specified BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService 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 Backend Service resource.
+    #
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    #
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    #
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    #
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      #
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      #
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      #
+      # This field is applicable to either:
+      #
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      #
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      #
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      #
+      # The value of this field must be in the range [0, 100].
+      #
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      #
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      #
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      #
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      #
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      #
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      #
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      #
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      #
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      #
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      #
+      #
+      #
+      # This field is applicable to either:
+      #
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      #
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      #
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      #
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      #
+      #
+      #
+      # This field is applicable to either:
+      #
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      #
+      #
+      #
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      #
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      #
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      #
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      #
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      #
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      #
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      #
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      #
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      #
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      #
+      # Applicable backend endpoints can be:
+      #
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      #
+      #
+      #
+      # Applicable backend service types can be:
+      #
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      #
+      #
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      #
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      #
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      #
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      #
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      #
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      #
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      #
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      #
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+ +
+ getEffectiveSecurityPolicies(project, backendService, x__xgafv=None) + 
Returns effective security policies applied to this backend service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the Backend Service for this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ getHealth(project, backendService, body=None, x__xgafv=None) + 
Gets the most recent health check results for this
+BackendService.
+
+Example request body:
+
+{
+  "group": "/zones/us-east1-b/instanceGroups/lb-backend-example"
+}
+
+Args:
+  project: string, A parameter (required)
+  backendService: string, Name of the BackendService resource to which the queried instance belongs. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "group": "A String", # A URI referencing one of the instance groups or network endpoint groups
+      # listed in the backend service.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "annotations": { # Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "healthStatus": [ # Health state of the backend instances or endpoints in requested instance or
+      # network endpoint group, determined based on configured health checks.
+    {
+      "annotations": { # Metadata defined as annotations for network endpoint.
+        "a_key": "A String",
+      },
+      "forwardingRule": "A String", # URL of the forwarding rule associated with the health status of the
+          # instance.
+      "forwardingRuleIp": "A String", # A forwarding rule IP address assigned to this instance.
+      "healthState": "A String", # Health state of the IPv4 address of the instance.
+      "instance": "A String", # URL of the instance resource.
+      "ipAddress": "A String", # For target pool based Network Load Balancing, it indicates the forwarding
+          # rule's IP address assigned to this instance. For other types of load
+          # balancing, the field indicates VM internal ip.
+      "ipv6Address": "A String",
+      "ipv6HealthState": "A String", # Health state of the IPv6 address of the instance.
+      "port": 42, # The named port of the instance group, not necessarily the port that is
+          # health-checked.
+      "weight": "A String",
+      "weightError": "A String",
+    },
+  ],
+  "kind": "compute#backendServiceGroupHealth", # Output only. [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend
+      # services.
+}
+
+ +
+ 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 BackendService resource in the specified project using
+the data included in the request. For more information, see
+Backend services overview.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of BackendService resources available to 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.
+  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 BackendService resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendService resources.
+    { # Represents a Backend Service resource.
+        #
+        # A backend service defines how Google Cloud load balancers distribute traffic.
+        # The backend service configuration contains a set of values, such as the
+        # protocol used to connect to backends, various distribution and session
+        # settings, health checks, and timeouts. These settings provide fine-grained
+        # control over how your load balancer behaves. Most of the settings have
+        # default values that allow for easy configuration if you need to get started
+        # quickly.
+        #
+        # Backend services in Google Compute Engine can be either regionally or
+        # globally scoped.
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+        #
+        # For more information, seeBackend
+        # Services.
+      "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+          # Load Balancers and Traffic Director and requires
+          # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+          #
+          # If set to 0, the cookie is non-persistent and lasts only until
+          # the end of the browser session (or equivalent). The maximum allowed value
+          # is two weeks (1,209,600).
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+      "backends": [ # The list of backends that serve this BackendService.
+        { # Message containing information of one individual backend.
+          "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+              # handle additional traffic or is fully loaded. For usage guidelines, see
+              # Connection balancing mode.
+              #
+              # Backends must use compatible balancing modes. Backends of a backend
+              # service may use different balancing modes. For more information, see
+              # Supported balancing modes and target capacity settings and
+              # Restrictions and guidance for instance groups.
+              #
+              # Note: Currently, if you use the API to configure incompatible balancing
+              # modes, the configuration might be accepted even though it has no impact
+              # and is ignored. Specifically, Backend.maxUtilization is ignored when
+              # Backend.balancingMode is RATE. In the future, this incompatible combination
+              # will be rejected.
+          "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+              # mode.
+              # The default value is 1, which means the group serves up to
+              # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+              # completely drained, offering 0% of its available capacity. The valid ranges
+              # are 0.0 and [0.1,1.0].
+              # You cannot configure a setting larger than 0 and smaller than0.1.
+              # You cannot configure a setting of 0 when there is only one
+              # backend attached to the backend service.
+              #
+              # Not available with backends that don't support using abalancingMode. This includes backends such as global
+              # internet NEGs, regional serverless NEGs, and PSC NEGs.
+          "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+              # BalancingMode.
+            { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+              "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+                  # Monitoring, but is not used for load balancing.
+              "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+                  # balancing mode. The valid range is [0.0, 1.0].
+              "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                  # long and match the regular expression
+                  # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                  # first character must be a lowercase letter, and all following
+                  # characters must be a dash, period, underscore, lowercase letter, or
+                  # digit, except the last character, which cannot be a dash, period, or
+                  # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                  # field can only be used for a global or regional backend service with the
+                  # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+            },
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one
+              # failover backend can be configured for a given BackendService.
+              #
+              # This field can only be used for a regional external Passthrough Network
+              # Load Balancer or a regional internal Passthrough Network Load Balancer.
+          "group": "A String", # The fully-qualified URL of aninstance
+              # group or network endpoint
+              # group (NEG) resource. To determine what types of backends a load
+              # balancer supports, see the [Backend services
+              # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+              #
+              # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+              # or NEG. Partial URLs are not supported.
+              #
+              # If haPolicy is specified, backends must refer to NEG resources of type
+              # GCE_VM_IP.
+          "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode. Not available if the backend'sbalancingMode is RATE.
+          "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+              # For usage guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+              # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+              # usage guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+              #
+              # 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:
+              #
+              #    - PREFERRED: Backends with this preference level will be
+              #    filled up to their capacity limits first, based on RTT.
+              #    - DEFAULT:  If preferred backends don't have enough
+              #    capacity, backends in this layer would be used and traffic would be
+              #    assigned based on the load balancing algorithm you use. This is the
+              #    default
+              #
+              #
+              #
+              # For global external Passthrough Network Load Balancers, the following
+              # restrictions apply:
+              #
+              #    - At most one backend can be marked as PREFERRED.
+              #    - PREFERRED and DEFAULT backends cannot reside
+              #    in the same Cloud region.
+          "trafficDuration": "A String",
+        },
+      ],
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+          # specified load balancer types.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+            # CDN.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # query_string_whitelist and query_string_blacklist. If neither is set, the
+              # entire query string will be included. If false, the query string will be
+              # excluded from the cache key entirely.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+          # backend service.
+        "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+            # there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+            # not specified, there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+            # service. If not specified, there is no limit.
+        "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+            # This parameter is respected by both the HTTP/1.1 and HTTP/2
+            # implementations. If not specified, there is no limit. Setting this
+            # parameter to 1 will effectively disable keep alive.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+            # not specified, the default is 1.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+        "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+            # instance. For supported load balancers and protocols, as described inEnabling
+            # connection draining.
+      },
+      "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+          # tracking policy settings are only available for external passthrough
+          # Network Load Balancers and internal passthrough Network Load Balancers.
+          #
+          # connectionTrackingPolicy cannot be specified with haPolicy.
+        "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+            # value is DEFAULT_FOR_PROTOCOL.
+            #
+            # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+            # persist on unhealthy backends only for connection-oriented protocols
+            # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+            # Affinity is configured for 5-tuple. They do not persist forUDP.
+            #
+            # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+            # the existing connections on the unhealthy backend are never persisted on
+            # the unhealthy backend. They are always diverted to newly selected healthy
+            # backends (unless all backends are unhealthy).
+            #
+            # If set to ALWAYS_PERSIST, existing connections always
+            # persist on unhealthy backends regardless of protocol and session
+            # affinity. It is generally not recommended to use this mode overriding the
+            # default.
+            #
+            # For more details, see [Connection Persistence for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+            # and [Connection Persistence for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+        "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+            # Balancers. This option is not available publicly.
+        "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+            # matching traffic (in seconds).
+            #
+            # For internal passthrough Network Load Balancers:
+            #
+            #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+            #    - It can be set only if Connection Tracking is less than 5-tuple
+            #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+            #    Mode is PER_SESSION).
+            #
+            #
+            #
+            # For external passthrough Network Load Balancers the default is 60
+            # seconds. This option is not available publicly.
+        "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+            # options:
+            #
+            #    - PER_CONNECTION: This is the default mode. The Connection
+            #    Tracking is performed as per the Connection Key (default Hash Method) for
+            #    the specific protocol.
+            #    - PER_SESSION: The Connection Tracking is performed as per
+            #    the configured Session Affinity. It matches the configured Session
+            #    Affinity.
+            #
+            #
+            #
+            # For more details, see [Tracking Mode for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+            # and [Tracking Mode for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+      },
+      "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+          # affinity based on HTTP headers, cookies or other properties. This load
+          # balancing policy is applicable only for HTTP connections. The affinity to a
+          # particular destination host will be lost when one or more hosts are
+          # added/removed from the destination service. This field specifies parameters
+          # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+            # be used as the hash key for the consistent hash load balancer. If the
+            # cookie is not present, it will be generated. This field is applicable if
+            # the sessionAffinity is set to HTTP_COOKIE.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+            # for load balancing policies that use a consistent hash.
+          "name": "A String", # Name of the cookie.
+          "path": "A String", # Path to set for the cookie.
+          "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+            # applicable if the sessionAffinity is set toHEADER_FIELD.
+        "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+            # 1024. Larger ring sizes result in more granular load distributions. If the
+            # number of hosts in the load balancing pool is larger than the ring size,
+            # each host will be assigned a single virtual node.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+        { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+            # locality_lb_policy.
+          "dryRun": True or False, # If true, the metric data is not used for load balancing.
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend service.
+      "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+          # global external Application Load Balancer.
+      "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+          # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+          # externalManagedMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+          # external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # Session affinity options will slightly affect this routing behavior, for
+          # more details, see:Session
+          # Affinity.
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+          # as a backup (failover) backend.
+          # For load balancers that have configurable failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+          # Network Load Balancers.
+          # failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough
+          # Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # On failover or failback, this field indicates whether connection draining
+          # will be honored. Google Cloud has a fixed connection draining timeout of
+          # 10 minutes. A setting of true terminates existing TCP
+          # connections to the active pool during failover and failback, immediately
+          # draining traffic. A setting of false allows existing TCP
+          # connections to persist, even on VMs no longer in the active pool, for up
+          # to the duration of the connection draining timeout (10 minutes).
+        "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+            #
+            # The default is false.
+        "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+            # load balancer are dropped when all primary and all backup backend VMs are
+            # unhealthy.If set to false, connections are distributed
+            # among all primary VMs when all primary and all backup backend VMs are
+            #  unhealthy.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+            # The default is false.
+        "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+            # failover when the number of healthy primary VMs equals zero.
+            # For all other values, the load balancer performs a failover when the
+            # total number of healthy primary VMs is less than this ratio.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      },
+      "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 BackendService. An up-to-date fingerprint must be provided in
+          # order to update the BackendService, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a BackendService.
+      "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+          # Protocol Forwarding.
+          #
+          # The backends of this regional backend service must only specify zonal
+          # network endpoint groups (NEGs) of type GCE_VM_IP.
+          #
+          # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+          # regional backend service must set the network field. All zonal NEGs must
+          # belong to the same network. However, individual NEGs can
+          # belong to different subnetworks of that network.
+          #
+          # When haPolicy is specified, the set of attached network endpoints across
+          # all backends comprise an High Availability domain from which one endpoint
+          # is selected as the active endpoint (the leader) that receives all
+          # traffic.
+          #
+          # haPolicy can be added only at backend service creation time. Once set up,
+          # it cannot be deleted.
+          #
+          # Note that haPolicy is not for load balancing, and therefore cannot be
+          # specified with sessionAffinity, connectionTrackingPolicy, and
+          # failoverPolicy.
+          #
+          # haPolicy requires customers to be responsible for tracking backend
+          # endpoint health and electing a leader among the healthy endpoints.
+          # Therefore, haPolicy cannot be specified with healthChecks.
+          # haPolicy can only be specified for External Passthrough
+          # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+          # Load Balancers.
+        "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+            # achieve it.
+            #
+            # Supported values are:
+            #
+            #    - DISABLED: Fast IP Move is disabled. You can only use the
+            #    haPolicy.leader API to update the leader.
+            #    - >GARP_RA: Provides a method to very quickly define a new network
+            #    endpoint as the leader. This method is faster than updating the leader
+            #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+            #    hosting the network endpoint that should become the new leader sends
+            #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+            #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+            #    temporarily associates the forwarding rule IP address with that VM, and
+            #    both new and in-flight packets are quickly delivered to that VM.
+            #
+            #
+            #
+            # Note the important properties of the Fast IP Move functionality:
+            #
+            #    - The GARP/RA-initiated re-routing stays active for approximately 20
+            #    minutes. After triggering fast failover, you must also
+            #    appropriately set the haPolicy.leader.
+            #    -  The new leader instance should continue to send GARP/RA packets
+            #    periodically every 10 seconds until at least 10 minutes after updating
+            #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+            #    - After triggering a fast failover, we recommend that you wait at least
+            #    3 seconds before sending another GARP/RA packet from a different VM
+            #    instance to avoid race conditions.
+            #    - Don't send GARP/RA packets from different VM
+            #    instances at the same time. If multiple instances continue to send
+            #    GARP/RA packets, traffic might be routed to different destinations in an
+            #    alternating order. This condition ceases when a single instance
+            #    issues a GARP/RA packet.
+            #    - The GARP/RA request always takes priority over the leader API.
+            #    Using the haPolicy.leader API to change the leader to a different
+            #    instance will have no effect until the GARP/RA request becomes
+            #    inactive.
+            #    - The GARP/RA packets should follow the GARP/RA
+            #    Packet Specifications..
+            #    -  When multiple forwarding rules refer to a regional backend service,
+            #    you need only send a GARP or RA packet for a single forwarding rule
+            #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+            #    backend service will also be moved to the sender of the GARP or RA
+            #    packet.
+            #
+            #
+            #
+            # The following are the Fast IP Move limitations (that is, when fastIPMove
+            # is not DISABLED):
+            #
+            #    - Multiple forwarding rules cannot use the same IP address if one of
+            #    them refers to a regional backend service with fastIPMove.
+            #    - The regional backend service must set the network field, and all
+            #    NEGs must belong to that network. However, individual
+            #    NEGs can belong to different subnetworks of that network.
+            #    - The maximum number of network endpoints across all backends of a
+            #    backend service with fastIPMove is 32.
+            #    - The maximum number of backend services with fastIPMove that can have
+            #    the same network endpoint attached to one of its backends is 64.
+            #    - The maximum number of backend services with fastIPMove in a VPC in a
+            #    region is 64.
+            #    - The network endpoints that are attached to a backend of a backend
+            #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+            #    - Traffic directed to the leader by a static route next hop will not be
+            #    redirected to a new leader by fast failover. Such traffic will only be
+            #    redirected once an haPolicy.leader update has taken effect. Only traffic
+            #    to the forwarding rule's virtual IP will be redirected to a new leader by
+            #    fast failover.
+            #
+            #
+            # haPolicy.fastIPMove can be set only at backend service creation time.
+            # Once set, it cannot be updated.
+            #
+            # By default, fastIpMove is set to DISABLED.
+        "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+            # this service as the active endpoint (the leader) that receives all
+            # traffic.
+            #
+            # When the leader changes, there is no connection draining to persist
+            # existing connections on the old leader.
+            #
+            # You are responsible for selecting a suitable endpoint as the
+            # leader. For example, preferring a healthy endpoint over unhealthy ones.
+            # Note that this service does not track backend endpoint health, and
+            # selects the configured leader unconditionally.
+          "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+              # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+              # that the leader is attached to.
+              #
+              # The leader's backendGroup must already be specified as a backend of
+              # this backend service. Removing a backend that is designated as the
+              # leader's backendGroup is not permitted.
+          "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+              # designated as the leader.
+              #
+              # This network endpoint cannot be detached from the NEG specified in
+              # the haPolicy.leader.backendGroup until the leader is updated with
+              # another network endpoint, or the leader is removed from the haPolicy.
+            "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+                # instance must already be attached to the NEG specified in the
+                # haPolicy.leader.backendGroup.
+                #
+                # The value must be a valid RFC1035 name (1-63 characters) or a valid
+                # instance URL.
+                # Authorization requires the following IAM permission on the
+                # specified resource instance: compute.instances.use
+          },
+        },
+      },
+      "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+          # httpsHealthChecks (legacy) resource for health checking this backend
+          # service. Not all backend services support legacy health checks. See
+          # Load balancer guide. Currently, at most one health check can be
+          # specified for each backend service. Backend services with
+          # instance group or zonal NEG backends must have a health check unless
+          # haPolicy is specified. Backend services with internet or serverless NEG
+          # backends must not have a health check.
+          #
+          # healthChecks[] cannot be specified with haPolicy.
+        "A String",
+      ],
+      "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+          # Not available for internal passthrough Network Load Balancers and external
+          # passthrough Network Load Balancers.
+        "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+            # incoming requests.
+        "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+        "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+            # For security reasons, this value cannot be retrieved via the API.
+            # Instead, the SHA-256 hash of the value is returned in the
+            # oauth2ClientSecretSha256 field.
+            #
+            # @InputOnly
+        "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+          # from the client to the backend for proxyless gRPC).
+          # The possible values are:
+          #
+          #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv4
+          #    health checks are used to check the health of the backends. This is the
+          #    default setting.
+          #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+          #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+          #    address).
+          #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv6
+          #    health checks are used to check the health of the backends.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    -  Advanced global external Application Load Balancer (load balancing
+          #    scheme EXTERNAL_MANAGED),
+          #    -  Regional external Application Load
+          #    Balancer,
+          #    -  Internal proxy Network Load Balancer (load balancing
+          #    scheme INTERNAL_MANAGED),
+          #    -  Regional internal Application Load
+          #    Balancer (load balancing scheme INTERNAL_MANAGED),
+          #    -  Traffic
+          #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+          #    INTERNAL_SELF_MANAGED).
+      "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+          # for backend services.
+      "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+          # created for one type of load balancer cannot be used with another.
+          # For more information, refer to
+          # Backend services product and scheme table.
+      "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+          # preference. When you use localityLbPolicies, you must set at least one
+          # value for either the localityLbPolicies[].policy or the
+          # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+          # value set in the localityLbPolicy field.
+          #
+          # For an example of how to use this field, seeDefine
+          # a list of preferred policies.
+          #
+          # Caution: This field and its children are intended for use in a service mesh
+          # that includes gRPC clients only. Envoy proxies can't use backend services
+          # that have this configuration.
+        { # Container for either a built-in LB policy supported by gRPC or Envoy or
+            # a custom one implemented by the end user.
+          "customPolicy": { # The configuration for a custom policy implemented by the user and
+              # deployed with the client.
+            "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+                # by a locally installed custom policy implementation.
+            "name": "A String", # Identifies the custom policy.
+                #
+                # The value should match the name of a custom implementation registered
+                # on the gRPC clients. It should follow protocol buffer message naming
+                # conventions and include the full path (for example,
+                # myorg.CustomLbPolicy). The maximum length is 256 characters.
+                #
+                # Do not specify the same custom policy more than once for a
+                # backend. If you do, the configuration is rejected.
+                #
+                # For an example of how to use this field, seeUse
+                # a custom policy.
+          },
+          "policy": { # The configuration for a built-in load balancing policy.
+            "name": "A String", # The name of a locality load-balancing policy. Valid values include
+                # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+                # about these values, see the description of localityLbPolicy.
+                #
+                # Do not specify the same policy more than once for a
+                # backend. If you do, the configuration is rejected.
+          },
+        },
+      ],
+      "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+          # possible values are:
+          #
+          #    - ROUND_ROBIN: This is a simple policy in which each healthy
+          #    backend is selected in round robin order. This is the default.
+          #    - LEAST_REQUEST: An O(1) algorithm which
+          #    selects two random healthy hosts and picks the host which has fewer active
+          #    requests.
+          #    - RING_HASH: The ring/modulo hash load balancer implements
+          #    consistent hashing to backends. The algorithm has the property that the
+          #    addition/removal of a host from a set of N hosts only affects 1/N of the
+          #    requests.
+          #    - RANDOM: The load balancer selects a random healthy
+          #    host.
+          #    - ORIGINAL_DESTINATION: Backend host is selected
+          #    based on the client connection metadata, i.e., connections are opened to
+          #    the same address as the destination address of the incoming connection
+          #    before the connection was redirected to the load balancer.
+          #    - MAGLEV: used as a drop in replacement for the ring hash
+          #    load balancer. Maglev is not as stable as ring hash but has faster table
+          #    lookup build times and host selection times. For more information about
+          #    Maglev, see Maglev:
+          #    A Fast and Reliable Software Network Load Balancer.
+          #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+          #    Load Balancing using weights computed from Backend reported Custom Metrics.
+          #    If set, the Backend Service responses are expected to contain non-standard
+          #    HTTP response header field Endpoint-Load-Metrics. The reported
+          #    metrics to use for computing the weights are specified via thecustomMetrics field.
+          #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+          #    health check reported weights. If set, the backend service must configure
+          #    an HTTP-based Health Check, and health check replies are expected to
+          #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+          #    weights. If set, load balancing is weighted based on the per-endpoint
+          #    weights reported in the last processed health check replies, as long as
+          #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+          #    Otherwise, load balancing remains equal-weight.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+          #    EXTERNAL_MANAGED.
+          #
+          #
+          #
+          # If sessionAffinity is not configured—that is, if session
+          # affinity remains at the default value of NONE—then the
+          # default value for localityLbPolicy
+          # is ROUND_ROBIN. If session affinity is set to a value other
+          # than NONE,
+          # then the default value for localityLbPolicy isMAGLEV.
+          #
+          # Only ROUND_ROBIN and RING_HASH are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # localityLbPolicy cannot be specified with haPolicy.
+      "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+          # by this backend service. If logging is enabled, logs will be exported to
+          # Stackdriver.
+          # backend service.
+        "enable": True or False, # Denotes whether to enable logging for the load balancer
+            # traffic served by this backend service. The default value is false.
+        "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+            # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+            # of optional fields you want to include in the logs. For example:
+            # serverInstance, serverGkeDetails.cluster,
+            # serverGkeDetails.pod.podNamespace
+          "A String",
+        ],
+        "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+            # service. Configures whether all, none or a subset of optional fields
+            # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+            # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+        "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+            # service. The value of the field must be in [0, 1]. This configures the
+            # sampling rate of requests to the load balancer where 1.0 means all logged
+            # requests are reported and 0.0 means no logged requests are reported. The
+            # default value is 1.0.
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+          # service. Duration is computed from the beginning of the stream until the
+          # response has been completely processed, including all retries. A stream
+          # that does not complete in this duration is closed.
+          #
+          # If not specified, there will be no timeout limit, i.e. the maximum
+          # duration is infinite.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # This field is only allowed when the loadBalancingScheme of
+          # the backend service is INTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+          # controller and read by the backend RCTH
+        "a_key": "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.
+      "network": "A String", # The URL of the network to which this backend service belongs.
+          #
+          # This field must be set for Internal Passthrough Network Load Balancers when
+          # the haPolicy is enabled, and for External Passthrough Network Load
+          # Balancers when the haPolicy fastIpMove is enabled.
+          #
+          # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+      "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+          # Load Balancers.
+          #
+          # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+        "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+            # endpoints in the local zone.
+          "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+              # possible values are:
+              #
+              #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+              #    is disabled. The load balancer distributes new connections to all
+              #    healthy backend endpoints across all zones.
+              #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there are no healthy
+              #    backend endpoints in the local zone, the load balancer distributes
+              #    new connections to all backend endpoints in the local zone.
+              #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there aren't enough
+              #    healthy backend endpoints in the local zone, the load balancer
+              #    distributes new connections to all healthy backend endpoints across all
+              #    zones.
+          "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+              # of healthy backend endpoints in a zone to the count of backend
+              # endpoints in that same zone is equal to or above this threshold, the
+              # load balancer distributes new connections to all healthy endpoints in
+              # the local zone only. When the ratio of the count of healthy backend
+              # endpoints in a zone to the count of backend endpoints in that same
+              # zone is below this threshold, the load balancer distributes all new
+              # 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
+          # considered disabled.
+          #
+          # Results of the outlier detection algorithm (ejection of endpoints from the
+          # load balancing pool and returning them back to the pool) are executed
+          # independently by each proxy instance of the load balancer. In most cases,
+          # more than one proxy instance handles the traffic received by a backend
+          # service. Thus, it is possible that an unhealthy endpoint is detected and
+          # ejected by only some of the proxies, and while this happens, other proxies
+          # may continue to send requests to the same unhealthy endpoint until they
+          # detect and eject the unhealthy endpoint.
+          #
+          # Applicable backend endpoints can be:
+          #
+          #    - VM instances in an Instance Group
+          #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+          #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+          #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+          #    Functions Services
+          #    - Private Service Connect NEGs, that resolve to
+          #    Google-managed regional API endpoints or managed services published using
+          #    Private Service Connect
+          #
+          #
+          #
+          # Applicable backend service types can be:
+          #
+          #    - A global backend service with the loadBalancingScheme set to
+          #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+          #    - A regional backend
+          #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+          #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+          #    supported for Serverless NEGs.
+          #
+          #
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # pool for the backend service.
+        "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+            # or 30s.
+            #
+            # After a backend endpoint is returned back to the load balancing pool, it
+            # can be ejected again in another ejection analysis. Thus, the total ejection
+            # time is equal to the base ejection time multiplied by the number of times
+            # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+            # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+            # return code qualifies as an error. Defaults to 5.
+        "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+            # connection errors that are mapped to one of those status codes) before a
+            # consecutive gateway failure ejection occurs. Defaults to 3.
+        "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive 5xx. This setting can be
+            # used to disable ejection or to ramp it up slowly. Defaults to 0.
+        "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive gateway failures. This
+            # setting can be used to disable ejection or to ramp it up slowly. Defaults
+            # to 100.
+        "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through success rate statistics. This setting
+            # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+            # ejections and backend endpoints being returned to service. The interval is
+            # equal to the number of seconds as defined in
+            # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+            # in outlierDetection.interval.nanos. Defaults to 1 second.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+            # backend service that can be ejected if the ejection conditions are met.
+            # Defaults to 50%.
+        "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+            # enough request volume to detect success rate outliers. If the number of
+            # backend endpoints is fewer than this setting, outlier detection via success
+            # rate statistics is not performed for any backend endpoint in the load
+            # balancing pool. Defaults to 5.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+            # (as defined by the interval duration above) to include this backend
+            # endpoint in success rate based outlier detection. If the volume is lower
+            # than this setting, outlier detection via success rate statistics is not
+            # performed for that backend endpoint. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+            # outlier ejection. The ejection threshold is the difference between the mean
+            # success rate, and the product of this factor and the standard deviation of
+            # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+            # is divided by a thousand to get a double. That is, if the desired factor
+            # is 1.9, the runtime value should be 1900. Defaults to 1900.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+      },
+      "params": { # Additional Backend Service 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+          # the backend. The default value is 80.
+          # For internal passthrough Network Load Balancers and external passthrough
+          # Network Load Balancers, omit port.
+      "portName": "A String", # A named port on a backend instance group representing the port for
+          # communication to the backend VMs in that group. The
+          # named port must be [defined on each backend instance
+          # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+          # This parameter has no meaning if the backends are NEGs. For internal
+          # passthrough Network Load Balancers and external passthrough Network Load
+          # Balancers, omit port_name.
+      "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+          #
+          # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+          # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+          # configuration.
+          # Refer to
+          # Load balancing features for more information.
+          #
+          # Must be set to GRPC when the backend service is referenced by a URL map
+          # that is bound to target gRPC proxy.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+          # resides. This field is not applicable to global backend services.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # backend service.
+      "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+          # service. This field is applicable to a global backend service with the
+          # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+            # storage buckets that support AWS's Signature Version 4 for authentication.
+            # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+            # private storage buckets that support Signature Version 4 for authentication.
+            # The service name for generating the authentication header will always default
+            # to 's3'.
+          "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+              # creating a backend that uses AWS v4 signature authentication, but will not
+              # be returned as part of the configuration when queried with a REST API GET
+              # request.
+              #
+              # @InputOnly
+          "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+          "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+              # keep track of different iterations of your access key.
+          "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+              # the name of the region your cloud uses to host your origin.  For example,
+              # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+        },
+        "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+            # that describes how clients should authenticate with this service's
+            # backends.
+            #
+            #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+            # to INTERNAL_SELF_MANAGED.
+            #
+            #  If left blank, communications are not encrypted.
+        "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+            # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+            # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+            # specified values, the communication continues. Otherwise, it fails. This
+            # additional check enables the client to verify that the server is authorized
+            # to run the requested service.
+            #
+            #  Note that the contents of the server
+            # certificate's subjectAltName field are configured by the
+            # Public Key Infrastructure which provisions server identities.
+            #
+            #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+            # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+            # mode).
+          "A String",
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+          #
+          # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+          # If set, lists of backends and health checks must be both empty.
+        "A String",
+      ],
+      "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+          #
+          # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+          # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+          # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+          # global backend service, the service lb policy must be global. For a
+          # regional backend service, the service lb policy must be regional and in the
+          # same region.
+      "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+          #
+          # Only NONE and HEADER_FIELD are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # For more details, see:
+          # [Session
+          # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+          #
+          # sessionAffinity cannot be specified with haPolicy.
+      "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+          # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+        "name": "A String", # Name of the cookie.
+        "path": "A String", # Path to set for the cookie.
+        "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+          # Currently this is applicable only for Internal TCP/UDP load balancing,
+          # Internal HTTP(S) load balancing and Traffic Director.
+        "policy": "A String",
+      },
+      "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+          # type of load balancer. For more information see,
+          # Backend service settings.
+          # The default is 30 seconds.
+          # The full range of timeout values allowed goes from 1
+          # through 2,147,483,647 seconds.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # Instead, use maxStreamDuration.
+      "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+          # when the backend protocol is SSL, HTTPS or HTTP2.
+        "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+            # networksecurity.googleapis.com namespace. Can be used in authenticating
+            # TLS connections to the backend, as specified by the authenticationMode
+            # field. Can only be specified if authenticationMode is not NONE.
+        "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+            #
+            #
+            # Use this property to configure the load balancer back-end to use
+            # certificates and roots of trust provisioned by the Managed Workload
+            # Identity system.
+            #
+            #  The `identity` property is the
+            # fully-specified SPIFFE ID to use in the SVID presented by the Load
+            # Balancer Workload.
+            #
+            #  The SPIFFE ID must be a resource starting with the
+            # `trustDomain` property value, followed by the path to the Managed
+            # Workload Identity.
+            #
+            #  Supported SPIFFE ID format:
+            #
+            #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+            #
+            #
+            # The Trust Domain within the Managed Identity must refer to a valid
+            # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+            # will be inherited from the Workload Identity Pool.
+            #
+            #  Restrictions:
+            #
+            #    - If you set the `identity` property, you cannot manually set
+            #    the following fields:
+            #        - tlsSettings.sni
+            #       - tlsSettings.subjectAltNames
+            #       - tlsSettings.authenticationConfig
+            #
+            #
+            # When defining a `identity` for a RegionBackendServices, the
+            # corresponding Workload Identity Pool must have a ca_pool
+            # configured in the same region.
+            #
+            #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+        "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+            # balancer sends this string as the SNI hostname in the TLS connection to
+            # the backend, and requires that this string match a Subject Alternative
+            # Name (SAN) in the backend's server certificate. With a Regional Internet
+            # NEG backend, if the SNI is specified here, the load balancer uses it
+            # regardless of whether the Regional Internet NEG is specified with FQDN or
+            # IP address and port. When both sni and subjectAltNames[] are specified,
+            # the load balancer matches the backend certificate's SAN only to
+            # subjectAltNames[].
+        "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+            # verifies during a TLS handshake with the backend. When the server
+            # presents its X.509 certificate to the Load Balancer, the Load Balancer
+            # inspects the certificate's SAN field, and requires that at least one SAN
+            # match one of the subjectAltNames in the list. This field is limited to 5
+            # entries. When both sni and subjectAltNames[] are specified, the load
+            # balancer matches the backend certificate's SAN only to subjectAltNames[].
+          { # A Subject Alternative Name that the load balancer matches against the SAN
+              # field in the TLS certificate provided by the backend, specified as either
+              # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+            "dnsName": "A String", # The SAN specified as a DNS Name.
+            "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+          },
+        ],
+      },
+      "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+              # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+              # and ForwardingRule.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#backendServiceList", # Output only. [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of all usable backend services for Application Load
+Balancers and Proxy Network Load Balancers in the specified project.
+Backend services for external and internal passthrough Network Load
+Balancers are not included in the response.
+
+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.
+  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 usable BackendService resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendService resources.
+    { # Represents a Backend Service resource.
+        #
+        # A backend service defines how Google Cloud load balancers distribute traffic.
+        # The backend service configuration contains a set of values, such as the
+        # protocol used to connect to backends, various distribution and session
+        # settings, health checks, and timeouts. These settings provide fine-grained
+        # control over how your load balancer behaves. Most of the settings have
+        # default values that allow for easy configuration if you need to get started
+        # quickly.
+        #
+        # Backend services in Google Compute Engine can be either regionally or
+        # globally scoped.
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+        #
+        # For more information, seeBackend
+        # Services.
+      "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+          # Load Balancers and Traffic Director and requires
+          # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+          #
+          # If set to 0, the cookie is non-persistent and lasts only until
+          # the end of the browser session (or equivalent). The maximum allowed value
+          # is two weeks (1,209,600).
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+      "backends": [ # The list of backends that serve this BackendService.
+        { # Message containing information of one individual backend.
+          "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+              # handle additional traffic or is fully loaded. For usage guidelines, see
+              # Connection balancing mode.
+              #
+              # Backends must use compatible balancing modes. Backends of a backend
+              # service may use different balancing modes. For more information, see
+              # Supported balancing modes and target capacity settings and
+              # Restrictions and guidance for instance groups.
+              #
+              # Note: Currently, if you use the API to configure incompatible balancing
+              # modes, the configuration might be accepted even though it has no impact
+              # and is ignored. Specifically, Backend.maxUtilization is ignored when
+              # Backend.balancingMode is RATE. In the future, this incompatible combination
+              # will be rejected.
+          "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+              # mode.
+              # The default value is 1, which means the group serves up to
+              # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+              # completely drained, offering 0% of its available capacity. The valid ranges
+              # are 0.0 and [0.1,1.0].
+              # You cannot configure a setting larger than 0 and smaller than0.1.
+              # You cannot configure a setting of 0 when there is only one
+              # backend attached to the backend service.
+              #
+              # Not available with backends that don't support using abalancingMode. This includes backends such as global
+              # internet NEGs, regional serverless NEGs, and PSC NEGs.
+          "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+              # BalancingMode.
+            { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+              "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+                  # Monitoring, but is not used for load balancing.
+              "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+                  # balancing mode. The valid range is [0.0, 1.0].
+              "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                  # long and match the regular expression
+                  # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                  # first character must be a lowercase letter, and all following
+                  # characters must be a dash, period, underscore, lowercase letter, or
+                  # digit, except the last character, which cannot be a dash, period, or
+                  # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                  # field can only be used for a global or regional backend service with the
+                  # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+            },
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one
+              # failover backend can be configured for a given BackendService.
+              #
+              # This field can only be used for a regional external Passthrough Network
+              # Load Balancer or a regional internal Passthrough Network Load Balancer.
+          "group": "A String", # The fully-qualified URL of aninstance
+              # group or network endpoint
+              # group (NEG) resource. To determine what types of backends a load
+              # balancer supports, see the [Backend services
+              # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+              #
+              # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+              # or NEG. Partial URLs are not supported.
+              #
+              # If haPolicy is specified, backends must refer to NEG resources of type
+              # GCE_VM_IP.
+          "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode. Not available if the backend'sbalancingMode is RATE.
+          "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+              # For usage guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+              # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+              # usage guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+              #
+              # 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:
+              #
+              #    - PREFERRED: Backends with this preference level will be
+              #    filled up to their capacity limits first, based on RTT.
+              #    - DEFAULT:  If preferred backends don't have enough
+              #    capacity, backends in this layer would be used and traffic would be
+              #    assigned based on the load balancing algorithm you use. This is the
+              #    default
+              #
+              #
+              #
+              # For global external Passthrough Network Load Balancers, the following
+              # restrictions apply:
+              #
+              #    - At most one backend can be marked as PREFERRED.
+              #    - PREFERRED and DEFAULT backends cannot reside
+              #    in the same Cloud region.
+          "trafficDuration": "A String",
+        },
+      ],
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+          # specified load balancer types.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+            # CDN.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # query_string_whitelist and query_string_blacklist. If neither is set, the
+              # entire query string will be included. If false, the query string will be
+              # excluded from the cache key entirely.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+          # backend service.
+        "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+            # there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+            # not specified, there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+            # service. If not specified, there is no limit.
+        "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+            # This parameter is respected by both the HTTP/1.1 and HTTP/2
+            # implementations. If not specified, there is no limit. Setting this
+            # parameter to 1 will effectively disable keep alive.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+            # not specified, the default is 1.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+        "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+            # instance. For supported load balancers and protocols, as described inEnabling
+            # connection draining.
+      },
+      "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+          # tracking policy settings are only available for external passthrough
+          # Network Load Balancers and internal passthrough Network Load Balancers.
+          #
+          # connectionTrackingPolicy cannot be specified with haPolicy.
+        "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+            # value is DEFAULT_FOR_PROTOCOL.
+            #
+            # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+            # persist on unhealthy backends only for connection-oriented protocols
+            # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+            # Affinity is configured for 5-tuple. They do not persist forUDP.
+            #
+            # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+            # the existing connections on the unhealthy backend are never persisted on
+            # the unhealthy backend. They are always diverted to newly selected healthy
+            # backends (unless all backends are unhealthy).
+            #
+            # If set to ALWAYS_PERSIST, existing connections always
+            # persist on unhealthy backends regardless of protocol and session
+            # affinity. It is generally not recommended to use this mode overriding the
+            # default.
+            #
+            # For more details, see [Connection Persistence for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+            # and [Connection Persistence for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+        "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+            # Balancers. This option is not available publicly.
+        "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+            # matching traffic (in seconds).
+            #
+            # For internal passthrough Network Load Balancers:
+            #
+            #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+            #    - It can be set only if Connection Tracking is less than 5-tuple
+            #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+            #    Mode is PER_SESSION).
+            #
+            #
+            #
+            # For external passthrough Network Load Balancers the default is 60
+            # seconds. This option is not available publicly.
+        "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+            # options:
+            #
+            #    - PER_CONNECTION: This is the default mode. The Connection
+            #    Tracking is performed as per the Connection Key (default Hash Method) for
+            #    the specific protocol.
+            #    - PER_SESSION: The Connection Tracking is performed as per
+            #    the configured Session Affinity. It matches the configured Session
+            #    Affinity.
+            #
+            #
+            #
+            # For more details, see [Tracking Mode for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+            # and [Tracking Mode for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+      },
+      "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+          # affinity based on HTTP headers, cookies or other properties. This load
+          # balancing policy is applicable only for HTTP connections. The affinity to a
+          # particular destination host will be lost when one or more hosts are
+          # added/removed from the destination service. This field specifies parameters
+          # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+            # be used as the hash key for the consistent hash load balancer. If the
+            # cookie is not present, it will be generated. This field is applicable if
+            # the sessionAffinity is set to HTTP_COOKIE.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+            # for load balancing policies that use a consistent hash.
+          "name": "A String", # Name of the cookie.
+          "path": "A String", # Path to set for the cookie.
+          "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+            # applicable if the sessionAffinity is set toHEADER_FIELD.
+        "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+            # 1024. Larger ring sizes result in more granular load distributions. If the
+            # number of hosts in the load balancing pool is larger than the ring size,
+            # each host will be assigned a single virtual node.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+        { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+            # locality_lb_policy.
+          "dryRun": True or False, # If true, the metric data is not used for load balancing.
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend service.
+      "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+          # global external Application Load Balancer.
+      "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+          # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+          # externalManagedMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+          # external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # Session affinity options will slightly affect this routing behavior, for
+          # more details, see:Session
+          # Affinity.
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+          # as a backup (failover) backend.
+          # For load balancers that have configurable failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+          # Network Load Balancers.
+          # failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough
+          # Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # On failover or failback, this field indicates whether connection draining
+          # will be honored. Google Cloud has a fixed connection draining timeout of
+          # 10 minutes. A setting of true terminates existing TCP
+          # connections to the active pool during failover and failback, immediately
+          # draining traffic. A setting of false allows existing TCP
+          # connections to persist, even on VMs no longer in the active pool, for up
+          # to the duration of the connection draining timeout (10 minutes).
+        "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+            #
+            # The default is false.
+        "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+            # load balancer are dropped when all primary and all backup backend VMs are
+            # unhealthy.If set to false, connections are distributed
+            # among all primary VMs when all primary and all backup backend VMs are
+            #  unhealthy.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+            # The default is false.
+        "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+            # failover when the number of healthy primary VMs equals zero.
+            # For all other values, the load balancer performs a failover when the
+            # total number of healthy primary VMs is less than this ratio.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      },
+      "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 BackendService. An up-to-date fingerprint must be provided in
+          # order to update the BackendService, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a BackendService.
+      "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+          # Protocol Forwarding.
+          #
+          # The backends of this regional backend service must only specify zonal
+          # network endpoint groups (NEGs) of type GCE_VM_IP.
+          #
+          # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+          # regional backend service must set the network field. All zonal NEGs must
+          # belong to the same network. However, individual NEGs can
+          # belong to different subnetworks of that network.
+          #
+          # When haPolicy is specified, the set of attached network endpoints across
+          # all backends comprise an High Availability domain from which one endpoint
+          # is selected as the active endpoint (the leader) that receives all
+          # traffic.
+          #
+          # haPolicy can be added only at backend service creation time. Once set up,
+          # it cannot be deleted.
+          #
+          # Note that haPolicy is not for load balancing, and therefore cannot be
+          # specified with sessionAffinity, connectionTrackingPolicy, and
+          # failoverPolicy.
+          #
+          # haPolicy requires customers to be responsible for tracking backend
+          # endpoint health and electing a leader among the healthy endpoints.
+          # Therefore, haPolicy cannot be specified with healthChecks.
+          # haPolicy can only be specified for External Passthrough
+          # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+          # Load Balancers.
+        "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+            # achieve it.
+            #
+            # Supported values are:
+            #
+            #    - DISABLED: Fast IP Move is disabled. You can only use the
+            #    haPolicy.leader API to update the leader.
+            #    - >GARP_RA: Provides a method to very quickly define a new network
+            #    endpoint as the leader. This method is faster than updating the leader
+            #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+            #    hosting the network endpoint that should become the new leader sends
+            #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+            #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+            #    temporarily associates the forwarding rule IP address with that VM, and
+            #    both new and in-flight packets are quickly delivered to that VM.
+            #
+            #
+            #
+            # Note the important properties of the Fast IP Move functionality:
+            #
+            #    - The GARP/RA-initiated re-routing stays active for approximately 20
+            #    minutes. After triggering fast failover, you must also
+            #    appropriately set the haPolicy.leader.
+            #    -  The new leader instance should continue to send GARP/RA packets
+            #    periodically every 10 seconds until at least 10 minutes after updating
+            #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+            #    - After triggering a fast failover, we recommend that you wait at least
+            #    3 seconds before sending another GARP/RA packet from a different VM
+            #    instance to avoid race conditions.
+            #    - Don't send GARP/RA packets from different VM
+            #    instances at the same time. If multiple instances continue to send
+            #    GARP/RA packets, traffic might be routed to different destinations in an
+            #    alternating order. This condition ceases when a single instance
+            #    issues a GARP/RA packet.
+            #    - The GARP/RA request always takes priority over the leader API.
+            #    Using the haPolicy.leader API to change the leader to a different
+            #    instance will have no effect until the GARP/RA request becomes
+            #    inactive.
+            #    - The GARP/RA packets should follow the GARP/RA
+            #    Packet Specifications..
+            #    -  When multiple forwarding rules refer to a regional backend service,
+            #    you need only send a GARP or RA packet for a single forwarding rule
+            #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+            #    backend service will also be moved to the sender of the GARP or RA
+            #    packet.
+            #
+            #
+            #
+            # The following are the Fast IP Move limitations (that is, when fastIPMove
+            # is not DISABLED):
+            #
+            #    - Multiple forwarding rules cannot use the same IP address if one of
+            #    them refers to a regional backend service with fastIPMove.
+            #    - The regional backend service must set the network field, and all
+            #    NEGs must belong to that network. However, individual
+            #    NEGs can belong to different subnetworks of that network.
+            #    - The maximum number of network endpoints across all backends of a
+            #    backend service with fastIPMove is 32.
+            #    - The maximum number of backend services with fastIPMove that can have
+            #    the same network endpoint attached to one of its backends is 64.
+            #    - The maximum number of backend services with fastIPMove in a VPC in a
+            #    region is 64.
+            #    - The network endpoints that are attached to a backend of a backend
+            #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+            #    - Traffic directed to the leader by a static route next hop will not be
+            #    redirected to a new leader by fast failover. Such traffic will only be
+            #    redirected once an haPolicy.leader update has taken effect. Only traffic
+            #    to the forwarding rule's virtual IP will be redirected to a new leader by
+            #    fast failover.
+            #
+            #
+            # haPolicy.fastIPMove can be set only at backend service creation time.
+            # Once set, it cannot be updated.
+            #
+            # By default, fastIpMove is set to DISABLED.
+        "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+            # this service as the active endpoint (the leader) that receives all
+            # traffic.
+            #
+            # When the leader changes, there is no connection draining to persist
+            # existing connections on the old leader.
+            #
+            # You are responsible for selecting a suitable endpoint as the
+            # leader. For example, preferring a healthy endpoint over unhealthy ones.
+            # Note that this service does not track backend endpoint health, and
+            # selects the configured leader unconditionally.
+          "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+              # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+              # that the leader is attached to.
+              #
+              # The leader's backendGroup must already be specified as a backend of
+              # this backend service. Removing a backend that is designated as the
+              # leader's backendGroup is not permitted.
+          "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+              # designated as the leader.
+              #
+              # This network endpoint cannot be detached from the NEG specified in
+              # the haPolicy.leader.backendGroup until the leader is updated with
+              # another network endpoint, or the leader is removed from the haPolicy.
+            "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+                # instance must already be attached to the NEG specified in the
+                # haPolicy.leader.backendGroup.
+                #
+                # The value must be a valid RFC1035 name (1-63 characters) or a valid
+                # instance URL.
+                # Authorization requires the following IAM permission on the
+                # specified resource instance: compute.instances.use
+          },
+        },
+      },
+      "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+          # httpsHealthChecks (legacy) resource for health checking this backend
+          # service. Not all backend services support legacy health checks. See
+          # Load balancer guide. Currently, at most one health check can be
+          # specified for each backend service. Backend services with
+          # instance group or zonal NEG backends must have a health check unless
+          # haPolicy is specified. Backend services with internet or serverless NEG
+          # backends must not have a health check.
+          #
+          # healthChecks[] cannot be specified with haPolicy.
+        "A String",
+      ],
+      "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+          # Not available for internal passthrough Network Load Balancers and external
+          # passthrough Network Load Balancers.
+        "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+            # incoming requests.
+        "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+        "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+            # For security reasons, this value cannot be retrieved via the API.
+            # Instead, the SHA-256 hash of the value is returned in the
+            # oauth2ClientSecretSha256 field.
+            #
+            # @InputOnly
+        "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+          # from the client to the backend for proxyless gRPC).
+          # The possible values are:
+          #
+          #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv4
+          #    health checks are used to check the health of the backends. This is the
+          #    default setting.
+          #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+          #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+          #    address).
+          #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv6
+          #    health checks are used to check the health of the backends.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    -  Advanced global external Application Load Balancer (load balancing
+          #    scheme EXTERNAL_MANAGED),
+          #    -  Regional external Application Load
+          #    Balancer,
+          #    -  Internal proxy Network Load Balancer (load balancing
+          #    scheme INTERNAL_MANAGED),
+          #    -  Regional internal Application Load
+          #    Balancer (load balancing scheme INTERNAL_MANAGED),
+          #    -  Traffic
+          #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+          #    INTERNAL_SELF_MANAGED).
+      "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+          # for backend services.
+      "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+          # created for one type of load balancer cannot be used with another.
+          # For more information, refer to
+          # Backend services product and scheme table.
+      "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+          # preference. When you use localityLbPolicies, you must set at least one
+          # value for either the localityLbPolicies[].policy or the
+          # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+          # value set in the localityLbPolicy field.
+          #
+          # For an example of how to use this field, seeDefine
+          # a list of preferred policies.
+          #
+          # Caution: This field and its children are intended for use in a service mesh
+          # that includes gRPC clients only. Envoy proxies can't use backend services
+          # that have this configuration.
+        { # Container for either a built-in LB policy supported by gRPC or Envoy or
+            # a custom one implemented by the end user.
+          "customPolicy": { # The configuration for a custom policy implemented by the user and
+              # deployed with the client.
+            "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+                # by a locally installed custom policy implementation.
+            "name": "A String", # Identifies the custom policy.
+                #
+                # The value should match the name of a custom implementation registered
+                # on the gRPC clients. It should follow protocol buffer message naming
+                # conventions and include the full path (for example,
+                # myorg.CustomLbPolicy). The maximum length is 256 characters.
+                #
+                # Do not specify the same custom policy more than once for a
+                # backend. If you do, the configuration is rejected.
+                #
+                # For an example of how to use this field, seeUse
+                # a custom policy.
+          },
+          "policy": { # The configuration for a built-in load balancing policy.
+            "name": "A String", # The name of a locality load-balancing policy. Valid values include
+                # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+                # about these values, see the description of localityLbPolicy.
+                #
+                # Do not specify the same policy more than once for a
+                # backend. If you do, the configuration is rejected.
+          },
+        },
+      ],
+      "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+          # possible values are:
+          #
+          #    - ROUND_ROBIN: This is a simple policy in which each healthy
+          #    backend is selected in round robin order. This is the default.
+          #    - LEAST_REQUEST: An O(1) algorithm which
+          #    selects two random healthy hosts and picks the host which has fewer active
+          #    requests.
+          #    - RING_HASH: The ring/modulo hash load balancer implements
+          #    consistent hashing to backends. The algorithm has the property that the
+          #    addition/removal of a host from a set of N hosts only affects 1/N of the
+          #    requests.
+          #    - RANDOM: The load balancer selects a random healthy
+          #    host.
+          #    - ORIGINAL_DESTINATION: Backend host is selected
+          #    based on the client connection metadata, i.e., connections are opened to
+          #    the same address as the destination address of the incoming connection
+          #    before the connection was redirected to the load balancer.
+          #    - MAGLEV: used as a drop in replacement for the ring hash
+          #    load balancer. Maglev is not as stable as ring hash but has faster table
+          #    lookup build times and host selection times. For more information about
+          #    Maglev, see Maglev:
+          #    A Fast and Reliable Software Network Load Balancer.
+          #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+          #    Load Balancing using weights computed from Backend reported Custom Metrics.
+          #    If set, the Backend Service responses are expected to contain non-standard
+          #    HTTP response header field Endpoint-Load-Metrics. The reported
+          #    metrics to use for computing the weights are specified via thecustomMetrics field.
+          #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+          #    health check reported weights. If set, the backend service must configure
+          #    an HTTP-based Health Check, and health check replies are expected to
+          #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+          #    weights. If set, load balancing is weighted based on the per-endpoint
+          #    weights reported in the last processed health check replies, as long as
+          #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+          #    Otherwise, load balancing remains equal-weight.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+          #    EXTERNAL_MANAGED.
+          #
+          #
+          #
+          # If sessionAffinity is not configured—that is, if session
+          # affinity remains at the default value of NONE—then the
+          # default value for localityLbPolicy
+          # is ROUND_ROBIN. If session affinity is set to a value other
+          # than NONE,
+          # then the default value for localityLbPolicy isMAGLEV.
+          #
+          # Only ROUND_ROBIN and RING_HASH are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # localityLbPolicy cannot be specified with haPolicy.
+      "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+          # by this backend service. If logging is enabled, logs will be exported to
+          # Stackdriver.
+          # backend service.
+        "enable": True or False, # Denotes whether to enable logging for the load balancer
+            # traffic served by this backend service. The default value is false.
+        "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+            # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+            # of optional fields you want to include in the logs. For example:
+            # serverInstance, serverGkeDetails.cluster,
+            # serverGkeDetails.pod.podNamespace
+          "A String",
+        ],
+        "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+            # service. Configures whether all, none or a subset of optional fields
+            # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+            # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+        "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+            # service. The value of the field must be in [0, 1]. This configures the
+            # sampling rate of requests to the load balancer where 1.0 means all logged
+            # requests are reported and 0.0 means no logged requests are reported. The
+            # default value is 1.0.
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+          # service. Duration is computed from the beginning of the stream until the
+          # response has been completely processed, including all retries. A stream
+          # that does not complete in this duration is closed.
+          #
+          # If not specified, there will be no timeout limit, i.e. the maximum
+          # duration is infinite.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # This field is only allowed when the loadBalancingScheme of
+          # the backend service is INTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+          # controller and read by the backend RCTH
+        "a_key": "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.
+      "network": "A String", # The URL of the network to which this backend service belongs.
+          #
+          # This field must be set for Internal Passthrough Network Load Balancers when
+          # the haPolicy is enabled, and for External Passthrough Network Load
+          # Balancers when the haPolicy fastIpMove is enabled.
+          #
+          # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+      "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+          # Load Balancers.
+          #
+          # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+        "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+            # endpoints in the local zone.
+          "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+              # possible values are:
+              #
+              #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+              #    is disabled. The load balancer distributes new connections to all
+              #    healthy backend endpoints across all zones.
+              #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there are no healthy
+              #    backend endpoints in the local zone, the load balancer distributes
+              #    new connections to all backend endpoints in the local zone.
+              #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there aren't enough
+              #    healthy backend endpoints in the local zone, the load balancer
+              #    distributes new connections to all healthy backend endpoints across all
+              #    zones.
+          "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+              # of healthy backend endpoints in a zone to the count of backend
+              # endpoints in that same zone is equal to or above this threshold, the
+              # load balancer distributes new connections to all healthy endpoints in
+              # the local zone only. When the ratio of the count of healthy backend
+              # endpoints in a zone to the count of backend endpoints in that same
+              # zone is below this threshold, the load balancer distributes all new
+              # 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
+          # considered disabled.
+          #
+          # Results of the outlier detection algorithm (ejection of endpoints from the
+          # load balancing pool and returning them back to the pool) are executed
+          # independently by each proxy instance of the load balancer. In most cases,
+          # more than one proxy instance handles the traffic received by a backend
+          # service. Thus, it is possible that an unhealthy endpoint is detected and
+          # ejected by only some of the proxies, and while this happens, other proxies
+          # may continue to send requests to the same unhealthy endpoint until they
+          # detect and eject the unhealthy endpoint.
+          #
+          # Applicable backend endpoints can be:
+          #
+          #    - VM instances in an Instance Group
+          #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+          #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+          #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+          #    Functions Services
+          #    - Private Service Connect NEGs, that resolve to
+          #    Google-managed regional API endpoints or managed services published using
+          #    Private Service Connect
+          #
+          #
+          #
+          # Applicable backend service types can be:
+          #
+          #    - A global backend service with the loadBalancingScheme set to
+          #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+          #    - A regional backend
+          #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+          #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+          #    supported for Serverless NEGs.
+          #
+          #
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # pool for the backend service.
+        "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+            # or 30s.
+            #
+            # After a backend endpoint is returned back to the load balancing pool, it
+            # can be ejected again in another ejection analysis. Thus, the total ejection
+            # time is equal to the base ejection time multiplied by the number of times
+            # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+            # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+            # return code qualifies as an error. Defaults to 5.
+        "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+            # connection errors that are mapped to one of those status codes) before a
+            # consecutive gateway failure ejection occurs. Defaults to 3.
+        "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive 5xx. This setting can be
+            # used to disable ejection or to ramp it up slowly. Defaults to 0.
+        "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive gateway failures. This
+            # setting can be used to disable ejection or to ramp it up slowly. Defaults
+            # to 100.
+        "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through success rate statistics. This setting
+            # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+            # ejections and backend endpoints being returned to service. The interval is
+            # equal to the number of seconds as defined in
+            # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+            # in outlierDetection.interval.nanos. Defaults to 1 second.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+            # backend service that can be ejected if the ejection conditions are met.
+            # Defaults to 50%.
+        "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+            # enough request volume to detect success rate outliers. If the number of
+            # backend endpoints is fewer than this setting, outlier detection via success
+            # rate statistics is not performed for any backend endpoint in the load
+            # balancing pool. Defaults to 5.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+            # (as defined by the interval duration above) to include this backend
+            # endpoint in success rate based outlier detection. If the volume is lower
+            # than this setting, outlier detection via success rate statistics is not
+            # performed for that backend endpoint. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+            # outlier ejection. The ejection threshold is the difference between the mean
+            # success rate, and the product of this factor and the standard deviation of
+            # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+            # is divided by a thousand to get a double. That is, if the desired factor
+            # is 1.9, the runtime value should be 1900. Defaults to 1900.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+      },
+      "params": { # Additional Backend Service 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+          # the backend. The default value is 80.
+          # For internal passthrough Network Load Balancers and external passthrough
+          # Network Load Balancers, omit port.
+      "portName": "A String", # A named port on a backend instance group representing the port for
+          # communication to the backend VMs in that group. The
+          # named port must be [defined on each backend instance
+          # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+          # This parameter has no meaning if the backends are NEGs. For internal
+          # passthrough Network Load Balancers and external passthrough Network Load
+          # Balancers, omit port_name.
+      "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+          #
+          # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+          # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+          # configuration.
+          # Refer to
+          # Load balancing features for more information.
+          #
+          # Must be set to GRPC when the backend service is referenced by a URL map
+          # that is bound to target gRPC proxy.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+          # resides. This field is not applicable to global backend services.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # backend service.
+      "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+          # service. This field is applicable to a global backend service with the
+          # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+            # storage buckets that support AWS's Signature Version 4 for authentication.
+            # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+            # private storage buckets that support Signature Version 4 for authentication.
+            # The service name for generating the authentication header will always default
+            # to 's3'.
+          "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+              # creating a backend that uses AWS v4 signature authentication, but will not
+              # be returned as part of the configuration when queried with a REST API GET
+              # request.
+              #
+              # @InputOnly
+          "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+          "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+              # keep track of different iterations of your access key.
+          "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+              # the name of the region your cloud uses to host your origin.  For example,
+              # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+        },
+        "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+            # that describes how clients should authenticate with this service's
+            # backends.
+            #
+            #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+            # to INTERNAL_SELF_MANAGED.
+            #
+            #  If left blank, communications are not encrypted.
+        "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+            # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+            # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+            # specified values, the communication continues. Otherwise, it fails. This
+            # additional check enables the client to verify that the server is authorized
+            # to run the requested service.
+            #
+            #  Note that the contents of the server
+            # certificate's subjectAltName field are configured by the
+            # Public Key Infrastructure which provisions server identities.
+            #
+            #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+            # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+            # mode).
+          "A String",
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+          #
+          # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+          # If set, lists of backends and health checks must be both empty.
+        "A String",
+      ],
+      "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+          #
+          # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+          # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+          # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+          # global backend service, the service lb policy must be global. For a
+          # regional backend service, the service lb policy must be regional and in the
+          # same region.
+      "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+          #
+          # Only NONE and HEADER_FIELD are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # For more details, see:
+          # [Session
+          # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+          #
+          # sessionAffinity cannot be specified with haPolicy.
+      "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+          # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+        "name": "A String", # Name of the cookie.
+        "path": "A String", # Path to set for the cookie.
+        "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+          # Currently this is applicable only for Internal TCP/UDP load balancing,
+          # Internal HTTP(S) load balancing and Traffic Director.
+        "policy": "A String",
+      },
+      "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+          # type of load balancer. For more information see,
+          # Backend service settings.
+          # The default is 30 seconds.
+          # The full range of timeout values allowed goes from 1
+          # through 2,147,483,647 seconds.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # Instead, use maxStreamDuration.
+      "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+          # when the backend protocol is SSL, HTTPS or HTTP2.
+        "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+            # networksecurity.googleapis.com namespace. Can be used in authenticating
+            # TLS connections to the backend, as specified by the authenticationMode
+            # field. Can only be specified if authenticationMode is not NONE.
+        "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+            #
+            #
+            # Use this property to configure the load balancer back-end to use
+            # certificates and roots of trust provisioned by the Managed Workload
+            # Identity system.
+            #
+            #  The `identity` property is the
+            # fully-specified SPIFFE ID to use in the SVID presented by the Load
+            # Balancer Workload.
+            #
+            #  The SPIFFE ID must be a resource starting with the
+            # `trustDomain` property value, followed by the path to the Managed
+            # Workload Identity.
+            #
+            #  Supported SPIFFE ID format:
+            #
+            #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+            #
+            #
+            # The Trust Domain within the Managed Identity must refer to a valid
+            # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+            # will be inherited from the Workload Identity Pool.
+            #
+            #  Restrictions:
+            #
+            #    - If you set the `identity` property, you cannot manually set
+            #    the following fields:
+            #        - tlsSettings.sni
+            #       - tlsSettings.subjectAltNames
+            #       - tlsSettings.authenticationConfig
+            #
+            #
+            # When defining a `identity` for a RegionBackendServices, the
+            # corresponding Workload Identity Pool must have a ca_pool
+            # configured in the same region.
+            #
+            #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+        "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+            # balancer sends this string as the SNI hostname in the TLS connection to
+            # the backend, and requires that this string match a Subject Alternative
+            # Name (SAN) in the backend's server certificate. With a Regional Internet
+            # NEG backend, if the SNI is specified here, the load balancer uses it
+            # regardless of whether the Regional Internet NEG is specified with FQDN or
+            # IP address and port. When both sni and subjectAltNames[] are specified,
+            # the load balancer matches the backend certificate's SAN only to
+            # subjectAltNames[].
+        "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+            # verifies during a TLS handshake with the backend. When the server
+            # presents its X.509 certificate to the Load Balancer, the Load Balancer
+            # inspects the certificate's SAN field, and requires that at least one SAN
+            # match one of the subjectAltNames in the list. This field is limited to 5
+            # entries. When both sni and subjectAltNames[] are specified, the load
+            # balancer matches the backend certificate's SAN only to subjectAltNames[].
+          { # A Subject Alternative Name that the load balancer matches against the SAN
+              # field in the TLS certificate provided by the backend, specified as either
+              # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+            "dnsName": "A String", # The SAN specified as a DNS Name.
+            "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+          },
+        ],
+      },
+      "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+              # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+              # and ForwardingRule.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#usableBackendServiceList", # Output only. [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend
+      # services.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable_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, backendService, body=None, requestId=None, x__xgafv=None) + 
Patches the specified BackendService resource with the data included in the
+request. For more information, see 
+Backend services overview. This method
+supports PATCH semantics and uses the JSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setEdgeSecurityPolicy(project, backendService, body=None, requestId=None, x__xgafv=None) + 
Sets the edge security policy for the specified backend service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to which the edge security policy
+should be set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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).
+}
+
+ +
+ setSecurityPolicy(project, backendService, body=None, requestId=None, x__xgafv=None) + 
Sets the Google Cloud Armor security policy for the specified backend
+service. For more information, seeGoogle
+Cloud Armor Overview
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, backendService, body=None, requestId=None, x__xgafv=None) + 
Updates the specified BackendService resource with the data included in the
+request. For more information, seeBackend
+services overview.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendService: string, Name of the BackendService resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.crossSiteNetworks.html b/docs/dyn/compute_preview.crossSiteNetworks.html new file mode 100644 index 0000000000..e071cf7936 --- /dev/null +++ b/docs/dyn/compute_preview.crossSiteNetworks.html @@ -0,0 +1,1272 @@ + + + +

Compute Engine API . crossSiteNetworks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, crossSiteNetwork, requestId=None, x__xgafv=None)

+

Deletes the specified cross-site network in the given scope.

+

+ get(project, crossSiteNetwork, x__xgafv=None)

+

Returns the specified cross-site network in the given scope.

+

+ insert(project, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates a cross-site network in the specified project in the given scope

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the cross-site networks for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, crossSiteNetwork, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

+

Updates the specified cross-site network with the data included in

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, crossSiteNetwork, requestId=None, x__xgafv=None) + 
Deletes the specified cross-site network in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, Name of the cross-site network 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, crossSiteNetwork, x__xgafv=None) + 
Returns the specified cross-site network in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, Name of the cross-site network 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:
+
+    { # A resource that represents a cross-site network.
+    #
+    # You can use cross-site networks to connect your on-premises networks to
+    # each other through Interconnect connections.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the cross-site network.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#crossSiteNetwork", # Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.
+  "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.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+}
+
+ +
+ insert(project, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates a cross-site network in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A resource that represents a cross-site network.
+    # 
+    # You can use cross-site networks to connect your on-premises networks to
+    # each other through Interconnect connections.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the cross-site network.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#crossSiteNetwork", # Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.
+  "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.
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  validateOnly: boolean, [Input Only] Validate the new configuration, but don't create it.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the cross-site networks for a project in the given scope.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request that contains a list of cross-site networks.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of CrossSiteNetwork resources.
+    { # A resource that represents a cross-site network.
+        #
+        # You can use cross-site networks to connect your on-premises networks to
+        # each other through Interconnect connections.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of the cross-site network.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "kind": "compute#crossSiteNetwork", # Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.
+      "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.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    },
+  ],
+  "kind": "compute#crossSiteNetwork", # Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.
+  "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.
+  "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.
+
+
+ +
+ patch(project, crossSiteNetwork, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None) + 
Updates the specified cross-site network 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)
+  crossSiteNetwork: string, Name of the cross-site network to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A resource that represents a cross-site network.
+    # 
+    # You can use cross-site networks to connect your on-premises networks to
+    # each other through Interconnect connections.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the cross-site network.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#crossSiteNetwork", # Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.
+  "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.
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  validateOnly: boolean, [Input Only] Validate the new configuration, but don't update it.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.diskTypes.html b/docs/dyn/compute_preview.diskTypes.html new file mode 100644 index 0000000000..76f402f6a9 --- /dev/null +++ b/docs/dyn/compute_preview.diskTypes.html @@ -0,0 +1,626 @@ + + + +

Compute Engine API . diskTypes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of disk types.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, diskType, x__xgafv=None)

+

Returns the specified disk type.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of disk types available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of disk types.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of DiskTypesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of disk types.
+      "diskTypes": [ # [Output Only] A list of disk types contained in this scope.
+        { # Represents a Disk Type resource.
+            #
+            # Google Compute Engine has two Disk Type resources:
+            #
+            # * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)
+            # * [Zonal](/compute/docs/reference/rest/v1/diskTypes)
+            #
+            # You can choose from a variety of disk types based on your needs.
+            # For more information, readStorage options.
+            #
+            # The diskTypes resource represents disk types for a zonal
+            # persistent disk.
+            # For more information, readZonal persistent disks.
+            #
+            # The regionDiskTypes resource represents disk types for a
+            # regional persistent disk. For more information, read Regional persistent disks.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
+          "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DELETED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DEPRECATED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to OBSOLETE. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+                # The suggested replacement resource must be the same kind of resource as the
+                # deprecated resource.
+            "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+                # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+                # warning indicating the deprecated resource and recommending its
+                # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+          },
+          "description": "A String", # [Output Only] An optional description of this resource.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#diskType", # Output only. [Output Only] Type of the resource. Always compute#diskType
+              # for disk types.
+          "name": "A String", # [Output Only] Name of the resource.
+          "region": "A String", # [Output Only] URL of the region where the disk type resides. Only
+              # applicable for regional resources.
+              # 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.
+          "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size,
+              # such as "10GB-10TB".
+          "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of disk types
+          # 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#diskTypeAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList.
+  "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.
+
+ +
+ get(project, zone, diskType, x__xgafv=None) + 
Returns the specified disk type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  diskType: string, Name of the disk type 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 Disk Type resource.
+    #
+    # Google Compute Engine has two Disk Type resources:
+    #
+    # * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)
+    # * [Zonal](/compute/docs/reference/rest/v1/diskTypes)
+    #
+    # You can choose from a variety of disk types based on your needs.
+    # For more information, readStorage options.
+    #
+    # The diskTypes resource represents disk types for a zonal
+    # persistent disk.
+    # For more information, readZonal persistent disks.
+    #
+    # The regionDiskTypes resource represents disk types for a
+    # regional persistent disk. For more information, read Regional persistent disks.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional description of this resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#diskType", # Output only. [Output Only] Type of the resource. Always compute#diskType
+      # for disk types.
+  "name": "A String", # [Output Only] Name of the resource.
+  "region": "A String", # [Output Only] URL of the region where the disk type resides. Only
+      # applicable for regional resources.
+      # 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.
+  "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size,
+      # such as "10GB-10TB".
+  "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of disk types available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 disk types.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of DiskType resources.
+    { # Represents a Disk Type resource.
+        #
+        # Google Compute Engine has two Disk Type resources:
+        #
+        # * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)
+        # * [Zonal](/compute/docs/reference/rest/v1/diskTypes)
+        #
+        # You can choose from a variety of disk types based on your needs.
+        # For more information, readStorage options.
+        #
+        # The diskTypes resource represents disk types for a zonal
+        # persistent disk.
+        # For more information, readZonal persistent disks.
+        #
+        # The regionDiskTypes resource represents disk types for a
+        # regional persistent disk. For more information, read Regional persistent disks.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional description of this resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#diskType", # Output only. [Output Only] Type of the resource. Always compute#diskType
+          # for disk types.
+      "name": "A String", # [Output Only] Name of the resource.
+      "region": "A String", # [Output Only] URL of the region where the disk type resides. Only
+          # applicable for regional resources.
+          # 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.
+      "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size,
+          # such as "10GB-10TB".
+      "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#diskTypeList", # Output only. [Output Only] Type of resource. Always compute#diskTypeList
+      # for disk types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.disks.html b/docs/dyn/compute_preview.disks.html new file mode 100644 index 0000000000..2e57d691b6 --- /dev/null +++ b/docs/dyn/compute_preview.disks.html @@ -0,0 +1,9171 @@ + + + +

Compute Engine API . disks

+

Instance Methods

+

+ addResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)

+

Adds existing resource policies to a disk. You can only add one

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of persistent disks.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Bulk create a set of disks.

+

+ bulkSetLabels(project, zone, body=None, requestId=None, resource=None, x__xgafv=None)

+

Sets the labels on many disks at once. To learn more about labels, read theLabeling

+

+ close()

+

Close httplib2 connections.

+

+ createSnapshot(project, zone, disk, body=None, guestFlush=None, requestId=None, x__xgafv=None)

+

Creates a snapshot of a specified persistent disk. For regular snapshot

+

+ delete(project, zone, disk, requestId=None, x__xgafv=None)

+

Deletes the specified persistent disk. Deleting a disk removes its data

+

+ get(project, zone, disk, x__xgafv=None)

+

Returns the specified persistent disk.

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, body=None, requestId=None, sourceImage=None, x__xgafv=None)

+

Creates a persistent disk in the specified project using the data

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of persistent disks contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)

+

Removes resource policies from a disk.

+

+ resize(project, zone, disk, body=None, requestId=None, x__xgafv=None)

+

Resizes the specified persistent disk.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a disk. To learn more about labels, read theLabeling

+

+ startAsyncReplication(project, zone, disk, body=None, requestId=None, x__xgafv=None)

+

Starts asynchronous replication.

+

+ stopAsyncReplication(project, zone, disk, requestId=None, x__xgafv=None)

+

Stops asynchronous replication.

+

+ stopGroupAsyncReplication(project, zone, body=None, requestId=None, x__xgafv=None)

+

Stops asynchronous replication for a consistency group of disks.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ 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.

+

+ updateKmsKey(project, zone, disk, body=None, requestId=None, x__xgafv=None)

+

Rotates the customer-managed

+

Method Details

+
+ addResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None) + 
Adds existing resource policies to a disk. You can only add one
+policy which will be applied to this disk for scheduling snapshot
+creation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Full or relative path to the resource policy to be added to this disk. You
+      # can only specify one resource policy.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of persistent disks.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of DisksScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of disks.
+      "disks": [ # [Output Only] A list of disks contained in this scope.
+        { # Represents a Persistent Disk resource.
+            #
+            # Google Compute Engine has two Disk resources:
+            #
+            # * [Zonal](/compute/docs/reference/rest/v1/disks)
+            # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+            #
+            # Persistent disks are required for running your VM instances.
+            # Create both boot and non-boot (data) persistent disks. For more information,
+            # read Persistent Disks. For more
+            # storage options, read Storage options.
+            #
+            # The disks resource represents a zonal persistent disk.
+            # For more information, readZonal persistent disks.
+            #
+            # The regionDisks resource represents a
+            # regional persistent disk.  For more information, read
+            # Regional resources.
+          "accessMode": "A String", # The access mode of the disk.
+              #
+              #
+              #      - READ_WRITE_SINGLE: The default AccessMode, means the
+              #      disk can be attached to single instance in RW mode.
+              #      - READ_WRITE_MANY: The AccessMode means the disk can be
+              #      attached to multiple instances in RW mode.
+              #      - READ_ONLY_MANY: The AccessMode means the disk can be
+              #      attached to multiple instances in RO mode.
+              #
+              #
+              # The AccessMode is only valid for Hyperdisk disk types.
+          "architecture": "A String", # The architecture of the disk. Valid values are
+              # ARM64 or X86_64.
+          "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+            "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+                # 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/zones/zone/disks/disk
+                #    - projects/project/zones/zone/disks/disk
+                #    - zones/zone/disks/disk
+            "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+                # to or from the current disk. This value identifies the exact disk that
+                # was used to create this replication. For example, if you started
+                # replicating the persistent disk from a disk that was later deleted and
+                # recreated under the same name, the disk ID would identify the exact
+                # version of the disk that was used.
+          },
+          "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+            "a_key": {
+              "asyncReplicationDisk": {
+                "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+                    # started on the disk as a member of a group.
+                "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+                    # started on the disk as a member of a group.
+                "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+                    # 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/zones/zone/disks/disk
+                    #    - projects/project/zones/zone/disks/disk
+                    #    - zones/zone/disks/disk
+                "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+                    # to or from the current disk. This value identifies the exact disk that
+                    # was used to create this replication. For example, if you started
+                    # replicating the persistent disk from a disk that was later deleted and
+                    # recreated under the same name, the disk ID would identify the exact
+                    # version of the disk that was used.
+              },
+            },
+          },
+          "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.
+          "diskEncryptionKey": { # Encrypts the disk using a
+              # customer-supplied encryption key or a
+              # customer-managed encryption key.
+              #
+              # Encryption keys do not protect access to metadata of the disk.
+              #
+              # After you encrypt a disk with a customer-supplied key, you must provide the
+              # same key if you use the disk later. For example, to create a disk snapshot,
+              # to create a disk image, to create a machine image, or to attach the disk to
+              # a virtual machine.
+              #
+              # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+              # name once the disk is created. The disk is encrypted with this version of
+              # the key. In the response, diskEncryptionKey.kmsKeyName appears
+              # in the following format:
+              #
+              # "diskEncryptionKey.kmsKeyName":
+              # "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeysVersions/version
+              #
+              # If you do not provide an encryption key when creating the disk, then the
+              # disk is encrypted using an automatically generated key and you don't need
+              # to provide a key to use the disk later.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+              # only for bootable images. Read
+              # Enabling guest operating system features to see a list of available
+              # options.
+            { # Guest OS features.
+              "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                  # separate values. Set to one or more of the following values:
+                  #
+                  #    - VIRTIO_SCSI_MULTIQUEUE
+                  #    - WINDOWS
+                  #    - MULTI_IP_SUBNET
+                  #    - UEFI_COMPATIBLE
+                  #    - GVNIC
+                  #    - SEV_CAPABLE
+                  #    - SUSPEND_RESUME_COMPATIBLE
+                  #    - SEV_LIVE_MIGRATABLE_V2
+                  #    - SEV_SNP_CAPABLE
+                  #    - TDX_CAPABLE
+                  #    - IDPF
+                  #    - SNP_SVSM_CAPABLE
+                  #    - CCA_CAPABLE
+                  #    - SUSPEND_SAFE_FPR
+                  #
+                  #
+                  # For more information, see
+                  # Enabling guest operating system features.
+            },
+          ],
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+              # disks.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+              # essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a disk.
+          "labels": { # Labels to apply to this disk. These can be later modified by
+              # the setLabels method.
+            "a_key": "A String",
+          },
+          "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+              # text format.
+          "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+              # text format.
+          "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+            "A String",
+          ],
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+              # This field is for use by internal tools that use the public API.
+          "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.
+          "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": { # 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/{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",
+            },
+          },
+          "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+              # If not present in a request, a default value is used.
+              # The currently supported size is 4096, other sizes may be added in
+              # the future.
+              # If an unsupported value is requested, the error message will list
+              # the supported values for the caller's project.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must be
+              # greater than or equal to 1.
+          "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+              # regional resources.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+              # for regional resources.
+            "A String",
+          ],
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+            "A String",
+          ],
+          "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+            "asyncPrimaryDisk": {
+              "state": "A String",
+            },
+            "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+              "a_key": {
+                "state": "A String",
+              },
+            },
+          },
+          "satisfiesPzi": True or False, # Output only. Reserved for future use.
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+          "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+              # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+              # persistent disk.
+              #
+              # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+              # source.
+              # Acceptable values are greater than 0.
+          "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+              # that was created using a consistency group.
+          "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+              # that was created using a consistency group.
+          "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+              #
+              #      -
+              #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+              #
+              #      -
+              #        projects/project/zones/zone/disks/disk
+              #
+              #      -
+              #        projects/project/regions/region/disks/disk
+              #
+              #      -
+              #        zones/zone/disks/disk
+              #
+              #      -
+              #        regions/region/disks/disk
+          "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+              # value identifies the exact disk that was used to create this persistent
+              # disk. For example, if you created the persistent disk from a disk that
+              # was later deleted and recreated under the same name, the source disk ID
+              # would identify the exact version of the disk that was used.
+          "sourceImage": "A String", # The source image used to create this disk. If the source image is
+              # deleted, this field will not be set.
+              #
+              # To create a disk with one of the public operating system images, specify
+              # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+              # value identifies the exact image that was used to create this persistent
+              # disk. For example, if you created the persistent disk from an image that
+              # was later deleted and recreated under the same name, the source image ID
+              # would identify the exact version of the image that was used.
+          "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+              #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+              #    - zones/zone/instantSnapshots/instantSnapshot
+          "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+              # disk. This value identifies the exact instant snapshot that was used to
+              # create this persistent disk. For example, if you created the persistent
+              # disk from an instant snapshot that was later deleted and recreated under
+              # the same name, the source instant snapshot ID would identify the exact
+              # version of the instant snapshot that was used.
+          "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+              #    - projects/project/global/snapshots/snapshot
+              #      - global/snapshots/snapshot
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot. Required if the source snapshot
+              # is protected by a customer-supplied encryption key.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+              # value identifies the exact snapshot that was used to create this persistent
+              # disk. For example, if you created the persistent disk from a snapshot that
+              # was later deleted and recreated under the same name, the source snapshot ID
+              # would identify the exact version of the snapshot that was used.
+          "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+              # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+              # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+              # https://storage.googleapis.com/. This flag is not optimized for creating
+              # multiple disks from a source storage object. To create many disks from a
+              # source storage object, use gcloud compute images
+              # import instead.
+          "status": "A String", # Output only. [Output Only] The status of disk creation.
+              #
+              #
+              #      - CREATING: Disk is provisioning.
+              #      - RESTORING: Source data is being copied into the
+              #      disk.
+              #      - FAILED: Disk creation failed.
+              #      - READY: Disk is ready for use.
+              #      - DELETING: Disk is deleting.
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+          "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.
+          "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+              # in form:projects/project/zones/zone/instances/instance
+            "A String",
+          ],
+          "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of disks 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#diskAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent
+      # disks.
+  "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.
+
+
+ +
+ bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Bulk create a set of disks.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.disks.bulkInsert and
+    # compute.regionDisks.bulkInsert. It is only used to process
+    # requests and is not persisted.
+  "instantSnapshotGroupParameters": { # The parameters for the instant snapshot group.
+    "sourceInstantSnapshotGroup": "A String", # The source instant 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/zones/zone/instantSnapshotGroups/instantSnapshotGroup
+        #      - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
+        #      - zones/zone/instantSnapshotGroups/instantSnapshotGroup
+  },
+  "snapshotGroupParameters": { # The parameters for the snapshot group. The usage of snapshot group feature
+      # is restricted.
+    "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:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        regions/region/resourcePolicies/resourcePolicy
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ bulkSetLabels(project, zone, body=None, requestId=None, resource=None, x__xgafv=None) + 
Sets the labels on many disks at once. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "requests": [
+    {
+      "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+          # used to detect conflicts. The fingerprint is initially generated by Compute
+          # Engine and changes after every request to modify or update labels. You may
+          # optionally provide an up-to-date fingerprint hash in order to update or
+          # change labels. Make a get() request to the resource to get the
+          # latest fingerprint.
+      "labels": { # The labels to set for this resource.
+        "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. 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).
+  resource: string, Name or id of the resource for this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ createSnapshot(project, zone, disk, body=None, guestFlush=None, requestId=None, x__xgafv=None) + 
Creates a snapshot of a specified persistent disk. For regular snapshot
+creation, consider using snapshots.insert
+instead, as that method supports more features, such as creating snapshots
+in a project different from the source disk project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, Name of the persistent disk to snapshot. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk Snapshot resource.
+    # 
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      # 
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+  guestFlush: boolean, [Input Only] Whether to attempt an application consistent snapshot by
+informing the OS to prepare for the snapshot process.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(project, zone, disk, requestId=None, x__xgafv=None) + 
Deletes the specified persistent disk. Deleting a disk removes its data
+permanently and is irreversible. However, deleting a disk does not
+delete any snapshots
+previously made from the disk. You must separatelydelete
+snapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, Name of the persistent disk 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, disk, x__xgafv=None) + 
Returns the specified persistent disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, Name of the persistent disk 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 Persistent Disk resource.
+    #
+    # Google Compute Engine has two Disk resources:
+    #
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    #
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    #
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    #
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      #
+      #
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      #
+      #
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      #
+      # Encryption keys do not protect access to metadata of the disk.
+      #
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      #
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      #
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      #
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      #
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        zones/zone/disks/disk
+      #
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      #
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      #
+      # projects/debian-cloud/global/images/family/debian-9
+      #
+      #
+      # Alternatively, use a specific version of a public operating system image:
+      #
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      #
+      #
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      #
+      # global/images/my-custom-image
+      #
+      #
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      #
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      #
+      #
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, body=None, requestId=None, sourceImage=None, x__xgafv=None) + 
Creates a persistent disk in the specified project using the data
+in the request. You can create a disk from a source
+(sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by
+omitting all properties. You can also create a disk that is larger than
+the default size by specifying the sizeGb property.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk resource.
+    # 
+    # Google Compute Engine has two Disk resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    # 
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    # 
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    # 
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      # 
+      # 
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      # 
+      # 
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      # 
+      # Encryption keys do not protect access to metadata of the disk.
+      # 
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      # 
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      # 
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      # 
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      # 
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      # 
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      # 
+      # projects/debian-cloud/global/images/family/debian-9
+      # 
+      # 
+      # Alternatively, use a specific version of a public operating system image:
+      # 
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      # 
+      # 
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      # 
+      # global/images/my-custom-image
+      # 
+      # 
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      # 
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      # 
+      # 
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  sourceImage: string, Source image to restore onto a disk. This field is optional.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of persistent disks contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of Disk resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Disk resources.
+    { # Represents a Persistent Disk resource.
+        #
+        # Google Compute Engine has two Disk resources:
+        #
+        # * [Zonal](/compute/docs/reference/rest/v1/disks)
+        # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+        #
+        # Persistent disks are required for running your VM instances.
+        # Create both boot and non-boot (data) persistent disks. For more information,
+        # read Persistent Disks. For more
+        # storage options, read Storage options.
+        #
+        # The disks resource represents a zonal persistent disk.
+        # For more information, readZonal persistent disks.
+        #
+        # The regionDisks resource represents a
+        # regional persistent disk.  For more information, read
+        # Regional resources.
+      "accessMode": "A String", # The access mode of the disk.
+          #
+          #
+          #      - READ_WRITE_SINGLE: The default AccessMode, means the
+          #      disk can be attached to single instance in RW mode.
+          #      - READ_WRITE_MANY: The AccessMode means the disk can be
+          #      attached to multiple instances in RW mode.
+          #      - READ_ONLY_MANY: The AccessMode means the disk can be
+          #      attached to multiple instances in RO mode.
+          #
+          #
+          # The AccessMode is only valid for Hyperdisk disk types.
+      "architecture": "A String", # The architecture of the disk. Valid values are
+          # ARM64 or X86_64.
+      "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+      "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+        "a_key": {
+          "asyncReplicationDisk": {
+            "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+                # 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/zones/zone/disks/disk
+                #    - projects/project/zones/zone/disks/disk
+                #    - zones/zone/disks/disk
+            "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+                # to or from the current disk. This value identifies the exact disk that
+                # was used to create this replication. For example, if you started
+                # replicating the persistent disk from a disk that was later deleted and
+                # recreated under the same name, the disk ID would identify the exact
+                # version of the disk that was used.
+          },
+        },
+      },
+      "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.
+      "diskEncryptionKey": { # Encrypts the disk using a
+          # customer-supplied encryption key or a
+          # customer-managed encryption key.
+          #
+          # Encryption keys do not protect access to metadata of the disk.
+          #
+          # After you encrypt a disk with a customer-supplied key, you must provide the
+          # same key if you use the disk later. For example, to create a disk snapshot,
+          # to create a disk image, to create a machine image, or to attach the disk to
+          # a virtual machine.
+          #
+          # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+          # name once the disk is created. The disk is encrypted with this version of
+          # the key. In the response, diskEncryptionKey.kmsKeyName appears
+          # in the following format:
+          #
+          # "diskEncryptionKey.kmsKeyName":
+          # "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeysVersions/version
+          #
+          # If you do not provide an encryption key when creating the disk, then the
+          # disk is encrypted using an automatically generated key and you don't need
+          # to provide a key to use the disk later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+          # disks.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a disk.
+      "labels": { # Labels to apply to this disk. These can be later modified by
+          # the setLabels method.
+        "a_key": "A String",
+      },
+      "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+          # text format.
+      "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+          # text format.
+      "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+        "A String",
+      ],
+      "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+        "A String",
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+          # This field is for use by internal tools that use the public API.
+      "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.
+      "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": { # 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/{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",
+        },
+      },
+      "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+          # If not present in a request, a default value is used.
+          # The currently supported size is 4096, other sizes may be added in
+          # the future.
+          # If an unsupported value is requested, the error message will list
+          # the supported values for the caller's project.
+      "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+          # of I/O operations per second that the disk can handle. Values must be
+          # between 10,000 and 120,000. For more details, see theExtreme persistent
+          # disk documentation.
+      "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+          # number of throughput mb per second that the disk can handle. Values must be
+          # greater than or equal to 1.
+      "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+          # regional resources.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+          # for regional resources.
+        "A String",
+      ],
+      "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+        "A String",
+      ],
+      "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+        "asyncPrimaryDisk": {
+          "state": "A String",
+        },
+        "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+          "a_key": {
+            "state": "A String",
+          },
+        },
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+          # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+          # persistent disk.
+          #
+          # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+          # source.
+          # Acceptable values are greater than 0.
+      "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+          # that was created using a consistency group.
+      "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+          # that was created using a consistency group.
+      "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        zones/zone/disks/disk
+          #
+          #      -
+          #        regions/region/disks/disk
+      "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+          # value identifies the exact disk that was used to create this persistent
+          # disk. For example, if you created the persistent disk from a disk that
+          # was later deleted and recreated under the same name, the source disk ID
+          # would identify the exact version of the disk that was used.
+      "sourceImage": "A String", # The source image used to create this disk. If the source image is
+          # deleted, this field will not be set.
+          #
+          # To create a disk with one of the public operating system images, specify
+          # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+          #
+          # projects/debian-cloud/global/images/family/debian-9
+          #
+          #
+          # Alternatively, use a specific version of a public operating system image:
+          #
+          # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+          #
+          #
+          # To create a disk with a custom image that you created, specify the
+          # image name in the following format:
+          #
+          # global/images/my-custom-image
+          #
+          #
+          # You can also specify a custom image by its image family, which returns
+          # the latest version of the image in that family. Replace the image name
+          # with family/family-name:
+          #
+          # global/images/family/my-image-family
+      "sourceImageEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source image. Required if the source image is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+          # value identifies the exact image that was used to create this persistent
+          # disk. For example, if you created the persistent disk from an image that
+          # was later deleted and recreated under the same name, the source image ID
+          # would identify the exact version of the image that was used.
+      "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+          #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+          #    - zones/zone/instantSnapshots/instantSnapshot
+      "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+          # disk. This value identifies the exact instant snapshot that was used to
+          # create this persistent disk. For example, if you created the persistent
+          # disk from an instant snapshot that was later deleted and recreated under
+          # the same name, the source instant snapshot ID would identify the exact
+          # version of the instant snapshot that was used.
+      "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+          #    - projects/project/global/snapshots/snapshot
+          #      - global/snapshots/snapshot
+      "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source snapshot. Required if the source snapshot
+          # is protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+          # value identifies the exact snapshot that was used to create this persistent
+          # disk. For example, if you created the persistent disk from a snapshot that
+          # was later deleted and recreated under the same name, the source snapshot ID
+          # would identify the exact version of the snapshot that was used.
+      "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+          # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+          # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+          # https://storage.googleapis.com/. This flag is not optimized for creating
+          # multiple disks from a source storage object. To create many disks from a
+          # source storage object, use gcloud compute images
+          # import instead.
+      "status": "A String", # Output only. [Output Only] The status of disk creation.
+          #
+          #
+          #      - CREATING: Disk is provisioning.
+          #      - RESTORING: Source data is being copied into the
+          #      disk.
+          #      - FAILED: Disk creation failed.
+          #      - READY: Disk is ready for use.
+          #      - DELETING: Disk is deleting.
+      "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+          #      - projects/project/zones/zone/storagePools/storagePool
+          #    - zones/zone/storagePools/storagePool
+      "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.
+      "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+          # in form:projects/project/zones/zone/instances/instance
+        "A String",
+      ],
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#diskList", # Output only. [Output Only] Type of resource. Always compute#diskList for
+      # lists of disks.
+  "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.
+  "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.
+
+
+ +
+ removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None) + 
Removes resource policies from a disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Resource policies to be removed from this disk.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resize(project, zone, disk, body=None, requestId=None, x__xgafv=None) + 
Resizes the specified persistent disk.
+You can only increase the size of the disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The name of the persistent disk. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sizeGb": "A String", # The new size of the persistent disk, which is specified in GB.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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).
+}
+
+ +
+ setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a disk. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ startAsyncReplication(project, zone, disk, body=None, requestId=None, x__xgafv=None) + 
Starts asynchronous replication.
+Must be invoked on the primary disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The name of the persistent disk. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "asyncSecondaryDisk": "A String", # The secondary disk to start asynchronous replication to.
+      # 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopAsyncReplication(project, zone, disk, requestId=None, x__xgafv=None) + 
Stops asynchronous replication.
+Can be invoked either on the primary or on the secondary disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The name of the persistent disk. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopGroupAsyncReplication(project, zone, body=None, requestId=None, x__xgafv=None) + 
Stops asynchronous replication for a consistency group of disks.
+Can be invoked either in the primary or secondary scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. This must be the zone of the primary
+or secondary disks in the consistency group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.disks.stopGroupAsyncReplication and
+    # compute.regionDisks.stopGroupAsyncReplication. It is only used to process
+    # requests and is not persisted.
+  "resourcePolicy": "A String", # The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.
+      # This may be a full or partial URL, such as:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        regions/region/resourcePolicies/resourcePolicy
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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, 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.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk resource.
+    # 
+    # Google Compute Engine has two Disk resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    # 
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    # 
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    # 
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      # 
+      # 
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      # 
+      # 
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      # 
+      # Encryption keys do not protect access to metadata of the disk.
+      # 
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      # 
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      # 
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      # 
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      # 
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      # 
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      # 
+      # projects/debian-cloud/global/images/family/debian-9
+      # 
+      # 
+      # Alternatively, use a specific version of a public operating system image:
+      # 
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      # 
+      # 
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      # 
+      # global/images/my-custom-image
+      # 
+      # 
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      # 
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      # 
+      # 
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  paths: string, A parameter (repeated)
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateKmsKey(project, zone, disk, body=None, requestId=None, x__xgafv=None) + 
Rotates the customer-managed
+encryption key to the latest version for the specified persistent disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  disk: string, Name of the Disk resource, should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "kmsKeyName": "A String", # Optional. The new KMS key to replace the current one on the disk. If empty, the disk
+      # will be re-encrypted using the primary version of the disk's current KMS
+      # key.
+      # 
+      # The KMS key can be provided in the following formats:
+      # 
+      # 
+      #      - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key
+      # 
+      # 
+      # Where project is the project ID or
+      # project number.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.externalVpnGateways.html b/docs/dyn/compute_preview.externalVpnGateways.html new file mode 100644 index 0000000000..49b2cc7243 --- /dev/null +++ b/docs/dyn/compute_preview.externalVpnGateways.html @@ -0,0 +1,1482 @@ + + + +

Compute Engine API . externalVpnGateways

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, externalVpnGateway, requestId=None, x__xgafv=None)

+

Deletes the specified externalVpnGateway.

+

+ get(project, externalVpnGateway, x__xgafv=None)

+

Returns the specified externalVpnGateway. Get a list of available

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a ExternalVpnGateway in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of ExternalVpnGateway available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on an ExternalVpnGateway. To learn more about labels,

+

+ 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, externalVpnGateway, requestId=None, x__xgafv=None) + 
Deletes the specified externalVpnGateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  externalVpnGateway: string, Name of the externalVpnGateways 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, externalVpnGateway, x__xgafv=None) + 
Returns the specified externalVpnGateway. Get a list of available
+externalVpnGateways by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  externalVpnGateway: string, Name of the externalVpnGateway 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 an external VPN gateway.
+    #
+    # External VPN gateway is the on-premises VPN gateway(s) or another cloud
+    # provider's VPN gateway that connects to your Google Cloud VPN gateway.
+    #
+    # To create a highly available VPN from Google Cloud Platform to your
+    # VPN gateway or another cloud provider's VPN gateway, you must create a
+    # external VPN gateway resource with information about the other gateway.
+    #
+    # For more information about using external VPN gateways, see
+    # Creating an HA VPN gateway and tunnel pair to a peer VPN.
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interfaces": [ # A list of interfaces for this external VPN gateway.
+      #
+      # If your peer-side gateway is an on-premises gateway and non-AWS cloud
+      # providers' gateway, at most two interfaces can be provided for an external
+      # VPN gateway. If your peer side is an AWS virtual private gateway, four
+      # interfaces should be provided for an external VPN gateway.
+    { # The interface for the external VPN gateway.
+      "id": 42, # The numeric ID of this interface.
+          # The allowed input values for this id for different redundancy types of
+          # external VPN gateway:
+          #
+          #    - SINGLE_IP_INTERNALLY_REDUNDANT - 0
+          #    - TWO_IPS_REDUNDANCY - 0, 1
+          #    - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3
+      "ipAddress": "A String", # IP address of the interface in the external VPN gateway. Only IPv4 is
+          # supported. This IP address can be either from your on-premise gateway or
+          # another Cloud provider's VPN gateway, it cannot be an IP address from
+          # Google Compute Engine.
+      "ipv6Address": "A String", # IPv6 address of the interface in the external VPN gateway. This IPv6
+          # address can be either from your on-premise gateway or another Cloud
+          # provider's VPN gateway, it cannot be an IP address from Google Compute
+          # Engine. Must specify an IPv6 address (not IPV4-mapped) using any format
+          # described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format
+          # is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+    },
+  ],
+  "kind": "compute#externalVpnGateway", # Output only. [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this ExternalVpnGateway,
+      # which is essentially a hash of the labels set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an ExternalVpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a ExternalVpnGateway 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 an external VPN gateway.
+    # 
+    # External VPN gateway is the on-premises VPN gateway(s) or another cloud
+    # provider's VPN gateway that connects to your Google Cloud VPN gateway.
+    # 
+    # To create a highly available VPN from Google Cloud Platform to your
+    # VPN gateway or another cloud provider's VPN gateway, you must create a
+    # external VPN gateway resource with information about the other gateway.
+    # 
+    # For more information about using external VPN gateways, see
+    # Creating an HA VPN gateway and tunnel pair to a peer VPN.
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interfaces": [ # A list of interfaces for this external VPN gateway.
+      # 
+      # If your peer-side gateway is an on-premises gateway and non-AWS cloud
+      # providers' gateway, at most two interfaces can be provided for an external
+      # VPN gateway. If your peer side is an AWS virtual private gateway, four
+      # interfaces should be provided for an external VPN gateway.
+    { # The interface for the external VPN gateway.
+      "id": 42, # The numeric ID of this interface.
+          # The allowed input values for this id for different redundancy types of
+          # external VPN gateway:
+          #
+          #    - SINGLE_IP_INTERNALLY_REDUNDANT - 0
+          #    - TWO_IPS_REDUNDANCY - 0, 1
+          #    - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3
+      "ipAddress": "A String", # IP address of the interface in the external VPN gateway. Only IPv4 is
+          # supported. This IP address can be either from your on-premise gateway or
+          # another Cloud provider's VPN gateway, it cannot be an IP address from
+          # Google Compute Engine.
+      "ipv6Address": "A String", # IPv6 address of the interface in the external VPN gateway. This IPv6
+          # address can be either from your on-premise gateway or another Cloud
+          # provider's VPN gateway, it cannot be an IP address from Google Compute
+          # Engine. Must specify an IPv6 address (not IPV4-mapped) using any format
+          # described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format
+          # is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+    },
+  ],
+  "kind": "compute#externalVpnGateway", # Output only. [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this ExternalVpnGateway,
+      # which is essentially a hash of the labels set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an ExternalVpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of ExternalVpnGateway available to 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request, and contains a list of externalVpnGateways.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of ExternalVpnGateway resources.
+    { # Represents an external VPN gateway.
+        #
+        # External VPN gateway is the on-premises VPN gateway(s) or another cloud
+        # provider's VPN gateway that connects to your Google Cloud VPN gateway.
+        #
+        # To create a highly available VPN from Google Cloud Platform to your
+        # VPN gateway or another cloud provider's VPN gateway, you must create a
+        # external VPN gateway resource with information about the other gateway.
+        #
+        # For more information about using external VPN gateways, see
+        # Creating an HA VPN gateway and tunnel pair to a peer VPN.
+      "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.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "interfaces": [ # A list of interfaces for this external VPN gateway.
+          #
+          # If your peer-side gateway is an on-premises gateway and non-AWS cloud
+          # providers' gateway, at most two interfaces can be provided for an external
+          # VPN gateway. If your peer side is an AWS virtual private gateway, four
+          # interfaces should be provided for an external VPN gateway.
+        { # The interface for the external VPN gateway.
+          "id": 42, # The numeric ID of this interface.
+              # The allowed input values for this id for different redundancy types of
+              # external VPN gateway:
+              #
+              #    - SINGLE_IP_INTERNALLY_REDUNDANT - 0
+              #    - TWO_IPS_REDUNDANCY - 0, 1
+              #    - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3
+          "ipAddress": "A String", # IP address of the interface in the external VPN gateway. Only IPv4 is
+              # supported. This IP address can be either from your on-premise gateway or
+              # another Cloud provider's VPN gateway, it cannot be an IP address from
+              # Google Compute Engine.
+          "ipv6Address": "A String", # IPv6 address of the interface in the external VPN gateway. This IPv6
+              # address can be either from your on-premise gateway or another Cloud
+              # provider's VPN gateway, it cannot be an IP address from Google Compute
+              # Engine. Must specify an IPv6 address (not IPV4-mapped) using any format
+              # described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format
+              # is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+        },
+      ],
+      "kind": "compute#externalVpnGateway", # Output only. [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this ExternalVpnGateway,
+          # which is essentially a hash of the labels set used for optimistic locking.
+          # The fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an ExternalVpnGateway.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "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.
+    },
+  ],
+  "kind": "compute#externalVpnGatewayList", # Output only. [Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways.
+  "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.
+  "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.
+
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on an ExternalVpnGateway. To learn more about labels,
+read the Labeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.firewallPolicies.html b/docs/dyn/compute_preview.firewallPolicies.html new file mode 100644 index 0000000000..1c43f1cd7e --- /dev/null +++ b/docs/dyn/compute_preview.firewallPolicies.html @@ -0,0 +1,7094 @@ + + + +

Compute Engine API . firewallPolicies

+

Instance Methods

+

+ addAssociation(firewallPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None)

+

Inserts an association for the specified firewall policy.

+

+ addRule(firewallPolicy, body=None, requestId=None, x__xgafv=None)

+

Inserts a rule into a firewall policy.

+

+ cloneRules(firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

+

Copies rules to the specified firewall policy.

+

+ close()

+

Close httplib2 connections.

+

+ delete(firewallPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified policy.

+

+ get(firewallPolicy, x__xgafv=None)

+

Returns the specified firewall policy.

+

+ getAssociation(firewallPolicy, name=None, x__xgafv=None)

+

Gets an association with the specified name.

+

+ getIamPolicy(resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getRule(firewallPolicy, priority=None, x__xgafv=None)

+

Gets a rule of the specified priority.

+

+ insert(body=None, parentId=None, requestId=None, x__xgafv=None)

+

Creates a new policy in the specified project using the data included in

+

+ list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None)

+

Lists all the policies that have been configured for the specified

+

+ listAssociations(includeInheritedPolicies=None, targetResource=None, x__xgafv=None)

+

Lists associations of a specified target, i.e., organization or folder.

+

+ list_next()

+

Retrieves the next page of results.

+

+ move(firewallPolicy, parentId=None, requestId=None, x__xgafv=None)

+

Moves the specified firewall policy.

+

+ patch(firewallPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request.

+

+ patchRule(firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None)

+

Patches a rule of the specified priority.

+

+ removeAssociation(firewallPolicy, name=None, requestId=None, x__xgafv=None)

+

Removes an association for the specified firewall policy.

+

+ removeRule(firewallPolicy, priority=None, requestId=None, x__xgafv=None)

+

Deletes a rule of the specified priority.

+

+ setIamPolicy(resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ addAssociation(firewallPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None) + 
Inserts an association for the specified firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+  replaceExistingAssociation: boolean, Indicates whether or not to replace it if an association of the attachment
+already exists. This is false by default, in which case an error will be
+returned if an association already exists.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addRule(firewallPolicy, body=None, requestId=None, x__xgafv=None) + 
Inserts a rule into a firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ cloneRules(firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None) + 
Copies rules to the specified firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (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).
+  sourceFirewallPolicy: string, The firewall policy from which to copy rules.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(firewallPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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(firewallPolicy, x__xgafv=None) + 
Returns the specified firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to get. (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 Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      #
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+ +
+ getAssociation(firewallPolicy, name=None, x__xgafv=None) + 
Gets an association with the specified name.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to which the queried rule belongs. (required)
+  name: string, The name of the association to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+ +
+ getIamPolicy(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:
+  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).
+}
+
+ +
+ getRule(firewallPolicy, priority=None, x__xgafv=None) + 
Gets a rule of the specified priority.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      #
+      #
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+ +
+ insert(body=None, parentId=None, requestId=None, x__xgafv=None) + 
Creates a new policy in the specified project using the data included in
+the request.
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  parentId: string, Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]"
+if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the
+parent is an organization.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None) + 
Lists all the policies that have been configured for the specified
+folder or organization.
+
+Args:
+  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.
+  parentId: string, Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]"
+if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the
+parent is an organization.
+  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 FirewallPolicy resources.
+    { # Represents a Firewall Policy resource.
+      "associations": [ # A list of associations that belong to this firewall policy.
+        {
+          "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+          "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+              # of the firewall policy of the association.
+          "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+          "name": "A String", # The name for an association.
+          "priority": 42, # An integer indicating the priority of an association. The priority
+              # must be a positive value between 1 and 2147483647.
+              # Firewall Policies are evaluated from highest to lowest priority where 1
+              # is the highest priority and 2147483647 is the lowest priority.
+              # The default value is `1000`. If two associations have the same priority
+              # then lexicographical order on association names is applied.
+          "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+        },
+      ],
+      "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.
+      "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+          # Organization firewall policy. The name should be unique in the organization
+          # in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed.
+          # The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # firewall policy.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+      "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+          # [Output Only] numeric ID allocated by Google Cloud which uniquely
+          # identifies the Organization Firewall Policy.
+      "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+          # This field is not applicable to network firewall policies.
+      "policyType": "A String", # The type of the firewall policy. This field can be one of
+          # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+          #
+          # Note: if not specified then VPC_POLICY will be used.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+          # This field is not applicable to global firewall policies.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+          # policy can not exceed a set number of tuples.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule (rule with priority 2147483647 and
+          # match "*"). If no rules are provided when creating a firewall policy, a
+          # default rule with action "allow" will be added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+          # unique in the organization in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed. The name must be
+          # 1-63 characters long, and comply with RFC1035.
+          # 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.
+    },
+  ],
+  "kind": "compute#firewallPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies
+  "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.
+  "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.
+  },
+}
+
+ +
+ listAssociations(includeInheritedPolicies=None, targetResource=None, x__xgafv=None) + 
Lists associations of a specified target, i.e., organization or folder.
+
+Args:
+  includeInheritedPolicies: boolean, If set to "true", the response will contain a list of all associations for
+the containing folders and the containing organization of the target. The
+parameter has no effect if the target is an organization.
+  targetResource: string, The target resource to list associations. It is an organization, or a
+folder.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "associations": [ # A list of associations.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "kind": "compute#firewallPoliciesListAssociationsResponse", # Output only. [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of
+      # firewallPolicy associations.
+}
+
+ +
+ 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.
+
+
+ +
+ move(firewallPolicy, parentId=None, requestId=None, x__xgafv=None) + 
Moves the specified firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  parentId: string, The new parent of the firewall policy. The ID can be either be
+"folders/[FOLDER_ID]" if the parent is a folder or
+"organizations/[ORGANIZATION_ID]" if the parent is an organization.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patch(firewallPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None) + 
Patches a rule of the specified priority.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  priority: integer, The priority of the rule to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeAssociation(firewallPolicy, name=None, requestId=None, x__xgafv=None) + 
Removes an association for the specified firewall policy.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  name: string, Name for the attachment that will be removed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(firewallPolicy, priority=None, requestId=None, x__xgafv=None) + 
Deletes a rule of the specified priority.
+
+Args:
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  priority: integer, The priority of the rule to remove from the firewall policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(resource, body=None, x__xgafv=None) + 
Sets the access control policy on the specified resource.
+Replaces any existing policy.
+
+Args:
+  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(resource, body=None, x__xgafv=None) + 
Returns permissions that a caller has on the specified resource.
+
+Args:
+  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_preview.firewalls.html b/docs/dyn/compute_preview.firewalls.html new file mode 100644 index 0000000000..89dc065832 --- /dev/null +++ b/docs/dyn/compute_preview.firewalls.html @@ -0,0 +1,2356 @@ + + + +

Compute Engine API . firewalls

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, firewall, requestId=None, x__xgafv=None)

+

Deletes the specified firewall.

+

+ get(project, firewall, x__xgafv=None)

+

Returns the specified firewall.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a firewall rule in the specified project using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of firewall rules available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, firewall, body=None, requestId=None, x__xgafv=None)

+

Updates the specified firewall rule with the data included in the

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, firewall, body=None, requestId=None, x__xgafv=None)

+

Updates the specified firewall rule with the data included in the

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, firewall, requestId=None, x__xgafv=None) + 
Deletes the specified firewall.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewall: string, Name of the firewall rule 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, firewall, x__xgafv=None) + 
Returns the specified firewall.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewall: string, Name of the firewall rule 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 Firewall Rule resource.
+    #
+    # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+    # instances. For more information, readFirewall rules.
+  "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a permitted connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          #
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a denied connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          #
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+      # traffic that has destination IP address in these ranges. These ranges must
+      # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+      # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+      # specify the sourceTags fields.
+  "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+      # firewall rule is not enforced and the network behaves as if it did not
+      # exist. If this is unspecified, the firewall rule will be enabled.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+      # for firewall rules.
+  "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+      # logging is enabled, logs will be exported to Cloud Logging.
+    "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+        # rule.
+    "metadata": "A String", # This field can only be specified for a particular firewall rule if
+        # logging is enabled for that rule. This field denotes whether to include
+        # or exclude metadata for firewall logs.
+  },
+  "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # URL of the network resource for this firewall rule. If not
+      # specified when creating a firewall rule, the default network
+      # is used:
+      #
+      # global/networks/default
+      #
+      # If you choose to specify this field, you can specify the network as a full
+      # or partial URL. For example, the following are all valid URLs:
+      #
+      #    -
+      #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+      #    - projects/myproject/global/networks/my-network
+      #    - global/networks/default
+  "params": { # Additional firewall 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # Priority for this rule.
+      # This is an integer between `0` and `65535`, both inclusive.
+      # The default value is `1000`.
+      # Relative priorities determine which rule takes effect if multiple rules
+      # apply. Lower values indicate higher priority. For example, a rule with
+      # priority `0` has higher precedence than a rule with priority `1`.
+      # DENY rules take precedence over ALLOW rules if they have equal priority.
+      # Note that VPC networks have implied
+      # rules with a priority of `65535`. To avoid conflicts with the implied
+      # rules, use a priority number less than `65535`.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+      # that has a source IP address in these ranges. These ranges must be
+      # expressed inCIDR format. One or both of sourceRanges
+      # and sourceTags may be set.
+      # If both fields are set, the rule applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP
+      # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+      # both fields for the rule to
+      # apply. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+      # traffic originating from an instance with a service account in this list.
+      # Source service accounts cannot be used to control traffic to an instance's
+      # external IP address because service accounts are associated with an
+      # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+      # If both are set, the firewall applies to traffic that
+      # has a source IP address within the sourceRanges OR a source
+      # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+      # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+    "A String",
+  ],
+  "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+      # with source IPs that match the primary network interfaces of VM instances
+      # that have the tag and are in the same VPC network.
+      # Source tags cannot be used to control traffic to an instance's external IP
+      # address, it only applies to traffic between instances in the same virtual
+      # network. Because tags are associated with instances, not IP addresses.
+      # One or both of sourceRanges and sourceTags may be
+      # set. If both fields are set, the firewall applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP from a
+      # resource with a matching tag listed in the sourceTags
+      # field. The connection does not need to match both fields for the
+      # firewall to apply.
+    "A String",
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+      # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+      # If neither targetServiceAccounts nor targetTags
+      # are specified, the firewall rule applies to all instances on the specified
+      # network.
+    "A String",
+  ],
+  "targetTags": [ # A list of tags that controls which instances the firewall rule
+      # applies to. If targetTags are specified, then the firewall
+      # rule applies only to instances in the VPC network that have one of those
+      # tags. If no targetTags are specified, the firewall rule
+      # applies to all instances on the specified network.
+    "A String",
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a firewall rule 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 Firewall Rule resource.
+    # 
+    # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+    # instances. For more information, readFirewall rules.
+  "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a permitted connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a denied connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+      # traffic that has destination IP address in these ranges. These ranges must
+      # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+      # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+      # specify the sourceTags fields.
+  "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+      # firewall rule is not enforced and the network behaves as if it did not
+      # exist. If this is unspecified, the firewall rule will be enabled.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+      # for firewall rules.
+  "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+      # logging is enabled, logs will be exported to Cloud Logging.
+    "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+        # rule.
+    "metadata": "A String", # This field can only be specified for a particular firewall rule if
+        # logging is enabled for that rule. This field denotes whether to include
+        # or exclude metadata for firewall logs.
+  },
+  "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # URL of the network resource for this firewall rule. If not
+      # specified when creating a firewall rule, the default network
+      # is used:
+      # 
+      # global/networks/default
+      # 
+      # If you choose to specify this field, you can specify the network as a full
+      # or partial URL. For example, the following are all valid URLs:
+      # 
+      #    -
+      #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+      #    - projects/myproject/global/networks/my-network
+      #    - global/networks/default
+  "params": { # Additional firewall 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # Priority for this rule.
+      # This is an integer between `0` and `65535`, both inclusive.
+      # The default value is `1000`.
+      # Relative priorities determine which rule takes effect if multiple rules
+      # apply. Lower values indicate higher priority. For example, a rule with
+      # priority `0` has higher precedence than a rule with priority `1`.
+      # DENY rules take precedence over ALLOW rules if they have equal priority.
+      # Note that VPC networks have implied
+      # rules with a priority of `65535`. To avoid conflicts with the implied
+      # rules, use a priority number less than `65535`.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+      # that has a source IP address in these ranges. These ranges must be
+      # expressed inCIDR format. One or both of sourceRanges
+      # and sourceTags may be set.
+      # If both fields are set, the rule applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP
+      # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+      # both fields for the rule to
+      # apply. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+      # traffic originating from an instance with a service account in this list.
+      # Source service accounts cannot be used to control traffic to an instance's
+      # external IP address because service accounts are associated with an
+      # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+      # If both are set, the firewall applies to traffic that
+      # has a source IP address within the sourceRanges OR a source
+      # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+      # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+    "A String",
+  ],
+  "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+      # with source IPs that match the primary network interfaces of VM instances
+      # that have the tag and are in the same VPC network.
+      # Source tags cannot be used to control traffic to an instance's external IP
+      # address, it only applies to traffic between instances in the same virtual
+      # network. Because tags are associated with instances, not IP addresses.
+      # One or both of sourceRanges and sourceTags may be
+      # set. If both fields are set, the firewall applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP from a
+      # resource with a matching tag listed in the sourceTags
+      # field. The connection does not need to match both fields for the
+      # firewall to apply.
+    "A String",
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+      # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+      # If neither targetServiceAccounts nor targetTags
+      # are specified, the firewall rule applies to all instances on the specified
+      # network.
+    "A String",
+  ],
+  "targetTags": [ # A list of tags that controls which instances the firewall rule
+      # applies to. If targetTags are specified, then the firewall
+      # rule applies only to instances in the VPC network that have one of those
+      # tags. If no targetTags are specified, the firewall rule
+      # applies to all instances on the specified network.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of firewall rules available to 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.
+  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 firewalls.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Firewall resources.
+    { # Represents a Firewall Rule resource.
+        #
+        # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+        # instances. For more information, readFirewall rules.
+      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a permitted connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a denied connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+          # traffic that has destination IP address in these ranges. These ranges must
+          # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+          # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+          # specify the sourceTags fields.
+      "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+          # firewall rule is not enforced and the network behaves as if it did not
+          # exist. If this is unspecified, the firewall rule will be enabled.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+          # for firewall rules.
+      "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+          # logging is enabled, logs will be exported to Cloud Logging.
+        "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+            # rule.
+        "metadata": "A String", # This field can only be specified for a particular firewall rule if
+            # logging is enabled for that rule. This field denotes whether to include
+            # or exclude metadata for firewall logs.
+      },
+      "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # URL of the network resource for this firewall rule. If not
+          # specified when creating a firewall rule, the default network
+          # is used:
+          #
+          # global/networks/default
+          #
+          # If you choose to specify this field, you can specify the network as a full
+          # or partial URL. For example, the following are all valid URLs:
+          #
+          #    -
+          #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+          #    - projects/myproject/global/networks/my-network
+          #    - global/networks/default
+      "params": { # Additional firewall 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "priority": 42, # Priority for this rule.
+          # This is an integer between `0` and `65535`, both inclusive.
+          # The default value is `1000`.
+          # Relative priorities determine which rule takes effect if multiple rules
+          # apply. Lower values indicate higher priority. For example, a rule with
+          # priority `0` has higher precedence than a rule with priority `1`.
+          # DENY rules take precedence over ALLOW rules if they have equal priority.
+          # Note that VPC networks have implied
+          # rules with a priority of `65535`. To avoid conflicts with the implied
+          # rules, use a priority number less than `65535`.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+          # that has a source IP address in these ranges. These ranges must be
+          # expressed inCIDR format. One or both of sourceRanges
+          # and sourceTags may be set.
+          # If both fields are set, the rule applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP
+          # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+          # both fields for the rule to
+          # apply. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+          # traffic originating from an instance with a service account in this list.
+          # Source service accounts cannot be used to control traffic to an instance's
+          # external IP address because service accounts are associated with an
+          # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+          # If both are set, the firewall applies to traffic that
+          # has a source IP address within the sourceRanges OR a source
+          # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+          # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+        "A String",
+      ],
+      "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+          # with source IPs that match the primary network interfaces of VM instances
+          # that have the tag and are in the same VPC network.
+          # Source tags cannot be used to control traffic to an instance's external IP
+          # address, it only applies to traffic between instances in the same virtual
+          # network. Because tags are associated with instances, not IP addresses.
+          # One or both of sourceRanges and sourceTags may be
+          # set. If both fields are set, the firewall applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP from a
+          # resource with a matching tag listed in the sourceTags
+          # field. The connection does not need to match both fields for the
+          # firewall to apply.
+        "A String",
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+          # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+          # If neither targetServiceAccounts nor targetTags
+          # are specified, the firewall rule applies to all instances on the specified
+          # network.
+        "A String",
+      ],
+      "targetTags": [ # A list of tags that controls which instances the firewall rule
+          # applies to. If targetTags are specified, then the firewall
+          # rule applies only to instances in the VPC network that have one of those
+          # tags. If no targetTags are specified, the firewall rule
+          # applies to all instances on the specified network.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#firewallList", # Output only. [Output Only] Type of resource. Always compute#firewallList
+      # for lists of firewalls.
+  "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.
+  "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, firewall, body=None, requestId=None, x__xgafv=None) + 
Updates the specified firewall rule 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)
+  firewall: string, Name of the firewall rule to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Rule resource.
+    # 
+    # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+    # instances. For more information, readFirewall rules.
+  "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a permitted connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a denied connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+      # traffic that has destination IP address in these ranges. These ranges must
+      # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+      # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+      # specify the sourceTags fields.
+  "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+      # firewall rule is not enforced and the network behaves as if it did not
+      # exist. If this is unspecified, the firewall rule will be enabled.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+      # for firewall rules.
+  "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+      # logging is enabled, logs will be exported to Cloud Logging.
+    "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+        # rule.
+    "metadata": "A String", # This field can only be specified for a particular firewall rule if
+        # logging is enabled for that rule. This field denotes whether to include
+        # or exclude metadata for firewall logs.
+  },
+  "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # URL of the network resource for this firewall rule. If not
+      # specified when creating a firewall rule, the default network
+      # is used:
+      # 
+      # global/networks/default
+      # 
+      # If you choose to specify this field, you can specify the network as a full
+      # or partial URL. For example, the following are all valid URLs:
+      # 
+      #    -
+      #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+      #    - projects/myproject/global/networks/my-network
+      #    - global/networks/default
+  "params": { # Additional firewall 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # Priority for this rule.
+      # This is an integer between `0` and `65535`, both inclusive.
+      # The default value is `1000`.
+      # Relative priorities determine which rule takes effect if multiple rules
+      # apply. Lower values indicate higher priority. For example, a rule with
+      # priority `0` has higher precedence than a rule with priority `1`.
+      # DENY rules take precedence over ALLOW rules if they have equal priority.
+      # Note that VPC networks have implied
+      # rules with a priority of `65535`. To avoid conflicts with the implied
+      # rules, use a priority number less than `65535`.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+      # that has a source IP address in these ranges. These ranges must be
+      # expressed inCIDR format. One or both of sourceRanges
+      # and sourceTags may be set.
+      # If both fields are set, the rule applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP
+      # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+      # both fields for the rule to
+      # apply. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+      # traffic originating from an instance with a service account in this list.
+      # Source service accounts cannot be used to control traffic to an instance's
+      # external IP address because service accounts are associated with an
+      # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+      # If both are set, the firewall applies to traffic that
+      # has a source IP address within the sourceRanges OR a source
+      # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+      # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+    "A String",
+  ],
+  "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+      # with source IPs that match the primary network interfaces of VM instances
+      # that have the tag and are in the same VPC network.
+      # Source tags cannot be used to control traffic to an instance's external IP
+      # address, it only applies to traffic between instances in the same virtual
+      # network. Because tags are associated with instances, not IP addresses.
+      # One or both of sourceRanges and sourceTags may be
+      # set. If both fields are set, the firewall applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP from a
+      # resource with a matching tag listed in the sourceTags
+      # field. The connection does not need to match both fields for the
+      # firewall to apply.
+    "A String",
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+      # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+      # If neither targetServiceAccounts nor targetTags
+      # are specified, the firewall rule applies to all instances on the specified
+      # network.
+    "A String",
+  ],
+  "targetTags": [ # A list of tags that controls which instances the firewall rule
+      # applies to. If targetTags are specified, then the firewall
+      # rule applies only to instances in the VPC network that have one of those
+      # tags. If no targetTags are specified, the firewall rule
+      # applies to all instances on the specified network.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, firewall, body=None, requestId=None, x__xgafv=None) + 
Updates the specified firewall rule with the data included in the
+request.
+Note that all fields will be updated if using PUT, even fields that are not
+specified. To update individual fields, please use PATCH instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewall: string, Name of the firewall rule to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Rule resource.
+    # 
+    # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+    # instances. For more information, readFirewall rules.
+  "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a permitted connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+      # protocol and port-range tuple that describes a denied connection.
+    {
+      "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+          # required when creating a firewall rule. This value can either be one of the
+          # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+      "ports": [ # An optional list of ports to which this rule applies.
+          # This field is only applicable for the UDP or TCP protocol.
+          # Each entry must be either an integer or a range.
+          # If not specified, this rule applies to connections through any port.
+          # 
+          # Example inputs include: ["22"], ["80","443"],
+          # and ["12345-12349"].
+        "A String",
+      ],
+    },
+  ],
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+      # traffic that has destination IP address in these ranges. These ranges must
+      # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+      # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+      # specify the sourceTags fields.
+  "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+      # firewall rule is not enforced and the network behaves as if it did not
+      # exist. If this is unspecified, the firewall rule will be enabled.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+      # for firewall rules.
+  "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+      # logging is enabled, logs will be exported to Cloud Logging.
+    "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+        # rule.
+    "metadata": "A String", # This field can only be specified for a particular firewall rule if
+        # logging is enabled for that rule. This field denotes whether to include
+        # or exclude metadata for firewall logs.
+  },
+  "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # URL of the network resource for this firewall rule. If not
+      # specified when creating a firewall rule, the default network
+      # is used:
+      # 
+      # global/networks/default
+      # 
+      # If you choose to specify this field, you can specify the network as a full
+      # or partial URL. For example, the following are all valid URLs:
+      # 
+      #    -
+      #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+      #    - projects/myproject/global/networks/my-network
+      #    - global/networks/default
+  "params": { # Additional firewall 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # Priority for this rule.
+      # This is an integer between `0` and `65535`, both inclusive.
+      # The default value is `1000`.
+      # Relative priorities determine which rule takes effect if multiple rules
+      # apply. Lower values indicate higher priority. For example, a rule with
+      # priority `0` has higher precedence than a rule with priority `1`.
+      # DENY rules take precedence over ALLOW rules if they have equal priority.
+      # Note that VPC networks have implied
+      # rules with a priority of `65535`. To avoid conflicts with the implied
+      # rules, use a priority number less than `65535`.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+      # that has a source IP address in these ranges. These ranges must be
+      # expressed inCIDR format. One or both of sourceRanges
+      # and sourceTags may be set.
+      # If both fields are set, the rule applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP
+      # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+      # both fields for the rule to
+      # apply. Both IPv4 and IPv6 are supported.
+    "A String",
+  ],
+  "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+      # traffic originating from an instance with a service account in this list.
+      # Source service accounts cannot be used to control traffic to an instance's
+      # external IP address because service accounts are associated with an
+      # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+      # If both are set, the firewall applies to traffic that
+      # has a source IP address within the sourceRanges OR a source
+      # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+      # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+    "A String",
+  ],
+  "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+      # with source IPs that match the primary network interfaces of VM instances
+      # that have the tag and are in the same VPC network.
+      # Source tags cannot be used to control traffic to an instance's external IP
+      # address, it only applies to traffic between instances in the same virtual
+      # network. Because tags are associated with instances, not IP addresses.
+      # One or both of sourceRanges and sourceTags may be
+      # set. If both fields are set, the firewall applies to traffic that has a
+      # source IP address within sourceRanges OR a source IP from a
+      # resource with a matching tag listed in the sourceTags
+      # field. The connection does not need to match both fields for the
+      # firewall to apply.
+    "A String",
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+      # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+      # If neither targetServiceAccounts nor targetTags
+      # are specified, the firewall rule applies to all instances on the specified
+      # network.
+    "A String",
+  ],
+  "targetTags": [ # A list of tags that controls which instances the firewall rule
+      # applies to. If targetTags are specified, then the firewall
+      # rule applies only to instances in the VPC network that have one of those
+      # tags. If no targetTags are specified, the firewall rule
+      # applies to all instances on the specified network.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.forwardingRules.html b/docs/dyn/compute_preview.forwardingRules.html new file mode 100644 index 0000000000..9d071bb267 --- /dev/null +++ b/docs/dyn/compute_preview.forwardingRules.html @@ -0,0 +1,4160 @@ + + + +

Compute Engine API . forwardingRules

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of forwarding rules.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, forwardingRule, requestId=None, x__xgafv=None)

+

Deletes the specified ForwardingRule resource.

+

+ get(project, region, forwardingRule, view=None, x__xgafv=None)

+

Returns the specified ForwardingRule resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a ForwardingRule resource in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of ForwardingRule resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None)

+

Updates the specified forwarding rule with the data included in the

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on the specified resource. To learn more about labels,

+

+ setTarget(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None)

+

Changes target URL for forwarding rule. The new target should be of the

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of forwarding rules.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of ForwardingRulesScopedList resources.
+    "a_key": { # Name of the scope containing this set of addresses.
+      "forwardingRules": [ # A list of forwarding rules contained in this scope.
+        { # Represents a Forwarding Rule resource.
+            #
+            # Forwarding rule resources in Google Cloud can be either regional or global in
+            # scope:
+            #
+            # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+            # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+            #
+            # A forwarding rule and its corresponding IP address represent the frontend
+            # configuration of a Google Cloud load balancer.
+            # Forwarding rules can also reference target instances and Cloud VPN Classic
+            # gateways (targetVpnGateway).
+            #
+            # For more information, read
+            # Forwarding rule concepts and
+            # Using protocol forwarding.
+          "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+              # sends traffic to this IP address, the forwarding rule directs the traffic
+              # to the referenced target or backendService.
+              # While creating a forwarding rule, specifying an IPAddress is
+              # required under the following circumstances:
+              #
+              #
+              #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+              #    - When the target is a Private Service Connect Google APIs
+              #    bundle, you must specify an IPAddress.
+              #
+              #
+              # Otherwise, you can optionally specify an IP address that references an
+              # existing static (reserved) IP address resource. When omitted, Google Cloud
+              # assigns an ephemeral IP address.
+              #
+              # Use one of the following formats to specify an IP address while creating a
+              # forwarding rule:
+              #
+              # * IP address number, as in `100.1.2.3`
+              # * IPv6 address range, as in `2600:1234::/96`
+              # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+              # * Partial URL or by name, as in:
+              #
+              #    - projects/project_id/regions/region/addresses/address-name
+              #    - regions/region/addresses/address-name
+              #    - global/addresses/address-name
+              #    - address-name
+              #
+              #
+              #
+              # The IP address can only be set at creation. Once set, it cannot be updated.
+              #
+              # The forwarding rule's target or backendService,
+              # and in most cases, also the loadBalancingScheme, determine the
+              # type of IP address that you can use. For detailed information, see
+              # [IP address
+              # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+              #
+              # When reading an IPAddress, the API always returns the IP
+              # address number.
+              #
+              # When creating a global external Passthrough Network Load Balancer
+              # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+              # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+          "IPProtocol": "A String", # The IP protocol to which this rule applies.
+              #
+              # For protocol forwarding, valid
+              # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+              #
+              # The valid IP protocols are different for different load balancing products
+              # as described in [Load balancing
+              # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+          "allPorts": True or False, # The ports, portRange, and allPorts
+              # fields are mutually exclusive. Only packets addressed to ports in the
+              # specified range will be forwarded to the backends configured with this
+              # forwarding rule.
+              #
+              # The allPorts field has the following limitations:
+              #
+              #    - It requires that the forwarding rule IPProtocol be TCP,
+              #    UDP, SCTP, or L3_DEFAULT.
+              #    - It's applicable only to the following products: internal passthrough
+              #    Network Load Balancers, backend service-based external passthrough Network
+              #    Load Balancers, and internal and external protocol forwarding.
+              #    - Set this field to true to allow packets addressed to any port or
+              #    packets lacking destination port information (for example, UDP fragments
+              #    after the first fragment) to be forwarded to the backends configured with
+              #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+          "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+              # Balancers, the regional internal Application Load Balancer, and the
+              # regional internal proxy Network Load Balancer from all regions.
+              # If false, only allows access from the local region the load balancer is
+              # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+              # cannot be changed after the forwarding rule is created.
+          "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+              # endpoint can be accessed from another region.
+          "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+            { # Reference to an extension resource that is attached to this ForwardingRule.
+              "reference": "A String", # Output only. The resource name.
+            },
+          ],
+          "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+              #
+              # It is a required field for the following load balancers:
+              #
+              #    - Internal passthrough Network Load Balancers
+              #    - Backend service-based regional external passthrough Network Load
+              #    Balancers
+              #    - Global external passthrough Network Load Balancers
+              #
+              #
+              #
+              # It cannot be set by other load balancer types and protocol forwarding
+              # rules.
+          "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+              # forwarding rule, we mean the forwarding rule that has the same IP address,
+              # protocol, and port settings with the current forwarding rule, but without
+              # sourceIPRanges specified.
+              # Always empty if the current forwarding rule does not have sourceIPRanges
+              # specified.
+          "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.
+          "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+              # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+              # TEST_ALL_TRAFFIC.
+              #
+              # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+              # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+              # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+              # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+              # attached to this forwarding rule by percentage using
+              # externalManagedBackendBucketMigrationTestingPercentage.
+              #
+              # Rolling back a migration requires the states to be set in reverse order. So
+              # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+              # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+              # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+              # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+          "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+              # processed by the global external Application Load Balancer.
+              #
+              # The value of this field must be in the range [0, 100].
+              #
+              # This value can only be set if the loadBalancingScheme in the BackendService
+              # is set to EXTERNAL (when using the classic Application Load Balancer) and
+              # the migration state is TEST_BY_PERCENTAGE.
+          "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 ForwardingRule. Include the fingerprint in patch request to
+              # ensure that you do not overwrite changes that were applied from another
+              # concurrent request.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a ForwardingRule.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+              # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+              #
+              # Use one of the following formats to specify a sub-PDP when creating an IPv6
+              # NetLB forwarding rule using BYOIP:
+              # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+              # Partial URL, as in:
+              #
+              #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+              #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+          "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+              # are IPV4 or IPV6.
+          "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+              # packet mirroring. To prevent mirroring loops, instances behind this
+              # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+              # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+          "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+              # essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a ForwardingRule.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "A String",
+          },
+          "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+              #
+              # For more information, refer to
+              # Forwarding rule product and scheme table.
+          "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+              # configuration to a limited set of xDS
+              # compliant clients. In their xDS requests to load balancer, xDS clients
+              # present node
+              # metadata. When there is a match, the relevant configuration
+              # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+              # referenced by the ForwardingRule are not visible to
+              # those proxies.
+              #
+              # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+              # the metadata. If its filterMatchCriteria is set to
+              # MATCH_ALL, then all of its filterLabels must match with
+              # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+              # in order to be considered a match.
+              #
+              # metadataFilters specified here will be applifed before
+              # those specified in the UrlMap that thisForwardingRule references.
+              #
+              # metadataFilters only applies to Loadbalancers that have
+              # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            { # Opaque filter criteria used by load balancers to restrict routing
+                # configuration to a limited set of load balancing proxies. Proxies and
+                # sidecars involved in load balancing would typically present metadata to the
+                # load balancers that need to match criteria specified here. If a match takes
+                # place, the relevant configuration is made available to those
+                # proxies.
+                #
+                # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                # one of thefilterLabels must match the corresponding label provided in
+                # the metadata. If its filterMatchCriteria is set to
+                # MATCH_ALL, then all of its filterLabels must match with
+                # corresponding labels provided in the metadata.
+                #
+                # An example for using metadataFilters would be: if
+                # load balancing involves
+                # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+              "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                  # metadata based on filterMatchCriteria
+                  #
+                  # This list must not be empty and can have at the most 64 entries.
+                { # MetadataFilter label name value pairs that are expected
+                    # to match corresponding labels presented as metadata to the load balancer.
+                  "name": "A String", # Name of metadata label.
+                      #
+                      #  The name can have a maximum length of 1024 characters and must be at
+                      # least 1 character long.
+                  "value": "A String", # The value of the label must match the specified value.
+                      #
+                      # value can have a maximum length of 1024 characters.
+                },
+              ],
+              "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                  # within the list of filterLabels and contributes toward the
+                  # overall metadataFilter match.
+                  #
+                  #  Supported values are:
+                  #
+                  #    - MATCH_ANY: at least one of the filterLabels
+                  #    must have a matching label in the provided metadata.
+                  #    - MATCH_ALL: all filterLabels must have
+                  #    matching labels in the provided metadata.
+            },
+          ],
+          "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.
+              #
+              # For Private Service Connect forwarding rules that forward traffic to Google
+              # APIs, the forwarding rule name must be a 1-20 characters string with
+              # lowercase letters and numbers and must start with a letter.
+              #
+              # For global external Passthrough Network Load Balancer forwarding rules, the
+              # forwarding rule name must be 1-43 characters long. For each global external
+              # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+              # rule) that you create, Google Cloud generates two output-only child
+              # forwarding rules that are named by concatenating the parent forwarding rule
+              # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+          "network": "A String", # This field is not used for global external load balancing.
+              #
+              # For internal passthrough Network Load Balancers, this field identifies the
+              # network that the load balanced IP should belong to for this forwarding
+              # rule.
+              # If the subnetwork is specified, the network of the subnetwork will be used.
+              # If neither subnetwork nor this field is specified, the default network will
+              # be used.
+              #
+              # For Private Service Connect forwarding rules that forward traffic to Google
+              # APIs, a network must be provided.
+          "networkTier": "A String", # This signifies the networking tier used for configuring
+              # this load balancer and can only take the following values:PREMIUM, STANDARD.
+              #
+              # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+              #
+              # If this field is not specified, it is assumed to be PREMIUM.
+              # If IPAddress is specified, this value must be equal to the
+              # networkTier of the Address.
+          "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+              # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+              # this field. Once set, this field is not mutable.
+          "portRange": "A String", # The ports, portRange, and allPorts
+              # fields are mutually exclusive. Only packets addressed to ports in the
+              # specified range will be forwarded to the backends configured with this
+              # forwarding rule.
+              #
+              # The portRange field has the following limitations:
+              #
+              #    - It requires that the forwarding rule IPProtocol be TCP,
+              #    UDP, or SCTP, and
+              #    - It's applicable only to the following products: external passthrough
+              #    Network Load Balancers, internal and external proxy Network Load Balancers,
+              #    internal and external Application Load Balancers, external protocol
+              #    forwarding, and Classic VPN.
+              #    - Some products have restrictions on what ports can be used. See
+              #    port specifications for details.
+              #
+              #
+              #
+              # For external forwarding rules, two or more forwarding rules cannot use the
+              # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+              # fields) if they have overlapping portRanges.
+              #
+              # For internal forwarding rules within the same VPC network, two or more
+              # forwarding rules cannot use the same [IPAddress, IPProtocol]
+              # pair, and cannot have overlapping portRanges.
+              #
+              # @pattern: \\d+(?:-\\d+)?
+          "ports": [ # The ports, portRange, and allPorts
+              # fields are mutually exclusive. Only packets addressed to ports in the
+              # specified range will be forwarded to the backends configured with this
+              # forwarding rule.
+              #
+              # The ports field has the following limitations:
+              #
+              #    - It requires that the forwarding rule IPProtocol be TCP,
+              #    UDP, or SCTP, and
+              #    - It's applicable only to the following products: internal passthrough
+              #    Network Load Balancers, backend service-based external passthrough Network
+              #    Load Balancers, and internal protocol forwarding.
+              #    - You can specify a list of up to five ports by number, separated by
+              #    commas. The ports can be contiguous or discontiguous.
+              #
+              #
+              #
+              # For external forwarding rules, two or more forwarding rules cannot use the
+              # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+              # fields) if they share at least one port number.
+              #
+              # For internal forwarding rules within the same VPC network, two or more
+              # forwarding rules cannot use the same [IPAddress, IPProtocol]
+              # pair if they share at least one port number.
+              #
+              # @pattern: \\d+(?:-\\d+)?
+            "A String",
+          ],
+          "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+          "pscConnectionStatus": "A String",
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+              # This field is not applicable to global forwarding rules.
+              # 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.
+          "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+          "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+              # Currently, only supports a single Service Directory resource.
+            { # Describes the auto-registration of the forwarding rule to Service Directory.
+                # The region and project of the Service Directory resource generated from
+                # this registration will be the same as this forwarding rule.
+              "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+              "service": "A String", # Service Directory service to register the forwarding rule under.
+              "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+                  # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+                  # All PSC for Google APIs forwarding rules on the same network should use
+                  # the same Service Directory region.
+            },
+          ],
+          "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+              # If specified, the prefix is the first label of the fully qualified service
+              # name.
+              #
+              # The label must be 1-63 characters long, and comply withRFC1035.
+              # Specifically, the label 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.
+              #
+              # This field is only used for internal load balancing.
+          "serviceName": "A String", # [Output Only]
+              # The internal fully qualified service name for this forwarding rule.
+              #
+              # This field is only used for internal load balancing.
+          "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+              # source IP address matches one of the IP addresses or CIDR ranges set here.
+              # Note that a forwarding rule can only have up to 64 source IP ranges, and
+              # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+              # Each source_ip_range entry should be either an IP address (for
+              # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+            "A String",
+          ],
+          "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+              # belong to for this forwarding rule, used with internal load balancers and
+              # external passthrough Network Load Balancers with IPv6.
+              #
+              # If the network specified is in auto subnet mode, this field is optional.
+              # However, a subnetwork must be specified if the network is in custom subnet
+              # mode or when creating external forwarding rule with IPv6.
+          "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+              # regional forwarding rules, this target must be in the same region as the
+              # forwarding rule. For global forwarding rules, this target must be a global
+              # load balancing resource.
+              #
+              # The forwarded traffic must be of a type appropriate to the target object.
+              #
+              #
+              #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+              #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+              #
+              #
+              #             -  vpc-sc -  APIs that support VPC Service Controls.
+              #             -  all-apis - All supported Google APIs.
+              #
+              #
+              #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+              #
+              #
+              #
+              # The following load balancers cannot set the target field (they should set the backendService field instead):
+              #
+              #    - Internal passthrough Network Load Balancers
+              #    - Backend service-based regional external passthrough Network Load
+              #    Balancers
+              #    - Global external passthrough Network Load Balancers
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of forwarding rules 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#forwardingRuleAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules.
+  "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, forwardingRule, requestId=None, x__xgafv=None) + 
Deletes the specified ForwardingRule resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  forwardingRule: string, Name of the ForwardingRule 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, forwardingRule, view=None, x__xgafv=None) + 
Returns the specified ForwardingRule resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource to return. (required)
+  view: string, A parameter
+    Allowed values
+      BASIC - The default view of a ForwardingRule, which includes the basic fields.
+      FULL - The full view, including the ForwardingRule.`attached_extensions` field.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a Forwarding Rule resource.
+    #
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    #
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    #
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    #
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      #
+      #
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      #
+      #
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      #
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      #
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      #
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      #
+      #
+      #
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      #
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      #
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      #
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      #
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The allPorts field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      #
+      # It is a required field for the following load balancers:
+      #
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      #
+      #
+      #
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      #
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      #
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      #
+      # The value of this field must be in the range [0, 100].
+      #
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      #
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      #
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      #
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      #
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      #
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      #
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      #
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      #
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      #
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      #
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      #
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The portRange field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      #
+      #
+      #
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      #
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      #
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The ports field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      #
+      #
+      #
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      #
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      #
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      #
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      #
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      #
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      #
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      #
+      # The forwarded traffic must be of a type appropriate to the target object.
+      #
+      #
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      #
+      #
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      #
+      #
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      #
+      #
+      #
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      #
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a ForwardingRule resource in the specified project and region using
+the data 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 Forwarding Rule resource.
+    # 
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    # 
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    # 
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      # 
+      # 
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      # 
+      # 
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      # 
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      # 
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      # 
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      # 
+      # 
+      # 
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      # 
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      # 
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      # 
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      # 
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      # 
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The allPorts field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      # 
+      # It is a required field for the following load balancers:
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      # 
+      # 
+      # 
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      # 
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      # 
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      # 
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      # 
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      # 
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      # 
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      # 
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      # 
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The portRange field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The ports field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      # 
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      # 
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      # 
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      # 
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      # 
+      # The forwarded traffic must be of a type appropriate to the target object.
+      # 
+      # 
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      # 
+      # 
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      # 
+      # 
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      # 
+      # 
+      # 
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of ForwardingRule resources available to the specified
+project and 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.
+  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 ForwardingRule resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of ForwardingRule resources.
+    { # Represents a Forwarding Rule resource.
+        #
+        # Forwarding rule resources in Google Cloud can be either regional or global in
+        # scope:
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+        #
+        # A forwarding rule and its corresponding IP address represent the frontend
+        # configuration of a Google Cloud load balancer.
+        # Forwarding rules can also reference target instances and Cloud VPN Classic
+        # gateways (targetVpnGateway).
+        #
+        # For more information, read
+        # Forwarding rule concepts and
+        # Using protocol forwarding.
+      "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+          # sends traffic to this IP address, the forwarding rule directs the traffic
+          # to the referenced target or backendService.
+          # While creating a forwarding rule, specifying an IPAddress is
+          # required under the following circumstances:
+          #
+          #
+          #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+          #    - When the target is a Private Service Connect Google APIs
+          #    bundle, you must specify an IPAddress.
+          #
+          #
+          # Otherwise, you can optionally specify an IP address that references an
+          # existing static (reserved) IP address resource. When omitted, Google Cloud
+          # assigns an ephemeral IP address.
+          #
+          # Use one of the following formats to specify an IP address while creating a
+          # forwarding rule:
+          #
+          # * IP address number, as in `100.1.2.3`
+          # * IPv6 address range, as in `2600:1234::/96`
+          # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+          # * Partial URL or by name, as in:
+          #
+          #    - projects/project_id/regions/region/addresses/address-name
+          #    - regions/region/addresses/address-name
+          #    - global/addresses/address-name
+          #    - address-name
+          #
+          #
+          #
+          # The IP address can only be set at creation. Once set, it cannot be updated.
+          #
+          # The forwarding rule's target or backendService,
+          # and in most cases, also the loadBalancingScheme, determine the
+          # type of IP address that you can use. For detailed information, see
+          # [IP address
+          # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+          #
+          # When reading an IPAddress, the API always returns the IP
+          # address number.
+          #
+          # When creating a global external Passthrough Network Load Balancer
+          # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+          # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+      "IPProtocol": "A String", # The IP protocol to which this rule applies.
+          #
+          # For protocol forwarding, valid
+          # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+          #
+          # The valid IP protocols are different for different load balancing products
+          # as described in [Load balancing
+          # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+      "allPorts": True or False, # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The allPorts field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, SCTP, or L3_DEFAULT.
+          #    - It's applicable only to the following products: internal passthrough
+          #    Network Load Balancers, backend service-based external passthrough Network
+          #    Load Balancers, and internal and external protocol forwarding.
+          #    - Set this field to true to allow packets addressed to any port or
+          #    packets lacking destination port information (for example, UDP fragments
+          #    after the first fragment) to be forwarded to the backends configured with
+          #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+      "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+          # Balancers, the regional internal Application Load Balancer, and the
+          # regional internal proxy Network Load Balancer from all regions.
+          # If false, only allows access from the local region the load balancer is
+          # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+          # cannot be changed after the forwarding rule is created.
+      "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+          # endpoint can be accessed from another region.
+      "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+        { # Reference to an extension resource that is attached to this ForwardingRule.
+          "reference": "A String", # Output only. The resource name.
+        },
+      ],
+      "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+          #
+          # It is a required field for the following load balancers:
+          #
+          #    - Internal passthrough Network Load Balancers
+          #    - Backend service-based regional external passthrough Network Load
+          #    Balancers
+          #    - Global external passthrough Network Load Balancers
+          #
+          #
+          #
+          # It cannot be set by other load balancer types and protocol forwarding
+          # rules.
+      "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+          # forwarding rule, we mean the forwarding rule that has the same IP address,
+          # protocol, and port settings with the current forwarding rule, but without
+          # sourceIPRanges specified.
+          # Always empty if the current forwarding rule does not have sourceIPRanges
+          # specified.
+      "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.
+      "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+          # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+          # TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+          # attached to this forwarding rule by percentage using
+          # externalManagedBackendBucketMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+          # processed by the global external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "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 ForwardingRule. Include the fingerprint in patch request to
+          # ensure that you do not overwrite changes that were applied from another
+          # concurrent request.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a ForwardingRule.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+          # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+          #
+          # Use one of the following formats to specify a sub-PDP when creating an IPv6
+          # NetLB forwarding rule using BYOIP:
+          # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          # Partial URL, as in:
+          #
+          #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+      "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+          # are IPV4 or IPV6.
+      "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+          # packet mirroring. To prevent mirroring loops, instances behind this
+          # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+          # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+      "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a ForwardingRule.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+          #
+          # For more information, refer to
+          # Forwarding rule product and scheme table.
+      "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+          # configuration to a limited set of xDS
+          # compliant clients. In their xDS requests to load balancer, xDS clients
+          # present node
+          # metadata. When there is a match, the relevant configuration
+          # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+          # referenced by the ForwardingRule are not visible to
+          # those proxies.
+          #
+          # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+          # the metadata. If its filterMatchCriteria is set to
+          # MATCH_ALL, then all of its filterLabels must match with
+          # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+          # in order to be considered a match.
+          #
+          # metadataFilters specified here will be applifed before
+          # those specified in the UrlMap that thisForwardingRule references.
+          #
+          # metadataFilters only applies to Loadbalancers that have
+          # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        { # Opaque filter criteria used by load balancers to restrict routing
+            # configuration to a limited set of load balancing proxies. Proxies and
+            # sidecars involved in load balancing would typically present metadata to the
+            # load balancers that need to match criteria specified here. If a match takes
+            # place, the relevant configuration is made available to those
+            # proxies.
+            #
+            # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+            # one of thefilterLabels must match the corresponding label provided in
+            # the metadata. If its filterMatchCriteria is set to
+            # MATCH_ALL, then all of its filterLabels must match with
+            # corresponding labels provided in the metadata.
+            #
+            # An example for using metadataFilters would be: if
+            # load balancing involves
+            # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+          "filterLabels": [ # The list of label value pairs that must match labels in the provided
+              # metadata based on filterMatchCriteria
+              #
+              # This list must not be empty and can have at the most 64 entries.
+            { # MetadataFilter label name value pairs that are expected
+                # to match corresponding labels presented as metadata to the load balancer.
+              "name": "A String", # Name of metadata label.
+                  #
+                  #  The name can have a maximum length of 1024 characters and must be at
+                  # least 1 character long.
+              "value": "A String", # The value of the label must match the specified value.
+                  #
+                  # value can have a maximum length of 1024 characters.
+            },
+          ],
+          "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+              # within the list of filterLabels and contributes toward the
+              # overall metadataFilter match.
+              #
+              #  Supported values are:
+              #
+              #    - MATCH_ANY: at least one of the filterLabels
+              #    must have a matching label in the provided metadata.
+              #    - MATCH_ALL: all filterLabels must have
+              #    matching labels in the provided metadata.
+        },
+      ],
+      "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.
+          #
+          # For Private Service Connect forwarding rules that forward traffic to Google
+          # APIs, the forwarding rule name must be a 1-20 characters string with
+          # lowercase letters and numbers and must start with a letter.
+          #
+          # For global external Passthrough Network Load Balancer forwarding rules, the
+          # forwarding rule name must be 1-43 characters long. For each global external
+          # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+          # rule) that you create, Google Cloud generates two output-only child
+          # forwarding rules that are named by concatenating the parent forwarding rule
+          # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+      "network": "A String", # This field is not used for global external load balancing.
+          #
+          # For internal passthrough Network Load Balancers, this field identifies the
+          # network that the load balanced IP should belong to for this forwarding
+          # rule.
+          # If the subnetwork is specified, the network of the subnetwork will be used.
+          # If neither subnetwork nor this field is specified, the default network will
+          # be used.
+          #
+          # For Private Service Connect forwarding rules that forward traffic to Google
+          # APIs, a network must be provided.
+      "networkTier": "A String", # This signifies the networking tier used for configuring
+          # this load balancer and can only take the following values:PREMIUM, STANDARD.
+          #
+          # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+          #
+          # If this field is not specified, it is assumed to be PREMIUM.
+          # If IPAddress is specified, this value must be equal to the
+          # networkTier of the Address.
+      "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+          # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+          # this field. Once set, this field is not mutable.
+      "portRange": "A String", # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The portRange field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, or SCTP, and
+          #    - It's applicable only to the following products: external passthrough
+          #    Network Load Balancers, internal and external proxy Network Load Balancers,
+          #    internal and external Application Load Balancers, external protocol
+          #    forwarding, and Classic VPN.
+          #    - Some products have restrictions on what ports can be used. See
+          #    port specifications for details.
+          #
+          #
+          #
+          # For external forwarding rules, two or more forwarding rules cannot use the
+          # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+          # fields) if they have overlapping portRanges.
+          #
+          # For internal forwarding rules within the same VPC network, two or more
+          # forwarding rules cannot use the same [IPAddress, IPProtocol]
+          # pair, and cannot have overlapping portRanges.
+          #
+          # @pattern: \\d+(?:-\\d+)?
+      "ports": [ # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The ports field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, or SCTP, and
+          #    - It's applicable only to the following products: internal passthrough
+          #    Network Load Balancers, backend service-based external passthrough Network
+          #    Load Balancers, and internal protocol forwarding.
+          #    - You can specify a list of up to five ports by number, separated by
+          #    commas. The ports can be contiguous or discontiguous.
+          #
+          #
+          #
+          # For external forwarding rules, two or more forwarding rules cannot use the
+          # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+          # fields) if they share at least one port number.
+          #
+          # For internal forwarding rules within the same VPC network, two or more
+          # forwarding rules cannot use the same [IPAddress, IPProtocol]
+          # pair if they share at least one port number.
+          #
+          # @pattern: \\d+(?:-\\d+)?
+        "A String",
+      ],
+      "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+      "pscConnectionStatus": "A String",
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+          # This field is not applicable to global forwarding rules.
+          # 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.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+          # Currently, only supports a single Service Directory resource.
+        { # Describes the auto-registration of the forwarding rule to Service Directory.
+            # The region and project of the Service Directory resource generated from
+            # this registration will be the same as this forwarding rule.
+          "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+          "service": "A String", # Service Directory service to register the forwarding rule under.
+          "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+              # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+              # All PSC for Google APIs forwarding rules on the same network should use
+              # the same Service Directory region.
+        },
+      ],
+      "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+          # If specified, the prefix is the first label of the fully qualified service
+          # name.
+          #
+          # The label must be 1-63 characters long, and comply withRFC1035.
+          # Specifically, the label 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.
+          #
+          # This field is only used for internal load balancing.
+      "serviceName": "A String", # [Output Only]
+          # The internal fully qualified service name for this forwarding rule.
+          #
+          # This field is only used for internal load balancing.
+      "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+          # source IP address matches one of the IP addresses or CIDR ranges set here.
+          # Note that a forwarding rule can only have up to 64 source IP ranges, and
+          # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+          # Each source_ip_range entry should be either an IP address (for
+          # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+        "A String",
+      ],
+      "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+          # belong to for this forwarding rule, used with internal load balancers and
+          # external passthrough Network Load Balancers with IPv6.
+          #
+          # If the network specified is in auto subnet mode, this field is optional.
+          # However, a subnetwork must be specified if the network is in custom subnet
+          # mode or when creating external forwarding rule with IPv6.
+      "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+          # regional forwarding rules, this target must be in the same region as the
+          # forwarding rule. For global forwarding rules, this target must be a global
+          # load balancing resource.
+          #
+          # The forwarded traffic must be of a type appropriate to the target object.
+          #
+          #
+          #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+          #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+          #
+          #
+          #             -  vpc-sc -  APIs that support VPC Service Controls.
+          #             -  all-apis - All supported Google APIs.
+          #
+          #
+          #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+          #
+          #
+          #
+          # The following load balancers cannot set the target field (they should set the backendService field instead):
+          #
+          #    - Internal passthrough Network Load Balancers
+          #    - Backend service-based regional external passthrough Network Load
+          #    Balancers
+          #    - Global external passthrough Network Load Balancers
+    },
+  ],
+  "kind": "compute#forwardingRuleList", # 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.
+  "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, forwardingRule, body=None, requestId=None, x__xgafv=None) + 
Updates the specified forwarding rule with the data included in the
+request. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules. Currently, you can only
+patch the network_tier field.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Forwarding Rule resource.
+    # 
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    # 
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    # 
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      # 
+      # 
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      # 
+      # 
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      # 
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      # 
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      # 
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      # 
+      # 
+      # 
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      # 
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      # 
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      # 
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      # 
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      # 
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The allPorts field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      # 
+      # It is a required field for the following load balancers:
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      # 
+      # 
+      # 
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      # 
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      # 
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      # 
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      # 
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      # 
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      # 
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      # 
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      # 
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The portRange field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The ports field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      # 
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      # 
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      # 
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      # 
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      # 
+      # The forwarded traffic must be of a type appropriate to the target object.
+      # 
+      # 
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      # 
+      # 
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      # 
+      # 
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      # 
+      # 
+      # 
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on the specified resource. To learn more about labels,
+read the 
+Labeling Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setTarget(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None) + 
Changes target URL for forwarding rule. The new target should be of the
+same type as the old target.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource in which target is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "target": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.futureReservations.html b/docs/dyn/compute_preview.futureReservations.html new file mode 100644 index 0000000000..251c291ac7 --- /dev/null +++ b/docs/dyn/compute_preview.futureReservations.html @@ -0,0 +1,3388 @@ + + + +

Compute Engine API . futureReservations

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of future reservations.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)

+

Cancel the specified future reservation.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, futureReservation, requestId=None, x__xgafv=None)

+

Deletes the specified future reservation.

+

+ get(project, zone, futureReservation, x__xgafv=None)

+

Retrieves information about the specified future reservation.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a new Future Reservation.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

A list of all the future reservations that have been configured for the

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates the specified future reservation.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of future reservations.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 future reservations.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of Future reservation resources.
+    "a_key": { # Name of the scope containing this set of future reservations.
+      "futureReservations": [ # A list of future reservations contained in this scope.
+        {
+          "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation.
+              # count of CPUs) and can account for multiple instance SKUs. In other words,
+              # one can create instances of varying shapes against this reservation.
+            "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+                # belong to.
+            "workloadType": "A String", # The workload type of the instances that will target this reservation.
+          },
+          "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by
+              # Compute Engine. Format of this field must be a valid
+              # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
+          "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations.
+              # It represents relative time to future reservation start_time when
+              # auto-created reservations will be automatically deleted by Compute
+              # Engine. Duration time unit is represented as a count of seconds
+              # and fractions of seconds at nanosecond resolution.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created
+              # reservation. If set to true, auto-created reservations will be
+              # deleted at Future Reservation's end time (default) or at user's defined
+              # timestamp if any of the
+              # [auto_created_reservations_delete_time, auto_created_reservations_duration]
+              # values is specified.
+              # For keeping auto-created reservation indefinitely, this value should be set
+              # to false.
+          "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate
+              # intent for reserving capacity in the same cluster as the colocation
+              # resource.
+          "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an
+              # existing commitment.
+            "commitmentName": "A String", # name of the commitment where capacity is being delivered to.
+            "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If
+                # this field is not present, then no
+                # commitment needs to be created.
+            "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all
+                # parent commitments will be extended to match the end date of the plan for
+                # this commitment.
+          },
+          "confidentialComputeType": "A String",
+          "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339
+              # text format.
+          "deploymentType": "A String", # Type of the deployment requested as part of future reservation.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the future reservation.
+          "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled.
+          "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server
+              # defines this identifier.
+          "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "namePrefix": "A String", # Name prefix for the reservations to be created at the time of
+              # delivery. The name prefix must comply with RFC1035.
+              # Maximum allowed length for name prefix is 20. Automatically created
+              # reservations name format will be -date-####.
+          "params": { # Additional future 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 future 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",
+            },
+          },
+          "planningStatus": "A String", # Planning state before being submitted for evaluation
+          "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and
+              # expected pricing.
+          "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of
+              # delivery of  future reservations. If the reservation with the given name
+              # does not exist already, it is created automatically at the time of Approval
+              # with INACTIVE state till specified start-time. Either provide the
+              # reservation_name or a name_prefix.
+          "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation
+              # resource. It is populated for each instance of the FutureReservation
+              # resource, and includes the api_version the
+              # instance was retrieved through, and its canonical
+              # resource_type name.
+            "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+                # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+            "resourceType": "A String", # The canonical resource type name in the format of a resource type
+                # as defined by [AIP-123](https://google.aip.dev/123).
+                # For example, `"compute.googleapis.com/Instance"`.
+          },
+          "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to
+              # RFC1035. This will be the name of storage pool or Exapool for persistent
+              # disk FRs.
+          "schedulingType": "A String", # Maintenance information for this reservation
+          "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 with the resource id.
+          "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with.
+            "projectMap": { # A map of project id and project config. This is only valid when
+                # share_type's value is SPECIFIC_PROJECTS.
+              "a_key": { # Config for each project in the share settings.
+                "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                    # parent map.
+              },
+            },
+            "shareType": "A String", # Type of sharing for this shared-reservation
+          },
+          "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with
+              # affinity for "any" reservation. If the field is set, then only VMs that
+              # target the reservation by name can consume from the delivered reservation.
+          "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and
+              # total count.
+            "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+                # Next ID: 10
+              "guestAccelerators": [ # Specifies accelerator type and count.
+                { # A specification of the type and number of accelerator cards attached to the
+                    # instance.
+                  "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                  "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                      # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                      # If you are creating an instance template, specify only the
+                      # accelerator name.
+                      # See GPUs on Compute Engine
+                      # for a full list of accelerator types.
+                },
+              ],
+              "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                  # of disk is local-ssd.
+                {
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                      # either SCSI or NVME. The default isSCSI.
+                      # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                },
+              ],
+              "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                  # resources.
+                  # This field is for use by internal tools that use the public API.
+              "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                  # and fixed amount of memory. This also includes specifying custom
+                  # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+              "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+            },
+            "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+                # ReservedInstanceProperties of the future reservation
+            "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+                # future time period.
+          },
+          "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation
+            "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment.
+            "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at
+                # start_time.
+              "A String",
+            ],
+            "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type.
+              "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+              "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+              "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+            },
+            "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future
+                # reservation.
+                # reservation.
+              "count": "A String", # Output only. Count to represent min(FR total_count,
+                  # matching_reserved_capacity+matching_unreserved_instances)
+              "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+            },
+            "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during
+                # "PROVISIONING" state. This count also includes capacity delivered as part
+                # of existing matching reservations.
+            "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an
+                # amendment was requested. If the amendment is declined, the Future
+                # Reservation will be reverted to the last known good state. The last known
+                # good state is not set when updating a future reservation whose
+                # Procurement Status is DRAFTING.
+                # amendment be declined.
+              "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an
+                  # amendment was requested.
+              "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future
+                  # reservation before an amendment was requested.
+                  # reservation.
+                "count": "A String", # Output only. Count to represent min(FR total_count,
+                    # matching_reserved_capacity+matching_unreserved_instances)
+                "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+              },
+              "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation.
+                "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation.
+                  "projectMap": { # A map of project id and project config. This is only valid when
+                      # share_type's value is SPECIFIC_PROJECTS.
+                    "a_key": { # Config for each project in the share settings.
+                      "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                          # parent map.
+                    },
+                  },
+                  "shareType": "A String", # Type of sharing for this shared-reservation
+                },
+                "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the
+                    # Future Reservation.
+                  "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+                      # Next ID: 10
+                    "guestAccelerators": [ # Specifies accelerator type and count.
+                      { # A specification of the type and number of accelerator cards attached to the
+                          # instance.
+                        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                            # If you are creating an instance template, specify only the
+                            # accelerator name.
+                            # See GPUs on Compute Engine
+                            # for a full list of accelerator types.
+                      },
+                    ],
+                    "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                        # of disk is local-ssd.
+                      {
+                        "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                            # either SCSI or NVME. The default isSCSI.
+                            # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                      },
+                    ],
+                    "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                        # resources.
+                        # This field is for use by internal tools that use the public API.
+                    "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                        # and fixed amount of memory. This also includes specifying custom
+                        # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+                    "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+                  },
+                  "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+                      # ReservedInstanceProperties of the future reservation
+                  "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+                      # future time period.
+                },
+                "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation.
+                  "duration": { # A Duration represents a fixed-length span of time represented
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "endTime": "A String",
+                  "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+                      # string.
+                },
+              },
+              "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an
+                  # amendment was requested.
+              "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an
+                  # amendment was requested.
+              "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future
+                  # Reservation.
+            },
+            "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no
+                # modifications to Future Reservation will be allowed. Applicable only
+                # after the Future Reservation is in the APPROVED state. The lock_time is
+                # an RFC3339 string. The procurement_status will transition to PROCURING
+                # state at this time.
+            "procurementStatus": "A String", # Output only. Current state of this Future Reservation
+            "specificSkuProperties": { # Properties to be set for the Future Reservation.
+              "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation
+                  # properties.
+            },
+            "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type.
+              "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+              "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+                  # type is hyperdisk-balanced.
+              "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+                  # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+            },
+          },
+          "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation.
+            "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB.
+              "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+              "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+              "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+            },
+            "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity.
+              "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+              "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+                  # type is hyperdisk-balanced.
+              "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+                  # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+            },
+            "storagePoolType": "A String", # Type of the storage pool.
+          },
+          "timeWindow": { # Time window for this Future Reservation.
+            "duration": { # A Duration represents a fixed-length span of time represented
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "endTime": "A String",
+            "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+                # string.
+          },
+          "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of future reservations 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#futureReservationsAggregatedListResponse", # Output only. [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future
+      # resevation aggregated list response.
+  "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.
+
+
+ +
+ cancel(project, zone, futureReservation, requestId=None, x__xgafv=None) + 
Cancel the specified future reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Name should conform to RFC1035. (required)
+  futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, futureReservation, requestId=None, x__xgafv=None) + 
Deletes the specified future reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Name should conform to RFC1035. (required)
+  futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, futureReservation, x__xgafv=None) + 
Retrieves information about the specified future reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Name should conform to RFC1035. (required)
+  futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by
+      # Compute Engine. Format of this field must be a valid
+      # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
+  "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations.
+      # It represents relative time to future reservation start_time when
+      # auto-created reservations will be automatically deleted by Compute
+      # Engine. Duration time unit is represented as a count of seconds
+      # and fractions of seconds at nanosecond resolution.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created
+      # reservation. If set to true, auto-created reservations will be
+      # deleted at Future Reservation's end time (default) or at user's defined
+      # timestamp if any of the
+      # [auto_created_reservations_delete_time, auto_created_reservations_duration]
+      # values is specified.
+      # For keeping auto-created reservation indefinitely, this value should be set
+      # to false.
+  "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate
+      # intent for reserving capacity in the same cluster as the colocation
+      # resource.
+  "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an
+      # existing commitment.
+    "commitmentName": "A String", # name of the commitment where capacity is being delivered to.
+    "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If
+        # this field is not present, then no
+        # commitment needs to be created.
+    "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all
+        # parent commitments will be extended to match the end date of the plan for
+        # this commitment.
+  },
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339
+      # text format.
+  "deploymentType": "A String", # Type of the deployment requested as part of future reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the future reservation.
+  "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server
+      # defines this identifier.
+  "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "namePrefix": "A String", # Name prefix for the reservations to be created at the time of
+      # delivery. The name prefix must comply with RFC1035.
+      # Maximum allowed length for name prefix is 20. Automatically created
+      # reservations name format will be -date-####.
+  "params": { # Additional future 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 future 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",
+    },
+  },
+  "planningStatus": "A String", # Planning state before being submitted for evaluation
+  "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and
+      # expected pricing.
+  "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of
+      # delivery of  future reservations. If the reservation with the given name
+      # does not exist already, it is created automatically at the time of Approval
+      # with INACTIVE state till specified start-time. Either provide the
+      # reservation_name or a name_prefix.
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation
+      # resource. It is populated for each instance of the FutureReservation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to
+      # RFC1035. This will be the name of storage pool or Exapool for persistent
+      # disk FRs.
+  "schedulingType": "A String", # Maintenance information for this reservation
+  "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 with the resource id.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with
+      # affinity for "any" reservation. If the field is set, then only VMs that
+      # target the reservation by name can consume from the delivered reservation.
+  "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and
+      # total count.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+        # ReservedInstanceProperties of the future reservation
+    "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+        # future time period.
+  },
+  "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation
+    "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment.
+    "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at
+        # start_time.
+      "A String",
+    ],
+    "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future
+        # reservation.
+        # reservation.
+      "count": "A String", # Output only. Count to represent min(FR total_count,
+          # matching_reserved_capacity+matching_unreserved_instances)
+      "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+    },
+    "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during
+        # "PROVISIONING" state. This count also includes capacity delivered as part
+        # of existing matching reservations.
+    "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an
+        # amendment was requested. If the amendment is declined, the Future
+        # Reservation will be reverted to the last known good state. The last known
+        # good state is not set when updating a future reservation whose
+        # Procurement Status is DRAFTING.
+        # amendment be declined.
+      "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an
+          # amendment was requested.
+      "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future
+          # reservation before an amendment was requested.
+          # reservation.
+        "count": "A String", # Output only. Count to represent min(FR total_count,
+            # matching_reserved_capacity+matching_unreserved_instances)
+        "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+      },
+      "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation.
+        "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation.
+          "projectMap": { # A map of project id and project config. This is only valid when
+              # share_type's value is SPECIFIC_PROJECTS.
+            "a_key": { # Config for each project in the share settings.
+              "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                  # parent map.
+            },
+          },
+          "shareType": "A String", # Type of sharing for this shared-reservation
+        },
+        "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the
+            # Future Reservation.
+          "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+              # Next ID: 10
+            "guestAccelerators": [ # Specifies accelerator type and count.
+              { # A specification of the type and number of accelerator cards attached to the
+                  # instance.
+                "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                    # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                    # If you are creating an instance template, specify only the
+                    # accelerator name.
+                    # See GPUs on Compute Engine
+                    # for a full list of accelerator types.
+              },
+            ],
+            "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                # of disk is local-ssd.
+              {
+                "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. The default isSCSI.
+                    # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+              },
+            ],
+            "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                # resources.
+                # This field is for use by internal tools that use the public API.
+            "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                # and fixed amount of memory. This also includes specifying custom
+                # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+            "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+          },
+          "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+              # ReservedInstanceProperties of the future reservation
+          "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+              # future time period.
+        },
+        "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation.
+          "duration": { # A Duration represents a fixed-length span of time represented
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "endTime": "A String",
+          "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+              # string.
+        },
+      },
+      "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an
+          # amendment was requested.
+      "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an
+          # amendment was requested.
+      "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future
+          # Reservation.
+    },
+    "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no
+        # modifications to Future Reservation will be allowed. Applicable only
+        # after the Future Reservation is in the APPROVED state. The lock_time is
+        # an RFC3339 string. The procurement_status will transition to PROCURING
+        # state at this time.
+    "procurementStatus": "A String", # Output only. Current state of this Future Reservation
+    "specificSkuProperties": { # Properties to be set for the Future Reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation
+          # properties.
+    },
+    "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+  },
+  "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation.
+    "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+    "storagePoolType": "A String", # Type of the storage pool.
+  },
+  "timeWindow": { # Time window for this Future Reservation.
+    "duration": { # A Duration represents a fixed-length span of time represented
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "endTime": "A String",
+    "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+        # string.
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides.
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a new Future Reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by
+      # Compute Engine. Format of this field must be a valid
+      # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
+  "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations.
+      # It represents relative time to future reservation start_time when
+      # auto-created reservations will be automatically deleted by Compute
+      # Engine. Duration time unit is represented as a count of seconds
+      # and fractions of seconds at nanosecond resolution.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created
+      # reservation. If set to true, auto-created reservations will be
+      # deleted at Future Reservation's end time (default) or at user's defined
+      # timestamp if any of the
+      # [auto_created_reservations_delete_time, auto_created_reservations_duration]
+      # values is specified.
+      # For keeping auto-created reservation indefinitely, this value should be set
+      # to false.
+  "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate
+      # intent for reserving capacity in the same cluster as the colocation
+      # resource.
+  "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an
+      # existing commitment.
+    "commitmentName": "A String", # name of the commitment where capacity is being delivered to.
+    "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If
+        # this field is not present, then no
+        # commitment needs to be created.
+    "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all
+        # parent commitments will be extended to match the end date of the plan for
+        # this commitment.
+  },
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339
+      # text format.
+  "deploymentType": "A String", # Type of the deployment requested as part of future reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the future reservation.
+  "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server
+      # defines this identifier.
+  "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "namePrefix": "A String", # Name prefix for the reservations to be created at the time of
+      # delivery. The name prefix must comply with RFC1035.
+      # Maximum allowed length for name prefix is 20. Automatically created
+      # reservations name format will be -date-####.
+  "params": { # Additional future 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 future 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",
+    },
+  },
+  "planningStatus": "A String", # Planning state before being submitted for evaluation
+  "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and
+      # expected pricing.
+  "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of
+      # delivery of  future reservations. If the reservation with the given name
+      # does not exist already, it is created automatically at the time of Approval
+      # with INACTIVE state till specified start-time. Either provide the
+      # reservation_name or a name_prefix.
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation
+      # resource. It is populated for each instance of the FutureReservation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to
+      # RFC1035. This will be the name of storage pool or Exapool for persistent
+      # disk FRs.
+  "schedulingType": "A String", # Maintenance information for this reservation
+  "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 with the resource id.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with
+      # affinity for "any" reservation. If the field is set, then only VMs that
+      # target the reservation by name can consume from the delivered reservation.
+  "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and
+      # total count.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+        # ReservedInstanceProperties of the future reservation
+    "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+        # future time period.
+  },
+  "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation
+    "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment.
+    "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at
+        # start_time.
+      "A String",
+    ],
+    "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future
+        # reservation.
+        # reservation.
+      "count": "A String", # Output only. Count to represent min(FR total_count,
+          # matching_reserved_capacity+matching_unreserved_instances)
+      "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+    },
+    "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during
+        # "PROVISIONING" state. This count also includes capacity delivered as part
+        # of existing matching reservations.
+    "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an
+        # amendment was requested. If the amendment is declined, the Future
+        # Reservation will be reverted to the last known good state. The last known
+        # good state is not set when updating a future reservation whose
+        # Procurement Status is DRAFTING.
+        # amendment be declined.
+      "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an
+          # amendment was requested.
+      "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future
+          # reservation before an amendment was requested.
+          # reservation.
+        "count": "A String", # Output only. Count to represent min(FR total_count,
+            # matching_reserved_capacity+matching_unreserved_instances)
+        "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+      },
+      "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation.
+        "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation.
+          "projectMap": { # A map of project id and project config. This is only valid when
+              # share_type's value is SPECIFIC_PROJECTS.
+            "a_key": { # Config for each project in the share settings.
+              "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                  # parent map.
+            },
+          },
+          "shareType": "A String", # Type of sharing for this shared-reservation
+        },
+        "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the
+            # Future Reservation.
+          "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+              # Next ID: 10
+            "guestAccelerators": [ # Specifies accelerator type and count.
+              { # A specification of the type and number of accelerator cards attached to the
+                  # instance.
+                "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                    # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                    # If you are creating an instance template, specify only the
+                    # accelerator name.
+                    # See GPUs on Compute Engine
+                    # for a full list of accelerator types.
+              },
+            ],
+            "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                # of disk is local-ssd.
+              {
+                "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. The default isSCSI.
+                    # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+              },
+            ],
+            "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                # resources.
+                # This field is for use by internal tools that use the public API.
+            "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                # and fixed amount of memory. This also includes specifying custom
+                # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+            "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+          },
+          "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+              # ReservedInstanceProperties of the future reservation
+          "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+              # future time period.
+        },
+        "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation.
+          "duration": { # A Duration represents a fixed-length span of time represented
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "endTime": "A String",
+          "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+              # string.
+        },
+      },
+      "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an
+          # amendment was requested.
+      "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an
+          # amendment was requested.
+      "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future
+          # Reservation.
+    },
+    "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no
+        # modifications to Future Reservation will be allowed. Applicable only
+        # after the Future Reservation is in the APPROVED state. The lock_time is
+        # an RFC3339 string. The procurement_status will transition to PROCURING
+        # state at this time.
+    "procurementStatus": "A String", # Output only. Current state of this Future Reservation
+    "specificSkuProperties": { # Properties to be set for the Future Reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation
+          # properties.
+    },
+    "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+  },
+  "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation.
+    "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+    "storagePoolType": "A String", # Type of the storage pool.
+  },
+  "timeWindow": { # Time window for this Future Reservation.
+    "duration": { # A Duration represents a fixed-length span of time represented
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "endTime": "A String",
+    "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+        # string.
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
A list of all the future reservations that have been configured for the
+specified project in specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of future reservation resources.
+    {
+      "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation.
+          # count of CPUs) and can account for multiple instance SKUs. In other words,
+          # one can create instances of varying shapes against this reservation.
+        "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+            # belong to.
+        "workloadType": "A String", # The workload type of the instances that will target this reservation.
+      },
+      "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by
+          # Compute Engine. Format of this field must be a valid
+          # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
+      "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations.
+          # It represents relative time to future reservation start_time when
+          # auto-created reservations will be automatically deleted by Compute
+          # Engine. Duration time unit is represented as a count of seconds
+          # and fractions of seconds at nanosecond resolution.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created
+          # reservation. If set to true, auto-created reservations will be
+          # deleted at Future Reservation's end time (default) or at user's defined
+          # timestamp if any of the
+          # [auto_created_reservations_delete_time, auto_created_reservations_duration]
+          # values is specified.
+          # For keeping auto-created reservation indefinitely, this value should be set
+          # to false.
+      "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate
+          # intent for reserving capacity in the same cluster as the colocation
+          # resource.
+      "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an
+          # existing commitment.
+        "commitmentName": "A String", # name of the commitment where capacity is being delivered to.
+        "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If
+            # this field is not present, then no
+            # commitment needs to be created.
+        "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all
+            # parent commitments will be extended to match the end date of the plan for
+            # this commitment.
+      },
+      "confidentialComputeType": "A String",
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339
+          # text format.
+      "deploymentType": "A String", # Type of the deployment requested as part of future reservation.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the future reservation.
+      "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server
+          # defines this identifier.
+      "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "namePrefix": "A String", # Name prefix for the reservations to be created at the time of
+          # delivery. The name prefix must comply with RFC1035.
+          # Maximum allowed length for name prefix is 20. Automatically created
+          # reservations name format will be -date-####.
+      "params": { # Additional future 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 future 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",
+        },
+      },
+      "planningStatus": "A String", # Planning state before being submitted for evaluation
+      "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and
+          # expected pricing.
+      "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of
+          # delivery of  future reservations. If the reservation with the given name
+          # does not exist already, it is created automatically at the time of Approval
+          # with INACTIVE state till specified start-time. Either provide the
+          # reservation_name or a name_prefix.
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation
+          # resource. It is populated for each instance of the FutureReservation
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to
+          # RFC1035. This will be the name of storage pool or Exapool for persistent
+          # disk FRs.
+      "schedulingType": "A String", # Maintenance information for this reservation
+      "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 with the resource id.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with
+          # affinity for "any" reservation. If the field is set, then only VMs that
+          # target the reservation by name can consume from the delivered reservation.
+      "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and
+          # total count.
+        "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+            # Next ID: 10
+          "guestAccelerators": [ # Specifies accelerator type and count.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+              # of disk is local-ssd.
+            {
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. The default isSCSI.
+                  # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+            },
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+              # and fixed amount of memory. This also includes specifying custom
+              # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+          "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+        },
+        "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+            # ReservedInstanceProperties of the future reservation
+        "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+            # future time period.
+      },
+      "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation
+        "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment.
+        "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at
+            # start_time.
+          "A String",
+        ],
+        "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type.
+          "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+          "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+          "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+        },
+        "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future
+            # reservation.
+            # reservation.
+          "count": "A String", # Output only. Count to represent min(FR total_count,
+              # matching_reserved_capacity+matching_unreserved_instances)
+          "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+        },
+        "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during
+            # "PROVISIONING" state. This count also includes capacity delivered as part
+            # of existing matching reservations.
+        "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an
+            # amendment was requested. If the amendment is declined, the Future
+            # Reservation will be reverted to the last known good state. The last known
+            # good state is not set when updating a future reservation whose
+            # Procurement Status is DRAFTING.
+            # amendment be declined.
+          "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an
+              # amendment was requested.
+          "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future
+              # reservation before an amendment was requested.
+              # reservation.
+            "count": "A String", # Output only. Count to represent min(FR total_count,
+                # matching_reserved_capacity+matching_unreserved_instances)
+            "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+          },
+          "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation.
+            "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation.
+              "projectMap": { # A map of project id and project config. This is only valid when
+                  # share_type's value is SPECIFIC_PROJECTS.
+                "a_key": { # Config for each project in the share settings.
+                  "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                      # parent map.
+                },
+              },
+              "shareType": "A String", # Type of sharing for this shared-reservation
+            },
+            "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the
+                # Future Reservation.
+              "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+                  # Next ID: 10
+                "guestAccelerators": [ # Specifies accelerator type and count.
+                  { # A specification of the type and number of accelerator cards attached to the
+                      # instance.
+                    "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                    "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                        # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                        # If you are creating an instance template, specify only the
+                        # accelerator name.
+                        # See GPUs on Compute Engine
+                        # for a full list of accelerator types.
+                  },
+                ],
+                "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                    # of disk is local-ssd.
+                  {
+                    "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                    "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                        # either SCSI or NVME. The default isSCSI.
+                        # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                  },
+                ],
+                "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                    # resources.
+                    # This field is for use by internal tools that use the public API.
+                "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                    # and fixed amount of memory. This also includes specifying custom
+                    # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+                "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+              },
+              "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+                  # ReservedInstanceProperties of the future reservation
+              "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+                  # future time period.
+            },
+            "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation.
+              "duration": { # A Duration represents a fixed-length span of time represented
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "endTime": "A String",
+              "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+                  # string.
+            },
+          },
+          "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an
+              # amendment was requested.
+          "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an
+              # amendment was requested.
+          "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future
+              # Reservation.
+        },
+        "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no
+            # modifications to Future Reservation will be allowed. Applicable only
+            # after the Future Reservation is in the APPROVED state. The lock_time is
+            # an RFC3339 string. The procurement_status will transition to PROCURING
+            # state at this time.
+        "procurementStatus": "A String", # Output only. Current state of this Future Reservation
+        "specificSkuProperties": { # Properties to be set for the Future Reservation.
+          "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation
+              # properties.
+        },
+        "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type.
+          "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+          "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+              # type is hyperdisk-balanced.
+          "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+              # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+        },
+      },
+      "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation.
+        "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB.
+          "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+          "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+          "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+        },
+        "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity.
+          "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+          "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+              # type is hyperdisk-balanced.
+          "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+              # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+        },
+        "storagePoolType": "A String", # Type of the storage pool.
+      },
+      "timeWindow": { # Time window for this Future Reservation.
+        "duration": { # A Duration represents a fixed-length span of time represented
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "endTime": "A String",
+        "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+            # string.
+      },
+      "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides.
+    },
+  ],
+  "kind": "compute#futureReservationsListResponse", # Output only. [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of
+      # reservations
+  "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.
+  },
+}
+
+ +
+ 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.
+
+
+ +
+ update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the specified future reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Name should conform to RFC1035. (required)
+  futureReservation: string, Name of the reservation to update. Name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by
+      # Compute Engine. Format of this field must be a valid
+      # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
+  "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations.
+      # It represents relative time to future reservation start_time when
+      # auto-created reservations will be automatically deleted by Compute
+      # Engine. Duration time unit is represented as a count of seconds
+      # and fractions of seconds at nanosecond resolution.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created
+      # reservation. If set to true, auto-created reservations will be
+      # deleted at Future Reservation's end time (default) or at user's defined
+      # timestamp if any of the
+      # [auto_created_reservations_delete_time, auto_created_reservations_duration]
+      # values is specified.
+      # For keeping auto-created reservation indefinitely, this value should be set
+      # to false.
+  "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate
+      # intent for reserving capacity in the same cluster as the colocation
+      # resource.
+  "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an
+      # existing commitment.
+    "commitmentName": "A String", # name of the commitment where capacity is being delivered to.
+    "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If
+        # this field is not present, then no
+        # commitment needs to be created.
+    "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all
+        # parent commitments will be extended to match the end date of the plan for
+        # this commitment.
+  },
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339
+      # text format.
+  "deploymentType": "A String", # Type of the deployment requested as part of future reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the future reservation.
+  "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server
+      # defines this identifier.
+  "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "namePrefix": "A String", # Name prefix for the reservations to be created at the time of
+      # delivery. The name prefix must comply with RFC1035.
+      # Maximum allowed length for name prefix is 20. Automatically created
+      # reservations name format will be -date-####.
+  "params": { # Additional future 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 future 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",
+    },
+  },
+  "planningStatus": "A String", # Planning state before being submitted for evaluation
+  "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and
+      # expected pricing.
+  "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of
+      # delivery of  future reservations. If the reservation with the given name
+      # does not exist already, it is created automatically at the time of Approval
+      # with INACTIVE state till specified start-time. Either provide the
+      # reservation_name or a name_prefix.
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation
+      # resource. It is populated for each instance of the FutureReservation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to
+      # RFC1035. This will be the name of storage pool or Exapool for persistent
+      # disk FRs.
+  "schedulingType": "A String", # Maintenance information for this reservation
+  "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 with the resource id.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with
+      # affinity for "any" reservation. If the field is set, then only VMs that
+      # target the reservation by name can consume from the delivered reservation.
+  "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and
+      # total count.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+        # ReservedInstanceProperties of the future reservation
+    "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+        # future time period.
+  },
+  "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation
+    "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment.
+    "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at
+        # start_time.
+      "A String",
+    ],
+    "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future
+        # reservation.
+        # reservation.
+      "count": "A String", # Output only. Count to represent min(FR total_count,
+          # matching_reserved_capacity+matching_unreserved_instances)
+      "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+    },
+    "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during
+        # "PROVISIONING" state. This count also includes capacity delivered as part
+        # of existing matching reservations.
+    "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an
+        # amendment was requested. If the amendment is declined, the Future
+        # Reservation will be reverted to the last known good state. The last known
+        # good state is not set when updating a future reservation whose
+        # Procurement Status is DRAFTING.
+        # amendment be declined.
+      "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an
+          # amendment was requested.
+      "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future
+          # reservation before an amendment was requested.
+          # reservation.
+        "count": "A String", # Output only. Count to represent min(FR total_count,
+            # matching_reserved_capacity+matching_unreserved_instances)
+        "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated
+      },
+      "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation.
+        "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation.
+          "projectMap": { # A map of project id and project config. This is only valid when
+              # share_type's value is SPECIFIC_PROJECTS.
+            "a_key": { # Config for each project in the share settings.
+              "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                  # parent map.
+            },
+          },
+          "shareType": "A String", # Type of sharing for this shared-reservation
+        },
+        "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the
+            # Future Reservation.
+          "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved.
+              # Next ID: 10
+            "guestAccelerators": [ # Specifies accelerator type and count.
+              { # A specification of the type and number of accelerator cards attached to the
+                  # instance.
+                "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                    # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                    # If you are creating an instance template, specify only the
+                    # accelerator name.
+                    # See GPUs on Compute Engine
+                    # for a full list of accelerator types.
+              },
+            ],
+            "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                # of disk is local-ssd.
+              {
+                "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. The default isSCSI.
+                    # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+              },
+            ],
+            "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                # resources.
+                # This field is for use by internal tools that use the public API.
+            "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                # and fixed amount of memory. This also includes specifying custom
+                # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+            "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+          },
+          "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the
+              # ReservedInstanceProperties of the future reservation
+          "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a
+              # future time period.
+        },
+        "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation.
+          "duration": { # A Duration represents a fixed-length span of time represented
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "endTime": "A String",
+          "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+              # string.
+        },
+      },
+      "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an
+          # amendment was requested.
+      "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an
+          # amendment was requested.
+      "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future
+          # Reservation.
+    },
+    "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no
+        # modifications to Future Reservation will be allowed. Applicable only
+        # after the Future Reservation is in the APPROVED state. The lock_time is
+        # an RFC3339 string. The procurement_status will transition to PROCURING
+        # state at this time.
+    "procurementStatus": "A String", # Output only. Current state of this Future Reservation
+    "specificSkuProperties": { # Properties to be set for the Future Reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation
+          # properties.
+    },
+    "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+  },
+  "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation.
+    "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB.
+      "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+      "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+      "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+    },
+    "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if
+          # the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+    },
+    "storagePoolType": "A String", # Type of the storage pool.
+  },
+  "timeWindow": { # Time window for this Future Reservation.
+    "duration": { # A Duration represents a fixed-length span of time represented
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "endTime": "A String",
+    "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339
+        # string.
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides.
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalAddresses.html b/docs/dyn/compute_preview.globalAddresses.html new file mode 100644 index 0000000000..6711c593c1 --- /dev/null +++ b/docs/dyn/compute_preview.globalAddresses.html @@ -0,0 +1,1939 @@ + + + +

Compute Engine API . globalAddresses

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, address, requestId=None, x__xgafv=None)

+

Deletes the specified address resource.

+

+ get(project, address, x__xgafv=None)

+

Returns the specified address resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates an address resource in the specified project by using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of global addresses.

+

+ list_next()

+

Retrieves the next page of results.

+

+ move(project, address, body=None, requestId=None, x__xgafv=None)

+

Moves the specified address resource from one project to another project.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling

+

+ 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, address, requestId=None, x__xgafv=None) + 
Deletes the specified address resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  address: string, Name of the address 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, address, x__xgafv=None) + 
Returns the specified address resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  address: string, Name of the address 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 an IP Address resource.
+    #
+    # Google Compute Engine has two IP Address resources:
+    #
+    # * [Global (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+    # * [Regional (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+    #
+    # For more information, see
+    # Reserving a static external IP address.
+  "address": "A String", # The static IP address represented by this resource.
+  "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field 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.
+  "ipCollection": "A String", # Reference to the source of IP addresses.
+      #
+      # It supports the following cases:
+      #
+      #    -
+      #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+      #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+      #      allocations. If an IPv6 PDP is used, the PDP must be in
+      #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #    -
+      #      Case 2: Internal Range for global internal addresses.
+      #
+      #
+      #
+      # Use one of the following formats to specify the resource:
+      #
+      # For a Public Delegated Prefix:
+      #
+      #    -
+      #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+      #    - Partial URL:
+      #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+      #       - regions/region/publicDelegatedPrefixes/pdp-name
+      #
+      #
+      #
+      # For an Internal Range:
+      #
+      #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+      #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+  "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+  "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+      # or NETLB. This is used for deciding which type of endpoint
+      # this address can be used after the external IPv6 address reservation.
+  "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+      # addresses.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Address.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # The URL of the network in which to reserve the address. This field can
+      # only be used with INTERNAL type with theVPC_PEERING purpose.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+      # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+      # global external IP addresses are always Premium Tier; regional external IP
+      # addresses can be either Standard or Premium Tier.
+      #
+      # If this field is not specified, it is assumed to be PREMIUM.
+  "prefixLength": 42, # The prefix length if the resource represents an IP range.
+  "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+      #
+      #
+      #      - GCE_ENDPOINT for addresses that are used by VM
+      #      instances, alias IP ranges, load balancers, and similar resources.
+      #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+      #        for a Cloud DNS  inbound
+      #        forwarder IP addresses (regional internal IP address in a subnet of
+      #        a VPC network)
+      #      - VPC_PEERING for global internal IP addresses used for
+      #
+      #           private services access allocated ranges.
+      #      - NAT_AUTO for the regional external IP addresses used by
+      #           Cloud NAT when allocating addresses using
+      #
+      #           automatic NAT IP address allocation.
+      #      - IPSEC_INTERCONNECT for addresses created from a private
+      #      IP range that are reserved for a VLAN attachment in an
+      #      *HA VPN over Cloud Interconnect* configuration. These addresses
+      #      are regional resources.
+      #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+      #      to multiple internal forwarding rules.
+      #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+      #      used to configure Private Service Connect. Only global internal addresses
+      #      can use this purpose.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+      #      that can only be assigned to global external Passthrough Network Load
+      #      Balancer forwarding rules, as an Availability Group 0 address.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+      #      can only be assigned to global external Passthrough Network Load Balancer
+      #      forwarding rules, as an Availability Group 1 address.
+  "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+      # For regional addresses, you must specify the region as a path parameter in
+      # the HTTP request URL. *This field is not applicable to global
+      # addresses.*
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+      # An address that is RESERVING is currently in the process of
+      # being reserved. A RESERVED address is currently reserved and
+      # available to use. An IN_USE address is currently being used
+      # by another resource and is not available.
+  "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+      # is specified, it must be within the subnetwork's IP range. This field can
+      # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+  "users": [ # [Output Only] The URLs of the resources that are using this address.
+    "A String",
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates an address resource in the specified project by 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 an IP Address resource.
+    # 
+    # Google Compute Engine has two IP Address resources:
+    # 
+    # * [Global (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+    # * [Regional (external and
+    # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+    # 
+    # For more information, see
+    # Reserving a static external IP address.
+  "address": "A String", # The static IP address represented by this resource.
+  "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field 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.
+  "ipCollection": "A String", # Reference to the source of IP addresses.
+      # 
+      # It supports the following cases:
+      # 
+      #    -
+      #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+      #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+      #      allocations. If an IPv6 PDP is used, the PDP must be in
+      #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #    -
+      #      Case 2: Internal Range for global internal addresses.
+      # 
+      # 
+      # 
+      # Use one of the following formats to specify the resource:
+      # 
+      # For a Public Delegated Prefix:
+      # 
+      #    -
+      #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+      #    - Partial URL:
+      #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+      #       - regions/region/publicDelegatedPrefixes/pdp-name
+      # 
+      # 
+      # 
+      # For an Internal Range:
+      # 
+      #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+      #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+  "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+  "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+      # or NETLB. This is used for deciding which type of endpoint
+      # this address can be used after the external IPv6 address reservation.
+  "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+      # addresses.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Address.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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])?`. The first character
+      # must be a lowercase letter, and all following characters (except for the
+      # last character) must be a dash, lowercase letter, or digit. The last
+      # character must be a lowercase letter or digit.
+  "network": "A String", # The URL of the network in which to reserve the address. This field can
+      # only be used with INTERNAL type with theVPC_PEERING purpose.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+      # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+      # global external IP addresses are always Premium Tier; regional external IP
+      # addresses can be either Standard or Premium Tier.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+  "prefixLength": 42, # The prefix length if the resource represents an IP range.
+  "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+      # 
+      # 
+      #      - GCE_ENDPOINT for addresses that are used by VM
+      #      instances, alias IP ranges, load balancers, and similar resources.
+      #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+      #        for a Cloud DNS  inbound
+      #        forwarder IP addresses (regional internal IP address in a subnet of
+      #        a VPC network)
+      #      - VPC_PEERING for global internal IP addresses used for
+      # 
+      #           private services access allocated ranges.
+      #      - NAT_AUTO for the regional external IP addresses used by
+      #           Cloud NAT when allocating addresses using
+      # 
+      #           automatic NAT IP address allocation.
+      #      - IPSEC_INTERCONNECT for addresses created from a private
+      #      IP range that are reserved for a VLAN attachment in an
+      #      *HA VPN over Cloud Interconnect* configuration. These addresses
+      #      are regional resources.
+      #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+      #      to multiple internal forwarding rules.
+      #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+      #      used to configure Private Service Connect. Only global internal addresses
+      #      can use this purpose.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+      #      that can only be assigned to global external Passthrough Network Load
+      #      Balancer forwarding rules, as an Availability Group 0 address.
+      #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+      #      can only be assigned to global external Passthrough Network Load Balancer
+      #      forwarding rules, as an Availability Group 1 address.
+  "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+      # For regional addresses, you must specify the region as a path parameter in
+      # the HTTP request URL. *This field is not applicable to global
+      # addresses.*
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+      # An address that is RESERVING is currently in the process of
+      # being reserved. A RESERVED address is currently reserved and
+      # available to use. An IN_USE address is currently being used
+      # by another resource and is not available.
+  "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+      # is specified, it must be within the subnetwork's IP range. This field can
+      # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+  "users": [ # [Output Only] The URLs of the resources that are using this address.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of global addresses.
+
+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.
+  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 addresses.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Address resources.
+    { # Represents an IP Address resource.
+        #
+        # Google Compute Engine has two IP Address resources:
+        #
+        # * [Global (external and
+        # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)
+        # * [Regional (external and
+        # internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)
+        #
+        # For more information, see
+        # Reserving a static external IP address.
+      "address": "A String", # The static IP address represented by this resource.
+      "addressType": "A String", # The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this field 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.
+      "ipCollection": "A String", # Reference to the source of IP addresses.
+          #
+          # It supports the following cases:
+          #
+          #    -
+          #      Case 1: PublicDelegatedPrefix (PDP) for BYOIP external
+          #      addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4
+          #      allocations. If an IPv6 PDP is used, the PDP must be in
+          #      EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+          #    -
+          #      Case 2: Internal Range for global internal addresses.
+          #
+          #
+          #
+          # Use one of the following formats to specify the resource:
+          #
+          # For a Public Delegated Prefix:
+          #
+          #    -
+          #    Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp
+          #    - Partial URL:
+          #       - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name
+          #       - regions/region/publicDelegatedPrefixes/pdp-name
+          #
+          #
+          #
+          # For an Internal Range:
+          #
+          #    - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range
+          #    - Partial URL:projects/project/locations/global/internalRanges/internal-range
+      "ipVersion": "A String", # The IP version that will be used by this address. Valid options areIPV4 or IPV6.
+      "ipv6EndpointType": "A String", # The endpoint type of this address, which should be VM
+          # or NETLB. This is used for deciding which type of endpoint
+          # this address can be used after the external IPv6 address reservation.
+      "kind": "compute#address", # Output only. [Output Only] Type of the resource. Always compute#address for
+          # addresses.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Address, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an Address.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # The URL of the network in which to reserve the address. This field can
+          # only be used with INTERNAL type with theVPC_PEERING purpose.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this address and
+          # can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;
+          # global external IP addresses are always Premium Tier; regional external IP
+          # addresses can be either Standard or Premium Tier.
+          #
+          # If this field is not specified, it is assumed to be PREMIUM.
+      "prefixLength": 42, # The prefix length if the resource represents an IP range.
+      "purpose": "A String", # The purpose of this resource, which can be one of the following values:
+          #
+          #
+          #      - GCE_ENDPOINT for addresses that are used by VM
+          #      instances, alias IP ranges, load balancers, and similar resources.
+          #      - DNS_RESOLVER for a DNS resolver address in a subnetwork
+          #        for a Cloud DNS  inbound
+          #        forwarder IP addresses (regional internal IP address in a subnet of
+          #        a VPC network)
+          #      - VPC_PEERING for global internal IP addresses used for
+          #
+          #           private services access allocated ranges.
+          #      - NAT_AUTO for the regional external IP addresses used by
+          #           Cloud NAT when allocating addresses using
+          #
+          #           automatic NAT IP address allocation.
+          #      - IPSEC_INTERCONNECT for addresses created from a private
+          #      IP range that are reserved for a VLAN attachment in an
+          #      *HA VPN over Cloud Interconnect* configuration. These addresses
+          #      are regional resources.
+          #      - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned
+          #      to multiple internal forwarding rules.
+          #      - `PRIVATE_SERVICE_CONNECT` for a private network address that is
+          #      used to configure Private Service Connect. Only global internal addresses
+          #      can use this purpose.
+          #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses
+          #      that can only be assigned to global external Passthrough Network Load
+          #      Balancer forwarding rules, as an Availability Group 0 address.
+          #      - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that
+          #      can only be assigned to global external Passthrough Network Load Balancer
+          #      forwarding rules, as an Availability Group 1 address.
+      "region": "A String", # Output only. [Output Only] The URL of the region where a regional address resides.
+          # For regional addresses, you must specify the region as a path parameter in
+          # the HTTP request URL. *This field is not applicable to global
+          # addresses.*
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.
+          # An address that is RESERVING is currently in the process of
+          # being reserved. A RESERVED address is currently reserved and
+          # available to use. An IN_USE address is currently being used
+          # by another resource and is not available.
+      "subnetwork": "A String", # The URL of the subnetwork in which to reserve the address. If an IP address
+          # is specified, it must be within the subnetwork's IP range. This field can
+          # only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.
+      "users": [ # [Output Only] The URLs of the resources that are using this address.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#addressList", # Output only. [Output Only] Type of resource. Always compute#addressList for
+      # lists of addresses.
+  "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.
+  "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.
+
+
+ +
+ move(project, address, body=None, requestId=None, x__xgafv=None) + 
Moves the specified address resource from one project to another project.
+
+Args:
+  project: string, Source project ID which the Address is moved from. (required)
+  address: string, Name of the address resource to move. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "description": "A String", # An optional destination address description if intended to be different
+      # from the source.
+  "destinationAddress": "A String", # The URL of the destination address to move to. This can be a full or
+      # partial URL. For example, the following are all valid URLs to a address:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address
+      #    - projects/project/global/addresses/address
+      # 
+      # 
+      # Note that destination project must be different from the source project. So/global/addresses/address is not valid partial url.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.globalForwardingRules.html b/docs/dyn/compute_preview.globalForwardingRules.html new file mode 100644 index 0000000000..c2e807da1f --- /dev/null +++ b/docs/dyn/compute_preview.globalForwardingRules.html @@ -0,0 +1,3523 @@ + + + +

Compute Engine API . globalForwardingRules

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, forwardingRule, requestId=None, x__xgafv=None)

+

Deletes the specified GlobalForwardingRule resource.

+

+ get(project, forwardingRule, view=None, x__xgafv=None)

+

Returns the specified GlobalForwardingRule resource. Gets a list of

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a GlobalForwardingRule resource in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of GlobalForwardingRule resources available to the

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, forwardingRule, body=None, requestId=None, x__xgafv=None)

+

Updates the specified forwarding rule with the data included in the

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on the specified resource. To learn more about labels,

+

+ setTarget(project, forwardingRule, body=None, requestId=None, x__xgafv=None)

+

Changes target URL for the GlobalForwardingRule resource. The new target

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, forwardingRule, requestId=None, x__xgafv=None) + 
Deletes the specified GlobalForwardingRule resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  forwardingRule: string, Name of the ForwardingRule 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, forwardingRule, view=None, x__xgafv=None) + 
Returns the specified GlobalForwardingRule resource. Gets a list of
+available forwarding rules by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource to return. (required)
+  view: string, A parameter
+    Allowed values
+      BASIC - The default view of a ForwardingRule, which includes the basic fields.
+      FULL - The full view, including the ForwardingRule.`attached_extensions` field.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a Forwarding Rule resource.
+    #
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    #
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    #
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    #
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      #
+      #
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      #
+      #
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      #
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      #
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      #
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      #
+      #
+      #
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      #
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      #
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      #
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      #
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The allPorts field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      #
+      # It is a required field for the following load balancers:
+      #
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      #
+      #
+      #
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      #
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      #
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      #
+      # The value of this field must be in the range [0, 100].
+      #
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      #
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      #
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      #
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      #
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      #
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      #
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      #
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      #
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      #
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      #
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      #
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      #
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The portRange field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      #
+      #
+      #
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      #
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      #
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      #
+      # The ports field has the following limitations:
+      #
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      #
+      #
+      #
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      #
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      #
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      #
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      #
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      #
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      #
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      #
+      # The forwarded traffic must be of a type appropriate to the target object.
+      #
+      #
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      #
+      #
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      #
+      #
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      #
+      #
+      #
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      #
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a GlobalForwardingRule resource 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 Forwarding Rule resource.
+    # 
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    # 
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    # 
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      # 
+      # 
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      # 
+      # 
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      # 
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      # 
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      # 
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      # 
+      # 
+      # 
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      # 
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      # 
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      # 
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      # 
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      # 
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The allPorts field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      # 
+      # It is a required field for the following load balancers:
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      # 
+      # 
+      # 
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      # 
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      # 
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      # 
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      # 
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      # 
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      # 
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      # 
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      # 
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The portRange field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The ports field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      # 
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      # 
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      # 
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      # 
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      # 
+      # The forwarded traffic must be of a type appropriate to the target object.
+      # 
+      # 
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      # 
+      # 
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      # 
+      # 
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      # 
+      # 
+      # 
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of GlobalForwardingRule resources available to 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.
+  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 ForwardingRule resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of ForwardingRule resources.
+    { # Represents a Forwarding Rule resource.
+        #
+        # Forwarding rule resources in Google Cloud can be either regional or global in
+        # scope:
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+        #
+        # A forwarding rule and its corresponding IP address represent the frontend
+        # configuration of a Google Cloud load balancer.
+        # Forwarding rules can also reference target instances and Cloud VPN Classic
+        # gateways (targetVpnGateway).
+        #
+        # For more information, read
+        # Forwarding rule concepts and
+        # Using protocol forwarding.
+      "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+          # sends traffic to this IP address, the forwarding rule directs the traffic
+          # to the referenced target or backendService.
+          # While creating a forwarding rule, specifying an IPAddress is
+          # required under the following circumstances:
+          #
+          #
+          #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+          #    - When the target is a Private Service Connect Google APIs
+          #    bundle, you must specify an IPAddress.
+          #
+          #
+          # Otherwise, you can optionally specify an IP address that references an
+          # existing static (reserved) IP address resource. When omitted, Google Cloud
+          # assigns an ephemeral IP address.
+          #
+          # Use one of the following formats to specify an IP address while creating a
+          # forwarding rule:
+          #
+          # * IP address number, as in `100.1.2.3`
+          # * IPv6 address range, as in `2600:1234::/96`
+          # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+          # * Partial URL or by name, as in:
+          #
+          #    - projects/project_id/regions/region/addresses/address-name
+          #    - regions/region/addresses/address-name
+          #    - global/addresses/address-name
+          #    - address-name
+          #
+          #
+          #
+          # The IP address can only be set at creation. Once set, it cannot be updated.
+          #
+          # The forwarding rule's target or backendService,
+          # and in most cases, also the loadBalancingScheme, determine the
+          # type of IP address that you can use. For detailed information, see
+          # [IP address
+          # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+          #
+          # When reading an IPAddress, the API always returns the IP
+          # address number.
+          #
+          # When creating a global external Passthrough Network Load Balancer
+          # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+          # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+      "IPProtocol": "A String", # The IP protocol to which this rule applies.
+          #
+          # For protocol forwarding, valid
+          # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+          #
+          # The valid IP protocols are different for different load balancing products
+          # as described in [Load balancing
+          # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+      "allPorts": True or False, # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The allPorts field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, SCTP, or L3_DEFAULT.
+          #    - It's applicable only to the following products: internal passthrough
+          #    Network Load Balancers, backend service-based external passthrough Network
+          #    Load Balancers, and internal and external protocol forwarding.
+          #    - Set this field to true to allow packets addressed to any port or
+          #    packets lacking destination port information (for example, UDP fragments
+          #    after the first fragment) to be forwarded to the backends configured with
+          #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+      "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+          # Balancers, the regional internal Application Load Balancer, and the
+          # regional internal proxy Network Load Balancer from all regions.
+          # If false, only allows access from the local region the load balancer is
+          # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+          # cannot be changed after the forwarding rule is created.
+      "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+          # endpoint can be accessed from another region.
+      "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+        { # Reference to an extension resource that is attached to this ForwardingRule.
+          "reference": "A String", # Output only. The resource name.
+        },
+      ],
+      "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+          #
+          # It is a required field for the following load balancers:
+          #
+          #    - Internal passthrough Network Load Balancers
+          #    - Backend service-based regional external passthrough Network Load
+          #    Balancers
+          #    - Global external passthrough Network Load Balancers
+          #
+          #
+          #
+          # It cannot be set by other load balancer types and protocol forwarding
+          # rules.
+      "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+          # forwarding rule, we mean the forwarding rule that has the same IP address,
+          # protocol, and port settings with the current forwarding rule, but without
+          # sourceIPRanges specified.
+          # Always empty if the current forwarding rule does not have sourceIPRanges
+          # specified.
+      "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.
+      "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+          # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+          # TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+          # attached to this forwarding rule by percentage using
+          # externalManagedBackendBucketMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+          # processed by the global external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "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 ForwardingRule. Include the fingerprint in patch request to
+          # ensure that you do not overwrite changes that were applied from another
+          # concurrent request.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a ForwardingRule.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+          # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+          #
+          # Use one of the following formats to specify a sub-PDP when creating an IPv6
+          # NetLB forwarding rule using BYOIP:
+          # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          # Partial URL, as in:
+          #
+          #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+      "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+          # are IPV4 or IPV6.
+      "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+          # packet mirroring. To prevent mirroring loops, instances behind this
+          # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+          # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+      "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a ForwardingRule.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+          #
+          # For more information, refer to
+          # Forwarding rule product and scheme table.
+      "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+          # configuration to a limited set of xDS
+          # compliant clients. In their xDS requests to load balancer, xDS clients
+          # present node
+          # metadata. When there is a match, the relevant configuration
+          # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+          # referenced by the ForwardingRule are not visible to
+          # those proxies.
+          #
+          # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+          # the metadata. If its filterMatchCriteria is set to
+          # MATCH_ALL, then all of its filterLabels must match with
+          # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+          # in order to be considered a match.
+          #
+          # metadataFilters specified here will be applifed before
+          # those specified in the UrlMap that thisForwardingRule references.
+          #
+          # metadataFilters only applies to Loadbalancers that have
+          # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        { # Opaque filter criteria used by load balancers to restrict routing
+            # configuration to a limited set of load balancing proxies. Proxies and
+            # sidecars involved in load balancing would typically present metadata to the
+            # load balancers that need to match criteria specified here. If a match takes
+            # place, the relevant configuration is made available to those
+            # proxies.
+            #
+            # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+            # one of thefilterLabels must match the corresponding label provided in
+            # the metadata. If its filterMatchCriteria is set to
+            # MATCH_ALL, then all of its filterLabels must match with
+            # corresponding labels provided in the metadata.
+            #
+            # An example for using metadataFilters would be: if
+            # load balancing involves
+            # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+          "filterLabels": [ # The list of label value pairs that must match labels in the provided
+              # metadata based on filterMatchCriteria
+              #
+              # This list must not be empty and can have at the most 64 entries.
+            { # MetadataFilter label name value pairs that are expected
+                # to match corresponding labels presented as metadata to the load balancer.
+              "name": "A String", # Name of metadata label.
+                  #
+                  #  The name can have a maximum length of 1024 characters and must be at
+                  # least 1 character long.
+              "value": "A String", # The value of the label must match the specified value.
+                  #
+                  # value can have a maximum length of 1024 characters.
+            },
+          ],
+          "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+              # within the list of filterLabels and contributes toward the
+              # overall metadataFilter match.
+              #
+              #  Supported values are:
+              #
+              #    - MATCH_ANY: at least one of the filterLabels
+              #    must have a matching label in the provided metadata.
+              #    - MATCH_ALL: all filterLabels must have
+              #    matching labels in the provided metadata.
+        },
+      ],
+      "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.
+          #
+          # For Private Service Connect forwarding rules that forward traffic to Google
+          # APIs, the forwarding rule name must be a 1-20 characters string with
+          # lowercase letters and numbers and must start with a letter.
+          #
+          # For global external Passthrough Network Load Balancer forwarding rules, the
+          # forwarding rule name must be 1-43 characters long. For each global external
+          # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+          # rule) that you create, Google Cloud generates two output-only child
+          # forwarding rules that are named by concatenating the parent forwarding rule
+          # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+      "network": "A String", # This field is not used for global external load balancing.
+          #
+          # For internal passthrough Network Load Balancers, this field identifies the
+          # network that the load balanced IP should belong to for this forwarding
+          # rule.
+          # If the subnetwork is specified, the network of the subnetwork will be used.
+          # If neither subnetwork nor this field is specified, the default network will
+          # be used.
+          #
+          # For Private Service Connect forwarding rules that forward traffic to Google
+          # APIs, a network must be provided.
+      "networkTier": "A String", # This signifies the networking tier used for configuring
+          # this load balancer and can only take the following values:PREMIUM, STANDARD.
+          #
+          # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+          #
+          # If this field is not specified, it is assumed to be PREMIUM.
+          # If IPAddress is specified, this value must be equal to the
+          # networkTier of the Address.
+      "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+          # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+          # this field. Once set, this field is not mutable.
+      "portRange": "A String", # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The portRange field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, or SCTP, and
+          #    - It's applicable only to the following products: external passthrough
+          #    Network Load Balancers, internal and external proxy Network Load Balancers,
+          #    internal and external Application Load Balancers, external protocol
+          #    forwarding, and Classic VPN.
+          #    - Some products have restrictions on what ports can be used. See
+          #    port specifications for details.
+          #
+          #
+          #
+          # For external forwarding rules, two or more forwarding rules cannot use the
+          # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+          # fields) if they have overlapping portRanges.
+          #
+          # For internal forwarding rules within the same VPC network, two or more
+          # forwarding rules cannot use the same [IPAddress, IPProtocol]
+          # pair, and cannot have overlapping portRanges.
+          #
+          # @pattern: \\d+(?:-\\d+)?
+      "ports": [ # The ports, portRange, and allPorts
+          # fields are mutually exclusive. Only packets addressed to ports in the
+          # specified range will be forwarded to the backends configured with this
+          # forwarding rule.
+          #
+          # The ports field has the following limitations:
+          #
+          #    - It requires that the forwarding rule IPProtocol be TCP,
+          #    UDP, or SCTP, and
+          #    - It's applicable only to the following products: internal passthrough
+          #    Network Load Balancers, backend service-based external passthrough Network
+          #    Load Balancers, and internal protocol forwarding.
+          #    - You can specify a list of up to five ports by number, separated by
+          #    commas. The ports can be contiguous or discontiguous.
+          #
+          #
+          #
+          # For external forwarding rules, two or more forwarding rules cannot use the
+          # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+          # fields) if they share at least one port number.
+          #
+          # For internal forwarding rules within the same VPC network, two or more
+          # forwarding rules cannot use the same [IPAddress, IPProtocol]
+          # pair if they share at least one port number.
+          #
+          # @pattern: \\d+(?:-\\d+)?
+        "A String",
+      ],
+      "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+      "pscConnectionStatus": "A String",
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+          # This field is not applicable to global forwarding rules.
+          # 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.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+          # Currently, only supports a single Service Directory resource.
+        { # Describes the auto-registration of the forwarding rule to Service Directory.
+            # The region and project of the Service Directory resource generated from
+            # this registration will be the same as this forwarding rule.
+          "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+          "service": "A String", # Service Directory service to register the forwarding rule under.
+          "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+              # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+              # All PSC for Google APIs forwarding rules on the same network should use
+              # the same Service Directory region.
+        },
+      ],
+      "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+          # If specified, the prefix is the first label of the fully qualified service
+          # name.
+          #
+          # The label must be 1-63 characters long, and comply withRFC1035.
+          # Specifically, the label 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.
+          #
+          # This field is only used for internal load balancing.
+      "serviceName": "A String", # [Output Only]
+          # The internal fully qualified service name for this forwarding rule.
+          #
+          # This field is only used for internal load balancing.
+      "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+          # source IP address matches one of the IP addresses or CIDR ranges set here.
+          # Note that a forwarding rule can only have up to 64 source IP ranges, and
+          # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+          # Each source_ip_range entry should be either an IP address (for
+          # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+        "A String",
+      ],
+      "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+          # belong to for this forwarding rule, used with internal load balancers and
+          # external passthrough Network Load Balancers with IPv6.
+          #
+          # If the network specified is in auto subnet mode, this field is optional.
+          # However, a subnetwork must be specified if the network is in custom subnet
+          # mode or when creating external forwarding rule with IPv6.
+      "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+          # regional forwarding rules, this target must be in the same region as the
+          # forwarding rule. For global forwarding rules, this target must be a global
+          # load balancing resource.
+          #
+          # The forwarded traffic must be of a type appropriate to the target object.
+          #
+          #
+          #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+          #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+          #
+          #
+          #             -  vpc-sc -  APIs that support VPC Service Controls.
+          #             -  all-apis - All supported Google APIs.
+          #
+          #
+          #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+          #
+          #
+          #
+          # The following load balancers cannot set the target field (they should set the backendService field instead):
+          #
+          #    - Internal passthrough Network Load Balancers
+          #    - Backend service-based regional external passthrough Network Load
+          #    Balancers
+          #    - Global external passthrough Network Load Balancers
+    },
+  ],
+  "kind": "compute#forwardingRuleList", # 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.
+  "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, forwardingRule, body=None, requestId=None, x__xgafv=None) + 
Updates the specified forwarding rule with the data included in the
+request. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules. Currently, you can only
+patch the network_tier field.
+
+Args:
+  project: string, Project ID for this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Forwarding Rule resource.
+    # 
+    # Forwarding rule resources in Google Cloud can be either regional or global in
+    # scope:
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)
+    # 
+    # A forwarding rule and its corresponding IP address represent the frontend
+    # configuration of a Google Cloud load balancer.
+    # Forwarding rules can also reference target instances and Cloud VPN Classic
+    # gateways (targetVpnGateway).
+    # 
+    # For more information, read
+    # Forwarding rule concepts and
+    # Using protocol forwarding.
+  "IPAddress": "A String", # IP address for which this forwarding rule accepts traffic. When a client
+      # sends traffic to this IP address, the forwarding rule directs the traffic
+      # to the referenced target or backendService.
+      # While creating a forwarding rule, specifying an IPAddress is
+      # required under the following circumstances:
+      # 
+      # 
+      #    - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.
+      #    - When the target is a Private Service Connect Google APIs
+      #    bundle, you must specify an IPAddress.
+      # 
+      # 
+      # Otherwise, you can optionally specify an IP address that references an
+      # existing static (reserved) IP address resource. When omitted, Google Cloud
+      # assigns an ephemeral IP address.
+      # 
+      # Use one of the following formats to specify an IP address while creating a
+      # forwarding rule:
+      # 
+      # * IP address number, as in `100.1.2.3`
+      # * IPv6 address range, as in `2600:1234::/96`
+      # * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
+      # * Partial URL or by name, as in:
+      # 
+      #    - projects/project_id/regions/region/addresses/address-name
+      #    - regions/region/addresses/address-name
+      #    - global/addresses/address-name
+      #    - address-name
+      # 
+      # 
+      # 
+      # The IP address can only be set at creation. Once set, it cannot be updated.
+      # 
+      # The forwarding rule's target or backendService,
+      # and in most cases, also the loadBalancingScheme, determine the
+      # type of IP address that you can use. For detailed information, see
+      # [IP address
+      # specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      # 
+      # When reading an IPAddress, the API always returns the IP
+      # address number.
+      # 
+      # When creating a global external Passthrough Network Load Balancer
+      # forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child
+      # forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.
+  "IPProtocol": "A String", # The IP protocol to which this rule applies.
+      # 
+      # For protocol forwarding, valid
+      # options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.
+      # 
+      # The valid IP protocols are different for different load balancing products
+      # as described in [Load balancing
+      # features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).
+  "allPorts": True or False, # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The allPorts field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, SCTP, or L3_DEFAULT.
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal and external protocol forwarding.
+      #    - Set this field to true to allow packets addressed to any port or
+      #    packets lacking destination port information (for example, UDP fragments
+      #    after the first fragment) to be forwarded to the backends configured with
+      #    this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.
+  "allowGlobalAccess": True or False, # If set to true, clients can access the internal passthrough Network Load
+      # Balancers, the regional internal Application Load Balancer, and the
+      # regional internal proxy Network Load Balancer from all regions.
+      # If false, only allows access from the local region the load balancer is
+      # located at. Note that for INTERNAL_MANAGED forwarding rules, this field
+      # cannot be changed after the forwarding rule is created.
+  "allowPscGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC
+      # endpoint can be accessed from another region.
+  "attachedExtensions": [ # Output only. [Output Only]. The extensions that are attached to this ForwardingRule.
+    { # Reference to an extension resource that is attached to this ForwardingRule.
+      "reference": "A String", # Output only. The resource name.
+    },
+  ],
+  "backendService": "A String", # Identifies the backend service to which the forwarding rule sends traffic.
+      # 
+      # It is a required field for the following load balancers:
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+      # 
+      # 
+      # 
+      # It cannot be set by other load balancer types and protocol forwarding
+      # rules.
+  "baseForwardingRule": "A String", # Output only. [Output Only] The URL for the corresponding base forwarding rule. By base
+      # forwarding rule, we mean the forwarding rule that has the same IP address,
+      # protocol, and port settings with the current forwarding rule, but without
+      # sourceIPRanges specified.
+      # Always empty if the current forwarding rule does not have sourceIPRanges
+      # specified.
+  "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.
+  "externalManagedBackendBucketMigrationState": "A String", # Specifies the canary migration state for the backend buckets attached to
+      # this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and
+      # TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets
+      # attached to this forwarding rule by percentage using
+      # externalManagedBackendBucketMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedBackendBucketMigrationTestingPercentage": 3.14, # Determines the fraction of requests to backend buckets that should be
+      # processed by the global external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "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 ForwardingRule. Include the fingerprint in patch request to
+      # ensure that you do not overwrite changes that were applied from another
+      # concurrent request.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipCollection": "A String", # Resource reference of a PublicDelegatedPrefix. The PDP must
+      # be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating an IPv6
+      # NetLB forwarding rule using BYOIP:
+      # Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      # Partial URL, as in:
+      # 
+      #    - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipVersion": "A String", # The IP Version that will be used by this forwarding rule.  Valid options
+      # are IPV4 or IPV6.
+  "isMirroringCollector": True or False, # Indicates whether or not this load balancer can be used as a collector for
+      # packet mirroring. To prevent mirroring loops, instances behind this
+      # load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.
+      # This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.
+  "kind": "compute#forwardingRule", # Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this resource, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a ForwardingRule.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Specifies the forwarding rule type.
+      # 
+      # For more information, refer to
+      # Forwarding rule product and scheme table.
+  "metadataFilters": [ # Opaque filter criteria used by load balancer to restrict routing
+      # configuration to a limited set of xDS
+      # compliant clients. In their xDS requests to load balancer, xDS clients
+      # present node
+      # metadata. When there is a match, the relevant configuration
+      # is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)
+      # referenced by the ForwardingRule are not visible to
+      # those proxies.
+      # 
+      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+      # the metadata. If its filterMatchCriteria is set to
+      # MATCH_ALL, then all of its filterLabels must match with
+      # corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied
+      # in order to be considered a match.
+      # 
+      # metadataFilters specified here will be applifed before
+      # those specified in the UrlMap that thisForwardingRule references.
+      # 
+      # metadataFilters only applies to Loadbalancers that have
+      # their loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+    { # Opaque filter criteria used by load balancers to restrict routing
+        # configuration to a limited set of load balancing proxies. Proxies and
+        # sidecars involved in load balancing would typically present metadata to the
+        # load balancers that need to match criteria specified here. If a match takes
+        # place, the relevant configuration is made available to those
+        # proxies.
+        #
+        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+        # one of thefilterLabels must match the corresponding label provided in
+        # the metadata. If its filterMatchCriteria is set to
+        # MATCH_ALL, then all of its filterLabels must match with
+        # corresponding labels provided in the metadata.
+        #
+        # An example for using metadataFilters would be: if
+        # load balancing involves
+        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+          # metadata based on filterMatchCriteria
+          #
+          # This list must not be empty and can have at the most 64 entries.
+        { # MetadataFilter label name value pairs that are expected
+            # to match corresponding labels presented as metadata to the load balancer.
+          "name": "A String", # Name of metadata label.
+              #
+              #  The name can have a maximum length of 1024 characters and must be at
+              # least 1 character long.
+          "value": "A String", # The value of the label must match the specified value.
+              #
+              # value can have a maximum length of 1024 characters.
+        },
+      ],
+      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+          # within the list of filterLabels and contributes toward the
+          # overall metadataFilter match.
+          #
+          #  Supported values are:
+          #
+          #    - MATCH_ANY: at least one of the filterLabels
+          #    must have a matching label in the provided metadata.
+          #    - MATCH_ALL: all filterLabels must have
+          #    matching labels in the provided metadata.
+    },
+  ],
+  "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.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, the forwarding rule name must be a 1-20 characters string with
+      # lowercase letters and numbers and must start with a letter.
+      # 
+      # For global external Passthrough Network Load Balancer forwarding rules, the
+      # forwarding rule name must be 1-43 characters long. For each global external
+      # Passthrough Network Load Balancer forwarding rule (a parent forwarding
+      # rule) that you create, Google Cloud generates two output-only child
+      # forwarding rules that are named by concatenating the parent forwarding rule
+      # name with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.
+  "network": "A String", # This field is not used for global external load balancing.
+      # 
+      # For internal passthrough Network Load Balancers, this field identifies the
+      # network that the load balanced IP should belong to for this forwarding
+      # rule.
+      # If the subnetwork is specified, the network of the subnetwork will be used.
+      # If neither subnetwork nor this field is specified, the default network will
+      # be used.
+      # 
+      # For Private Service Connect forwarding rules that forward traffic to Google
+      # APIs, a network must be provided.
+  "networkTier": "A String", # This signifies the networking tier used for configuring
+      # this load balancer and can only take the following values:PREMIUM, STANDARD.
+      # 
+      # For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.
+      # 
+      # If this field is not specified, it is assumed to be PREMIUM.
+      # If IPAddress is specified, this value must be equal to the
+      # networkTier of the Address.
+  "noAutomateDnsZone": True or False, # This is used in PSC consumer ForwardingRule to control whether it should
+      # try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use
+      # this field. Once set, this field is not mutable.
+  "portRange": "A String", # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The portRange field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: external passthrough
+      #    Network Load Balancers, internal and external proxy Network Load Balancers,
+      #    internal and external Application Load Balancers, external protocol
+      #    forwarding, and Classic VPN.
+      #    - Some products have restrictions on what ports can be used. See
+      #    port specifications for details.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they have overlapping portRanges.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair, and cannot have overlapping portRanges.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+  "ports": [ # The ports, portRange, and allPorts
+      # fields are mutually exclusive. Only packets addressed to ports in the
+      # specified range will be forwarded to the backends configured with this
+      # forwarding rule.
+      # 
+      # The ports field has the following limitations:
+      # 
+      #    - It requires that the forwarding rule IPProtocol be TCP,
+      #    UDP, or SCTP, and
+      #    - It's applicable only to the following products: internal passthrough
+      #    Network Load Balancers, backend service-based external passthrough Network
+      #    Load Balancers, and internal protocol forwarding.
+      #    - You can specify a list of up to five ports by number, separated by
+      #    commas. The ports can be contiguous or discontiguous.
+      # 
+      # 
+      # 
+      # For external forwarding rules, two or more forwarding rules cannot use the
+      # same [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol
+      # fields) if they share at least one port number.
+      # 
+      # For internal forwarding rules within the same VPC network, two or more
+      # forwarding rules cannot use the same [IPAddress, IPProtocol]
+      # pair if they share at least one port number.
+      # 
+      # @pattern: \\d+(?:-\\d+)?
+    "A String",
+  ],
+  "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC forwarding rule.
+  "pscConnectionStatus": "A String",
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional forwarding rule resides.
+      # This field is not applicable to global forwarding rules.
+      # 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.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "serviceDirectoryRegistrations": [ # Service Directory resources to register this forwarding rule with.
+      # Currently, only supports a single Service Directory resource.
+    { # Describes the auto-registration of the forwarding rule to Service Directory.
+        # The region and project of the Service Directory resource generated from
+        # this registration will be the same as this forwarding rule.
+      "namespace": "A String", # Service Directory namespace to register the forwarding rule under.
+      "service": "A String", # Service Directory service to register the forwarding rule under.
+      "serviceDirectoryRegion": "A String", # [Optional] Service Directory region to register this global forwarding
+          # rule under. Default to "us-central1". Only used for PSC for Google APIs.
+          # All PSC for Google APIs forwarding rules on the same network should use
+          # the same Service Directory region.
+    },
+  ],
+  "serviceLabel": "A String", # An optional prefix to the service name for this forwarding rule.
+      # If specified, the prefix is the first label of the fully qualified service
+      # name.
+      # 
+      # The label must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the label 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.
+      # 
+      # This field is only used for internal load balancing.
+  "serviceName": "A String", # [Output Only]
+      # The internal fully qualified service name for this forwarding rule.
+      # 
+      # This field is only used for internal load balancing.
+  "sourceIpRanges": [ # If not empty, this forwarding rule will only forward the traffic when the
+      # source IP address matches one of the IP addresses or CIDR ranges set here.
+      # Note that a forwarding rule can only have up to 64 source IP ranges, and
+      # this field can only be used with a regional forwarding rule whose scheme isEXTERNAL.
+      # Each source_ip_range entry should be either an IP address (for
+      # example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
+    "A String",
+  ],
+  "subnetwork": "A String", # This field identifies the subnetwork that the load balanced IP should
+      # belong to for this forwarding rule, used with internal load balancers and
+      # external passthrough Network Load Balancers with IPv6.
+      # 
+      # If the network specified is in auto subnet mode, this field is optional.
+      # However, a subnetwork must be specified if the network is in custom subnet
+      # mode or when creating external forwarding rule with IPv6.
+  "target": "A String", # The URL of the target resource to receive the matched traffic.  For
+      # regional forwarding rules, this target must be in the same region as the
+      # forwarding rule. For global forwarding rules, this target must be a global
+      # load balancing resource.
+      # 
+      # The forwarded traffic must be of a type appropriate to the target object.
+      # 
+      # 
+      #      -  For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).
+      #      -  For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
+      # 
+      # 
+      #             -  vpc-sc -  APIs that support VPC Service Controls.
+      #             -  all-apis - All supported Google APIs.
+      # 
+      # 
+      #      -  For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment.
+      # 
+      # 
+      # 
+      # The following load balancers cannot set the target field (they should set the backendService field instead):
+      # 
+      #    - Internal passthrough Network Load Balancers
+      #    - Backend service-based regional external passthrough Network Load
+      #    Balancers
+      #    - Global external passthrough Network Load Balancers
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on the specified resource. To learn more about labels,
+read the 
+Labeling resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setTarget(project, forwardingRule, body=None, requestId=None, x__xgafv=None) + 
Changes target URL for the GlobalForwardingRule resource. The new target
+should be of the same type as the old target.
+
+Args:
+  project: string, Project ID for this request. (required)
+  forwardingRule: string, Name of the ForwardingRule resource in which target is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "target": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalFrontendSettings.html b/docs/dyn/compute_preview.globalFrontendSettings.html new file mode 100644 index 0000000000..3658f13de6 --- /dev/null +++ b/docs/dyn/compute_preview.globalFrontendSettings.html @@ -0,0 +1,435 @@ + + + +

Compute Engine API . globalFrontendSettings

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, x__xgafv=None)

+

Gets the Global Frontend Billing Bundle Settings for a project.

+

+ patch(project, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates the Global Frontend Billing Bundle Settings for a project.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, x__xgafv=None) + 
Gets the Global Frontend Billing Bundle Settings for a project.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents the Global Frontend Bundle settings for a single project.
+  "bundleType": "A String", # Customer-settable bundle type.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # Output only. [Output Only] An optional description of this resource.
+  "etag": "A String", # Output only. For optimistic locking.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "name": "A String", # Output only. OUTPUT_ONLY fields
+      # [Output Only] Name of the resource. 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.
+}
+
+ +
+ patch(project, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the Global Frontend Billing Bundle Settings for a project.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents the Global Frontend Bundle settings for a single project.
+  "bundleType": "A String", # Customer-settable bundle type.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # Output only. [Output Only] An optional description of this resource.
+  "etag": "A String", # Output only. For optimistic locking.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "name": "A String", # Output only. OUTPUT_ONLY fields
+      # [Output Only] Name of the resource. 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.
+}
+
+  requestId: string, An optional request ID to identify requests.
+  updateMask: string, Field mask to support patch. E.g., "type".
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to an UpdateGlobalFrontendSettingsRequest.
+  "operation": { # Represents an Operation resource. # The Operation resource for this long-running operation.
+      #
+      # 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.
+        { # Represents a single error encountered during the processing of an
+            # 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.
+            { # Container for structured error details providing additional context
+                # specific to the encountered error code.
+              "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                  #
+                  # 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. # Links and information to help the user resolve the error.
+                  #
+                  # 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 # A localized human-readable error message intended for end users.
+                  # 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. # Details about quota limits and metrics when a quota is exceeded.
+                "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.
+        },
+      ],
+    },
+    "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+      "healthInfo": { # Health information. # Output only. The health information.
+        "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+        "healthStatus": "A String", # Output only. The health status.
+        "repairCategory": "A String", # Output only. The repair category.
+        "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+        "updateTime": "A String", # Output only. The time when health info was updated.
+      },
+    },
+    "getVersionOperationMetadata": {
+      "inlineSbomInfo": {
+        "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+            # appropriate identifiers.
+          "a_key": "A String",
+        },
+        "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+            # identifiers.
+          "a_key": "A String",
+        },
+      },
+    },
+    "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.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalNetworkEndpointGroups.html b/docs/dyn/compute_preview.globalNetworkEndpointGroups.html new file mode 100644 index 0000000000..a4f2fc925e --- /dev/null +++ b/docs/dyn/compute_preview.globalNetworkEndpointGroups.html @@ -0,0 +1,2296 @@ + + + +

Compute Engine API . globalNetworkEndpointGroups

+

Instance Methods

+

+ attachNetworkEndpoints(project, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Attach a network endpoint to the specified network endpoint group.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, networkEndpointGroup, requestId=None, x__xgafv=None)

+

Deletes the specified network endpoint group.Note that the NEG cannot be

+

+ detachNetworkEndpoints(project, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Detach the network endpoint from the specified network endpoint group.

+

+ get(project, networkEndpointGroup, x__xgafv=None)

+

Returns the specified network endpoint group.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a network endpoint group in the specified project using the

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of network endpoint groups that are located in the

+

+ listNetworkEndpoints(project, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the network endpoints in the specified network endpoint group.

+

+ listNetworkEndpoints_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ attachNetworkEndpoints(project, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Attach a network endpoint to the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkEndpointGroup: string, The name of the network endpoint group where you are attaching network
+endpoints to. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be attached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, networkEndpointGroup, requestId=None, x__xgafv=None) + 
Deletes the specified network endpoint group.Note that the NEG cannot be
+deleted if there are backend services referencing it.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkEndpointGroup: string, The name of the network endpoint group to delete. It should comply with
+RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ detachNetworkEndpoints(project, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Detach the network endpoint from the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkEndpointGroup: string, The name of the network endpoint group where you are removing network
+endpoints. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be detached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, networkEndpointGroup, x__xgafv=None) + 
Returns the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkEndpointGroup: string, The name of the network endpoint group. It should comply with RFC1035. (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 collection of network endpoints.
+    #
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    #
+    # Note: Use the following APIs to manage network endpoint groups:
+    #
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      #
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      #
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a network endpoint group in the specified project using the
+parameters that are included in the request.
+
+Note: Use the following APIs to manage network endpoint groups:
+   
+   - 
+   To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+   NEGs): zonal
+   API
+   - 
+   To manage NEGs with regional scope (such as regional internet NEGs,
+   serverless NEGs, Private Service Connect NEGs): regional
+   API
+   - 
+   To manage NEGs with global scope (such as global internet NEGs):global
+   API
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a collection of network endpoints.
+    # 
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    # 
+    # Note: Use the following APIs to manage network endpoint groups:
+    # 
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      # 
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      # 
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of network endpoint groups that are located in 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.
+  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 NetworkEndpointGroup resources.
+    { # Represents a collection of network endpoints.
+        #
+        # A network endpoint group (NEG) defines how a set of endpoints should be
+        # reached, whether they are reachable, and where they are located.
+        # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+        #
+        # Note: Use the following APIs to manage network endpoint groups:
+        #
+        #    -
+        #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+        #    NEGs): zonal
+        #    API
+        #    -
+        #    To manage NEGs with regional scope (such as regional internet NEGs,
+        #    serverless NEGs, Private Service Connect NEGs): regional
+        #    API
+        #    -
+        #    To manage NEGs with global scope (such as global internet NEGs):global
+        #    API
+      "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+        "a_key": "A String",
+      },
+      "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service is optional, may be provided explicitly or in the
+          # URL mask. The version is optional and can only be provided
+          # explicitly or in the URL mask when service is present.
+          #
+          # Note: App Engine service must be in the same project and located in the
+          # same region as the Serverless NEG.
+        "service": "A String", # Optional serving service.
+            #
+            # The service name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: default, my-service.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse service and version fields
+            # from a request URL. URL mask allows for routing to multiple App Engine
+            # services without having to create multiple Network Endpoint Groups and
+            # backend services.
+            #
+            # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+            # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+            # The URL mask will parse them to { service = "foo1", version = "v1"
+            # } and { service = "foo1", version = "v2" }
+            # respectively.
+        "version": "A String", # Optional serving version.
+            #
+            # The version name is case-sensitive and must be 1-100
+            # characters long.
+            #
+            # Example value: v1, v2.
+      },
+      "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The function must be provided explicitly or in the URL mask.
+          #
+          # Note: Cloud Function must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "function": "A String", # A user-defined name of the Cloud Function.
+            #
+            # The function name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: func1.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse function field from a request URL. URL
+            # mask allows for routing to multiple Cloud Functions without having to
+            # create multiple Network Endpoint Groups and backend services.
+            #
+            # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+            # Serverless NEG with URL mask /<function>. The URL
+            # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+      },
+      "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service must be provided explicitly or in the URL mask.
+          # The tag is optional, may be provided explicitly or in the URL
+          # mask.
+          #
+          # Note: Cloud Run service must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+            #
+            # The service must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "run-service".
+        "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+            # fine-grained traffic routing information.
+            #
+            # The tag must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "revision-0010".
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+            # routing to multiple Run services without having to create multiple
+            # network endpoint groups and backend services.
+            #
+            # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+            # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+            # parse them to { service="bar1", tag="foo1" } and {
+            # service="bar2", tag="foo2" } respectively.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultPort": 42, # The default port used if the port number is not specified in the network
+          # endpoint.
+          #
+          # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+          # field must not be specified.
+      "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+      "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+          # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+          # if this field is not specified, a default network will be used.
+          # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+          # global NEGs.
+          # For all other network endpoint types, this field is required.
+      "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+      "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+          # type PRIVATE_SERVICE_CONNECT.
+        "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+            # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+            # L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+            # the PSC Producer side; should only be used for the
+            # PRIVATE_SERVICE_CONNECT NEG type
+        "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+            # Consumer.
+        "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+      },
+      "pscTargetService": "A String", # The target service url used to set up private service connection to
+          # a Google API or a PSC Producer Service Attachment.
+          # An example value is: asia-northeast3-cloudkms.googleapis.com.
+          #
+          # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the network endpoint group is located.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+      "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+          # belong.
+      "zone": "A String", # Output only. [Output Only] The URL of thezone
+          # where the network endpoint group is located.
+    },
+  ],
+  "kind": "compute#networkEndpointGroupList", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group
+      # lists.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints(project, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the network endpoints in the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkEndpointGroup: string, The name of the network endpoint group from which you want to generate a
+list of included network endpoints. It should comply with 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.
+  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 NetworkEndpointWithHealthStatus resources.
+    {
+      "healths": [ # Output only. [Output only] The health status of network endpoint.
+          #
+          # Optional. Displayed only if the network endpoint has centralized health
+          # checking configured.
+        {
+          "backendService": { # URL of the backend service associated with the health state of the network
+              # endpoint.
+            "backendService": "A String",
+          },
+          "forwardingRule": { # URL of the forwarding rule associated with the health state of the network
+              # endpoint.
+            "forwardingRule": "A String",
+          },
+          "healthCheck": { # A full or valid partial URL to a health check. For example, the following are # URL of the health check associated with the health state of the network
+              # endpoint.
+              # valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+              #    - projects/project-id/global/httpHealthChecks/health-check
+              #    - global/httpHealthChecks/health-check
+            "healthCheck": "A String",
+          },
+          "healthCheckService": { # A full or valid partial URL to a health check service. For example, the # URL of the health check service associated with the health state of the
+              # network endpoint.
+              # following are valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - regions/us-west1/healthCheckServices/health-check-service
+            "healthCheckService": "A String",
+          },
+          "healthState": "A String", # Health state of the network endpoint determined based on the health checks
+              # configured.
+          "ipv6HealthState": "A String", # Health state of the ipv6 network endpoint determined based on the health
+              # checks configured.
+        },
+      ],
+      "networkEndpoint": { # The network endpoint. # Output only. [Output only] The network endpoint.
+        "annotations": { # Optional metadata defined as annotations on the network endpoint.
+          "a_key": "A String",
+        },
+        "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+            #
+            # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+        "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+            # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+        "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+            # Optional, the field presence depends on the network endpoint type. The
+            # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+            #
+            # The instance must be in the same zone of network endpoint group (for zonal
+            # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+            # If the ipAddress is specified, it must belongs to the VM
+            # instance.
+            #
+            # The name must be 1-63 characters long, and comply withRFC1035
+            # or be a valid URL pointing to an existing instance.
+        "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+            # VM in Compute Engine (either the primary IP or as part of an aliased IP
+            # range). If the IP address is not specified, then the primary IP address for
+            # the VM instance in the network that the network endpoint group belongs to
+            # will be used.
+            #
+            # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+            # address of the attached VM instance that matches the subnetwork of the NEG.
+            # The primary internal IP address from any NIC of a multi-NIC VM instance can
+            # be added to a NEG as long as it matches the NEG subnetwork.
+        "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+        "port": 42, # Optional port number of network endpoint. If not specified, the
+            # defaultPort for the network endpoint group will be used.
+            #
+            # This field can not be set for network endpoints of typeGCE_VM_IP.
+      },
+    },
+  ],
+  "kind": "compute#networkEndpointGroupsListNetworkEndpoints", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list
+      # of network endpoints in the specified network endpoint group.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints_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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalOperations.html b/docs/dyn/compute_preview.globalOperations.html new file mode 100644 index 0000000000..c8fcdfd081 --- /dev/null +++ b/docs/dyn/compute_preview.globalOperations.html @@ -0,0 +1,1605 @@ + + + +

Compute Engine API . globalOperations

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of all operations.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, operation, x__xgafv=None)

+

Deletes the specified Operations resource.

+

+ get(project, operation, x__xgafv=None)

+

Retrieves the specified Operations resource.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of Operation resources contained within the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ wait(project, operation, x__xgafv=None)

+

Waits for the specified Operation resource to return as `DONE`

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of all operations.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": { # [Output Only] A map of scoped operation lists.
+    "a_key": { # [Output Only] Name of the scope containing this set of operations.
+      "operations": [ # [Output Only] A list of operations contained in this scope.
+        { # 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.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+            "healthInfo": { # Health information. # Output only. The health information.
+              "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+              "healthStatus": "A String", # Output only. The health status.
+              "repairCategory": "A String", # Output only. The repair category.
+              "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+              "updateTime": "A String", # Output only. The time when health info was updated.
+            },
+          },
+          "getVersionOperationMetadata": {
+            "inlineSbomInfo": {
+              "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+                  # appropriate identifiers.
+                "a_key": "A String",
+              },
+              "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+                  # identifiers.
+                "a_key": "A String",
+              },
+            },
+          },
+          "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.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of operations
+          # 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#operationAggregatedList", # Output only. [Output Only] Type of resource. Always `compute#operationAggregatedList`
+      # for aggregated lists of operations.
+  "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 than
+      # `maxResults`, 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.
+  "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, operation, x__xgafv=None) + 
Deletes the specified Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  operation: string, Name of the Operations resource to delete, or its unique numeric
+identifier. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ get(project, operation, x__xgafv=None) + 
Retrieves the specified Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of Operation 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.
+  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 Operation resources.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of Operation resources.
+    { # 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.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+      "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+        "healthInfo": { # Health information. # Output only. The health information.
+          "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+          "healthStatus": "A String", # Output only. The health status.
+          "repairCategory": "A String", # Output only. The repair category.
+          "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+          "updateTime": "A String", # Output only. The time when health info was updated.
+        },
+      },
+      "getVersionOperationMetadata": {
+        "inlineSbomInfo": {
+          "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+              # appropriate identifiers.
+            "a_key": "A String",
+          },
+          "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+              # identifiers.
+            "a_key": "A String",
+          },
+        },
+      },
+      "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.
+    },
+  ],
+  "kind": "compute#operationList", # Output only. [Output Only] Type of resource. Always `compute#operations` for Operations
+      # 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 than
+      # `maxResults`, 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.
+
+
+ +
+ wait(project, operation, x__xgafv=None) + 
Waits for the specified Operation resource to return as `DONE`
+or for the request to approach the 2 minute deadline, and retrieves the
+specified Operation resource. This method differs from the
+`GET` method in that it waits for no more than the default
+deadline (2 minutes) and then returns the current state of the operation,
+which might be `DONE` or still in progress.
+
+This method is called on a best-effort basis. Specifically:
+   
+   
+    - In uncommon cases, when the server is overloaded, the request might
+    return before the default deadline is reached, or might return after zero
+    seconds.
+   - If the default deadline is reached, there is no guarantee that the
+    operation is actually done when the method returns. Be prepared to retry
+    if the operation is not `DONE`.
+
+Args:
+  project: string, Project ID for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalOrganizationOperations.html b/docs/dyn/compute_preview.globalOrganizationOperations.html new file mode 100644 index 0000000000..662a140a4c --- /dev/null +++ b/docs/dyn/compute_preview.globalOrganizationOperations.html @@ -0,0 +1,826 @@ + + + +

Compute Engine API . globalOrganizationOperations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(operation, parentId=None, x__xgafv=None)

+

Deletes the specified Operations resource.

+

+ get(operation, parentId=None, x__xgafv=None)

+

Retrieves the specified Operations resource. Gets a list of operations

+

+ list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None)

+

Retrieves a list of Operation resources contained within the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(operation, parentId=None, x__xgafv=None) + 
Deletes the specified Operations resource.
+
+Args:
+  operation: string, Name of the Operations resource to delete, or its unique numeric
+identifier. (required)
+  parentId: string, Parent ID for this request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ get(operation, parentId=None, x__xgafv=None) + 
Retrieves the specified Operations resource. Gets a list of operations
+by making a `list()` request.
+
+Args:
+  operation: string, Name of the Operations resource to return. Parent is derived from this
+field. (required)
+  parentId: string, Parent ID for this request. Not used. Parent is derived from resource_id.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None) + 
Retrieves a list of Operation resources contained within the specified
+organization.
+
+Args:
+  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.
+  parentId: string, Parent ID for this request.
+  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 Operation resources.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of Operation resources.
+    { # 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.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+      "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+        "healthInfo": { # Health information. # Output only. The health information.
+          "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+          "healthStatus": "A String", # Output only. The health status.
+          "repairCategory": "A String", # Output only. The repair category.
+          "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+          "updateTime": "A String", # Output only. The time when health info was updated.
+        },
+      },
+      "getVersionOperationMetadata": {
+        "inlineSbomInfo": {
+          "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+              # appropriate identifiers.
+            "a_key": "A String",
+          },
+          "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+              # identifiers.
+            "a_key": "A String",
+          },
+        },
+      },
+      "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.
+    },
+  ],
+  "kind": "compute#operationList", # Output only. [Output Only] Type of resource. Always `compute#operations` for Operations
+      # 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 than
+      # `maxResults`, 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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalPublicDelegatedPrefixes.html b/docs/dyn/compute_preview.globalPublicDelegatedPrefixes.html new file mode 100644 index 0000000000..74bfbf9eec --- /dev/null +++ b/docs/dyn/compute_preview.globalPublicDelegatedPrefixes.html @@ -0,0 +1,1510 @@ + + + +

Compute Engine API . globalPublicDelegatedPrefixes

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, publicDelegatedPrefix, requestId=None, x__xgafv=None)

+

Deletes the specified global PublicDelegatedPrefix.

+

+ get(project, publicDelegatedPrefix, x__xgafv=None)

+

Returns the specified global PublicDelegatedPrefix resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a global PublicDelegatedPrefix in the specified project using the

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the global PublicDelegatedPrefixes for a project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

+

Patches the specified global PublicDelegatedPrefix resource with the data

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, publicDelegatedPrefix, requestId=None, x__xgafv=None) + 
Deletes the specified global PublicDelegatedPrefix.
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, publicDelegatedPrefix, x__xgafv=None) + 
Returns the specified global PublicDelegatedPrefix resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix 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:
+
+    { # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      #
+      #
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a global PublicDelegatedPrefix in the specified project using the
+parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      # 
+      # 
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the global PublicDelegatedPrefixes for a 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.
+  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 PublicDelegatedPrefix resources.
+    { # A PublicDelegatedPrefix resource represents an IP block within a
+        # PublicAdvertisedPrefix that is configured within a single cloud scope
+        # (global or region). IPs in the block can be allocated to resources within
+        # that scope. Public delegated prefixes may be further broken up into
+        # smaller IP blocks in the same scope as the parent block.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+          # This field is optional and cannot be set for prefixes in DELEGATION mode.
+          # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+      "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+      "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.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "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 new PublicDelegatedPrefix. An up-to-date
+          # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+          # error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a PublicDelegatedPrefix.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+          # Inherited from parent prefix.
+      "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+      "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+      "mode": "A String", # The public delegated prefix mode for IPv6 only.
+      "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.
+      "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+          # PublicDelegatedPrefix.
+      "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+          # delegated prefix.
+        { # Represents a sub PublicDelegatedPrefix.
+          "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+          "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+              # Applicable for IPv4 PDPs only.
+          "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+              # delegated prefix.
+          "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+              # Prefixes. Inherited from parent prefix.
+          "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+              # delegatee project.
+          "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+          "name": "A String", # The name of the sub public delegated prefix.
+          "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+              # regional. If absent, the sub prefix is global.
+          "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+          # This field applies only to the region 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.
+      "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+          # of following values:
+          #
+          #
+          #      - `INITIALIZING` The public delegated prefix is being initialized and
+          #      addresses cannot be created yet.
+          #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+          #      prefix and is active.
+          #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+          #      use.
+          #      - `DELETING` The public delegated prefix is being deprovsioned.
+          #      - `ACTIVE` The public delegated prefix is ready to use.
+    },
+  ],
+  "kind": "compute#publicDelegatedPrefixList", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated
+      # prefixes.
+  "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, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None) + 
Patches the specified global PublicDelegatedPrefix 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)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      # 
+      # 
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.globalVmExtensionPolicies.html b/docs/dyn/compute_preview.globalVmExtensionPolicies.html new file mode 100644 index 0000000000..cabef2e4d7 --- /dev/null +++ b/docs/dyn/compute_preview.globalVmExtensionPolicies.html @@ -0,0 +1,1978 @@ + + + +

Compute Engine API . globalVmExtensionPolicies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all VM Extension Policy resources

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

+

Purge scoped resources (zonal policies) from a global VM extension

+

+ get(project, globalVmExtensionPolicy, x__xgafv=None)

+

Gets details of a global VM extension policy.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a new project level GlobalVmExtensionPolicy.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists global VM extension policies.

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

+

Updates a global VM extension policy.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all VM Extension Policy resources
+available to the specified project.
+
+To prevent failure, it's 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.
+  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:
+
+    { # Response for the aggregated list of VM extension policies.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of VmExtensionPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of VmExtensionPolicies.
+      "vmExtensionPolicies": [ # List of VmExtensionPolicy resources contained in this scope.
+        { # Represents a VM extension policy.
+          "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 (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.
+              "stringConfig": "A String", # Optional. String-based configuration data for the extension.
+            },
+          },
+          "globalResourceLink": "A String", # Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if
+              # applicable.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instanceSelectors": [ # Optional. Selectors to target VMs for this policy. VMs are selected if they match
+              # *any* of the provided selectors (logical OR). If this list is empty, the
+              # policy applies to all VMs.
+            { # Defines how to select VMs to apply a zone VM extension policy.
+              "labelSelector": { # A LabelSelector is applied to a VM only if it matches all the specified # Optional. LabelSelector selects VMs based on their labels.
+                  # labels.
+                "inclusionLabels": { # Optional. A map of key-value pairs representing VM labels.
+                    # VMs must have all of the labels specified in this map to be selected
+                    # (logical AND).
+                    #
+                    # e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2",
+                    # "value2")}, the VM labels must contain both ("key1", "value1") and
+                    # ("key2", "value2") to be selected. If the VM labels are ("key1",
+                    # "value1") and ("something", "else"), it will not be selected.
+                    #
+                    # If the map is empty, it's considered a match.
+                  "a_key": "A String",
+                },
+              },
+            },
+          ],
+          "kind": "compute#vmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.
+          "managedByGlobal": True or False, # Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.
+          "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.
+          "priority": 42, # Optional. Priority of this policy. Used to resolve conflicts when multiple policies
+              # apply to the same extension.
+              # 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 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.
+          "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+              # text format.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#VmExtensionPolicyAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#VmExtensionPolicyAggregatedList for lists of
+      # VmExtensionPolicies.
+  "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, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None) + 
Purge scoped resources (zonal policies) from a global VM extension
+policy, and then delete the global VM extension policy. Purge of the scoped
+resources is a pre-condition of the global VM extension policy deletion.
+The deletion of the global VM extension policy happens after the purge
+rollout is done, so it's not a part of the LRO. It's an automatic process
+that triggers in the backend.
+
+Args:
+  project: string, Project ID for this request. (required)
+  globalVmExtensionPolicy: string, Name of the global VM extension policy to purge scoped resources for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "conflictBehavior": "A String", # Optional. Specifies the behavior of the rollout if a conflict is detected in a
+      # project during a rollout. This only applies to `insert` and `update`
+      # methods.
+      # 
+      # A conflict occurs in the following cases:
+      # 
+      # * `insert` method: If the zonal policy already exists when the insert
+      #   happens.
+      # * `update` method: If the zonal policy was modified by a zonal API call
+      #   outside of this rollout.
+      # 
+      # Possible values are the following:
+      # 
+      # * `""` (empty string): If a conflict occurs, the local value is not
+      #   overwritten. This is the default behavior.
+      # * `"overwrite"`: If a conflict occurs, the local value is overwritten
+      #   with the rollout value.
+  "name": "A String", # Optional. The name of the rollout plan.
+      # Ex.
+      # projects//locations/global/rolloutPlans/.
+  "predefinedRolloutPlan": "A String", # Optional. Specifies the predefined rollout plan for the policy. Valid values
+      # are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is
+      # `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout
+      # plans for global policies.
+  "retryUuid": "A String", # Optional. The UUID that identifies a policy rollout retry attempt for update and
+      # delete operations. Set this field only when retrying a rollout for an
+      # existing extension policy.
+      # 
+      # * `update` method: Lets you retry policy rollout without changes.
+      # An error occurs if you set retry_uuid but the policy is modified.
+      # * `delete` method: Lets you retry policy deletion rollout if the
+      # previous deletion rollout is not finished and the policy is in the
+      # DELETING state. If you set this field when the policy is not in the
+      # DELETING state, an error occurs.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, globalVmExtensionPolicy, x__xgafv=None) + 
Gets details of a global VM extension policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  globalVmExtensionPolicy: string, Name of the GlobalVmExtensionPolicy 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:
+
+    { # Message describing GlobalVmExtensionPolicy object.
+  "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.
+  "extensionPolicies": { # Required. Map from extension (eg: "cloudops") to its policy configuration.
+      # The key is the name of the extension.
+    "a_key": { # Policy for a single extension.
+      "pinnedVersion": "A String", # Optional. The version pinning for the extension.
+          # If empty, the extension will be installed with the latest version
+          # released by the extension producer.
+      "stringConfig": "A String", # Optional. String configuration. Any string payload that the extension
+          # understands.
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selector to target VMs for a policy.
+      # There is a logical "AND" between instance_selectors.
+    { # Selector to target VMs for a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applicable for a VM only if it matches all labels in # Optional. Labels within the LabelSelector are OR'd.
+          # the LabelSelector.
+        "inclusionLabels": { # Optional. Labels as key value pairs.
+            # A VM should contain all the pairs specified in this map to be selected;
+            # Labels within the LabelSelector are OR'ed.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#globalVmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.
+  "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.
+  "priority": 42, # Optional. Used to resolve conflicts when multiple policies are active for the same
+      # extension. Defaults to 0.
+      #
+      # Larger the number, higher the priority. When the priority is the same,
+      # the policy with the newer create time has higher priority.
+  "rolloutOperation": { # Represents the rollout operation # Required. The rollout strategy and status.
+    "rolloutInput": { # Required. The rollout input which defines the rollout plan.
+      "conflictBehavior": "A String", # Optional. Specifies the behavior of the rollout if a conflict is detected in a
+          # project during a rollout. This only applies to `insert` and `update`
+          # methods.
+          #
+          # A conflict occurs in the following cases:
+          #
+          # * `insert` method: If the zonal policy already exists when the insert
+          #   happens.
+          # * `update` method: If the zonal policy was modified by a zonal API call
+          #   outside of this rollout.
+          #
+          # Possible values are the following:
+          #
+          # * `""` (empty string): If a conflict occurs, the local value is not
+          #   overwritten. This is the default behavior.
+          # * `"overwrite"`: If a conflict occurs, the local value is overwritten
+          #   with the rollout value.
+      "name": "A String", # Optional. The name of the rollout plan.
+          # Ex.
+          # projects//locations/global/rolloutPlans/.
+      "predefinedRolloutPlan": "A String", # Optional. Specifies the predefined rollout plan for the policy. Valid values
+          # are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is
+          # `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout
+          # plans for global policies.
+      "retryUuid": "A String", # Optional. The UUID that identifies a policy rollout retry attempt for update and
+          # delete operations. Set this field only when retrying a rollout for an
+          # existing extension policy.
+          #
+          # * `update` method: Lets you retry policy rollout without changes.
+          # An error occurs if you set retry_uuid but the policy is modified.
+          # * `delete` method: Lets you retry policy deletion rollout if the
+          # previous deletion rollout is not finished and the policy is in the
+          # DELETING state. If you set this field when the policy is not in the
+          # DELETING state, an error occurs.
+    },
+    "rolloutStatus": { # Output only. [Output Only] The rollout status of the policy.
+      "currentRollouts": [ # Output only. [Output Only] The current rollouts for the latest version of the
+          # resource. There should be only one current rollout, but for
+          # scalability, we make it repeated.
+        {
+          "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+              # locations is the same as the list of locations in the rollout plan.
+            "a_key": {
+              "state": "A String", # Output only. [Output Only] The state of the location rollout.
+            },
+          },
+          "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+              # Ex. projects//locations/global/rollouts/.
+          "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+              # Ex.
+              # projects//locations/global/rolloutPlans/.
+          "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+        },
+      ],
+      "previousRollout": { # Output only. [Output Only] The last completed rollout resource. This field will not
+          # be populated until the first rollout is completed.
+        "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+            # locations is the same as the list of locations in the rollout plan.
+          "a_key": {
+            "state": "A String", # Output only. [Output Only] The state of the location rollout.
+          },
+        },
+        "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+            # Ex. projects//locations/global/rollouts/.
+        "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+            # Ex.
+            # projects//locations/global/rolloutPlans/.
+        "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+      },
+    },
+  },
+  "scopedResourceStatus": "A String", # Output only. [Output Only] The scoped resource status. It's only for tracking the
+      # purging status of the policy.
+  "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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a new project level GlobalVmExtensionPolicy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message describing GlobalVmExtensionPolicy object.
+  "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.
+  "extensionPolicies": { # Required. Map from extension (eg: "cloudops") to its policy configuration.
+      # The key is the name of the extension.
+    "a_key": { # Policy for a single extension.
+      "pinnedVersion": "A String", # Optional. The version pinning for the extension.
+          # If empty, the extension will be installed with the latest version
+          # released by the extension producer.
+      "stringConfig": "A String", # Optional. String configuration. Any string payload that the extension
+          # understands.
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selector to target VMs for a policy.
+      # There is a logical "AND" between instance_selectors.
+    { # Selector to target VMs for a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applicable for a VM only if it matches all labels in # Optional. Labels within the LabelSelector are OR'd.
+          # the LabelSelector.
+        "inclusionLabels": { # Optional. Labels as key value pairs.
+            # A VM should contain all the pairs specified in this map to be selected;
+            # Labels within the LabelSelector are OR'ed.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#globalVmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.
+  "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.
+  "priority": 42, # Optional. Used to resolve conflicts when multiple policies are active for the same
+      # extension. Defaults to 0.
+      # 
+      # Larger the number, higher the priority. When the priority is the same,
+      # the policy with the newer create time has higher priority.
+  "rolloutOperation": { # Represents the rollout operation # Required. The rollout strategy and status.
+    "rolloutInput": { # Required. The rollout input which defines the rollout plan.
+      "conflictBehavior": "A String", # Optional. Specifies the behavior of the rollout if a conflict is detected in a
+          # project during a rollout. This only applies to `insert` and `update`
+          # methods.
+          #
+          # A conflict occurs in the following cases:
+          #
+          # * `insert` method: If the zonal policy already exists when the insert
+          #   happens.
+          # * `update` method: If the zonal policy was modified by a zonal API call
+          #   outside of this rollout.
+          #
+          # Possible values are the following:
+          #
+          # * `""` (empty string): If a conflict occurs, the local value is not
+          #   overwritten. This is the default behavior.
+          # * `"overwrite"`: If a conflict occurs, the local value is overwritten
+          #   with the rollout value.
+      "name": "A String", # Optional. The name of the rollout plan.
+          # Ex.
+          # projects//locations/global/rolloutPlans/.
+      "predefinedRolloutPlan": "A String", # Optional. Specifies the predefined rollout plan for the policy. Valid values
+          # are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is
+          # `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout
+          # plans for global policies.
+      "retryUuid": "A String", # Optional. The UUID that identifies a policy rollout retry attempt for update and
+          # delete operations. Set this field only when retrying a rollout for an
+          # existing extension policy.
+          #
+          # * `update` method: Lets you retry policy rollout without changes.
+          # An error occurs if you set retry_uuid but the policy is modified.
+          # * `delete` method: Lets you retry policy deletion rollout if the
+          # previous deletion rollout is not finished and the policy is in the
+          # DELETING state. If you set this field when the policy is not in the
+          # DELETING state, an error occurs.
+    },
+    "rolloutStatus": { # Output only. [Output Only] The rollout status of the policy.
+      "currentRollouts": [ # Output only. [Output Only] The current rollouts for the latest version of the
+          # resource. There should be only one current rollout, but for
+          # scalability, we make it repeated.
+        {
+          "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+              # locations is the same as the list of locations in the rollout plan.
+            "a_key": {
+              "state": "A String", # Output only. [Output Only] The state of the location rollout.
+            },
+          },
+          "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+              # Ex. projects//locations/global/rollouts/.
+          "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+              # Ex.
+              # projects//locations/global/rolloutPlans/.
+          "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+        },
+      ],
+      "previousRollout": { # Output only. [Output Only] The last completed rollout resource. This field will not
+          # be populated until the first rollout is completed.
+        "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+            # locations is the same as the list of locations in the rollout plan.
+          "a_key": {
+            "state": "A String", # Output only. [Output Only] The state of the location rollout.
+          },
+        },
+        "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+            # Ex. projects//locations/global/rollouts/.
+        "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+            # Ex.
+            # projects//locations/global/rolloutPlans/.
+        "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+      },
+    },
+  },
+  "scopedResourceStatus": "A String", # Output only. [Output Only] The scoped resource status. It's only for tracking the
+      # purging status of the policy.
+  "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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists global VM extension policies.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to list global VM extension policy resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of GlobalVmExtensionPolicy resources.
+    { # Message describing GlobalVmExtensionPolicy object.
+      "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.
+      "extensionPolicies": { # Required. Map from extension (eg: "cloudops") to its policy configuration.
+          # The key is the name of the extension.
+        "a_key": { # Policy for a single extension.
+          "pinnedVersion": "A String", # Optional. The version pinning for the extension.
+              # If empty, the extension will be installed with the latest version
+              # released by the extension producer.
+          "stringConfig": "A String", # Optional. String configuration. Any string payload that the extension
+              # understands.
+        },
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instanceSelectors": [ # Optional. Selector to target VMs for a policy.
+          # There is a logical "AND" between instance_selectors.
+        { # Selector to target VMs for a zone VM extension policy.
+          "labelSelector": { # A LabelSelector is applicable for a VM only if it matches all labels in # Optional. Labels within the LabelSelector are OR'd.
+              # the LabelSelector.
+            "inclusionLabels": { # Optional. Labels as key value pairs.
+                # A VM should contain all the pairs specified in this map to be selected;
+                # Labels within the LabelSelector are OR'ed.
+              "a_key": "A String",
+            },
+          },
+        },
+      ],
+      "kind": "compute#globalVmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.
+      "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.
+      "priority": 42, # Optional. Used to resolve conflicts when multiple policies are active for the same
+          # extension. Defaults to 0.
+          #
+          # Larger the number, higher the priority. When the priority is the same,
+          # the policy with the newer create time has higher priority.
+      "rolloutOperation": { # Represents the rollout operation # Required. The rollout strategy and status.
+        "rolloutInput": { # Required. The rollout input which defines the rollout plan.
+          "conflictBehavior": "A String", # Optional. Specifies the behavior of the rollout if a conflict is detected in a
+              # project during a rollout. This only applies to `insert` and `update`
+              # methods.
+              #
+              # A conflict occurs in the following cases:
+              #
+              # * `insert` method: If the zonal policy already exists when the insert
+              #   happens.
+              # * `update` method: If the zonal policy was modified by a zonal API call
+              #   outside of this rollout.
+              #
+              # Possible values are the following:
+              #
+              # * `""` (empty string): If a conflict occurs, the local value is not
+              #   overwritten. This is the default behavior.
+              # * `"overwrite"`: If a conflict occurs, the local value is overwritten
+              #   with the rollout value.
+          "name": "A String", # Optional. The name of the rollout plan.
+              # Ex.
+              # projects//locations/global/rolloutPlans/.
+          "predefinedRolloutPlan": "A String", # Optional. Specifies the predefined rollout plan for the policy. Valid values
+              # are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is
+              # `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout
+              # plans for global policies.
+          "retryUuid": "A String", # Optional. The UUID that identifies a policy rollout retry attempt for update and
+              # delete operations. Set this field only when retrying a rollout for an
+              # existing extension policy.
+              #
+              # * `update` method: Lets you retry policy rollout without changes.
+              # An error occurs if you set retry_uuid but the policy is modified.
+              # * `delete` method: Lets you retry policy deletion rollout if the
+              # previous deletion rollout is not finished and the policy is in the
+              # DELETING state. If you set this field when the policy is not in the
+              # DELETING state, an error occurs.
+        },
+        "rolloutStatus": { # Output only. [Output Only] The rollout status of the policy.
+          "currentRollouts": [ # Output only. [Output Only] The current rollouts for the latest version of the
+              # resource. There should be only one current rollout, but for
+              # scalability, we make it repeated.
+            {
+              "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+                  # locations is the same as the list of locations in the rollout plan.
+                "a_key": {
+                  "state": "A String", # Output only. [Output Only] The state of the location rollout.
+                },
+              },
+              "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+                  # Ex. projects//locations/global/rollouts/.
+              "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+                  # Ex.
+                  # projects//locations/global/rolloutPlans/.
+              "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+            },
+          ],
+          "previousRollout": { # Output only. [Output Only] The last completed rollout resource. This field will not
+              # be populated until the first rollout is completed.
+            "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+                # locations is the same as the list of locations in the rollout plan.
+              "a_key": {
+                "state": "A String", # Output only. [Output Only] The state of the location rollout.
+              },
+            },
+            "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+                # Ex. projects//locations/global/rollouts/.
+            "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+                # Ex.
+                # projects//locations/global/rolloutPlans/.
+            "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+          },
+        },
+      },
+      "scopedResourceStatus": "A String", # Output only. [Output Only] The scoped resource status. It's only for tracking the
+          # purging status of the policy.
+      "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.
+      "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+          # text format.
+    },
+  ],
+  "kind": "compute#globalVmExtensionPolicyList", # 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.
+  },
+}
+
+ +
+ 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.
+
+
+ +
+ update(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None) + 
Updates a global VM extension policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  globalVmExtensionPolicy: string, Name of the global VM extension policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message describing GlobalVmExtensionPolicy object.
+  "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.
+  "extensionPolicies": { # Required. Map from extension (eg: "cloudops") to its policy configuration.
+      # The key is the name of the extension.
+    "a_key": { # Policy for a single extension.
+      "pinnedVersion": "A String", # Optional. The version pinning for the extension.
+          # If empty, the extension will be installed with the latest version
+          # released by the extension producer.
+      "stringConfig": "A String", # Optional. String configuration. Any string payload that the extension
+          # understands.
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selector to target VMs for a policy.
+      # There is a logical "AND" between instance_selectors.
+    { # Selector to target VMs for a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applicable for a VM only if it matches all labels in # Optional. Labels within the LabelSelector are OR'd.
+          # the LabelSelector.
+        "inclusionLabels": { # Optional. Labels as key value pairs.
+            # A VM should contain all the pairs specified in this map to be selected;
+            # Labels within the LabelSelector are OR'ed.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#globalVmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.
+  "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.
+  "priority": 42, # Optional. Used to resolve conflicts when multiple policies are active for the same
+      # extension. Defaults to 0.
+      # 
+      # Larger the number, higher the priority. When the priority is the same,
+      # the policy with the newer create time has higher priority.
+  "rolloutOperation": { # Represents the rollout operation # Required. The rollout strategy and status.
+    "rolloutInput": { # Required. The rollout input which defines the rollout plan.
+      "conflictBehavior": "A String", # Optional. Specifies the behavior of the rollout if a conflict is detected in a
+          # project during a rollout. This only applies to `insert` and `update`
+          # methods.
+          #
+          # A conflict occurs in the following cases:
+          #
+          # * `insert` method: If the zonal policy already exists when the insert
+          #   happens.
+          # * `update` method: If the zonal policy was modified by a zonal API call
+          #   outside of this rollout.
+          #
+          # Possible values are the following:
+          #
+          # * `""` (empty string): If a conflict occurs, the local value is not
+          #   overwritten. This is the default behavior.
+          # * `"overwrite"`: If a conflict occurs, the local value is overwritten
+          #   with the rollout value.
+      "name": "A String", # Optional. The name of the rollout plan.
+          # Ex.
+          # projects//locations/global/rolloutPlans/.
+      "predefinedRolloutPlan": "A String", # Optional. Specifies the predefined rollout plan for the policy. Valid values
+          # are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is
+          # `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout
+          # plans for global policies.
+      "retryUuid": "A String", # Optional. The UUID that identifies a policy rollout retry attempt for update and
+          # delete operations. Set this field only when retrying a rollout for an
+          # existing extension policy.
+          #
+          # * `update` method: Lets you retry policy rollout without changes.
+          # An error occurs if you set retry_uuid but the policy is modified.
+          # * `delete` method: Lets you retry policy deletion rollout if the
+          # previous deletion rollout is not finished and the policy is in the
+          # DELETING state. If you set this field when the policy is not in the
+          # DELETING state, an error occurs.
+    },
+    "rolloutStatus": { # Output only. [Output Only] The rollout status of the policy.
+      "currentRollouts": [ # Output only. [Output Only] The current rollouts for the latest version of the
+          # resource. There should be only one current rollout, but for
+          # scalability, we make it repeated.
+        {
+          "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+              # locations is the same as the list of locations in the rollout plan.
+            "a_key": {
+              "state": "A String", # Output only. [Output Only] The state of the location rollout.
+            },
+          },
+          "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+              # Ex. projects//locations/global/rollouts/.
+          "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+              # Ex.
+              # projects//locations/global/rolloutPlans/.
+          "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+        },
+      ],
+      "previousRollout": { # Output only. [Output Only] The last completed rollout resource. This field will not
+          # be populated until the first rollout is completed.
+        "locationRolloutStatus": { # Output only. [Output Only] The rollout status for each location. The list of the
+            # locations is the same as the list of locations in the rollout plan.
+          "a_key": {
+            "state": "A String", # Output only. [Output Only] The state of the location rollout.
+          },
+        },
+        "rollout": "A String", # Output only. [Output Only] The name of the rollout.
+            # Ex. projects//locations/global/rollouts/.
+        "rolloutPlan": "A String", # Output only. [Output Only] The name of the rollout plan.
+            # Ex.
+            # projects//locations/global/rolloutPlans/.
+        "state": "A String", # Output only. [Output Only] The overall state of the rollout.
+      },
+    },
+  },
+  "scopedResourceStatus": "A String", # Output only. [Output Only] The scoped resource status. It's only for tracking the
+      # purging status of the policy.
+  "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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.haControllers.html b/docs/dyn/compute_preview.haControllers.html new file mode 100644 index 0000000000..f2dac7bd9b --- /dev/null +++ b/docs/dyn/compute_preview.haControllers.html @@ -0,0 +1,3852 @@ + + + +

Compute Engine API . haControllers

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of all of the HaControllers in the specified

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, haController, force=None, requestId=None, x__xgafv=None)

+

Deletes an HaController in the specified project.

+

+ failover(project, region, haController, body=None, requestId=None, x__xgafv=None)

+

Fails over a VM targeted by the specified HaController to the selected

+

+ get(project, region, haController, x__xgafv=None)

+

Returns all the details of a specific HaController.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates HaController in the specified project.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all HaControllers in the specified project in the specified region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, haController, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates HaController in the specified project.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of all of the HaControllers in the specified
+project across all regions.
+
+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.
+  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.
+  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:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HaControllersScopedList resources.
+    "a_key": { # Name of the scope containing this set of ha controllers.
+      "haControllers": [ # List of HaControllers contained in this scope.
+        { # HaController handles failover for a VM Instance.
+          "backendServices": [ # Advanced configuration option. If specified, these Backend Services need to
+              # be pre-created.
+              #
+              # Currently, only one backend service can be specified, and it must be L4
+              # Internal Load Balancer (ILB).
+            "A String",
+          ],
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "failoverInitiation": "A String", # Indicates how failover should be initiated.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instanceName": "A String", # Name of the instance that HaController is in charge of.
+              # If not specified the HaController's resource name will be used instead.
+              # 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.
+          "kind": "compute#HaController", # Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.
+          "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.
+          "networkingAutoConfiguration": { # Basic networking configuration. Required backend services and forwarding # Basic networking configuration. Required backend services and forwarding
+              # rules will be automatically created with default parameters.
+              # rules will be automatically created with default parameters.
+            "internal": { # Internal networking configuration # Internal networking configuration
+              "ipAddress": "A String", # Optional. IP addresses will be automatically allocated according to
+                  # StackType if not provided.
+              "ipv6Address": "A String",
+              "stackType": "A String", # Determine which IP addresses to automatically create. Field and option
+                  # naming consistent with NetworkInterface configuration on Instances.
+            },
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the resource 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. [Output only] Server-defined URL for the resource.
+          "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+          "state": "A String", # Output only. The current state of the HA Controller.
+          "status": { # Contains information about current status of the HaController. # Output only. [Output Only] Status information for the HaController resource.
+            "failoverProgress": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the ongoing failover. This message
+                # is not displayed if failover is NOT in progress.
+              "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+                  # Filled only if the failover is completed, in lastFailoverInfo.
+              "failoverDuration": "A String", # Output only. The duration of the last failover.
+              "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+                  # manually.
+              "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+              "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+                  # is filled only if the current failover is failing
+                "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+                    # failover.
+                  "errors": [ # [Output Only] The array of errors encountered while processing this
+                      # operation.
+                    { # Represents a single error encountered during the processing of an
+                        # 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.
+                        { # Container for structured error details providing additional context
+                            # specific to the encountered error code.
+                          "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                              #
+                              # 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. # Links and information to help the user resolve the error.
+                              #
+                              # 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 # A localized human-readable error message intended for end users.
+                              # 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. # Details about quota limits and metrics when a quota is exceeded.
+                            "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.
+                    },
+                  ],
+                },
+                "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                    # text format.
+              },
+            },
+            "lastFailoverInfo": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the last successful failover.
+              "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+                  # Filled only if the failover is completed, in lastFailoverInfo.
+              "failoverDuration": "A String", # Output only. The duration of the last failover.
+              "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+                  # manually.
+              "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+              "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+                  # is filled only if the current failover is failing
+                "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+                    # failover.
+                  "errors": [ # [Output Only] The array of errors encountered while processing this
+                      # operation.
+                    { # Represents a single error encountered during the processing of an
+                        # 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.
+                        { # Container for structured error details providing additional context
+                            # specific to the encountered error code.
+                          "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                              #
+                              # 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. # Links and information to help the user resolve the error.
+                              #
+                              # 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 # A localized human-readable error message intended for end users.
+                              # 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. # Details about quota limits and metrics when a quota is exceeded.
+                            "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.
+                    },
+                  ],
+                },
+                "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                    # text format.
+              },
+            },
+            "ongoingFailover": True or False, # Output only. [Output Only]  Indicates if the failover is currently in-progress.
+            "primaryInstance": "A String", # Output only. [Output Only] The URL to the instance that is intended to be primary at
+                # this moment. Primary instance will be changed at the very beginning of a
+                # failover operation.
+            "primaryZone": "A String", # Output only. [Output Only] The name of the zone that is intended to be primary at this
+                # moment. Primary zone will be changed at the very beginning of a failover
+                # operation. The zone may not be operational in the middle of a failover
+                # operation.
+            "readyForFailover": True or False, # Output only. [Output Only] Indicates if the resource is ready for initiating a
+                # failover to the secondary zone.
+            "zoneStatus": { # Output only. [Output Only] Map of zone statuses.
+                # Key: name of the zone
+                # Value: ZoneStatus
+              "a_key": { # Contains the status of a specific zone.
+                "isPrimary": True or False, # Output only. [Output Only] Indicates if the zone is primary at this moment.
+                "isZoneReady": True or False, # Output only. [Output Only] Indicates if the zone is ready for initiating a failover.
+                "lastError": { # Contains details of the last failed operation. # Output only. [Output Only] This field is filled only if the current operation is
+                    # failing.
+                  "errors": { # Output only. [Output Only] Encountered errors.
+                    "errors": [ # [Output Only] The array of errors encountered while processing this
+                        # operation.
+                      { # Represents a single error encountered during the processing of an
+                          # 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.
+                          { # Container for structured error details providing additional context
+                              # specific to the encountered error code.
+                            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                                #
+                                # 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. # Links and information to help the user resolve the error.
+                                #
+                                # 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 # A localized human-readable error message intended for end users.
+                                # 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. # Details about quota limits and metrics when a quota is exceeded.
+                              "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.
+                      },
+                    ],
+                  },
+                  "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                      # text format.
+                },
+              },
+            },
+          },
+          "zoneConfigurations": { # Map of zone configurations
+              # Key: name of the zone
+              # Value: ZoneConfiguration
+            "a_key": { # Config for a zone that the HaController may use for running the VM
+                # instance.
+              "nodeAffinities": [ # A set of node affinity configurations. Refer toConfiguring node
+                  # affinity for more information.
+                  # Overrides reservationAffinity.
+                { # Node Affinity: the configuration of desired nodes onto which the
+                    #  Instance could be scheduled.
+                    #  This message should be an exact copy of the Instances representation
+                    #  of NodeAffinity.
+                  "key": "A String", # Corresponds to the label key of Node resource.
+                  "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+                  "values": [ # Corresponds to the label values of Node resource.
+                    "A String",
+                  ],
+                },
+              ],
+              "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that the instance can consume from.
+                  # This message should be an exact copy of the Instances representation
+                  # of AllocationAffinity.
+                "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+                    # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+                    # Consuming reserved instances for examples.
+                "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+                    # the name of your reservation as its value.
+                "values": [ # Corresponds to the label values of a reservation resource. This can be
+                    # either a name to a reservation in the same project or
+                    # "projects/different-project/reservations/some-reservation-name" to
+                    # target a shared reservation in the same zone but in a different
+                    # project.
+                  "A String",
+                ],
+              },
+            },
+          },
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#haControllersAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#haControllersAggregatedList for lists of
+      # HaControllers.
+  "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, haController, force=None, requestId=None, x__xgafv=None) + 
Deletes an HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, Name of the HaController resource to delete. (required)
+  force: boolean, Force-deletes HA Controller when the Delete is stuck. Instance that is not
+primary at the moment will also be deleted. Can only be used against the HA
+Controller resource that is already being deleted.
+  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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ failover(project, region, haController, body=None, requestId=None, x__xgafv=None) + 
Fails over a VM targeted by the specified HaController to the selected
+zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, ID of the HaController resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "failoverToZone": "A String", # Name of the destination zone for the failover.
+}
+
+  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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, haController, x__xgafv=None) + 
Returns all the details of a specific HaController.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, Name of the HaController 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:
+
+    { # HaController handles failover for a VM Instance.
+  "backendServices": [ # Advanced configuration option. If specified, these Backend Services need to
+      # be pre-created.
+      #
+      # Currently, only one backend service can be specified, and it must be L4
+      # Internal Load Balancer (ILB).
+    "A String",
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of.
+      # If not specified the HaController's resource name will be used instead.
+      # 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.
+  "kind": "compute#HaController", # Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.
+  "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.
+  "networkingAutoConfiguration": { # Basic networking configuration. Required backend services and forwarding # Basic networking configuration. Required backend services and forwarding
+      # rules will be automatically created with default parameters.
+      # rules will be automatically created with default parameters.
+    "internal": { # Internal networking configuration # Internal networking configuration
+      "ipAddress": "A String", # Optional. IP addresses will be automatically allocated according to
+          # StackType if not provided.
+      "ipv6Address": "A String",
+      "stackType": "A String", # Determine which IP addresses to automatically create. Field and option
+          # naming consistent with NetworkInterface configuration on Instances.
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource 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. [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. The current state of the HA Controller.
+  "status": { # Contains information about current status of the HaController. # Output only. [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the ongoing failover. This message
+        # is not displayed if failover is NOT in progress.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "lastFailoverInfo": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the last successful failover.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "ongoingFailover": True or False, # Output only. [Output Only]  Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # Output only. [Output Only] The URL to the instance that is intended to be primary at
+        # this moment. Primary instance will be changed at the very beginning of a
+        # failover operation.
+    "primaryZone": "A String", # Output only. [Output Only] The name of the zone that is intended to be primary at this
+        # moment. Primary zone will be changed at the very beginning of a failover
+        # operation. The zone may not be operational in the middle of a failover
+        # operation.
+    "readyForFailover": True or False, # Output only. [Output Only] Indicates if the resource is ready for initiating a
+        # failover to the secondary zone.
+    "zoneStatus": { # Output only. [Output Only] Map of zone statuses.
+        # Key: name of the zone
+        # Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # Output only. [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # Output only. [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # Output only. [Output Only] This field is filled only if the current operation is
+            # failing.
+          "errors": { # Output only. [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+              # text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations
+      # Key: name of the zone
+      # Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM
+        # instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the
+            #  Instance could be scheduled.
+            #  This message should be an exact copy of the Instances representation
+            #  of NodeAffinity.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that the instance can consume from.
+          # This message should be an exact copy of the Instances representation
+          # of AllocationAffinity.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+            # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+            # Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+            # the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be
+            # either a name to a reservation in the same project or
+            # "projects/different-project/reservations/some-reservation-name" to
+            # target a shared reservation in the same zone but in a different
+            # project.
+          "A String",
+        ],
+      },
+    },
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # HaController handles failover for a VM Instance.
+  "backendServices": [ # Advanced configuration option. If specified, these Backend Services need to
+      # be pre-created.
+      # 
+      # Currently, only one backend service can be specified, and it must be L4
+      # Internal Load Balancer (ILB).
+    "A String",
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of.
+      # If not specified the HaController's resource name will be used instead.
+      # 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.
+  "kind": "compute#HaController", # Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.
+  "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.
+  "networkingAutoConfiguration": { # Basic networking configuration. Required backend services and forwarding # Basic networking configuration. Required backend services and forwarding
+      # rules will be automatically created with default parameters.
+      # rules will be automatically created with default parameters.
+    "internal": { # Internal networking configuration # Internal networking configuration
+      "ipAddress": "A String", # Optional. IP addresses will be automatically allocated according to
+          # StackType if not provided.
+      "ipv6Address": "A String",
+      "stackType": "A String", # Determine which IP addresses to automatically create. Field and option
+          # naming consistent with NetworkInterface configuration on Instances.
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource 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. [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. The current state of the HA Controller.
+  "status": { # Contains information about current status of the HaController. # Output only. [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the ongoing failover. This message
+        # is not displayed if failover is NOT in progress.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "lastFailoverInfo": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the last successful failover.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "ongoingFailover": True or False, # Output only. [Output Only]  Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # Output only. [Output Only] The URL to the instance that is intended to be primary at
+        # this moment. Primary instance will be changed at the very beginning of a
+        # failover operation.
+    "primaryZone": "A String", # Output only. [Output Only] The name of the zone that is intended to be primary at this
+        # moment. Primary zone will be changed at the very beginning of a failover
+        # operation. The zone may not be operational in the middle of a failover
+        # operation.
+    "readyForFailover": True or False, # Output only. [Output Only] Indicates if the resource is ready for initiating a
+        # failover to the secondary zone.
+    "zoneStatus": { # Output only. [Output Only] Map of zone statuses.
+        # Key: name of the zone
+        # Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # Output only. [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # Output only. [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # Output only. [Output Only] This field is filled only if the current operation is
+            # failing.
+          "errors": { # Output only. [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+              # text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations
+      # Key: name of the zone
+      # Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM
+        # instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the
+            #  Instance could be scheduled.
+            #  This message should be an exact copy of the Instances representation
+            #  of NodeAffinity.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that the instance can consume from.
+          # This message should be an exact copy of the Instances representation
+          # of AllocationAffinity.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+            # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+            # Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+            # the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be
+            # either a name to a reservation in the same project or
+            # "projects/different-project/reservations/some-reservation-name" to
+            # target a shared reservation in the same zone but in a different
+            # project.
+          "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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all HaControllers in the specified project in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HaControllers in the specified project and region.
+    { # HaController handles failover for a VM Instance.
+      "backendServices": [ # Advanced configuration option. If specified, these Backend Services need to
+          # be pre-created.
+          #
+          # Currently, only one backend service can be specified, and it must be L4
+          # Internal Load Balancer (ILB).
+        "A String",
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failoverInitiation": "A String", # Indicates how failover should be initiated.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instanceName": "A String", # Name of the instance that HaController is in charge of.
+          # If not specified the HaController's resource name will be used instead.
+          # 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.
+      "kind": "compute#HaController", # Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.
+      "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.
+      "networkingAutoConfiguration": { # Basic networking configuration. Required backend services and forwarding # Basic networking configuration. Required backend services and forwarding
+          # rules will be automatically created with default parameters.
+          # rules will be automatically created with default parameters.
+        "internal": { # Internal networking configuration # Internal networking configuration
+          "ipAddress": "A String", # Optional. IP addresses will be automatically allocated according to
+              # StackType if not provided.
+          "ipv6Address": "A String",
+          "stackType": "A String", # Determine which IP addresses to automatically create. Field and option
+              # naming consistent with NetworkInterface configuration on Instances.
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the resource 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. [Output only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "state": "A String", # Output only. The current state of the HA Controller.
+      "status": { # Contains information about current status of the HaController. # Output only. [Output Only] Status information for the HaController resource.
+        "failoverProgress": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the ongoing failover. This message
+            # is not displayed if failover is NOT in progress.
+          "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+              # Filled only if the failover is completed, in lastFailoverInfo.
+          "failoverDuration": "A String", # Output only. The duration of the last failover.
+          "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+              # manually.
+          "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+          "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+              # is filled only if the current failover is failing
+            "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+                # failover.
+              "errors": [ # [Output Only] The array of errors encountered while processing this
+                  # operation.
+                { # Represents a single error encountered during the processing of an
+                    # 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.
+                    { # Container for structured error details providing additional context
+                        # specific to the encountered error code.
+                      "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                          #
+                          # 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. # Links and information to help the user resolve the error.
+                          #
+                          # 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 # A localized human-readable error message intended for end users.
+                          # 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. # Details about quota limits and metrics when a quota is exceeded.
+                        "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.
+                },
+              ],
+            },
+            "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                # text format.
+          },
+        },
+        "lastFailoverInfo": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the last successful failover.
+          "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+              # Filled only if the failover is completed, in lastFailoverInfo.
+          "failoverDuration": "A String", # Output only. The duration of the last failover.
+          "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+              # manually.
+          "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+          "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+              # is filled only if the current failover is failing
+            "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+                # failover.
+              "errors": [ # [Output Only] The array of errors encountered while processing this
+                  # operation.
+                { # Represents a single error encountered during the processing of an
+                    # 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.
+                    { # Container for structured error details providing additional context
+                        # specific to the encountered error code.
+                      "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                          #
+                          # 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. # Links and information to help the user resolve the error.
+                          #
+                          # 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 # A localized human-readable error message intended for end users.
+                          # 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. # Details about quota limits and metrics when a quota is exceeded.
+                        "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.
+                },
+              ],
+            },
+            "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                # text format.
+          },
+        },
+        "ongoingFailover": True or False, # Output only. [Output Only]  Indicates if the failover is currently in-progress.
+        "primaryInstance": "A String", # Output only. [Output Only] The URL to the instance that is intended to be primary at
+            # this moment. Primary instance will be changed at the very beginning of a
+            # failover operation.
+        "primaryZone": "A String", # Output only. [Output Only] The name of the zone that is intended to be primary at this
+            # moment. Primary zone will be changed at the very beginning of a failover
+            # operation. The zone may not be operational in the middle of a failover
+            # operation.
+        "readyForFailover": True or False, # Output only. [Output Only] Indicates if the resource is ready for initiating a
+            # failover to the secondary zone.
+        "zoneStatus": { # Output only. [Output Only] Map of zone statuses.
+            # Key: name of the zone
+            # Value: ZoneStatus
+          "a_key": { # Contains the status of a specific zone.
+            "isPrimary": True or False, # Output only. [Output Only] Indicates if the zone is primary at this moment.
+            "isZoneReady": True or False, # Output only. [Output Only] Indicates if the zone is ready for initiating a failover.
+            "lastError": { # Contains details of the last failed operation. # Output only. [Output Only] This field is filled only if the current operation is
+                # failing.
+              "errors": { # Output only. [Output Only] Encountered errors.
+                "errors": [ # [Output Only] The array of errors encountered while processing this
+                    # operation.
+                  { # Represents a single error encountered during the processing of an
+                      # 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.
+                      { # Container for structured error details providing additional context
+                          # specific to the encountered error code.
+                        "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                            #
+                            # 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. # Links and information to help the user resolve the error.
+                            #
+                            # 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 # A localized human-readable error message intended for end users.
+                            # 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. # Details about quota limits and metrics when a quota is exceeded.
+                          "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.
+                  },
+                ],
+              },
+              "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+                  # text format.
+            },
+          },
+        },
+      },
+      "zoneConfigurations": { # Map of zone configurations
+          # Key: name of the zone
+          # Value: ZoneConfiguration
+        "a_key": { # Config for a zone that the HaController may use for running the VM
+            # instance.
+          "nodeAffinities": [ # A set of node affinity configurations. Refer toConfiguring node
+              # affinity for more information.
+              # Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which the
+                #  Instance could be scheduled.
+                #  This message should be an exact copy of the Instances representation
+                #  of NodeAffinity.
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that the instance can consume from.
+              # This message should be an exact copy of the Instances representation
+              # of AllocationAffinity.
+            "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+                # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+                # Consuming reserved instances for examples.
+            "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+                # the name of your reservation as its value.
+            "values": [ # Corresponds to the label values of a reservation resource. This can be
+                # either a name to a reservation in the same project or
+                # "projects/different-project/reservations/some-reservation-name" to
+                # target a shared reservation in the same zone but in a different
+                # project.
+              "A String",
+            ],
+          },
+        },
+      },
+    },
+  ],
+  "nextPageToken": "A String", # This token allows you to get the next page of results formaxResults, 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": { # 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, haController, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, ID of the HaController resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # HaController handles failover for a VM Instance.
+  "backendServices": [ # Advanced configuration option. If specified, these Backend Services need to
+      # be pre-created.
+      # 
+      # Currently, only one backend service can be specified, and it must be L4
+      # Internal Load Balancer (ILB).
+    "A String",
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of.
+      # If not specified the HaController's resource name will be used instead.
+      # 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.
+  "kind": "compute#HaController", # Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.
+  "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.
+  "networkingAutoConfiguration": { # Basic networking configuration. Required backend services and forwarding # Basic networking configuration. Required backend services and forwarding
+      # rules will be automatically created with default parameters.
+      # rules will be automatically created with default parameters.
+    "internal": { # Internal networking configuration # Internal networking configuration
+      "ipAddress": "A String", # Optional. IP addresses will be automatically allocated according to
+          # StackType if not provided.
+      "ipv6Address": "A String",
+      "stackType": "A String", # Determine which IP addresses to automatically create. Field and option
+          # naming consistent with NetworkInterface configuration on Instances.
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource 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. [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. The current state of the HA Controller.
+  "status": { # Contains information about current status of the HaController. # Output only. [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the ongoing failover. This message
+        # is not displayed if failover is NOT in progress.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "lastFailoverInfo": { # Contains information about the current failover operation. # Output only. [Output Only] Contains the details of the last successful failover.
+      "failoverCompleteTimestamp": "A String", # Output only. [Output Only] Timestamp of the failover completion.
+          # Filled only if the failover is completed, in lastFailoverInfo.
+      "failoverDuration": "A String", # Output only. The duration of the last failover.
+      "failoverTrigger": "A String", # Output only. [Output Only] Indicates if failover has been triggered automatically or
+          # manually.
+      "failoverTriggerTimestamp": "A String", # Output only. [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # Output only. [Output Only] Contains details of the last failed failover. This field
+          # is filled only if the current failover is failing
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to process
+            # failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+            # text format.
+      },
+    },
+    "ongoingFailover": True or False, # Output only. [Output Only]  Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # Output only. [Output Only] The URL to the instance that is intended to be primary at
+        # this moment. Primary instance will be changed at the very beginning of a
+        # failover operation.
+    "primaryZone": "A String", # Output only. [Output Only] The name of the zone that is intended to be primary at this
+        # moment. Primary zone will be changed at the very beginning of a failover
+        # operation. The zone may not be operational in the middle of a failover
+        # operation.
+    "readyForFailover": True or False, # Output only. [Output Only] Indicates if the resource is ready for initiating a
+        # failover to the secondary zone.
+    "zoneStatus": { # Output only. [Output Only] Map of zone statuses.
+        # Key: name of the zone
+        # Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # Output only. [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # Output only. [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # Output only. [Output Only] This field is filled only if the current operation is
+            # failing.
+          "errors": { # Output only. [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. [Output Only] Show timestamp only if there is an error.RFC3339
+              # text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations
+      # Key: name of the zone
+      # Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM
+        # instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the
+            #  Instance could be scheduled.
+            #  This message should be an exact copy of the Instances representation
+            #  of NodeAffinity.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that the instance can consume from.
+          # This message should be an exact copy of the Instances representation
+          # of AllocationAffinity.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+            # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+            # Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+            # the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be
+            # either a name to a reservation in the same project or
+            # "projects/different-project/reservations/some-reservation-name" to
+            # target a shared reservation in the same zone but in a different
+            # project.
+          "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.
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.healthChecks.html b/docs/dyn/compute_preview.healthChecks.html new file mode 100644 index 0000000000..30079a0289 --- /dev/null +++ b/docs/dyn/compute_preview.healthChecks.html @@ -0,0 +1,3817 @@ + + + +

Compute Engine API . healthChecks

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all HealthCheck resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, healthCheck, requestId=None, x__xgafv=None)

+

Deletes the specified HealthCheck resource.

+

+ get(project, healthCheck, x__xgafv=None)

+

Returns the specified HealthCheck resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a HealthCheck resource in the specified project using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of HealthCheck resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, healthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HealthCheck resource in the specified project using the data

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, healthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HealthCheck resource in the specified project using the data

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all HealthCheck resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HealthChecksScopedList resources.
+    "a_key": { # Name of the scope containing this set of HealthChecks.
+      "healthChecks": [ # A list of HealthChecks contained in this scope.
+        { # Represents a health check resource.
+            #
+            # Google Compute Engine has two health check resources:
+            #
+            # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+            # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+            #
+            # These health check resources can be used for load balancing and for
+            # autohealing VMs in a managed instance group (MIG).
+            #
+            # **Load balancing**
+            #
+            # Health check requirements vary depending on the type of load balancer. For
+            # details about the type of health check supported for
+            # each load balancer and corresponding backend type,
+            # see Health
+            # checks overview: Load balancer guide.
+            #
+            # **Autohealing in MIGs**
+            #
+            # The health checks that you use for autohealing VMs in a MIG can be either
+            # regional or global. For more information, see  Set up an
+            # application health check and autohealing.
+            #
+            # For more information, seeHealth checks
+            # overview.
+          "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+              # seconds.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "grpcHealthCheck": {
+            "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+                # value of grpc_service_name has the following meanings by convention:
+                #
+                # - Empty service_name means the overall status of all services at the
+                # backend.
+                #
+                # - Non-empty service_name means the health of that gRPC service, as defined
+                # by the owner of the service.
+                #
+                # The grpc_service_name can only be ASCII.
+            "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+                # values are 1 through 65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                #  USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+          },
+          "grpcTlsHealthCheck": {
+            "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+                # value of grpc_service_name has the following meanings by convention:
+                #
+                # - Empty service_name means the overall status of all services at the
+                # backend.
+                #
+                # - Non-empty service_name means the health of that gRPC service, as defined
+                # by the owner of the service.
+                #
+                # The grpc_service_name can only be ASCII.
+            "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+                # values are 1 through 65535.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                #  USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+          },
+          "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+              # many consecutive successes. The default value is 2.
+          "http2HealthCheck": {
+            "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+                # empty (default value), the host header is set to the destination IP address
+                # to which health check packets are sent. The destination IP address depends
+                # on the type of load balancer. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+            "port": 42, # The TCP port number to which the health check prober sends packets. The
+                # default value is 443. Valid values are 1 through65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                #  USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+                # backend, either NONE or PROXY_V1. The default
+                # is NONE.
+            "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+            "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+                # HTTP 200 (OK) status code, you can configure the health check to pass only
+                # when the backend sends this specific ASCII response string within the first
+                # 1024 bytes of the HTTP response body. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+          },
+          "httpHealthCheck": {
+            "host": "A String", # The value of the host header in the HTTP health check request. If left
+                # empty (default value), the host header is set to the destination IP address
+                # to which health check packets are sent. The destination IP address depends
+                # on the type of load balancer. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+            "port": 42, # The TCP port number to which the health check prober sends packets. The
+                # default value is 80. Valid values are 1 through65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Also supported in legacy HTTP health checks for target pools.
+                # The health check supports all backends supported by the backend service
+                # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+                # network endpoint groups, and instance group backends.
+                # USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for pass-through load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+                # backend, either NONE or PROXY_V1. The default
+                # is NONE.
+            "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+            "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+                # HTTP 200 (OK) status code, you can configure the health check to pass only
+                # when the backend sends this specific ASCII response string within the first
+                # 1024 bytes of the HTTP response body. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+          },
+          "httpsHealthCheck": {
+            "host": "A String", # The value of the host header in the HTTPS health check request. If left
+                # empty (default value), the host header is set to the destination IP address
+                # to which health check packets are sent. The destination IP address depends
+                # on the type of load balancer. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+            "port": 42, # The TCP port number to which the health check prober sends packets. The
+                # default value is 443. Valid values are 1 through65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                #  USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+                # backend, either NONE or PROXY_V1. The default
+                # is NONE.
+            "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+            "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+                # HTTP 200 (OK) status code, you can configure the health check to pass only
+                # when the backend sends this specific ASCII response string within the first
+                # 1024 bytes of the HTTP response body. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+          },
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#healthCheck", # Output only. Type of the resource.
+          "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+              # will be exported to Stackdriver.
+            "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+                # means no health check logging will be done.
+          },
+          "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.
+              # For example, a name that is 1-63 characters long, matches the regular
+              # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+              # RFC1035. This regular expression describes a name where the first
+              # character is a lowercase letter, and all following characters are a dash,
+              # lowercase letter, or digit, except the last character, which isn't a dash.
+          "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+              # global health checks.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+              # regions are specified, then exactly 3 regions should be specified. The
+              # region names must be valid names of Google Cloud regions.
+              # This can only be set for global health check.
+              # If this list is non-empty, then there are restrictions
+              # on what other health check fields are supported and what other resources
+              # can use this health check:
+              #
+              #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+              #    - The TCP request field is not supported.
+              #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+              #    supported.
+              #    - The checkIntervalSec field must be at least 30.
+              #    - The health check cannot be used with BackendService nor with managed
+              #    instance group auto-healing.
+            "A String",
+          ],
+          "sslHealthCheck": {
+            "port": 42, # The TCP port number to which the health check prober sends packets. The
+                # default value is 443. Valid values are 1 through65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                #  USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+                # backend, either NONE or PROXY_V1. The default
+                # is NONE.
+            "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+                # 1024 bytes in length, after establishing the TCP connection and SSL
+                # handshake.
+            "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+                # TCP connection and the TLS handshake, you can configure the health check to
+                # pass only when the backend sends this exact response ASCII string, up to
+                # 1024 bytes in length. For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+          },
+          "tcpHealthCheck": {
+            "port": 42, # The TCP port number to which the health check prober sends packets. The
+                # default value is 80. Valid values are 1 through65535.
+            "portName": "A String", # Not supported.
+            "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+                # following values:
+                # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+                # for passthrough load balancers and backend services for proxy load
+                # balancers. Not supported by target pools. The health check supports all
+                # backends supported by the backend service provided the backend can be
+                # health checked. For example, GCE_VM_IP network endpoint
+                # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+                # group backends.
+                # USE_NAMED_PORT: Not supported.
+                # USE_SERVING_PORT: Provides an indirect method of specifying
+                # the health check port by referring to the backend service. Only supported
+                # by backend services for proxy load balancers. Not supported by target
+                # pools.  Not supported by backend services for passthrough load balancers.
+                # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+                # backends.
+                #
+                # For GCE_VM_IP_PORT network endpoint group backends, the health
+                # check uses the port number specified for each endpoint in the network
+                # endpoint group.  For instance group backends, the health check uses the
+                # port number determined by looking up the backend service's named port in
+                # the instance group's list of named ports.
+            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+                # backend, either NONE or PROXY_V1. The default
+                # is NONE.
+            "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+                # 1024 bytes in length, after establishing the TCP connection.
+            "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+                # TCP connection, you can configure the health check to pass only when the
+                # backend sends this exact response ASCII string, up to 1024 bytes in length.
+                # For details, see:
+                # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+          },
+          "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+              # 5 seconds. It is invalid for timeoutSec to have greater
+              # value than checkIntervalSec.
+          "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+              # Exactly one of the protocol-specific health check fields must be specified,
+              # which must match type field.
+          "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+              # consecutive failures. The default value is 2.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#healthChecksAggregatedList", # 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, healthCheck, requestId=None, x__xgafv=None) + 
Deletes the specified HealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  healthCheck: string, Name of the HealthCheck 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, healthCheck, x__xgafv=None) + 
Returns the specified HealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  healthCheck: string, Name of the HealthCheck 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 check resource.
+    #
+    # Google Compute Engine has two health check resources:
+    #
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    #
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    #
+    # **Load balancing**
+    #
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    #
+    # **Autohealing in MIGs**
+    #
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    #
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      #
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a HealthCheck resource 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 health check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of HealthCheck resources available to 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.
+  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 HealthCheck resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HealthCheck resources.
+    { # Represents a health check resource.
+        #
+        # Google Compute Engine has two health check resources:
+        #
+        # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+        # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+        #
+        # These health check resources can be used for load balancing and for
+        # autohealing VMs in a managed instance group (MIG).
+        #
+        # **Load balancing**
+        #
+        # Health check requirements vary depending on the type of load balancer. For
+        # details about the type of health check supported for
+        # each load balancer and corresponding backend type,
+        # see Health
+        # checks overview: Load balancer guide.
+        #
+        # **Autohealing in MIGs**
+        #
+        # The health checks that you use for autohealing VMs in a MIG can be either
+        # regional or global. For more information, see  Set up an
+        # application health check and autohealing.
+        #
+        # For more information, seeHealth checks
+        # overview.
+      "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+          # seconds.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "grpcHealthCheck": {
+        "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+            # value of grpc_service_name has the following meanings by convention:
+            #
+            # - Empty service_name means the overall status of all services at the
+            # backend.
+            #
+            # - Non-empty service_name means the health of that gRPC service, as defined
+            # by the owner of the service.
+            #
+            # The grpc_service_name can only be ASCII.
+        "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+            # values are 1 through 65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+      },
+      "grpcTlsHealthCheck": {
+        "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+            # value of grpc_service_name has the following meanings by convention:
+            #
+            # - Empty service_name means the overall status of all services at the
+            # backend.
+            #
+            # - Non-empty service_name means the health of that gRPC service, as defined
+            # by the owner of the service.
+            #
+            # The grpc_service_name can only be ASCII.
+        "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+            # values are 1 through 65535.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+      },
+      "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+          # many consecutive successes. The default value is 2.
+      "http2HealthCheck": {
+        "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "httpHealthCheck": {
+        "host": "A String", # The value of the host header in the HTTP health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 80. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Also supported in legacy HTTP health checks for target pools.
+            # The health check supports all backends supported by the backend service
+            # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+            # network endpoint groups, and instance group backends.
+            # USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for pass-through load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "httpsHealthCheck": {
+        "host": "A String", # The value of the host header in the HTTPS health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#healthCheck", # Output only. Type of the resource.
+      "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+          # will be exported to Stackdriver.
+        "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+            # means no health check logging will be done.
+      },
+      "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.
+          # For example, a name that is 1-63 characters long, matches the regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+          # RFC1035. This regular expression describes a name where the first
+          # character is a lowercase letter, and all following characters are a dash,
+          # lowercase letter, or digit, except the last character, which isn't a dash.
+      "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+          # global health checks.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+          # regions are specified, then exactly 3 regions should be specified. The
+          # region names must be valid names of Google Cloud regions.
+          # This can only be set for global health check.
+          # If this list is non-empty, then there are restrictions
+          # on what other health check fields are supported and what other resources
+          # can use this health check:
+          #
+          #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+          #    - The TCP request field is not supported.
+          #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+          #    supported.
+          #    - The checkIntervalSec field must be at least 30.
+          #    - The health check cannot be used with BackendService nor with managed
+          #    instance group auto-healing.
+        "A String",
+      ],
+      "sslHealthCheck": {
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+            # 1024 bytes in length, after establishing the TCP connection and SSL
+            # handshake.
+        "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+            # TCP connection and the TLS handshake, you can configure the health check to
+            # pass only when the backend sends this exact response ASCII string, up to
+            # 1024 bytes in length. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+      },
+      "tcpHealthCheck": {
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 80. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            # USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+            # 1024 bytes in length, after establishing the TCP connection.
+        "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+            # TCP connection, you can configure the health check to pass only when the
+            # backend sends this exact response ASCII string, up to 1024 bytes in length.
+            # For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+      },
+      "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+          # 5 seconds. It is invalid for timeoutSec to have greater
+          # value than checkIntervalSec.
+      "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+          # Exactly one of the protocol-specific health check fields must be specified,
+          # which must match type field.
+      "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+          # consecutive failures. The default value is 2.
+    },
+  ],
+  "kind": "compute#healthCheckList", # 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.
+  "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, healthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HealthCheck resource in the specified project using 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)
+  healthCheck: string, Name of the HealthCheck resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, healthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HealthCheck resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  healthCheck: string, Name of the HealthCheck resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.hosts.html b/docs/dyn/compute_preview.hosts.html new file mode 100644 index 0000000000..93a5db0686 --- /dev/null +++ b/docs/dyn/compute_preview.hosts.html @@ -0,0 +1,644 @@ + + + +

Compute Engine API . hosts

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, association, host, x__xgafv=None)

+

Retrieves information about the specified host.

+

+ getVersion(project, zone, association, host, body=None, requestId=None, x__xgafv=None)

+

Allows customers to get SBOM versions of a host.

+

+ list(project, zone, association, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of hosts.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, association, host, x__xgafv=None) + 
Retrieves information about the specified host.
+
+Args:
+  project: string, The project ID for this request. (required)
+  zone: string, The name of the zone for this request, formatted as RFC1035. (required)
+  association: string, The parent resource association for the Host. This field specifies the
+hierarchical context (e.g., reservation, block, sub-block) when
+accessing the host. For example, reservations/reservation_name,
+reservations/reservation_name/reservationBlocks/reservation_block_name or
+reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. (required)
+  host: string, The name of the host, formatted as RFC1035 or a resource ID
+number. (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 host resource.
+  "aliasLinks": [ # Output only. All aliases for this resource.
+      # e.g.
+      # projects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1
+    "A String",
+  ],
+  "creationTimestamp": "A String", # Output only. The creation timestamp, formatted asRFC3339 text.
+  "description": "A String", # An optional description of this resource.
+  "id": "A String", # Output only. The unique identifier for this resource. This identifier is
+      # defined by the server.
+  "kind": "compute#host", # Output only. The type of resource. Alwayscompute#host for hosts.
+  "name": "A String", # Output only. The name of the host.
+  "selfLink": "A String", # Output only. The self link of the host.
+  "selfLinkWithId": "A String", # Output only. The self link with id of the host.
+  "state": "A String", # Output only. The state of the host.
+  "status": { # Output only. The status of the host
+    "physicalTopology": { # Output only. The physical topology of the reservation sub-block, if
+        # present
+      "block": "A String", # The unique identifier of the capacity block within the cluster.
+      "cluster": "A String", # The cluster name of the reservation sub-block.
+      "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+      "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+          # block.
+    },
+    "runningInstances": [ # Output only. The URIs of the instances currently running on this host.
+      "A String",
+    ],
+  },
+  "zone": "A String", # Output only. The zone in which the host resides.
+}
+
+ +
+ getVersion(project, zone, association, host, body=None, requestId=None, x__xgafv=None) + 
Allows customers to get SBOM versions of a host.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  association: string, The parent resource association for the Host. This field specifies the
+hierarchical context (e.g., reservation, block, sub-block) when
+accessing the host. (required)
+  host: string, The name of the host, formatted as RFC1035 or a resource ID
+number. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sbomSelections": [ # The SBOM selection to return. Duplicate values in the list will be ignored.
+    "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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, association, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of hosts.
+
+Args:
+  project: string, The project ID for this request. (required)
+  zone: string, The name of the zone for this request, formatted as RFC1035. (required)
+  association: string, The parent resource association for the Host. This field specifies the
+hierarchical context (e.g., reservation, block, sub-block) when
+accessing the host. For example, reservations/reservation_name,
+reservations/reservation_name/reservationBlocks/reservation_block_name or
+reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # The unique identifier for the resource; defined by the server.
+  "items": [ # A list of host resources.
+    { # Represents a host resource.
+      "aliasLinks": [ # Output only. All aliases for this resource.
+          # e.g.
+          # projects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1
+        "A String",
+      ],
+      "creationTimestamp": "A String", # Output only. The creation timestamp, formatted asRFC3339 text.
+      "description": "A String", # An optional description of this resource.
+      "id": "A String", # Output only. The unique identifier for this resource. This identifier is
+          # defined by the server.
+      "kind": "compute#host", # Output only. The type of resource. Alwayscompute#host for hosts.
+      "name": "A String", # Output only. The name of the host.
+      "selfLink": "A String", # Output only. The self link of the host.
+      "selfLinkWithId": "A String", # Output only. The self link with id of the host.
+      "state": "A String", # Output only. The state of the host.
+      "status": { # Output only. The status of the host
+        "physicalTopology": { # Output only. The physical topology of the reservation sub-block, if
+            # present
+          "block": "A String", # The unique identifier of the capacity block within the cluster.
+          "cluster": "A String", # The cluster name of the reservation sub-block.
+          "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+          "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+              # block.
+        },
+        "runningInstances": [ # Output only. The URIs of the instances currently running on this host.
+          "A String",
+        ],
+      },
+      "zone": "A String", # Output only. The zone in which the host resides.
+    },
+  ],
+  "kind": "compute#hostList", # The type of resource. Always compute#host for a list of hosts.
+  "nextPageToken": "A String", # 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", # The server-defined URL for this resource.
+  "unreachables": [ # Unreachable resources.
+      # end_interface: MixerListResponseWithEtagBuilder
+    "A String",
+  ],
+  "warning": { # An 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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.html b/docs/dyn/compute_preview.html new file mode 100644 index 0000000000..f95be70c0b --- /dev/null +++ b/docs/dyn/compute_preview.html @@ -0,0 +1,766 @@ + + + +

Compute Engine API

+

Instance Methods

+

+ acceleratorTypes() +

+

Returns the acceleratorTypes Resource.

+ +

+ addresses() +

+

Returns the addresses Resource.

+ +

+ advice() +

+

Returns the advice Resource.

+ +

+ autoscalers() +

+

Returns the autoscalers Resource.

+ +

+ backendBuckets() +

+

Returns the backendBuckets Resource.

+ +

+ backendServices() +

+

Returns the backendServices Resource.

+ +

+ crossSiteNetworks() +

+

Returns the crossSiteNetworks Resource.

+ +

+ diskTypes() +

+

Returns the diskTypes Resource.

+ +

+ disks() +

+

Returns the disks Resource.

+ +

+ externalVpnGateways() +

+

Returns the externalVpnGateways Resource.

+ +

+ firewallPolicies() +

+

Returns the firewallPolicies Resource.

+ +

+ firewalls() +

+

Returns the firewalls Resource.

+ +

+ forwardingRules() +

+

Returns the forwardingRules Resource.

+ +

+ futureReservations() +

+

Returns the futureReservations Resource.

+ +

+ globalAddresses() +

+

Returns the globalAddresses Resource.

+ +

+ globalForwardingRules() +

+

Returns the globalForwardingRules Resource.

+ +

+ globalFrontendSettings() +

+

Returns the globalFrontendSettings Resource.

+ +

+ globalNetworkEndpointGroups() +

+

Returns the globalNetworkEndpointGroups Resource.

+ +

+ globalOperations() +

+

Returns the globalOperations Resource.

+ +

+ globalOrganizationOperations() +

+

Returns the globalOrganizationOperations Resource.

+ +

+ globalPublicDelegatedPrefixes() +

+

Returns the globalPublicDelegatedPrefixes Resource.

+ +

+ globalVmExtensionPolicies() +

+

Returns the globalVmExtensionPolicies Resource.

+ +

+ haControllers() +

+

Returns the haControllers Resource.

+ +

+ healthChecks() +

+

Returns the healthChecks Resource.

+ +

+ hosts() +

+

Returns the hosts Resource.

+ +

+ httpHealthChecks() +

+

Returns the httpHealthChecks Resource.

+ +

+ httpsHealthChecks() +

+

Returns the httpsHealthChecks Resource.

+ +

+ imageFamilyViews() +

+

Returns the imageFamilyViews Resource.

+ +

+ imageViews() +

+

Returns the imageViews Resource.

+ +

+ images() +

+

Returns the images Resource.

+ +

+ instanceGroupManagerResizeRequests() +

+

Returns the instanceGroupManagerResizeRequests Resource.

+ +

+ instanceGroupManagers() +

+

Returns the instanceGroupManagers Resource.

+ +

+ instanceGroups() +

+

Returns the instanceGroups Resource.

+ +

+ instanceSettings() +

+

Returns the instanceSettings Resource.

+ +

+ instanceTemplates() +

+

Returns the instanceTemplates Resource.

+ +

+ instances() +

+

Returns the instances Resource.

+ +

+ instantSnapshotGroups() +

+

Returns the instantSnapshotGroups Resource.

+ +

+ instantSnapshots() +

+

Returns the instantSnapshots Resource.

+ +

+ interconnectAttachmentGroups() +

+

Returns the interconnectAttachmentGroups Resource.

+ +

+ interconnectAttachments() +

+

Returns the interconnectAttachments Resource.

+ +

+ interconnectGroups() +

+

Returns the interconnectGroups Resource.

+ +

+ interconnectLocations() +

+

Returns the interconnectLocations Resource.

+ +

+ interconnectRemoteLocations() +

+

Returns the interconnectRemoteLocations Resource.

+ +

+ interconnects() +

+

Returns the interconnects Resource.

+ +

+ licenseCodes() +

+

Returns the licenseCodes Resource.

+ +

+ licenses() +

+

Returns the licenses Resource.

+ +

+ machineImages() +

+

Returns the machineImages Resource.

+ +

+ machineTypes() +

+

Returns the machineTypes Resource.

+ +

+ managedRulesets() +

+

Returns the managedRulesets Resource.

+ +

+ networkAttachments() +

+

Returns the networkAttachments Resource.

+ +

+ networkEdgeSecurityServices() +

+

Returns the networkEdgeSecurityServices Resource.

+ +

+ networkEndpointGroups() +

+

Returns the networkEndpointGroups Resource.

+ +

+ networkFirewallPolicies() +

+

Returns the networkFirewallPolicies Resource.

+ +

+ networkProfiles() +

+

Returns the networkProfiles Resource.

+ +

+ networks() +

+

Returns the networks Resource.

+ +

+ nodeGroups() +

+

Returns the nodeGroups Resource.

+ +

+ nodeTemplates() +

+

Returns the nodeTemplates Resource.

+ +

+ nodeTypes() +

+

Returns the nodeTypes Resource.

+ +

+ organizationSecurityPolicies() +

+

Returns the organizationSecurityPolicies Resource.

+ +

+ packetMirrorings() +

+

Returns the packetMirrorings Resource.

+ +

+ previewFeatures() +

+

Returns the previewFeatures Resource.

+ +

+ projectViews() +

+

Returns the projectViews Resource.

+ +

+ projects() +

+

Returns the projects Resource.

+ +

+ publicAdvertisedPrefixes() +

+

Returns the publicAdvertisedPrefixes Resource.

+ +

+ publicDelegatedPrefixes() +

+

Returns the publicDelegatedPrefixes Resource.

+ +

+ regionAutoscalers() +

+

Returns the regionAutoscalers Resource.

+ +

+ regionBackendBuckets() +

+

Returns the regionBackendBuckets Resource.

+ +

+ regionBackendServices() +

+

Returns the regionBackendServices Resource.

+ +

+ regionCommitments() +

+

Returns the regionCommitments Resource.

+ +

+ regionCompositeHealthChecks() +

+

Returns the regionCompositeHealthChecks Resource.

+ +

+ regionDiskTypes() +

+

Returns the regionDiskTypes Resource.

+ +

+ regionDisks() +

+

Returns the regionDisks Resource.

+ +

+ regionHealthAggregationPolicies() +

+

Returns the regionHealthAggregationPolicies Resource.

+ +

+ regionHealthCheckServices() +

+

Returns the regionHealthCheckServices Resource.

+ +

+ regionHealthChecks() +

+

Returns the regionHealthChecks Resource.

+ +

+ regionHealthSources() +

+

Returns the regionHealthSources Resource.

+ +

+ regionInstanceGroupManagerResizeRequests() +

+

Returns the regionInstanceGroupManagerResizeRequests Resource.

+ +

+ regionInstanceGroupManagers() +

+

Returns the regionInstanceGroupManagers Resource.

+ +

+ regionInstanceGroups() +

+

Returns the regionInstanceGroups Resource.

+ +

+ regionInstanceTemplates() +

+

Returns the regionInstanceTemplates Resource.

+ +

+ regionInstances() +

+

Returns the regionInstances Resource.

+ +

+ regionInstantSnapshotGroups() +

+

Returns the regionInstantSnapshotGroups Resource.

+ +

+ regionInstantSnapshots() +

+

Returns the regionInstantSnapshots Resource.

+ +

+ regionNetworkEndpointGroups() +

+

Returns the regionNetworkEndpointGroups Resource.

+ +

+ regionNetworkFirewallPolicies() +

+

Returns the regionNetworkFirewallPolicies Resource.

+ +

+ regionNotificationEndpoints() +

+

Returns the regionNotificationEndpoints Resource.

+ +

+ regionOperations() +

+

Returns the regionOperations Resource.

+ +

+ regionSecurityPolicies() +

+

Returns the regionSecurityPolicies Resource.

+ +

+ regionSnapshotSettings() +

+

Returns the regionSnapshotSettings Resource.

+ +

+ regionSnapshots() +

+

Returns the regionSnapshots Resource.

+ +

+ regionSslCertificates() +

+

Returns the regionSslCertificates Resource.

+ +

+ regionSslPolicies() +

+

Returns the regionSslPolicies Resource.

+ +

+ regionTargetHttpProxies() +

+

Returns the regionTargetHttpProxies Resource.

+ +

+ regionTargetHttpsProxies() +

+

Returns the regionTargetHttpsProxies Resource.

+ +

+ regionTargetTcpProxies() +

+

Returns the regionTargetTcpProxies Resource.

+ +

+ regionUrlMaps() +

+

Returns the regionUrlMaps Resource.

+ +

+ regionZones() +

+

Returns the regionZones Resource.

+ +

+ regions() +

+

Returns the regions Resource.

+ +

+ reliabilityRisks() +

+

Returns the reliabilityRisks Resource.

+ +

+ reservationBlocks() +

+

Returns the reservationBlocks Resource.

+ +

+ reservationSlots() +

+

Returns the reservationSlots Resource.

+ +

+ reservationSubBlocks() +

+

Returns the reservationSubBlocks Resource.

+ +

+ reservations() +

+

Returns the reservations Resource.

+ +

+ resourcePolicies() +

+

Returns the resourcePolicies Resource.

+ +

+ rolloutPlans() +

+

Returns the rolloutPlans Resource.

+ +

+ rollouts() +

+

Returns the rollouts Resource.

+ +

+ routers() +

+

Returns the routers Resource.

+ +

+ routes() +

+

Returns the routes Resource.

+ +

+ securityPolicies() +

+

Returns the securityPolicies Resource.

+ +

+ serviceAttachments() +

+

Returns the serviceAttachments Resource.

+ +

+ snapshotSettings() +

+

Returns the snapshotSettings Resource.

+ +

+ snapshots() +

+

Returns the snapshots Resource.

+ +

+ sslCertificates() +

+

Returns the sslCertificates Resource.

+ +

+ sslPolicies() +

+

Returns the sslPolicies Resource.

+ +

+ storagePoolTypes() +

+

Returns the storagePoolTypes Resource.

+ +

+ storagePools() +

+

Returns the storagePools Resource.

+ +

+ subnetworks() +

+

Returns the subnetworks Resource.

+ +

+ targetGrpcProxies() +

+

Returns the targetGrpcProxies Resource.

+ +

+ targetHttpProxies() +

+

Returns the targetHttpProxies Resource.

+ +

+ targetHttpsProxies() +

+

Returns the targetHttpsProxies Resource.

+ +

+ targetInstances() +

+

Returns the targetInstances Resource.

+ +

+ targetPools() +

+

Returns the targetPools Resource.

+ +

+ targetSslProxies() +

+

Returns the targetSslProxies Resource.

+ +

+ targetTcpProxies() +

+

Returns the targetTcpProxies Resource.

+ +

+ targetVpnGateways() +

+

Returns the targetVpnGateways Resource.

+ +

+ urlMaps() +

+

Returns the urlMaps Resource.

+ +

+ vpnGateways() +

+

Returns the vpnGateways Resource.

+ +

+ vpnTunnels() +

+

Returns the vpnTunnels Resource.

+ +

+ wireGroups() +

+

Returns the wireGroups Resource.

+ +

+ zoneOperations() +

+

Returns the zoneOperations Resource.

+ +

+ zoneVmExtensionPolicies() +

+

Returns the zoneVmExtensionPolicies Resource.

+ +

+ zones() +

+

Returns the zones Resource.

+ +

+ close()

+

Close httplib2 connections.

+

+ new_batch_http_request()

+

Create a BatchHttpRequest object based on the discovery document.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ new_batch_http_request() + 
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.httpHealthChecks.html b/docs/dyn/compute_preview.httpHealthChecks.html new file mode 100644 index 0000000000..7a1ffb7aad --- /dev/null +++ b/docs/dyn/compute_preview.httpHealthChecks.html @@ -0,0 +1,1723 @@ + + + +

Compute Engine API . httpHealthChecks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, httpHealthCheck, requestId=None, x__xgafv=None)

+

Deletes the specified HttpHealthCheck resource.

+

+ get(project, httpHealthCheck, x__xgafv=None)

+

Returns the specified HttpHealthCheck resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a HttpHealthCheck resource in the specified project using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of HttpHealthCheck resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HttpHealthCheck resource in the specified project using the data

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HttpHealthCheck resource in the specified project using the data

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, httpHealthCheck, requestId=None, x__xgafv=None) + 
Deletes the specified HttpHealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpHealthCheck: string, Name of the HttpHealthCheck 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, httpHealthCheck, x__xgafv=None) + 
Returns the specified HttpHealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpHealthCheck: string, Name of the HttpHealthCheck 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 legacy HTTP Health Check resource.
+    #
+    # Legacy HTTP health checks are now only required by target pool-based network
+    # load balancers. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    #
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is5 seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTP health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.
+  "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.
+  "port": 42, # The TCP port number for the HTTP health check request. The default value is80.
+  "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. This field does not support query
+      # parameters. Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have
+      # greater value than checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a HttpHealthCheck resource 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 legacy HTTP Health Check resource.
+    # 
+    # Legacy HTTP health checks are now only required by target pool-based network
+    # load balancers. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is5 seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTP health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.
+  "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.
+  "port": 42, # The TCP port number for the HTTP health check request. The default value is80.
+  "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. This field does not support query
+      # parameters. Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have
+      # greater value than checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of HttpHealthCheck resources available to 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.
+  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 HttpHealthCheck resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HttpHealthCheck resources.
+    { # Represents a legacy HTTP Health Check resource.
+        #
+        # Legacy HTTP health checks are now only required by target pool-based network
+        # load balancers. For all other load balancers, including backend service-based
+        # network load balancers, and for managed instance group auto-healing, you must
+        # use modern (non-legacy) health checks.
+        #
+        # For more information, seeHealth checks
+        # overview.
+      "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is5 seconds.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+          # many consecutive successes. The default value is 2.
+      "host": "A String", # The value of the host header in the HTTP health check request. If left
+          # empty (default value), the public IP on behalf of which this health check
+          # is performed will be used.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#httpHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.
+      "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.
+      "port": 42, # The TCP port number for the HTTP health check request. The default value is80.
+      "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. This field does not support query
+          # parameters. Must comply withRFC3986.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have
+          # greater value than checkIntervalSec.
+      "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+          # many consecutive failures. The default value is 2.
+    },
+  ],
+  "kind": "compute#httpHealthCheckList", # 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.
+  "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, httpHealthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HttpHealthCheck resource in the specified project using 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)
+  httpHealthCheck: string, Name of the HttpHealthCheck resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a legacy HTTP Health Check resource.
+    # 
+    # Legacy HTTP health checks are now only required by target pool-based network
+    # load balancers. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is5 seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTP health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.
+  "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.
+  "port": 42, # The TCP port number for the HTTP health check request. The default value is80.
+  "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. This field does not support query
+      # parameters. Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have
+      # greater value than checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HttpHealthCheck resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpHealthCheck: string, Name of the HttpHealthCheck resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a legacy HTTP Health Check resource.
+    # 
+    # Legacy HTTP health checks are now only required by target pool-based network
+    # load balancers. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is5 seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTP health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.
+  "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.
+  "port": 42, # The TCP port number for the HTTP health check request. The default value is80.
+  "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. This field does not support query
+      # parameters. Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have
+      # greater value than checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.httpsHealthChecks.html b/docs/dyn/compute_preview.httpsHealthChecks.html new file mode 100644 index 0000000000..cb23109c4d --- /dev/null +++ b/docs/dyn/compute_preview.httpsHealthChecks.html @@ -0,0 +1,1743 @@ + + + +

Compute Engine API . httpsHealthChecks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, httpsHealthCheck, requestId=None, x__xgafv=None)

+

Deletes the specified HttpsHealthCheck resource.

+

+ get(project, httpsHealthCheck, x__xgafv=None)

+

Returns the specified HttpsHealthCheck resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a HttpsHealthCheck resource in the specified project using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of HttpsHealthCheck resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HttpsHealthCheck resource in the specified project using the data

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HttpsHealthCheck resource in the specified project using the data

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, httpsHealthCheck, requestId=None, x__xgafv=None) + 
Deletes the specified HttpsHealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpsHealthCheck: string, Name of the HttpsHealthCheck 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, httpsHealthCheck, x__xgafv=None) + 
Returns the specified HttpsHealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpsHealthCheck: string, Name of the HttpsHealthCheck 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 legacy HTTPS Health Check resource.
+    #
+    # Legacy HTTPS health checks have been deprecated. If you are using a target
+    # pool-based network load balancer, you must use a legacy HTTP (not HTTPS)
+    # health check. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    #
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTPS health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpsHealthCheck", # Output only. Type of the resource.
+  "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.
+  "port": 42, # The TCP port number for the HTTPS health check request. The default value
+      # is 443.
+  "requestPath": "A String", # The request path of the HTTPS health check request. The default value is
+      # "/". Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have a greater value than
+      # checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a HttpsHealthCheck resource 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 legacy HTTPS Health Check resource.
+    # 
+    # Legacy HTTPS health checks have been deprecated. If you are using a target
+    # pool-based network load balancer, you must use a legacy HTTP (not HTTPS)
+    # health check. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTPS health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpsHealthCheck", # Output only. Type of the resource.
+  "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.
+  "port": 42, # The TCP port number for the HTTPS health check request. The default value
+      # is 443.
+  "requestPath": "A String", # The request path of the HTTPS health check request. The default value is
+      # "/". Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have a greater value than
+      # checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of HttpsHealthCheck resources available to 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.
+  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 HttpsHealthCheck resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HttpsHealthCheck resources.
+    { # Represents a legacy HTTPS Health Check resource.
+        #
+        # Legacy HTTPS health checks have been deprecated. If you are using a target
+        # pool-based network load balancer, you must use a legacy HTTP (not HTTPS)
+        # health check. For all other load balancers, including backend service-based
+        # network load balancers, and for managed instance group auto-healing, you must
+        # use modern (non-legacy) health checks.
+        #
+        # For more information, seeHealth checks
+        # overview.
+      "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+          # seconds.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+          # many consecutive successes. The default value is 2.
+      "host": "A String", # The value of the host header in the HTTPS health check request. If left
+          # empty (default value), the public IP on behalf of which this health check
+          # is performed will be used.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#httpsHealthCheck", # Output only. Type of the resource.
+      "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.
+      "port": 42, # The TCP port number for the HTTPS health check request. The default value
+          # is 443.
+      "requestPath": "A String", # The request path of the HTTPS health check request. The default value is
+          # "/". Must comply withRFC3986.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+          # 5 seconds. It is invalid for timeoutSec to have a greater value than
+          # checkIntervalSec.
+      "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+          # many consecutive failures. The default value is 2.
+    },
+  ],
+  "kind": "compute#httpsHealthCheckList", # 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.
+  "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, httpsHealthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HttpsHealthCheck resource in the specified project using 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)
+  httpsHealthCheck: string, Name of the HttpsHealthCheck resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a legacy HTTPS Health Check resource.
+    # 
+    # Legacy HTTPS health checks have been deprecated. If you are using a target
+    # pool-based network load balancer, you must use a legacy HTTP (not HTTPS)
+    # health check. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTPS health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpsHealthCheck", # Output only. Type of the resource.
+  "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.
+  "port": 42, # The TCP port number for the HTTPS health check request. The default value
+      # is 443.
+  "requestPath": "A String", # The request path of the HTTPS health check request. The default value is
+      # "/". Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have a greater value than
+      # checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HttpsHealthCheck resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  httpsHealthCheck: string, Name of the HttpsHealthCheck resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a legacy HTTPS Health Check resource.
+    # 
+    # Legacy HTTPS health checks have been deprecated. If you are using a target
+    # pool-based network load balancer, you must use a legacy HTTP (not HTTPS)
+    # health check. For all other load balancers, including backend service-based
+    # network load balancers, and for managed instance group auto-healing, you must
+    # use modern (non-legacy) health checks.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "host": "A String", # The value of the host header in the HTTPS health check request. If left
+      # empty (default value), the public IP on behalf of which this health check
+      # is performed will be used.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#httpsHealthCheck", # Output only. Type of the resource.
+  "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.
+  "port": 42, # The TCP port number for the HTTPS health check request. The default value
+      # is 443.
+  "requestPath": "A String", # The request path of the HTTPS health check request. The default value is
+      # "/". Must comply withRFC3986.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have a greater value than
+      # checkIntervalSec.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this
+      # many consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.imageFamilyViews.html b/docs/dyn/compute_preview.imageFamilyViews.html new file mode 100644 index 0000000000..83c53f122f --- /dev/null +++ b/docs/dyn/compute_preview.imageFamilyViews.html @@ -0,0 +1,584 @@ + + + +

Compute Engine API . imageFamilyViews

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, family, x__xgafv=None)

+

Returns the latest image that is part of an image family, is not

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, family, x__xgafv=None) + 
Returns the latest image that is part of an image family, is not
+deprecated and is rolled out in the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  family: string, Name of the image family to search for. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "image": { # Represents an Image resource. # The latest image that is part of the specified image family in the
+      # requested location, and that is not deprecated.
+      #
+      # You can use images to create boot disks for your VM instances.
+      # For more information, read Images.
+    "architecture": "A String", # The architecture of the image. Valid values are
+        # ARM64 or X86_64.
+    "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+        # Storage (in bytes).
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+        # text format.
+    "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to DELETED. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to DEPRECATED. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to OBSOLETE. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+          # The suggested replacement resource must be the same kind of resource as the
+          # deprecated resource.
+      "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+          # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+          # warning indicating the deprecated resource and recommending its
+          # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+    },
+    "description": "A String", # An optional description of this resource. Provide this property when you
+        # create the resource.
+    "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+    "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+        # [Output Only]: This field is not set by user, but from source disk.
+    "family": "A String", # The name of the image family to which this image belongs. The image
+        # family name can be from a publicly managed image family provided by
+        # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+        # For more information, see Image
+        # family best practices.
+        #
+        # When creating disks, you can specify an image family instead of a specific
+        # image name. The image family always returns its latest image that is not
+        # deprecated. The name of the image family must comply with RFC1035.
+    "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+        # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+      { # Guest OS features.
+        "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+            # separate values. Set to one or more of the following values:
+            #
+            #    - VIRTIO_SCSI_MULTIQUEUE
+            #    - WINDOWS
+            #    - MULTI_IP_SUBNET
+            #    - UEFI_COMPATIBLE
+            #    - GVNIC
+            #    - SEV_CAPABLE
+            #    - SUSPEND_RESUME_COMPATIBLE
+            #    - SEV_LIVE_MIGRATABLE_V2
+            #    - SEV_SNP_CAPABLE
+            #    - TDX_CAPABLE
+            #    - IDPF
+            #    - SNP_SVSM_CAPABLE
+            #    - CCA_CAPABLE
+            #    - SUSPEND_SAFE_FPR
+            #
+            #
+            # For more information, see
+            # Enabling guest operating system features.
+      },
+    ],
+    "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+        # encryption key.
+        #
+        # After you encrypt an image with a customer-supplied key, you must provide
+        # the same key if you use the image later (e.g. to create a disk from
+        # the image).
+        #
+        # Customer-supplied encryption keys do not protect access to metadata
+        # of the disk.
+        #
+        # If you do not provide an encryption key when creating the image, then the
+        # disk will be encrypted using an automatically generated key and you do not
+        # need to provide a key to use the image later.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+        # images.
+    "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+        # essentially a hash of the labels used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update labels. You must always provide an
+        # up-to-date fingerprint hash in order to update or change labels,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve an image.
+    "labels": { # Labels to apply to this image. These can be later modified by
+        # the setLabels method.
+      "a_key": "A String",
+    },
+    "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+      "A String",
+    ],
+    "licenses": [ # Any applicable license URI.
+      "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.
+    "params": { # Additional image params. # Input only. [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 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/{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",
+      },
+    },
+    "rawDisk": { # The parameters of the raw disk image.
+      "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+          # a runtime format. Provided by the client when the disk image is created.
+      "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+          # An optional SHA1 checksum of the disk image before unpackaging provided
+          # by the client when the disk image is created.
+      "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+          # disk image archive is stored.
+          # The following are valid formats:
+          #
+          #    - https://storage.googleapis.com/bucket_name/image_archive_name
+          #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+          #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+          #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+          #
+          #
+          #
+          # In order to create an image, you must provide the full or partial URL of
+          # one of the following:
+          #
+          #    - The rawDisk.source URL
+          #    - The sourceDisk URL
+          #    - The sourceImage URL
+          #    - The sourceSnapshot URL
+    },
+    "satisfiesPzi": True or False, # Output only. Reserved for future use.
+    "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+    "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+        # these are public keys which are safe to store in public
+      "dbs": [ # The Key Database (db).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "dbxs": [ # The forbidden key database (dbx).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "keks": [ # The Key Exchange Key (KEK).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "pk": { # The Platform Key (PK).
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    },
+    "sourceDisk": "A String", # URL of the source disk used to create this image.
+        # For example, the following are valid values:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceDiskEncryptionKey": { # Thecustomer-supplied
+        # encryption key of the source disk. Required if the source disk is
+        # protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceDiskId": "A String", # Output only. [Output Only]
+        # The ID value of the disk used to create this image. This value may be used
+        # to determine whether the image was taken from the current or a previous
+        # instance of a given disk name.
+    "sourceImage": "A String", # URL of the source image used to create this image.
+        # The following are valid formats for the URL:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+        #    images/image_name
+        #    - projects/project_id/global/images/image_name
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+        # source image is protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceImageId": "A String", # Output only. [Output Only]
+        # The ID value of the image used to create this image. This value may be used
+        # to determine whether the image was taken from the current or a previous
+        # instance of a given image name.
+    "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+        # The following are valid formats for the URL:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+        #    snapshots/snapshot_name
+        #    - projects/project_id/global/snapshots/snapshot_name
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+        # the source snapshot is protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceSnapshotId": "A String", # Output only. [Output Only]
+        # The ID value of the snapshot used to create this image. This value may be
+        # used to determine whether the snapshot was taken from the current or a
+        # previous instance of a given snapshot name.
+    "sourceType": "RAW", # The type of the image used to create this disk. The
+        # default and only valid value is RAW.
+    "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+        # resources, such as instances, only after the image has been successfully
+        # created and the status is set to READY. Possible
+        # values are FAILED, PENDING, orREADY.
+    "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+        # multi-regional).
+      "A String",
+    ],
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.imageViews.html b/docs/dyn/compute_preview.imageViews.html new file mode 100644 index 0000000000..c18969a36c --- /dev/null +++ b/docs/dyn/compute_preview.imageViews.html @@ -0,0 +1,1210 @@ + + + +

Compute Engine API . imageViews

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, resourceId, x__xgafv=None)

+

Returns the specified global ImageView resource, with a regional

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Returns a list of global ImageView resources, with a regional

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, resourceId, x__xgafv=None) + 
Returns the specified global ImageView resource, with a regional
+context.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  region: string, Required. Name of the region for this request. (required)
+  resourceId: string, Name of the image 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 read-only view of a global Image resource.
+  "image": { # Represents an Image resource. # The Image resource.
+      #
+      # You can use images to create boot disks for your VM instances.
+      # For more information, read Images.
+    "architecture": "A String", # The architecture of the image. Valid values are
+        # ARM64 or X86_64.
+    "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+        # Storage (in bytes).
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+        # text format.
+    "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to DELETED. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to DEPRECATED. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+          # resource is intended to change to OBSOLETE. This is only
+          # informational and the status will not change unless the client explicitly
+          # changes it.
+      "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+          # The suggested replacement resource must be the same kind of resource as the
+          # deprecated resource.
+      "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+          # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+          # warning indicating the deprecated resource and recommending its
+          # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+    },
+    "description": "A String", # An optional description of this resource. Provide this property when you
+        # create the resource.
+    "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+    "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+        # [Output Only]: This field is not set by user, but from source disk.
+    "family": "A String", # The name of the image family to which this image belongs. The image
+        # family name can be from a publicly managed image family provided by
+        # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+        # For more information, see Image
+        # family best practices.
+        #
+        # When creating disks, you can specify an image family instead of a specific
+        # image name. The image family always returns its latest image that is not
+        # deprecated. The name of the image family must comply with RFC1035.
+    "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+        # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+      { # Guest OS features.
+        "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+            # separate values. Set to one or more of the following values:
+            #
+            #    - VIRTIO_SCSI_MULTIQUEUE
+            #    - WINDOWS
+            #    - MULTI_IP_SUBNET
+            #    - UEFI_COMPATIBLE
+            #    - GVNIC
+            #    - SEV_CAPABLE
+            #    - SUSPEND_RESUME_COMPATIBLE
+            #    - SEV_LIVE_MIGRATABLE_V2
+            #    - SEV_SNP_CAPABLE
+            #    - TDX_CAPABLE
+            #    - IDPF
+            #    - SNP_SVSM_CAPABLE
+            #    - CCA_CAPABLE
+            #    - SUSPEND_SAFE_FPR
+            #
+            #
+            # For more information, see
+            # Enabling guest operating system features.
+      },
+    ],
+    "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+        # encryption key.
+        #
+        # After you encrypt an image with a customer-supplied key, you must provide
+        # the same key if you use the image later (e.g. to create a disk from
+        # the image).
+        #
+        # Customer-supplied encryption keys do not protect access to metadata
+        # of the disk.
+        #
+        # If you do not provide an encryption key when creating the image, then the
+        # disk will be encrypted using an automatically generated key and you do not
+        # need to provide a key to use the image later.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+        # images.
+    "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+        # essentially a hash of the labels used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update labels. You must always provide an
+        # up-to-date fingerprint hash in order to update or change labels,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve an image.
+    "labels": { # Labels to apply to this image. These can be later modified by
+        # the setLabels method.
+      "a_key": "A String",
+    },
+    "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+      "A String",
+    ],
+    "licenses": [ # Any applicable license URI.
+      "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.
+    "params": { # Additional image params. # Input only. [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 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/{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",
+      },
+    },
+    "rawDisk": { # The parameters of the raw disk image.
+      "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+          # a runtime format. Provided by the client when the disk image is created.
+      "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+          # An optional SHA1 checksum of the disk image before unpackaging provided
+          # by the client when the disk image is created.
+      "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+          # disk image archive is stored.
+          # The following are valid formats:
+          #
+          #    - https://storage.googleapis.com/bucket_name/image_archive_name
+          #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+          #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+          #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+          #
+          #
+          #
+          # In order to create an image, you must provide the full or partial URL of
+          # one of the following:
+          #
+          #    - The rawDisk.source URL
+          #    - The sourceDisk URL
+          #    - The sourceImage URL
+          #    - The sourceSnapshot URL
+    },
+    "satisfiesPzi": True or False, # Output only. Reserved for future use.
+    "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+    "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+        # these are public keys which are safe to store in public
+      "dbs": [ # The Key Database (db).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "dbxs": [ # The forbidden key database (dbx).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "keks": [ # The Key Exchange Key (KEK).
+        {
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      ],
+      "pk": { # The Platform Key (PK).
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    },
+    "sourceDisk": "A String", # URL of the source disk used to create this image.
+        # For example, the following are valid values:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceDiskEncryptionKey": { # Thecustomer-supplied
+        # encryption key of the source disk. Required if the source disk is
+        # protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceDiskId": "A String", # Output only. [Output Only]
+        # The ID value of the disk used to create this image. This value may be used
+        # to determine whether the image was taken from the current or a previous
+        # instance of a given disk name.
+    "sourceImage": "A String", # URL of the source image used to create this image.
+        # The following are valid formats for the URL:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+        #    images/image_name
+        #    - projects/project_id/global/images/image_name
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+        # source image is protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceImageId": "A String", # Output only. [Output Only]
+        # The ID value of the image used to create this image. This value may be used
+        # to determine whether the image was taken from the current or a previous
+        # instance of a given image name.
+    "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+        # The following are valid formats for the URL:
+        #
+        #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+        #    snapshots/snapshot_name
+        #    - projects/project_id/global/snapshots/snapshot_name
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+    "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+        # the source snapshot is protected by a customer-supplied encryption key.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceSnapshotId": "A String", # Output only. [Output Only]
+        # The ID value of the snapshot used to create this image. This value may be
+        # used to determine whether the snapshot was taken from the current or a
+        # previous instance of a given snapshot name.
+    "sourceType": "RAW", # The type of the image used to create this disk. The
+        # default and only valid value is RAW.
+    "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+        # resources, such as instances, only after the image has been successfully
+        # created and the status is set to READY. Possible
+        # values are FAILED, PENDING, orREADY.
+    "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+        # multi-regional).
+      "A String",
+    ],
+  },
+}
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Returns a list of global ImageView resources, with a regional
+context.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  region: string, Required. Name of the region 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.
+  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 ImageViewsService.List
+  "etag": "A String", # Etag of the resource.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Image resources.
+    { # Represents a read-only view of a global Image resource.
+      "image": { # Represents an Image resource. # The Image resource.
+          #
+          # You can use images to create boot disks for your VM instances.
+          # For more information, read Images.
+        "architecture": "A String", # The architecture of the image. Valid values are
+            # ARM64 or X86_64.
+        "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+            # Storage (in bytes).
+        "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+            # text format.
+        "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+              # resource is intended to change to DELETED. This is only
+              # informational and the status will not change unless the client explicitly
+              # changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+              # resource is intended to change to DEPRECATED. This is only
+              # informational and the status will not change unless the client explicitly
+              # changes it.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+              # resource is intended to change to OBSOLETE. This is only
+              # informational and the status will not change unless the client explicitly
+              # changes it.
+          "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+              # The suggested replacement resource must be the same kind of resource as the
+              # deprecated resource.
+          "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+              # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+              # warning indicating the deprecated resource and recommending its
+              # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+        },
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+        "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+            # [Output Only]: This field is not set by user, but from source disk.
+        "family": "A String", # The name of the image family to which this image belongs. The image
+            # family name can be from a publicly managed image family provided by
+            # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+            # For more information, see Image
+            # family best practices.
+            #
+            # When creating disks, you can specify an image family instead of a specific
+            # image name. The image family always returns its latest image that is not
+            # deprecated. The name of the image family must comply with RFC1035.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+            # defined by the server.
+        "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+            # encryption key.
+            #
+            # After you encrypt an image with a customer-supplied key, you must provide
+            # the same key if you use the image later (e.g. to create a disk from
+            # the image).
+            #
+            # Customer-supplied encryption keys do not protect access to metadata
+            # of the disk.
+            #
+            # If you do not provide an encryption key when creating the image, then the
+            # disk will be encrypted using an automatically generated key and you do not
+            # need to provide a key to use the image later.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+            # images.
+        "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+            # essentially a hash of the labels used for optimistic locking. The
+            # fingerprint is initially generated by Compute Engine and changes after
+            # every request to modify or update labels. You must always provide an
+            # up-to-date fingerprint hash in order to update or change labels,
+            # otherwise the request will fail with error412 conditionNotMet.
+            #
+            # To see the latest fingerprint, make a get() request to
+            # retrieve an image.
+        "labels": { # Labels to apply to this image. These can be later modified by
+            # the setLabels method.
+          "a_key": "A String",
+        },
+        "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+          "A String",
+        ],
+        "licenses": [ # Any applicable license URI.
+          "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.
+        "params": { # Additional image params. # Input only. [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 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/{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",
+          },
+        },
+        "rawDisk": { # The parameters of the raw disk image.
+          "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+              # a runtime format. Provided by the client when the disk image is created.
+          "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+              # An optional SHA1 checksum of the disk image before unpackaging provided
+              # by the client when the disk image is created.
+          "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+              # disk image archive is stored.
+              # The following are valid formats:
+              #
+              #    - https://storage.googleapis.com/bucket_name/image_archive_name
+              #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+              #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+              #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+              #
+              #
+              #
+              # In order to create an image, you must provide the full or partial URL of
+              # one of the following:
+              #
+              #    - The rawDisk.source URL
+              #    - The sourceDisk URL
+              #    - The sourceImage URL
+              #    - The sourceSnapshot URL
+        },
+        "satisfiesPzi": True or False, # Output only. Reserved for future use.
+        "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+        "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "sourceDisk": "A String", # URL of the source disk used to create this image.
+            # For example, the following are valid values:
+            #
+            #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+            #
+            #
+            #
+            # In order to create an image, you must provide the full or partial URL of
+            # one of the following:
+            #
+            #    - The rawDisk.source URL
+            #    - The sourceDisk URL
+            #    - The sourceImage URL
+            #    - The sourceSnapshot URL
+        "sourceDiskEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source disk. Required if the source disk is
+            # protected by a customer-supplied encryption key.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceDiskId": "A String", # Output only. [Output Only]
+            # The ID value of the disk used to create this image. This value may be used
+            # to determine whether the image was taken from the current or a previous
+            # instance of a given disk name.
+        "sourceImage": "A String", # URL of the source image used to create this image.
+            # The following are valid formats for the URL:
+            #
+            #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+            #    images/image_name
+            #    - projects/project_id/global/images/image_name
+            #
+            #
+            #
+            # In order to create an image, you must provide the full or partial URL of
+            # one of the following:
+            #
+            #    - The rawDisk.source URL
+            #    - The sourceDisk URL
+            #    - The sourceImage URL
+            #    - The sourceSnapshot URL
+        "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+            # source image is protected by a customer-supplied encryption key.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceImageId": "A String", # Output only. [Output Only]
+            # The ID value of the image used to create this image. This value may be used
+            # to determine whether the image was taken from the current or a previous
+            # instance of a given image name.
+        "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+            # The following are valid formats for the URL:
+            #
+            #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+            #    snapshots/snapshot_name
+            #    - projects/project_id/global/snapshots/snapshot_name
+            #
+            #
+            #
+            # In order to create an image, you must provide the full or partial URL of
+            # one of the following:
+            #
+            #    - The rawDisk.source URL
+            #    - The sourceDisk URL
+            #    - The sourceImage URL
+            #    - The sourceSnapshot URL
+        "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+            # the source snapshot is protected by a customer-supplied encryption key.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceSnapshotId": "A String", # Output only. [Output Only]
+            # The ID value of the snapshot used to create this image. This value may be
+            # used to determine whether the snapshot was taken from the current or a
+            # previous instance of a given snapshot name.
+        "sourceType": "RAW", # The type of the image used to create this disk. The
+            # default and only valid value is RAW.
+        "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+            # resources, such as instances, only after the image has been successfully
+            # created and the status is set to READY. Possible
+            # values are FAILED, PENDING, orREADY.
+        "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+            # multi-regional).
+          "A String",
+        ],
+      },
+    },
+  ],
+  "kind": "compute#imageViewList",
+  "nextPageToken": "A String",
+  "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.
+  },
+}
+
+ +
+ 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/compute_preview.images.html b/docs/dyn/compute_preview.images.html new file mode 100644 index 0000000000..657594582a --- /dev/null +++ b/docs/dyn/compute_preview.images.html @@ -0,0 +1,5508 @@ + + + +

Compute Engine API . images

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, image, requestId=None, x__xgafv=None)

+

Deletes the specified image.

+

+ deprecate(project, image, body=None, requestId=None, x__xgafv=None)

+

Sets the deprecation status of an image.

+

+ get(project, image, x__xgafv=None)

+

Returns the specified image.

+

+ getFromFamily(project, family, x__xgafv=None)

+

Returns the latest image that is part of an image family and is not

+

+ 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, forceCreate=None, requestId=None, x__xgafv=None)

+

Creates an image in the specified project using the data included

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of custom images

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, image, body=None, requestId=None, x__xgafv=None)

+

Patches the specified image with the data included in the request.

+

+ setIamPolicy(project, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on an image. To learn more about labels, read theLabeling

+

+ 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, image, requestId=None, x__xgafv=None) + 
Deletes the specified image.
+
+Args:
+  project: string, Project ID for this request. (required)
+  image: string, Name of the image 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deprecate(project, image, body=None, requestId=None, x__xgafv=None) + 
Sets the deprecation status of an image.
+
+If an empty request body is given, clears the deprecation status instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  image: string, Image name. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Deprecation status for a public resource.
+  "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+      # resource is intended to change to DELETED. This is only
+      # informational and the status will not change unless the client explicitly
+      # changes it.
+  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+      # resource is intended to change to DEPRECATED. This is only
+      # informational and the status will not change unless the client explicitly
+      # changes it.
+  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+      # resource is intended to change to OBSOLETE. This is only
+      # informational and the status will not change unless the client explicitly
+      # changes it.
+  "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+      # The suggested replacement resource must be the same kind of resource as the
+      # deprecated resource.
+  "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+      # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+      # warning indicating the deprecated resource and recommending its
+      # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, image, x__xgafv=None) + 
Returns the specified image.
+
+Args:
+  project: string, Project ID for this request. (required)
+  image: string, Name of the image 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 an Image resource.
+    #
+    # You can use images to create boot disks for your VM instances.
+    # For more information, read Images.
+  "architecture": "A String", # The architecture of the image. Valid values are
+      # ARM64 or X86_64.
+  "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+      # Storage (in bytes).
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+  "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "family": "A String", # The name of the image family to which this image belongs. The image
+      # family name can be from a publicly managed image family provided by
+      # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+      # For more information, see Image
+      # family best practices.
+      #
+      # When creating disks, you can specify an image family instead of a specific
+      # image name. The image family always returns its latest image that is not
+      # deprecated. The name of the image family must comply with RFC1035.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+      # encryption key.
+      #
+      # After you encrypt an image with a customer-supplied key, you must provide
+      # the same key if you use the image later (e.g. to create a disk from
+      # the image).
+      #
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the disk.
+      #
+      # If you do not provide an encryption key when creating the image, then the
+      # disk will be encrypted using an automatically generated key and you do not
+      # need to provide a key to use the image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+      # images.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+      # essentially a hash of the labels used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an image.
+  "labels": { # Labels to apply to this image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+    "A String",
+  ],
+  "licenses": [ # Any applicable license URI.
+    "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.
+  "params": { # Additional image params. # Input only. [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 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/{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",
+    },
+  },
+  "rawDisk": { # The parameters of the raw disk image.
+    "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+        # a runtime format. Provided by the client when the disk image is created.
+    "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+        # An optional SHA1 checksum of the disk image before unpackaging provided
+        # by the client when the disk image is created.
+    "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+        # disk image archive is stored.
+        # The following are valid formats:
+        #
+        #    - https://storage.googleapis.com/bucket_name/image_archive_name
+        #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+      # these are public keys which are safe to store in public
+    "dbs": [ # The Key Database (db).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "dbxs": [ # The forbidden key database (dbx).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "keks": [ # The Key Exchange Key (KEK).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "pk": { # The Platform Key (PK).
+      "content": "A String", # The raw content in the secure keys file.
+      "fileType": "A String", # The file type of source file.
+    },
+  },
+  "sourceDisk": "A String", # URL of the source disk used to create this image.
+      # For example, the following are valid values:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #    - projects/project/zones/zone/disks/disk
+      #    - zones/zone/disks/disk
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceDiskEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskId": "A String", # Output only. [Output Only]
+      # The ID value of the disk used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given disk name.
+  "sourceImage": "A String", # URL of the source image used to create this image.
+      # The following are valid formats for the URL:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    images/image_name
+      #    - projects/project_id/global/images/image_name
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+      # source image is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only]
+      # The ID value of the image used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given image name.
+  "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+      # The following are valid formats for the URL:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    snapshots/snapshot_name
+      #    - projects/project_id/global/snapshots/snapshot_name
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+      # the source snapshot is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only]
+      # The ID value of the snapshot used to create this image. This value may be
+      # used to determine whether the snapshot was taken from the current or a
+      # previous instance of a given snapshot name.
+  "sourceType": "RAW", # The type of the image used to create this disk. The
+      # default and only valid value is RAW.
+  "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+      # resources, such as instances, only after the image has been successfully
+      # created and the status is set to READY. Possible
+      # values are FAILED, PENDING, orREADY.
+  "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+ +
+ getFromFamily(project, family, x__xgafv=None) + 
Returns the latest image that is part of an image family and is not
+deprecated. For more information on image families, seePublic
+image families documentation.
+
+Args:
+  project: string, The image project that the image belongs to. For example, to get a CentOS
+image, specify centos-cloud as the image project. (required)
+  family: string, Name of the image family to search for. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Image resource.
+    #
+    # You can use images to create boot disks for your VM instances.
+    # For more information, read Images.
+  "architecture": "A String", # The architecture of the image. Valid values are
+      # ARM64 or X86_64.
+  "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+      # Storage (in bytes).
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+  "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "family": "A String", # The name of the image family to which this image belongs. The image
+      # family name can be from a publicly managed image family provided by
+      # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+      # For more information, see Image
+      # family best practices.
+      #
+      # When creating disks, you can specify an image family instead of a specific
+      # image name. The image family always returns its latest image that is not
+      # deprecated. The name of the image family must comply with RFC1035.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+      # encryption key.
+      #
+      # After you encrypt an image with a customer-supplied key, you must provide
+      # the same key if you use the image later (e.g. to create a disk from
+      # the image).
+      #
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the disk.
+      #
+      # If you do not provide an encryption key when creating the image, then the
+      # disk will be encrypted using an automatically generated key and you do not
+      # need to provide a key to use the image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+      # images.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+      # essentially a hash of the labels used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an image.
+  "labels": { # Labels to apply to this image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+    "A String",
+  ],
+  "licenses": [ # Any applicable license URI.
+    "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.
+  "params": { # Additional image params. # Input only. [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 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/{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",
+    },
+  },
+  "rawDisk": { # The parameters of the raw disk image.
+    "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+        # a runtime format. Provided by the client when the disk image is created.
+    "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+        # An optional SHA1 checksum of the disk image before unpackaging provided
+        # by the client when the disk image is created.
+    "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+        # disk image archive is stored.
+        # The following are valid formats:
+        #
+        #    - https://storage.googleapis.com/bucket_name/image_archive_name
+        #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+        #
+        #
+        #
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        #
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+      # these are public keys which are safe to store in public
+    "dbs": [ # The Key Database (db).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "dbxs": [ # The forbidden key database (dbx).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "keks": [ # The Key Exchange Key (KEK).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "pk": { # The Platform Key (PK).
+      "content": "A String", # The raw content in the secure keys file.
+      "fileType": "A String", # The file type of source file.
+    },
+  },
+  "sourceDisk": "A String", # URL of the source disk used to create this image.
+      # For example, the following are valid values:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #    - projects/project/zones/zone/disks/disk
+      #    - zones/zone/disks/disk
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceDiskEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskId": "A String", # Output only. [Output Only]
+      # The ID value of the disk used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given disk name.
+  "sourceImage": "A String", # URL of the source image used to create this image.
+      # The following are valid formats for the URL:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    images/image_name
+      #    - projects/project_id/global/images/image_name
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+      # source image is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only]
+      # The ID value of the image used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given image name.
+  "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+      # The following are valid formats for the URL:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    snapshots/snapshot_name
+      #    - projects/project_id/global/snapshots/snapshot_name
+      #
+      #
+      #
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      #
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+      # the source snapshot is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only]
+      # The ID value of the snapshot used to create this image. This value may be
+      # used to determine whether the snapshot was taken from the current or a
+      # previous instance of a given snapshot name.
+  "sourceType": "RAW", # The type of the image used to create this disk. The
+      # default and only valid value is RAW.
+  "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+      # resources, such as instances, only after the image has been successfully
+      # created and the status is set to READY. Possible
+      # values are FAILED, PENDING, orREADY.
+  "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+ +
+ 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, forceCreate=None, requestId=None, x__xgafv=None) + 
Creates an image 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 an Image resource.
+    # 
+    # You can use images to create boot disks for your VM instances.
+    # For more information, read Images.
+  "architecture": "A String", # The architecture of the image. Valid values are
+      # ARM64 or X86_64.
+  "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+      # Storage (in bytes).
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+  "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "family": "A String", # The name of the image family to which this image belongs. The image
+      # family name can be from a publicly managed image family provided by
+      # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+      # For more information, see Image
+      # family best practices.
+      # 
+      # When creating disks, you can specify an image family instead of a specific
+      # image name. The image family always returns its latest image that is not
+      # deprecated. The name of the image family must comply with RFC1035.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt an image with a customer-supplied key, you must provide
+      # the same key if you use the image later (e.g. to create a disk from
+      # the image).
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the disk.
+      # 
+      # If you do not provide an encryption key when creating the image, then the
+      # disk will be encrypted using an automatically generated key and you do not
+      # need to provide a key to use the image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+      # images.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+      # essentially a hash of the labels used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an image.
+  "labels": { # Labels to apply to this image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+    "A String",
+  ],
+  "licenses": [ # Any applicable license URI.
+    "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.
+  "params": { # Additional image params. # Input only. [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 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/{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",
+    },
+  },
+  "rawDisk": { # The parameters of the raw disk image.
+    "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+        # a runtime format. Provided by the client when the disk image is created.
+    "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+        # An optional SHA1 checksum of the disk image before unpackaging provided
+        # by the client when the disk image is created.
+    "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+        # disk image archive is stored.
+        # The following are valid formats:
+        # 
+        #    - https://storage.googleapis.com/bucket_name/image_archive_name
+        #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+        # 
+        # 
+        # 
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        # 
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+      # these are public keys which are safe to store in public
+    "dbs": [ # The Key Database (db).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "dbxs": [ # The forbidden key database (dbx).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "keks": [ # The Key Exchange Key (KEK).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "pk": { # The Platform Key (PK).
+      "content": "A String", # The raw content in the secure keys file.
+      "fileType": "A String", # The file type of source file.
+    },
+  },
+  "sourceDisk": "A String", # URL of the source disk used to create this image.
+      # For example, the following are valid values:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #    - projects/project/zones/zone/disks/disk
+      #    - zones/zone/disks/disk
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceDiskEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskId": "A String", # Output only. [Output Only]
+      # The ID value of the disk used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given disk name.
+  "sourceImage": "A String", # URL of the source image used to create this image.
+      # The following are valid formats for the URL:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    images/image_name
+      #    - projects/project_id/global/images/image_name
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+      # source image is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only]
+      # The ID value of the image used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given image name.
+  "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+      # The following are valid formats for the URL:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    snapshots/snapshot_name
+      #    - projects/project_id/global/snapshots/snapshot_name
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+      # the source snapshot is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only]
+      # The ID value of the snapshot used to create this image. This value may be
+      # used to determine whether the snapshot was taken from the current or a
+      # previous instance of a given snapshot name.
+  "sourceType": "RAW", # The type of the image used to create this disk. The
+      # default and only valid value is RAW.
+  "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+      # resources, such as instances, only after the image has been successfully
+      # created and the status is set to READY. Possible
+      # values are FAILED, PENDING, orREADY.
+  "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+  forceCreate: boolean, Force image creation if true.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of custom images
+available to the specified project. Custom images are images you
+create that belong to your project. This method does not
+get any images that belong to other projects, including publicly-available
+images, like Debian 8. If you want to get a list of publicly-available
+images, use this method to make a request to the respective image project,
+such as debian-cloud or windows-cloud.
+
+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.
+  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 images.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Image resources.
+    { # Represents an Image resource.
+        #
+        # You can use images to create boot disks for your VM instances.
+        # For more information, read Images.
+      "architecture": "A String", # The architecture of the image. Valid values are
+          # ARM64 or X86_64.
+      "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+          # Storage (in bytes).
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+      "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+          # [Output Only]: This field is not set by user, but from source disk.
+      "family": "A String", # The name of the image family to which this image belongs. The image
+          # family name can be from a publicly managed image family provided by
+          # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+          # For more information, see Image
+          # family best practices.
+          #
+          # When creating disks, you can specify an image family instead of a specific
+          # image name. The image family always returns its latest image that is not
+          # deprecated. The name of the image family must comply with RFC1035.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+          # encryption key.
+          #
+          # After you encrypt an image with a customer-supplied key, you must provide
+          # the same key if you use the image later (e.g. to create a disk from
+          # the image).
+          #
+          # Customer-supplied encryption keys do not protect access to metadata
+          # of the disk.
+          #
+          # If you do not provide an encryption key when creating the image, then the
+          # disk will be encrypted using an automatically generated key and you do not
+          # need to provide a key to use the image later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+          # images.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+          # essentially a hash of the labels used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an image.
+      "labels": { # Labels to apply to this image. These can be later modified by
+          # the setLabels method.
+        "a_key": "A String",
+      },
+      "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+        "A String",
+      ],
+      "licenses": [ # Any applicable license URI.
+        "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.
+      "params": { # Additional image params. # Input only. [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 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/{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",
+        },
+      },
+      "rawDisk": { # The parameters of the raw disk image.
+        "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+            # a runtime format. Provided by the client when the disk image is created.
+        "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+            # An optional SHA1 checksum of the disk image before unpackaging provided
+            # by the client when the disk image is created.
+        "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+            # disk image archive is stored.
+            # The following are valid formats:
+            #
+            #    - https://storage.googleapis.com/bucket_name/image_archive_name
+            #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+            #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+            #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+            #
+            #
+            #
+            # In order to create an image, you must provide the full or partial URL of
+            # one of the following:
+            #
+            #    - The rawDisk.source URL
+            #    - The sourceDisk URL
+            #    - The sourceImage URL
+            #    - The sourceSnapshot URL
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+          # these are public keys which are safe to store in public
+        "dbs": [ # The Key Database (db).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "dbxs": [ # The forbidden key database (dbx).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "keks": [ # The Key Exchange Key (KEK).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "pk": { # The Platform Key (PK).
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      },
+      "sourceDisk": "A String", # URL of the source disk used to create this image.
+          # For example, the following are valid values:
+          #
+          #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+          #    - projects/project/zones/zone/disks/disk
+          #    - zones/zone/disks/disk
+          #
+          #
+          #
+          # In order to create an image, you must provide the full or partial URL of
+          # one of the following:
+          #
+          #    - The rawDisk.source URL
+          #    - The sourceDisk URL
+          #    - The sourceImage URL
+          #    - The sourceSnapshot URL
+      "sourceDiskEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source disk. Required if the source disk is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceDiskId": "A String", # Output only. [Output Only]
+          # The ID value of the disk used to create this image. This value may be used
+          # to determine whether the image was taken from the current or a previous
+          # instance of a given disk name.
+      "sourceImage": "A String", # URL of the source image used to create this image.
+          # The following are valid formats for the URL:
+          #
+          #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+          #    images/image_name
+          #    - projects/project_id/global/images/image_name
+          #
+          #
+          #
+          # In order to create an image, you must provide the full or partial URL of
+          # one of the following:
+          #
+          #    - The rawDisk.source URL
+          #    - The sourceDisk URL
+          #    - The sourceImage URL
+          #    - The sourceSnapshot URL
+      "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+          # source image is protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceImageId": "A String", # Output only. [Output Only]
+          # The ID value of the image used to create this image. This value may be used
+          # to determine whether the image was taken from the current or a previous
+          # instance of a given image name.
+      "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+          # The following are valid formats for the URL:
+          #
+          #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+          #    snapshots/snapshot_name
+          #    - projects/project_id/global/snapshots/snapshot_name
+          #
+          #
+          #
+          # In order to create an image, you must provide the full or partial URL of
+          # one of the following:
+          #
+          #    - The rawDisk.source URL
+          #    - The sourceDisk URL
+          #    - The sourceImage URL
+          #    - The sourceSnapshot URL
+      "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+          # the source snapshot is protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceSnapshotId": "A String", # Output only. [Output Only]
+          # The ID value of the snapshot used to create this image. This value may be
+          # used to determine whether the snapshot was taken from the current or a
+          # previous instance of a given snapshot name.
+      "sourceType": "RAW", # The type of the image used to create this disk. The
+          # default and only valid value is RAW.
+      "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+          # resources, such as instances, only after the image has been successfully
+          # created and the status is set to READY. Possible
+          # values are FAILED, PENDING, orREADY.
+      "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#imageList", # 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.
+  "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, image, body=None, requestId=None, x__xgafv=None) + 
Patches the specified image with the data included in the request.
+Only the following fields can be modified: family, description,
+deprecation status.
+
+Args:
+  project: string, Project ID for this request. (required)
+  image: string, Name of the image resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Image resource.
+    # 
+    # You can use images to create boot disks for your VM instances.
+    # For more information, read Images.
+  "architecture": "A String", # The architecture of the image. Valid values are
+      # ARM64 or X86_64.
+  "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud
+      # Storage (in bytes).
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
+  "enableConfidentialCompute": True or False, # Output only. Whether this image is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "family": "A String", # The name of the image family to which this image belongs. The image
+      # family name can be from a publicly managed image family provided by
+      # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
+      # For more information, see Image
+      # family best practices.
+      # 
+      # When creating disks, you can specify an image family instead of a specific
+      # image name. The image family always returns its latest image that is not
+      # deprecated. The name of the image family must comply with RFC1035.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "imageEncryptionKey": { # Encrypts the image using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt an image with a customer-supplied key, you must provide
+      # the same key if you use the image later (e.g. to create a disk from
+      # the image).
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the disk.
+      # 
+      # If you do not provide an encryption key when creating the image, then the
+      # disk will be encrypted using an automatically generated key and you do not
+      # need to provide a key to use the image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "kind": "compute#image", # Output only. [Output Only] Type of the resource. Always compute#image for
+      # images.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is
+      # essentially a hash of the labels used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an image.
+  "labels": { # Labels to apply to this image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this image.
+    "A String",
+  ],
+  "licenses": [ # Any applicable license URI.
+    "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.
+  "params": { # Additional image params. # Input only. [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 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/{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",
+    },
+  },
+  "rawDisk": { # The parameters of the raw disk image.
+    "containerType": "A String", # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
+        # a runtime format. Provided by the client when the disk image is created.
+    "sha1Checksum": "A String", # [Deprecated] This field is deprecated.
+        # An optional SHA1 checksum of the disk image before unpackaging provided
+        # by the client when the disk image is created.
+    "source": "A String", # The full Google Cloud Storage URL or Artifact Registry path where the raw
+        # disk image archive is stored.
+        # The following are valid formats:
+        # 
+        #    - https://storage.googleapis.com/bucket_name/image_archive_name
+        #    - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
+        #    - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
+        # 
+        # 
+        # 
+        # In order to create an image, you must provide the full or partial URL of
+        # one of the following:
+        # 
+        #    - The rawDisk.source URL
+        #    - The sourceDisk URL
+        #    - The sourceImage URL
+        #    - The sourceSnapshot URL
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shieldedInstanceInitialState": { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
+      # these are public keys which are safe to store in public
+    "dbs": [ # The Key Database (db).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "dbxs": [ # The forbidden key database (dbx).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "keks": [ # The Key Exchange Key (KEK).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "pk": { # The Platform Key (PK).
+      "content": "A String", # The raw content in the secure keys file.
+      "fileType": "A String", # The file type of source file.
+    },
+  },
+  "sourceDisk": "A String", # URL of the source disk used to create this image.
+      # For example, the following are valid values:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #    - projects/project/zones/zone/disks/disk
+      #    - zones/zone/disks/disk
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceDiskEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskId": "A String", # Output only. [Output Only]
+      # The ID value of the disk used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given disk name.
+  "sourceImage": "A String", # URL of the source image used to create this image.
+      # The following are valid formats for the URL:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    images/image_name
+      #    - projects/project_id/global/images/image_name
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceImageEncryptionKey": { # The customer-supplied encryption key of the source image. Required if the
+      # source image is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only]
+      # The ID value of the image used to create this image. This value may be used
+      # to determine whether the image was taken from the current or a previous
+      # instance of a given image name.
+  "sourceSnapshot": "A String", # URL of the source snapshot used to create this image.
+      # The following are valid formats for the URL:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project_id/global/
+      #    snapshots/snapshot_name
+      #    - projects/project_id/global/snapshots/snapshot_name
+      # 
+      # 
+      # 
+      # In order to create an image, you must provide the full or partial URL of
+      # one of the following:
+      # 
+      #    - The rawDisk.source URL
+      #    - The sourceDisk URL
+      #    - The sourceImage URL
+      #    - The sourceSnapshot URL
+  "sourceSnapshotEncryptionKey": { # The customer-supplied encryption key of the source snapshot. Required if
+      # the source snapshot is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only]
+      # The ID value of the snapshot used to create this image. This value may be
+      # used to determine whether the snapshot was taken from the current or a
+      # previous instance of a given snapshot name.
+  "sourceType": "RAW", # The type of the image used to create this disk. The
+      # default and only valid value is RAW.
+  "status": "A String", # Output only. [Output Only] The status of the image. An image can be used to create other
+      # resources, such as instances, only after the image has been successfully
+      # created and the status is set to READY. Possible
+      # values are FAILED, PENDING, orREADY.
+  "storageLocations": [ # Cloud Storage bucket storage location of the image (regional or
+      # multi-regional).
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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).
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on an image. To learn more about labels, read theLabeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.instanceGroupManagerResizeRequests.html b/docs/dyn/compute_preview.instanceGroupManagerResizeRequests.html new file mode 100644 index 0000000000..9788426d0f --- /dev/null +++ b/docs/dyn/compute_preview.instanceGroupManagerResizeRequests.html @@ -0,0 +1,2174 @@ + + + +

Compute Engine API . instanceGroupManagerResizeRequests

+

Instance Methods

+

+ cancel(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)

+

Cancels the specified resize request and removes it from the queue.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)

+

Deletes the specified, inactive resize request. Requests that are still

+

+ get(project, zone, instanceGroupManager, resizeRequest, x__xgafv=None)

+

Returns all of the details about the specified resize request.

+

+ insert(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Creates a new resize request that starts provisioning VMs immediately

+

+ list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of resize requests that are contained in the

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ cancel(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None) + 
Cancels the specified resize request and removes it from the queue.
+Cancelled resize request does no longer wait for the resources to be
+provisioned. Cancel is only possible for requests that are accepted in the
+queue.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. The name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+The name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request to cancel.
+The name should conform to RFC1035 or be a resource ID. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None) + 
Deletes the specified, inactive resize request. Requests that are still
+active cannot be deleted. Deleting request does not delete instances that
+were provisioned previously.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. The name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+The name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request to delete.
+The name should conform to RFC1035 or be a resource ID. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instanceGroupManager, resizeRequest, x__xgafv=None) + 
Returns all of the details about the specified resize request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the href="/compute/docs/regions-zones/#available">zone
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+Name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request.
+Name should conform to RFC1035 or be a resource ID. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # InstanceGroupManagerResizeRequest represents a request to create
+    # a number of VMs: either immediately or by queuing the request for the
+    # specified time. This resize request is nested under InstanceGroupManager
+    # and the VMs created by this request are added to the owning
+    # InstanceGroupManager.
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+      # identifier.
+  "instances": [ # The names of instances to be created by this resize request. The number of
+      # names specified determines the number of instances to create. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'resize_by'.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+  "name": "A String", # The name of this resize request. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "region": "A String", # Output only. The URL of a region
+      # where the resize request is located. Populated only for regional resize
+      # requests.
+  "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+      # At the end of the run duration instance will be deleted.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'instances'.
+  "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. Current state of the request.
+  "status": { # Output only. Status of the request.
+    "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+        # the ResizeRequest that caused the transition to the FAILED state.
+        # Contrary to the last_attempt errors, this field is final and errors are
+        # never removed from here, as the ResizeRequest is not going to retry.
+      "errors": [ # [Output Only] The array of errors encountered while processing this
+          # operation.
+        { # Represents a single error encountered during the processing of an
+            # 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.
+            { # Container for structured error details providing additional context
+                # specific to the encountered error code.
+              "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                  #
+                  # 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. # Links and information to help the user resolve the error.
+                  #
+                  # 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 # A localized human-readable error message intended for end users.
+                  # 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. # Details about quota limits and metrics when a quota is exceeded.
+                "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.
+        },
+      ],
+    },
+    "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+        # temporary since the ResizeRequest can retry, as long as it's still active
+        # and the last attempt value can either be cleared or replaced with a
+        # different error. Since ResizeRequest retries infrequently, the value may
+        # be stale and no longer show an active problem. The value is cleared when
+        # ResizeRequest transitions to the final state (becomes inactive). If the
+        # final state is FAILED the error describing it will be stored in the
+        # "error" field only.
+      "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+        "errors": [ # [Output Only] The array of errors encountered while processing this
+            # operation.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+    },
+  },
+  "zone": "A String", # Output only. The URL of a zone
+      # where the resize request is located. Populated only for zonal resize
+      # requests.
+}
+
+ +
+ insert(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Creates a new resize request that starts provisioning VMs immediately
+or queues VM creation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located and where the resize request will be created.
+Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group to which the resize request will
+be added.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # InstanceGroupManagerResizeRequest represents a request to create
+    # a number of VMs: either immediately or by queuing the request for the
+    # specified time. This resize request is nested under InstanceGroupManager
+    # and the VMs created by this request are added to the owning
+    # InstanceGroupManager.
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+      # identifier.
+  "instances": [ # The names of instances to be created by this resize request. The number of
+      # names specified determines the number of instances to create. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'resize_by'.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+  "name": "A String", # The name of this resize request. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "region": "A String", # Output only. The URL of a region
+      # where the resize request is located. Populated only for regional resize
+      # requests.
+  "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+      # At the end of the run duration instance will be deleted.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'instances'.
+  "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. Current state of the request.
+  "status": { # Output only. Status of the request.
+    "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+        # the ResizeRequest that caused the transition to the FAILED state.
+        # Contrary to the last_attempt errors, this field is final and errors are
+        # never removed from here, as the ResizeRequest is not going to retry.
+      "errors": [ # [Output Only] The array of errors encountered while processing this
+          # operation.
+        { # Represents a single error encountered during the processing of an
+            # 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.
+            { # Container for structured error details providing additional context
+                # specific to the encountered error code.
+              "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                  #
+                  # 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. # Links and information to help the user resolve the error.
+                  #
+                  # 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 # A localized human-readable error message intended for end users.
+                  # 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. # Details about quota limits and metrics when a quota is exceeded.
+                "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.
+        },
+      ],
+    },
+    "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+        # temporary since the ResizeRequest can retry, as long as it's still active
+        # and the last attempt value can either be cleared or replaced with a
+        # different error. Since ResizeRequest retries infrequently, the value may
+        # be stale and no longer show an active problem. The value is cleared when
+        # ResizeRequest transitions to the final state (becomes inactive). If the
+        # final state is FAILED the error describing it will be stored in the
+        # "error" field only.
+      "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+        "errors": [ # [Output Only] The array of errors encountered while processing this
+            # operation.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+    },
+  },
+  "zone": "A String", # Output only. The URL of a zone
+      # where the resize request is located. Populated only for zonal resize
+      # requests.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of resize requests that are contained in the
+managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. The name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group. The 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [Output Only] A list of resize requests.
+  "id": "A String", # Output only. Unique identifier for the resource; defined by the server.
+  "items": [ # A list of resize request resources.
+    { # InstanceGroupManagerResizeRequest represents a request to create
+        # a number of VMs: either immediately or by queuing the request for the
+        # specified time. This resize request is nested under InstanceGroupManager
+        # and the VMs created by this request are added to the owning
+        # InstanceGroupManager.
+      "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource.
+      "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+          # identifier.
+      "instances": [ # The names of instances to be created by this resize request. The number of
+          # names specified determines the number of instances to create. The group's
+          # target size will be increased by this number. This field cannot be used
+          # together with 'resize_by'.
+        {
+          "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+              # optimistic locking. It is ignored when inserting a per-instance
+              # config. An up-to-date fingerprint must be provided in order to update an
+              # existing per-instance configuration or the field needs to be unset.
+          "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+              # Serves as a merge key during UpdatePerInstanceConfigs
+              # operations, that is, if a per-instance configuration with the same name
+              # exists then it will be updated, otherwise a new one will be created for the
+              # VM instance with the same name. An attempt to create a per-instance
+              # configuration for a VM instance that either doesn't exist or is not part
+              # of the group will result in an error.
+          "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+              # preserved state generated from a stateful policy.
+            "disks": { # Preserved disks defined for this instance.
+                # This map is keyed with the device names of the disks.
+              "a_key": {
+                "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                    # update, instance recreate operations. This flag is used to configure
+                    # if the disk should be deleted after it is no longer used by the group,
+                    # e.g. when the given instance or the whole MIG is deleted.
+                    # Note: disks attached in READ_ONLY mode cannot be
+                    # auto-deleted.
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                    # disk in READ_WRITE mode.
+                "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                    # to the VM instance.
+              },
+            },
+            "externalIPs": { # Preserved external IPs defined for this instance.
+                # This map is keyed with the name of the network interface.
+              "a_key": {
+                "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                    # update or VM instance recreate operations.
+                    # This flag is used to configure if the IP reservation should be deleted
+                    # after it is no longer used by the group, e.g. when the given instance
+                    # or the whole group is deleted.
+                "ipAddress": { # Ip address representation
+                  "address": "A String", # The URL of the reservation for this IP address.
+                  "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                      # network interface.
+                },
+              },
+            },
+            "internalIPs": { # Preserved internal IPs defined for this instance.
+                # This map is keyed with the name of the network interface.
+              "a_key": {
+                "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                    # update or VM instance recreate operations.
+                    # This flag is used to configure if the IP reservation should be deleted
+                    # after it is no longer used by the group, e.g. when the given instance
+                    # or the whole group is deleted.
+                "ipAddress": { # Ip address representation
+                  "address": "A String", # The URL of the reservation for this IP address.
+                  "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                      # network interface.
+                },
+              },
+            },
+            "metadata": { # Preserved metadata defined for this instance.
+              "a_key": "A String",
+            },
+          },
+          "status": "A String", # The status of applying this per-instance configuration on the corresponding
+              # managed instance.
+        },
+      ],
+      "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+      "name": "A String", # The name of this resize request. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "region": "A String", # Output only. The URL of a region
+          # where the resize request is located. Populated only for regional resize
+          # requests.
+      "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+          # At the end of the run duration instance will be deleted.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+          # target size will be increased by this number. This field cannot be used
+          # together with 'instances'.
+      "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+      "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+      "state": "A String", # Output only. Current state of the request.
+      "status": { # Output only. Status of the request.
+        "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+            # the ResizeRequest that caused the transition to the FAILED state.
+            # Contrary to the last_attempt errors, this field is final and errors are
+            # never removed from here, as the ResizeRequest is not going to retry.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+            # temporary since the ResizeRequest can retry, as long as it's still active
+            # and the last attempt value can either be cleared or replaced with a
+            # different error. Since ResizeRequest retries infrequently, the value may
+            # be stale and no longer show an active problem. The value is cleared when
+            # ResizeRequest transitions to the final state (becomes inactive). If the
+            # final state is FAILED the error describing it will be stored in the
+            # "error" field only.
+          "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+        },
+      },
+      "zone": "A String", # Output only. The URL of a zone
+          # where the resize request is located. Populated only for zonal resize
+          # requests.
+    },
+  ],
+  "kind": "compute#instanceGroupManagerResizeRequestList", # Output only. Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for
+      # a list of resize requests.
+  "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 than maxResults, use thenextPageToken as a value for the query parameterpageToken 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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.instanceGroupManagers.html b/docs/dyn/compute_preview.instanceGroupManagers.html new file mode 100644 index 0000000000..8ace920436 --- /dev/null +++ b/docs/dyn/compute_preview.instanceGroupManagers.html @@ -0,0 +1,13882 @@ + + + +

Compute Engine API . instanceGroupManagers

+

Instance Methods

+

+ abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances to be removed from the

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of managed instance groups and groups them by zone.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)

+

Applies changes to selected instances on the managed instance group.

+

+ close()

+

Close httplib2 connections.

+

+ createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Creates instances with per-instance configurations in this managed instance

+

+ delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Deletes the specified managed instance group and all of the instances

+

+ deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group for immediate

+

+ deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None)

+

Deletes selected per-instance configurations for the managed instance

+

+ get(project, zone, instanceGroupManager, x__xgafv=None)

+

Returns all of the details about the specified managed instance group.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a managed instance group using the information that you specify

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of managed instance groups that are contained within the

+

+ listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all errors thrown by actions on instances for a given managed

+

+ listErrors_next()

+

Retrieves the next page of results.

+

+ listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all of the instances in the managed instance group. Each instance

+

+ listManagedInstances_next()

+

Retrieves the next page of results.

+

+ listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all of the per-instance configurations defined for the managed

+

+ listPerInstanceConfigs_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Updates a managed instance group using the information that you specify

+

+ patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Inserts or patches per-instance configurations for the managed instance

+

+ recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified VM instances in the managed instance group to be

+

+ resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None)

+

Resizes the managed instance group. If you increase the size, the group

+

+ resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Specifies the instance template to use when creating new instances in this

+

+ setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Modifies the target pools to which all instances in this managed instance

+

+ startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Inserts or updates per-instance configurations for the managed instance

+

Method Details

+
+ abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances to be removed from the
+managed instance group. Abandoning an instance does not delete the
+instance, but it does remove the instance from any target pools that are
+applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
+number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
+not yet been removed from the group. You must separately verify the
+status of the abandoning action with thelistmanagedinstances
+method.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to abandon. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of managed instance groups and groups them by zone.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # Output only. Unique identifier for the resource; defined by the server.
+  "items": { # A list of InstanceGroupManagersScopedList resources.
+    "a_key": { # Output only. The name of the scope that contains this set of managed instance groups.
+      "instanceGroupManagers": [ # Output only. The list of managed instance groups that are contained in the specified
+          # project and zone.
+        { # Represents a Managed Instance Group resource.
+            #
+            # An instance group is a collection of VM instances that you can manage as a
+            # single entity. For more information, readInstance groups.
+            #
+            # For zonal Managed Instance Group, use the instanceGroupManagers
+            # resource.
+            #
+            # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+          "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+              # for the group.
+            "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+                #
+                # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+                # instances to apply the configuration. To apply the configuration, set the
+                # group's updatePolicy.type field to use proactive updates or
+                # use the applyUpdatesToInstances method.
+              "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+              "labels": { # The label key-value pairs that you want to patch onto the instance.
+                "a_key": "A String",
+              },
+              "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+                  # more information, see Project and
+                  # instance metadata.
+                "a_key": "A String",
+              },
+            },
+          },
+          "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+              # only one value.
+            {
+              "healthCheck": "A String", # The URL for the health check that signals autohealing.
+              "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+                  # initialize and run its startup script. During a VM's initial delay
+                  # period, the MIG ignores unsuccessful health checks because the VM might
+                  # be in the startup process. This prevents the MIG from prematurely
+                  # recreating a VM. If the health check receives a healthy response during
+                  # the initial delay, it indicates that the startup process is complete and
+                  # the VM is ready. The value of initial delay must be between 0 and 3600
+                  # seconds. The default value is 0.
+            },
+          ],
+          "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+              # all VMs in a MIG. The maximum character length is 58 and the name must
+              # comply with RFC1035 format.
+              #
+              # When a VM is created in the group, the MIG appends a hyphen and a random
+              # four-character string to the base instance name. If you want the MIG to
+              # assign sequential numbers instead of a random string, then end the base
+              # instance name with a hyphen followed by one or more hash symbols. The hash
+              # symbols indicate the number of digits. For example, a base instance name of
+              # "vm-###" results in "vm-001" as a VM name.
+              # @pattern
+              # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+          "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+              # text format.
+          "currentActions": { # Output only. The list of instance actions and the number of instances
+              # in this managed instance group that are scheduled for each of those
+              # actions.
+            "abandoning": 42, # Output only. The total number of instances in the managed instance group
+                # that are scheduled to be abandoned. Abandoning an instance removes it
+                # from the managed instance group without deleting it.
+            "creating": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be created or are currently being created. If the group
+                # fails to create any of these instances, it tries again until it creates
+                # the instance successfully.
+                #
+                # If you have disabled creation retries, this field will not be populated;
+                # instead, the creatingWithoutRetries field will be populated.
+            "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+                # will attempt to create. The group attempts to create each instance
+                # only once. If the group fails to create any of these instances, it
+                # decreases the group's targetSize value accordingly.
+            "deleting": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be deleted or are currently being deleted.
+            "none": 42, # Output only. The number of instances in the managed instance group that
+                # are running and have no scheduled actions.
+            "recreating": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be recreated or are currently being being recreated.
+                # Recreating an instance deletes the existing root persistent disk
+                # and creates a new disk from the image that is defined in the
+                # instance template.
+            "refreshing": 42, # Output only. The number of instances in the managed instance group that
+                # are being reconfigured with properties that do not require a restart
+                # or a recreate action. For example, setting or removing target
+                # pools for the instance.
+            "restarting": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be restarted or are currently being restarted.
+            "resuming": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be resumed or are currently being resumed.
+            "starting": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be started or are currently being started.
+            "stopping": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be stopped or are currently being stopped.
+            "suspending": 42, # Output only. The number of instances in the managed instance group that
+                # are scheduled to be suspended or are currently being suspended.
+            "verifying": 42, # Output only. The number of instances in the managed instance group that
+                # are being verified. See the managedInstances[].currentAction
+                # property in the listManagedInstances method documentation.
+          },
+          "description": "A String", # An optional description of this resource.
+          "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+              # zones in a regional managed instance group.
+            "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+                # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+            "zones": [ # Zones where the regional managed instance group will create and manage
+                # its instances.
+                # By default, a regional MIG doesn't automatically select an AI zone to create
+                # instances, even if an AI zone is available in the specified region. To
+                # create instances in an AI zone in the selected region, you must explicitly
+                # specify it in the distribution policy together with the other preferred
+                # zones.
+              {
+                "zone": "A String", # The URL of thezone.
+                    # The zone must exist in the region where the managed instance group is
+                    # located.
+              },
+            ],
+          },
+          "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+              # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+              # fingerprint must be provided in order to update the InstanceGroupManager,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve an InstanceGroupManager.
+          "id": "A String", # Output only. A unique identifier for this resource type. The server
+              # generates this identifier.
+          "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+              # types of machines.
+              # Instance flexibility configuration on MIG overrides instance
+              # template configuration.
+            "instanceSelections": { # Named instance selections configuring properties that the group will use
+                # when creating new VMs.
+              "a_key": {
+                "disks": [ # List of disks to be attached to the instances created from this
+                    # selection.
+                  { # An instance-attached disk resource.
+                    "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                        # or X86_64.
+                    "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                        # deleted (but not when the disk is detached from the instance).
+                    "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                        # partition of the disk for its root filesystem.
+                    "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                        # running within the instance. This name can be used to reference the device
+                        # for mounting, resizing, and so on, from within the instance.
+                        #
+                        # If not specified, the server chooses a default device name to apply to this
+                        # disk, in the form persistent-disk-x, where x is a number
+                        # assigned by Google Compute Engine. This field is only applicable for
+                        # persistent disks.
+                    "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                        # encryption key.
+                        #
+                        # If you are creating a new disk, this field encrypts the new disk using
+                        # an encryption key that you provide. If you are attaching an existing
+                        # disk that is already encrypted, this field decrypts the disk using
+                        # the customer-supplied encryption key.
+                        #
+                        # If you encrypt a disk using a customer-supplied key, you must provide the
+                        # same key again when you attempt to use this resource at a later time. For
+                        # example, you must provide the key when you create a snapshot or an image
+                        # from the disk or when you attach the disk to a virtual machine instance.
+                        #
+                        # If you do not provide an encryption key, then the disk will be encrypted
+                        # using an automatically generated key and you do not need to provide a key
+                        # to use the disk later.
+                        #
+                        # Note:
+                        #
+                        # Instance templates do not storecustomer-supplied
+                        # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                        #
+                        # You cannot create VMs that have disks with customer-supplied keys using
+                        # the bulk
+                        # insert method.
+                      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                          # For example:
+                          #
+                          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                          # key_region/cryptoKeys/key
+                          #
+                          # The fully-qualifed key name may be returned for resource GET requests. For
+                          # example:
+                          #
+                          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                          # key_region/cryptoKeys/key
+                          # /cryptoKeyVersions/1
+                      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                          # key. If absent, the Compute Engine default service account is used.
+                          # For example:
+                          #
+                          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                          # Specifies a 256-bit customer-supplied
+                          # encryption key, encoded in RFC
+                          # 4648 base64 to either encrypt or decrypt this resource. You can
+                          # provide either the rawKey or thersaEncryptedKey.
+                          # For example:
+                          #
+                          # "rawKey":
+                          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                          # customer-supplied encryption key to either encrypt or decrypt this
+                          # resource. You can provide either the rawKey or thersaEncryptedKey.
+                          # For example:
+                          #
+                          # "rsaEncryptedKey":
+                          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                          #
+                          # The key must meet the following requirements before you can provide it to
+                          # Compute Engine:
+                          #
+                          #    1. The key is wrapped using a RSA public key certificate provided by
+                          #    Google.
+                          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                          #    encoding.
+                          #
+                          # Gets the RSA public key certificate provided by Google at:
+                          #
+                          #
+                          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                          # [Output only] TheRFC
+                          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                          # encryption key that protects this resource.
+                    },
+                    "diskSizeGb": "A String", # The size of the disk in GB.
+                    "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                        # currently attached to another instance. If you try to force attach a zonal
+                        # disk to an instance, you will receive an error.
+                    "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                        # only for bootable images. Read
+                        # Enabling guest operating system features to see a list of available
+                        # options.
+                      { # Guest OS features.
+                        "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                            # separate values. Set to one or more of the following values:
+                            #
+                            #    - VIRTIO_SCSI_MULTIQUEUE
+                            #    - WINDOWS
+                            #    - MULTI_IP_SUBNET
+                            #    - UEFI_COMPATIBLE
+                            #    - GVNIC
+                            #    - SEV_CAPABLE
+                            #    - SUSPEND_RESUME_COMPATIBLE
+                            #    - SEV_LIVE_MIGRATABLE_V2
+                            #    - SEV_SNP_CAPABLE
+                            #    - TDX_CAPABLE
+                            #    - IDPF
+                            #    - SNP_SVSM_CAPABLE
+                            #    - CCA_CAPABLE
+                            #    - SUSPEND_SAFE_FPR
+                            #
+                            #
+                            # For more information, see
+                            # Enabling guest operating system features.
+                      },
+                    ],
+                    "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                        # boot disk. If you have many disks attached to an instance, each
+                        # disk would have a unique index number.
+                    "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                        # alongside the new instance. Use initialization parameters to create boot
+                        # disks or local SSDs attached to the new instance.
+                        #
+                        # This property is mutually exclusive with the source property;
+                        # you can only define one or the other, but not both.
+                        # alongside the new instance. Use initialization parameters to create boot
+                        # disks or local SSDs attached to the new instance.
+                        #
+                        # This field is persisted and returned for instanceTemplate and not returned
+                        # in the context of instance.
+                        #
+                        # This property is mutually exclusive with the source property;
+                        # you can only define one or the other, but not both.
+                      "architecture": "A String", # The architecture of the attached disk. Valid values are
+                          # arm64 or x86_64.
+                      "description": "A String", # An optional description. Provide this property when creating the disk.
+                      "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                          # of the instance. If a disk with the same name already exists in the given
+                          # region, the existing disk is attached to the new instance and the
+                          # new disk is not created.
+                      "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                          # 10 GB. If you specify a sourceImage, which is required for
+                          # boot disks, the default size is the size of the sourceImage.
+                          # If you do not specify a sourceImage, the default disk size
+                          # is 500 GB.
+                      "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                          # disk. For valid disk type values, see
+                          # Supported types for Hyperdisk volumes and
+                          # Persistent Disk type variables.
+                          #
+                          # When creating a single instance, you must provide either the full or
+                          # partial URL of the disk type. For example, the following values are
+                          # valid:
+                          #
+                          #
+                          #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                          #      - projects/project/zones/zone/diskTypes/diskType
+                          #      - zones/zone/diskTypes/diskType
+                          #
+                          #
+                          #
+                          # When creating an instance template, instance flexibility policy, or when
+                          # creating or updating an all-instances configuration, you specify the
+                          # disk type without a URL, for example, hyperdisk-balanced.
+                          #
+                          # If you omit this field for a disk, the default disk type depends on
+                          # the instance's machine series, as follows.
+                          #
+                          #
+                          #     - For first- and second-generation machine series like N1, N2, T2, and
+                          #     M1, the
+                          #        default disk type is Standard Persistent Disk
+                          #        (pd-standard).
+                          #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                          #     (pd-balanced).
+                          #    - For other third-generation machine
+                          #     series like A3, H3, Z3, all
+                          #         fourth-generation types like C4, N4, M4, and newer machine series,
+                          #         the default is Hyperdisk Balanced
+                          #         (hyperdisk-balanced).
+                          #
+                          #
+                          #
+                          # The disk type you specify must be compatible with the instance's machine
+                          # series. For a list of machine series that support Persistent Disk, see Machine
+                          # series support for Persistent Disk.
+                          #
+                          # For a list of machine series that support Hyperdisk, seeMachine
+                          # series support for Hyperdisk.
+                      "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+                      "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                          # persistent disks.
+                        "a_key": "A String",
+                      },
+                      "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                        "A String",
+                      ],
+                      "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                          # is to use the existing disk.
+                      "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                          # of I/O operations per second that the disk can handle. Values must be
+                          # between 10,000 and 120,000. For more details, see theExtreme persistent
+                          # disk documentation.
+                      "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                          # number of throughput mb per second that the disk can handle. Values must
+                          # greater than or equal to 1.
+                      "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                          # the URLs of the zones where the disk should be replicated to.
+                          # You must provide exactly two replica zones, and one zone must be the same
+                          # as the instance zone.
+                        "A String",
+                      ],
+                      "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/{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",
+                      },
+                      "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                          # Specified using the full or partial URL. For instance template, specify
+                          # only the resource policy name.
+                        "A String",
+                      ],
+                      "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                          # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                          # is required.
+                          #
+                          # To create a disk with one of the public operating system
+                          # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                          #
+                          # projects/debian-cloud/global/images/family/debian-9
+                          #
+                          #
+                          # Alternatively, use a specific version of a public operating system image:
+                          #
+                          # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                          #
+                          #
+                          # To create a disk with a custom image that you created, specify the
+                          # image name in the following format:
+                          #
+                          # global/images/my-custom-image
+                          #
+                          #
+                          # You can also specify a custom image by its image family, which returns
+                          # the latest version of the image in that family. Replace the image name
+                          # with family/family-name:
+                          #
+                          # global/images/family/my-image-family
+                          #
+                          #
+                          # If the source image is deleted later, this field will not be set.
+                      "sourceImageEncryptionKey": { # Thecustomer-supplied
+                          # encryption key of the source image. Required if the source image is
+                          # protected by a customer-supplied encryption key.
+                          #
+                          # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                          # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                          # source images are encrypted with your own keys.
+                        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                            # For example:
+                            #
+                            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                            # key_region/cryptoKeys/key
+                            #
+                            # The fully-qualifed key name may be returned for resource GET requests. For
+                            # example:
+                            #
+                            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                            # key_region/cryptoKeys/key
+                            # /cryptoKeyVersions/1
+                        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                            # key. If absent, the Compute Engine default service account is used.
+                            # For example:
+                            #
+                            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # Specifies a 256-bit customer-supplied
+                            # encryption key, encoded in RFC
+                            # 4648 base64 to either encrypt or decrypt this resource. You can
+                            # provide either the rawKey or thersaEncryptedKey.
+                            # For example:
+                            #
+                            # "rawKey":
+                            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                            # customer-supplied encryption key to either encrypt or decrypt this
+                            # resource. You can provide either the rawKey or thersaEncryptedKey.
+                            # For example:
+                            #
+                            # "rsaEncryptedKey":
+                            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                            #
+                            # The key must meet the following requirements before you can provide it to
+                            # Compute Engine:
+                            #
+                            #    1. The key is wrapped using a RSA public key certificate provided by
+                            #    Google.
+                            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                            #    encoding.
+                            #
+                            # Gets the RSA public key certificate provided by Google at:
+                            #
+                            #
+                            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # [Output only] TheRFC
+                            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                            # encryption key that protects this resource.
+                      },
+                      "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                          # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                          # is required.
+                          #
+                          # To create a disk with a snapshot that you created, specify the
+                          # snapshot name in the following format:
+                          #
+                          # global/snapshots/my-backup
+                          #
+                          #
+                          # If the source snapshot is deleted later, this field will not be set.
+                          #
+                          # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                          # an image instead when you create VMs using
+                          # the bulk
+                          # insert method.
+                      "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                          # encryption key of the source snapshot.
+                        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                            # For example:
+                            #
+                            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                            # key_region/cryptoKeys/key
+                            #
+                            # The fully-qualifed key name may be returned for resource GET requests. For
+                            # example:
+                            #
+                            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                            # key_region/cryptoKeys/key
+                            # /cryptoKeyVersions/1
+                        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                            # key. If absent, the Compute Engine default service account is used.
+                            # For example:
+                            #
+                            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # Specifies a 256-bit customer-supplied
+                            # encryption key, encoded in RFC
+                            # 4648 base64 to either encrypt or decrypt this resource. You can
+                            # provide either the rawKey or thersaEncryptedKey.
+                            # For example:
+                            #
+                            # "rawKey":
+                            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                            # customer-supplied encryption key to either encrypt or decrypt this
+                            # resource. You can provide either the rawKey or thersaEncryptedKey.
+                            # For example:
+                            #
+                            # "rsaEncryptedKey":
+                            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                            #
+                            # The key must meet the following requirements before you can provide it to
+                            # Compute Engine:
+                            #
+                            #    1. The key is wrapped using a RSA public key certificate provided by
+                            #    Google.
+                            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                            #    encoding.
+                            #
+                            # Gets the RSA public key certificate provided by Google at:
+                            #
+                            #
+                            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                            # [Output only] TheRFC
+                            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                            # encryption key that protects this resource.
+                      },
+                      "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                          #      - projects/project/zones/zone/storagePools/storagePool
+                          #    - zones/zone/storagePools/storagePool
+                    },
+                    "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                        # either SCSI or NVME. For most machine types, the
+                        # default is SCSI. Local SSDs can use either NVME or SCSI.
+                        # In certain configurations, persistent disks can use NVMe. For more
+                        # information, seeAbout
+                        # persistent disks.
+                    "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+                    "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+                      "A String",
+                    ],
+                    "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                        # in READ_WRITE mode.
+                    "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                        # field is set to PRESERVED if the LocalSSD data has been saved
+                        # to a persistent location by customer request.  (see the
+                        # discard_local_ssd option on Stop/Suspend).
+                        # Read-only in the api.
+                    "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                        # these are public keys which are safe to store in public
+                      "dbs": [ # The Key Database (db).
+                        {
+                          "content": "A String", # The raw content in the secure keys file.
+                          "fileType": "A String", # The file type of source file.
+                        },
+                      ],
+                      "dbxs": [ # The forbidden key database (dbx).
+                        {
+                          "content": "A String", # The raw content in the secure keys file.
+                          "fileType": "A String", # The file type of source file.
+                        },
+                      ],
+                      "keks": [ # The Key Exchange Key (KEK).
+                        {
+                          "content": "A String", # The raw content in the secure keys file.
+                          "fileType": "A String", # The file type of source file.
+                        },
+                      ],
+                      "pk": { # The Platform Key (PK).
+                        "content": "A String", # The raw content in the secure keys file.
+                        "fileType": "A String", # The file type of source file.
+                      },
+                    },
+                    "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                        # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                        # is required.
+                        #
+                        # If desired, you can also attach existing non-root persistent disks using
+                        # this property. This field is only applicable for persistent disks.
+                        #
+                        # 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.
+                  },
+                ],
+                "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+                  "A String",
+                ],
+                "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+                    # e.g. 'Intel Ice Lake'.
+                "rank": 42, # Preference of this instance selection. Lower number means higher
+                    # preference. MIG will first try to create a VM based on the machine-type
+                    # with lowest rank and fallback to next rank based on availability.
+                    # Machine types and instance selections with the same rank have the same
+                    # preference.
+              },
+            },
+          },
+          "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+          "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+            "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+                # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+                # applies to the VMs on which your application fails a health check.
+                # Valid values are
+                #
+                #    - REPAIR (default): MIG automatically repairs a failed VM
+                #    by recreating it. For more information, see About
+                #    repairing VMs in a MIG.
+                #    - DO_NOTHING: MIG does not repair a failed VM.
+            "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+                # configuration when repairing a VM. Valid options are:
+                #
+                #
+                #
+                #      -  NO (default): If configuration updates are available, they are not
+                #      forcefully applied during repair. Instead, configuration updates are
+                #      applied according to the group's update policy.
+                #
+                #      -  YES: If configuration updates are available, they are applied
+                #      during repair.
+            "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+                # unhealthy when the application running on that VM fails a health check.
+                # Valid values are:
+                #
+                #    - DEFAULT_ACTION (default): MIG uses the same action
+                #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+                #    - REPAIR: MIG automatically repairs an unhealthy VM by
+                #    recreating it.
+                #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+                #    For more information, see
+                #    About repairing VMs in a MIG.
+            "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+              "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+                  # Valid values are:
+                  #
+                  #    - NO (default): MIG cannot change a VM's zone during a
+                  #    repair.
+                  #    - YES: MIG can select a different zone for the VM during
+                  #    a repair.
+            },
+          },
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+              # instance group. The group uses this template to create all new instances
+              # in the managed instance group. The templates for existing instances in the
+              # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+          "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+          "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+              # this managed instance group.
+          "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+              # long, and comply withRFC1035.
+          "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+              # to this Instance Group Manager.
+            { # The named port. For example: <"http", 80>.
+              "name": "A String", # The name for this named port.
+                  # The name must be 1-63 characters long, and comply withRFC1035.
+              "port": 42, # The port number, which can be a value between 1 and 65535.
+            },
+          ],
+          "region": "A String", # Output only. [Output Only] The URL of theregion
+              # where the managed instance group resides (for regional resources).
+          "resourcePolicies": { # Resource policies for this managed instance group.
+            "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+                # instance group.
+                # It can be a full or partial URL. For example, the following are
+                # all valid URLs to a workload policy:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+                #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+                #       - regions/region/resourcePolicies/resourcePolicy
+          },
+          "satisfiesPzi": True or False, # Output only. Reserved for future use.
+          "satisfiesPzs": True or False, # Output only. Reserved for future use.
+          "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+              # this URL.
+          "standbyPolicy": { # Standby policy for stopped and suspended instances.
+            "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+                # stop a VM after that VM was created. The initial delay gives the
+                # initialization script the time to prepare your VM for a quick scale out.
+                # The value of initial delay must be between 0 and 3600 seconds. The
+                # default value is 0.
+            "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+                # group scales out. The default mode is `MANUAL`.
+          },
+          "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+            "preservedState": { # Configuration of preserved resources.
+              "disks": { # Disks created on the instances that will be preserved on instance
+                  # delete, update, etc. This map is keyed with the device names of
+                  # the disks.
+                "a_key": {
+                  "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                      # update or VM instance recreate operations.
+                      # This flag is used to configure if the disk should be deleted after it
+                      # is no longer used by the group, e.g. when the given instance or
+                      # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+                },
+              },
+              "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+                  # instance delete, update, etc. This map is keyed with the network
+                  # interface name.
+                "a_key": {
+                  "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                      # update or VM instance recreate operations.
+                      # This flag is used to configure if the IP reservation should be deleted
+                      # after it is no longer used by the group, e.g. when the given instance
+                      # or the whole group is deleted.
+                },
+              },
+              "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+                  # instance delete, update, etc. This map is keyed with the network
+                  # interface name.
+                "a_key": {
+                  "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                      # update or VM instance recreate operations.
+                      # This flag is used to configure if the IP reservation should be deleted
+                      # after it is no longer used by the group, e.g. when the given instance
+                      # or the whole group is deleted.
+                },
+              },
+            },
+          },
+          "status": { # Output only. The status of this managed instance group.
+            "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+              "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+                  # This value is in RFC3339 text format.
+              "effective": True or False, # Output only. A bit indicating whether this configuration has
+                  # been applied to all managed instances in the group.
+            },
+            "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+                # Currently only one accelerator topology is supported.
+              {
+                "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+                    # The value is the same as configured in the WorkloadPolicy.
+                "state": "A String", # Output only. The state of the accelerator topology.
+                "stateDetails": { # Output only. The result of the latest accelerator topology state
+                    # check.
+                  "error": { # Output only. Encountered errors.
+                    "errors": [ # [Output Only] The array of errors encountered while processing this
+                        # operation.
+                      { # Represents a single error encountered during the processing of an
+                          # 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.
+                          { # Container for structured error details providing additional context
+                              # specific to the encountered error code.
+                            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                                #
+                                # 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. # Links and information to help the user resolve the error.
+                                #
+                                # 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 # A localized human-readable error message intended for end users.
+                                # 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. # Details about quota limits and metrics when a quota is exceeded.
+                              "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.
+                      },
+                    ],
+                  },
+                  "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+                      # has // RFC3339 //
+                      # text format.
+                },
+              },
+            ],
+            "autoscaler": "A String", # Output only. The URL of theAutoscaler
+                # that targets this instance group manager.
+            "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+                # targetSizePolicy.mode is set to BULK.
+              "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+              "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+                  # operation.
+                "error": { # Output only. Errors encountered during bulk instance operation.
+                  "errors": [ # [Output Only] The array of errors encountered while processing this
+                      # operation.
+                    { # Represents a single error encountered during the processing of an
+                        # 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.
+                        { # Container for structured error details providing additional context
+                            # specific to the encountered error code.
+                          "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                              #
+                              # 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. # Links and information to help the user resolve the error.
+                              #
+                              # 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 # A localized human-readable error message intended for end users.
+                              # 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. # Details about quota limits and metrics when a quota is exceeded.
+                            "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.
+                    },
+                  ],
+                },
+                "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+                    # operation. Timestamp is in RFC3339 text format.
+              },
+            },
+            "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+                # in this managed instance group that have the status. Currently only shown
+                # for TPU MIGs
+                # instance group that have the status. For more information about how to
+                # interpret each status check the instance lifecycle documentation.
+                # Currently only shown for TPU MIGs.
+              "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+                  # that have DEPROVISIONING status.
+              "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+                  # have been deleted. Includes only instances that would be shown in the
+                  # listManagedInstances method and not all instances that have been
+                  # deleted in the lifetime of the MIG.
+                  # Does not include FlexStart instances that are waiting for the resources
+                  # availability, they are considered as 'pending'.
+              "pending": 42, # Output only. The number of instances in the managed instance group
+                  # that have PENDING status, that is FlexStart instances that are waiting
+                  # for resources. Instances that do not exist because of the other reasons
+                  # are counted as 'non_existent'.
+              "pendingStop": 42, # Output only. The number of instances in the managed instance group
+                  # that have PENDING_STOP status.
+              "provisioning": 42, # Output only. The number of instances in the managed instance group
+                  # that have PROVISIONING status.
+              "repairing": 42, # Output only. The number of instances in the managed instance group
+                  # that have REPAIRING status.
+              "running": 42, # Output only. The number of instances in the managed instance group
+                  # that have RUNNING status.
+              "staging": 42, # Output only. The number of instances in the managed instance group
+                  # that have STAGING status.
+              "stopped": 42, # Output only. The number of instances in the managed instance group
+                  # that have STOPPED status.
+              "stopping": 42, # Output only. The number of instances in the managed instance group
+                  # that have STOPPING status.
+              "suspended": 42, # Output only. The number of instances in the managed instance group
+                  # that have SUSPENDED status.
+              "suspending": 42, # Output only. The number of instances in the managed instance group
+                  # that have SUSPENDING status.
+              "terminated": 42, # Output only. The number of instances in the managed instance group
+                  # that have TERMINATED status.
+            },
+            "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+                # stable state. A stable state means that: none of the instances in the
+                # managed instance group is currently undergoing any type of change (for
+                # example, creation, restart, or deletion); no future changes are scheduled
+                # for instances in the managed instance group; and the managed instance
+                # group itself is not being modified.
+            "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+              "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+                  # has stateful configuration, that is, if you have configured any items
+                  # in a stateful policy or in per-instance configs.
+                  # The group might report that it has no stateful configuration even when
+                  # there is still some preserved state on a managed instance, for example,
+                  # if you have deleted all PICs but not yet applied those deletions.
+              "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+                "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+                    # (listed in the output of a listPerInstanceConfigs API call) have
+                    # status EFFECTIVE or there are no per-instance-configs.
+              },
+            },
+            "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+                # target version specified by version field on Instance Group
+                # Manager.
+              "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+                  # in this managed instance group, i.e. all instances are in their target
+                  # version. Instances' target version are specified byversion field on Instance Group Manager.
+            },
+          },
+          "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+              # apply to all of the instances in the managed instance group.
+            "A String",
+          ],
+          "targetSize": 42, # The target number of running instances for this managed instance group.
+              # You can reduce this number by using the instanceGroupManager
+              # deleteInstances or abandonInstances methods. Resizing the group also
+              # changes this number.
+          "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+              # size.
+            "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+                # individually or all at once.
+          },
+          "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+              # This number changes when you:
+              #
+              #    - Stop instance using the stopInstances
+              #    method or start instances using the startInstances
+              #    method.
+              #    - Manually change the targetStoppedSize using the update
+              #    method.
+          "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+              # This number changes when you:
+              #
+              #    - Suspend instance using the suspendInstances
+              #    method or resume instances using the resumeInstances
+              #    method.
+              #    - Manually change the targetSuspendedSize using the update
+              #    method.
+          "updatePolicy": { # The update policy for this managed instance group.
+            "instanceRedistributionType": "A String", # The
+                # instance redistribution policy for regional managed instance groups.
+                # Valid values are:
+                #
+                #    - PROACTIVE (default): The group attempts to maintain an
+                #    even distribution of VM instances across zones in the region.
+                #    - NONE: For non-autoscaled groups, proactive
+                #    redistribution is disabled.
+            "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+                # either a fixed number or, if the group has 10 or more instances, a
+                # percentage. If you set a percentage, the number of instances is rounded
+                # if necessary.  The default value for maxSurge is a fixed
+                # value equal to the number of zones in which the managed instance group
+                # operates.
+                #
+                # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+              "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                  #
+                  #
+                  #
+                  #     - If the value is fixed, then the calculated
+                  #      value is equal to the fixed value.
+                  #     - If the value is a percent, then the
+                  #     calculated
+                  #      value is percent/100 * targetSize. For example,
+                  #      the calculated value of a 80% of a managed instance group
+                  #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                  #      is a remainder, the number is rounded.
+              "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+              "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                  # example, specify 80 for 80%.
+            },
+            "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+                # process. An instance is considered available if all of the following
+                # conditions are satisfied:
+                #
+                #
+                #
+                #      - The instance's status is
+                #      RUNNING.
+                #    - If there is a health
+                #      check on the instance group, the instance's health check status
+                #      must be HEALTHY at least once. If there is no health check
+                #      on the group, then the instance only needs to have a status of
+                #      RUNNING to be considered available.
+                #
+                #
+                # This value can be either a fixed number or, if the group has 10 or more
+                # instances, a percentage. If you set a percentage, the number of instances
+                # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+                # in which the managed instance group operates.
+                #
+                # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+              "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                  #
+                  #
+                  #
+                  #     - If the value is fixed, then the calculated
+                  #      value is equal to the fixed value.
+                  #     - If the value is a percent, then the
+                  #     calculated
+                  #      value is percent/100 * targetSize. For example,
+                  #      the calculated value of a 80% of a managed instance group
+                  #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                  #      is a remainder, the number is rounded.
+              "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+              "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                  # example, specify 80 for 80%.
+            },
+            "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+                # disruption as much as possible or to apply a more disruptive action than
+                # is necessary.
+                #
+                #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+                #    Compute Engine performs the necessary action to execute the update.
+                #    - To apply a more disruptive action than is strictly necessary, set the
+                #    minimal action to RESTART or REPLACE. For
+                #    example, Compute Engine does not need to restart a VM to change its
+                #    metadata. But if your application reads instance metadata only when a VM
+                #    is restarted, you can set the minimal action to RESTART in
+                #    order to pick up metadata changes.
+            "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+                # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+                # as much as possible. RESTART to allow actions that can be
+                # applied without instance replacing or REPLACE to allow all
+                # possible actions. If the Updater determines that the minimal update
+                # action needed is more disruptive than most disruptive allowed action you
+                # specify it will not perform the update at all.
+            "replacementMethod": "A String", # What action should be used to replace instances.
+                # See minimal_action.REPLACE
+            "type": "A String", # The type
+                # of update process. You can specify either PROACTIVE so
+                # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+                # to update.
+          },
+          "versions": [ # Specifies the instance templates used by this managed instance group to
+              # create instances.
+              #
+              # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+              # group. This field overrides the top-level instanceTemplate
+              # field. Read more about therelationships
+              # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+              # remaining instances. For more information, read aboutcanary
+              # updates.
+            {
+              "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+                  # instance group. The group uses this template to create new instances in
+                  # the managed instance group until the `targetSize` for this version is
+                  # reached. The templates for existing instances in the group do not change
+                  # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+                  # existing instances are updated until the `targetSize` for this version is
+                  # reached.
+              "name": "A String", # Name of the version. Unique among all versions in the scope of this
+                  # managed instance group.
+              "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+                  # from the template will be equal to:
+                  #
+                  #
+                  #      - If expressed as a fixed number, the minimum of either
+                  #       targetSize.fixed or
+                  #       instanceGroupManager.targetSize is used.
+                  #      - if expressed as a percent, the targetSize
+                  #      would be (targetSize.percent/100 *
+                  #      InstanceGroupManager.targetSize) If there is a remainder, the
+                  #      number is rounded.
+                  #
+                  #  If unset, this version will update any remaining instances not
+                  # updated by another version. ReadStarting
+                  # a canary update for more information.
+                "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                    #
+                    #
+                    #
+                    #     - If the value is fixed, then the calculated
+                    #      value is equal to the fixed value.
+                    #     - If the value is a percent, then the
+                    #     calculated
+                    #      value is percent/100 * targetSize. For example,
+                    #      the calculated value of a 80% of a managed instance group
+                    #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                    #      is a remainder, the number is rounded.
+                "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+                "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                    # example, specify 80 for 80%.
+              },
+            },
+          ],
+          "zone": "A String", # Output only. The URL of azone
+              # where the managed instance group is located (for zonal resources).
+        },
+      ],
+      "warning": { # Output only. The warning that replaces the list of managed instance groups 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#instanceGroupManagerAggregatedList", # Output only. The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated
+      # list of managed instance groups.
+  "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.
+  "unreachables": [ # 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.
+
+
+ +
+ applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None) + 
Applies changes to selected instances on the managed instance group.
+This method can be used to apply new overrides and/or new versions.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone
+where the managed instance group is located. Should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # InstanceGroupManagers.applyUpdatesToInstances
+  "allInstances": True or False, # Flag to update all instances instead of specified list of "instances".
+      # If the flag is set to true then the instances may not be specified
+      # in the request.
+  "instances": [ # The list of URLs of one or more instances for which you want to apply
+      # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+  "minimalAction": "A String", # The minimal action that you want to perform on each instance during the
+      # update:
+      # 
+      # 
+      #      - REPLACE: At minimum, delete the instance and create it
+      #      again.
+      #    - RESTART: Stop the instance and start it
+      #      again.
+      #    - REFRESH: Do not stop the instance and limit
+      #      disruption as much as possible.
+      #    - NONE: Do not
+      #      disrupt the instance at all.
+      # 
+      # 
+      # By default, the minimum action is NONE. If your update
+      # requires a more disruptive action than you set with this flag, the
+      # necessary action is performed to execute the update.
+  "mostDisruptiveAllowedAction": "A String", # The most disruptive action that you want to perform on each instance during
+      # the update:
+      # 
+      # 
+      #      - REPLACE: Delete the instance and create it again.
+      #      - RESTART: Stop the instance and start it again.
+      #      - REFRESH: Do not stop the instance and limit disruption
+      #      as much as possible.
+      #    - NONE: Do not disrupt the
+      #      instance at all.
+      # 
+      # 
+      # By default, the most disruptive allowed action is REPLACE. If
+      # your update requires a more disruptive action than you set with this flag,
+      # the update request will fail.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Creates instances with per-instance configurations in this managed instance
+group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions
+take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
+method.
+
+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.createInstances
+  "instances": [ # [Required] List of specifications of per-instance configs.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Deletes the specified managed instance group and all of the instances
+in that group. Note that the instance group must not belong to a
+backend service. Read
+Deleting an instance group for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group to delete. (required)
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group for immediate
+deletion. The instances are also removed from any target
+pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
+instances that you delete. This operation is marked as DONE
+when the action is scheduled even if the instances are still being deleted.
+You must separately verify the status of the deleting action
+with thelistmanagedinstances
+method.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to delete. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+      # Queued instances do not have URL and can be deleted only by name.
+      # One cannot specify both URLs and names in a single request.
+    "A String",
+  ],
+  "skipInstancesOnValidationError": True or False, # Specifies whether the request should proceed despite the inclusion of
+      # instances that are not members of the group or that are already in the
+      # process of being deleted or abandoned. If this field is set to `false` and
+      # such an instance is specified in the request, the operation fails. The
+      # operation always fails if the request contains a malformed instance URL or
+      # a reference to an instance that exists in a zone or region other than the
+      # group's zone or region.
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None) + 
Deletes selected per-instance configurations for the managed instance
+group.
+
+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.deletePerInstanceConfigs
+  "names": [ # The list of instance names for which we want to delete per-instance configs
+      # on this managed instance group.
+    "A String",
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instanceGroupManager, x__xgafv=None) + 
Returns all of the details about the specified managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (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 Managed Instance Group resource.
+    #
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    #
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    #
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      #
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      #
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      #
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      #
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a managed instance group using the information that you specify
+in the request. After the group is created, instances in the group are
+created using the specified instance template.
+This operation is marked as DONE when the group is created
+even if the instances in the group have not yet been created. You
+must separately verify the status of the individual instances with thelistmanagedinstances
+method.
+
+A managed instance group can have up to 1000 VM instances per group. Please
+contact Cloud Support if you need an increase in
+this limit.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where you want to create the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Managed Instance Group resource.
+    # 
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    # 
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    # 
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      # 
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      # 
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of managed instance groups that are contained within the
+specified project and zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [Output Only] A list of managed instance groups.
+  "id": "A String", # Output only. Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceGroupManager resources.
+    { # Represents a Managed Instance Group resource.
+        #
+        # An instance group is a collection of VM instances that you can manage as a
+        # single entity. For more information, readInstance groups.
+        #
+        # For zonal Managed Instance Group, use the instanceGroupManagers
+        # resource.
+        #
+        # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+      "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+          # for the group.
+        "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+            #
+            # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+            # instances to apply the configuration. To apply the configuration, set the
+            # group's updatePolicy.type field to use proactive updates or
+            # use the applyUpdatesToInstances method.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+          "labels": { # The label key-value pairs that you want to patch onto the instance.
+            "a_key": "A String",
+          },
+          "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+              # more information, see Project and
+              # instance metadata.
+            "a_key": "A String",
+          },
+        },
+      },
+      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+          # only one value.
+        {
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
+          "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+              # initialize and run its startup script. During a VM's initial delay
+              # period, the MIG ignores unsuccessful health checks because the VM might
+              # be in the startup process. This prevents the MIG from prematurely
+              # recreating a VM. If the health check receives a healthy response during
+              # the initial delay, it indicates that the startup process is complete and
+              # the VM is ready. The value of initial delay must be between 0 and 3600
+              # seconds. The default value is 0.
+        },
+      ],
+      "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+          # all VMs in a MIG. The maximum character length is 58 and the name must
+          # comply with RFC1035 format.
+          #
+          # When a VM is created in the group, the MIG appends a hyphen and a random
+          # four-character string to the base instance name. If you want the MIG to
+          # assign sequential numbers instead of a random string, then end the base
+          # instance name with a hyphen followed by one or more hash symbols. The hash
+          # symbols indicate the number of digits. For example, a base instance name of
+          # "vm-###" results in "vm-001" as a VM name.
+          # @pattern
+          # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+      "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+          # text format.
+      "currentActions": { # Output only. The list of instance actions and the number of instances
+          # in this managed instance group that are scheduled for each of those
+          # actions.
+        "abandoning": 42, # Output only. The total number of instances in the managed instance group
+            # that are scheduled to be abandoned. Abandoning an instance removes it
+            # from the managed instance group without deleting it.
+        "creating": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be created or are currently being created. If the group
+            # fails to create any of these instances, it tries again until it creates
+            # the instance successfully.
+            #
+            # If you have disabled creation retries, this field will not be populated;
+            # instead, the creatingWithoutRetries field will be populated.
+        "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+            # will attempt to create. The group attempts to create each instance
+            # only once. If the group fails to create any of these instances, it
+            # decreases the group's targetSize value accordingly.
+        "deleting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be deleted or are currently being deleted.
+        "none": 42, # Output only. The number of instances in the managed instance group that
+            # are running and have no scheduled actions.
+        "recreating": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be recreated or are currently being being recreated.
+            # Recreating an instance deletes the existing root persistent disk
+            # and creates a new disk from the image that is defined in the
+            # instance template.
+        "refreshing": 42, # Output only. The number of instances in the managed instance group that
+            # are being reconfigured with properties that do not require a restart
+            # or a recreate action. For example, setting or removing target
+            # pools for the instance.
+        "restarting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be restarted or are currently being restarted.
+        "resuming": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be resumed or are currently being resumed.
+        "starting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be started or are currently being started.
+        "stopping": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be stopped or are currently being stopped.
+        "suspending": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be suspended or are currently being suspended.
+        "verifying": 42, # Output only. The number of instances in the managed instance group that
+            # are being verified. See the managedInstances[].currentAction
+            # property in the listManagedInstances method documentation.
+      },
+      "description": "A String", # An optional description of this resource.
+      "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+          # zones in a regional managed instance group.
+        "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+            # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+        "zones": [ # Zones where the regional managed instance group will create and manage
+            # its instances.
+            # By default, a regional MIG doesn't automatically select an AI zone to create
+            # instances, even if an AI zone is available in the specified region. To
+            # create instances in an AI zone in the selected region, you must explicitly
+            # specify it in the distribution policy together with the other preferred
+            # zones.
+          {
+            "zone": "A String", # The URL of thezone.
+                # The zone must exist in the region where the managed instance group is
+                # located.
+          },
+        ],
+      },
+      "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+          # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+          # fingerprint must be provided in order to update the InstanceGroupManager,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an InstanceGroupManager.
+      "id": "A String", # Output only. A unique identifier for this resource type. The server
+          # generates this identifier.
+      "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+          # types of machines.
+          # Instance flexibility configuration on MIG overrides instance
+          # template configuration.
+        "instanceSelections": { # Named instance selections configuring properties that the group will use
+            # when creating new VMs.
+          "a_key": {
+            "disks": [ # List of disks to be attached to the instances created from this
+                # selection.
+              { # An instance-attached disk resource.
+                "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                    # or X86_64.
+                "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                    # deleted (but not when the disk is detached from the instance).
+                "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                    # partition of the disk for its root filesystem.
+                "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                    # running within the instance. This name can be used to reference the device
+                    # for mounting, resizing, and so on, from within the instance.
+                    #
+                    # If not specified, the server chooses a default device name to apply to this
+                    # disk, in the form persistent-disk-x, where x is a number
+                    # assigned by Google Compute Engine. This field is only applicable for
+                    # persistent disks.
+                "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                    # encryption key.
+                    #
+                    # If you are creating a new disk, this field encrypts the new disk using
+                    # an encryption key that you provide. If you are attaching an existing
+                    # disk that is already encrypted, this field decrypts the disk using
+                    # the customer-supplied encryption key.
+                    #
+                    # If you encrypt a disk using a customer-supplied key, you must provide the
+                    # same key again when you attempt to use this resource at a later time. For
+                    # example, you must provide the key when you create a snapshot or an image
+                    # from the disk or when you attach the disk to a virtual machine instance.
+                    #
+                    # If you do not provide an encryption key, then the disk will be encrypted
+                    # using an automatically generated key and you do not need to provide a key
+                    # to use the disk later.
+                    #
+                    # Note:
+                    #
+                    # Instance templates do not storecustomer-supplied
+                    # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                    #
+                    # You cannot create VMs that have disks with customer-supplied keys using
+                    # the bulk
+                    # insert method.
+                  "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                      # For example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      #
+                      # The fully-qualifed key name may be returned for resource GET requests. For
+                      # example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      # /cryptoKeyVersions/1
+                  "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                      # key. If absent, the Compute Engine default service account is used.
+                      # For example:
+                      #
+                      # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                  "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies a 256-bit customer-supplied
+                      # encryption key, encoded in RFC
+                      # 4648 base64 to either encrypt or decrypt this resource. You can
+                      # provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rawKey":
+                      # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                  "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                      # customer-supplied encryption key to either encrypt or decrypt this
+                      # resource. You can provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rsaEncryptedKey":
+                      # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                      # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                      # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                      #
+                      # The key must meet the following requirements before you can provide it to
+                      # Compute Engine:
+                      #
+                      #    1. The key is wrapped using a RSA public key certificate provided by
+                      #    Google.
+                      #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                      #    encoding.
+                      #
+                      # Gets the RSA public key certificate provided by Google at:
+                      #
+                      #
+                      # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                  "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # [Output only] TheRFC
+                      # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                      # encryption key that protects this resource.
+                },
+                "diskSizeGb": "A String", # The size of the disk in GB.
+                "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                    # currently attached to another instance. If you try to force attach a zonal
+                    # disk to an instance, you will receive an error.
+                "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                    # only for bootable images. Read
+                    # Enabling guest operating system features to see a list of available
+                    # options.
+                  { # Guest OS features.
+                    "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                        # separate values. Set to one or more of the following values:
+                        #
+                        #    - VIRTIO_SCSI_MULTIQUEUE
+                        #    - WINDOWS
+                        #    - MULTI_IP_SUBNET
+                        #    - UEFI_COMPATIBLE
+                        #    - GVNIC
+                        #    - SEV_CAPABLE
+                        #    - SUSPEND_RESUME_COMPATIBLE
+                        #    - SEV_LIVE_MIGRATABLE_V2
+                        #    - SEV_SNP_CAPABLE
+                        #    - TDX_CAPABLE
+                        #    - IDPF
+                        #    - SNP_SVSM_CAPABLE
+                        #    - CCA_CAPABLE
+                        #    - SUSPEND_SAFE_FPR
+                        #
+                        #
+                        # For more information, see
+                        # Enabling guest operating system features.
+                  },
+                ],
+                "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                    # boot disk. If you have many disks attached to an instance, each
+                    # disk would have a unique index number.
+                "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This field is persisted and returned for instanceTemplate and not returned
+                    # in the context of instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                  "architecture": "A String", # The architecture of the attached disk. Valid values are
+                      # arm64 or x86_64.
+                  "description": "A String", # An optional description. Provide this property when creating the disk.
+                  "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                      # of the instance. If a disk with the same name already exists in the given
+                      # region, the existing disk is attached to the new instance and the
+                      # new disk is not created.
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                      # 10 GB. If you specify a sourceImage, which is required for
+                      # boot disks, the default size is the size of the sourceImage.
+                      # If you do not specify a sourceImage, the default disk size
+                      # is 500 GB.
+                  "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                      # disk. For valid disk type values, see
+                      # Supported types for Hyperdisk volumes and
+                      # Persistent Disk type variables.
+                      #
+                      # When creating a single instance, you must provide either the full or
+                      # partial URL of the disk type. For example, the following values are
+                      # valid:
+                      #
+                      #
+                      #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                      #      - projects/project/zones/zone/diskTypes/diskType
+                      #      - zones/zone/diskTypes/diskType
+                      #
+                      #
+                      #
+                      # When creating an instance template, instance flexibility policy, or when
+                      # creating or updating an all-instances configuration, you specify the
+                      # disk type without a URL, for example, hyperdisk-balanced.
+                      #
+                      # If you omit this field for a disk, the default disk type depends on
+                      # the instance's machine series, as follows.
+                      #
+                      #
+                      #     - For first- and second-generation machine series like N1, N2, T2, and
+                      #     M1, the
+                      #        default disk type is Standard Persistent Disk
+                      #        (pd-standard).
+                      #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                      #     (pd-balanced).
+                      #    - For other third-generation machine
+                      #     series like A3, H3, Z3, all
+                      #         fourth-generation types like C4, N4, M4, and newer machine series,
+                      #         the default is Hyperdisk Balanced
+                      #         (hyperdisk-balanced).
+                      #
+                      #
+                      #
+                      # The disk type you specify must be compatible with the instance's machine
+                      # series. For a list of machine series that support Persistent Disk, see Machine
+                      # series support for Persistent Disk.
+                      #
+                      # For a list of machine series that support Hyperdisk, seeMachine
+                      # series support for Hyperdisk.
+                  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+                  "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                      # persistent disks.
+                    "a_key": "A String",
+                  },
+                  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                    "A String",
+                  ],
+                  "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                      # is to use the existing disk.
+                  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                      # of I/O operations per second that the disk can handle. Values must be
+                      # between 10,000 and 120,000. For more details, see theExtreme persistent
+                      # disk documentation.
+                  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                      # number of throughput mb per second that the disk can handle. Values must
+                      # greater than or equal to 1.
+                  "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                      # the URLs of the zones where the disk should be replicated to.
+                      # You must provide exactly two replica zones, and one zone must be the same
+                      # as the instance zone.
+                    "A String",
+                  ],
+                  "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/{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",
+                  },
+                  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                      # Specified using the full or partial URL. For instance template, specify
+                      # only the resource policy name.
+                    "A String",
+                  ],
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                      # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                      # is required.
+                      #
+                      # To create a disk with one of the public operating system
+                      # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                      #
+                      # projects/debian-cloud/global/images/family/debian-9
+                      #
+                      #
+                      # Alternatively, use a specific version of a public operating system image:
+                      #
+                      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                      #
+                      #
+                      # To create a disk with a custom image that you created, specify the
+                      # image name in the following format:
+                      #
+                      # global/images/my-custom-image
+                      #
+                      #
+                      # You can also specify a custom image by its image family, which returns
+                      # the latest version of the image in that family. Replace the image name
+                      # with family/family-name:
+                      #
+                      # global/images/family/my-image-family
+                      #
+                      #
+                      # If the source image is deleted later, this field will not be set.
+                  "sourceImageEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source image. Required if the source image is
+                      # protected by a customer-supplied encryption key.
+                      #
+                      # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                      # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                      # source images are encrypted with your own keys.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                      # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                      # is required.
+                      #
+                      # To create a disk with a snapshot that you created, specify the
+                      # snapshot name in the following format:
+                      #
+                      # global/snapshots/my-backup
+                      #
+                      #
+                      # If the source snapshot is deleted later, this field will not be set.
+                      #
+                      # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                      # an image instead when you create VMs using
+                      # the bulk
+                      # insert method.
+                  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source snapshot.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                      #      - projects/project/zones/zone/storagePools/storagePool
+                      #    - zones/zone/storagePools/storagePool
+                },
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. For most machine types, the
+                    # default is SCSI. Local SSDs can use either NVME or SCSI.
+                    # In certain configurations, persistent disks can use NVMe. For more
+                    # information, seeAbout
+                    # persistent disks.
+                "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+                "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+                  "A String",
+                ],
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                    # in READ_WRITE mode.
+                "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                    # field is set to PRESERVED if the LocalSSD data has been saved
+                    # to a persistent location by customer request.  (see the
+                    # discard_local_ssd option on Stop/Suspend).
+                    # Read-only in the api.
+                "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                    # these are public keys which are safe to store in public
+                  "dbs": [ # The Key Database (db).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "dbxs": [ # The forbidden key database (dbx).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "keks": [ # The Key Exchange Key (KEK).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "pk": { # The Platform Key (PK).
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                },
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                    # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                    # is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using
+                    # this property. This field is only applicable for persistent disks.
+                    #
+                    # 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.
+              },
+            ],
+            "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+              "A String",
+            ],
+            "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+                # e.g. 'Intel Ice Lake'.
+            "rank": 42, # Preference of this instance selection. Lower number means higher
+                # preference. MIG will first try to create a VM based on the machine-type
+                # with lowest rank and fallback to next rank based on availability.
+                # Machine types and instance selections with the same rank have the same
+                # preference.
+          },
+        },
+      },
+      "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+      "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+        "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+            # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+            # applies to the VMs on which your application fails a health check.
+            # Valid values are
+            #
+            #    - REPAIR (default): MIG automatically repairs a failed VM
+            #    by recreating it. For more information, see About
+            #    repairing VMs in a MIG.
+            #    - DO_NOTHING: MIG does not repair a failed VM.
+        "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+            # configuration when repairing a VM. Valid options are:
+            #
+            #
+            #
+            #      -  NO (default): If configuration updates are available, they are not
+            #      forcefully applied during repair. Instead, configuration updates are
+            #      applied according to the group's update policy.
+            #
+            #      -  YES: If configuration updates are available, they are applied
+            #      during repair.
+        "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+            # unhealthy when the application running on that VM fails a health check.
+            # Valid values are:
+            #
+            #    - DEFAULT_ACTION (default): MIG uses the same action
+            #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+            #    - REPAIR: MIG automatically repairs an unhealthy VM by
+            #    recreating it.
+            #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+            #    For more information, see
+            #    About repairing VMs in a MIG.
+        "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+          "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+              # Valid values are:
+              #
+              #    - NO (default): MIG cannot change a VM's zone during a
+              #    repair.
+              #    - YES: MIG can select a different zone for the VM during
+              #    a repair.
+        },
+      },
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create all new instances
+          # in the managed instance group. The templates for existing instances in the
+          # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+      "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+      "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+          # this managed instance group.
+      "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+          # to this Instance Group Manager.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the managed instance group resides (for regional resources).
+      "resourcePolicies": { # Resource policies for this managed instance group.
+        "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+            # instance group.
+            # It can be a full or partial URL. For example, the following are
+            # all valid URLs to a workload policy:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+            #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+            #       - regions/region/resourcePolicies/resourcePolicy
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. Reserved for future use.
+      "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+          # this URL.
+      "standbyPolicy": { # Standby policy for stopped and suspended instances.
+        "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+            # stop a VM after that VM was created. The initial delay gives the
+            # initialization script the time to prepare your VM for a quick scale out.
+            # The value of initial delay must be between 0 and 3600 seconds. The
+            # default value is 0.
+        "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+            # group scales out. The default mode is `MANUAL`.
+      },
+      "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+        "preservedState": { # Configuration of preserved resources.
+          "disks": { # Disks created on the instances that will be preserved on instance
+              # delete, update, etc. This map is keyed with the device names of
+              # the disks.
+            "a_key": {
+              "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the disk should be deleted after it
+                  # is no longer used by the group, e.g. when the given instance or
+                  # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+            },
+          },
+          "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+              # instance delete, update, etc. This map is keyed with the network
+              # interface name.
+            "a_key": {
+              "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the IP reservation should be deleted
+                  # after it is no longer used by the group, e.g. when the given instance
+                  # or the whole group is deleted.
+            },
+          },
+          "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+              # instance delete, update, etc. This map is keyed with the network
+              # interface name.
+            "a_key": {
+              "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the IP reservation should be deleted
+                  # after it is no longer used by the group, e.g. when the given instance
+                  # or the whole group is deleted.
+            },
+          },
+        },
+      },
+      "status": { # Output only. The status of this managed instance group.
+        "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+          "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+              # This value is in RFC3339 text format.
+          "effective": True or False, # Output only. A bit indicating whether this configuration has
+              # been applied to all managed instances in the group.
+        },
+        "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+            # Currently only one accelerator topology is supported.
+          {
+            "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+                # The value is the same as configured in the WorkloadPolicy.
+            "state": "A String", # Output only. The state of the accelerator topology.
+            "stateDetails": { # Output only. The result of the latest accelerator topology state
+                # check.
+              "error": { # Output only. Encountered errors.
+                "errors": [ # [Output Only] The array of errors encountered while processing this
+                    # operation.
+                  { # Represents a single error encountered during the processing of an
+                      # 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.
+                      { # Container for structured error details providing additional context
+                          # specific to the encountered error code.
+                        "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                            #
+                            # 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. # Links and information to help the user resolve the error.
+                            #
+                            # 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 # A localized human-readable error message intended for end users.
+                            # 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. # Details about quota limits and metrics when a quota is exceeded.
+                          "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.
+                  },
+                ],
+              },
+              "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+                  # has // RFC3339 //
+                  # text format.
+            },
+          },
+        ],
+        "autoscaler": "A String", # Output only. The URL of theAutoscaler
+            # that targets this instance group manager.
+        "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+            # targetSizePolicy.mode is set to BULK.
+          "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+          "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+              # operation.
+            "error": { # Output only. Errors encountered during bulk instance operation.
+              "errors": [ # [Output Only] The array of errors encountered while processing this
+                  # operation.
+                { # Represents a single error encountered during the processing of an
+                    # 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.
+                    { # Container for structured error details providing additional context
+                        # specific to the encountered error code.
+                      "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                          #
+                          # 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. # Links and information to help the user resolve the error.
+                          #
+                          # 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 # A localized human-readable error message intended for end users.
+                          # 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. # Details about quota limits and metrics when a quota is exceeded.
+                        "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.
+                },
+              ],
+            },
+            "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+                # operation. Timestamp is in RFC3339 text format.
+          },
+        },
+        "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+            # in this managed instance group that have the status. Currently only shown
+            # for TPU MIGs
+            # instance group that have the status. For more information about how to
+            # interpret each status check the instance lifecycle documentation.
+            # Currently only shown for TPU MIGs.
+          "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+              # that have DEPROVISIONING status.
+          "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+              # have been deleted. Includes only instances that would be shown in the
+              # listManagedInstances method and not all instances that have been
+              # deleted in the lifetime of the MIG.
+              # Does not include FlexStart instances that are waiting for the resources
+              # availability, they are considered as 'pending'.
+          "pending": 42, # Output only. The number of instances in the managed instance group
+              # that have PENDING status, that is FlexStart instances that are waiting
+              # for resources. Instances that do not exist because of the other reasons
+              # are counted as 'non_existent'.
+          "pendingStop": 42, # Output only. The number of instances in the managed instance group
+              # that have PENDING_STOP status.
+          "provisioning": 42, # Output only. The number of instances in the managed instance group
+              # that have PROVISIONING status.
+          "repairing": 42, # Output only. The number of instances in the managed instance group
+              # that have REPAIRING status.
+          "running": 42, # Output only. The number of instances in the managed instance group
+              # that have RUNNING status.
+          "staging": 42, # Output only. The number of instances in the managed instance group
+              # that have STAGING status.
+          "stopped": 42, # Output only. The number of instances in the managed instance group
+              # that have STOPPED status.
+          "stopping": 42, # Output only. The number of instances in the managed instance group
+              # that have STOPPING status.
+          "suspended": 42, # Output only. The number of instances in the managed instance group
+              # that have SUSPENDED status.
+          "suspending": 42, # Output only. The number of instances in the managed instance group
+              # that have SUSPENDING status.
+          "terminated": 42, # Output only. The number of instances in the managed instance group
+              # that have TERMINATED status.
+        },
+        "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+            # stable state. A stable state means that: none of the instances in the
+            # managed instance group is currently undergoing any type of change (for
+            # example, creation, restart, or deletion); no future changes are scheduled
+            # for instances in the managed instance group; and the managed instance
+            # group itself is not being modified.
+        "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+          "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+              # has stateful configuration, that is, if you have configured any items
+              # in a stateful policy or in per-instance configs.
+              # The group might report that it has no stateful configuration even when
+              # there is still some preserved state on a managed instance, for example,
+              # if you have deleted all PICs but not yet applied those deletions.
+          "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+            "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+                # (listed in the output of a listPerInstanceConfigs API call) have
+                # status EFFECTIVE or there are no per-instance-configs.
+          },
+        },
+        "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+            # target version specified by version field on Instance Group
+            # Manager.
+          "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+              # in this managed instance group, i.e. all instances are in their target
+              # version. Instances' target version are specified byversion field on Instance Group Manager.
+        },
+      },
+      "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+          # apply to all of the instances in the managed instance group.
+        "A String",
+      ],
+      "targetSize": 42, # The target number of running instances for this managed instance group.
+          # You can reduce this number by using the instanceGroupManager
+          # deleteInstances or abandonInstances methods. Resizing the group also
+          # changes this number.
+      "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+          # size.
+        "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+            # individually or all at once.
+      },
+      "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+          # This number changes when you:
+          #
+          #    - Stop instance using the stopInstances
+          #    method or start instances using the startInstances
+          #    method.
+          #    - Manually change the targetStoppedSize using the update
+          #    method.
+      "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+          # This number changes when you:
+          #
+          #    - Suspend instance using the suspendInstances
+          #    method or resume instances using the resumeInstances
+          #    method.
+          #    - Manually change the targetSuspendedSize using the update
+          #    method.
+      "updatePolicy": { # The update policy for this managed instance group.
+        "instanceRedistributionType": "A String", # The
+            # instance redistribution policy for regional managed instance groups.
+            # Valid values are:
+            #
+            #    - PROACTIVE (default): The group attempts to maintain an
+            #    even distribution of VM instances across zones in the region.
+            #    - NONE: For non-autoscaled groups, proactive
+            #    redistribution is disabled.
+        "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+            # either a fixed number or, if the group has 10 or more instances, a
+            # percentage. If you set a percentage, the number of instances is rounded
+            # if necessary.  The default value for maxSurge is a fixed
+            # value equal to the number of zones in which the managed instance group
+            # operates.
+            #
+            # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+          "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+              #
+              #
+              #
+              #     - If the value is fixed, then the calculated
+              #      value is equal to the fixed value.
+              #     - If the value is a percent, then the
+              #     calculated
+              #      value is percent/100 * targetSize. For example,
+              #      the calculated value of a 80% of a managed instance group
+              #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+              #      is a remainder, the number is rounded.
+          "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+          "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+              # example, specify 80 for 80%.
+        },
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+            # process. An instance is considered available if all of the following
+            # conditions are satisfied:
+            #
+            #
+            #
+            #      - The instance's status is
+            #      RUNNING.
+            #    - If there is a health
+            #      check on the instance group, the instance's health check status
+            #      must be HEALTHY at least once. If there is no health check
+            #      on the group, then the instance only needs to have a status of
+            #      RUNNING to be considered available.
+            #
+            #
+            # This value can be either a fixed number or, if the group has 10 or more
+            # instances, a percentage. If you set a percentage, the number of instances
+            # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+            # in which the managed instance group operates.
+            #
+            # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+          "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+              #
+              #
+              #
+              #     - If the value is fixed, then the calculated
+              #      value is equal to the fixed value.
+              #     - If the value is a percent, then the
+              #     calculated
+              #      value is percent/100 * targetSize. For example,
+              #      the calculated value of a 80% of a managed instance group
+              #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+              #      is a remainder, the number is rounded.
+          "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+          "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+              # example, specify 80 for 80%.
+        },
+        "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+            # disruption as much as possible or to apply a more disruptive action than
+            # is necessary.
+            #
+            #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+            #    Compute Engine performs the necessary action to execute the update.
+            #    - To apply a more disruptive action than is strictly necessary, set the
+            #    minimal action to RESTART or REPLACE. For
+            #    example, Compute Engine does not need to restart a VM to change its
+            #    metadata. But if your application reads instance metadata only when a VM
+            #    is restarted, you can set the minimal action to RESTART in
+            #    order to pick up metadata changes.
+        "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+            # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+            # as much as possible. RESTART to allow actions that can be
+            # applied without instance replacing or REPLACE to allow all
+            # possible actions. If the Updater determines that the minimal update
+            # action needed is more disruptive than most disruptive allowed action you
+            # specify it will not perform the update at all.
+        "replacementMethod": "A String", # What action should be used to replace instances.
+            # See minimal_action.REPLACE
+        "type": "A String", # The type
+            # of update process. You can specify either PROACTIVE so
+            # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+            # to update.
+      },
+      "versions": [ # Specifies the instance templates used by this managed instance group to
+          # create instances.
+          #
+          # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+          # group. This field overrides the top-level instanceTemplate
+          # field. Read more about therelationships
+          # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+          # remaining instances. For more information, read aboutcanary
+          # updates.
+        {
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+              # instance group. The group uses this template to create new instances in
+              # the managed instance group until the `targetSize` for this version is
+              # reached. The templates for existing instances in the group do not change
+              # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+              # existing instances are updated until the `targetSize` for this version is
+              # reached.
+          "name": "A String", # Name of the version. Unique among all versions in the scope of this
+              # managed instance group.
+          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+              # from the template will be equal to:
+              #
+              #
+              #      - If expressed as a fixed number, the minimum of either
+              #       targetSize.fixed or
+              #       instanceGroupManager.targetSize is used.
+              #      - if expressed as a percent, the targetSize
+              #      would be (targetSize.percent/100 *
+              #      InstanceGroupManager.targetSize) If there is a remainder, the
+              #      number is rounded.
+              #
+              #  If unset, this version will update any remaining instances not
+              # updated by another version. ReadStarting
+              # a canary update for more information.
+            "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                #
+                #
+                #
+                #     - If the value is fixed, then the calculated
+                #      value is equal to the fixed value.
+                #     - If the value is a percent, then the
+                #     calculated
+                #      value is percent/100 * targetSize. For example,
+                #      the calculated value of a 80% of a managed instance group
+                #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                #      is a remainder, the number is rounded.
+            "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+            "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                # example, specify 80 for 80%.
+          },
+        },
+      ],
+      "zone": "A String", # Output only. The URL of azone
+          # where the managed instance group is located (for zonal resources).
+    },
+  ],
+  "kind": "compute#instanceGroupManagerList", # Output only. The resource type, which is always compute#instanceGroupManagerList for a
+      # list of managed instance groups.
+  "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.
+  },
+}
+
+ +
+ listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all errors thrown by actions on instances for a given managed
+instance group. The filter and orderBy query
+parameters are not supported.
+
+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 must be a string that meets the requirements in RFC1035, or an
+unsigned long integer: must match regexp pattern:
+(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "items": [ # Output only. The list of errors of the managed instance group.
+    {
+      "error": { # Output only. Contents of the error.
+        "code": "A String", # Output only. Error code.
+        "message": "A String", # Output only. Error message.
+      },
+      "instanceActionDetails": { # Output only. Details of the instance action that triggered this error.
+          # May be null, if the error was not caused by an action on an instance.
+          # This field is optional.
+        "action": "A String", # Output only. Action that managed instance group was executing on the instance when the
+            # error occurred. Possible values:
+        "instance": "A String", # Output only. The URL of the instance. The URL can be set even if the instance has not
+            # yet been created.
+        "version": { # Output only. Version this instance was created from, or was being
+            # created from, but the creation failed. Corresponds to one of the versions
+            # that were set on the Instance Group Manager resource at the time this
+            # instance was being created.
+          "instanceTemplate": "A String", # Output only. [Output Only] The intended template of the instance. This field is empty
+              # when current_action is one of { DELETING, ABANDONING }.
+          "name": "A String", # Output only. [Output Only] Name of the version.
+        },
+      },
+      "timestamp": "A String", # Output only. The time that this error occurred. This value is in RFC3339 text format.
+    },
+  ],
+  "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 than maxResults
+      # , then 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.
+}
+
+ +
+ listErrors_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.
+
+
+ +
+ listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all of the instances in the managed instance group. Each instance
+in the list has a currentAction, which indicates the action
+that the managed instance group is performing on the instance. For example,
+if the group is still creating an instance, the currentAction
+is CREATING. If a previous action failed, the
+list displays the errors for that failed action. The orderBy
+query parameter is not supported. The `pageToken` query parameter is
+supported only if the group's `listManagedInstancesResults` field is set
+to `PAGINATED`.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "managedInstances": [ # Output only. [Output Only] The list of instances in the managed instance group.
+    { # A Managed Instance resource.
+      "currentAction": "A String", # Output only. [Output Only] The current action that the managed instance group has
+          # scheduled for the instance. Possible values:
+          #
+          #    - NONE The instance is running, and the managed
+          #    instance group does not have any scheduled actions for this instance.
+          #    - CREATING The managed instance group is creating this
+          #    instance. If the group fails to create this instance, it will try again
+          #    until it is successful.
+          #    - CREATING_WITHOUT_RETRIES The managed instance group
+          #    is attempting to create this instance only once. If the group fails
+          #    to create this instance, it does not try again and the group'stargetSize value is decreased instead.
+          #    - RECREATING The managed instance group is recreating
+          #    this instance.
+          #    - DELETING The managed instance group is permanently
+          #    deleting this instance.
+          #    - ABANDONING The managed instance group is abandoning
+          #    this instance. The instance will be removed from the instance group
+          #    and from any target pools that are associated with this group.
+          #    - RESTARTING The managed instance group is restarting
+          #    the instance.
+          #    - REFRESHING The managed instance group is applying
+          #    configuration changes to the instance without stopping it. For example,
+          #    the group can update the target pool list for an instance without
+          #    stopping that instance.
+          #    - VERIFYING The managed instance group has created the
+          #    instance and it is in the process of being verified.
+      "id": "A String", # Output only. [Output only] The unique identifier for this resource. This field is empty
+          # when instance does not exist.
+      "instance": "A String", # Output only. [Output Only] The URL of the instance. The URL can exist even if the
+          # instance has not yet been created.
+      "instanceHealth": [ # Output only. [Output Only] Health state of the instance per health-check.
+        {
+          "detailedHealthState": "A String", # Output only. [Output Only] The current detailed instance health state.
+          "healthCheck": "A String", # Output only. [Output Only] The URL for the health check that verifies whether the
+              # instance is healthy.
+        },
+      ],
+      "instanceStatus": "A String", # Output only. [Output Only] The status of the instance. This field is empty when
+          # the instance does not exist.
+      "lastAttempt": { # Output only. [Output Only] Information about the last attempt to create or delete
+          # the instance.
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to create or
+            # delete the instance.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+      },
+      "name": "A String", # Output only. [Output Only] The name of the instance. The name always exists even if the
+          # instance has not yet been created.
+      "preservedStateFromConfig": { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
+          # for this instance.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "preservedStateFromPolicy": { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
+          # for this instance.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "propertiesFromFlexibilityPolicy": { # Output only. [Output Only] Instance properties selected for this instance resulting from
+          # InstanceFlexibilityPolicy.
+        "disks": [ # List of disks to be attached to the instance.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineType": "A String", # Output only. The machine type to be used for this instance.
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance.
+            # e.g. 'Intel Ice Lake'.
+      },
+      "scheduling": { # Output only. Information about the termination timestamp of the instance, if applicable.
+        "gracefulShutdownTimestamp": "A String", # Output only. The timestamp at which the underlying instance will be
+            # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
+        "terminationTimestamp": "A String", # Output only. The timestamp at which the managed instance will be terminated. This is
+            # in RFC3339 text
+            # format.
+      },
+      "shutdownDetails": { # Output only. Specifies the graceful shutdown details if the instance is in
+          # `PENDING_STOP` state or there is a programmed stop scheduled.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # Output only. The duration for graceful shutdown. Only applicable when the instance is
+            # in `PENDING_STOP` state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestTimestamp": "A String", # Output only. Past timestamp indicating the beginning of `PENDING_STOP` state of
+            # instance in RFC3339
+            # text format.
+      },
+      "targetStatus": "A String", # Output only. The eventual status of the instance. The instance group
+          # manager will not be identified as stable till each managed instance reaches
+          # its targetStatus.
+      "version": { # Output only. [Output Only] Intended version of this instance.
+        "instanceTemplate": "A String", # Output only. [Output Only] The intended template of the instance. This field is empty
+            # when current_action is one of { DELETING, ABANDONING }.
+        "name": "A String", # Output only. [Output Only] Name of the version.
+      },
+    },
+  ],
+  "nextPageToken": "A String", # Output only. [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.
+}
+
+ +
+ listManagedInstances_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.
+
+
+ +
+ listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all of the per-instance configurations defined for the managed
+instance group. The orderBy query parameter is not supported.
+
+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)
+  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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "items": [ # Output only. [Output Only] The list of PerInstanceConfig.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listPerInstanceConfigs_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, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Updates a managed instance group using the information that you specify
+in the request.
+This operation is marked as DONE when the group is patched
+even if the instances in the group are still in the process of being
+patched. You must separately verify the status of the individual instances
+with thelistManagedInstances
+method. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules.
+
+If you update your group to specify a new template or instance
+configuration, it's possible that your intended specification for each VM
+in the group is different from the current state of that VM. To learn how
+to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
+a MIG.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+you want to create the managed instance group. (required)
+  instanceGroupManager: string, The name of the instance group manager. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Managed Instance Group resource.
+    # 
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    # 
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    # 
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      # 
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      # 
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Inserts or patches per-instance configurations for the managed instance
+group. perInstanceConfig.name serves as a key used to
+distinguish whether to perform insert or patch.
+
+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.patchPerInstanceConfigs
+  "perInstanceConfigs": [ # The list of per-instance configurations to insert or patch on this managed
+      # instance group.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified VM instances in the managed instance group to be
+immediately recreated. Each instance is recreated using the group's current
+configuration. This operation is marked as DONE when the flag
+is set even if the instances have not yet been recreated. You must
+separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
+the status of managed instances.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to recreate. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None) + 
Resizes the managed instance group. If you increase the size, the group
+creates new instances using the current instance template. If you decrease
+the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
+has not yet added or deleted any instances. You must separately
+verify the status of the creating or deleting
+actions with thelistmanagedinstances
+method.
+
+When resizing down, the instance group arbitrarily chooses the order in
+which VMs are deleted. The group takes into account some VM attributes when
+making the selection including:
+
++ The status of the VM instance.
++ The health of the VM instance.
++ The instance template version the VM is based on.
++ For regional managed instance groups, the location of the VM instance.
+
+This list is subject to change.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  size: integer, The number of running instances that the managed instance group should
+maintain at any given time. The group automatically adds or removes
+instances to maintain the number of instances specified by this parameter. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+resumed. This method increases thetargetSize and decreases the targetSuspendedSize
+of the managed instance group by the number of instances that you resume.
+The resumeInstances operation is marked DONE if
+the resumeInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
+method.
+
+In this request, you can only specify instances that are suspended. For
+example, if an instance was previously suspended using the suspendInstances
+method, it can be resumed using the resumeInstances method.
+
+If a health check is attached to the managed instance group, the specified
+instances will be verified as healthy after they are resumed.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to resume. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Specifies the instance template to use when creating new instances in this
+group. The templates for existing instances in the group do not change
+unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Modifies the target pools to which all instances in this managed instance
+group are assigned. The target pools automatically apply to all of the
+instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not
+yet been added to their target pools. The change might take some time to
+apply to all of the instances in the group depending on the size of the
+group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "fingerprint": "A String", # The fingerprint of the target pools information. Use this optional
+      # property to prevent conflicts when multiple users change the target pools
+      # settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get
+      # method. Then, include the fingerprint in your request to ensure that you
+      # do not overwrite changes that were applied from another
+      # concurrent request.
+  "targetPools": [ # The list of target pool URLs that instances in this managed instance group
+      # belong to. The managed instance group applies these target pools to all
+      # of the instances in the group. Existing instances and new instances in the
+      # group all receive these target pool settings.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+started. This method increases thetargetSize and decreases the targetStoppedSize
+of the managed instance group by the number of instances that you start.
+The startInstances operation is marked DONE if
+the startInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
+method.
+
+In this request, you can only specify instances that are stopped. For
+example, if an instance was previously stopped using the stopInstances
+method, it can be started using the startInstances method.
+
+If a health check is attached to the managed instance group, the specified
+instances will be verified as healthy after they are started.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to start. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+immediately stopped. You can only specify instances that are running in
+this request. This method reduces thetargetSize and increases the targetStoppedSize
+of the managed instance group by the number of instances that you stop.
+The stopInstances operation is marked DONE if
+the stopInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
+method.
+
+If the standbyPolicy.initialDelaySec field is set, the group
+delays stopping the instances until initialDelaySec have
+passed from instance.creationTimestamp (that is, when the
+instance was created). This delay gives your application time to
+set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
+will be zero delay.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is stopped.
+
+Stopped instances can be started using the startInstances
+method.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "forceStop": True or False, # If this flag is set to true, the Instance Group Manager will proceed to
+      # stop the instances, skipping initialization on them.
+  "instances": [ # The URLs of one or more instances to stop. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+immediately suspended. You can only specify instances that are running in
+this request. This method reduces thetargetSize and increases the targetSuspendedSize
+of the managed instance group by the number of instances that you suspend.
+The suspendInstances operation is marked DONE if
+the suspendInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
+method.
+
+If the standbyPolicy.initialDelaySec field is set, the group
+delays suspension of the instances until initialDelaySec have
+passed from instance.creationTimestamp (that is, when the
+instance was created). This delay gives your application time to
+set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
+will be zero delay.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is suspended.
+
+Suspended instances can be resumed using the resumeInstances
+method.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone where the managed
+instance group is located. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "forceSuspend": True or False, # If this flag is set to true, the Instance Group Manager will proceed to
+      # suspend the instances, skipping initialization on them.
+  "instances": [ # The URLs of one or more instances to suspend. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Inserts or updates per-instance configurations for the managed instance
+group. perInstanceConfig.name serves as a key used to
+distinguish whether to perform insert or patch.
+
+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.updatePerInstanceConfigs
+  "perInstanceConfigs": [ # The list of per-instance configurations to insert or patch on this managed
+      # instance group.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.instanceGroups.html b/docs/dyn/compute_preview.instanceGroups.html new file mode 100644 index 0000000000..2ccfc5cdd1 --- /dev/null +++ b/docs/dyn/compute_preview.instanceGroups.html @@ -0,0 +1,2518 @@ + + + +

Compute Engine API . instanceGroups

+

Instance Methods

+

+ addInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

+

Adds a list of instances to the specified instance group. All of the

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of instance groups and sorts them by zone.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, instanceGroup, requestId=None, x__xgafv=None)

+

Deletes the specified instance group. The instances in the group are not

+

+ get(project, zone, instanceGroup, x__xgafv=None)

+

Returns the specified zonal instance group. Get a list of available zonal

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates an instance group in the specified project using the

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of zonal instance group resources contained within the

+

+ listInstances(project, zone, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the instances in the specified instance group.

+

+ listInstances_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ removeInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

+

Removes one or more instances from the specified instance group, but does

+

+ setNamedPorts(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

+

Sets the named ports for the specified instance group.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ addInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None) + 
Adds a list of instances to the specified instance group.  All of the
+instances in the instance group must be in the same network/subnetwork.
+Read 
+Adding instances for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group where you are adding instances. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The list of instances to add to the instance group.
+    {
+      "instance": "A String", # The URL for a specific instance.
+          # @required compute.instancegroups.addInstances/removeInstances
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of instance groups and sorts them by zone.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # Output only. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of InstanceGroupsScopedList resources.
+    "a_key": { # The name of the scope that contains this set of instance groups.
+      "instanceGroups": [ # Output only. [Output Only] The list ofinstance
+          # groups that are contained in this scope.
+        { # Represents an Instance Group resource.
+            #
+            # Instance Groups can be used to configure a target forload
+            # balancing.
+            #
+            # Instance groups can either be managed or unmanaged.
+            #
+            # To create
+            # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+            #
+            # Use zonal unmanaged instance groups if you need to applyload
+            # balancing to groups of heterogeneous instances or if you need to manage
+            # the instances yourself. You cannot create regional unmanaged instance groups.
+            #
+            # For more information, readInstance
+            # groups.
+          "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+              # uses this fingerprint to detect conflicts when multiple users change the
+              # named ports concurrently.
+          "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+              # by the server.
+          "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+          "name": "A String", # The name of the instance group. The name must be 1-63 characters
+              # long, and comply withRFC1035.
+          "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+              #
+              # This
+              # allows the system to reference ports by the assigned name instead of a
+              # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+              # "app1", port: 8081}, {name: "app2", port:
+              # 8082}]
+              #
+              # Named ports apply to all instances in this instance group.
+            { # The named port. For example: <"http", 80>.
+              "name": "A String", # The name for this named port.
+                  # The name must be 1-63 characters long, and comply withRFC1035.
+              "port": 42, # The port number, which can be a value between 1 and 65535.
+            },
+          ],
+          "network": "A String", # [Output Only] The URL of the network to which all instances in the
+              # instance group belong. If your instance has multiple network interfaces,
+              # then the network and subnetwork fields only refer to the
+              # network and subnet used by your primary interface (nic0).
+          "region": "A String", # Output only. [Output Only] The URL of theregion
+              # where the instance group is located (for regional resources).
+          "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+              # this URL.
+          "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+          "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+              # instance group belong. If your instance has multiple network interfaces,
+              # then the network and subnetwork fields only refer to the
+              # network and subnet used by your primary interface (nic0).
+          "zone": "A String", # Output only. [Output Only] The URL of thezone
+              # where the instance group is located (for zonal resources).
+        },
+      ],
+      "warning": { # Output only. [Output Only] An informational warning that replaces the list of
+          # instance groups 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#instanceGroupAggregatedList", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of
+      # instance groups.
+  "nextPageToken": "A String", # Output only. [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. [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, zone, instanceGroup, requestId=None, x__xgafv=None) + 
Deletes the specified instance group. The instances in the group are not
+deleted. Note that instance group must not belong to a backend service.
+Read
+Deleting an instance group for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instanceGroup, x__xgafv=None) + 
Returns the specified zonal instance group. Get a list of available zonal
+instance groups by making a list() request.
+
+For managed instance groups, use theinstanceGroupManagers
+or regionInstanceGroupManagers
+methods instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Instance Group resource.
+    #
+    # Instance Groups can be used to configure a target forload
+    # balancing.
+    #
+    # Instance groups can either be managed or unmanaged.
+    #
+    # To create
+    # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+    #
+    # Use zonal unmanaged instance groups if you need to applyload
+    # balancing to groups of heterogeneous instances or if you need to manage
+    # the instances yourself. You cannot create regional unmanaged instance groups.
+    #
+    # For more information, readInstance
+    # groups.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+      # uses this fingerprint to detect conflicts when multiple users change the
+      # named ports concurrently.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+      # by the server.
+  "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+  "name": "A String", # The name of the instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+      #
+      # This
+      # allows the system to reference ports by the assigned name instead of a
+      # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+      # "app1", port: 8081}, {name: "app2", port:
+      # 8082}]
+      #
+      # Named ports apply to all instances in this instance group.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "network": "A String", # [Output Only] The URL of the network to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the instance group is located (for regional resources).
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+      # this URL.
+  "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+  "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the instance group is located (for zonal resources).
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates an instance group in the specified project using the
+parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where you want to create the instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Instance Group resource.
+    # 
+    # Instance Groups can be used to configure a target forload
+    # balancing.
+    # 
+    # Instance groups can either be managed or unmanaged.
+    # 
+    # To create
+    # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+    # 
+    # Use zonal unmanaged instance groups if you need to applyload
+    # balancing to groups of heterogeneous instances or if you need to manage
+    # the instances yourself. You cannot create regional unmanaged instance groups.
+    # 
+    # For more information, readInstance
+    # groups.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+      # uses this fingerprint to detect conflicts when multiple users change the
+      # named ports concurrently.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+      # by the server.
+  "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+  "name": "A String", # The name of the instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+      # 
+      # This
+      # allows the system to reference ports by the assigned name instead of a
+      # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+      # "app1", port: 8081}, {name: "app2", port:
+      # 8082}]
+      # 
+      # Named ports apply to all instances in this instance group.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "network": "A String", # [Output Only] The URL of the network to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the instance group is located (for regional resources).
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+      # this URL.
+  "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+  "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the instance group is located (for zonal resources).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of zonal instance group resources contained within the
+specified zone.
+
+For managed instance groups, use theinstanceGroupManagers
+or regionInstanceGroupManagers
+methods instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone
+where the instance group is located. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of InstanceGroup resources.
+  "id": "A String", # Output only. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceGroup resources.
+    { # Represents an Instance Group resource.
+        #
+        # Instance Groups can be used to configure a target forload
+        # balancing.
+        #
+        # Instance groups can either be managed or unmanaged.
+        #
+        # To create
+        # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+        #
+        # Use zonal unmanaged instance groups if you need to applyload
+        # balancing to groups of heterogeneous instances or if you need to manage
+        # the instances yourself. You cannot create regional unmanaged instance groups.
+        #
+        # For more information, readInstance
+        # groups.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+          # uses this fingerprint to detect conflicts when multiple users change the
+          # named ports concurrently.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+          # by the server.
+      "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+      "name": "A String", # The name of the instance group. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+          #
+          # This
+          # allows the system to reference ports by the assigned name instead of a
+          # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+          # "app1", port: 8081}, {name: "app2", port:
+          # 8082}]
+          #
+          # Named ports apply to all instances in this instance group.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "network": "A String", # [Output Only] The URL of the network to which all instances in the
+          # instance group belong. If your instance has multiple network interfaces,
+          # then the network and subnetwork fields only refer to the
+          # network and subnet used by your primary interface (nic0).
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the instance group is located (for regional resources).
+      "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+          # this URL.
+      "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+      "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+          # instance group belong. If your instance has multiple network interfaces,
+          # then the network and subnetwork fields only refer to the
+          # network and subnet used by your primary interface (nic0).
+      "zone": "A String", # Output only. [Output Only] The URL of thezone
+          # where the instance group is located (for zonal resources).
+    },
+  ],
+  "kind": "compute#instanceGroupList", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists.
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listInstances(project, zone, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the instances in the specified instance group.
+The orderBy query parameter is not supported.
+The filter query parameter is supported, but only for
+expressions that use `eq` (equal) or `ne` (not equal) operators.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group from which you want to generate a list
+of included instances. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instanceState": "A String", # A filter for the state of the instances in the instance group. Valid
+      # options are ALL or RUNNING. If you do not specify
+      # this parameter the list includes all instances regardless of their state.
+}
+
+  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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceWithNamedPorts resources.
+    {
+      "instance": "A String", # Output only. [Output Only] The URL of the instance.
+      "namedPorts": [ # Output only. [Output Only] The named ports that belong to this instance group.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "status": "A String", # Output only. [Output Only] The status of the instance.
+    },
+  ],
+  "kind": "compute#instanceGroupsListInstances", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances
+      # in the specified instance group.
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listInstances_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.
+
+
+ +
+ removeInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None) + 
Removes one or more instances from the specified instance group, but does
+not delete those instances.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration before the VM instance is removed or deleted.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group where the specified instances will be
+removed. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The list of instances to remove from the instance group.
+    {
+      "instance": "A String", # The URL for a specific instance.
+          # @required compute.instancegroups.addInstances/removeInstances
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setNamedPorts(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None) + 
Sets the named ports for the specified instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone
+where the instance group is located. (required)
+  instanceGroup: string, The name of the instance group where the named ports are updated. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "fingerprint": "A String", # The fingerprint of the named ports information for this instance group.
+      # Use this optional property to prevent conflicts when multiple users change
+      # the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get
+      # method. Then, include the fingerprint in your request to ensure that you
+      # do not overwrite changes that were applied from another concurrent request.
+      # A request with an incorrect fingerprint will fail with error412 conditionNotMet.
+  "namedPorts": [ # The list of named ports to set for this instance group.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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_preview.instanceSettings.html b/docs/dyn/compute_preview.instanceSettings.html new file mode 100644 index 0000000000..6eab4d6fa7 --- /dev/null +++ b/docs/dyn/compute_preview.instanceSettings.html @@ -0,0 +1,471 @@ + + + +

Compute Engine API . instanceSettings

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, x__xgafv=None)

+

Get Instance settings.

+

+ patch(project, zone, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patch Instance settings

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, x__xgafv=None) + 
Get Instance settings.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (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 Instance Settings resource. You can use instance settings to
+    # configure default settings for Compute Engine VM instances. For example, you
+    # can use it to configure default machine type of Compute Engine VM instances.
+  "fingerprint": "A String", # Specifies a fingerprint for instance settings, which is essentially a hash
+      # of the instance settings resource's contents and used for optimistic
+      # locking. The fingerprint is initially generated by Compute Engine and
+      # changes after every request to modify or update the instance settings
+      # resource. You must always provide an up-to-date fingerprint hash in order
+      # to update or change the resource, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve the resource.
+  "kind": "compute#instanceSettings", # Output only. [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings.
+  "metadata": { # The metadata key/value pairs assigned to all the instances in the
+      # corresponding scope.
+    "items": { # A metadata key/value items map.
+        # The total size of all keys and values must be less than 512KB.
+      "a_key": "A String",
+    },
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the resource resides
+      # You must specify this field as part of the HTTP request URL. It is not
+      # settable as a field in the request body.
+}
+
+ +
+ patch(project, zone, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patch Instance settings
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The zone scoping this request. It should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Instance Settings resource. You can use instance settings to
+    # configure default settings for Compute Engine VM instances. For example, you
+    # can use it to configure default machine type of Compute Engine VM instances.
+  "fingerprint": "A String", # Specifies a fingerprint for instance settings, which is essentially a hash
+      # of the instance settings resource's contents and used for optimistic
+      # locking. The fingerprint is initially generated by Compute Engine and
+      # changes after every request to modify or update the instance settings
+      # resource. You must always provide an up-to-date fingerprint hash in order
+      # to update or change the resource, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve the resource.
+  "kind": "compute#instanceSettings", # Output only. [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings.
+  "metadata": { # The metadata key/value pairs assigned to all the instances in the
+      # corresponding scope.
+    "items": { # A metadata key/value items map.
+        # The total size of all keys and values must be less than 512KB.
+      "a_key": "A String",
+    },
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the resource resides
+      # You must specify this field as part of the HTTP request URL. It is not
+      # settable as a field in the request body.
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.instanceTemplates.html b/docs/dyn/compute_preview.instanceTemplates.html new file mode 100644 index 0000000000..a4f12f7e52 --- /dev/null +++ b/docs/dyn/compute_preview.instanceTemplates.html @@ -0,0 +1,6453 @@ + + + +

Compute Engine API . instanceTemplates

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all InstanceTemplates resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, instanceTemplate, requestId=None, x__xgafv=None)

+

Deletes the specified instance template. Deleting an instance template is

+

+ get(project, instanceTemplate, x__xgafv=None)

+

Returns the specified instance template.

+

+ 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 an instance template in the specified project using the

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of instance templates that are 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

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all InstanceTemplates resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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 InstanceTemplatesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of InstanceTemplatesScopedList resources.
+    "a_key": { # The name of the scope that contains this set of instance templates.
+      "instanceTemplates": [ # [Output Only] A list of instance templates that are contained within
+          # the specified project and zone.
+        { # Represents an Instance Template resource.
+            #
+            # Google Compute Engine has two Instance Template resources:
+            #
+            # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+            # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+            #
+            # You can reuse a global instance template in
+            # different regions whereas you can use a regional instance template in a
+            # specified region only. If you want to reduce cross-region dependency or
+            # achieve data residency, use a regional instance template.
+            #
+            # To create VMs, managed instance groups, and reservations, you can use either
+            # global or regional instance templates.
+            #
+            # For more information, readInstance Templates.
+          "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+              # defines this identifier.
+          "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+          "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.
+          "properties": { # The instance properties for this instance template.
+            "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+                # Note that for MachineImage, this is not supported yet.
+                # Options that would traditionally be configured in a BIOS belong
+                # here. Features that require operating system support may have
+                # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+                # disabled).
+              "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+              "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+              "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+              "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+                  # multithreading (SMT) set this to 1. If unset, the maximum number
+                  # of threads supported per core by the underlying processor is
+                  # assumed.
+              "turboMode": "A String", # Turbo frequency mode to use for the instance.
+                  # Supported modes include:
+                  # * ALL_CORE_MAX
+                  #
+                  # Using empty string or not setting this field will use the platform-specific
+                  # default turbo mode.
+              "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+                  # the number of threads per core to compute the total number of virtual
+                  # CPUs to expose to the instance. If unset, the number of cores is
+                  # inferred from the instance's nominal CPU count and the underlying
+                  # platform's SMT width.
+            },
+            "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+                # source IP addresses other than their own and receive packets with
+                # destination IP addresses other than their own. If these instances will be
+                # used as an IP gateway or it will be set as the next-hop in a Route
+                # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+                # documentation for more information.
+            "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+                # Note that for MachineImage, this is not supported yet.
+              "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+              "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+            },
+            "description": "A String", # An optional text description for the instances that are created from these
+                # properties.
+            "disks": [ # An array of disks that are associated with the instances that are created
+                # from these properties.
+              { # An instance-attached disk resource.
+                "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                    # or X86_64.
+                "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                    # deleted (but not when the disk is detached from the instance).
+                "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                    # partition of the disk for its root filesystem.
+                "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                    # running within the instance. This name can be used to reference the device
+                    # for mounting, resizing, and so on, from within the instance.
+                    #
+                    # If not specified, the server chooses a default device name to apply to this
+                    # disk, in the form persistent-disk-x, where x is a number
+                    # assigned by Google Compute Engine. This field is only applicable for
+                    # persistent disks.
+                "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                    # encryption key.
+                    #
+                    # If you are creating a new disk, this field encrypts the new disk using
+                    # an encryption key that you provide. If you are attaching an existing
+                    # disk that is already encrypted, this field decrypts the disk using
+                    # the customer-supplied encryption key.
+                    #
+                    # If you encrypt a disk using a customer-supplied key, you must provide the
+                    # same key again when you attempt to use this resource at a later time. For
+                    # example, you must provide the key when you create a snapshot or an image
+                    # from the disk or when you attach the disk to a virtual machine instance.
+                    #
+                    # If you do not provide an encryption key, then the disk will be encrypted
+                    # using an automatically generated key and you do not need to provide a key
+                    # to use the disk later.
+                    #
+                    # Note:
+                    #
+                    # Instance templates do not storecustomer-supplied
+                    # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                    #
+                    # You cannot create VMs that have disks with customer-supplied keys using
+                    # the bulk
+                    # insert method.
+                  "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                      # For example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      #
+                      # The fully-qualifed key name may be returned for resource GET requests. For
+                      # example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      # /cryptoKeyVersions/1
+                  "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                      # key. If absent, the Compute Engine default service account is used.
+                      # For example:
+                      #
+                      # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                  "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies a 256-bit customer-supplied
+                      # encryption key, encoded in RFC
+                      # 4648 base64 to either encrypt or decrypt this resource. You can
+                      # provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rawKey":
+                      # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                  "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                      # customer-supplied encryption key to either encrypt or decrypt this
+                      # resource. You can provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rsaEncryptedKey":
+                      # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                      # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                      # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                      #
+                      # The key must meet the following requirements before you can provide it to
+                      # Compute Engine:
+                      #
+                      #    1. The key is wrapped using a RSA public key certificate provided by
+                      #    Google.
+                      #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                      #    encoding.
+                      #
+                      # Gets the RSA public key certificate provided by Google at:
+                      #
+                      #
+                      # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                  "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # [Output only] TheRFC
+                      # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                      # encryption key that protects this resource.
+                },
+                "diskSizeGb": "A String", # The size of the disk in GB.
+                "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                    # currently attached to another instance. If you try to force attach a zonal
+                    # disk to an instance, you will receive an error.
+                "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                    # only for bootable images. Read
+                    # Enabling guest operating system features to see a list of available
+                    # options.
+                  { # Guest OS features.
+                    "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                        # separate values. Set to one or more of the following values:
+                        #
+                        #    - VIRTIO_SCSI_MULTIQUEUE
+                        #    - WINDOWS
+                        #    - MULTI_IP_SUBNET
+                        #    - UEFI_COMPATIBLE
+                        #    - GVNIC
+                        #    - SEV_CAPABLE
+                        #    - SUSPEND_RESUME_COMPATIBLE
+                        #    - SEV_LIVE_MIGRATABLE_V2
+                        #    - SEV_SNP_CAPABLE
+                        #    - TDX_CAPABLE
+                        #    - IDPF
+                        #    - SNP_SVSM_CAPABLE
+                        #    - CCA_CAPABLE
+                        #    - SUSPEND_SAFE_FPR
+                        #
+                        #
+                        # For more information, see
+                        # Enabling guest operating system features.
+                  },
+                ],
+                "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                    # boot disk. If you have many disks attached to an instance, each
+                    # disk would have a unique index number.
+                "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This field is persisted and returned for instanceTemplate and not returned
+                    # in the context of instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                  "architecture": "A String", # The architecture of the attached disk. Valid values are
+                      # arm64 or x86_64.
+                  "description": "A String", # An optional description. Provide this property when creating the disk.
+                  "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                      # of the instance. If a disk with the same name already exists in the given
+                      # region, the existing disk is attached to the new instance and the
+                      # new disk is not created.
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                      # 10 GB. If you specify a sourceImage, which is required for
+                      # boot disks, the default size is the size of the sourceImage.
+                      # If you do not specify a sourceImage, the default disk size
+                      # is 500 GB.
+                  "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                      # disk. For valid disk type values, see
+                      # Supported types for Hyperdisk volumes and
+                      # Persistent Disk type variables.
+                      #
+                      # When creating a single instance, you must provide either the full or
+                      # partial URL of the disk type. For example, the following values are
+                      # valid:
+                      #
+                      #
+                      #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                      #      - projects/project/zones/zone/diskTypes/diskType
+                      #      - zones/zone/diskTypes/diskType
+                      #
+                      #
+                      #
+                      # When creating an instance template, instance flexibility policy, or when
+                      # creating or updating an all-instances configuration, you specify the
+                      # disk type without a URL, for example, hyperdisk-balanced.
+                      #
+                      # If you omit this field for a disk, the default disk type depends on
+                      # the instance's machine series, as follows.
+                      #
+                      #
+                      #     - For first- and second-generation machine series like N1, N2, T2, and
+                      #     M1, the
+                      #        default disk type is Standard Persistent Disk
+                      #        (pd-standard).
+                      #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                      #     (pd-balanced).
+                      #    - For other third-generation machine
+                      #     series like A3, H3, Z3, all
+                      #         fourth-generation types like C4, N4, M4, and newer machine series,
+                      #         the default is Hyperdisk Balanced
+                      #         (hyperdisk-balanced).
+                      #
+                      #
+                      #
+                      # The disk type you specify must be compatible with the instance's machine
+                      # series. For a list of machine series that support Persistent Disk, see Machine
+                      # series support for Persistent Disk.
+                      #
+                      # For a list of machine series that support Hyperdisk, seeMachine
+                      # series support for Hyperdisk.
+                  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+                  "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                      # persistent disks.
+                    "a_key": "A String",
+                  },
+                  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                    "A String",
+                  ],
+                  "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                      # is to use the existing disk.
+                  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                      # of I/O operations per second that the disk can handle. Values must be
+                      # between 10,000 and 120,000. For more details, see theExtreme persistent
+                      # disk documentation.
+                  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                      # number of throughput mb per second that the disk can handle. Values must
+                      # greater than or equal to 1.
+                  "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                      # the URLs of the zones where the disk should be replicated to.
+                      # You must provide exactly two replica zones, and one zone must be the same
+                      # as the instance zone.
+                    "A String",
+                  ],
+                  "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/{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",
+                  },
+                  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                      # Specified using the full or partial URL. For instance template, specify
+                      # only the resource policy name.
+                    "A String",
+                  ],
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                      # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                      # is required.
+                      #
+                      # To create a disk with one of the public operating system
+                      # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                      #
+                      # projects/debian-cloud/global/images/family/debian-9
+                      #
+                      #
+                      # Alternatively, use a specific version of a public operating system image:
+                      #
+                      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                      #
+                      #
+                      # To create a disk with a custom image that you created, specify the
+                      # image name in the following format:
+                      #
+                      # global/images/my-custom-image
+                      #
+                      #
+                      # You can also specify a custom image by its image family, which returns
+                      # the latest version of the image in that family. Replace the image name
+                      # with family/family-name:
+                      #
+                      # global/images/family/my-image-family
+                      #
+                      #
+                      # If the source image is deleted later, this field will not be set.
+                  "sourceImageEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source image. Required if the source image is
+                      # protected by a customer-supplied encryption key.
+                      #
+                      # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                      # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                      # source images are encrypted with your own keys.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                      # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                      # is required.
+                      #
+                      # To create a disk with a snapshot that you created, specify the
+                      # snapshot name in the following format:
+                      #
+                      # global/snapshots/my-backup
+                      #
+                      #
+                      # If the source snapshot is deleted later, this field will not be set.
+                      #
+                      # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                      # an image instead when you create VMs using
+                      # the bulk
+                      # insert method.
+                  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source snapshot.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                      #      - projects/project/zones/zone/storagePools/storagePool
+                      #    - zones/zone/storagePools/storagePool
+                },
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. For most machine types, the
+                    # default is SCSI. Local SSDs can use either NVME or SCSI.
+                    # In certain configurations, persistent disks can use NVMe. For more
+                    # information, seeAbout
+                    # persistent disks.
+                "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+                "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+                  "A String",
+                ],
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                    # in READ_WRITE mode.
+                "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                    # field is set to PRESERVED if the LocalSSD data has been saved
+                    # to a persistent location by customer request.  (see the
+                    # discard_local_ssd option on Stop/Suspend).
+                    # Read-only in the api.
+                "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                    # these are public keys which are safe to store in public
+                  "dbs": [ # The Key Database (db).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "dbxs": [ # The forbidden key database (dbx).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "keks": [ # The Key Exchange Key (KEK).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "pk": { # The Platform Key (PK).
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                },
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                    # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                    # is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using
+                    # this property. This field is only applicable for persistent disks.
+                    #
+                    # 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.
+              },
+            ],
+            "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+                # created from these properties.
+              { # A specification of the type and number of accelerator cards attached to the
+                  # instance.
+                "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                    # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                    # If you are creating an instance template, specify only the
+                    # accelerator name.
+                    # See GPUs on Compute Engine
+                    # for a full list of accelerator types.
+              },
+            ],
+            "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+                # "NONE". The default value is "NONE" if it is not specified.
+            "labels": { # Labels to apply to instances that are created from these properties.
+              "a_key": "A String",
+            },
+            "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+                # Local SSDs attached to the VM.
+            "machineType": "A String", # The machine type to use for instances that are created from these
+                # properties.
+                # This field only accepts a machine type name, for example `n2-standard-4`.
+                # If you use the machine type full or partial URL, for example
+                # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+                # the request will result in an `INTERNAL_ERROR`.
+            "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+                # these properties. These pairs can consist of custom metadata or predefined
+                # keys. SeeProject and
+                # instance metadata for more information.
+              "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+                  # the metadata's contents and used for optimistic locking. The
+                  # fingerprint is initially generated by Compute Engine and changes after
+                  # every request to modify or update metadata. You must always provide an
+                  # up-to-date fingerprint hash in order to update or change metadata,
+                  # otherwise the request will fail with error412 conditionNotMet.
+                  #
+                  # To see the latest fingerprint, make a get() request to
+                  # retrieve the resource.
+              "items": [ # Array of key/value pairs. The total size of all keys and values must be
+                  # less than 512 KB.
+                { # Metadata
+                  "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                      # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                      # This is reflected as part of a URL in the metadata server. Additionally, to
+                      # avoid ambiguity, keys must not conflict with any other metadata keys
+                      # for the project.
+                  "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                      # have meaning as interpreted by the image running in the instance. The
+                      # only restriction placed on values is that their size must be less than
+                      # or equal to 262144 bytes (256 KiB).
+                },
+              ],
+              "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+                  # for metadata.
+            },
+            "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+                # scheduled on the specified or newer cpu/platform. Applicable values are the
+                # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+                # information, read Specifying a
+                # Minimum CPU Platform.
+            "networkInterfaces": [ # An array of network access configurations for this interface.
+              { # A network interface resource attached to an instance.
+                "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                    # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                    # no external internet access.
+                  { # An access configuration attached to an instance's network interface.
+                      # Only one access config per instance is supported.
+                    "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                        # The first IPv6 address of the external IPv6 range associated
+                        # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                        # use a static external IP address, it must be unused and in the same region
+                        # as the instance's zone. If not specified, Google Cloud will automatically
+                        # assign an external IPv6 address from the instance's subnetwork.
+                    "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                        # external IPv6 range.
+                    "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                    "name": "A String", # The name of this access configuration. In accessConfigs
+                        # (IPv4), the default and recommended name is External NAT, but
+                        # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                        # recommend name is External IPv6.
+                    "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                        # address associated with this instance. Specify an unused static
+                        # external IP address available to the project or leave this field undefined
+                        # to use an IP from a shared ephemeral IP address pool. If you specify a
+                        # static external IP address, it must live in the same region as the zone of
+                        # the instance.
+                    "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                        # configuration and can only take the following values: PREMIUM,STANDARD.
+                        #
+                        # If an AccessConfig is specified without a valid external IP address, an
+                        # ephemeral IP will be created with this networkTier.
+                        #
+                        # If an AccessConfig with a valid external IP address is specified, it must
+                        # match that of the networkTier associated with the Address resource owning
+                        # that IP.
+                    "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                        #
+                        # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                        # first IP in associated external IPv6 range.
+                    "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                        # config.
+                    "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                        # external IP address of the instance to a DNS domain name.
+                        #
+                        # This field is not used in ipv6AccessConfig. A default PTR
+                        # record will be created if the VM has external IPv6 range associated.
+                    "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                        # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+                  },
+                ],
+                "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                    # You can only specify this field for network interfaces in VPC networks.
+                  { # An alias IP range attached to an instance's network interface.
+                    "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                        # must belong to the specified subnetwork and cannot contain IP addresses
+                        # reserved by system or used by other network interfaces. This range may be
+                        # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                    "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                        # alias range. If not specified, the primary range of the subnetwork is used.
+                  },
+                ],
+                "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                    # You can only specify this field for network interfaces in VPC networks.
+                  { # An alias IP range attached to an instance's network interface.
+                    "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                        # must belong to the specified subnetwork and cannot contain IP addresses
+                        # reserved by system or used by other network interfaces. This range may be
+                        # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                    "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                        # alias range. If not specified, the primary range of the subnetwork is used.
+                  },
+                ],
+                "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                    # with network_attachment.
+                "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                    # This field will be ignored when inserting an Instance or
+                    # adding a NetworkInterface. An up-to-date
+                    # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+                "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                    # or not. If enabled, also indicates the version of IGMP supported.
+                "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+                "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                    # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                    # is no ipv6AccessConfig specified, then this instance will
+                    # have no external IPv6 Internet access.
+                  { # An access configuration attached to an instance's network interface.
+                      # Only one access config per instance is supported.
+                    "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                        # The first IPv6 address of the external IPv6 range associated
+                        # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                        # use a static external IP address, it must be unused and in the same region
+                        # as the instance's zone. If not specified, Google Cloud will automatically
+                        # assign an external IPv6 address from the instance's subnetwork.
+                    "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                        # external IPv6 range.
+                    "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                    "name": "A String", # The name of this access configuration. In accessConfigs
+                        # (IPv4), the default and recommended name is External NAT, but
+                        # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                        # recommend name is External IPv6.
+                    "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                        # address associated with this instance. Specify an unused static
+                        # external IP address available to the project or leave this field undefined
+                        # to use an IP from a shared ephemeral IP address pool. If you specify a
+                        # static external IP address, it must live in the same region as the zone of
+                        # the instance.
+                    "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                        # configuration and can only take the following values: PREMIUM,STANDARD.
+                        #
+                        # If an AccessConfig is specified without a valid external IP address, an
+                        # ephemeral IP will be created with this networkTier.
+                        #
+                        # If an AccessConfig with a valid external IP address is specified, it must
+                        # match that of the networkTier associated with the Address resource owning
+                        # that IP.
+                    "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                        #
+                        # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                        # first IP in associated external IPv6 range.
+                    "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                        # config.
+                    "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                        # external IP address of the instance to a DNS domain name.
+                        #
+                        # This field is not used in ipv6AccessConfig. A default PTR
+                        # record will be created if the VM has external IPv6 range associated.
+                    "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                        # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+                  },
+                ],
+                "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                    # accessed from the Internet. This field is always inherited from its
+                    # subnetwork.
+                    #
+                    # Valid only if stackType is IPV4_IPV6.
+                "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                    # use a static internal IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an internal IPv6 address from the instance's subnetwork.
+                "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+                "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                    # server. For a VM, the network interface uses the nicN naming
+                    # format. Where N is a value between 0 and7. The default interface value is nic0.
+                "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                    # instance, if neither the network nor the subnetwork is specified, the
+                    # default network global/networks/default is used. If the
+                    # selected project doesn't have the default network, you must specify a
+                    # network or subnet. If the network is not specified but the subnetwork is
+                    # specified, the network is inferred.
+                    #
+                    # If you specify this property, you can specify the network as
+                    # a full or partial URL. For example, the following are all valid URLs:
+                    #
+                    #
+                    #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                    #       - projects/project/global/networks/network
+                    #       - global/networks/default
+                "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                    # to in the following format:
+                    # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+                "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                    # interface. If not specified by the user, an unused internal IP is
+                    # assigned by the system.
+                "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                    # VirtioNet.
+                "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+                "queueCount": 42, # The networking queue count that's specified by users for the network
+                    # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                    # if not specified by the users.
+                "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                    # interface. Can only be used with network_attachment. It is not possible to
+                    # use on its own however, network_attachment can be used without
+                    # service_class_id.
+                "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                    # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                    #
+                    # This field can be both set at instance creation and update network
+                    # interface operations.
+                "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                    # resource is inlegacy
+                    # mode, do not specify this field. If the network is in auto subnet
+                    # mode, specifying the subnetwork is optional. If the network is in custom
+                    # subnet mode, specifying the subnetwork is required. If you specify this
+                    # field, you can specify the subnetwork as a full or partial URL. For
+                    # example, the following are all valid URLs:
+                    #
+                    #
+                    #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                    #    - regions/region/subnetworks/subnetwork
+                "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                    # from 2 to 255 inclusively.
+              },
+            ],
+            "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+              "totalEgressBandwidthTier": "A String",
+            },
+            "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+                # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+                # Note that for MachineImage, this is not supported yet.
+            "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+                # Note that for MachineImage, this is not supported yet.
+              "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+                  # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+                  # Consuming reserved instances for examples.
+              "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+                  # the name of your reservation as its value.
+              "values": [ # Corresponds to the label values of a reservation resource. This can be
+                  # either a name to a reservation in the same project or
+                  # "projects/different-project/reservations/some-reservation-name" to target a
+                  # shared reservation in the same zone but in a different project.
+                "A String",
+              ],
+            },
+            "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/{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",
+            },
+            "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+                # these properties.
+                # Note that for MachineImage, this is not supported yet.
+              "A String",
+            ],
+            "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+                # these properties.
+              "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+                  # terminated by Compute Engine (not terminated by a user). You can only set
+                  # the automatic restart option for standard instances.Preemptible instances
+                  # cannot be automatically restarted.
+                  #
+                  # By default, this is set to true so an instance is
+                  # automatically restarted if it is terminated by Compute Engine.
+              "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+                  # must be a number between 1 and the number of availability domains
+                  # specified in the spread placement policy attached to the instance.
+              "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+                  # ResourceStatus resource of the VM.
+              "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+                "enabled": True or False, # Opts-in for graceful shutdown.
+                "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                    # graceful shutdown isn't complete after this time, then the instance
+                    # transitions to the STOPPING state.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+              "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+                  # within the range of [90, 330] with the increment of 30, if unset, the
+                  # default behavior of host error recovery will be used.
+              "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+              "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+                  # recovery of the Local Ssd state is attempted. Its value should be in
+                  # between 0 and 168 hours with hour granularity and the default value being 1
+                  # hour.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "locationHint": "A String", # An opaque location hint used to place the instance close to other
+                  # resources.
+                  # This field is for use by internal tools that use the public API.
+              "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+                  # the instance termination action will be performed at the end of the run
+                  # duration.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+                  # on a sole-tenant node.
+              "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+                  # affinity for more information.
+                  # Overrides reservationAffinity.
+                { # Node Affinity: the configuration of desired nodes onto which this Instance
+                    #  could be scheduled.
+                  "key": "A String", # Corresponds to the label key of Node resource.
+                  "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+                  "values": [ # Corresponds to the label values of Node resource.
+                    "A String",
+                  ],
+                },
+              ],
+              "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+                  # the default behavior is MIGRATE. Forpreemptible instances,
+                  # the default and only possible behavior is TERMINATE. For more
+                  # information, see
+                  #  Set
+                  #  VM host maintenance policy.
+              "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+                "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                    # else, the Local SSD data will be preserved when the instance is stopped
+                    # at the end of the run duration/termination time.
+              },
+              "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+                  # instance creation or while the instance isstopped and
+                  # therefore, in a `TERMINATED` state. SeeInstance Life
+                  # Cycle for more information on the possible instance states.
+              "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+                  # Soft Off signal is triggered for Spot VMs only. If not specified,
+                  # there will be no wait before the G2 Soft Off signal is triggered.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+              "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+                  # Off and ACPI G3 Mechanical
+                  # Off for Standard VMs and 30 seconds for Spot VMs.
+              "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+                  # termination action will be performed at the termination time.
+            },
+            "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+                # service accounts are available to the instances that are created from
+                # these properties. Use metadata queries to obtain the access tokens for
+                # these instances.
+              { # A service account.
+                "email": "A String", # Email address of the service account.
+                "scopes": [ # The list of scopes to be made available for this service account.
+                  "A String",
+                ],
+              },
+            ],
+            "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+              "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+                  # default.
+              "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+                  # default.
+              "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+                  # default.
+            },
+            "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+                # properties. The tags identify valid sources or targets for network
+                # firewalls. The setTags method can modify this list of tags. Each tag within
+                # the list must comply with RFC1035.
+              "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+                  # the tags' contents and used for optimistic locking. The
+                  # fingerprint is initially generated by Compute Engine and changes after
+                  # every request to modify or update tags. You must always provide an
+                  # up-to-date fingerprint hash in order to update or change tags.
+                  #
+                  # To see the latest fingerprint, make get() request to the
+                  # instance.
+              "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+                  # with RFC1035.
+                "A String",
+              ],
+            },
+            "workloadIdentityConfig": {
+              "identity": "A String",
+              "identityCertificateEnabled": True or False,
+            },
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+              # applicable for regional resources.
+          "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+              # URL.
+          "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+              #    - projects/project/zones/zone/instances/instance
+          "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+              # from a source instance.
+            "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+                # For boot disk and any other R/W disks, the source images for each disk
+                # will be used. For read-only disks, they will be attached in read-only
+                # mode. Local SSD disks will be created as blank volumes.
+              { # A specification of the desired way to instantiate a disk in the instance
+                  # template when its created from a source instance.
+                "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                    # deleted (but not when the disk is detached from the instance).
+                "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+                    # this instance template.
+                "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+                "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+                    # values are:
+                    #
+                    #
+                    #      - source-image: to use the same image that was used to
+                    #      create the source instance's corresponding disk. Applicable to the boot
+                    #      disk and additional read-write disks.
+                    #      - source-image-family: to use the same image family that
+                    #      was used to create the source instance's corresponding disk. Applicable
+                    #      to the boot disk and additional read-write disks.
+                    #      - custom-image: to use a user-provided image url for disk
+                    #      creation. Applicable to the boot disk and additional read-write
+                    #      disks.
+                    #    - attach-read-only: to attach a read-only
+                    #      disk. Applicable to read-only disks.
+                    #      - do-not-include: to exclude a disk from the template.
+                    #      Applicable to additional read-write disks, local SSDs, and read-only
+                    #      disks.
+              },
+            ],
+          },
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that replaces the list of instance
+          # templates 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#instanceTemplateAggregatedList", # 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.
+  "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, instanceTemplate, requestId=None, x__xgafv=None) + 
Deletes the specified instance template. Deleting an instance template is
+permanent and cannot be undone. It is not possible to delete templates
+that are already in use by a managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  instanceTemplate: string, The name of the instance template 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instanceTemplate, x__xgafv=None) + 
Returns the specified instance template.
+
+Args:
+  project: string, Project ID for this request. (required)
+  instanceTemplate: string, The name of the instance template. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Instance Template resource.
+    #
+    # Google Compute Engine has two Instance Template resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+    #
+    # You can reuse a global instance template in
+    # different regions whereas you can use a regional instance template in a
+    # specified region only. If you want to reduce cross-region dependency or
+    # achieve data residency, use a regional instance template.
+    #
+    # To create VMs, managed instance groups, and reservations, you can use either
+    # global or regional instance templates.
+    #
+    # For more information, readInstance Templates.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+      # defines this identifier.
+  "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+  "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.
+  "properties": { # The instance properties for this instance template.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+      # applicable for regional resources.
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+      # URL.
+  "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+      # from a source instance.
+    "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+        # For boot disk and any other R/W disks, the source images for each disk
+        # will be used. For read-only disks, they will be attached in read-only
+        # mode. Local SSD disks will be created as blank volumes.
+      { # A specification of the desired way to instantiate a disk in the instance
+          # template when its created from a source instance.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+            # this instance template.
+        "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+        "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+            # values are:
+            #
+            #
+            #      - source-image: to use the same image that was used to
+            #      create the source instance's corresponding disk. Applicable to the boot
+            #      disk and additional read-write disks.
+            #      - source-image-family: to use the same image family that
+            #      was used to create the source instance's corresponding disk. Applicable
+            #      to the boot disk and additional read-write disks.
+            #      - custom-image: to use a user-provided image url for disk
+            #      creation. Applicable to the boot disk and additional read-write
+            #      disks.
+            #    - attach-read-only: to attach a read-only
+            #      disk. Applicable to read-only disks.
+            #      - do-not-include: to exclude a disk from the template.
+            #      Applicable to additional read-write disks, local SSDs, and read-only
+            #      disks.
+      },
+    ],
+  },
+}
+
+ +
+ 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 an instance template in the specified project using the
+data that is included in the request. If you are creating a new template to
+update an existing instance group, your new instance template must use the
+same network or, if applicable, the same subnetwork as the original
+template.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Instance Template resource.
+    # 
+    # Google Compute Engine has two Instance Template resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+    # 
+    # You can reuse a global instance template in
+    # different regions whereas you can use a regional instance template in a
+    # specified region only. If you want to reduce cross-region dependency or
+    # achieve data residency, use a regional instance template.
+    # 
+    # To create VMs, managed instance groups, and reservations, you can use either
+    # global or regional instance templates.
+    # 
+    # For more information, readInstance Templates.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+      # defines this identifier.
+  "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+  "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.
+  "properties": { # The instance properties for this instance template.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+      # applicable for regional resources.
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+      # URL.
+  "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+      # from a source instance.
+    "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+        # For boot disk and any other R/W disks, the source images for each disk
+        # will be used. For read-only disks, they will be attached in read-only
+        # mode. Local SSD disks will be created as blank volumes.
+      { # A specification of the desired way to instantiate a disk in the instance
+          # template when its created from a source instance.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+            # this instance template.
+        "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+        "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+            # values are:
+            #
+            #
+            #      - source-image: to use the same image that was used to
+            #      create the source instance's corresponding disk. Applicable to the boot
+            #      disk and additional read-write disks.
+            #      - source-image-family: to use the same image family that
+            #      was used to create the source instance's corresponding disk. Applicable
+            #      to the boot disk and additional read-write disks.
+            #      - custom-image: to use a user-provided image url for disk
+            #      creation. Applicable to the boot disk and additional read-write
+            #      disks.
+            #    - attach-read-only: to attach a read-only
+            #      disk. Applicable to read-only disks.
+            #      - do-not-include: to exclude a disk from the template.
+            #      Applicable to additional read-write disks, local SSDs, and read-only
+            #      disks.
+      },
+    ],
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of instance templates that are 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of instance templates.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceTemplate resources.
+    { # Represents an Instance Template resource.
+        #
+        # Google Compute Engine has two Instance Template resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+        # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+        #
+        # You can reuse a global instance template in
+        # different regions whereas you can use a regional instance template in a
+        # specified region only. If you want to reduce cross-region dependency or
+        # achieve data residency, use a regional instance template.
+        #
+        # To create VMs, managed instance groups, and reservations, you can use either
+        # global or regional instance templates.
+        #
+        # For more information, readInstance Templates.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+          # defines this identifier.
+      "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+      "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.
+      "properties": { # The instance properties for this instance template.
+        "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+            # Note that for MachineImage, this is not supported yet.
+            # Options that would traditionally be configured in a BIOS belong
+            # here. Features that require operating system support may have
+            # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+            # disabled).
+          "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+          "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+          "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+          "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+              # multithreading (SMT) set this to 1. If unset, the maximum number
+              # of threads supported per core by the underlying processor is
+              # assumed.
+          "turboMode": "A String", # Turbo frequency mode to use for the instance.
+              # Supported modes include:
+              # * ALL_CORE_MAX
+              #
+              # Using empty string or not setting this field will use the platform-specific
+              # default turbo mode.
+          "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+              # the number of threads per core to compute the total number of virtual
+              # CPUs to expose to the instance. If unset, the number of cores is
+              # inferred from the instance's nominal CPU count and the underlying
+              # platform's SMT width.
+        },
+        "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+            # source IP addresses other than their own and receive packets with
+            # destination IP addresses other than their own. If these instances will be
+            # used as an IP gateway or it will be set as the next-hop in a Route
+            # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+            # documentation for more information.
+        "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+            # Note that for MachineImage, this is not supported yet.
+          "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+          "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+        },
+        "description": "A String", # An optional text description for the instances that are created from these
+            # properties.
+        "disks": [ # An array of disks that are associated with the instances that are created
+            # from these properties.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+            # created from these properties.
+          { # A specification of the type and number of accelerator cards attached to the
+              # instance.
+            "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+            "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                # If you are creating an instance template, specify only the
+                # accelerator name.
+                # See GPUs on Compute Engine
+                # for a full list of accelerator types.
+          },
+        ],
+        "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+            # "NONE". The default value is "NONE" if it is not specified.
+        "labels": { # Labels to apply to instances that are created from these properties.
+          "a_key": "A String",
+        },
+        "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+            # Local SSDs attached to the VM.
+        "machineType": "A String", # The machine type to use for instances that are created from these
+            # properties.
+            # This field only accepts a machine type name, for example `n2-standard-4`.
+            # If you use the machine type full or partial URL, for example
+            # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+            # the request will result in an `INTERNAL_ERROR`.
+        "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+            # these properties. These pairs can consist of custom metadata or predefined
+            # keys. SeeProject and
+            # instance metadata for more information.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve the resource.
+          "items": [ # Array of key/value pairs. The total size of all keys and values must be
+              # less than 512 KB.
+            { # Metadata
+              "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                  # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                  # This is reflected as part of a URL in the metadata server. Additionally, to
+                  # avoid ambiguity, keys must not conflict with any other metadata keys
+                  # for the project.
+              "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                  # have meaning as interpreted by the image running in the instance. The
+                  # only restriction placed on values is that their size must be less than
+                  # or equal to 262144 bytes (256 KiB).
+            },
+          ],
+          "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+              # for metadata.
+        },
+        "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+            # scheduled on the specified or newer cpu/platform. Applicable values are the
+            # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+            # information, read Specifying a
+            # Minimum CPU Platform.
+        "networkInterfaces": [ # An array of network access configurations for this interface.
+          { # A network interface resource attached to an instance.
+            "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                # no external internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                # with network_attachment.
+            "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                # This field will be ignored when inserting an Instance or
+                # adding a NetworkInterface. An up-to-date
+                # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+            "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                # or not. If enabled, also indicates the version of IGMP supported.
+            "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+            "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                # is no ipv6AccessConfig specified, then this instance will
+                # have no external IPv6 Internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                # accessed from the Internet. This field is always inherited from its
+                # subnetwork.
+                #
+                # Valid only if stackType is IPV4_IPV6.
+            "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                # use a static internal IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an internal IPv6 address from the instance's subnetwork.
+            "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+            "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                # server. For a VM, the network interface uses the nicN naming
+                # format. Where N is a value between 0 and7. The default interface value is nic0.
+            "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                # instance, if neither the network nor the subnetwork is specified, the
+                # default network global/networks/default is used. If the
+                # selected project doesn't have the default network, you must specify a
+                # network or subnet. If the network is not specified but the subnetwork is
+                # specified, the network is inferred.
+                #
+                # If you specify this property, you can specify the network as
+                # a full or partial URL. For example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                #       - projects/project/global/networks/network
+                #       - global/networks/default
+            "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                # to in the following format:
+                # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+            "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                # interface. If not specified by the user, an unused internal IP is
+                # assigned by the system.
+            "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                # VirtioNet.
+            "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+            "queueCount": 42, # The networking queue count that's specified by users for the network
+                # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                # if not specified by the users.
+            "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                # interface. Can only be used with network_attachment. It is not possible to
+                # use on its own however, network_attachment can be used without
+                # service_class_id.
+            "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                #
+                # This field can be both set at instance creation and update network
+                # interface operations.
+            "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                # resource is inlegacy
+                # mode, do not specify this field. If the network is in auto subnet
+                # mode, specifying the subnetwork is optional. If the network is in custom
+                # subnet mode, specifying the subnetwork is required. If you specify this
+                # field, you can specify the subnetwork as a full or partial URL. For
+                # example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                #    - regions/region/subnetworks/subnetwork
+            "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                # from 2 to 255 inclusively.
+          },
+        ],
+        "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+          "totalEgressBandwidthTier": "A String",
+        },
+        "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+            # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+            # Note that for MachineImage, this is not supported yet.
+        "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+            # Note that for MachineImage, this is not supported yet.
+          "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+              # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+              # Consuming reserved instances for examples.
+          "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+              # the name of your reservation as its value.
+          "values": [ # Corresponds to the label values of a reservation resource. This can be
+              # either a name to a reservation in the same project or
+              # "projects/different-project/reservations/some-reservation-name" to target a
+              # shared reservation in the same zone but in a different project.
+            "A String",
+          ],
+        },
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+            # these properties.
+            # Note that for MachineImage, this is not supported yet.
+          "A String",
+        ],
+        "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+            # these properties.
+          "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+              # terminated by Compute Engine (not terminated by a user). You can only set
+              # the automatic restart option for standard instances.Preemptible instances
+              # cannot be automatically restarted.
+              #
+              # By default, this is set to true so an instance is
+              # automatically restarted if it is terminated by Compute Engine.
+          "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+              # must be a number between 1 and the number of availability domains
+              # specified in the spread placement policy attached to the instance.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+              # ResourceStatus resource of the VM.
+          "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+            "enabled": True or False, # Opts-in for graceful shutdown.
+            "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                # graceful shutdown isn't complete after this time, then the instance
+                # transitions to the STOPPING state.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+              # within the range of [90, 330] with the increment of 30, if unset, the
+              # default behavior of host error recovery will be used.
+          "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+          "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+              # recovery of the Local Ssd state is attempted. Its value should be in
+              # between 0 and 168 hours with hour granularity and the default value being 1
+              # hour.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "locationHint": "A String", # An opaque location hint used to place the instance close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+              # the instance termination action will be performed at the end of the run
+              # duration.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+              # on a sole-tenant node.
+          "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+              # affinity for more information.
+              # Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which this Instance
+                #  could be scheduled.
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+              # the default behavior is MIGRATE. Forpreemptible instances,
+              # the default and only possible behavior is TERMINATE. For more
+              # information, see
+              #  Set
+              #  VM host maintenance policy.
+          "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+            "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                # else, the Local SSD data will be preserved when the instance is stopped
+                # at the end of the run duration/termination time.
+          },
+          "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+              # instance creation or while the instance isstopped and
+              # therefore, in a `TERMINATED` state. SeeInstance Life
+              # Cycle for more information on the possible instance states.
+          "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+              # Soft Off signal is triggered for Spot VMs only. If not specified,
+              # there will be no wait before the G2 Soft Off signal is triggered.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+          "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+              # Off and ACPI G3 Mechanical
+              # Off for Standard VMs and 30 seconds for Spot VMs.
+          "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+              # termination action will be performed at the termination time.
+        },
+        "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+            # service accounts are available to the instances that are created from
+            # these properties. Use metadata queries to obtain the access tokens for
+            # these instances.
+          { # A service account.
+            "email": "A String", # Email address of the service account.
+            "scopes": [ # The list of scopes to be made available for this service account.
+              "A String",
+            ],
+          },
+        ],
+        "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+          "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+              # default.
+          "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+              # default.
+          "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+              # default.
+        },
+        "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+            # properties. The tags identify valid sources or targets for network
+            # firewalls. The setTags method can modify this list of tags. Each tag within
+            # the list must comply with RFC1035.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the tags' contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update tags. You must always provide an
+              # up-to-date fingerprint hash in order to update or change tags.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+              # with RFC1035.
+            "A String",
+          ],
+        },
+        "workloadIdentityConfig": {
+          "identity": "A String",
+          "identityCertificateEnabled": True or False,
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+          # applicable for regional resources.
+      "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+          # URL.
+      "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+          #    - projects/project/zones/zone/instances/instance
+      "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+          # from a source instance.
+        "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+            # For boot disk and any other R/W disks, the source images for each disk
+            # will be used. For read-only disks, they will be attached in read-only
+            # mode. Local SSD disks will be created as blank volumes.
+          { # A specification of the desired way to instantiate a disk in the instance
+              # template when its created from a source instance.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+                # this instance template.
+            "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+            "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+                # values are:
+                #
+                #
+                #      - source-image: to use the same image that was used to
+                #      create the source instance's corresponding disk. Applicable to the boot
+                #      disk and additional read-write disks.
+                #      - source-image-family: to use the same image family that
+                #      was used to create the source instance's corresponding disk. Applicable
+                #      to the boot disk and additional read-write disks.
+                #      - custom-image: to use a user-provided image url for disk
+                #      creation. Applicable to the boot disk and additional read-write
+                #      disks.
+                #    - attach-read-only: to attach a read-only
+                #      disk. Applicable to read-only disks.
+                #      - do-not-include: to exclude a disk from the template.
+                #      Applicable to additional read-write disks, local SSDs, and read-only
+                #      disks.
+          },
+        ],
+      },
+    },
+  ],
+  "kind": "compute#instanceTemplateList", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template
+      # lists.
+  "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.
+  "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_preview.instances.html b/docs/dyn/compute_preview.instances.html new file mode 100644 index 0000000000..9227ab97b6 --- /dev/null +++ b/docs/dyn/compute_preview.instances.html @@ -0,0 +1,23618 @@ + + + +

Compute Engine API . instances

+

Instance Methods

+

+ addAccessConfig(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None)

+

Adds an access config to an instance's network interface.

+

+ addNetworkInterface(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Adds one dynamic network interface to an active instance.

+

+ addResourcePolicies(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Adds existing resource policies to an instance. You can only add one

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of all of the instances in your project

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ attachDisk(project, zone, instance, body=None, forceAttach=None, requestId=None, x__xgafv=None)

+

Attaches an existing Disk resource to an instance. You must first

+

+ bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates multiple instances. Count specifies the number of instances to

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, instance, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Deletes the specified Instance resource. For more information, seeDeleting

+

+ deleteAccessConfig(project, zone, instance, accessConfig, networkInterface, requestId=None, x__xgafv=None)

+

Deletes an access config from an instance's network interface.

+

+ deleteNetworkInterface(project, zone, instance, networkInterfaceName, requestId=None, x__xgafv=None)

+

Deletes one dynamic network interface from an active instance.

+

+ detachDisk(project, zone, instance, deviceName, requestId=None, x__xgafv=None)

+

Detaches a disk from an instance.

+

+ get(project, zone, instance, x__xgafv=None)

+

Returns the specified Instance resource.

+

+ getEffectiveFirewalls(project, zone, instance, networkInterface, x__xgafv=None)

+

Returns effective firewalls applied to an interface of the instance.

+

+ getGuestAttributes(project, zone, instance, queryPath=None, variableKey=None, x__xgafv=None)

+

Returns the specified guest attributes entry.

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getScreenshot(project, zone, instance, x__xgafv=None)

+

Returns the screenshot from the specified instance.

+

+ getSerialPortOutput(project, zone, instance, port=None, start=None, x__xgafv=None)

+

Returns the last 1 MB of serial port output from the specified instance.

+

+ getShieldedInstanceIdentity(project, zone, instance, x__xgafv=None)

+

Returns the Shielded Instance Identity of an instance

+

+ insert(project, zone, body=None, requestId=None, sourceInstanceTemplate=None, sourceMachineImage=None, x__xgafv=None)

+

Creates an instance resource in the specified project using the data

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of instances contained within

+

+ listReferrers(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of resources that refer to the VM instance specified in

+

+ listReferrers_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ performMaintenance(project, zone, instance, requestId=None, x__xgafv=None)

+

Perform a manual maintenance on the instance.

+

+ removeResourcePolicies(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Removes resource policies from an instance.

+

+ reportHostAsFaulty(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Mark the host as faulty and try to restart the instance on a new host.

+

+ reset(project, zone, instance, requestId=None, x__xgafv=None)

+

Performs a reset on the instance. This is a hard reset. The VM

+

+ resume(project, zone, instance, requestId=None, x__xgafv=None)

+

Resumes an instance that was suspended using theinstances().suspend

+

+ sendDiagnosticInterrupt(project, zone, instance, x__xgafv=None)

+

Sends diagnostic interrupt to the instance.

+

+ setDeletionProtection(project, zone, resource, deletionProtection=None, requestId=None, x__xgafv=None)

+

Sets deletion protection on the instance.

+

+ setDiskAutoDelete(project, zone, instance, autoDelete, deviceName, requestId=None, x__xgafv=None)

+

Sets the auto-delete flag for a disk attached to an instance.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets labels on an instance. To learn more about labels, read theLabeling

+

+ setMachineResources(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Changes the number and/or type of accelerator for a stopped instance to the

+

+ setMachineType(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Changes the machine type for a stopped instance to the machine

+

+ setMetadata(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets metadata for the specified instance to the data included

+

+ setMinCpuPlatform(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Changes the minimum CPU platform that this instance should use.

+

+ setName(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets name of an instance.

+

+ setScheduling(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets an instance's scheduling options. You can only call this method on astopped instance,

+

+ setSecurityPolicy(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets the Google Cloud Armor security policy for the specified instance.

+

+ setServiceAccount(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets the service account on the instance. For more information,

+

+ setShieldedInstanceIntegrityPolicy(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets the Shielded Instance integrity policy for an instance. You can

+

+ setTags(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Sets network tags

+

+ simulateMaintenanceEvent(project, zone, instance, requestId=None, withExtendedNotifications=None, x__xgafv=None)

+

Simulates a host maintenance event on a VM. For more information, see

+

+ start(project, zone, instance, requestId=None, x__xgafv=None)

+

Starts an instance that was stopped using theinstances().stop

+

+ startWithEncryptionKey(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Starts an instance that was stopped using theinstances().stop

+

+ stop(project, zone, instance, discardLocalSsd=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Stops a running instance, shutting it down cleanly, and allows

+

+ suspend(project, zone, instance, discardLocalSsd=None, requestId=None, x__xgafv=None)

+

This method suspends a running instance, saving its state to persistent

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, zone, instance, body=None, discardLocalSsd=None, minimalAction=None, mostDisruptiveAllowedAction=None, requestId=None, x__xgafv=None)

+

Updates an instance only if the necessary resources are available. This

+

+ updateAccessConfig(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None)

+

Updates the specified access config from an instance's network interface

+

+ updateDisplayDevice(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Updates the Display config for a VM instance. You can

+

+ updateNetworkInterface(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None)

+

Updates an instance's network interface. This method can only update an

+

+ updateShieldedInstanceConfig(project, zone, instance, body=None, requestId=None, x__xgafv=None)

+

Updates the Shielded Instance config for an instance. You can

+

Method Details

+
+ addAccessConfig(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None) + 
Adds an access config to an instance's network interface.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  networkInterface: string, The name of the network interface to add to this instance. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An access configuration attached to an instance's network interface.
+    # Only one access config per instance is supported.
+  "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+      # The first IPv6 address of the external IPv6 range associated
+      # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+      # use a static external IP address, it must be unused and in the same region
+      # as the instance's zone. If not specified, Google Cloud will automatically
+      # assign an external IPv6 address from the instance's subnetwork.
+  "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+      # external IPv6 range.
+  "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+  "name": "A String", # The name of this access configuration. In accessConfigs
+      # (IPv4), the default and recommended name is External NAT, but
+      # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+      # recommend name is External IPv6.
+  "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+      # address associated with this instance. Specify an unused static
+      # external IP address available to the project or leave this field undefined
+      # to use an IP from a shared ephemeral IP address pool. If you specify a
+      # static external IP address, it must live in the same region as the zone of
+      # the instance.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this access
+      # configuration and can only take the following values: PREMIUM,STANDARD.
+      # 
+      # If an AccessConfig is specified without a valid external IP address, an
+      # ephemeral IP will be created with this networkTier.
+      # 
+      # If an AccessConfig with a valid external IP address is specified, it must
+      # match that of the networkTier associated with the Address resource owning
+      # that IP.
+  "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+      # 
+      # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+      # first IP in associated external IPv6 range.
+  "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+      # config.
+  "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+      # external IP address of the instance to a DNS domain name.
+      # 
+      # This field is not used in ipv6AccessConfig. A default PTR
+      # record will be created if the VM has external IPv6 range associated.
+  "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+      # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addNetworkInterface(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Adds one dynamic network interface to an active instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request stored as resource_id.
+Name should conform to RFC1035 or be an unsigned long integer. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A network interface resource attached to an instance.
+  "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+      # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+      # no external internet access.
+    { # An access configuration attached to an instance's network interface.
+        # Only one access config per instance is supported.
+      "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+          # The first IPv6 address of the external IPv6 range associated
+          # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+          # use a static external IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an external IPv6 address from the instance's subnetwork.
+      "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+          # external IPv6 range.
+      "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+      "name": "A String", # The name of this access configuration. In accessConfigs
+          # (IPv4), the default and recommended name is External NAT, but
+          # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+          # recommend name is External IPv6.
+      "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+          # address associated with this instance. Specify an unused static
+          # external IP address available to the project or leave this field undefined
+          # to use an IP from a shared ephemeral IP address pool. If you specify a
+          # static external IP address, it must live in the same region as the zone of
+          # the instance.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this access
+          # configuration and can only take the following values: PREMIUM,STANDARD.
+          #
+          # If an AccessConfig is specified without a valid external IP address, an
+          # ephemeral IP will be created with this networkTier.
+          #
+          # If an AccessConfig with a valid external IP address is specified, it must
+          # match that of the networkTier associated with the Address resource owning
+          # that IP.
+      "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+          #
+          # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+          # first IP in associated external IPv6 range.
+      "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+          # config.
+      "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+          # external IP address of the instance to a DNS domain name.
+          #
+          # This field is not used in ipv6AccessConfig. A default PTR
+          # record will be created if the VM has external IPv6 range associated.
+      "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+          # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+    },
+  ],
+  "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+      # You can only specify this field for network interfaces in VPC networks.
+    { # An alias IP range attached to an instance's network interface.
+      "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+          # must belong to the specified subnetwork and cannot contain IP addresses
+          # reserved by system or used by other network interfaces. This range may be
+          # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+      "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+          # alias range. If not specified, the primary range of the subnetwork is used.
+    },
+  ],
+  "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+      # You can only specify this field for network interfaces in VPC networks.
+    { # An alias IP range attached to an instance's network interface.
+      "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+          # must belong to the specified subnetwork and cannot contain IP addresses
+          # reserved by system or used by other network interfaces. This range may be
+          # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+      "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+          # alias range. If not specified, the primary range of the subnetwork is used.
+    },
+  ],
+  "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+      # with network_attachment.
+  "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+      # This field will be ignored when inserting an Instance or
+      # adding a NetworkInterface. An up-to-date
+      # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+  "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+      # or not. If enabled, also indicates the version of IGMP supported.
+  "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+  "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+      # one IPv6 access config, DIRECT_IPV6, is supported. If there
+      # is no ipv6AccessConfig specified, then this instance will
+      # have no external IPv6 Internet access.
+    { # An access configuration attached to an instance's network interface.
+        # Only one access config per instance is supported.
+      "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+          # The first IPv6 address of the external IPv6 range associated
+          # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+          # use a static external IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an external IPv6 address from the instance's subnetwork.
+      "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+          # external IPv6 range.
+      "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+      "name": "A String", # The name of this access configuration. In accessConfigs
+          # (IPv4), the default and recommended name is External NAT, but
+          # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+          # recommend name is External IPv6.
+      "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+          # address associated with this instance. Specify an unused static
+          # external IP address available to the project or leave this field undefined
+          # to use an IP from a shared ephemeral IP address pool. If you specify a
+          # static external IP address, it must live in the same region as the zone of
+          # the instance.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this access
+          # configuration and can only take the following values: PREMIUM,STANDARD.
+          #
+          # If an AccessConfig is specified without a valid external IP address, an
+          # ephemeral IP will be created with this networkTier.
+          #
+          # If an AccessConfig with a valid external IP address is specified, it must
+          # match that of the networkTier associated with the Address resource owning
+          # that IP.
+      "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+          #
+          # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+          # first IP in associated external IPv6 range.
+      "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+          # config.
+      "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+          # external IP address of the instance to a DNS domain name.
+          #
+          # This field is not used in ipv6AccessConfig. A default PTR
+          # record will be created if the VM has external IPv6 range associated.
+      "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+          # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+    },
+  ],
+  "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+      # accessed from the Internet. This field is always inherited from its
+      # subnetwork.
+      # 
+      # Valid only if stackType is IPV4_IPV6.
+  "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+      # use a static internal IP address, it must be unused and in the same region
+      # as the instance's zone. If not specified, Google Cloud will automatically
+      # assign an internal IPv6 address from the instance's subnetwork.
+  "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+  "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+      # server. For a VM, the network interface uses the nicN naming
+      # format. Where N is a value between 0 and7. The default interface value is nic0.
+  "network": "A String", # URL of the VPC network resource for this instance. When creating an
+      # instance, if neither the network nor the subnetwork is specified, the
+      # default network global/networks/default is used. If the
+      # selected project doesn't have the default network, you must specify a
+      # network or subnet. If the network is not specified but the subnetwork is
+      # specified, the network is inferred.
+      # 
+      # If you specify this property, you can specify the network as
+      # a full or partial URL. For example, the following are all valid URLs:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+      #       - projects/project/global/networks/network
+      #       - global/networks/default
+  "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+      # to in the following format:
+      # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+  "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+      # interface. If not specified by the user, an unused internal IP is
+      # assigned by the system.
+  "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+      # VirtioNet.
+  "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+  "queueCount": 42, # The networking queue count that's specified by users for the network
+      # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+      # if not specified by the users.
+  "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+      # interface. Can only be used with network_attachment. It is not possible to
+      # use on its own however, network_attachment can be used without
+      # service_class_id.
+  "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+      # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+      # 
+      # This field can be both set at instance creation and update network
+      # interface operations.
+  "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+      # resource is inlegacy
+      # mode, do not specify this field. If the network is in auto subnet
+      # mode, specifying the subnetwork is optional. If the network is in custom
+      # subnet mode, specifying the subnetwork is required. If you specify this
+      # field, you can specify the subnetwork as a full or partial URL. For
+      # example, the following are all valid URLs:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+      #    - regions/region/subnetworks/subnetwork
+  "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+      # from 2 to 255 inclusively.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addResourcePolicies(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Adds existing resource policies to an instance. You can only add one
+policy right now which will be applied to this instance for scheduling live
+migrations.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Resource policies to be added to this instance.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of all of the instances in your project
+across all regions and zones.
+
+The performance of this method degrades when a filter is specified on a
+project that has a very large number of instances.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # An object that contains a list of instances scoped by zone.
+    "a_key": { # [Output Only] Name of the scope containing this set of instances.
+      "instances": [ # [Output Only] A list of instances contained in this scope.
+        { # Represents an Instance resource.
+            #
+            # An instance is a virtual machine that is hosted on Google Cloud Platform.
+            # For more information, readVirtual Machine Instances.
+          "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+              # Options that would traditionally be configured in a BIOS belong
+              # here. Features that require operating system support may have
+              # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+              # disabled).
+            "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+            "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+            "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+            "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+                # multithreading (SMT) set this to 1. If unset, the maximum number
+                # of threads supported per core by the underlying processor is
+                # assumed.
+            "turboMode": "A String", # Turbo frequency mode to use for the instance.
+                # Supported modes include:
+                # * ALL_CORE_MAX
+                #
+                # Using empty string or not setting this field will use the platform-specific
+                # default turbo mode.
+            "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+                # the number of threads per core to compute the total number of virtual
+                # CPUs to expose to the instance. If unset, the number of cores is
+                # inferred from the instance's nominal CPU count and the underlying
+                # platform's SMT width.
+          },
+          "canIpForward": True or False, # Allows this instance to send and receive packets with non-matching
+              # destination or source IPs. This is required if you plan to use this
+              # instance to forward routes. For more information, seeEnabling IP Forwarding.
+          "confidentialInstanceConfig": { # A set of Confidential Instance options.
+            "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+            "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+          },
+          "cpuPlatform": "A String", # Output only. [Output Only] The CPU platform used by this instance.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+          "deletionProtection": True or False, # Whether the resource should be protected against deletion.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "disks": [ # Array of disks associated with this instance. Persistent disks must be
+              # created before you can assign them.
+            { # An instance-attached disk resource.
+              "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                  # or X86_64.
+              "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                  # deleted (but not when the disk is detached from the instance).
+              "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                  # partition of the disk for its root filesystem.
+              "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                  # running within the instance. This name can be used to reference the device
+                  # for mounting, resizing, and so on, from within the instance.
+                  #
+                  # If not specified, the server chooses a default device name to apply to this
+                  # disk, in the form persistent-disk-x, where x is a number
+                  # assigned by Google Compute Engine. This field is only applicable for
+                  # persistent disks.
+              "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                  # encryption key.
+                  #
+                  # If you are creating a new disk, this field encrypts the new disk using
+                  # an encryption key that you provide. If you are attaching an existing
+                  # disk that is already encrypted, this field decrypts the disk using
+                  # the customer-supplied encryption key.
+                  #
+                  # If you encrypt a disk using a customer-supplied key, you must provide the
+                  # same key again when you attempt to use this resource at a later time. For
+                  # example, you must provide the key when you create a snapshot or an image
+                  # from the disk or when you attach the disk to a virtual machine instance.
+                  #
+                  # If you do not provide an encryption key, then the disk will be encrypted
+                  # using an automatically generated key and you do not need to provide a key
+                  # to use the disk later.
+                  #
+                  # Note:
+                  #
+                  # Instance templates do not storecustomer-supplied
+                  # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                  #
+                  # You cannot create VMs that have disks with customer-supplied keys using
+                  # the bulk
+                  # insert method.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "diskSizeGb": "A String", # The size of the disk in GB.
+              "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                  # currently attached to another instance. If you try to force attach a zonal
+                  # disk to an instance, you will receive an error.
+              "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                  # only for bootable images. Read
+                  # Enabling guest operating system features to see a list of available
+                  # options.
+                { # Guest OS features.
+                  "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                      # separate values. Set to one or more of the following values:
+                      #
+                      #    - VIRTIO_SCSI_MULTIQUEUE
+                      #    - WINDOWS
+                      #    - MULTI_IP_SUBNET
+                      #    - UEFI_COMPATIBLE
+                      #    - GVNIC
+                      #    - SEV_CAPABLE
+                      #    - SUSPEND_RESUME_COMPATIBLE
+                      #    - SEV_LIVE_MIGRATABLE_V2
+                      #    - SEV_SNP_CAPABLE
+                      #    - TDX_CAPABLE
+                      #    - IDPF
+                      #    - SNP_SVSM_CAPABLE
+                      #    - CCA_CAPABLE
+                      #    - SUSPEND_SAFE_FPR
+                      #
+                      #
+                      # For more information, see
+                      # Enabling guest operating system features.
+                },
+              ],
+              "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                  # boot disk. If you have many disks attached to an instance, each
+                  # disk would have a unique index number.
+              "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                  # alongside the new instance. Use initialization parameters to create boot
+                  # disks or local SSDs attached to the new instance.
+                  #
+                  # This property is mutually exclusive with the source property;
+                  # you can only define one or the other, but not both.
+                  # alongside the new instance. Use initialization parameters to create boot
+                  # disks or local SSDs attached to the new instance.
+                  #
+                  # This field is persisted and returned for instanceTemplate and not returned
+                  # in the context of instance.
+                  #
+                  # This property is mutually exclusive with the source property;
+                  # you can only define one or the other, but not both.
+                "architecture": "A String", # The architecture of the attached disk. Valid values are
+                    # arm64 or x86_64.
+                "description": "A String", # An optional description. Provide this property when creating the disk.
+                "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                    # of the instance. If a disk with the same name already exists in the given
+                    # region, the existing disk is attached to the new instance and the
+                    # new disk is not created.
+                "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                    # 10 GB. If you specify a sourceImage, which is required for
+                    # boot disks, the default size is the size of the sourceImage.
+                    # If you do not specify a sourceImage, the default disk size
+                    # is 500 GB.
+                "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                    # disk. For valid disk type values, see
+                    # Supported types for Hyperdisk volumes and
+                    # Persistent Disk type variables.
+                    #
+                    # When creating a single instance, you must provide either the full or
+                    # partial URL of the disk type. For example, the following values are
+                    # valid:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                    #      - projects/project/zones/zone/diskTypes/diskType
+                    #      - zones/zone/diskTypes/diskType
+                    #
+                    #
+                    #
+                    # When creating an instance template, instance flexibility policy, or when
+                    # creating or updating an all-instances configuration, you specify the
+                    # disk type without a URL, for example, hyperdisk-balanced.
+                    #
+                    # If you omit this field for a disk, the default disk type depends on
+                    # the instance's machine series, as follows.
+                    #
+                    #
+                    #     - For first- and second-generation machine series like N1, N2, T2, and
+                    #     M1, the
+                    #        default disk type is Standard Persistent Disk
+                    #        (pd-standard).
+                    #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                    #     (pd-balanced).
+                    #    - For other third-generation machine
+                    #     series like A3, H3, Z3, all
+                    #         fourth-generation types like C4, N4, M4, and newer machine series,
+                    #         the default is Hyperdisk Balanced
+                    #         (hyperdisk-balanced).
+                    #
+                    #
+                    #
+                    # The disk type you specify must be compatible with the instance's machine
+                    # series. For a list of machine series that support Persistent Disk, see Machine
+                    # series support for Persistent Disk.
+                    #
+                    # For a list of machine series that support Hyperdisk, seeMachine
+                    # series support for Hyperdisk.
+                "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+                "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                    # persistent disks.
+                  "a_key": "A String",
+                },
+                "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                  "A String",
+                ],
+                "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                    # is to use the existing disk.
+                "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                    # of I/O operations per second that the disk can handle. Values must be
+                    # between 10,000 and 120,000. For more details, see theExtreme persistent
+                    # disk documentation.
+                "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                    # number of throughput mb per second that the disk can handle. Values must
+                    # greater than or equal to 1.
+                "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                    # the URLs of the zones where the disk should be replicated to.
+                    # You must provide exactly two replica zones, and one zone must be the same
+                    # as the instance zone.
+                  "A String",
+                ],
+                "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/{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",
+                },
+                "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                    # Specified using the full or partial URL. For instance template, specify
+                    # only the resource policy name.
+                  "A String",
+                ],
+                "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                    # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                    # is required.
+                    #
+                    # To create a disk with one of the public operating system
+                    # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                    #
+                    # projects/debian-cloud/global/images/family/debian-9
+                    #
+                    #
+                    # Alternatively, use a specific version of a public operating system image:
+                    #
+                    # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                    #
+                    #
+                    # To create a disk with a custom image that you created, specify the
+                    # image name in the following format:
+                    #
+                    # global/images/my-custom-image
+                    #
+                    #
+                    # You can also specify a custom image by its image family, which returns
+                    # the latest version of the image in that family. Replace the image name
+                    # with family/family-name:
+                    #
+                    # global/images/family/my-image-family
+                    #
+                    #
+                    # If the source image is deleted later, this field will not be set.
+                "sourceImageEncryptionKey": { # Thecustomer-supplied
+                    # encryption key of the source image. Required if the source image is
+                    # protected by a customer-supplied encryption key.
+                    #
+                    # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                    # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                    # source images are encrypted with your own keys.
+                  "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                      # For example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      #
+                      # The fully-qualifed key name may be returned for resource GET requests. For
+                      # example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      # /cryptoKeyVersions/1
+                  "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                      # key. If absent, the Compute Engine default service account is used.
+                      # For example:
+                      #
+                      # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                  "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies a 256-bit customer-supplied
+                      # encryption key, encoded in RFC
+                      # 4648 base64 to either encrypt or decrypt this resource. You can
+                      # provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rawKey":
+                      # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                  "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                      # customer-supplied encryption key to either encrypt or decrypt this
+                      # resource. You can provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rsaEncryptedKey":
+                      # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                      # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                      # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                      #
+                      # The key must meet the following requirements before you can provide it to
+                      # Compute Engine:
+                      #
+                      #    1. The key is wrapped using a RSA public key certificate provided by
+                      #    Google.
+                      #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                      #    encoding.
+                      #
+                      # Gets the RSA public key certificate provided by Google at:
+                      #
+                      #
+                      # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                  "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # [Output only] TheRFC
+                      # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                      # encryption key that protects this resource.
+                },
+                "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                    # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                    # is required.
+                    #
+                    # To create a disk with a snapshot that you created, specify the
+                    # snapshot name in the following format:
+                    #
+                    # global/snapshots/my-backup
+                    #
+                    #
+                    # If the source snapshot is deleted later, this field will not be set.
+                    #
+                    # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                    # an image instead when you create VMs using
+                    # the bulk
+                    # insert method.
+                "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                    # encryption key of the source snapshot.
+                  "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                      # For example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      #
+                      # The fully-qualifed key name may be returned for resource GET requests. For
+                      # example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      # /cryptoKeyVersions/1
+                  "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                      # key. If absent, the Compute Engine default service account is used.
+                      # For example:
+                      #
+                      # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                  "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies a 256-bit customer-supplied
+                      # encryption key, encoded in RFC
+                      # 4648 base64 to either encrypt or decrypt this resource. You can
+                      # provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rawKey":
+                      # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                  "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                      # customer-supplied encryption key to either encrypt or decrypt this
+                      # resource. You can provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rsaEncryptedKey":
+                      # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                      # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                      # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                      #
+                      # The key must meet the following requirements before you can provide it to
+                      # Compute Engine:
+                      #
+                      #    1. The key is wrapped using a RSA public key certificate provided by
+                      #    Google.
+                      #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                      #    encoding.
+                      #
+                      # Gets the RSA public key certificate provided by Google at:
+                      #
+                      #
+                      # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                  "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # [Output only] TheRFC
+                      # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                      # encryption key that protects this resource.
+                },
+                "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                    #      - projects/project/zones/zone/storagePools/storagePool
+                    #    - zones/zone/storagePools/storagePool
+              },
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. For most machine types, the
+                  # default is SCSI. Local SSDs can use either NVME or SCSI.
+                  # In certain configurations, persistent disks can use NVMe. For more
+                  # information, seeAbout
+                  # persistent disks.
+              "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+              "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+                "A String",
+              ],
+              "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                  # in READ_WRITE mode.
+              "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                  # field is set to PRESERVED if the LocalSSD data has been saved
+                  # to a persistent location by customer request.  (see the
+                  # discard_local_ssd option on Stop/Suspend).
+                  # Read-only in the api.
+              "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                  # these are public keys which are safe to store in public
+                "dbs": [ # The Key Database (db).
+                  {
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                ],
+                "dbxs": [ # The forbidden key database (dbx).
+                  {
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                ],
+                "keks": [ # The Key Exchange Key (KEK).
+                  {
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                ],
+                "pk": { # The Platform Key (PK).
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              },
+              "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                  # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # If desired, you can also attach existing non-root persistent disks using
+                  # this property. This field is only applicable for persistent disks.
+                  #
+                  # 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.
+            },
+          ],
+          "displayDevice": { # A set of Display Device options # Enables display device for the instance.
+            "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+          },
+          "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+              # the instance's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update the instance. You must always provide an
+              # up-to-date fingerprint hash in order to update the instance.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "hostname": "A String", # Specifies the hostname of the instance. The specified hostname must be
+              # RFC1035 compliant. If hostname is not specified, the default hostname is
+              # [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and
+              # [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instanceEncryptionKey": { # Encrypts suspended data for an instance with acustomer-managed
+              # encryption key.
+              #
+              # If you are creating a new instance, this field will encrypt the local SSD
+              # and in-memory contents of the instance during the suspend operation.
+              #
+              # If you do not provide an encryption key when creating the instance, then
+              # the local SSD and in-memory contents will be encrypted using
+              # an automatically generated key during the suspend operation.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+              # "NONE". The default value is "NONE" if it is not specified.
+          "kind": "compute#instance", # Output only. [Output Only] Type of the resource. Always compute#instance
+              # for instances.
+          "labelFingerprint": "A String", # A fingerprint for this request, which is essentially a hash of
+              # the label's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "labels": { # Labels to apply to this instance. These can be later modified by
+              # the setLabels method.
+            "a_key": "A String",
+          },
+          "lastStartTimestamp": "A String", # Output only. [Output Only] Last start timestamp inRFC3339 text format.
+          "lastStopTimestamp": "A String", # Output only. [Output Only] Last stop timestamp inRFC3339 text format.
+          "lastSuspendedTimestamp": "A String", # Output only. [Output Only] Last suspended timestamp inRFC3339 text format.
+          "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+              # Local SSDs attached to the VM.
+          "machineType": "A String", # Full or partial URL of the machine type resource to use for this instance,
+              # in the format:zones/zone/machineTypes/machine-type. This is provided by the client
+              # when the instance is created. For example, the following is a valid partial
+              # url to a predefined
+              # machine type:
+              #
+              # zones/us-central1-f/machineTypes/n1-standard-1
+              #
+              #
+              # To create acustom
+              # machine type, provide a URL to a machine type in the following format,
+              # where CPUS is 1 or an even number up to 32 (2,
+              # 4, 6, ... 24, etc), and MEMORY is the total
+              # memory for this instance. Memory must be a multiple of 256 MB and must
+              # be supplied in MB (e.g. 5 GB of memory is 5120 MB):
+              #
+              # zones/zone/machineTypes/custom-CPUS-MEMORY
+              #
+              #
+              # For example: zones/us-central1-f/machineTypes/custom-4-5120
+              #
+              # For a full list of restrictions, read theSpecifications
+              # for custom machine types.
+          "metadata": { # A metadata key/value entry. # The metadata key/value pairs assigned
+              # to this instance. This includes metadata keys that were explicitly defined
+              # for the instance.
+            "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+                # the metadata's contents and used for optimistic locking. The
+                # fingerprint is initially generated by Compute Engine and changes after
+                # every request to modify or update metadata. You must always provide an
+                # up-to-date fingerprint hash in order to update or change metadata,
+                # otherwise the request will fail with error412 conditionNotMet.
+                #
+                # To see the latest fingerprint, make a get() request to
+                # retrieve the resource.
+            "items": [ # Array of key/value pairs. The total size of all keys and values must be
+                # less than 512 KB.
+              { # Metadata
+                "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                    # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                    # This is reflected as part of a URL in the metadata server. Additionally, to
+                    # avoid ambiguity, keys must not conflict with any other metadata keys
+                    # for the project.
+                "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                    # have meaning as interpreted by the image running in the instance. The
+                    # only restriction placed on values is that their size must be less than
+                    # or equal to 262144 bytes (256 KiB).
+              },
+            ],
+            "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+                # for metadata.
+          },
+          "minCpuPlatform": "A String", # Specifies aminimum CPU
+              # platform for the VM instance. Applicable values are the friendly names
+              # of CPU platforms, such as minCpuPlatform: "Intel
+              # Haswell" or minCpuPlatform: "Intel Sandy
+              # Bridge".
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "networkInterfaces": [ # An array of network configurations for this instance. These specify how
+              # interfaces are configured to interact with other network services, such as
+              # connecting to the internet. Multiple interfaces are supported
+              # per instance.
+            { # A network interface resource attached to an instance.
+              "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                  # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                  # no external internet access.
+                { # An access configuration attached to an instance's network interface.
+                    # Only one access config per instance is supported.
+                  "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                      # The first IPv6 address of the external IPv6 range associated
+                      # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                      # use a static external IP address, it must be unused and in the same region
+                      # as the instance's zone. If not specified, Google Cloud will automatically
+                      # assign an external IPv6 address from the instance's subnetwork.
+                  "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                      # external IPv6 range.
+                  "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                  "name": "A String", # The name of this access configuration. In accessConfigs
+                      # (IPv4), the default and recommended name is External NAT, but
+                      # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                      # recommend name is External IPv6.
+                  "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                      # address associated with this instance. Specify an unused static
+                      # external IP address available to the project or leave this field undefined
+                      # to use an IP from a shared ephemeral IP address pool. If you specify a
+                      # static external IP address, it must live in the same region as the zone of
+                      # the instance.
+                  "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                      # configuration and can only take the following values: PREMIUM,STANDARD.
+                      #
+                      # If an AccessConfig is specified without a valid external IP address, an
+                      # ephemeral IP will be created with this networkTier.
+                      #
+                      # If an AccessConfig with a valid external IP address is specified, it must
+                      # match that of the networkTier associated with the Address resource owning
+                      # that IP.
+                  "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                      #
+                      # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                      # first IP in associated external IPv6 range.
+                  "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                      # config.
+                  "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                      # external IP address of the instance to a DNS domain name.
+                      #
+                      # This field is not used in ipv6AccessConfig. A default PTR
+                      # record will be created if the VM has external IPv6 range associated.
+                  "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                      # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+                },
+              ],
+              "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                  # You can only specify this field for network interfaces in VPC networks.
+                { # An alias IP range attached to an instance's network interface.
+                  "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                      # must belong to the specified subnetwork and cannot contain IP addresses
+                      # reserved by system or used by other network interfaces. This range may be
+                      # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                  "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                      # alias range. If not specified, the primary range of the subnetwork is used.
+                },
+              ],
+              "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                  # You can only specify this field for network interfaces in VPC networks.
+                { # An alias IP range attached to an instance's network interface.
+                  "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                      # must belong to the specified subnetwork and cannot contain IP addresses
+                      # reserved by system or used by other network interfaces. This range may be
+                      # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                  "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                      # alias range. If not specified, the primary range of the subnetwork is used.
+                },
+              ],
+              "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                  # with network_attachment.
+              "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                  # This field will be ignored when inserting an Instance or
+                  # adding a NetworkInterface. An up-to-date
+                  # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+              "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                  # or not. If enabled, also indicates the version of IGMP supported.
+              "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+              "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                  # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                  # is no ipv6AccessConfig specified, then this instance will
+                  # have no external IPv6 Internet access.
+                { # An access configuration attached to an instance's network interface.
+                    # Only one access config per instance is supported.
+                  "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                      # The first IPv6 address of the external IPv6 range associated
+                      # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                      # use a static external IP address, it must be unused and in the same region
+                      # as the instance's zone. If not specified, Google Cloud will automatically
+                      # assign an external IPv6 address from the instance's subnetwork.
+                  "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                      # external IPv6 range.
+                  "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                  "name": "A String", # The name of this access configuration. In accessConfigs
+                      # (IPv4), the default and recommended name is External NAT, but
+                      # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                      # recommend name is External IPv6.
+                  "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                      # address associated with this instance. Specify an unused static
+                      # external IP address available to the project or leave this field undefined
+                      # to use an IP from a shared ephemeral IP address pool. If you specify a
+                      # static external IP address, it must live in the same region as the zone of
+                      # the instance.
+                  "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                      # configuration and can only take the following values: PREMIUM,STANDARD.
+                      #
+                      # If an AccessConfig is specified without a valid external IP address, an
+                      # ephemeral IP will be created with this networkTier.
+                      #
+                      # If an AccessConfig with a valid external IP address is specified, it must
+                      # match that of the networkTier associated with the Address resource owning
+                      # that IP.
+                  "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                      #
+                      # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                      # first IP in associated external IPv6 range.
+                  "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                      # config.
+                  "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                      # external IP address of the instance to a DNS domain name.
+                      #
+                      # This field is not used in ipv6AccessConfig. A default PTR
+                      # record will be created if the VM has external IPv6 range associated.
+                  "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                      # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+                },
+              ],
+              "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                  # accessed from the Internet. This field is always inherited from its
+                  # subnetwork.
+                  #
+                  # Valid only if stackType is IPV4_IPV6.
+              "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                  # use a static internal IP address, it must be unused and in the same region
+                  # as the instance's zone. If not specified, Google Cloud will automatically
+                  # assign an internal IPv6 address from the instance's subnetwork.
+              "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+              "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                  # server. For a VM, the network interface uses the nicN naming
+                  # format. Where N is a value between 0 and7. The default interface value is nic0.
+              "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                  # instance, if neither the network nor the subnetwork is specified, the
+                  # default network global/networks/default is used. If the
+                  # selected project doesn't have the default network, you must specify a
+                  # network or subnet. If the network is not specified but the subnetwork is
+                  # specified, the network is inferred.
+                  #
+                  # If you specify this property, you can specify the network as
+                  # a full or partial URL. For example, the following are all valid URLs:
+                  #
+                  #
+                  #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                  #       - projects/project/global/networks/network
+                  #       - global/networks/default
+              "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                  # to in the following format:
+                  # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+              "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                  # interface. If not specified by the user, an unused internal IP is
+                  # assigned by the system.
+              "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                  # VirtioNet.
+              "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+              "queueCount": 42, # The networking queue count that's specified by users for the network
+                  # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                  # if not specified by the users.
+              "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                  # interface. Can only be used with network_attachment. It is not possible to
+                  # use on its own however, network_attachment can be used without
+                  # service_class_id.
+              "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                  # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                  #
+                  # This field can be both set at instance creation and update network
+                  # interface operations.
+              "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                  # resource is inlegacy
+                  # mode, do not specify this field. If the network is in auto subnet
+                  # mode, specifying the subnetwork is optional. If the network is in custom
+                  # subnet mode, specifying the subnetwork is required. If you specify this
+                  # field, you can specify the subnetwork as a full or partial URL. For
+                  # example, the following are all valid URLs:
+                  #
+                  #
+                  #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                  #    - regions/region/subnetworks/subnetwork
+              "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                  # from 2 to 255 inclusively.
+            },
+          ],
+          "networkPerformanceConfig": {
+            "totalEgressBandwidthTier": "A String",
+          },
+          "params": { # Additional instance params. # Input only. [Input Only] Additional params passed with the request, but not persisted
+              # as part of resource payload.
+            "requestValidForDuration": { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity. Relevant only for
+                # Instances.Insert API.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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": { # 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/{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",
+            },
+          },
+          "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for the VM.
+              # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+          "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that this instance can consume from.
+            "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+                # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+                # Consuming reserved instances for examples.
+            "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+                # the name of your reservation as its value.
+            "values": [ # Corresponds to the label values of a reservation resource. This can be
+                # either a name to a reservation in the same project or
+                # "projects/different-project/reservations/some-reservation-name" to target a
+                # shared reservation in the same zone but in a different project.
+              "A String",
+            ],
+          },
+          "resourcePolicies": [ # Resource policies applied to this instance.
+            "A String",
+          ],
+          "resourceStatus": { # Contains output only fields. # Output only. [Output Only] Specifies values set for instance attributes as
+              # compared to the values requested by user in the corresponding input only
+              # field.
+              # Use this sub-message for actual values set on Instance attributes as compared
+              # to the value requested by the user (intent) in their instance CRUD calls.
+            "effectiveInstanceMetadata": { # Effective values of predefined metadata keys for an instance. # Output only. [Output Only] Effective metadata is a field that consolidates project,
+                # zonal instance settings, and instance-level predefined metadata keys to
+                # provide the overridden value for those metadata keys at the instance level.
+              "blockProjectSshKeysMetadataValue": True or False, # Effective block-project-ssh-keys value at Instance level.
+              "enableGuestAttributesMetadataValue": True or False, # Effective enable-guest-attributes value at Instance level.
+              "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.
+            },
+            "physicalHost": "A String", # Output only. [Output Only] The precise location of your instance within the zone's data
+                # center, including the block, sub-block, and host. The field is formatted as
+                # follows: blockId/subBlockId/hostId.
+            "physicalHostTopology": { # Represents the physical host topology of the host on which the VM is # Output only. [Output Only] A series of fields containing the global name of the Compute
+                # Engine cluster, as well as the ID of the block, sub-block, and host on
+                # which the running instance is located.
+                # running.
+              "additionalAttributes": { # Additional location information of the running instance. # Output only. [Output Only] Additional location information of the running instance.
+                "acceleratorTopologyIds": { # Output only. The IDs of the accelerator topologies the instance belongs to. For
+                    # example
+                    # The key will be topologies like "4x4", "2x2x2" and the value will be
+                    # the location ID of the topologies.
+                  "a_key": "A String",
+                },
+              },
+              "block": "A String", # [Output Only] The ID of the block in which the running instance is
+                  # located. Instances within the same block experience low network latency.
+              "cluster": "A String", # [Output Only] The global name of the Compute Engine cluster where the
+                  # running instance is located.
+              "host": "A String", # [Output Only] The ID of the host on which the running instance is located.
+                  # Instances on the same host experience the lowest possible network
+                  # latency.
+              "subblock": "A String", # [Output Only] The ID of the sub-block in which the running instance is
+                  # located. Instances in the same sub-block experience lower network latency
+                  # than instances in the same block.
+            },
+            "reservationConsumptionInfo": { # Reservation consumption information that the instance is consuming from. # Output only. [Output Only] Reservation information that the instance is consuming from.
+              "consumedReservation": "A String", # Output only. [Output Only] The full resource name of the reservation that this
+                  # instance is consuming from.
+              "consumedReservationBlock": "A String", # Output only. [Output Only] The full resource name of the reservation block that this
+                  # instance is consuming from.
+              "consumedReservationSubBlock": "A String", # Output only. [Output Only] The full resource name of the reservation sub-block that
+                  # this instance is consuming from.
+            },
+            "scheduling": {
+              "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+                  # must be a number between 1 and the number of availability domains
+                  # specified in the spread placement policy attached to the instance.
+              "gracefulShutdownTimestamp": "A String", # Output only. Specifies the timestamp, when the instance will start graceful shutdown
+                  # process, in RFC3339 text format.
+              "terminationTimestamp": "A String", # Time in future when the instance will be terminated inRFC3339 text format.
+            },
+            "shutdownDetails": { # Specifies if the instance is in `PENDING_STOP` state or there is a # Output only. [Output Only] Details about the instance stopping state.
+                # programmed stop scheduled.
+              "maxDuration": { # A Duration represents a fixed-length span of time represented # The duration for graceful shutdown. Only applicable when
+                  # `stop_state=PENDING_STOP`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "requestTimestamp": "A String", # Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.
+              "stopState": "A String", # Current stopping state of the instance.
+              "targetState": "A String", # Target instance state.
+            },
+            "upcomingMaintenance": { # Upcoming Maintenance notification information.
+              "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+              "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                  # This timestamp value is in RFC3339 text format.
+              "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+              "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+                "A String",
+              ],
+              "maintenanceStatus": "A String",
+              "type": "A String", # Defines the type of maintenance.
+              "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                  # This timestamp value is in RFC3339 text format.
+              "windowStartTime": "A String", # The current start time of the maintenance window.
+                  # This timestamp value is in RFC3339 text format.
+            },
+          },
+          "satisfiesPzi": True or False, # Output only. [Output Only] Reserved for future use.
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "scheduling": { # Sets the scheduling options for an Instance. # Sets the scheduling options for this instance.
+            "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+                # terminated by Compute Engine (not terminated by a user). You can only set
+                # the automatic restart option for standard instances.Preemptible instances
+                # cannot be automatically restarted.
+                #
+                # By default, this is set to true so an instance is
+                # automatically restarted if it is terminated by Compute Engine.
+            "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+                # must be a number between 1 and the number of availability domains
+                # specified in the spread placement policy attached to the instance.
+            "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+                # ResourceStatus resource of the VM.
+            "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+              "enabled": True or False, # Opts-in for graceful shutdown.
+              "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                  # graceful shutdown isn't complete after this time, then the instance
+                  # transitions to the STOPPING state.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+                # within the range of [90, 330] with the increment of 30, if unset, the
+                # default behavior of host error recovery will be used.
+            "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+            "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+                # recovery of the Local Ssd state is attempted. Its value should be in
+                # between 0 and 168 hours with hour granularity and the default value being 1
+                # hour.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "locationHint": "A String", # An opaque location hint used to place the instance close to other
+                # resources.
+                # This field is for use by internal tools that use the public API.
+            "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+                # the instance termination action will be performed at the end of the run
+                # duration.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+                # on a sole-tenant node.
+            "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+                # affinity for more information.
+                # Overrides reservationAffinity.
+              { # Node Affinity: the configuration of desired nodes onto which this Instance
+                  #  could be scheduled.
+                "key": "A String", # Corresponds to the label key of Node resource.
+                "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+                "values": [ # Corresponds to the label values of Node resource.
+                  "A String",
+                ],
+              },
+            ],
+            "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+                # the default behavior is MIGRATE. Forpreemptible instances,
+                # the default and only possible behavior is TERMINATE. For more
+                # information, see
+                #  Set
+                #  VM host maintenance policy.
+            "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+              "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                  # else, the Local SSD data will be preserved when the instance is stopped
+                  # at the end of the run duration/termination time.
+            },
+            "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+                # instance creation or while the instance isstopped and
+                # therefore, in a `TERMINATED` state. SeeInstance Life
+                # Cycle for more information on the possible instance states.
+            "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+                # Soft Off signal is triggered for Spot VMs only. If not specified,
+                # there will be no wait before the G2 Soft Off signal is triggered.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+            "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+                # Off and ACPI G3 Mechanical
+                # Off for Standard VMs and 30 seconds for Spot VMs.
+            "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+                # termination action will be performed at the termination time.
+          },
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+          "serviceAccounts": [ # A list of service accounts, with their specified scopes, authorized for
+              # this instance. Only one service account per VM instance is supported.
+              #
+              # Service accounts generate access tokens that can be accessed
+              # through the metadata server and used to authenticate applications on the
+              # instance. SeeService Accounts
+              # for more information.
+            { # A service account.
+              "email": "A String", # Email address of the service account.
+              "scopes": [ # The list of scopes to be made available for this service account.
+                "A String",
+              ],
+            },
+          ],
+          "shieldedInstanceConfig": { # A set of Shielded Instance options.
+            "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+                # default.
+            "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+                # default.
+            "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+                # default.
+          },
+          "shieldedInstanceIntegrityPolicy": { # The policy describes the baseline against which
+              # Instance boot integrity is measured.
+            "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+                # measurements from the VM instance's most recent boot.
+          },
+          "sourceMachineImage": "A String", # Source machine image
+          "sourceMachineImageEncryptionKey": { # Source machine image encryption key when creating an instance from a
+              # machine image.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "startRestricted": True or False, # Output only. [Output Only] Whether a VM has been restricted for start because Compute
+              # Engine has detected suspicious activity.
+          "status": "A String", # Output only. [Output Only] The status of the instance. One of the
+              # following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the
+              # instance, see
+              # Instance life cycle.
+          "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+          "tags": { # A set of instance tags. # Tags to apply to this instance. Tags are used to identify valid
+              # sources or targets for network firewalls and are specified by the client
+              # during instance creation. The tags can be later modified by the setTags
+              # method. Each tag within the list must comply withRFC1035.
+              # Multiple tags can be specified via the 'tags.items' field.
+            "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+                # the tags' contents and used for optimistic locking. The
+                # fingerprint is initially generated by Compute Engine and changes after
+                # every request to modify or update tags. You must always provide an
+                # up-to-date fingerprint hash in order to update or change tags.
+                #
+                # To see the latest fingerprint, make get() request to the
+                # instance.
+            "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+                # with RFC1035.
+              "A String",
+            ],
+          },
+          "workloadIdentityConfig": {
+            "identity": "A String",
+            "identityCertificateEnabled": True or False,
+          },
+          "zone": "A String", # Output only. [Output Only] URL of the zone where the instance resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of instances
+          # 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#instanceAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of
+      # Instance resources.
+  "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.
+
+
+ +
+ attachDisk(project, zone, instance, body=None, forceAttach=None, requestId=None, x__xgafv=None) + 
Attaches an existing Disk resource to an instance. You must first
+create the disk before you can attach it. It is not possible to create
+and attach a disk at the same time. For more information, readAdding a
+persistent disk to your instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An instance-attached disk resource.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+      # or X86_64.
+  "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+      # deleted (but not when the disk is detached from the instance).
+  "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+      # partition of the disk for its root filesystem.
+  "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+      # running within the instance. This name can be used to reference the device
+      # for mounting, resizing, and so on, from within the instance.
+      # 
+      # If not specified, the server chooses a default device name to apply to this
+      # disk, in the form persistent-disk-x, where x is a number
+      # assigned by Google Compute Engine. This field is only applicable for
+      # persistent disks.
+  "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+      # encryption key.
+      # 
+      # If you are creating a new disk, this field encrypts the new disk using
+      # an encryption key that you provide. If you are attaching an existing
+      # disk that is already encrypted, this field decrypts the disk using
+      # the customer-supplied encryption key.
+      # 
+      # If you encrypt a disk using a customer-supplied key, you must provide the
+      # same key again when you attempt to use this resource at a later time. For
+      # example, you must provide the key when you create a snapshot or an image
+      # from the disk or when you attach the disk to a virtual machine instance.
+      # 
+      # If you do not provide an encryption key, then the disk will be encrypted
+      # using an automatically generated key and you do not need to provide a key
+      # to use the disk later.
+      # 
+      # Note:
+      # 
+      # Instance templates do not storecustomer-supplied
+      # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+      # 
+      # You cannot create VMs that have disks with customer-supplied keys using
+      # the bulk
+      # insert method.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "diskSizeGb": "A String", # The size of the disk in GB.
+  "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+      # currently attached to another instance. If you try to force attach a zonal
+      # disk to an instance, you will receive an error.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+      # boot disk. If you have many disks attached to an instance, each
+      # disk would have a unique index number.
+  "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+      # alongside the new instance. Use initialization parameters to create boot
+      # disks or local SSDs attached to the new instance.
+      # 
+      # This property is mutually exclusive with the source property;
+      # you can only define one or the other, but not both.
+      # alongside the new instance. Use initialization parameters to create boot
+      # disks or local SSDs attached to the new instance.
+      #
+      # This field is persisted and returned for instanceTemplate and not returned
+      # in the context of instance.
+      #
+      # This property is mutually exclusive with the source property;
+      # you can only define one or the other, but not both.
+    "architecture": "A String", # The architecture of the attached disk. Valid values are
+        # arm64 or x86_64.
+    "description": "A String", # An optional description. Provide this property when creating the disk.
+    "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+        # of the instance. If a disk with the same name already exists in the given
+        # region, the existing disk is attached to the new instance and the
+        # new disk is not created.
+    "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+        # 10 GB. If you specify a sourceImage, which is required for
+        # boot disks, the default size is the size of the sourceImage.
+        # If you do not specify a sourceImage, the default disk size
+        # is 500 GB.
+    "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+        # disk. For valid disk type values, see
+        # Supported types for Hyperdisk volumes and
+        # Persistent Disk type variables.
+        #
+        # When creating a single instance, you must provide either the full or
+        # partial URL of the disk type. For example, the following values are
+        # valid:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+        #      - projects/project/zones/zone/diskTypes/diskType
+        #      - zones/zone/diskTypes/diskType
+        #
+        #
+        #
+        # When creating an instance template, instance flexibility policy, or when
+        # creating or updating an all-instances configuration, you specify the
+        # disk type without a URL, for example, hyperdisk-balanced.
+        #
+        # If you omit this field for a disk, the default disk type depends on
+        # the instance's machine series, as follows.
+        #
+        #
+        #     - For first- and second-generation machine series like N1, N2, T2, and
+        #     M1, the
+        #        default disk type is Standard Persistent Disk
+        #        (pd-standard).
+        #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+        #     (pd-balanced).
+        #    - For other third-generation machine
+        #     series like A3, H3, Z3, all
+        #         fourth-generation types like C4, N4, M4, and newer machine series,
+        #         the default is Hyperdisk Balanced
+        #         (hyperdisk-balanced).
+        #
+        #
+        #
+        # The disk type you specify must be compatible with the instance's machine
+        # series. For a list of machine series that support Persistent Disk, see Machine
+        # series support for Persistent Disk.
+        #
+        # For a list of machine series that support Hyperdisk, seeMachine
+        # series support for Hyperdisk.
+    "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+    "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+        # persistent disks.
+      "a_key": "A String",
+    },
+    "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+      "A String",
+    ],
+    "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+        # is to use the existing disk.
+    "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+        # of I/O operations per second that the disk can handle. Values must be
+        # between 10,000 and 120,000. For more details, see theExtreme persistent
+        # disk documentation.
+    "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+        # number of throughput mb per second that the disk can handle. Values must
+        # greater than or equal to 1.
+    "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+        # the URLs of the zones where the disk should be replicated to.
+        # You must provide exactly two replica zones, and one zone must be the same
+        # as the instance zone.
+      "A String",
+    ],
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+        # Specified using the full or partial URL. For instance template, specify
+        # only the resource policy name.
+      "A String",
+    ],
+    "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+        # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+        # is required.
+        #
+        # To create a disk with one of the public operating system
+        # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+        #
+        # projects/debian-cloud/global/images/family/debian-9
+        #
+        #
+        # Alternatively, use a specific version of a public operating system image:
+        #
+        # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+        #
+        #
+        # To create a disk with a custom image that you created, specify the
+        # image name in the following format:
+        #
+        # global/images/my-custom-image
+        #
+        #
+        # You can also specify a custom image by its image family, which returns
+        # the latest version of the image in that family. Replace the image name
+        # with family/family-name:
+        #
+        # global/images/family/my-image-family
+        #
+        #
+        # If the source image is deleted later, this field will not be set.
+    "sourceImageEncryptionKey": { # Thecustomer-supplied
+        # encryption key of the source image. Required if the source image is
+        # protected by a customer-supplied encryption key.
+        #
+        # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+        # encryption keys, so you cannot create disks for instances in a managed instance group if the
+        # source images are encrypted with your own keys.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+        # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+        # is required.
+        #
+        # To create a disk with a snapshot that you created, specify the
+        # snapshot name in the following format:
+        #
+        # global/snapshots/my-backup
+        #
+        #
+        # If the source snapshot is deleted later, this field will not be set.
+        #
+        # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+        # an image instead when you create VMs using
+        # the bulk
+        # insert method.
+    "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+        # encryption key of the source snapshot.
+      "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+          # For example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          #
+          # The fully-qualifed key name may be returned for resource GET requests. For
+          # example:
+          #
+          # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeyVersions/1
+      "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+          # key. If absent, the Compute Engine default service account is used.
+          # For example:
+          #
+          # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+      "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies a 256-bit customer-supplied
+          # encryption key, encoded in RFC
+          # 4648 base64 to either encrypt or decrypt this resource. You can
+          # provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rawKey":
+          # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+      "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+          # customer-supplied encryption key to either encrypt or decrypt this
+          # resource. You can provide either the rawKey or thersaEncryptedKey.
+          # For example:
+          #
+          # "rsaEncryptedKey":
+          # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+          # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+          # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+          #
+          # The key must meet the following requirements before you can provide it to
+          # Compute Engine:
+          #
+          #    1. The key is wrapped using a RSA public key certificate provided by
+          #    Google.
+          #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+          #    encoding.
+          #
+          # Gets the RSA public key certificate provided by Google at:
+          #
+          #
+          # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+      "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+          # [Output only] TheRFC
+          # 4648 base64 encoded SHA-256 hash of the customer-supplied
+          # encryption key that protects this resource.
+    },
+    "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+        #      - projects/project/zones/zone/storagePools/storagePool
+        #    - zones/zone/storagePools/storagePool
+  },
+  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+      # either SCSI or NVME. For most machine types, the
+      # default is SCSI. Local SSDs can use either NVME or SCSI.
+      # In certain configurations, persistent disks can use NVMe. For more
+      # information, seeAbout
+      # persistent disks.
+  "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+  "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+    "A String",
+  ],
+  "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+      # in READ_WRITE mode.
+  "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+      # field is set to PRESERVED if the LocalSSD data has been saved
+      # to a persistent location by customer request.  (see the
+      # discard_local_ssd option on Stop/Suspend).
+      # Read-only in the api.
+  "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+      # these are public keys which are safe to store in public
+    "dbs": [ # The Key Database (db).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "dbxs": [ # The forbidden key database (dbx).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "keks": [ # The Key Exchange Key (KEK).
+      {
+        "content": "A String", # The raw content in the secure keys file.
+        "fileType": "A String", # The file type of source file.
+      },
+    ],
+    "pk": { # The Platform Key (PK).
+      "content": "A String", # The raw content in the secure keys file.
+      "fileType": "A String", # The file type of source file.
+    },
+  },
+  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+      # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+      # is required.
+      # 
+      # If desired, you can also attach existing non-root persistent disks using
+      # this property. This field is only applicable for persistent disks.
+      # 
+      # 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.
+}
+
+  forceAttach: boolean, Whether to force attach the regional disk even if it's currently attached
+to another instance. If you try to force attach a zonal disk to an
+instance, you will receive an error.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates multiple instances. Count specifies the number of instances to
+create. For more information, seeAbout bulk
+creation of VMs.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.instances.bulkInsert and
+    # compute.regionInstances.bulkInsert . This resource is not persisted
+    # anywhere, it is used only for processing the requests.
+  "count": "A String", # The maximum number of instances to create.
+  "instanceFlexibilityPolicy": { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
+    "instanceSelections": { # Specification of alternative, flexible instance subsets.
+        # One of them will be selected to create the instances
+        # based on various criteria, like:
+        # - ranks,
+        # - location policy,
+        # - current capacity,
+        # - available reservations (you can specify affinity in
+        # InstanceProperties),
+        # - SWAN/GOOSE limitations.
+        # Key is an arbitrary, unique RFC1035 string that identifies the instance
+        # selection.
+      "a_key": { # Specification of machine type to use. Every position inside this message
+          # is an alternative.
+          # The count specified in the shape flexibility must not exceed the number
+          # of entries in per_instance_properties or the capacity of the
+          # name_pattern, if used.
+        "disks": [ # Disks to be attached to the instances created from in this selection.
+            # They override the disks specified in the instance properties.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Alternative machine types to use for instances that are created from
+            # these properties. This field only accepts a machine type names, for
+            # example `n2-standard-4` and not URLs or partial URLs.
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": "A String", # Rank when prioritizing the shape flexibilities.
+            # The instance selections with rank are considered
+            # first, in the ascending order of the rank.
+            # If not set, defaults to 0.
+      },
+    },
+  },
+  "instanceProperties": { # The instance properties defining the VM instances to be created. Required
+      # if sourceInstanceTemplate is not provided.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "locationPolicy": { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
+      # bulk.
+      # (e.g. preferences for zone selection among zones in a single region).
+    "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.
+          "maxCount": 42, # Maximum number of items that are allowed to be placed in this zone.
+              # The value must be non-negative.
+        },
+        "preference": "A String", # Preference for a given location. Set to either ALLOW orDENY.
+      },
+    },
+    "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
+      # be created and instances already created will be deleted.
+  "namePattern": "A String", # The string pattern used for the names of the VMs.
+      # Either name_pattern or per_instance_properties
+      # must be set. The pattern must contain one continuous sequence of
+      # placeholder hash characters (#) with each character corresponding to one
+      # digit of the generated instance name. Example: a name_pattern
+      # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
+      # in the same project and zone have names that match the name pattern
+      # then the generated instance numbers start after the biggest
+      # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
+      # placeholder #...# can contain up to 18 characters.
+  "perInstanceProperties": { # Per-instance properties to be set on individual instances.
+      # Keys of this map specify requested instance names.
+      # Can be empty if name_pattern is used.
+    "a_key": { # Per-instance properties to be set on individual instances.
+        # To be extended in the future.
+      "hostname": "A String", # Specifies the hostname of the instance. More details in:
+          # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
+      "name": "A String", # Output only. This field is only temporary. It will be removed. Do not use it.
+    },
+  },
+  "sourceInstanceTemplate": "A String", # Specifies the instance template from which to create instances. You may
+      # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
+      # existing instance template. Bulk API follows the semantics of JSON Merge
+      # Patch described by RFC
+      # 7396.
+      # 
+      # It can be a full or partial URL. For example, the following are
+      # all valid URLs to an instance template:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+      #       - projects/project/global/instanceTemplates/instanceTemplate
+      #       - global/instanceTemplates/instanceTemplate
+      # 
+      # 
+      # 
+      # This field is optional.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, instance, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Deletes the specified Instance resource. For more information, seeDeleting
+an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to delete. (required)
+  noGracefulShutdown: boolean, If set to true, Graceful Shutdown is skipped.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteAccessConfig(project, zone, instance, accessConfig, networkInterface, requestId=None, x__xgafv=None) + 
Deletes an access config from an instance's network interface.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  accessConfig: string, The name of the access config to delete. (required)
+  networkInterface: string, The name of the network interface. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteNetworkInterface(project, zone, instance, networkInterfaceName, requestId=None, x__xgafv=None) + 
Deletes one dynamic network interface from an active instance.
+InstancesDeleteNetworkInterfaceRequest indicates:
+- instance from which to delete, using project+zone+resource_id fields;
+- dynamic network interface to be deleted, using network_interface_name
+field;
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request stored as resource_id.
+Name should conform to RFC1035 or be an unsigned long integer. (required)
+  networkInterfaceName: string, The name of the dynamic network interface to be deleted from the instance. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ detachDisk(project, zone, instance, deviceName, requestId=None, x__xgafv=None) + 
Detaches a disk from an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Instance name for this request. (required)
+  deviceName: string, The device name of the disk to detach. Make a get() request on
+the instance to view currently attached disks and device names. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instance, x__xgafv=None) + 
Returns the specified Instance resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance 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 an Instance resource.
+    #
+    # An instance is a virtual machine that is hosted on Google Cloud Platform.
+    # For more information, readVirtual Machine Instances.
+  "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+      # Options that would traditionally be configured in a BIOS belong
+      # here. Features that require operating system support may have
+      # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+      # disabled).
+    "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+    "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+    "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+    "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+        # multithreading (SMT) set this to 1. If unset, the maximum number
+        # of threads supported per core by the underlying processor is
+        # assumed.
+    "turboMode": "A String", # Turbo frequency mode to use for the instance.
+        # Supported modes include:
+        # * ALL_CORE_MAX
+        #
+        # Using empty string or not setting this field will use the platform-specific
+        # default turbo mode.
+    "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+        # the number of threads per core to compute the total number of virtual
+        # CPUs to expose to the instance. If unset, the number of cores is
+        # inferred from the instance's nominal CPU count and the underlying
+        # platform's SMT width.
+  },
+  "canIpForward": True or False, # Allows this instance to send and receive packets with non-matching
+      # destination or source IPs. This is required if you plan to use this
+      # instance to forward routes. For more information, seeEnabling IP Forwarding.
+  "confidentialInstanceConfig": { # A set of Confidential Instance options.
+    "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+    "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+  },
+  "cpuPlatform": "A String", # Output only. [Output Only] The CPU platform used by this instance.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+  "deletionProtection": True or False, # Whether the resource should be protected against deletion.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "disks": [ # Array of disks associated with this instance. Persistent disks must be
+      # created before you can assign them.
+    { # An instance-attached disk resource.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+          # or X86_64.
+      "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+          # deleted (but not when the disk is detached from the instance).
+      "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+          # partition of the disk for its root filesystem.
+      "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+          # running within the instance. This name can be used to reference the device
+          # for mounting, resizing, and so on, from within the instance.
+          #
+          # If not specified, the server chooses a default device name to apply to this
+          # disk, in the form persistent-disk-x, where x is a number
+          # assigned by Google Compute Engine. This field is only applicable for
+          # persistent disks.
+      "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+          # encryption key.
+          #
+          # If you are creating a new disk, this field encrypts the new disk using
+          # an encryption key that you provide. If you are attaching an existing
+          # disk that is already encrypted, this field decrypts the disk using
+          # the customer-supplied encryption key.
+          #
+          # If you encrypt a disk using a customer-supplied key, you must provide the
+          # same key again when you attempt to use this resource at a later time. For
+          # example, you must provide the key when you create a snapshot or an image
+          # from the disk or when you attach the disk to a virtual machine instance.
+          #
+          # If you do not provide an encryption key, then the disk will be encrypted
+          # using an automatically generated key and you do not need to provide a key
+          # to use the disk later.
+          #
+          # Note:
+          #
+          # Instance templates do not storecustomer-supplied
+          # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+          #
+          # You cannot create VMs that have disks with customer-supplied keys using
+          # the bulk
+          # insert method.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "diskSizeGb": "A String", # The size of the disk in GB.
+      "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+          # currently attached to another instance. If you try to force attach a zonal
+          # disk to an instance, you will receive an error.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+          # boot disk. If you have many disks attached to an instance, each
+          # disk would have a unique index number.
+      "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This field is persisted and returned for instanceTemplate and not returned
+          # in the context of instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+        "architecture": "A String", # The architecture of the attached disk. Valid values are
+            # arm64 or x86_64.
+        "description": "A String", # An optional description. Provide this property when creating the disk.
+        "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+            # of the instance. If a disk with the same name already exists in the given
+            # region, the existing disk is attached to the new instance and the
+            # new disk is not created.
+        "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+            # 10 GB. If you specify a sourceImage, which is required for
+            # boot disks, the default size is the size of the sourceImage.
+            # If you do not specify a sourceImage, the default disk size
+            # is 500 GB.
+        "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+            # disk. For valid disk type values, see
+            # Supported types for Hyperdisk volumes and
+            # Persistent Disk type variables.
+            #
+            # When creating a single instance, you must provide either the full or
+            # partial URL of the disk type. For example, the following values are
+            # valid:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+            #      - projects/project/zones/zone/diskTypes/diskType
+            #      - zones/zone/diskTypes/diskType
+            #
+            #
+            #
+            # When creating an instance template, instance flexibility policy, or when
+            # creating or updating an all-instances configuration, you specify the
+            # disk type without a URL, for example, hyperdisk-balanced.
+            #
+            # If you omit this field for a disk, the default disk type depends on
+            # the instance's machine series, as follows.
+            #
+            #
+            #     - For first- and second-generation machine series like N1, N2, T2, and
+            #     M1, the
+            #        default disk type is Standard Persistent Disk
+            #        (pd-standard).
+            #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+            #     (pd-balanced).
+            #    - For other third-generation machine
+            #     series like A3, H3, Z3, all
+            #         fourth-generation types like C4, N4, M4, and newer machine series,
+            #         the default is Hyperdisk Balanced
+            #         (hyperdisk-balanced).
+            #
+            #
+            #
+            # The disk type you specify must be compatible with the instance's machine
+            # series. For a list of machine series that support Persistent Disk, see Machine
+            # series support for Persistent Disk.
+            #
+            # For a list of machine series that support Hyperdisk, seeMachine
+            # series support for Hyperdisk.
+        "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+        "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+            # persistent disks.
+          "a_key": "A String",
+        },
+        "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+          "A String",
+        ],
+        "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+            # is to use the existing disk.
+        "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+            # of I/O operations per second that the disk can handle. Values must be
+            # between 10,000 and 120,000. For more details, see theExtreme persistent
+            # disk documentation.
+        "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+            # number of throughput mb per second that the disk can handle. Values must
+            # greater than or equal to 1.
+        "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+            # the URLs of the zones where the disk should be replicated to.
+            # You must provide exactly two replica zones, and one zone must be the same
+            # as the instance zone.
+          "A String",
+        ],
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+            # Specified using the full or partial URL. For instance template, specify
+            # only the resource policy name.
+          "A String",
+        ],
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+            # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # To create a disk with one of the public operating system
+            # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+            #
+            # projects/debian-cloud/global/images/family/debian-9
+            #
+            #
+            # Alternatively, use a specific version of a public operating system image:
+            #
+            # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+            #
+            #
+            # To create a disk with a custom image that you created, specify the
+            # image name in the following format:
+            #
+            # global/images/my-custom-image
+            #
+            #
+            # You can also specify a custom image by its image family, which returns
+            # the latest version of the image in that family. Replace the image name
+            # with family/family-name:
+            #
+            # global/images/family/my-image-family
+            #
+            #
+            # If the source image is deleted later, this field will not be set.
+        "sourceImageEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source image. Required if the source image is
+            # protected by a customer-supplied encryption key.
+            #
+            # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+            # encryption keys, so you cannot create disks for instances in a managed instance group if the
+            # source images are encrypted with your own keys.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+            # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+            # is required.
+            #
+            # To create a disk with a snapshot that you created, specify the
+            # snapshot name in the following format:
+            #
+            # global/snapshots/my-backup
+            #
+            #
+            # If the source snapshot is deleted later, this field will not be set.
+            #
+            # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+            # an image instead when you create VMs using
+            # the bulk
+            # insert method.
+        "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source snapshot.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+            #      - projects/project/zones/zone/storagePools/storagePool
+            #    - zones/zone/storagePools/storagePool
+      },
+      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+          # either SCSI or NVME. For most machine types, the
+          # default is SCSI. Local SSDs can use either NVME or SCSI.
+          # In certain configurations, persistent disks can use NVMe. For more
+          # information, seeAbout
+          # persistent disks.
+      "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+      "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+        "A String",
+      ],
+      "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+          # in READ_WRITE mode.
+      "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+          # field is set to PRESERVED if the LocalSSD data has been saved
+          # to a persistent location by customer request.  (see the
+          # discard_local_ssd option on Stop/Suspend).
+          # Read-only in the api.
+      "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+          # these are public keys which are safe to store in public
+        "dbs": [ # The Key Database (db).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "dbxs": [ # The forbidden key database (dbx).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "keks": [ # The Key Exchange Key (KEK).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "pk": { # The Platform Key (PK).
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      },
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+          # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+          # is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using
+          # this property. This field is only applicable for persistent disks.
+          #
+          # 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.
+    },
+  ],
+  "displayDevice": { # A set of Display Device options # Enables display device for the instance.
+    "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+  },
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the instance's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update the instance. You must always provide an
+      # up-to-date fingerprint hash in order to update the instance.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+  "hostname": "A String", # Specifies the hostname of the instance. The specified hostname must be
+      # RFC1035 compliant. If hostname is not specified, the default hostname is
+      # [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and
+      # [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceEncryptionKey": { # Encrypts suspended data for an instance with acustomer-managed
+      # encryption key.
+      #
+      # If you are creating a new instance, this field will encrypt the local SSD
+      # and in-memory contents of the instance during the suspend operation.
+      #
+      # If you do not provide an encryption key when creating the instance, then
+      # the local SSD and in-memory contents will be encrypted using
+      # an automatically generated key during the suspend operation.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+      # "NONE". The default value is "NONE" if it is not specified.
+  "kind": "compute#instance", # Output only. [Output Only] Type of the resource. Always compute#instance
+      # for instances.
+  "labelFingerprint": "A String", # A fingerprint for this request, which is essentially a hash of
+      # the label's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "labels": { # Labels to apply to this instance. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastStartTimestamp": "A String", # Output only. [Output Only] Last start timestamp inRFC3339 text format.
+  "lastStopTimestamp": "A String", # Output only. [Output Only] Last stop timestamp inRFC3339 text format.
+  "lastSuspendedTimestamp": "A String", # Output only. [Output Only] Last suspended timestamp inRFC3339 text format.
+  "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+      # Local SSDs attached to the VM.
+  "machineType": "A String", # Full or partial URL of the machine type resource to use for this instance,
+      # in the format:zones/zone/machineTypes/machine-type. This is provided by the client
+      # when the instance is created. For example, the following is a valid partial
+      # url to a predefined
+      # machine type:
+      #
+      # zones/us-central1-f/machineTypes/n1-standard-1
+      #
+      #
+      # To create acustom
+      # machine type, provide a URL to a machine type in the following format,
+      # where CPUS is 1 or an even number up to 32 (2,
+      # 4, 6, ... 24, etc), and MEMORY is the total
+      # memory for this instance. Memory must be a multiple of 256 MB and must
+      # be supplied in MB (e.g. 5 GB of memory is 5120 MB):
+      #
+      # zones/zone/machineTypes/custom-CPUS-MEMORY
+      #
+      #
+      # For example: zones/us-central1-f/machineTypes/custom-4-5120
+      #
+      # For a full list of restrictions, read theSpecifications
+      # for custom machine types.
+  "metadata": { # A metadata key/value entry. # The metadata key/value pairs assigned
+      # to this instance. This includes metadata keys that were explicitly defined
+      # for the instance.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the metadata's contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update metadata. You must always provide an
+        # up-to-date fingerprint hash in order to update or change metadata,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve the resource.
+    "items": [ # Array of key/value pairs. The total size of all keys and values must be
+        # less than 512 KB.
+      { # Metadata
+        "key": "A String", # Key for the metadata entry. Keys must conform to the following
+            # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+            # This is reflected as part of a URL in the metadata server. Additionally, to
+            # avoid ambiguity, keys must not conflict with any other metadata keys
+            # for the project.
+        "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+            # have meaning as interpreted by the image running in the instance. The
+            # only restriction placed on values is that their size must be less than
+            # or equal to 262144 bytes (256 KiB).
+      },
+    ],
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "minCpuPlatform": "A String", # Specifies aminimum CPU
+      # platform for the VM instance. Applicable values are the friendly names
+      # of CPU platforms, such as minCpuPlatform: "Intel
+      # Haswell" or minCpuPlatform: "Intel Sandy
+      # Bridge".
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "networkInterfaces": [ # An array of network configurations for this instance. These specify how
+      # interfaces are configured to interact with other network services, such as
+      # connecting to the internet. Multiple interfaces are supported
+      # per instance.
+    { # A network interface resource attached to an instance.
+      "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+          # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+          # no external internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+          # with network_attachment.
+      "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+          # This field will be ignored when inserting an Instance or
+          # adding a NetworkInterface. An up-to-date
+          # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+      "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+          # or not. If enabled, also indicates the version of IGMP supported.
+      "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+      "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+          # one IPv6 access config, DIRECT_IPV6, is supported. If there
+          # is no ipv6AccessConfig specified, then this instance will
+          # have no external IPv6 Internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+          # accessed from the Internet. This field is always inherited from its
+          # subnetwork.
+          #
+          # Valid only if stackType is IPV4_IPV6.
+      "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+          # use a static internal IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an internal IPv6 address from the instance's subnetwork.
+      "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+      "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+          # server. For a VM, the network interface uses the nicN naming
+          # format. Where N is a value between 0 and7. The default interface value is nic0.
+      "network": "A String", # URL of the VPC network resource for this instance. When creating an
+          # instance, if neither the network nor the subnetwork is specified, the
+          # default network global/networks/default is used. If the
+          # selected project doesn't have the default network, you must specify a
+          # network or subnet. If the network is not specified but the subnetwork is
+          # specified, the network is inferred.
+          #
+          # If you specify this property, you can specify the network as
+          # a full or partial URL. For example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+          #       - projects/project/global/networks/network
+          #       - global/networks/default
+      "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+          # to in the following format:
+          # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+      "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+          # interface. If not specified by the user, an unused internal IP is
+          # assigned by the system.
+      "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+          # VirtioNet.
+      "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+      "queueCount": 42, # The networking queue count that's specified by users for the network
+          # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+          # if not specified by the users.
+      "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+          # interface. Can only be used with network_attachment. It is not possible to
+          # use on its own however, network_attachment can be used without
+          # service_class_id.
+      "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+          # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+          #
+          # This field can be both set at instance creation and update network
+          # interface operations.
+      "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+          # resource is inlegacy
+          # mode, do not specify this field. If the network is in auto subnet
+          # mode, specifying the subnetwork is optional. If the network is in custom
+          # subnet mode, specifying the subnetwork is required. If you specify this
+          # field, you can specify the subnetwork as a full or partial URL. For
+          # example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+          #    - regions/region/subnetworks/subnetwork
+      "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+          # from 2 to 255 inclusively.
+    },
+  ],
+  "networkPerformanceConfig": {
+    "totalEgressBandwidthTier": "A String",
+  },
+  "params": { # Additional instance params. # Input only. [Input Only] Additional params passed with the request, but not persisted
+      # as part of resource payload.
+    "requestValidForDuration": { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity. Relevant only for
+        # Instances.Insert API.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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": { # 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/{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",
+    },
+  },
+  "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for the VM.
+      # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+  "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that this instance can consume from.
+    "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+        # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+        # Consuming reserved instances for examples.
+    "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+        # the name of your reservation as its value.
+    "values": [ # Corresponds to the label values of a reservation resource. This can be
+        # either a name to a reservation in the same project or
+        # "projects/different-project/reservations/some-reservation-name" to target a
+        # shared reservation in the same zone but in a different project.
+      "A String",
+    ],
+  },
+  "resourcePolicies": [ # Resource policies applied to this instance.
+    "A String",
+  ],
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] Specifies values set for instance attributes as
+      # compared to the values requested by user in the corresponding input only
+      # field.
+      # Use this sub-message for actual values set on Instance attributes as compared
+      # to the value requested by the user (intent) in their instance CRUD calls.
+    "effectiveInstanceMetadata": { # Effective values of predefined metadata keys for an instance. # Output only. [Output Only] Effective metadata is a field that consolidates project,
+        # zonal instance settings, and instance-level predefined metadata keys to
+        # provide the overridden value for those metadata keys at the instance level.
+      "blockProjectSshKeysMetadataValue": True or False, # Effective block-project-ssh-keys value at Instance level.
+      "enableGuestAttributesMetadataValue": True or False, # Effective enable-guest-attributes value at Instance level.
+      "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.
+    },
+    "physicalHost": "A String", # Output only. [Output Only] The precise location of your instance within the zone's data
+        # center, including the block, sub-block, and host. The field is formatted as
+        # follows: blockId/subBlockId/hostId.
+    "physicalHostTopology": { # Represents the physical host topology of the host on which the VM is # Output only. [Output Only] A series of fields containing the global name of the Compute
+        # Engine cluster, as well as the ID of the block, sub-block, and host on
+        # which the running instance is located.
+        # running.
+      "additionalAttributes": { # Additional location information of the running instance. # Output only. [Output Only] Additional location information of the running instance.
+        "acceleratorTopologyIds": { # Output only. The IDs of the accelerator topologies the instance belongs to. For
+            # example
+            # The key will be topologies like "4x4", "2x2x2" and the value will be
+            # the location ID of the topologies.
+          "a_key": "A String",
+        },
+      },
+      "block": "A String", # [Output Only] The ID of the block in which the running instance is
+          # located. Instances within the same block experience low network latency.
+      "cluster": "A String", # [Output Only] The global name of the Compute Engine cluster where the
+          # running instance is located.
+      "host": "A String", # [Output Only] The ID of the host on which the running instance is located.
+          # Instances on the same host experience the lowest possible network
+          # latency.
+      "subblock": "A String", # [Output Only] The ID of the sub-block in which the running instance is
+          # located. Instances in the same sub-block experience lower network latency
+          # than instances in the same block.
+    },
+    "reservationConsumptionInfo": { # Reservation consumption information that the instance is consuming from. # Output only. [Output Only] Reservation information that the instance is consuming from.
+      "consumedReservation": "A String", # Output only. [Output Only] The full resource name of the reservation that this
+          # instance is consuming from.
+      "consumedReservationBlock": "A String", # Output only. [Output Only] The full resource name of the reservation block that this
+          # instance is consuming from.
+      "consumedReservationSubBlock": "A String", # Output only. [Output Only] The full resource name of the reservation sub-block that
+          # this instance is consuming from.
+    },
+    "scheduling": {
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "gracefulShutdownTimestamp": "A String", # Output only. Specifies the timestamp, when the instance will start graceful shutdown
+          # process, in RFC3339 text format.
+      "terminationTimestamp": "A String", # Time in future when the instance will be terminated inRFC3339 text format.
+    },
+    "shutdownDetails": { # Specifies if the instance is in `PENDING_STOP` state or there is a # Output only. [Output Only] Details about the instance stopping state.
+        # programmed stop scheduled.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The duration for graceful shutdown. Only applicable when
+          # `stop_state=PENDING_STOP`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "requestTimestamp": "A String", # Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.
+      "stopState": "A String", # Current stopping state of the instance.
+      "targetState": "A String", # Target instance state.
+    },
+    "upcomingMaintenance": { # Upcoming Maintenance notification information.
+      "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+      "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+          # This timestamp value is in RFC3339 text format.
+      "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+      "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+        "A String",
+      ],
+      "maintenanceStatus": "A String",
+      "type": "A String", # Defines the type of maintenance.
+      "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+          # This timestamp value is in RFC3339 text format.
+      "windowStartTime": "A String", # The current start time of the maintenance window.
+          # This timestamp value is in RFC3339 text format.
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. [Output Only] Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "scheduling": { # Sets the scheduling options for an Instance. # Sets the scheduling options for this instance.
+    "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+        # terminated by Compute Engine (not terminated by a user). You can only set
+        # the automatic restart option for standard instances.Preemptible instances
+        # cannot be automatically restarted.
+        #
+        # By default, this is set to true so an instance is
+        # automatically restarted if it is terminated by Compute Engine.
+    "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+        # must be a number between 1 and the number of availability domains
+        # specified in the spread placement policy attached to the instance.
+    "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+        # ResourceStatus resource of the VM.
+    "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+      "enabled": True or False, # Opts-in for graceful shutdown.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+          # graceful shutdown isn't complete after this time, then the instance
+          # transitions to the STOPPING state.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+        # within the range of [90, 330] with the increment of 30, if unset, the
+        # default behavior of host error recovery will be used.
+    "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+    "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+        # recovery of the Local Ssd state is attempted. Its value should be in
+        # between 0 and 168 hours with hour granularity and the default value being 1
+        # hour.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "locationHint": "A String", # An opaque location hint used to place the instance close to other
+        # resources.
+        # This field is for use by internal tools that use the public API.
+    "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+        # the instance termination action will be performed at the end of the run
+        # duration.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+        # on a sole-tenant node.
+    "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+        # affinity for more information.
+        # Overrides reservationAffinity.
+      { # Node Affinity: the configuration of desired nodes onto which this Instance
+          #  could be scheduled.
+        "key": "A String", # Corresponds to the label key of Node resource.
+        "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+        "values": [ # Corresponds to the label values of Node resource.
+          "A String",
+        ],
+      },
+    ],
+    "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+        # the default behavior is MIGRATE. Forpreemptible instances,
+        # the default and only possible behavior is TERMINATE. For more
+        # information, see
+        #  Set
+        #  VM host maintenance policy.
+    "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+      "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+          # else, the Local SSD data will be preserved when the instance is stopped
+          # at the end of the run duration/termination time.
+    },
+    "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+        # instance creation or while the instance isstopped and
+        # therefore, in a `TERMINATED` state. SeeInstance Life
+        # Cycle for more information on the possible instance states.
+    "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+        # Soft Off signal is triggered for Spot VMs only. If not specified,
+        # there will be no wait before the G2 Soft Off signal is triggered.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+    "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+        # Off and ACPI G3 Mechanical
+        # Off for Standard VMs and 30 seconds for Spot VMs.
+    "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+        # termination action will be performed at the termination time.
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "serviceAccounts": [ # A list of service accounts, with their specified scopes, authorized for
+      # this instance. Only one service account per VM instance is supported.
+      #
+      # Service accounts generate access tokens that can be accessed
+      # through the metadata server and used to authenticate applications on the
+      # instance. SeeService Accounts
+      # for more information.
+    { # A service account.
+      "email": "A String", # Email address of the service account.
+      "scopes": [ # The list of scopes to be made available for this service account.
+        "A String",
+      ],
+    },
+  ],
+  "shieldedInstanceConfig": { # A set of Shielded Instance options.
+    "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+        # default.
+    "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+        # default.
+    "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+        # default.
+  },
+  "shieldedInstanceIntegrityPolicy": { # The policy describes the baseline against which
+      # Instance boot integrity is measured.
+    "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+        # measurements from the VM instance's most recent boot.
+  },
+  "sourceMachineImage": "A String", # Source machine image
+  "sourceMachineImageEncryptionKey": { # Source machine image encryption key when creating an instance from a
+      # machine image.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "startRestricted": True or False, # Output only. [Output Only] Whether a VM has been restricted for start because Compute
+      # Engine has detected suspicious activity.
+  "status": "A String", # Output only. [Output Only] The status of the instance. One of the
+      # following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the
+      # instance, see
+      # Instance life cycle.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "tags": { # A set of instance tags. # Tags to apply to this instance. Tags are used to identify valid
+      # sources or targets for network firewalls and are specified by the client
+      # during instance creation. The tags can be later modified by the setTags
+      # method. Each tag within the list must comply withRFC1035.
+      # Multiple tags can be specified via the 'tags.items' field.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the tags' contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update tags. You must always provide an
+        # up-to-date fingerprint hash in order to update or change tags.
+        #
+        # To see the latest fingerprint, make get() request to the
+        # instance.
+    "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+        # with RFC1035.
+      "A String",
+    ],
+  },
+  "workloadIdentityConfig": {
+    "identity": "A String",
+    "identityCertificateEnabled": True or False,
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instance resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getEffectiveFirewalls(project, zone, instance, networkInterface, x__xgafv=None) + 
Returns effective firewalls applied to an interface of the instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  networkInterface: string, The name of the network interface to get the effective firewalls. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "firewallPolicys": [ # [Output Only] Effective firewalls from firewall policies.
+    {
+      "displayName": "A String", # Output only. [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy.
+      "name": "A String", # Output only. [Output Only] The name of the firewall policy.
+      "packetMirroringRules": [ # Output only. [Output Only] The packet mirroring rules that apply to the instance.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "priority": 42, # Output only. [Output only] Priority of firewall policy association. Not applicable for
+          # type=HIERARCHY.
+      "rules": [ # [Output Only] The rules that apply to the instance. Only rules that
+          # target the specific VM instance are returned if target service accounts
+          # or target secure tags are specified in the rules.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy.
+      "type": "A String", # Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,
+          # NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.
+    },
+  ],
+  "firewalls": [ # Effective firewalls on the instance.
+    { # Represents a Firewall Rule resource.
+        #
+        # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+        # instances. For more information, readFirewall rules.
+      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a permitted connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a denied connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+          # traffic that has destination IP address in these ranges. These ranges must
+          # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+          # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+          # specify the sourceTags fields.
+      "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+          # firewall rule is not enforced and the network behaves as if it did not
+          # exist. If this is unspecified, the firewall rule will be enabled.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+          # for firewall rules.
+      "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+          # logging is enabled, logs will be exported to Cloud Logging.
+        "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+            # rule.
+        "metadata": "A String", # This field can only be specified for a particular firewall rule if
+            # logging is enabled for that rule. This field denotes whether to include
+            # or exclude metadata for firewall logs.
+      },
+      "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # URL of the network resource for this firewall rule. If not
+          # specified when creating a firewall rule, the default network
+          # is used:
+          #
+          # global/networks/default
+          #
+          # If you choose to specify this field, you can specify the network as a full
+          # or partial URL. For example, the following are all valid URLs:
+          #
+          #    -
+          #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+          #    - projects/myproject/global/networks/my-network
+          #    - global/networks/default
+      "params": { # Additional firewall 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "priority": 42, # Priority for this rule.
+          # This is an integer between `0` and `65535`, both inclusive.
+          # The default value is `1000`.
+          # Relative priorities determine which rule takes effect if multiple rules
+          # apply. Lower values indicate higher priority. For example, a rule with
+          # priority `0` has higher precedence than a rule with priority `1`.
+          # DENY rules take precedence over ALLOW rules if they have equal priority.
+          # Note that VPC networks have implied
+          # rules with a priority of `65535`. To avoid conflicts with the implied
+          # rules, use a priority number less than `65535`.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+          # that has a source IP address in these ranges. These ranges must be
+          # expressed inCIDR format. One or both of sourceRanges
+          # and sourceTags may be set.
+          # If both fields are set, the rule applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP
+          # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+          # both fields for the rule to
+          # apply. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+          # traffic originating from an instance with a service account in this list.
+          # Source service accounts cannot be used to control traffic to an instance's
+          # external IP address because service accounts are associated with an
+          # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+          # If both are set, the firewall applies to traffic that
+          # has a source IP address within the sourceRanges OR a source
+          # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+          # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+        "A String",
+      ],
+      "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+          # with source IPs that match the primary network interfaces of VM instances
+          # that have the tag and are in the same VPC network.
+          # Source tags cannot be used to control traffic to an instance's external IP
+          # address, it only applies to traffic between instances in the same virtual
+          # network. Because tags are associated with instances, not IP addresses.
+          # One or both of sourceRanges and sourceTags may be
+          # set. If both fields are set, the firewall applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP from a
+          # resource with a matching tag listed in the sourceTags
+          # field. The connection does not need to match both fields for the
+          # firewall to apply.
+        "A String",
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+          # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+          # If neither targetServiceAccounts nor targetTags
+          # are specified, the firewall rule applies to all instances on the specified
+          # network.
+        "A String",
+      ],
+      "targetTags": [ # A list of tags that controls which instances the firewall rule
+          # applies to. If targetTags are specified, then the firewall
+          # rule applies only to instances in the VPC network that have one of those
+          # tags. If no targetTags are specified, the firewall rule
+          # applies to all instances on the specified network.
+        "A String",
+      ],
+    },
+  ],
+}
+
+ +
+ getGuestAttributes(project, zone, instance, queryPath=None, variableKey=None, x__xgafv=None) + 
Returns the specified guest attributes entry.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  queryPath: string, Specifies the guest attributes path to be queried.
+  variableKey: string, Specifies the key for the guest attributes entry.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A guest attributes entry.
+  "kind": "compute#guestAttributes", # Output only. [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry.
+  "queryPath": "A String", # The path to be queried. This can be the default namespace ('') or a
+      # nested namespace ('\/') or a specified key
+      # ('\/\').
+  "queryValue": { # Array of guest attribute namespace/key/value tuples. # Output only. [Output Only] The value of the requested queried path.
+    "items": [
+      { # A guest attributes namespace/key/value entry.
+        "key": "A String", # Key for the guest attribute entry.
+        "namespace": "A String", # Namespace for the guest attribute entry.
+        "value": "A String", # Value for the guest attribute entry.
+      },
+    ],
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "variableKey": "A String", # The key to search for.
+  "variableValue": "A String", # Output only. [Output Only] The value found for the requested key.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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).
+}
+
+ +
+ getScreenshot(project, zone, instance, x__xgafv=None) + 
Returns the screenshot from the specified instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An instance's screenshot.
+  "contents": "A String", # [Output Only] The Base64-encoded screenshot data.
+  "kind": "compute#screenshot", # Output only. [Output Only] Type of the resource. Always compute#screenshot
+      # for the screenshots.
+}
+
+ +
+ getSerialPortOutput(project, zone, instance, port=None, start=None, x__xgafv=None) + 
Returns the last 1 MB of serial port output from the specified instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance for this request. (required)
+  port: integer, Specifies which COM or serial port to retrieve data from.
+  start: string, Specifies the starting byte position of the output to return. To start with
+the first byte of output to the specified port, omit this field or set it
+to `0`.
+
+If the output for that byte position is available, this field matches the
+`start` parameter sent with the request. If the amount of serial console
+output exceeds the size of the buffer (1 MB), the oldest output is
+discarded and is no longer available. If the requested start position
+refers to discarded output, the start position is adjusted to the oldest
+output still available, and the adjusted start position is returned as the
+`start` property value.
+
+You can also provide a negative start position, which translates to the
+most recent number of bytes written to the serial port. For example, -3 is
+interpreted as the most recent 3 bytes written to the serial console. Note
+that the negative start is bounded by the retained buffer size, and the
+returned serial console output will not exceed the max buffer size.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An instance serial console output.
+  "contents": "A String", # [Output Only] The contents of the console output.
+  "kind": "compute#serialPortOutput", # Output only. [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output.
+  "next": "A String", # [Output Only] The position of the next byte of content, regardless of
+      # whether the content exists, following the output returned in the `contents`
+      # property. Use this value in the next request as the start
+      # parameter.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "start": "A String", # The starting byte position of the output that was returned.
+      # This should match the start parameter sent with the request.
+      # If the serial console output exceeds the size of the buffer (1 MB), older
+      # output is overwritten by newer content. The output start value will
+      # indicate the byte position of the output that was returned, which might be
+      # different than the `start` value that was specified in the request.
+}
+
+ +
+ getShieldedInstanceIdentity(project, zone, instance, x__xgafv=None) + 
Returns the Shielded Instance Identity of an instance
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name or id of the instance scoping this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A Shielded Instance Identity.
+  "eccP256EncryptionKey": { # A Shielded Instance Identity Entry. # An Endorsement Key (EK) made by the ECC P256 algorithm
+      # issued to the Shielded Instance's vTPM.
+    "ekCert": "A String", # A PEM-encoded X.509 certificate. This field can be empty.
+    "ekPub": "A String", # A PEM-encoded public key.
+  },
+  "eccP256SigningKey": { # A Shielded Instance Identity Entry. # An Attestation Key (AK) made by the ECC P256 algorithm
+      # issued to the Shielded Instance's vTPM.
+    "ekCert": "A String", # A PEM-encoded X.509 certificate. This field can be empty.
+    "ekPub": "A String", # A PEM-encoded public key.
+  },
+  "encryptionKey": { # A Shielded Instance Identity Entry. # An Endorsement Key (EK) made by the RSA 2048 algorithm
+      # issued to the Shielded Instance's vTPM.
+    "ekCert": "A String", # A PEM-encoded X.509 certificate. This field can be empty.
+    "ekPub": "A String", # A PEM-encoded public key.
+  },
+  "kind": "compute#shieldedInstanceIdentity", # Output only. [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance
+      # identity entry.
+  "signingKey": { # A Shielded Instance Identity Entry. # An Attestation Key (AK) made by the RSA 2048 algorithm
+      # issued to the Shielded Instance's vTPM.
+    "ekCert": "A String", # A PEM-encoded X.509 certificate. This field can be empty.
+    "ekPub": "A String", # A PEM-encoded public key.
+  },
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, sourceInstanceTemplate=None, sourceMachineImage=None, x__xgafv=None) + 
Creates an instance resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Instance resource.
+    # 
+    # An instance is a virtual machine that is hosted on Google Cloud Platform.
+    # For more information, readVirtual Machine Instances.
+  "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+      # Options that would traditionally be configured in a BIOS belong
+      # here. Features that require operating system support may have
+      # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+      # disabled).
+    "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+    "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+    "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+    "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+        # multithreading (SMT) set this to 1. If unset, the maximum number
+        # of threads supported per core by the underlying processor is
+        # assumed.
+    "turboMode": "A String", # Turbo frequency mode to use for the instance.
+        # Supported modes include:
+        # * ALL_CORE_MAX
+        #
+        # Using empty string or not setting this field will use the platform-specific
+        # default turbo mode.
+    "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+        # the number of threads per core to compute the total number of virtual
+        # CPUs to expose to the instance. If unset, the number of cores is
+        # inferred from the instance's nominal CPU count and the underlying
+        # platform's SMT width.
+  },
+  "canIpForward": True or False, # Allows this instance to send and receive packets with non-matching
+      # destination or source IPs. This is required if you plan to use this
+      # instance to forward routes. For more information, seeEnabling IP Forwarding.
+  "confidentialInstanceConfig": { # A set of Confidential Instance options.
+    "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+    "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+  },
+  "cpuPlatform": "A String", # Output only. [Output Only] The CPU platform used by this instance.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+  "deletionProtection": True or False, # Whether the resource should be protected against deletion.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "disks": [ # Array of disks associated with this instance. Persistent disks must be
+      # created before you can assign them.
+    { # An instance-attached disk resource.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+          # or X86_64.
+      "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+          # deleted (but not when the disk is detached from the instance).
+      "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+          # partition of the disk for its root filesystem.
+      "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+          # running within the instance. This name can be used to reference the device
+          # for mounting, resizing, and so on, from within the instance.
+          #
+          # If not specified, the server chooses a default device name to apply to this
+          # disk, in the form persistent-disk-x, where x is a number
+          # assigned by Google Compute Engine. This field is only applicable for
+          # persistent disks.
+      "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+          # encryption key.
+          #
+          # If you are creating a new disk, this field encrypts the new disk using
+          # an encryption key that you provide. If you are attaching an existing
+          # disk that is already encrypted, this field decrypts the disk using
+          # the customer-supplied encryption key.
+          #
+          # If you encrypt a disk using a customer-supplied key, you must provide the
+          # same key again when you attempt to use this resource at a later time. For
+          # example, you must provide the key when you create a snapshot or an image
+          # from the disk or when you attach the disk to a virtual machine instance.
+          #
+          # If you do not provide an encryption key, then the disk will be encrypted
+          # using an automatically generated key and you do not need to provide a key
+          # to use the disk later.
+          #
+          # Note:
+          #
+          # Instance templates do not storecustomer-supplied
+          # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+          #
+          # You cannot create VMs that have disks with customer-supplied keys using
+          # the bulk
+          # insert method.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "diskSizeGb": "A String", # The size of the disk in GB.
+      "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+          # currently attached to another instance. If you try to force attach a zonal
+          # disk to an instance, you will receive an error.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+          # boot disk. If you have many disks attached to an instance, each
+          # disk would have a unique index number.
+      "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This field is persisted and returned for instanceTemplate and not returned
+          # in the context of instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+        "architecture": "A String", # The architecture of the attached disk. Valid values are
+            # arm64 or x86_64.
+        "description": "A String", # An optional description. Provide this property when creating the disk.
+        "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+            # of the instance. If a disk with the same name already exists in the given
+            # region, the existing disk is attached to the new instance and the
+            # new disk is not created.
+        "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+            # 10 GB. If you specify a sourceImage, which is required for
+            # boot disks, the default size is the size of the sourceImage.
+            # If you do not specify a sourceImage, the default disk size
+            # is 500 GB.
+        "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+            # disk. For valid disk type values, see
+            # Supported types for Hyperdisk volumes and
+            # Persistent Disk type variables.
+            #
+            # When creating a single instance, you must provide either the full or
+            # partial URL of the disk type. For example, the following values are
+            # valid:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+            #      - projects/project/zones/zone/diskTypes/diskType
+            #      - zones/zone/diskTypes/diskType
+            #
+            #
+            #
+            # When creating an instance template, instance flexibility policy, or when
+            # creating or updating an all-instances configuration, you specify the
+            # disk type without a URL, for example, hyperdisk-balanced.
+            #
+            # If you omit this field for a disk, the default disk type depends on
+            # the instance's machine series, as follows.
+            #
+            #
+            #     - For first- and second-generation machine series like N1, N2, T2, and
+            #     M1, the
+            #        default disk type is Standard Persistent Disk
+            #        (pd-standard).
+            #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+            #     (pd-balanced).
+            #    - For other third-generation machine
+            #     series like A3, H3, Z3, all
+            #         fourth-generation types like C4, N4, M4, and newer machine series,
+            #         the default is Hyperdisk Balanced
+            #         (hyperdisk-balanced).
+            #
+            #
+            #
+            # The disk type you specify must be compatible with the instance's machine
+            # series. For a list of machine series that support Persistent Disk, see Machine
+            # series support for Persistent Disk.
+            #
+            # For a list of machine series that support Hyperdisk, seeMachine
+            # series support for Hyperdisk.
+        "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+        "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+            # persistent disks.
+          "a_key": "A String",
+        },
+        "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+          "A String",
+        ],
+        "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+            # is to use the existing disk.
+        "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+            # of I/O operations per second that the disk can handle. Values must be
+            # between 10,000 and 120,000. For more details, see theExtreme persistent
+            # disk documentation.
+        "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+            # number of throughput mb per second that the disk can handle. Values must
+            # greater than or equal to 1.
+        "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+            # the URLs of the zones where the disk should be replicated to.
+            # You must provide exactly two replica zones, and one zone must be the same
+            # as the instance zone.
+          "A String",
+        ],
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+            # Specified using the full or partial URL. For instance template, specify
+            # only the resource policy name.
+          "A String",
+        ],
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+            # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # To create a disk with one of the public operating system
+            # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+            #
+            # projects/debian-cloud/global/images/family/debian-9
+            #
+            #
+            # Alternatively, use a specific version of a public operating system image:
+            #
+            # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+            #
+            #
+            # To create a disk with a custom image that you created, specify the
+            # image name in the following format:
+            #
+            # global/images/my-custom-image
+            #
+            #
+            # You can also specify a custom image by its image family, which returns
+            # the latest version of the image in that family. Replace the image name
+            # with family/family-name:
+            #
+            # global/images/family/my-image-family
+            #
+            #
+            # If the source image is deleted later, this field will not be set.
+        "sourceImageEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source image. Required if the source image is
+            # protected by a customer-supplied encryption key.
+            #
+            # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+            # encryption keys, so you cannot create disks for instances in a managed instance group if the
+            # source images are encrypted with your own keys.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+            # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+            # is required.
+            #
+            # To create a disk with a snapshot that you created, specify the
+            # snapshot name in the following format:
+            #
+            # global/snapshots/my-backup
+            #
+            #
+            # If the source snapshot is deleted later, this field will not be set.
+            #
+            # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+            # an image instead when you create VMs using
+            # the bulk
+            # insert method.
+        "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source snapshot.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+            #      - projects/project/zones/zone/storagePools/storagePool
+            #    - zones/zone/storagePools/storagePool
+      },
+      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+          # either SCSI or NVME. For most machine types, the
+          # default is SCSI. Local SSDs can use either NVME or SCSI.
+          # In certain configurations, persistent disks can use NVMe. For more
+          # information, seeAbout
+          # persistent disks.
+      "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+      "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+        "A String",
+      ],
+      "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+          # in READ_WRITE mode.
+      "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+          # field is set to PRESERVED if the LocalSSD data has been saved
+          # to a persistent location by customer request.  (see the
+          # discard_local_ssd option on Stop/Suspend).
+          # Read-only in the api.
+      "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+          # these are public keys which are safe to store in public
+        "dbs": [ # The Key Database (db).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "dbxs": [ # The forbidden key database (dbx).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "keks": [ # The Key Exchange Key (KEK).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "pk": { # The Platform Key (PK).
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      },
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+          # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+          # is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using
+          # this property. This field is only applicable for persistent disks.
+          #
+          # 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.
+    },
+  ],
+  "displayDevice": { # A set of Display Device options # Enables display device for the instance.
+    "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+  },
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the instance's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update the instance. You must always provide an
+      # up-to-date fingerprint hash in order to update the instance.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+  "hostname": "A String", # Specifies the hostname of the instance. The specified hostname must be
+      # RFC1035 compliant. If hostname is not specified, the default hostname is
+      # [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and
+      # [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceEncryptionKey": { # Encrypts suspended data for an instance with acustomer-managed
+      # encryption key.
+      # 
+      # If you are creating a new instance, this field will encrypt the local SSD
+      # and in-memory contents of the instance during the suspend operation.
+      # 
+      # If you do not provide an encryption key when creating the instance, then
+      # the local SSD and in-memory contents will be encrypted using
+      # an automatically generated key during the suspend operation.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+      # "NONE". The default value is "NONE" if it is not specified.
+  "kind": "compute#instance", # Output only. [Output Only] Type of the resource. Always compute#instance
+      # for instances.
+  "labelFingerprint": "A String", # A fingerprint for this request, which is essentially a hash of
+      # the label's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "labels": { # Labels to apply to this instance. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastStartTimestamp": "A String", # Output only. [Output Only] Last start timestamp inRFC3339 text format.
+  "lastStopTimestamp": "A String", # Output only. [Output Only] Last stop timestamp inRFC3339 text format.
+  "lastSuspendedTimestamp": "A String", # Output only. [Output Only] Last suspended timestamp inRFC3339 text format.
+  "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+      # Local SSDs attached to the VM.
+  "machineType": "A String", # Full or partial URL of the machine type resource to use for this instance,
+      # in the format:zones/zone/machineTypes/machine-type. This is provided by the client
+      # when the instance is created. For example, the following is a valid partial
+      # url to a predefined
+      # machine type:
+      # 
+      # zones/us-central1-f/machineTypes/n1-standard-1
+      # 
+      # 
+      # To create acustom
+      # machine type, provide a URL to a machine type in the following format,
+      # where CPUS is 1 or an even number up to 32 (2,
+      # 4, 6, ... 24, etc), and MEMORY is the total
+      # memory for this instance. Memory must be a multiple of 256 MB and must
+      # be supplied in MB (e.g. 5 GB of memory is 5120 MB):
+      # 
+      # zones/zone/machineTypes/custom-CPUS-MEMORY
+      # 
+      # 
+      # For example: zones/us-central1-f/machineTypes/custom-4-5120
+      # 
+      # For a full list of restrictions, read theSpecifications
+      # for custom machine types.
+  "metadata": { # A metadata key/value entry. # The metadata key/value pairs assigned
+      # to this instance. This includes metadata keys that were explicitly defined
+      # for the instance.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the metadata's contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update metadata. You must always provide an
+        # up-to-date fingerprint hash in order to update or change metadata,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve the resource.
+    "items": [ # Array of key/value pairs. The total size of all keys and values must be
+        # less than 512 KB.
+      { # Metadata
+        "key": "A String", # Key for the metadata entry. Keys must conform to the following
+            # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+            # This is reflected as part of a URL in the metadata server. Additionally, to
+            # avoid ambiguity, keys must not conflict with any other metadata keys
+            # for the project.
+        "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+            # have meaning as interpreted by the image running in the instance. The
+            # only restriction placed on values is that their size must be less than
+            # or equal to 262144 bytes (256 KiB).
+      },
+    ],
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "minCpuPlatform": "A String", # Specifies aminimum CPU
+      # platform for the VM instance. Applicable values are the friendly names
+      # of CPU platforms, such as minCpuPlatform: "Intel
+      # Haswell" or minCpuPlatform: "Intel Sandy
+      # Bridge".
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "networkInterfaces": [ # An array of network configurations for this instance. These specify how
+      # interfaces are configured to interact with other network services, such as
+      # connecting to the internet. Multiple interfaces are supported
+      # per instance.
+    { # A network interface resource attached to an instance.
+      "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+          # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+          # no external internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+          # with network_attachment.
+      "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+          # This field will be ignored when inserting an Instance or
+          # adding a NetworkInterface. An up-to-date
+          # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+      "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+          # or not. If enabled, also indicates the version of IGMP supported.
+      "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+      "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+          # one IPv6 access config, DIRECT_IPV6, is supported. If there
+          # is no ipv6AccessConfig specified, then this instance will
+          # have no external IPv6 Internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+          # accessed from the Internet. This field is always inherited from its
+          # subnetwork.
+          #
+          # Valid only if stackType is IPV4_IPV6.
+      "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+          # use a static internal IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an internal IPv6 address from the instance's subnetwork.
+      "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+      "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+          # server. For a VM, the network interface uses the nicN naming
+          # format. Where N is a value between 0 and7. The default interface value is nic0.
+      "network": "A String", # URL of the VPC network resource for this instance. When creating an
+          # instance, if neither the network nor the subnetwork is specified, the
+          # default network global/networks/default is used. If the
+          # selected project doesn't have the default network, you must specify a
+          # network or subnet. If the network is not specified but the subnetwork is
+          # specified, the network is inferred.
+          #
+          # If you specify this property, you can specify the network as
+          # a full or partial URL. For example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+          #       - projects/project/global/networks/network
+          #       - global/networks/default
+      "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+          # to in the following format:
+          # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+      "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+          # interface. If not specified by the user, an unused internal IP is
+          # assigned by the system.
+      "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+          # VirtioNet.
+      "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+      "queueCount": 42, # The networking queue count that's specified by users for the network
+          # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+          # if not specified by the users.
+      "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+          # interface. Can only be used with network_attachment. It is not possible to
+          # use on its own however, network_attachment can be used without
+          # service_class_id.
+      "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+          # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+          #
+          # This field can be both set at instance creation and update network
+          # interface operations.
+      "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+          # resource is inlegacy
+          # mode, do not specify this field. If the network is in auto subnet
+          # mode, specifying the subnetwork is optional. If the network is in custom
+          # subnet mode, specifying the subnetwork is required. If you specify this
+          # field, you can specify the subnetwork as a full or partial URL. For
+          # example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+          #    - regions/region/subnetworks/subnetwork
+      "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+          # from 2 to 255 inclusively.
+    },
+  ],
+  "networkPerformanceConfig": {
+    "totalEgressBandwidthTier": "A String",
+  },
+  "params": { # Additional instance params. # Input only. [Input Only] Additional params passed with the request, but not persisted
+      # as part of resource payload.
+    "requestValidForDuration": { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity. Relevant only for
+        # Instances.Insert API.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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": { # 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/{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",
+    },
+  },
+  "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for the VM.
+      # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+  "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that this instance can consume from.
+    "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+        # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+        # Consuming reserved instances for examples.
+    "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+        # the name of your reservation as its value.
+    "values": [ # Corresponds to the label values of a reservation resource. This can be
+        # either a name to a reservation in the same project or
+        # "projects/different-project/reservations/some-reservation-name" to target a
+        # shared reservation in the same zone but in a different project.
+      "A String",
+    ],
+  },
+  "resourcePolicies": [ # Resource policies applied to this instance.
+    "A String",
+  ],
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] Specifies values set for instance attributes as
+      # compared to the values requested by user in the corresponding input only
+      # field.
+      # Use this sub-message for actual values set on Instance attributes as compared
+      # to the value requested by the user (intent) in their instance CRUD calls.
+    "effectiveInstanceMetadata": { # Effective values of predefined metadata keys for an instance. # Output only. [Output Only] Effective metadata is a field that consolidates project,
+        # zonal instance settings, and instance-level predefined metadata keys to
+        # provide the overridden value for those metadata keys at the instance level.
+      "blockProjectSshKeysMetadataValue": True or False, # Effective block-project-ssh-keys value at Instance level.
+      "enableGuestAttributesMetadataValue": True or False, # Effective enable-guest-attributes value at Instance level.
+      "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.
+    },
+    "physicalHost": "A String", # Output only. [Output Only] The precise location of your instance within the zone's data
+        # center, including the block, sub-block, and host. The field is formatted as
+        # follows: blockId/subBlockId/hostId.
+    "physicalHostTopology": { # Represents the physical host topology of the host on which the VM is # Output only. [Output Only] A series of fields containing the global name of the Compute
+        # Engine cluster, as well as the ID of the block, sub-block, and host on
+        # which the running instance is located.
+        # running.
+      "additionalAttributes": { # Additional location information of the running instance. # Output only. [Output Only] Additional location information of the running instance.
+        "acceleratorTopologyIds": { # Output only. The IDs of the accelerator topologies the instance belongs to. For
+            # example
+            # The key will be topologies like "4x4", "2x2x2" and the value will be
+            # the location ID of the topologies.
+          "a_key": "A String",
+        },
+      },
+      "block": "A String", # [Output Only] The ID of the block in which the running instance is
+          # located. Instances within the same block experience low network latency.
+      "cluster": "A String", # [Output Only] The global name of the Compute Engine cluster where the
+          # running instance is located.
+      "host": "A String", # [Output Only] The ID of the host on which the running instance is located.
+          # Instances on the same host experience the lowest possible network
+          # latency.
+      "subblock": "A String", # [Output Only] The ID of the sub-block in which the running instance is
+          # located. Instances in the same sub-block experience lower network latency
+          # than instances in the same block.
+    },
+    "reservationConsumptionInfo": { # Reservation consumption information that the instance is consuming from. # Output only. [Output Only] Reservation information that the instance is consuming from.
+      "consumedReservation": "A String", # Output only. [Output Only] The full resource name of the reservation that this
+          # instance is consuming from.
+      "consumedReservationBlock": "A String", # Output only. [Output Only] The full resource name of the reservation block that this
+          # instance is consuming from.
+      "consumedReservationSubBlock": "A String", # Output only. [Output Only] The full resource name of the reservation sub-block that
+          # this instance is consuming from.
+    },
+    "scheduling": {
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "gracefulShutdownTimestamp": "A String", # Output only. Specifies the timestamp, when the instance will start graceful shutdown
+          # process, in RFC3339 text format.
+      "terminationTimestamp": "A String", # Time in future when the instance will be terminated inRFC3339 text format.
+    },
+    "shutdownDetails": { # Specifies if the instance is in `PENDING_STOP` state or there is a # Output only. [Output Only] Details about the instance stopping state.
+        # programmed stop scheduled.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The duration for graceful shutdown. Only applicable when
+          # `stop_state=PENDING_STOP`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "requestTimestamp": "A String", # Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.
+      "stopState": "A String", # Current stopping state of the instance.
+      "targetState": "A String", # Target instance state.
+    },
+    "upcomingMaintenance": { # Upcoming Maintenance notification information.
+      "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+      "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+          # This timestamp value is in RFC3339 text format.
+      "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+      "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+        "A String",
+      ],
+      "maintenanceStatus": "A String",
+      "type": "A String", # Defines the type of maintenance.
+      "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+          # This timestamp value is in RFC3339 text format.
+      "windowStartTime": "A String", # The current start time of the maintenance window.
+          # This timestamp value is in RFC3339 text format.
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. [Output Only] Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "scheduling": { # Sets the scheduling options for an Instance. # Sets the scheduling options for this instance.
+    "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+        # terminated by Compute Engine (not terminated by a user). You can only set
+        # the automatic restart option for standard instances.Preemptible instances
+        # cannot be automatically restarted.
+        #
+        # By default, this is set to true so an instance is
+        # automatically restarted if it is terminated by Compute Engine.
+    "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+        # must be a number between 1 and the number of availability domains
+        # specified in the spread placement policy attached to the instance.
+    "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+        # ResourceStatus resource of the VM.
+    "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+      "enabled": True or False, # Opts-in for graceful shutdown.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+          # graceful shutdown isn't complete after this time, then the instance
+          # transitions to the STOPPING state.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+        # within the range of [90, 330] with the increment of 30, if unset, the
+        # default behavior of host error recovery will be used.
+    "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+    "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+        # recovery of the Local Ssd state is attempted. Its value should be in
+        # between 0 and 168 hours with hour granularity and the default value being 1
+        # hour.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "locationHint": "A String", # An opaque location hint used to place the instance close to other
+        # resources.
+        # This field is for use by internal tools that use the public API.
+    "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+        # the instance termination action will be performed at the end of the run
+        # duration.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+        # on a sole-tenant node.
+    "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+        # affinity for more information.
+        # Overrides reservationAffinity.
+      { # Node Affinity: the configuration of desired nodes onto which this Instance
+          #  could be scheduled.
+        "key": "A String", # Corresponds to the label key of Node resource.
+        "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+        "values": [ # Corresponds to the label values of Node resource.
+          "A String",
+        ],
+      },
+    ],
+    "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+        # the default behavior is MIGRATE. Forpreemptible instances,
+        # the default and only possible behavior is TERMINATE. For more
+        # information, see
+        #  Set
+        #  VM host maintenance policy.
+    "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+      "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+          # else, the Local SSD data will be preserved when the instance is stopped
+          # at the end of the run duration/termination time.
+    },
+    "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+        # instance creation or while the instance isstopped and
+        # therefore, in a `TERMINATED` state. SeeInstance Life
+        # Cycle for more information on the possible instance states.
+    "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+        # Soft Off signal is triggered for Spot VMs only. If not specified,
+        # there will be no wait before the G2 Soft Off signal is triggered.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+    "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+        # Off and ACPI G3 Mechanical
+        # Off for Standard VMs and 30 seconds for Spot VMs.
+    "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+        # termination action will be performed at the termination time.
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "serviceAccounts": [ # A list of service accounts, with their specified scopes, authorized for
+      # this instance. Only one service account per VM instance is supported.
+      # 
+      # Service accounts generate access tokens that can be accessed
+      # through the metadata server and used to authenticate applications on the
+      # instance. SeeService Accounts
+      # for more information.
+    { # A service account.
+      "email": "A String", # Email address of the service account.
+      "scopes": [ # The list of scopes to be made available for this service account.
+        "A String",
+      ],
+    },
+  ],
+  "shieldedInstanceConfig": { # A set of Shielded Instance options.
+    "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+        # default.
+    "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+        # default.
+    "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+        # default.
+  },
+  "shieldedInstanceIntegrityPolicy": { # The policy describes the baseline against which
+      # Instance boot integrity is measured.
+    "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+        # measurements from the VM instance's most recent boot.
+  },
+  "sourceMachineImage": "A String", # Source machine image
+  "sourceMachineImageEncryptionKey": { # Source machine image encryption key when creating an instance from a
+      # machine image.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "startRestricted": True or False, # Output only. [Output Only] Whether a VM has been restricted for start because Compute
+      # Engine has detected suspicious activity.
+  "status": "A String", # Output only. [Output Only] The status of the instance. One of the
+      # following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the
+      # instance, see
+      # Instance life cycle.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "tags": { # A set of instance tags. # Tags to apply to this instance. Tags are used to identify valid
+      # sources or targets for network firewalls and are specified by the client
+      # during instance creation. The tags can be later modified by the setTags
+      # method. Each tag within the list must comply withRFC1035.
+      # Multiple tags can be specified via the 'tags.items' field.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the tags' contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update tags. You must always provide an
+        # up-to-date fingerprint hash in order to update or change tags.
+        #
+        # To see the latest fingerprint, make get() request to the
+        # instance.
+    "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+        # with RFC1035.
+      "A String",
+    ],
+  },
+  "workloadIdentityConfig": {
+    "identity": "A String",
+    "identityCertificateEnabled": True or False,
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instance resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  sourceInstanceTemplate: string, Specifies instance template to create the instance.
+
+This field is optional. It can be a full or partial URL. For example, the
+following are all valid URLs to an instance template:
+   
+   
+      - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+      - projects/project/global/instanceTemplates/instanceTemplate
+      - global/instanceTemplates/instanceTemplate
+  sourceMachineImage: string, Specifies the machine image to use to create the instance.
+
+This field is optional. It can be a full or partial URL. For example, the
+following are all valid URLs to a machine image:
+   
+   
+      - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage
+      - projects/project/global/global/machineImages/machineImage
+      - global/machineImages/machineImage
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of instances contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 instances.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Instance resources.
+    { # Represents an Instance resource.
+        #
+        # An instance is a virtual machine that is hosted on Google Cloud Platform.
+        # For more information, readVirtual Machine Instances.
+      "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+          # Options that would traditionally be configured in a BIOS belong
+          # here. Features that require operating system support may have
+          # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+          # disabled).
+        "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+        "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+        "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+        "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+            # multithreading (SMT) set this to 1. If unset, the maximum number
+            # of threads supported per core by the underlying processor is
+            # assumed.
+        "turboMode": "A String", # Turbo frequency mode to use for the instance.
+            # Supported modes include:
+            # * ALL_CORE_MAX
+            #
+            # Using empty string or not setting this field will use the platform-specific
+            # default turbo mode.
+        "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+            # the number of threads per core to compute the total number of virtual
+            # CPUs to expose to the instance. If unset, the number of cores is
+            # inferred from the instance's nominal CPU count and the underlying
+            # platform's SMT width.
+      },
+      "canIpForward": True or False, # Allows this instance to send and receive packets with non-matching
+          # destination or source IPs. This is required if you plan to use this
+          # instance to forward routes. For more information, seeEnabling IP Forwarding.
+      "confidentialInstanceConfig": { # A set of Confidential Instance options.
+        "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+        "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+      },
+      "cpuPlatform": "A String", # Output only. [Output Only] The CPU platform used by this instance.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+      "deletionProtection": True or False, # Whether the resource should be protected against deletion.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "disks": [ # Array of disks associated with this instance. Persistent disks must be
+          # created before you can assign them.
+        { # An instance-attached disk resource.
+          "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+              # or X86_64.
+          "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+              # deleted (but not when the disk is detached from the instance).
+          "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+              # partition of the disk for its root filesystem.
+          "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+              # running within the instance. This name can be used to reference the device
+              # for mounting, resizing, and so on, from within the instance.
+              #
+              # If not specified, the server chooses a default device name to apply to this
+              # disk, in the form persistent-disk-x, where x is a number
+              # assigned by Google Compute Engine. This field is only applicable for
+              # persistent disks.
+          "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+              # encryption key.
+              #
+              # If you are creating a new disk, this field encrypts the new disk using
+              # an encryption key that you provide. If you are attaching an existing
+              # disk that is already encrypted, this field decrypts the disk using
+              # the customer-supplied encryption key.
+              #
+              # If you encrypt a disk using a customer-supplied key, you must provide the
+              # same key again when you attempt to use this resource at a later time. For
+              # example, you must provide the key when you create a snapshot or an image
+              # from the disk or when you attach the disk to a virtual machine instance.
+              #
+              # If you do not provide an encryption key, then the disk will be encrypted
+              # using an automatically generated key and you do not need to provide a key
+              # to use the disk later.
+              #
+              # Note:
+              #
+              # Instance templates do not storecustomer-supplied
+              # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+              #
+              # You cannot create VMs that have disks with customer-supplied keys using
+              # the bulk
+              # insert method.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "diskSizeGb": "A String", # The size of the disk in GB.
+          "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+              # currently attached to another instance. If you try to force attach a zonal
+              # disk to an instance, you will receive an error.
+          "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+              # only for bootable images. Read
+              # Enabling guest operating system features to see a list of available
+              # options.
+            { # Guest OS features.
+              "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                  # separate values. Set to one or more of the following values:
+                  #
+                  #    - VIRTIO_SCSI_MULTIQUEUE
+                  #    - WINDOWS
+                  #    - MULTI_IP_SUBNET
+                  #    - UEFI_COMPATIBLE
+                  #    - GVNIC
+                  #    - SEV_CAPABLE
+                  #    - SUSPEND_RESUME_COMPATIBLE
+                  #    - SEV_LIVE_MIGRATABLE_V2
+                  #    - SEV_SNP_CAPABLE
+                  #    - TDX_CAPABLE
+                  #    - IDPF
+                  #    - SNP_SVSM_CAPABLE
+                  #    - CCA_CAPABLE
+                  #    - SUSPEND_SAFE_FPR
+                  #
+                  #
+                  # For more information, see
+                  # Enabling guest operating system features.
+            },
+          ],
+          "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+              # boot disk. If you have many disks attached to an instance, each
+              # disk would have a unique index number.
+          "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+              # alongside the new instance. Use initialization parameters to create boot
+              # disks or local SSDs attached to the new instance.
+              #
+              # This property is mutually exclusive with the source property;
+              # you can only define one or the other, but not both.
+              # alongside the new instance. Use initialization parameters to create boot
+              # disks or local SSDs attached to the new instance.
+              #
+              # This field is persisted and returned for instanceTemplate and not returned
+              # in the context of instance.
+              #
+              # This property is mutually exclusive with the source property;
+              # you can only define one or the other, but not both.
+            "architecture": "A String", # The architecture of the attached disk. Valid values are
+                # arm64 or x86_64.
+            "description": "A String", # An optional description. Provide this property when creating the disk.
+            "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                # of the instance. If a disk with the same name already exists in the given
+                # region, the existing disk is attached to the new instance and the
+                # new disk is not created.
+            "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                # 10 GB. If you specify a sourceImage, which is required for
+                # boot disks, the default size is the size of the sourceImage.
+                # If you do not specify a sourceImage, the default disk size
+                # is 500 GB.
+            "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                # disk. For valid disk type values, see
+                # Supported types for Hyperdisk volumes and
+                # Persistent Disk type variables.
+                #
+                # When creating a single instance, you must provide either the full or
+                # partial URL of the disk type. For example, the following values are
+                # valid:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                #      - projects/project/zones/zone/diskTypes/diskType
+                #      - zones/zone/diskTypes/diskType
+                #
+                #
+                #
+                # When creating an instance template, instance flexibility policy, or when
+                # creating or updating an all-instances configuration, you specify the
+                # disk type without a URL, for example, hyperdisk-balanced.
+                #
+                # If you omit this field for a disk, the default disk type depends on
+                # the instance's machine series, as follows.
+                #
+                #
+                #     - For first- and second-generation machine series like N1, N2, T2, and
+                #     M1, the
+                #        default disk type is Standard Persistent Disk
+                #        (pd-standard).
+                #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                #     (pd-balanced).
+                #    - For other third-generation machine
+                #     series like A3, H3, Z3, all
+                #         fourth-generation types like C4, N4, M4, and newer machine series,
+                #         the default is Hyperdisk Balanced
+                #         (hyperdisk-balanced).
+                #
+                #
+                #
+                # The disk type you specify must be compatible with the instance's machine
+                # series. For a list of machine series that support Persistent Disk, see Machine
+                # series support for Persistent Disk.
+                #
+                # For a list of machine series that support Hyperdisk, seeMachine
+                # series support for Hyperdisk.
+            "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+            "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                # persistent disks.
+              "a_key": "A String",
+            },
+            "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+              "A String",
+            ],
+            "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                # is to use the existing disk.
+            "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                # of I/O operations per second that the disk can handle. Values must be
+                # between 10,000 and 120,000. For more details, see theExtreme persistent
+                # disk documentation.
+            "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                # number of throughput mb per second that the disk can handle. Values must
+                # greater than or equal to 1.
+            "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                # the URLs of the zones where the disk should be replicated to.
+                # You must provide exactly two replica zones, and one zone must be the same
+                # as the instance zone.
+              "A String",
+            ],
+            "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/{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",
+            },
+            "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                # Specified using the full or partial URL. For instance template, specify
+                # only the resource policy name.
+              "A String",
+            ],
+            "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # To create a disk with one of the public operating system
+                # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                #
+                # projects/debian-cloud/global/images/family/debian-9
+                #
+                #
+                # Alternatively, use a specific version of a public operating system image:
+                #
+                # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                #
+                #
+                # To create a disk with a custom image that you created, specify the
+                # image name in the following format:
+                #
+                # global/images/my-custom-image
+                #
+                #
+                # You can also specify a custom image by its image family, which returns
+                # the latest version of the image in that family. Replace the image name
+                # with family/family-name:
+                #
+                # global/images/family/my-image-family
+                #
+                #
+                # If the source image is deleted later, this field will not be set.
+            "sourceImageEncryptionKey": { # Thecustomer-supplied
+                # encryption key of the source image. Required if the source image is
+                # protected by a customer-supplied encryption key.
+                #
+                # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                # source images are encrypted with your own keys.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                # is required.
+                #
+                # To create a disk with a snapshot that you created, specify the
+                # snapshot name in the following format:
+                #
+                # global/snapshots/my-backup
+                #
+                #
+                # If the source snapshot is deleted later, this field will not be set.
+                #
+                # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                # an image instead when you create VMs using
+                # the bulk
+                # insert method.
+            "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                # encryption key of the source snapshot.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                #      - projects/project/zones/zone/storagePools/storagePool
+                #    - zones/zone/storagePools/storagePool
+          },
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. For most machine types, the
+              # default is SCSI. Local SSDs can use either NVME or SCSI.
+              # In certain configurations, persistent disks can use NVMe. For more
+              # information, seeAbout
+              # persistent disks.
+          "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+          "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+            "A String",
+          ],
+          "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+              # in READ_WRITE mode.
+          "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+              # field is set to PRESERVED if the LocalSSD data has been saved
+              # to a persistent location by customer request.  (see the
+              # discard_local_ssd option on Stop/Suspend).
+              # Read-only in the api.
+          "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+              # these are public keys which are safe to store in public
+            "dbs": [ # The Key Database (db).
+              {
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            ],
+            "dbxs": [ # The forbidden key database (dbx).
+              {
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            ],
+            "keks": [ # The Key Exchange Key (KEK).
+              {
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            ],
+            "pk": { # The Platform Key (PK).
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          },
+          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+              # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # If desired, you can also attach existing non-root persistent disks using
+              # this property. This field is only applicable for persistent disks.
+              #
+              # 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.
+        },
+      ],
+      "displayDevice": { # A set of Display Device options # Enables display device for the instance.
+        "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+      },
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the instance's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update the instance. You must always provide an
+          # up-to-date fingerprint hash in order to update the instance.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "hostname": "A String", # Specifies the hostname of the instance. The specified hostname must be
+          # RFC1035 compliant. If hostname is not specified, the default hostname is
+          # [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and
+          # [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instanceEncryptionKey": { # Encrypts suspended data for an instance with acustomer-managed
+          # encryption key.
+          #
+          # If you are creating a new instance, this field will encrypt the local SSD
+          # and in-memory contents of the instance during the suspend operation.
+          #
+          # If you do not provide an encryption key when creating the instance, then
+          # the local SSD and in-memory contents will be encrypted using
+          # an automatically generated key during the suspend operation.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+          # "NONE". The default value is "NONE" if it is not specified.
+      "kind": "compute#instance", # Output only. [Output Only] Type of the resource. Always compute#instance
+          # for instances.
+      "labelFingerprint": "A String", # A fingerprint for this request, which is essentially a hash of
+          # the label's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "labels": { # Labels to apply to this instance. These can be later modified by
+          # the setLabels method.
+        "a_key": "A String",
+      },
+      "lastStartTimestamp": "A String", # Output only. [Output Only] Last start timestamp inRFC3339 text format.
+      "lastStopTimestamp": "A String", # Output only. [Output Only] Last stop timestamp inRFC3339 text format.
+      "lastSuspendedTimestamp": "A String", # Output only. [Output Only] Last suspended timestamp inRFC3339 text format.
+      "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+          # Local SSDs attached to the VM.
+      "machineType": "A String", # Full or partial URL of the machine type resource to use for this instance,
+          # in the format:zones/zone/machineTypes/machine-type. This is provided by the client
+          # when the instance is created. For example, the following is a valid partial
+          # url to a predefined
+          # machine type:
+          #
+          # zones/us-central1-f/machineTypes/n1-standard-1
+          #
+          #
+          # To create acustom
+          # machine type, provide a URL to a machine type in the following format,
+          # where CPUS is 1 or an even number up to 32 (2,
+          # 4, 6, ... 24, etc), and MEMORY is the total
+          # memory for this instance. Memory must be a multiple of 256 MB and must
+          # be supplied in MB (e.g. 5 GB of memory is 5120 MB):
+          #
+          # zones/zone/machineTypes/custom-CPUS-MEMORY
+          #
+          #
+          # For example: zones/us-central1-f/machineTypes/custom-4-5120
+          #
+          # For a full list of restrictions, read theSpecifications
+          # for custom machine types.
+      "metadata": { # A metadata key/value entry. # The metadata key/value pairs assigned
+          # to this instance. This includes metadata keys that were explicitly defined
+          # for the instance.
+        "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+            # the metadata's contents and used for optimistic locking. The
+            # fingerprint is initially generated by Compute Engine and changes after
+            # every request to modify or update metadata. You must always provide an
+            # up-to-date fingerprint hash in order to update or change metadata,
+            # otherwise the request will fail with error412 conditionNotMet.
+            #
+            # To see the latest fingerprint, make a get() request to
+            # retrieve the resource.
+        "items": [ # Array of key/value pairs. The total size of all keys and values must be
+            # less than 512 KB.
+          { # Metadata
+            "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                # This is reflected as part of a URL in the metadata server. Additionally, to
+                # avoid ambiguity, keys must not conflict with any other metadata keys
+                # for the project.
+            "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                # have meaning as interpreted by the image running in the instance. The
+                # only restriction placed on values is that their size must be less than
+                # or equal to 262144 bytes (256 KiB).
+          },
+        ],
+        "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+            # for metadata.
+      },
+      "minCpuPlatform": "A String", # Specifies aminimum CPU
+          # platform for the VM instance. Applicable values are the friendly names
+          # of CPU platforms, such as minCpuPlatform: "Intel
+          # Haswell" or minCpuPlatform: "Intel Sandy
+          # Bridge".
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "networkInterfaces": [ # An array of network configurations for this instance. These specify how
+          # interfaces are configured to interact with other network services, such as
+          # connecting to the internet. Multiple interfaces are supported
+          # per instance.
+        { # A network interface resource attached to an instance.
+          "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+              # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+              # no external internet access.
+            { # An access configuration attached to an instance's network interface.
+                # Only one access config per instance is supported.
+              "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                  # The first IPv6 address of the external IPv6 range associated
+                  # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                  # use a static external IP address, it must be unused and in the same region
+                  # as the instance's zone. If not specified, Google Cloud will automatically
+                  # assign an external IPv6 address from the instance's subnetwork.
+              "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                  # external IPv6 range.
+              "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+              "name": "A String", # The name of this access configuration. In accessConfigs
+                  # (IPv4), the default and recommended name is External NAT, but
+                  # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                  # recommend name is External IPv6.
+              "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                  # address associated with this instance. Specify an unused static
+                  # external IP address available to the project or leave this field undefined
+                  # to use an IP from a shared ephemeral IP address pool. If you specify a
+                  # static external IP address, it must live in the same region as the zone of
+                  # the instance.
+              "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                  # configuration and can only take the following values: PREMIUM,STANDARD.
+                  #
+                  # If an AccessConfig is specified without a valid external IP address, an
+                  # ephemeral IP will be created with this networkTier.
+                  #
+                  # If an AccessConfig with a valid external IP address is specified, it must
+                  # match that of the networkTier associated with the Address resource owning
+                  # that IP.
+              "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                  #
+                  # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                  # first IP in associated external IPv6 range.
+              "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                  # config.
+              "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                  # external IP address of the instance to a DNS domain name.
+                  #
+                  # This field is not used in ipv6AccessConfig. A default PTR
+                  # record will be created if the VM has external IPv6 range associated.
+              "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                  # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+            },
+          ],
+          "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+              # You can only specify this field for network interfaces in VPC networks.
+            { # An alias IP range attached to an instance's network interface.
+              "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                  # must belong to the specified subnetwork and cannot contain IP addresses
+                  # reserved by system or used by other network interfaces. This range may be
+                  # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+              "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                  # alias range. If not specified, the primary range of the subnetwork is used.
+            },
+          ],
+          "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+              # You can only specify this field for network interfaces in VPC networks.
+            { # An alias IP range attached to an instance's network interface.
+              "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                  # must belong to the specified subnetwork and cannot contain IP addresses
+                  # reserved by system or used by other network interfaces. This range may be
+                  # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+              "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                  # alias range. If not specified, the primary range of the subnetwork is used.
+            },
+          ],
+          "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+              # with network_attachment.
+          "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+              # This field will be ignored when inserting an Instance or
+              # adding a NetworkInterface. An up-to-date
+              # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+          "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+              # or not. If enabled, also indicates the version of IGMP supported.
+          "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+          "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+              # one IPv6 access config, DIRECT_IPV6, is supported. If there
+              # is no ipv6AccessConfig specified, then this instance will
+              # have no external IPv6 Internet access.
+            { # An access configuration attached to an instance's network interface.
+                # Only one access config per instance is supported.
+              "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                  # The first IPv6 address of the external IPv6 range associated
+                  # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                  # use a static external IP address, it must be unused and in the same region
+                  # as the instance's zone. If not specified, Google Cloud will automatically
+                  # assign an external IPv6 address from the instance's subnetwork.
+              "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                  # external IPv6 range.
+              "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+              "name": "A String", # The name of this access configuration. In accessConfigs
+                  # (IPv4), the default and recommended name is External NAT, but
+                  # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                  # recommend name is External IPv6.
+              "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                  # address associated with this instance. Specify an unused static
+                  # external IP address available to the project or leave this field undefined
+                  # to use an IP from a shared ephemeral IP address pool. If you specify a
+                  # static external IP address, it must live in the same region as the zone of
+                  # the instance.
+              "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                  # configuration and can only take the following values: PREMIUM,STANDARD.
+                  #
+                  # If an AccessConfig is specified without a valid external IP address, an
+                  # ephemeral IP will be created with this networkTier.
+                  #
+                  # If an AccessConfig with a valid external IP address is specified, it must
+                  # match that of the networkTier associated with the Address resource owning
+                  # that IP.
+              "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                  #
+                  # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                  # first IP in associated external IPv6 range.
+              "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                  # config.
+              "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                  # external IP address of the instance to a DNS domain name.
+                  #
+                  # This field is not used in ipv6AccessConfig. A default PTR
+                  # record will be created if the VM has external IPv6 range associated.
+              "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                  # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+            },
+          ],
+          "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+              # accessed from the Internet. This field is always inherited from its
+              # subnetwork.
+              #
+              # Valid only if stackType is IPV4_IPV6.
+          "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+              # use a static internal IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an internal IPv6 address from the instance's subnetwork.
+          "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+          "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+              # server. For a VM, the network interface uses the nicN naming
+              # format. Where N is a value between 0 and7. The default interface value is nic0.
+          "network": "A String", # URL of the VPC network resource for this instance. When creating an
+              # instance, if neither the network nor the subnetwork is specified, the
+              # default network global/networks/default is used. If the
+              # selected project doesn't have the default network, you must specify a
+              # network or subnet. If the network is not specified but the subnetwork is
+              # specified, the network is inferred.
+              #
+              # If you specify this property, you can specify the network as
+              # a full or partial URL. For example, the following are all valid URLs:
+              #
+              #
+              #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+              #       - projects/project/global/networks/network
+              #       - global/networks/default
+          "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+              # to in the following format:
+              # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+          "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+              # interface. If not specified by the user, an unused internal IP is
+              # assigned by the system.
+          "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+              # VirtioNet.
+          "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+          "queueCount": 42, # The networking queue count that's specified by users for the network
+              # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+              # if not specified by the users.
+          "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+              # interface. Can only be used with network_attachment. It is not possible to
+              # use on its own however, network_attachment can be used without
+              # service_class_id.
+          "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+              # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+              #
+              # This field can be both set at instance creation and update network
+              # interface operations.
+          "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+              # resource is inlegacy
+              # mode, do not specify this field. If the network is in auto subnet
+              # mode, specifying the subnetwork is optional. If the network is in custom
+              # subnet mode, specifying the subnetwork is required. If you specify this
+              # field, you can specify the subnetwork as a full or partial URL. For
+              # example, the following are all valid URLs:
+              #
+              #
+              #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+              #    - regions/region/subnetworks/subnetwork
+          "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+              # from 2 to 255 inclusively.
+        },
+      ],
+      "networkPerformanceConfig": {
+        "totalEgressBandwidthTier": "A String",
+      },
+      "params": { # Additional instance params. # Input only. [Input Only] Additional params passed with the request, but not persisted
+          # as part of resource payload.
+        "requestValidForDuration": { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity. Relevant only for
+            # Instances.Insert API.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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": { # 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/{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",
+        },
+      },
+      "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for the VM.
+          # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that this instance can consume from.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+            # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+            # Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+            # the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be
+            # either a name to a reservation in the same project or
+            # "projects/different-project/reservations/some-reservation-name" to target a
+            # shared reservation in the same zone but in a different project.
+          "A String",
+        ],
+      },
+      "resourcePolicies": [ # Resource policies applied to this instance.
+        "A String",
+      ],
+      "resourceStatus": { # Contains output only fields. # Output only. [Output Only] Specifies values set for instance attributes as
+          # compared to the values requested by user in the corresponding input only
+          # field.
+          # Use this sub-message for actual values set on Instance attributes as compared
+          # to the value requested by the user (intent) in their instance CRUD calls.
+        "effectiveInstanceMetadata": { # Effective values of predefined metadata keys for an instance. # Output only. [Output Only] Effective metadata is a field that consolidates project,
+            # zonal instance settings, and instance-level predefined metadata keys to
+            # provide the overridden value for those metadata keys at the instance level.
+          "blockProjectSshKeysMetadataValue": True or False, # Effective block-project-ssh-keys value at Instance level.
+          "enableGuestAttributesMetadataValue": True or False, # Effective enable-guest-attributes value at Instance level.
+          "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.
+        },
+        "physicalHost": "A String", # Output only. [Output Only] The precise location of your instance within the zone's data
+            # center, including the block, sub-block, and host. The field is formatted as
+            # follows: blockId/subBlockId/hostId.
+        "physicalHostTopology": { # Represents the physical host topology of the host on which the VM is # Output only. [Output Only] A series of fields containing the global name of the Compute
+            # Engine cluster, as well as the ID of the block, sub-block, and host on
+            # which the running instance is located.
+            # running.
+          "additionalAttributes": { # Additional location information of the running instance. # Output only. [Output Only] Additional location information of the running instance.
+            "acceleratorTopologyIds": { # Output only. The IDs of the accelerator topologies the instance belongs to. For
+                # example
+                # The key will be topologies like "4x4", "2x2x2" and the value will be
+                # the location ID of the topologies.
+              "a_key": "A String",
+            },
+          },
+          "block": "A String", # [Output Only] The ID of the block in which the running instance is
+              # located. Instances within the same block experience low network latency.
+          "cluster": "A String", # [Output Only] The global name of the Compute Engine cluster where the
+              # running instance is located.
+          "host": "A String", # [Output Only] The ID of the host on which the running instance is located.
+              # Instances on the same host experience the lowest possible network
+              # latency.
+          "subblock": "A String", # [Output Only] The ID of the sub-block in which the running instance is
+              # located. Instances in the same sub-block experience lower network latency
+              # than instances in the same block.
+        },
+        "reservationConsumptionInfo": { # Reservation consumption information that the instance is consuming from. # Output only. [Output Only] Reservation information that the instance is consuming from.
+          "consumedReservation": "A String", # Output only. [Output Only] The full resource name of the reservation that this
+              # instance is consuming from.
+          "consumedReservationBlock": "A String", # Output only. [Output Only] The full resource name of the reservation block that this
+              # instance is consuming from.
+          "consumedReservationSubBlock": "A String", # Output only. [Output Only] The full resource name of the reservation sub-block that
+              # this instance is consuming from.
+        },
+        "scheduling": {
+          "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+              # must be a number between 1 and the number of availability domains
+              # specified in the spread placement policy attached to the instance.
+          "gracefulShutdownTimestamp": "A String", # Output only. Specifies the timestamp, when the instance will start graceful shutdown
+              # process, in RFC3339 text format.
+          "terminationTimestamp": "A String", # Time in future when the instance will be terminated inRFC3339 text format.
+        },
+        "shutdownDetails": { # Specifies if the instance is in `PENDING_STOP` state or there is a # Output only. [Output Only] Details about the instance stopping state.
+            # programmed stop scheduled.
+          "maxDuration": { # A Duration represents a fixed-length span of time represented # The duration for graceful shutdown. Only applicable when
+              # `stop_state=PENDING_STOP`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "requestTimestamp": "A String", # Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.
+          "stopState": "A String", # Current stopping state of the instance.
+          "targetState": "A String", # Target instance state.
+        },
+        "upcomingMaintenance": { # Upcoming Maintenance notification information.
+          "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+          "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+              # This timestamp value is in RFC3339 text format.
+          "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+          "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+            "A String",
+          ],
+          "maintenanceStatus": "A String",
+          "type": "A String", # Defines the type of maintenance.
+          "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+              # This timestamp value is in RFC3339 text format.
+          "windowStartTime": "A String", # The current start time of the maintenance window.
+              # This timestamp value is in RFC3339 text format.
+        },
+      },
+      "satisfiesPzi": True or False, # Output only. [Output Only] Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "scheduling": { # Sets the scheduling options for an Instance. # Sets the scheduling options for this instance.
+        "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+            # terminated by Compute Engine (not terminated by a user). You can only set
+            # the automatic restart option for standard instances.Preemptible instances
+            # cannot be automatically restarted.
+            #
+            # By default, this is set to true so an instance is
+            # automatically restarted if it is terminated by Compute Engine.
+        "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+            # must be a number between 1 and the number of availability domains
+            # specified in the spread placement policy attached to the instance.
+        "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+            # ResourceStatus resource of the VM.
+        "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+          "enabled": True or False, # Opts-in for graceful shutdown.
+          "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+              # graceful shutdown isn't complete after this time, then the instance
+              # transitions to the STOPPING state.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+            # within the range of [90, 330] with the increment of 30, if unset, the
+            # default behavior of host error recovery will be used.
+        "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+        "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+            # recovery of the Local Ssd state is attempted. Its value should be in
+            # between 0 and 168 hours with hour granularity and the default value being 1
+            # hour.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "locationHint": "A String", # An opaque location hint used to place the instance close to other
+            # resources.
+            # This field is for use by internal tools that use the public API.
+        "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+            # the instance termination action will be performed at the end of the run
+            # duration.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+            # on a sole-tenant node.
+        "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+            # affinity for more information.
+            # Overrides reservationAffinity.
+          { # Node Affinity: the configuration of desired nodes onto which this Instance
+              #  could be scheduled.
+            "key": "A String", # Corresponds to the label key of Node resource.
+            "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+            "values": [ # Corresponds to the label values of Node resource.
+              "A String",
+            ],
+          },
+        ],
+        "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+            # the default behavior is MIGRATE. Forpreemptible instances,
+            # the default and only possible behavior is TERMINATE. For more
+            # information, see
+            #  Set
+            #  VM host maintenance policy.
+        "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+          "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+              # else, the Local SSD data will be preserved when the instance is stopped
+              # at the end of the run duration/termination time.
+        },
+        "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+            # instance creation or while the instance isstopped and
+            # therefore, in a `TERMINATED` state. SeeInstance Life
+            # Cycle for more information on the possible instance states.
+        "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+            # Soft Off signal is triggered for Spot VMs only. If not specified,
+            # there will be no wait before the G2 Soft Off signal is triggered.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+        "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+            # Off and ACPI G3 Mechanical
+            # Off for Standard VMs and 30 seconds for Spot VMs.
+        "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+            # termination action will be performed at the termination time.
+      },
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+      "serviceAccounts": [ # A list of service accounts, with their specified scopes, authorized for
+          # this instance. Only one service account per VM instance is supported.
+          #
+          # Service accounts generate access tokens that can be accessed
+          # through the metadata server and used to authenticate applications on the
+          # instance. SeeService Accounts
+          # for more information.
+        { # A service account.
+          "email": "A String", # Email address of the service account.
+          "scopes": [ # The list of scopes to be made available for this service account.
+            "A String",
+          ],
+        },
+      ],
+      "shieldedInstanceConfig": { # A set of Shielded Instance options.
+        "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+            # default.
+        "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+            # default.
+        "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+            # default.
+      },
+      "shieldedInstanceIntegrityPolicy": { # The policy describes the baseline against which
+          # Instance boot integrity is measured.
+        "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+            # measurements from the VM instance's most recent boot.
+      },
+      "sourceMachineImage": "A String", # Source machine image
+      "sourceMachineImageEncryptionKey": { # Source machine image encryption key when creating an instance from a
+          # machine image.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "startRestricted": True or False, # Output only. [Output Only] Whether a VM has been restricted for start because Compute
+          # Engine has detected suspicious activity.
+      "status": "A String", # Output only. [Output Only] The status of the instance. One of the
+          # following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the
+          # instance, see
+          # Instance life cycle.
+      "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+      "tags": { # A set of instance tags. # Tags to apply to this instance. Tags are used to identify valid
+          # sources or targets for network firewalls and are specified by the client
+          # during instance creation. The tags can be later modified by the setTags
+          # method. Each tag within the list must comply withRFC1035.
+          # Multiple tags can be specified via the 'tags.items' field.
+        "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+            # the tags' contents and used for optimistic locking. The
+            # fingerprint is initially generated by Compute Engine and changes after
+            # every request to modify or update tags. You must always provide an
+            # up-to-date fingerprint hash in order to update or change tags.
+            #
+            # To see the latest fingerprint, make get() request to the
+            # instance.
+        "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+            # with RFC1035.
+          "A String",
+        ],
+      },
+      "workloadIdentityConfig": {
+        "identity": "A String",
+        "identityCertificateEnabled": True or False,
+      },
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the instance resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#instanceList", # Output only. [Output Only] Type of resource. Always compute#instanceList
+      # for lists of Instance resources.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listReferrers(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of resources that refer to the VM instance specified in
+the request. For example, if the VM instance is part of a managed or
+unmanaged instance group, the referrers list includes the instance group.
+For more information, readViewing
+referrers to VM instances.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the target instance scoping this request, or '-' if the
+request should span over all instances in the container. (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.
+  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 instance referrers.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Reference resources.
+    { # Represents a reference to a resource.
+      "kind": "compute#reference", # Output only. [Output Only] Type of the resource. Always compute#reference
+          # for references.
+      "referenceType": "A String", # A description of the reference type with no implied semantics. Possible
+          # values include:
+          #
+          #
+          #     1. MEMBER_OF
+      "referrer": "A String", # URL of the resource which refers to the target.
+      "target": "A String", # URL of the resource to which this reference points.
+    },
+  ],
+  "kind": "compute#instanceListReferrers", # Output only. [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listReferrers_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.
+
+
+ +
+ performMaintenance(project, zone, instance, requestId=None, x__xgafv=None) + 
Perform a manual maintenance on the instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeResourcePolicies(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Removes resource policies from an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Resource policies to be removed from this instance.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ reportHostAsFaulty(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Mark the host as faulty and try to restart the instance on a new host.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "disruptionSchedule": "A String", # The disruption schedule for the VM. Required field, only allows IMMEDIATE.
+  "faultReasons": [
+    {
+      "behavior": "A String",
+      "description": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ reset(project, zone, instance, requestId=None, x__xgafv=None) + 
Performs a reset on the instance. This is a hard reset. The VM
+does not do a graceful shutdown. For more information, seeResetting
+an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resume(project, zone, instance, requestId=None, x__xgafv=None) + 
Resumes an instance that was suspended using theinstances().suspend
+method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to resume. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ sendDiagnosticInterrupt(project, zone, instance, x__xgafv=None) + 
Sends diagnostic interrupt to the instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ setDeletionProtection(project, zone, resource, deletionProtection=None, requestId=None, x__xgafv=None) + 
Sets deletion protection on the instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  deletionProtection: boolean, Whether the resource should be protected against deletion.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setDiskAutoDelete(project, zone, instance, autoDelete, deviceName, requestId=None, x__xgafv=None) + 
Sets the auto-delete flag for a disk attached to an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  autoDelete: boolean, Whether to auto-delete the disk when the instance is deleted. (required)
+  deviceName: string, The device name of the disk to modify. Make a get() request
+on the instance to view currently attached disks and device names. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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).
+}
+
+ +
+ setLabels(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets labels on an instance.  To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "labelFingerprint": "A String", # Fingerprint of the previous set of labels for this resource,
+      # used to prevent conflicts. Provide the latest fingerprint value when making
+      # a request to add or change labels.
+  "labels": {
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setMachineResources(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Changes the number and/or type of accelerator for a stopped instance to the
+values specified in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setMachineType(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Changes the machine type for a stopped instance to the machine
+type specified in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "machineType": "A String", # Full or partial URL of the machine type resource. See Machine Types for a full list of
+      # machine types. For example:zones/us-central1-f/machineTypes/n1-standard-1
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setMetadata(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets metadata for the specified instance to the data included
+in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A metadata key/value entry.
+  "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve the resource.
+  "items": [ # Array of key/value pairs. The total size of all keys and values must be
+      # less than 512 KB.
+    { # Metadata
+      "key": "A String", # Key for the metadata entry. Keys must conform to the following
+          # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+          # This is reflected as part of a URL in the metadata server. Additionally, to
+          # avoid ambiguity, keys must not conflict with any other metadata keys
+          # for the project.
+      "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+          # have meaning as interpreted by the image running in the instance. The
+          # only restriction placed on values is that their size must be less than
+          # or equal to 262144 bytes (256 KiB).
+    },
+  ],
+  "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+      # for metadata.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setMinCpuPlatform(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Changes the minimum CPU platform that this instance should use.
+This method can only
+be called on a stopped instance. For more information, readSpecifying a
+Minimum CPU Platform.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "minCpuPlatform": "A String", # Minimum cpu/platform this instance should be started at.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setName(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets name of an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "currentName": "A String", # The current name of this resource, used to prevent conflicts. Provide the
+      # latest name when making a request to change name.
+  "name": "A String", # The name to be applied to the instance. Needs to be RFC 1035 compliant.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setScheduling(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets an instance's scheduling options. You can only call this method on astopped instance,
+that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life
+Cycle for more information on the possible instance states.
+For more information about setting scheduling options for a VM, seeSet
+VM host maintenance policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Instance name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Sets the scheduling options for an Instance.
+  "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+      # terminated by Compute Engine (not terminated by a user). You can only set
+      # the automatic restart option for standard instances.Preemptible instances
+      # cannot be automatically restarted.
+      # 
+      # By default, this is set to true so an instance is
+      # automatically restarted if it is terminated by Compute Engine.
+  "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+      # must be a number between 1 and the number of availability domains
+      # specified in the spread placement policy attached to the instance.
+  "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+      # ResourceStatus resource of the VM.
+  "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+    "enabled": True or False, # Opts-in for graceful shutdown.
+    "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+        # graceful shutdown isn't complete after this time, then the instance
+        # transitions to the STOPPING state.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+      # within the range of [90, 330] with the increment of 30, if unset, the
+      # default behavior of host error recovery will be used.
+  "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+  "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+      # recovery of the Local Ssd state is attempted. Its value should be in
+      # between 0 and 168 hours with hour granularity and the default value being 1
+      # hour.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "locationHint": "A String", # An opaque location hint used to place the instance close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+      # the instance termination action will be performed at the end of the run
+      # duration.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+      # on a sole-tenant node.
+  "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+      # affinity for more information.
+      # Overrides reservationAffinity.
+    { # Node Affinity: the configuration of desired nodes onto which this Instance
+        #  could be scheduled.
+      "key": "A String", # Corresponds to the label key of Node resource.
+      "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+      "values": [ # Corresponds to the label values of Node resource.
+        "A String",
+      ],
+    },
+  ],
+  "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+      # the default behavior is MIGRATE. Forpreemptible instances,
+      # the default and only possible behavior is TERMINATE. For more
+      # information, see
+      #  Set
+      #  VM host maintenance policy.
+  "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+    "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+        # else, the Local SSD data will be preserved when the instance is stopped
+        # at the end of the run duration/termination time.
+  },
+  "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+      # instance creation or while the instance isstopped and
+      # therefore, in a `TERMINATED` state. SeeInstance Life
+      # Cycle for more information on the possible instance states.
+  "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+      # Soft Off signal is triggered for Spot VMs only. If not specified,
+      # there will be no wait before the G2 Soft Off signal is triggered.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+  "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+      # Off and ACPI G3 Mechanical
+      # Off for Standard VMs and 30 seconds for Spot VMs.
+  "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+      # termination action will be performed at the termination time.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSecurityPolicy(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets the Google Cloud Armor security policy for the specified instance.
+For more information, seeGoogle
+Cloud Armor Overview
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone scoping this request. (required)
+  instance: string, Name of the Instance resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkInterfaces": [ # The network interfaces that the security policy will be applied to. Network
+      # interfaces use the nicN naming format. You can only set a
+      # security policy for network interfaces with an access config.
+    "A String",
+  ],
+  "securityPolicy": "A String", # A full or partial URL to a security policy to add to this instance.
+      # If this field is set to an empty string it will remove the associated
+      # security policy.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setServiceAccount(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets the service account on the instance. For more information,
+readChanging
+the service account and access scopes for an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to start. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "email": "A String", # Email address of the service account.
+  "scopes": [ # The list of scopes to be made available for this service account.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setShieldedInstanceIntegrityPolicy(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets the Shielded Instance integrity policy for an instance. You can
+only use this method on a running instance. This method
+supports PATCH semantics and uses the JSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name or id of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The policy describes the baseline against which
+    # Instance boot integrity is measured.
+  "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+      # measurements from the VM instance's most recent boot.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setTags(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Sets network tags
+for the specified instance to the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A set of instance tags.
+  "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+      # the tags' contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update tags. You must always provide an
+      # up-to-date fingerprint hash in order to update or change tags.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+      # with RFC1035.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ simulateMaintenanceEvent(project, zone, instance, requestId=None, withExtendedNotifications=None, x__xgafv=None) + 
Simulates a host maintenance event on a VM. For more information, see
+Simulate a host maintenance event.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (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).
+  withExtendedNotifications: boolean, Determines whether the customers receive notifications before migration.
+Only applicable to SF vms.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ start(project, zone, instance, requestId=None, x__xgafv=None) + 
Starts an instance that was stopped using theinstances().stop
+method. For more information, seeRestart an
+instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to start. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ startWithEncryptionKey(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Starts an instance that was stopped using theinstances().stop
+method. For more information, seeRestart an
+instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to start. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "disks": [ # Array of disks associated with this instance that are protected with acustomer-supplied
+      # encryption key.
+      # 
+      # In order to start the instance, the disk url and its corresponding key must
+      # be provided.
+      # 
+      # If the disk is not protected with a customer-supplied encryption key it
+      # should not be specified.
+    {
+      "diskEncryptionKey": { # Decrypts data associated with the disk with acustomer-supplied
+          # encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+          # resource. This field is only applicable for persistent disks.
+          # For example:
+          #
+          # "source": "/compute/v1/projects/project_id/zones/zone/disks/
+          # disk_name
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stop(project, zone, instance, discardLocalSsd=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Stops a running instance, shutting it down cleanly, and allows
+you to restart the instance at a later time. Stopped instances do not incur
+VM usage charges while they are stopped. However, resources that the VM is
+using, such as persistent disks and static IP addresses, will continue to
+be charged until they are deleted. For more information, seeStopping
+an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to stop. (required)
+  discardLocalSsd: boolean, This property is required if the instance has any attached Local SSD disks.
+If false, Local SSD data will be preserved when the instance is suspended.
+If true, the contents of any attached Local SSD disks will be discarded.
+  noGracefulShutdown: boolean, If set to true, Graceful Shutdown is skipped.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ suspend(project, zone, instance, discardLocalSsd=None, requestId=None, x__xgafv=None) + 
This method suspends a running instance, saving its state to persistent
+storage, and allows you to resume the instance at a later time. Suspended
+instances have no compute costs (cores or RAM), and incur only storage
+charges for the saved VM memory and localSSD data. Any charged resources
+the virtual machine was using, such as persistent disks and static IP
+addresses, will continue to be charged while the instance is suspended.
+For more information, see
+Suspending and resuming an instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to suspend. (required)
+  discardLocalSsd: boolean, This property is required if the instance has any attached Local SSD disks.
+If false, Local SSD data will be preserved when the instance is suspended.
+If true, the contents of any attached Local SSD disks will be discarded.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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, zone, instance, body=None, discardLocalSsd=None, minimalAction=None, mostDisruptiveAllowedAction=None, requestId=None, x__xgafv=None) + 
Updates an instance only if the necessary resources are available. This
+method can update only a specific set of instance properties. See
+Updating a running instance for a list of updatable instance
+properties.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Instance resource.
+    # 
+    # An instance is a virtual machine that is hosted on Google Cloud Platform.
+    # For more information, readVirtual Machine Instances.
+  "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+      # Options that would traditionally be configured in a BIOS belong
+      # here. Features that require operating system support may have
+      # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+      # disabled).
+    "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+    "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+    "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+    "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+        # multithreading (SMT) set this to 1. If unset, the maximum number
+        # of threads supported per core by the underlying processor is
+        # assumed.
+    "turboMode": "A String", # Turbo frequency mode to use for the instance.
+        # Supported modes include:
+        # * ALL_CORE_MAX
+        #
+        # Using empty string or not setting this field will use the platform-specific
+        # default turbo mode.
+    "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+        # the number of threads per core to compute the total number of virtual
+        # CPUs to expose to the instance. If unset, the number of cores is
+        # inferred from the instance's nominal CPU count and the underlying
+        # platform's SMT width.
+  },
+  "canIpForward": True or False, # Allows this instance to send and receive packets with non-matching
+      # destination or source IPs. This is required if you plan to use this
+      # instance to forward routes. For more information, seeEnabling IP Forwarding.
+  "confidentialInstanceConfig": { # A set of Confidential Instance options.
+    "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+    "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+  },
+  "cpuPlatform": "A String", # Output only. [Output Only] The CPU platform used by this instance.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+  "deletionProtection": True or False, # Whether the resource should be protected against deletion.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "disks": [ # Array of disks associated with this instance. Persistent disks must be
+      # created before you can assign them.
+    { # An instance-attached disk resource.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+          # or X86_64.
+      "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+          # deleted (but not when the disk is detached from the instance).
+      "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+          # partition of the disk for its root filesystem.
+      "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+          # running within the instance. This name can be used to reference the device
+          # for mounting, resizing, and so on, from within the instance.
+          #
+          # If not specified, the server chooses a default device name to apply to this
+          # disk, in the form persistent-disk-x, where x is a number
+          # assigned by Google Compute Engine. This field is only applicable for
+          # persistent disks.
+      "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+          # encryption key.
+          #
+          # If you are creating a new disk, this field encrypts the new disk using
+          # an encryption key that you provide. If you are attaching an existing
+          # disk that is already encrypted, this field decrypts the disk using
+          # the customer-supplied encryption key.
+          #
+          # If you encrypt a disk using a customer-supplied key, you must provide the
+          # same key again when you attempt to use this resource at a later time. For
+          # example, you must provide the key when you create a snapshot or an image
+          # from the disk or when you attach the disk to a virtual machine instance.
+          #
+          # If you do not provide an encryption key, then the disk will be encrypted
+          # using an automatically generated key and you do not need to provide a key
+          # to use the disk later.
+          #
+          # Note:
+          #
+          # Instance templates do not storecustomer-supplied
+          # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+          #
+          # You cannot create VMs that have disks with customer-supplied keys using
+          # the bulk
+          # insert method.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "diskSizeGb": "A String", # The size of the disk in GB.
+      "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+          # currently attached to another instance. If you try to force attach a zonal
+          # disk to an instance, you will receive an error.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+          # boot disk. If you have many disks attached to an instance, each
+          # disk would have a unique index number.
+      "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+          # alongside the new instance. Use initialization parameters to create boot
+          # disks or local SSDs attached to the new instance.
+          #
+          # This field is persisted and returned for instanceTemplate and not returned
+          # in the context of instance.
+          #
+          # This property is mutually exclusive with the source property;
+          # you can only define one or the other, but not both.
+        "architecture": "A String", # The architecture of the attached disk. Valid values are
+            # arm64 or x86_64.
+        "description": "A String", # An optional description. Provide this property when creating the disk.
+        "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+            # of the instance. If a disk with the same name already exists in the given
+            # region, the existing disk is attached to the new instance and the
+            # new disk is not created.
+        "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+            # 10 GB. If you specify a sourceImage, which is required for
+            # boot disks, the default size is the size of the sourceImage.
+            # If you do not specify a sourceImage, the default disk size
+            # is 500 GB.
+        "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+            # disk. For valid disk type values, see
+            # Supported types for Hyperdisk volumes and
+            # Persistent Disk type variables.
+            #
+            # When creating a single instance, you must provide either the full or
+            # partial URL of the disk type. For example, the following values are
+            # valid:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+            #      - projects/project/zones/zone/diskTypes/diskType
+            #      - zones/zone/diskTypes/diskType
+            #
+            #
+            #
+            # When creating an instance template, instance flexibility policy, or when
+            # creating or updating an all-instances configuration, you specify the
+            # disk type without a URL, for example, hyperdisk-balanced.
+            #
+            # If you omit this field for a disk, the default disk type depends on
+            # the instance's machine series, as follows.
+            #
+            #
+            #     - For first- and second-generation machine series like N1, N2, T2, and
+            #     M1, the
+            #        default disk type is Standard Persistent Disk
+            #        (pd-standard).
+            #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+            #     (pd-balanced).
+            #    - For other third-generation machine
+            #     series like A3, H3, Z3, all
+            #         fourth-generation types like C4, N4, M4, and newer machine series,
+            #         the default is Hyperdisk Balanced
+            #         (hyperdisk-balanced).
+            #
+            #
+            #
+            # The disk type you specify must be compatible with the instance's machine
+            # series. For a list of machine series that support Persistent Disk, see Machine
+            # series support for Persistent Disk.
+            #
+            # For a list of machine series that support Hyperdisk, seeMachine
+            # series support for Hyperdisk.
+        "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+        "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+            # persistent disks.
+          "a_key": "A String",
+        },
+        "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+          "A String",
+        ],
+        "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+            # is to use the existing disk.
+        "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+            # of I/O operations per second that the disk can handle. Values must be
+            # between 10,000 and 120,000. For more details, see theExtreme persistent
+            # disk documentation.
+        "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+            # number of throughput mb per second that the disk can handle. Values must
+            # greater than or equal to 1.
+        "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+            # the URLs of the zones where the disk should be replicated to.
+            # You must provide exactly two replica zones, and one zone must be the same
+            # as the instance zone.
+          "A String",
+        ],
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+            # Specified using the full or partial URL. For instance template, specify
+            # only the resource policy name.
+          "A String",
+        ],
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+            # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # To create a disk with one of the public operating system
+            # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+            #
+            # projects/debian-cloud/global/images/family/debian-9
+            #
+            #
+            # Alternatively, use a specific version of a public operating system image:
+            #
+            # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+            #
+            #
+            # To create a disk with a custom image that you created, specify the
+            # image name in the following format:
+            #
+            # global/images/my-custom-image
+            #
+            #
+            # You can also specify a custom image by its image family, which returns
+            # the latest version of the image in that family. Replace the image name
+            # with family/family-name:
+            #
+            # global/images/family/my-image-family
+            #
+            #
+            # If the source image is deleted later, this field will not be set.
+        "sourceImageEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source image. Required if the source image is
+            # protected by a customer-supplied encryption key.
+            #
+            # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+            # encryption keys, so you cannot create disks for instances in a managed instance group if the
+            # source images are encrypted with your own keys.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+            # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+            # is required.
+            #
+            # To create a disk with a snapshot that you created, specify the
+            # snapshot name in the following format:
+            #
+            # global/snapshots/my-backup
+            #
+            #
+            # If the source snapshot is deleted later, this field will not be set.
+            #
+            # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+            # an image instead when you create VMs using
+            # the bulk
+            # insert method.
+        "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+            # encryption key of the source snapshot.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+            #      - projects/project/zones/zone/storagePools/storagePool
+            #    - zones/zone/storagePools/storagePool
+      },
+      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+          # either SCSI or NVME. For most machine types, the
+          # default is SCSI. Local SSDs can use either NVME or SCSI.
+          # In certain configurations, persistent disks can use NVMe. For more
+          # information, seeAbout
+          # persistent disks.
+      "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+      "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+        "A String",
+      ],
+      "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+          # in READ_WRITE mode.
+      "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+          # field is set to PRESERVED if the LocalSSD data has been saved
+          # to a persistent location by customer request.  (see the
+          # discard_local_ssd option on Stop/Suspend).
+          # Read-only in the api.
+      "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+          # these are public keys which are safe to store in public
+        "dbs": [ # The Key Database (db).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "dbxs": [ # The forbidden key database (dbx).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "keks": [ # The Key Exchange Key (KEK).
+          {
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        ],
+        "pk": { # The Platform Key (PK).
+          "content": "A String", # The raw content in the secure keys file.
+          "fileType": "A String", # The file type of source file.
+        },
+      },
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+          # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+          # is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using
+          # this property. This field is only applicable for persistent disks.
+          #
+          # 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.
+    },
+  ],
+  "displayDevice": { # A set of Display Device options # Enables display device for the instance.
+    "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+  },
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the instance's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update the instance. You must always provide an
+      # up-to-date fingerprint hash in order to update the instance.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "guestAccelerators": [ # A list of the type and count of accelerator cards attached to the instance.
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+  "hostname": "A String", # Specifies the hostname of the instance. The specified hostname must be
+      # RFC1035 compliant. If hostname is not specified, the default hostname is
+      # [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and
+      # [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceEncryptionKey": { # Encrypts suspended data for an instance with acustomer-managed
+      # encryption key.
+      # 
+      # If you are creating a new instance, this field will encrypt the local SSD
+      # and in-memory contents of the instance during the suspend operation.
+      # 
+      # If you do not provide an encryption key when creating the instance, then
+      # the local SSD and in-memory contents will be encrypted using
+      # an automatically generated key during the suspend operation.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+      # "NONE". The default value is "NONE" if it is not specified.
+  "kind": "compute#instance", # Output only. [Output Only] Type of the resource. Always compute#instance
+      # for instances.
+  "labelFingerprint": "A String", # A fingerprint for this request, which is essentially a hash of
+      # the label's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # instance.
+  "labels": { # Labels to apply to this instance. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastStartTimestamp": "A String", # Output only. [Output Only] Last start timestamp inRFC3339 text format.
+  "lastStopTimestamp": "A String", # Output only. [Output Only] Last stop timestamp inRFC3339 text format.
+  "lastSuspendedTimestamp": "A String", # Output only. [Output Only] Last suspended timestamp inRFC3339 text format.
+  "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+      # Local SSDs attached to the VM.
+  "machineType": "A String", # Full or partial URL of the machine type resource to use for this instance,
+      # in the format:zones/zone/machineTypes/machine-type. This is provided by the client
+      # when the instance is created. For example, the following is a valid partial
+      # url to a predefined
+      # machine type:
+      # 
+      # zones/us-central1-f/machineTypes/n1-standard-1
+      # 
+      # 
+      # To create acustom
+      # machine type, provide a URL to a machine type in the following format,
+      # where CPUS is 1 or an even number up to 32 (2,
+      # 4, 6, ... 24, etc), and MEMORY is the total
+      # memory for this instance. Memory must be a multiple of 256 MB and must
+      # be supplied in MB (e.g. 5 GB of memory is 5120 MB):
+      # 
+      # zones/zone/machineTypes/custom-CPUS-MEMORY
+      # 
+      # 
+      # For example: zones/us-central1-f/machineTypes/custom-4-5120
+      # 
+      # For a full list of restrictions, read theSpecifications
+      # for custom machine types.
+  "metadata": { # A metadata key/value entry. # The metadata key/value pairs assigned
+      # to this instance. This includes metadata keys that were explicitly defined
+      # for the instance.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the metadata's contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update metadata. You must always provide an
+        # up-to-date fingerprint hash in order to update or change metadata,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve the resource.
+    "items": [ # Array of key/value pairs. The total size of all keys and values must be
+        # less than 512 KB.
+      { # Metadata
+        "key": "A String", # Key for the metadata entry. Keys must conform to the following
+            # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+            # This is reflected as part of a URL in the metadata server. Additionally, to
+            # avoid ambiguity, keys must not conflict with any other metadata keys
+            # for the project.
+        "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+            # have meaning as interpreted by the image running in the instance. The
+            # only restriction placed on values is that their size must be less than
+            # or equal to 262144 bytes (256 KiB).
+      },
+    ],
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "minCpuPlatform": "A String", # Specifies aminimum CPU
+      # platform for the VM instance. Applicable values are the friendly names
+      # of CPU platforms, such as minCpuPlatform: "Intel
+      # Haswell" or minCpuPlatform: "Intel Sandy
+      # Bridge".
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "networkInterfaces": [ # An array of network configurations for this instance. These specify how
+      # interfaces are configured to interact with other network services, such as
+      # connecting to the internet. Multiple interfaces are supported
+      # per instance.
+    { # A network interface resource attached to an instance.
+      "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+          # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+          # no external internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+          # You can only specify this field for network interfaces in VPC networks.
+        { # An alias IP range attached to an instance's network interface.
+          "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+              # must belong to the specified subnetwork and cannot contain IP addresses
+              # reserved by system or used by other network interfaces. This range may be
+              # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+          "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+              # alias range. If not specified, the primary range of the subnetwork is used.
+        },
+      ],
+      "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+          # with network_attachment.
+      "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+          # This field will be ignored when inserting an Instance or
+          # adding a NetworkInterface. An up-to-date
+          # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+      "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+          # or not. If enabled, also indicates the version of IGMP supported.
+      "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+      "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+          # one IPv6 access config, DIRECT_IPV6, is supported. If there
+          # is no ipv6AccessConfig specified, then this instance will
+          # have no external IPv6 Internet access.
+        { # An access configuration attached to an instance's network interface.
+            # Only one access config per instance is supported.
+          "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+              # The first IPv6 address of the external IPv6 range associated
+              # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+              # use a static external IP address, it must be unused and in the same region
+              # as the instance's zone. If not specified, Google Cloud will automatically
+              # assign an external IPv6 address from the instance's subnetwork.
+          "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+              # external IPv6 range.
+          "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+          "name": "A String", # The name of this access configuration. In accessConfigs
+              # (IPv4), the default and recommended name is External NAT, but
+              # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+              # recommend name is External IPv6.
+          "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+              # address associated with this instance. Specify an unused static
+              # external IP address available to the project or leave this field undefined
+              # to use an IP from a shared ephemeral IP address pool. If you specify a
+              # static external IP address, it must live in the same region as the zone of
+              # the instance.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access
+              # configuration and can only take the following values: PREMIUM,STANDARD.
+              #
+              # If an AccessConfig is specified without a valid external IP address, an
+              # ephemeral IP will be created with this networkTier.
+              #
+              # If an AccessConfig with a valid external IP address is specified, it must
+              # match that of the networkTier associated with the Address resource owning
+              # that IP.
+          "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+              #
+              # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+              # first IP in associated external IPv6 range.
+          "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+              # config.
+          "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+              # external IP address of the instance to a DNS domain name.
+              #
+              # This field is not used in ipv6AccessConfig. A default PTR
+              # record will be created if the VM has external IPv6 range associated.
+          "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+              # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+        },
+      ],
+      "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+          # accessed from the Internet. This field is always inherited from its
+          # subnetwork.
+          #
+          # Valid only if stackType is IPV4_IPV6.
+      "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+          # use a static internal IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an internal IPv6 address from the instance's subnetwork.
+      "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+      "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+          # server. For a VM, the network interface uses the nicN naming
+          # format. Where N is a value between 0 and7. The default interface value is nic0.
+      "network": "A String", # URL of the VPC network resource for this instance. When creating an
+          # instance, if neither the network nor the subnetwork is specified, the
+          # default network global/networks/default is used. If the
+          # selected project doesn't have the default network, you must specify a
+          # network or subnet. If the network is not specified but the subnetwork is
+          # specified, the network is inferred.
+          #
+          # If you specify this property, you can specify the network as
+          # a full or partial URL. For example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+          #       - projects/project/global/networks/network
+          #       - global/networks/default
+      "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+          # to in the following format:
+          # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+      "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+          # interface. If not specified by the user, an unused internal IP is
+          # assigned by the system.
+      "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+          # VirtioNet.
+      "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+      "queueCount": 42, # The networking queue count that's specified by users for the network
+          # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+          # if not specified by the users.
+      "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+          # interface. Can only be used with network_attachment. It is not possible to
+          # use on its own however, network_attachment can be used without
+          # service_class_id.
+      "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+          # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+          #
+          # This field can be both set at instance creation and update network
+          # interface operations.
+      "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+          # resource is inlegacy
+          # mode, do not specify this field. If the network is in auto subnet
+          # mode, specifying the subnetwork is optional. If the network is in custom
+          # subnet mode, specifying the subnetwork is required. If you specify this
+          # field, you can specify the subnetwork as a full or partial URL. For
+          # example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+          #    - regions/region/subnetworks/subnetwork
+      "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+          # from 2 to 255 inclusively.
+    },
+  ],
+  "networkPerformanceConfig": {
+    "totalEgressBandwidthTier": "A String",
+  },
+  "params": { # Additional instance params. # Input only. [Input Only] Additional params passed with the request, but not persisted
+      # as part of resource payload.
+    "requestValidForDuration": { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity. Relevant only for
+        # Instances.Insert API.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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": { # 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/{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",
+    },
+  },
+  "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for the VM.
+      # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+  "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that this instance can consume from.
+    "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+        # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+        # Consuming reserved instances for examples.
+    "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+        # the name of your reservation as its value.
+    "values": [ # Corresponds to the label values of a reservation resource. This can be
+        # either a name to a reservation in the same project or
+        # "projects/different-project/reservations/some-reservation-name" to target a
+        # shared reservation in the same zone but in a different project.
+      "A String",
+    ],
+  },
+  "resourcePolicies": [ # Resource policies applied to this instance.
+    "A String",
+  ],
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] Specifies values set for instance attributes as
+      # compared to the values requested by user in the corresponding input only
+      # field.
+      # Use this sub-message for actual values set on Instance attributes as compared
+      # to the value requested by the user (intent) in their instance CRUD calls.
+    "effectiveInstanceMetadata": { # Effective values of predefined metadata keys for an instance. # Output only. [Output Only] Effective metadata is a field that consolidates project,
+        # zonal instance settings, and instance-level predefined metadata keys to
+        # provide the overridden value for those metadata keys at the instance level.
+      "blockProjectSshKeysMetadataValue": True or False, # Effective block-project-ssh-keys value at Instance level.
+      "enableGuestAttributesMetadataValue": True or False, # Effective enable-guest-attributes value at Instance level.
+      "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.
+    },
+    "physicalHost": "A String", # Output only. [Output Only] The precise location of your instance within the zone's data
+        # center, including the block, sub-block, and host. The field is formatted as
+        # follows: blockId/subBlockId/hostId.
+    "physicalHostTopology": { # Represents the physical host topology of the host on which the VM is # Output only. [Output Only] A series of fields containing the global name of the Compute
+        # Engine cluster, as well as the ID of the block, sub-block, and host on
+        # which the running instance is located.
+        # running.
+      "additionalAttributes": { # Additional location information of the running instance. # Output only. [Output Only] Additional location information of the running instance.
+        "acceleratorTopologyIds": { # Output only. The IDs of the accelerator topologies the instance belongs to. For
+            # example
+            # The key will be topologies like "4x4", "2x2x2" and the value will be
+            # the location ID of the topologies.
+          "a_key": "A String",
+        },
+      },
+      "block": "A String", # [Output Only] The ID of the block in which the running instance is
+          # located. Instances within the same block experience low network latency.
+      "cluster": "A String", # [Output Only] The global name of the Compute Engine cluster where the
+          # running instance is located.
+      "host": "A String", # [Output Only] The ID of the host on which the running instance is located.
+          # Instances on the same host experience the lowest possible network
+          # latency.
+      "subblock": "A String", # [Output Only] The ID of the sub-block in which the running instance is
+          # located. Instances in the same sub-block experience lower network latency
+          # than instances in the same block.
+    },
+    "reservationConsumptionInfo": { # Reservation consumption information that the instance is consuming from. # Output only. [Output Only] Reservation information that the instance is consuming from.
+      "consumedReservation": "A String", # Output only. [Output Only] The full resource name of the reservation that this
+          # instance is consuming from.
+      "consumedReservationBlock": "A String", # Output only. [Output Only] The full resource name of the reservation block that this
+          # instance is consuming from.
+      "consumedReservationSubBlock": "A String", # Output only. [Output Only] The full resource name of the reservation sub-block that
+          # this instance is consuming from.
+    },
+    "scheduling": {
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "gracefulShutdownTimestamp": "A String", # Output only. Specifies the timestamp, when the instance will start graceful shutdown
+          # process, in RFC3339 text format.
+      "terminationTimestamp": "A String", # Time in future when the instance will be terminated inRFC3339 text format.
+    },
+    "shutdownDetails": { # Specifies if the instance is in `PENDING_STOP` state or there is a # Output only. [Output Only] Details about the instance stopping state.
+        # programmed stop scheduled.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The duration for graceful shutdown. Only applicable when
+          # `stop_state=PENDING_STOP`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "requestTimestamp": "A String", # Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.
+      "stopState": "A String", # Current stopping state of the instance.
+      "targetState": "A String", # Target instance state.
+    },
+    "upcomingMaintenance": { # Upcoming Maintenance notification information.
+      "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+      "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+          # This timestamp value is in RFC3339 text format.
+      "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+      "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+        "A String",
+      ],
+      "maintenanceStatus": "A String",
+      "type": "A String", # Defines the type of maintenance.
+      "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+          # This timestamp value is in RFC3339 text format.
+      "windowStartTime": "A String", # The current start time of the maintenance window.
+          # This timestamp value is in RFC3339 text format.
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. [Output Only] Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "scheduling": { # Sets the scheduling options for an Instance. # Sets the scheduling options for this instance.
+    "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+        # terminated by Compute Engine (not terminated by a user). You can only set
+        # the automatic restart option for standard instances.Preemptible instances
+        # cannot be automatically restarted.
+        #
+        # By default, this is set to true so an instance is
+        # automatically restarted if it is terminated by Compute Engine.
+    "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+        # must be a number between 1 and the number of availability domains
+        # specified in the spread placement policy attached to the instance.
+    "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+        # ResourceStatus resource of the VM.
+    "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+      "enabled": True or False, # Opts-in for graceful shutdown.
+      "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+          # graceful shutdown isn't complete after this time, then the instance
+          # transitions to the STOPPING state.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+        # within the range of [90, 330] with the increment of 30, if unset, the
+        # default behavior of host error recovery will be used.
+    "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+    "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+        # recovery of the Local Ssd state is attempted. Its value should be in
+        # between 0 and 168 hours with hour granularity and the default value being 1
+        # hour.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "locationHint": "A String", # An opaque location hint used to place the instance close to other
+        # resources.
+        # This field is for use by internal tools that use the public API.
+    "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+        # the instance termination action will be performed at the end of the run
+        # duration.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+        # on a sole-tenant node.
+    "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+        # affinity for more information.
+        # Overrides reservationAffinity.
+      { # Node Affinity: the configuration of desired nodes onto which this Instance
+          #  could be scheduled.
+        "key": "A String", # Corresponds to the label key of Node resource.
+        "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+        "values": [ # Corresponds to the label values of Node resource.
+          "A String",
+        ],
+      },
+    ],
+    "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+        # the default behavior is MIGRATE. Forpreemptible instances,
+        # the default and only possible behavior is TERMINATE. For more
+        # information, see
+        #  Set
+        #  VM host maintenance policy.
+    "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+      "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+          # else, the Local SSD data will be preserved when the instance is stopped
+          # at the end of the run duration/termination time.
+    },
+    "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+        # instance creation or while the instance isstopped and
+        # therefore, in a `TERMINATED` state. SeeInstance Life
+        # Cycle for more information on the possible instance states.
+    "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+        # Soft Off signal is triggered for Spot VMs only. If not specified,
+        # there will be no wait before the G2 Soft Off signal is triggered.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+    "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+        # Off and ACPI G3 Mechanical
+        # Off for Standard VMs and 30 seconds for Spot VMs.
+    "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+        # termination action will be performed at the termination time.
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "serviceAccounts": [ # A list of service accounts, with their specified scopes, authorized for
+      # this instance. Only one service account per VM instance is supported.
+      # 
+      # Service accounts generate access tokens that can be accessed
+      # through the metadata server and used to authenticate applications on the
+      # instance. SeeService Accounts
+      # for more information.
+    { # A service account.
+      "email": "A String", # Email address of the service account.
+      "scopes": [ # The list of scopes to be made available for this service account.
+        "A String",
+      ],
+    },
+  ],
+  "shieldedInstanceConfig": { # A set of Shielded Instance options.
+    "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+        # default.
+    "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+        # default.
+    "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+        # default.
+  },
+  "shieldedInstanceIntegrityPolicy": { # The policy describes the baseline against which
+      # Instance boot integrity is measured.
+    "updateAutoLearnPolicy": True or False, # Updates the integrity policy baseline using the
+        # measurements from the VM instance's most recent boot.
+  },
+  "sourceMachineImage": "A String", # Source machine image
+  "sourceMachineImageEncryptionKey": { # Source machine image encryption key when creating an instance from a
+      # machine image.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "startRestricted": True or False, # Output only. [Output Only] Whether a VM has been restricted for start because Compute
+      # Engine has detected suspicious activity.
+  "status": "A String", # Output only. [Output Only] The status of the instance. One of the
+      # following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the
+      # instance, see
+      # Instance life cycle.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "tags": { # A set of instance tags. # Tags to apply to this instance. Tags are used to identify valid
+      # sources or targets for network firewalls and are specified by the client
+      # during instance creation. The tags can be later modified by the setTags
+      # method. Each tag within the list must comply withRFC1035.
+      # Multiple tags can be specified via the 'tags.items' field.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the tags' contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update tags. You must always provide an
+        # up-to-date fingerprint hash in order to update or change tags.
+        #
+        # To see the latest fingerprint, make get() request to the
+        # instance.
+    "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+        # with RFC1035.
+      "A String",
+    ],
+  },
+  "workloadIdentityConfig": {
+    "identity": "A String",
+    "identityCertificateEnabled": True or False,
+  },
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instance resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  discardLocalSsd: boolean, Whether to discard local SSDs from the instance during restart
+default value is false.
+  minimalAction: string, Specifies the action to take when updating an instance even if the
+updated properties do not require it. If not specified, then
+Compute Engine acts based on the minimum action that the updated
+properties require.
+    Allowed values
+      INVALID - 
+      NO_EFFECT - No changes can be made to the instance.
+      REFRESH - The instance will not restart.
+      RESTART - The instance will restart, potentially on a different host.
+  mostDisruptiveAllowedAction: string, Specifies the most disruptive action that can be taken on the instance
+as part of the update. Compute Engine returns an error if the
+instance properties require a more disruptive action as part of the
+instance update. Valid options from lowest to highest are
+NO_EFFECT, REFRESH, and RESTART.
+    Allowed values
+      INVALID - 
+      NO_EFFECT - No changes can be made to the instance.
+      REFRESH - The instance will not restart.
+      RESTART - The instance will restart, potentially on a different host.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateAccessConfig(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None) + 
Updates the specified access config from an instance's network interface
+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)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  networkInterface: string, The name of the network interface where the access config is attached. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An access configuration attached to an instance's network interface.
+    # Only one access config per instance is supported.
+  "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+      # The first IPv6 address of the external IPv6 range associated
+      # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+      # use a static external IP address, it must be unused and in the same region
+      # as the instance's zone. If not specified, Google Cloud will automatically
+      # assign an external IPv6 address from the instance's subnetwork.
+  "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+      # external IPv6 range.
+  "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+  "name": "A String", # The name of this access configuration. In accessConfigs
+      # (IPv4), the default and recommended name is External NAT, but
+      # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+      # recommend name is External IPv6.
+  "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+      # address associated with this instance. Specify an unused static
+      # external IP address available to the project or leave this field undefined
+      # to use an IP from a shared ephemeral IP address pool. If you specify a
+      # static external IP address, it must live in the same region as the zone of
+      # the instance.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this access
+      # configuration and can only take the following values: PREMIUM,STANDARD.
+      # 
+      # If an AccessConfig is specified without a valid external IP address, an
+      # ephemeral IP will be created with this networkTier.
+      # 
+      # If an AccessConfig with a valid external IP address is specified, it must
+      # match that of the networkTier associated with the Address resource owning
+      # that IP.
+  "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+      # 
+      # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+      # first IP in associated external IPv6 range.
+  "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+      # config.
+  "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+      # external IP address of the instance to a DNS domain name.
+      # 
+      # This field is not used in ipv6AccessConfig. A default PTR
+      # record will be created if the VM has external IPv6 range associated.
+  "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+      # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateDisplayDevice(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Updates the Display config for a VM instance. You can
+only use this method on a stopped VM instance. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A set of Display Device options
+  "enableDisplay": True or False, # Defines whether the instance has Display enabled.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateNetworkInterface(project, zone, instance, networkInterface, body=None, requestId=None, x__xgafv=None) + 
Updates an instance's network interface. This method can only update an
+interface's alias IP range and attached network. See Modifying
+alias IP ranges for an existing instance for instructions on
+changing alias IP ranges. See Migrating
+a VM between networks for instructions on migrating an interface.
+This method follows PATCH semantics.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, The instance name for this request. (required)
+  networkInterface: string, The name of the network interface to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A network interface resource attached to an instance.
+  "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+      # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+      # no external internet access.
+    { # An access configuration attached to an instance's network interface.
+        # Only one access config per instance is supported.
+      "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+          # The first IPv6 address of the external IPv6 range associated
+          # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+          # use a static external IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an external IPv6 address from the instance's subnetwork.
+      "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+          # external IPv6 range.
+      "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+      "name": "A String", # The name of this access configuration. In accessConfigs
+          # (IPv4), the default and recommended name is External NAT, but
+          # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+          # recommend name is External IPv6.
+      "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+          # address associated with this instance. Specify an unused static
+          # external IP address available to the project or leave this field undefined
+          # to use an IP from a shared ephemeral IP address pool. If you specify a
+          # static external IP address, it must live in the same region as the zone of
+          # the instance.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this access
+          # configuration and can only take the following values: PREMIUM,STANDARD.
+          #
+          # If an AccessConfig is specified without a valid external IP address, an
+          # ephemeral IP will be created with this networkTier.
+          #
+          # If an AccessConfig with a valid external IP address is specified, it must
+          # match that of the networkTier associated with the Address resource owning
+          # that IP.
+      "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+          #
+          # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+          # first IP in associated external IPv6 range.
+      "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+          # config.
+      "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+          # external IP address of the instance to a DNS domain name.
+          #
+          # This field is not used in ipv6AccessConfig. A default PTR
+          # record will be created if the VM has external IPv6 range associated.
+      "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+          # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+    },
+  ],
+  "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+      # You can only specify this field for network interfaces in VPC networks.
+    { # An alias IP range attached to an instance's network interface.
+      "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+          # must belong to the specified subnetwork and cannot contain IP addresses
+          # reserved by system or used by other network interfaces. This range may be
+          # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+      "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+          # alias range. If not specified, the primary range of the subnetwork is used.
+    },
+  ],
+  "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+      # You can only specify this field for network interfaces in VPC networks.
+    { # An alias IP range attached to an instance's network interface.
+      "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+          # must belong to the specified subnetwork and cannot contain IP addresses
+          # reserved by system or used by other network interfaces. This range may be
+          # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+      "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+          # alias range. If not specified, the primary range of the subnetwork is used.
+    },
+  ],
+  "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+      # with network_attachment.
+  "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+      # This field will be ignored when inserting an Instance or
+      # adding a NetworkInterface. An up-to-date
+      # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+  "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+      # or not. If enabled, also indicates the version of IGMP supported.
+  "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+  "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+      # one IPv6 access config, DIRECT_IPV6, is supported. If there
+      # is no ipv6AccessConfig specified, then this instance will
+      # have no external IPv6 Internet access.
+    { # An access configuration attached to an instance's network interface.
+        # Only one access config per instance is supported.
+      "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+          # The first IPv6 address of the external IPv6 range associated
+          # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+          # use a static external IP address, it must be unused and in the same region
+          # as the instance's zone. If not specified, Google Cloud will automatically
+          # assign an external IPv6 address from the instance's subnetwork.
+      "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+          # external IPv6 range.
+      "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+      "name": "A String", # The name of this access configuration. In accessConfigs
+          # (IPv4), the default and recommended name is External NAT, but
+          # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+          # recommend name is External IPv6.
+      "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+          # address associated with this instance. Specify an unused static
+          # external IP address available to the project or leave this field undefined
+          # to use an IP from a shared ephemeral IP address pool. If you specify a
+          # static external IP address, it must live in the same region as the zone of
+          # the instance.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this access
+          # configuration and can only take the following values: PREMIUM,STANDARD.
+          #
+          # If an AccessConfig is specified without a valid external IP address, an
+          # ephemeral IP will be created with this networkTier.
+          #
+          # If an AccessConfig with a valid external IP address is specified, it must
+          # match that of the networkTier associated with the Address resource owning
+          # that IP.
+      "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+          #
+          # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+          # first IP in associated external IPv6 range.
+      "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+          # config.
+      "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+          # external IP address of the instance to a DNS domain name.
+          #
+          # This field is not used in ipv6AccessConfig. A default PTR
+          # record will be created if the VM has external IPv6 range associated.
+      "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+          # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+    },
+  ],
+  "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+      # accessed from the Internet. This field is always inherited from its
+      # subnetwork.
+      # 
+      # Valid only if stackType is IPV4_IPV6.
+  "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+      # use a static internal IP address, it must be unused and in the same region
+      # as the instance's zone. If not specified, Google Cloud will automatically
+      # assign an internal IPv6 address from the instance's subnetwork.
+  "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+  "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+      # server. For a VM, the network interface uses the nicN naming
+      # format. Where N is a value between 0 and7. The default interface value is nic0.
+  "network": "A String", # URL of the VPC network resource for this instance. When creating an
+      # instance, if neither the network nor the subnetwork is specified, the
+      # default network global/networks/default is used. If the
+      # selected project doesn't have the default network, you must specify a
+      # network or subnet. If the network is not specified but the subnetwork is
+      # specified, the network is inferred.
+      # 
+      # If you specify this property, you can specify the network as
+      # a full or partial URL. For example, the following are all valid URLs:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+      #       - projects/project/global/networks/network
+      #       - global/networks/default
+  "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+      # to in the following format:
+      # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+  "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+      # interface. If not specified by the user, an unused internal IP is
+      # assigned by the system.
+  "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+      # VirtioNet.
+  "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+  "queueCount": 42, # The networking queue count that's specified by users for the network
+      # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+      # if not specified by the users.
+  "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+      # interface. Can only be used with network_attachment. It is not possible to
+      # use on its own however, network_attachment can be used without
+      # service_class_id.
+  "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+      # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+      # 
+      # This field can be both set at instance creation and update network
+      # interface operations.
+  "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+      # resource is inlegacy
+      # mode, do not specify this field. If the network is in auto subnet
+      # mode, specifying the subnetwork is optional. If the network is in custom
+      # subnet mode, specifying the subnetwork is required. If you specify this
+      # field, you can specify the subnetwork as a full or partial URL. For
+      # example, the following are all valid URLs:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+      #    - regions/region/subnetworks/subnetwork
+  "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+      # from 2 to 255 inclusively.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateShieldedInstanceConfig(project, zone, instance, body=None, requestId=None, x__xgafv=None) + 
Updates the Shielded Instance config for an instance. You can
+only use this method on a stopped instance. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name or id of the instance scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A set of Shielded Instance options.
+  "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+      # default.
+  "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+      # default.
+  "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+      # default.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.instantSnapshotGroups.html b/docs/dyn/compute_preview.instantSnapshotGroups.html new file mode 100644 index 0000000000..b27b40f2ce --- /dev/null +++ b/docs/dyn/compute_preview.instantSnapshotGroups.html @@ -0,0 +1,2280 @@ + + + +

Compute Engine API . instantSnapshotGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, instantSnapshotGroup, requestId=None, x__xgafv=None)

+

deletes a Zonal InstantSnapshotGroup resource

+

+ get(project, zone, instantSnapshotGroup, x__xgafv=None)

+

returns the specified InstantSnapshotGroup resource in the specified zone.

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)

+

inserts a Zonal InstantSnapshotGroup resource

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

retrieves the list of InstantSnapshotGroup resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, instantSnapshotGroup, requestId=None, x__xgafv=None) + 
deletes a Zonal InstantSnapshotGroup resource
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instantSnapshotGroup: string, Name of the InstantSnapshot 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instantSnapshotGroup, x__xgafv=None) + 
returns the specified InstantSnapshotGroup resource in the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instantSnapshotGroup: string, Name of the InstantSnapshotGroup 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 an InstantSnapshotGroup resource.
+    #
+    # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+      # 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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": {
+    "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+    "sourceInfo": { # Output only. [Output Only]
+      "consistencyGroup": "A String",
+      "consistencyGroupId": "A String",
+    },
+  },
+  "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.
+  "sourceConsistencyGroup": "A String",
+  "status": "A String", # Output only. [Output Only]
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None) + 
inserts a Zonal InstantSnapshotGroup resource
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an InstantSnapshotGroup resource.
+    # 
+    # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+      # 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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": {
+    "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+    "sourceInfo": { # Output only. [Output Only]
+      "consistencyGroup": "A String",
+      "consistencyGroupId": "A String",
+    },
+  },
+  "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.
+  "sourceConsistencyGroup": "A String",
+  "status": "A String", # Output only. [Output Only]
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  sourceConsistencyGroup: string, begin_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
retrieves the list of InstantSnapshotGroup resources contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 InstantSnapshotGroup resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstantSnapshotGroup resources.
+    { # Represents an InstantSnapshotGroup resource.
+        #
+        # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+          # 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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "resourceStatus": {
+        "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+        "sourceInfo": { # Output only. [Output Only]
+          "consistencyGroup": "A String",
+          "consistencyGroupId": "A String",
+        },
+      },
+      "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.
+      "sourceConsistencyGroup": "A String",
+      "status": "A String", # Output only. [Output Only]
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#instantSnapshotGroupsList", # 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, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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, zone, 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)
+  zone: string, The name of the zone 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_preview.instantSnapshots.html b/docs/dyn/compute_preview.instantSnapshots.html new file mode 100644 index 0000000000..5ee5cf2c33 --- /dev/null +++ b/docs/dyn/compute_preview.instantSnapshots.html @@ -0,0 +1,3066 @@ + + + +

Compute Engine API . instantSnapshots

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of instantSnapshots.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, instantSnapshot, requestId=None, x__xgafv=None)

+

Deletes the specified InstantSnapshot resource. Keep in mind that deleting

+

+ get(project, zone, instantSnapshot, x__xgafv=None)

+

Returns the specified InstantSnapshot resource in the specified zone.

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates an instant snapshot in the specified zone.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of InstantSnapshot resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a instantSnapshot in the given zone. To learn more about

+

+ testIamPermissions(project, zone, 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of instantSnapshots.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of InstantSnapshotsScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of instantSnapshots.
+      "instantSnapshots": [ # [Output Only] A list of instantSnapshots contained in this scope.
+        { # Represents a InstantSnapshot resource.
+            #
+            # You can use instant snapshots to create disk rollback points quickly..
+          "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+              # ARM64 or X86_64.
+          "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.
+          "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+              # is essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a InstantSnapshot.
+          "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+              # the setLabels method.
+              # Label values may be empty.
+            "a_key": "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.
+          "params": { # Additional instant snapshot 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 instant 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/{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",
+            },
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+            "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+          },
+          "satisfiesPzi": True or False, # Output only. Reserved for future use.
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "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.
+          "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+              # Note that the source disk must be in the same zone/region as the
+              # instant snapshot to be created. This can be a full or valid partial URL.
+              # For example, the following are valid values:
+              #
+              #
+              #      -
+              #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+              #
+              #      -
+              #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+              #
+              #      -
+              #        projects/project/zones/zone/disks/disk
+              #
+              #      -
+              #        projects/project/regions/region/disks/disk
+              #
+              #      -
+              #        zones/zone/disks/disk
+              #
+              #      -
+              #        regions/region/disks/disk
+          "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+              # This value may be used to determine whether the InstantSnapshot
+              # was taken from the current or a previous instance of a given disk name.
+          "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+              # part of. Note that the source instant snapshot group must be in the same
+              # zone/region as the instant snapshot to be created. This can be a full or
+              # valid partial URL.
+          "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+              # InstantSnapshot is part of. This value may be used to determine whether the
+              # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+          "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+          "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of
+          # instantSnapshots 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#instantSnapshotAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of
+      # instantSnapshots.
+  "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, zone, instantSnapshot, requestId=None, x__xgafv=None) + 
Deletes the specified InstantSnapshot resource. Keep in mind that deleting
+a single instantSnapshot might not necessarily delete all the data on that
+instantSnapshot. If any data on the instantSnapshot that is marked for
+deletion is needed for subsequent instantSnapshots, the data will be moved
+to the next corresponding instantSnapshot.
+
+For more information, seeDeleting
+instantSnapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instantSnapshot: string, Name of the InstantSnapshot 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, instantSnapshot, x__xgafv=None) + 
Returns the specified InstantSnapshot resource in the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instantSnapshot: string, Name of the InstantSnapshot 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 InstantSnapshot resource.
+    #
+    # You can use instant snapshots to create disk rollback points quickly..
+  "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+      # ARM64 or X86_64.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a InstantSnapshot.
+  "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "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.
+  "params": { # Additional instant snapshot 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 instant 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+    "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "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.
+  "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+      # Note that the source disk must be in the same zone/region as the
+      # instant snapshot to be created. This can be a full or valid partial URL.
+      # For example, the following are valid values:
+      #
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        zones/zone/disks/disk
+      #
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+      # This value may be used to determine whether the InstantSnapshot
+      # was taken from the current or a previous instance of a given disk name.
+  "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+      # part of. Note that the source instant snapshot group must be in the same
+      # zone/region as the instant snapshot to be created. This can be a full or
+      # valid partial URL.
+  "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+      # InstantSnapshot is part of. This value may be used to determine whether the
+      # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+  "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, body=None, requestId=None, x__xgafv=None) + 
Creates an instant snapshot in the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a InstantSnapshot resource.
+    # 
+    # You can use instant snapshots to create disk rollback points quickly..
+  "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+      # ARM64 or X86_64.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a InstantSnapshot.
+  "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "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.
+  "params": { # Additional instant snapshot 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 instant 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+    "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "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.
+  "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+      # Note that the source disk must be in the same zone/region as the
+      # instant snapshot to be created. This can be a full or valid partial URL.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+      # This value may be used to determine whether the InstantSnapshot
+      # was taken from the current or a previous instance of a given disk name.
+  "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+      # part of. Note that the source instant snapshot group must be in the same
+      # zone/region as the instant snapshot to be created. This can be a full or
+      # valid partial URL.
+  "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+      # InstantSnapshot is part of. This value may be used to determine whether the
+      # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+  "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of InstantSnapshot resources contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 InstantSnapshot resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstantSnapshot resources.
+    { # Represents a InstantSnapshot resource.
+        #
+        # You can use instant snapshots to create disk rollback points quickly..
+      "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+          # ARM64 or X86_64.
+      "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.
+      "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a InstantSnapshot.
+      "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+          # the setLabels method.
+          # Label values may be empty.
+        "a_key": "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.
+      "params": { # Additional instant snapshot 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 instant 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/{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",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+        "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "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.
+      "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+          # Note that the source disk must be in the same zone/region as the
+          # instant snapshot to be created. This can be a full or valid partial URL.
+          # For example, the following are valid values:
+          #
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        zones/zone/disks/disk
+          #
+          #      -
+          #        regions/region/disks/disk
+      "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+          # This value may be used to determine whether the InstantSnapshot
+          # was taken from the current or a previous instance of a given disk name.
+      "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+          # part of. Note that the source instant snapshot group must be in the same
+          # zone/region as the instant snapshot to be created. This can be a full or
+          # valid partial URL.
+      "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+          # InstantSnapshot is part of. This value may be used to determine whether the
+          # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+      "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#instantSnapshotList", # 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.
+  "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, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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).
+}
+
+ +
+ setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a instantSnapshot in the given zone. To learn more about
+labels, read the Labeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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_preview.interconnectAttachmentGroups.html b/docs/dyn/compute_preview.interconnectAttachmentGroups.html new file mode 100644 index 0000000000..e55b532d45 --- /dev/null +++ b/docs/dyn/compute_preview.interconnectAttachmentGroups.html @@ -0,0 +1,3055 @@ + + + +

Compute Engine API . interconnectAttachmentGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, interconnectAttachmentGroup, requestId=None, x__xgafv=None)

+

Deletes the specified InterconnectAttachmentGroup in the given scope

+

+ get(project, interconnectAttachmentGroup, x__xgafv=None)

+

Returns the specified InterconnectAttachmentGroup resource in the given

+

+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getOperationalStatus(project, interconnectAttachmentGroup, x__xgafv=None)

+

Returns the InterconnectAttachmentStatuses for the specified

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a InterconnectAttachmentGroup in the specified project in the given

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the InterconnectAttachmentGroups for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, interconnectAttachmentGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patches the specified InterconnectAttachmentGroup resource with the data

+

+ 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, interconnectAttachmentGroup, requestId=None, x__xgafv=None) + 
Deletes the specified InterconnectAttachmentGroup in the given scope
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectAttachmentGroup: string, Name of the InterconnectAttachmentGroup 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, interconnectAttachmentGroup, x__xgafv=None) + 
Returns the specified InterconnectAttachmentGroup resource in the given
+scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectAttachmentGroup: string, Name of the InterconnectAttachmentGroup 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:
+
+    { # An interconnect attachment group resource allows customers to create,
+    # analyze, and expand highly available deployments.
+  "attachments": { # Attachments in the AttachmentGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Attachments per group" quota.
+    "a_key": { # An Attachment in this AttachmentGroup.
+      "attachment": "A String",
+    },
+  },
+  "configured": { # [Output Only] The redundancy this group is configured to support. The way a
+      # user queries what SLA their Attachment gets is by looking at this field of
+      # the Attachment's AttachmentGroup.
+    "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+        # group does or does not meet that SLA's requirements.
+      "effectiveSla": "A String",
+      "intendedSlaBlockers": [
+        { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+            # intent.availabilitySLA. This list is empty if and only if those are the
+            # same.
+          "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+              # blocker in more detail.
+            "A String",
+          ],
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". This will be set
+              # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+              # not apply to others.
+            "A String",
+          ],
+          "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+              # detail. These are region names formatted like "us-central1". This
+              # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+              # not apply to others.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Format is "zone1" and/or "zone2". This will be set for some blockers
+              # (like  MISSING_ZONE) but does not apply to others.
+            "A String",
+          ],
+        },
+      ],
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described byAIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this AttachmentGroup. This is the only required field
+      # besides the name that must be specified on group creation.
+    "availabilitySla": "A String",
+  },
+  "interconnectGroup": "A String", # The URL of an InterconnectGroup that groups these Attachments'
+      # Interconnects. Customers do not need to set this unless directed by
+      # Google Support.
+  "kind": "compute#interconnectAttachmentGroup", # Output only. [Output Only] Type of the resource. Always
+      # compute#interconnectAttachmentGroup.
+  "logicalStructure": { # [Output Only] An analysis of the logical layout of Attachments in this
+      # group. Every Attachment in the group is shown once in this structure.
+    "regions": [
+      { # [Output Only] The regions Attachments in this group are in.
+        "metros": [
+          { # [Output Only] The metros of Attachments in this group in this region.
+            "facilities": [
+              { # [Output Only] The facilities used for this group's Attachments'
+                  # Interconnects.
+                "facility": "A String", # Output only. [Output Only] The name of a facility, like "iad-1234".
+                "zones": [
+                  { # [Output Only] The zones that Attachments in this group are present
+                      # in, in the given facilities.  This is inherited from their
+                      # Interconnects.
+                    "attachments": [ # Output only. [Output Only] URLs of Attachments in the given zone, to the given
+                        # region, on Interconnects in the given facility and metro. Every
+                        # Attachment in the AG has such an entry.
+                      "A String",
+                    ],
+                    "zone": "A String", # Output only. [Output Only] The name of a zone, either "zone1" or "zone2".
+                  },
+                ],
+              },
+            ],
+            "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase
+                # string like "iad". This is the first component of the location of an
+                # Interconnect.
+          },
+        ],
+        "region": "A String", # Output only. [Output Only] The name of a region, like "us-central1".
+      },
+    ],
+  },
+  "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.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+}
+
+ +
+ 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).
+}
+
+ +
+ getOperationalStatus(project, interconnectAttachmentGroup, x__xgafv=None) + 
Returns the InterconnectAttachmentStatuses for the specified
+InterconnectAttachmentGroup resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectAttachmentGroup: string, Name of the interconnectAttachmentGroup resource to query. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse.
+  "etag": "A String",
+  "result": {
+    "attachmentStatuses": [
+      { # The status of one Attachment in the group. List order is arbitrary.
+        "adminEnabled": True or False, # Output only. Whether this Attachment is enabled. This becomes false when the customer
+            # drains their Attachment.
+        "attachment": "A String", # Output only. The URL of the Attachment being described.
+        "isActive": "A String", # Output only. Whether this Attachment is participating in the redundant configuration.
+            # This will be ACTIVE if and only if the status below is CONNECTION_UP.
+            # Any INACTIVE Attachments are excluded from the analysis that generates
+            # operational.availabilitySLA.
+        "status": "A String", # Output only. Whether this Attachment is active, and if so, whether BGP is up.
+      },
+    ],
+    "configured": { # [Output Only] The redundancy this group is configured to support. The way a
+        # user queries what SLA their Attachment gets is by looking at this field of
+        # the Attachment's AttachmentGroup.
+      "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+          # group does or does not meet that SLA's requirements.
+        "effectiveSla": "A String",
+        "intendedSlaBlockers": [
+          { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+              # intent.availabilitySLA. This list is empty if and only if those are the
+              # same.
+            "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+                # blocker in more detail.
+              "A String",
+            ],
+            "blockerType": "A String",
+            "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                # this requirement. This is set for every type of requirement.
+            "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                # why it's not met. This is set for every type of requirement.
+            "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                # These are three-letter lowercase strings like "iad". This will be set
+                # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+                # not apply to others.
+              "A String",
+            ],
+            "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+                # detail. These are region names formatted like "us-central1". This
+                # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+                # not apply to others.
+              "A String",
+            ],
+            "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                # Format is "zone1" and/or "zone2". This will be set for some blockers
+                # (like  MISSING_ZONE) but does not apply to others.
+              "A String",
+            ],
+          },
+        ],
+      },
+    },
+    "groupStatus": "A String", # Output only. Summarizes the status of the group.
+    "intent": { # The user's intent for this AttachmentGroup. This is the only required field
+        # besides the name that must be specified on group creation.
+      "availabilitySla": "A String",
+    },
+    "operational": { # [Output Only] The redundancy this group is configured to support. The way a # Output only. The operational state of the group, including only active Attachments.
+        # user queries what SLA their Attachment gets is by looking at this field of
+        # the Attachment's AttachmentGroup.
+      "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+          # group does or does not meet that SLA's requirements.
+        "effectiveSla": "A String",
+        "intendedSlaBlockers": [
+          { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+              # intent.availabilitySLA. This list is empty if and only if those are the
+              # same.
+            "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+                # blocker in more detail.
+              "A String",
+            ],
+            "blockerType": "A String",
+            "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                # this requirement. This is set for every type of requirement.
+            "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                # why it's not met. This is set for every type of requirement.
+            "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                # These are three-letter lowercase strings like "iad". This will be set
+                # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+                # not apply to others.
+              "A String",
+            ],
+            "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+                # detail. These are region names formatted like "us-central1". This
+                # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+                # not apply to others.
+              "A String",
+            ],
+            "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                # Format is "zone1" and/or "zone2". This will be set for some blockers
+                # (like  MISSING_ZONE) but does not apply to others.
+              "A String",
+            ],
+          },
+        ],
+      },
+    },
+  },
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a InterconnectAttachmentGroup in the specified project in the given
+scope using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An interconnect attachment group resource allows customers to create,
+    # analyze, and expand highly available deployments.
+  "attachments": { # Attachments in the AttachmentGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Attachments per group" quota.
+    "a_key": { # An Attachment in this AttachmentGroup.
+      "attachment": "A String",
+    },
+  },
+  "configured": { # [Output Only] The redundancy this group is configured to support. The way a
+      # user queries what SLA their Attachment gets is by looking at this field of
+      # the Attachment's AttachmentGroup.
+    "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+        # group does or does not meet that SLA's requirements.
+      "effectiveSla": "A String",
+      "intendedSlaBlockers": [
+        { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+            # intent.availabilitySLA. This list is empty if and only if those are the
+            # same.
+          "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+              # blocker in more detail.
+            "A String",
+          ],
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". This will be set
+              # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+              # not apply to others.
+            "A String",
+          ],
+          "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+              # detail. These are region names formatted like "us-central1". This
+              # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+              # not apply to others.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Format is "zone1" and/or "zone2". This will be set for some blockers
+              # (like  MISSING_ZONE) but does not apply to others.
+            "A String",
+          ],
+        },
+      ],
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described byAIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this AttachmentGroup. This is the only required field
+      # besides the name that must be specified on group creation.
+    "availabilitySla": "A String",
+  },
+  "interconnectGroup": "A String", # The URL of an InterconnectGroup that groups these Attachments'
+      # Interconnects. Customers do not need to set this unless directed by
+      # Google Support.
+  "kind": "compute#interconnectAttachmentGroup", # Output only. [Output Only] Type of the resource. Always
+      # compute#interconnectAttachmentGroup.
+  "logicalStructure": { # [Output Only] An analysis of the logical layout of Attachments in this
+      # group. Every Attachment in the group is shown once in this structure.
+    "regions": [
+      { # [Output Only] The regions Attachments in this group are in.
+        "metros": [
+          { # [Output Only] The metros of Attachments in this group in this region.
+            "facilities": [
+              { # [Output Only] The facilities used for this group's Attachments'
+                  # Interconnects.
+                "facility": "A String", # Output only. [Output Only] The name of a facility, like "iad-1234".
+                "zones": [
+                  { # [Output Only] The zones that Attachments in this group are present
+                      # in, in the given facilities.  This is inherited from their
+                      # Interconnects.
+                    "attachments": [ # Output only. [Output Only] URLs of Attachments in the given zone, to the given
+                        # region, on Interconnects in the given facility and metro. Every
+                        # Attachment in the AG has such an entry.
+                      "A String",
+                    ],
+                    "zone": "A String", # Output only. [Output Only] The name of a zone, either "zone1" or "zone2".
+                  },
+                ],
+              },
+            ],
+            "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase
+                # string like "iad". This is the first component of the location of an
+                # Interconnect.
+          },
+        ],
+        "region": "A String", # Output only. [Output Only] The name of a region, like "us-central1".
+      },
+    ],
+  },
+  "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.
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the InterconnectAttachmentGroups for a project in the given scope.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InterconnectAttachmentGroup resources.
+    { # An interconnect attachment group resource allows customers to create,
+        # analyze, and expand highly available deployments.
+      "attachments": { # Attachments in the AttachmentGroup. Keys are arbitrary user-specified
+          # strings. Users are encouraged, but not required, to use their preferred
+          # format for resource links as keys.
+          # Note that there are add-members and remove-members methods in gcloud.
+          # The size of this map is limited by an "Attachments per group" quota.
+        "a_key": { # An Attachment in this AttachmentGroup.
+          "attachment": "A String",
+        },
+      },
+      "configured": { # [Output Only] The redundancy this group is configured to support. The way a
+          # user queries what SLA their Attachment gets is by looking at this field of
+          # the Attachment's AttachmentGroup.
+        "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+            # group does or does not meet that SLA's requirements.
+          "effectiveSla": "A String",
+          "intendedSlaBlockers": [
+            { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+                # intent.availabilitySLA. This list is empty if and only if those are the
+                # same.
+              "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+                  # blocker in more detail.
+                "A String",
+              ],
+              "blockerType": "A String",
+              "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                  # this requirement. This is set for every type of requirement.
+              "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                  # why it's not met. This is set for every type of requirement.
+              "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                  # These are three-letter lowercase strings like "iad". This will be set
+                  # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+                  # not apply to others.
+                "A String",
+              ],
+              "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+                  # detail. These are region names formatted like "us-central1". This
+                  # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+                  # not apply to others.
+                "A String",
+              ],
+              "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                  # Format is "zone1" and/or "zone2". This will be set for some blockers
+                  # (like  MISSING_ZONE) but does not apply to others.
+                "A String",
+              ],
+            },
+          ],
+        },
+      },
+      "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.
+      "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+          # If provided when patching a configuration in update mode, the provided
+          # token must match the current token or the update is rejected. This provides
+          # a reliable means of doing read-modify-write (optimistic locking) as
+          # described byAIP 154.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "intent": { # The user's intent for this AttachmentGroup. This is the only required field
+          # besides the name that must be specified on group creation.
+        "availabilitySla": "A String",
+      },
+      "interconnectGroup": "A String", # The URL of an InterconnectGroup that groups these Attachments'
+          # Interconnects. Customers do not need to set this unless directed by
+          # Google Support.
+      "kind": "compute#interconnectAttachmentGroup", # Output only. [Output Only] Type of the resource. Always
+          # compute#interconnectAttachmentGroup.
+      "logicalStructure": { # [Output Only] An analysis of the logical layout of Attachments in this
+          # group. Every Attachment in the group is shown once in this structure.
+        "regions": [
+          { # [Output Only] The regions Attachments in this group are in.
+            "metros": [
+              { # [Output Only] The metros of Attachments in this group in this region.
+                "facilities": [
+                  { # [Output Only] The facilities used for this group's Attachments'
+                      # Interconnects.
+                    "facility": "A String", # Output only. [Output Only] The name of a facility, like "iad-1234".
+                    "zones": [
+                      { # [Output Only] The zones that Attachments in this group are present
+                          # in, in the given facilities.  This is inherited from their
+                          # Interconnects.
+                        "attachments": [ # Output only. [Output Only] URLs of Attachments in the given zone, to the given
+                            # region, on Interconnects in the given facility and metro. Every
+                            # Attachment in the AG has such an entry.
+                          "A String",
+                        ],
+                        "zone": "A String", # Output only. [Output Only] The name of a zone, either "zone1" or "zone2".
+                      },
+                    ],
+                  },
+                ],
+                "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase
+                    # string like "iad". This is the first component of the location of an
+                    # Interconnect.
+              },
+            ],
+            "region": "A String", # Output only. [Output Only] The name of a region, like "us-central1".
+          },
+        ],
+      },
+      "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.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    },
+  ],
+  "kind": "compute#interconnectAttachmentGroup",
+  "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.
+  "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.
+
+
+ +
+ patch(project, interconnectAttachmentGroup, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patches the specified InterconnectAttachmentGroup resource with the data
+included in the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectAttachmentGroup: string, Name of the InterconnectAttachmentGroup resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An interconnect attachment group resource allows customers to create,
+    # analyze, and expand highly available deployments.
+  "attachments": { # Attachments in the AttachmentGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Attachments per group" quota.
+    "a_key": { # An Attachment in this AttachmentGroup.
+      "attachment": "A String",
+    },
+  },
+  "configured": { # [Output Only] The redundancy this group is configured to support. The way a
+      # user queries what SLA their Attachment gets is by looking at this field of
+      # the Attachment's AttachmentGroup.
+    "availabilitySla": { # [Output Only] Which SLA this group is configured to support, and why this
+        # group does or does not meet that SLA's requirements.
+      "effectiveSla": "A String",
+      "intendedSlaBlockers": [
+        { # [Output Only] Reasons why configuration.availabilitySLA.sla differs from
+            # intent.availabilitySLA. This list is empty if and only if those are the
+            # same.
+          "attachments": [ # Output only. [Output Only] URLs of any particular Attachments to explain this
+              # blocker in more detail.
+            "A String",
+          ],
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". This will be set
+              # for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does
+              # not apply to others.
+            "A String",
+          ],
+          "regions": [ # Output only. [Output Only] Regions used to explain this blocker in more
+              # detail. These are region names formatted like "us-central1". This
+              # will be set for some blockers (like INCOMPATIBLE_REGIONS) but does
+              # not apply to others.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Format is "zone1" and/or "zone2". This will be set for some blockers
+              # (like  MISSING_ZONE) but does not apply to others.
+            "A String",
+          ],
+        },
+      ],
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described byAIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this AttachmentGroup. This is the only required field
+      # besides the name that must be specified on group creation.
+    "availabilitySla": "A String",
+  },
+  "interconnectGroup": "A String", # The URL of an InterconnectGroup that groups these Attachments'
+      # Interconnects. Customers do not need to set this unless directed by
+      # Google Support.
+  "kind": "compute#interconnectAttachmentGroup", # Output only. [Output Only] Type of the resource. Always
+      # compute#interconnectAttachmentGroup.
+  "logicalStructure": { # [Output Only] An analysis of the logical layout of Attachments in this
+      # group. Every Attachment in the group is shown once in this structure.
+    "regions": [
+      { # [Output Only] The regions Attachments in this group are in.
+        "metros": [
+          { # [Output Only] The metros of Attachments in this group in this region.
+            "facilities": [
+              { # [Output Only] The facilities used for this group's Attachments'
+                  # Interconnects.
+                "facility": "A String", # Output only. [Output Only] The name of a facility, like "iad-1234".
+                "zones": [
+                  { # [Output Only] The zones that Attachments in this group are present
+                      # in, in the given facilities.  This is inherited from their
+                      # Interconnects.
+                    "attachments": [ # Output only. [Output Only] URLs of Attachments in the given zone, to the given
+                        # region, on Interconnects in the given facility and metro. Every
+                        # Attachment in the AG has such an entry.
+                      "A String",
+                    ],
+                    "zone": "A String", # Output only. [Output Only] The name of a zone, either "zone1" or "zone2".
+                  },
+                ],
+              },
+            ],
+            "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase
+                # string like "iad". This is the first component of the location of an
+                # Interconnect.
+          },
+        ],
+        "region": "A String", # Output only. [Output Only] The name of a region, like "us-central1".
+      },
+    ],
+  },
+  "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.
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  updateMask: string, The list of fields to update.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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_preview.interconnectAttachments.html b/docs/dyn/compute_preview.interconnectAttachments.html new file mode 100644 index 0000000000..f7f99ec04e --- /dev/null +++ b/docs/dyn/compute_preview.interconnectAttachments.html @@ -0,0 +1,3599 @@ + + + +

Compute Engine API . interconnectAttachments

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of interconnect attachments.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, interconnectAttachment, requestId=None, x__xgafv=None)

+

Deletes the specified interconnect attachment.

+

+ get(project, region, interconnectAttachment, x__xgafv=None)

+

Returns the specified interconnect attachment.

+

+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates an InterconnectAttachment in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of interconnect attachments contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, interconnectAttachment, body=None, requestId=None, x__xgafv=None)

+

Updates the specified interconnect attachment with the data included in the

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on an InterconnectAttachment. To learn more about labels,

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of interconnect attachments.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of InterconnectAttachmentsScopedList resources.
+    "a_key": { # Name of the scope containing this set of interconnect attachments.
+      "interconnectAttachments": [ # A list of interconnect attachments contained in this scope.
+        { # Represents an Interconnect Attachment (VLAN) resource.
+            #
+            # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+            # Cloud networks to your on-premises networks through an Interconnect.
+            # For more information, read
+            # Creating VLAN Attachments.
+          "adminEnabled": True or False, # Determines whether this Attachment will carry packets.
+              # Not present for PARTNER_PROVIDER.
+          "attachmentGroup": "A String", # Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.
+          "bandwidth": "A String", # Provisioned bandwidth capacity for the interconnect attachment. For
+              # attachments of type DEDICATED, the user can set the bandwidth.
+              # For attachments of type PARTNER, the Google Partner that is operating
+              # the interconnect must set the bandwidth.
+              # Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,
+              # and can take one of the following values:
+              #
+              #    - BPS_50M: 50 Mbit/s
+              #    - BPS_100M: 100 Mbit/s
+              #    - BPS_200M: 200 Mbit/s
+              #    - BPS_300M: 300 Mbit/s
+              #    - BPS_400M: 400 Mbit/s
+              #    - BPS_500M: 500 Mbit/s
+              #    - BPS_1G: 1 Gbit/s
+              #    - BPS_2G: 2 Gbit/s
+              #    - BPS_5G: 5 Gbit/s
+              #    - BPS_10G: 10 Gbit/s
+              #    - BPS_20G: 20 Gbit/s
+              #    - BPS_50G: 50 Gbit/s
+              #    - BPS_100G: 100 Gbit/s
+              #    - BPS_400G: 400 Gbit/s
+          "candidateCloudRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the cloud router
+              # interface for this interconnect attachment.
+              #
+              #    - Both candidate_cloud_router_ip_address and
+              #    candidate_customer_router_ip_address fields must be set or both must be
+              #    unset.
+              #    - Prefix length of both candidate_cloud_router_ip_address and
+              #    candidate_customer_router_ip_address must be the same.
+              #    - Max prefix length is 31.
+          "candidateCloudRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the cloud router
+              # interface for this interconnect attachment.
+              #
+              #    - Both candidate_cloud_router_ipv6_address and
+              #    candidate_customer_router_ipv6_address fields must be set or both must be
+              #    unset.
+              #    - Prefix length of both candidate_cloud_router_ipv6_address and
+              #    candidate_customer_router_ipv6_address must be the same.
+              #    - Max prefix length is 126.
+          "candidateCustomerRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the customer router
+              # interface for this interconnect attachment.
+          "candidateCustomerRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the customer router
+              # interface for this interconnect attachment.
+          "candidateIpv6Subnets": [ # This field is not available.
+            "A String",
+          ],
+          "candidateSubnets": [ # Input only. Up to 16 candidate prefixes that can be used to restrict the allocation
+              # of cloudRouterIpAddress and customerRouterIpAddress for this attachment.
+              # All prefixes must be within link-local address space (169.254.0.0/16) and
+              # must be /29 or shorter (/28, /27, etc). Google will attempt to select an
+              # unused /29 from the supplied candidate prefix(es). The request will fail if
+              # all possible /29s are in use on Google's edge. If not supplied, Google will
+              # randomly select an unused /29 from all of link-local space.
+            "A String",
+          ],
+          "cloudRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router
+              # Interface for this interconnect attachment.
+          "cloudRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud
+              # Router Interface for this interconnect attachment.
+          "cloudRouterIpv6InterfaceId": "A String", # This field is not available.
+          "configurationConstraints": { # Output only. [Output Only] Constraints for this attachment, if any. The attachment does
+              # not work if these constraints are not met.
+            "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+                # requires/allows/disallows BGP MD5 authentication. This can take one of
+                # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+                #
+                # For example, a Cross-Cloud Interconnect connection to a remote cloud
+                # provider that requires BGP MD5 authentication has the
+                # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+                # field set to MD5_REQUIRED, and that property is propagated to the
+                # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+                # returned if MD5 is requested.
+            "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+                # support. Formatted as an array of inclusive ranges {min: min-value, max:
+                # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+                # allows the peer ASN to be 123 or anything in the range 64512-65534.
+                #
+                # This field is only advisory. Although the API accepts other ranges, these
+                # are the ranges that we recommend.
+              {
+                "max": 42,
+                "min": 42,
+              },
+            ],
+          },
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "customerRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on the customer
+              # router subinterface for this interconnect attachment.
+          "customerRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on the
+              # customer router subinterface for this interconnect attachment.
+          "customerRouterIpv6InterfaceId": "A String", # This field is not available.
+          "dataplaneVersion": 42, # Output only. [Output Only] Dataplane version for this InterconnectAttachment. This
+              # field is only present for Dataplane version 2 and higher. Absence of this
+              # field in the API output indicates that the Dataplane is version 1.
+          "description": "A String", # An optional description of this resource.
+          "edgeAvailabilityDomain": "A String", # Input only. Desired availability domain for the attachment. Only available for type
+              # PARTNER, at creation time, and can take one of the following values:
+              #
+              #    - AVAILABILITY_DOMAIN_ANY
+              #    - AVAILABILITY_DOMAIN_1
+              #    - AVAILABILITY_DOMAIN_2
+              #
+              #
+              # For improved reliability, customers should configure a pair of attachments,
+              # one per availability domain. The selected availability domain will be
+              # provided to the Partner via the pairing key, so that the provisioned
+              # circuit will lie in the specified domain. If not specified, the value will
+              # default to AVAILABILITY_DOMAIN_ANY.
+          "encryption": "A String", # Indicates the user-supplied encryption option of this VLAN attachment
+              # (interconnectAttachment). Can only be specified at attachment creation
+              # for PARTNER or DEDICATED attachments.
+              # Possible values are:
+              #
+              #    - NONE - This is the default value, which means that the
+              #    VLAN attachment carries unencrypted traffic. VMs are able to send
+              #    traffic to, or receive traffic from, such a VLAN attachment.
+              #    - IPSEC - The VLAN attachment carries only encrypted
+              #    traffic that is encrypted by an IPsec device, such as an HA VPN gateway or
+              #    third-party IPsec VPN. VMs cannot directly send traffic to, or receive
+              #    traffic from, such a VLAN attachment. To use *HA VPN over Cloud
+              #    Interconnect*, the VLAN attachment must be created with this
+              #    option.
+          "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID, to be used when raising support tickets
+              # with Google or otherwise to debug backend connectivity issues.
+              # [Deprecated] This field is not used.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "interconnect": "A String", # URL of the underlying Interconnect object that this attachment's traffic
+              # will traverse through.
+          "ipsecInternalAddresses": [ # A list of URLs of addresses that have been reserved for the VLAN
+              # attachment. Used only for the VLAN attachment that has the encryption
+              # option as IPSEC. The addresses must be regional internal IP address ranges.
+              # When creating an HA VPN gateway over the VLAN attachment, if the attachment
+              # is configured to use a regional internal IP address, then the VPN gateway's
+              # IP address is allocated from the IP address range specified here. For
+              # example, if the HA VPN gateway's interface 0 is paired to this VLAN
+              # attachment, then a regional internal IP address for the VPN gateway
+              # interface 0 will be allocated from the IP address specified for this
+              # VLAN attachment.
+              # If this field is not specified when creating the VLAN attachment, then
+              # later on when creating an HA VPN gateway on this VLAN attachment, the HA
+              # VPN gateway's IP address is allocated from the regional external IP address
+              # pool.
+            "A String",
+          ],
+          "kind": "compute#interconnectAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.
+          "l2Forwarding": { # L2 Interconnect Attachment related configuration. # L2 Interconnect Attachment related config. This field is required if the
+              # type is L2_DEDICATED.
+              #
+              # The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)
+              # within L2 packets are mapped to the destination appliances IP addresses.
+              # The packet is then encapsulated with the appliance IP address and sent to
+              # the edge appliance.
+            "applianceMappings": { # Optional. A map of VLAN tags to appliances and optional inner mapping
+                # rules. If VLANs are not explicitly mapped to any appliance, the
+                # defaultApplianceIpAddress is used.
+                #
+                # Each VLAN tag can be a single number or a range of numbers in the range
+                # of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping
+                # VLAN tag ranges are enforced, and violating operations will be rejected.
+                #
+                # The VLAN tags in the Ethernet header must use an ethertype value of
+                # 0x88A8 or 0x8100.
+              "a_key": { # Two-level VLAN-to-Appliance mapping rule.
+                "applianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the destination IP
+                    # address for ingress packets that match on a VLAN tag, but do not match
+                    # a more specific inner VLAN tag.
+                    #
+                    # Unset field (null-value) indicates both VLAN tags are required to be
+                    # mapped. Otherwise, defaultApplianceIpAddress is used.
+                "innerVlanToApplianceMappings": [ # Optional. Used to match against the inner VLAN when the packet
+                    # contains two VLAN tags.
+                    #
+                    # A list of mapping rules from inner VLAN tags to IP addresses. If the
+                    # inner VLAN is not explicitly mapped to an IP address range, the
+                    # applianceIpAddress is used.
+                  { # The inner VLAN-to-Appliance mapping.
+                    "innerApplianceIpAddress": "A String", # Required in this object. A single IPv4 or IPv6 address used as the
+                        # destination IP address for ingress packets that match on both VLAN
+                        # tags.
+                    "innerVlanTags": [ # Required in this object. Used to match the inner VLAN tag on the
+                        # packet. Each entry can be a single number or a range of numbers in
+                        # the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty
+                        # and Non-overlapping VLAN tag ranges are enforced, and violating
+                        # operations will be rejected.
+                        #
+                        # The inner VLAN tags must have an ethertype value of 0x8100.
+                      "A String",
+                    ],
+                  },
+                ],
+                "name": "A String", # Optional. The name of this appliance mapping rule.
+              },
+            },
+            "defaultApplianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the default destination
+                # IP when there is no VLAN mapping result found.
+                #
+                # Unset field (null-value) indicates the unmatched packet should be
+                # dropped.
+            "geneveHeader": { # GeneveHeader related configurations. # Optional. It represents the structure of a Geneve (Generic Network
+                # Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various
+                # protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization
+                # environments.
+              "vni": 42, # Optional. VNI is a 24-bit unique virtual network identifier, from 0 to
+                  # 16,777,215.
+            },
+            "network": "A String", # Required. Resource URL of the network to which this attachment belongs.
+            "tunnelEndpointIpAddress": "A String", # Required. A single IPv4 or IPv6 address. This address will be used as the
+                # source IP address for packets sent to the appliances, and must be used as
+                # the destination IP address for packets that should be sent out through
+                # this attachment.
+          },
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InterconnectAttachment,
+              # which is essentially a hash of the labels set used for optimistic locking.
+              # The fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve an InterconnectAttachment.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "A String",
+          },
+          "mtu": 42, # Maximum Transmission Unit (MTU), in bytes, of packets passing through this
+              # interconnect attachment.
+              # Valid values are 1440, 1460, 1500, and 8896. If not specified,
+              # the value will default to 1440.
+          "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.
+          "operationalStatus": "A String", # Output only. [Output Only] The current status of whether or not this interconnect
+              # attachment is functional, which can take one of the following values:
+              #
+              #    - OS_ACTIVE: The attachment has been turned up and is ready to
+              #    use.
+              #    - OS_UNPROVISIONED: The attachment is not ready to use yet,
+              #    because turnup is not complete.
+          "pairingKey": "A String", # [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not
+              # present for DEDICATED].
+              # The opaque identifier of a PARTNER attachment used to initiate
+              # provisioning with a selected partner.
+              # Of the form "XXXXX/region/domain"
+          "params": { # Additional interconnect attachment 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.
+                # 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",
+            },
+          },
+          "partnerAsn": "A String", # Optional BGP ASN for the router supplied by a Layer 3 Partner if they
+              # configured BGP on behalf of the customer.
+              # Output only for PARTNER type, input only for PARTNER_PROVIDER, not
+              # available for DEDICATED.
+          "partnerMetadata": { # Informational metadata about Partner attachments from Partners to display # Informational metadata about Partner attachments from Partners to display
+              # to customers.
+              # Output only for PARTNER type, mutable for PARTNER_PROVIDER, not
+              # available for DEDICATED.
+              # to customers.  These fields are propagated from PARTNER_PROVIDER
+              # attachments to their corresponding PARTNER attachments.
+            "interconnectName": "A String", # Plain text name of the Interconnect this attachment is connected to, as
+                # displayed in the Partner's portal. For instance "Chicago 1".
+                # This value may be validated to match approved Partner values.
+            "partnerName": "A String", # Plain text name of the Partner providing this attachment.
+                # This value may be validated to match approved Partner values.
+            "portalUrl": "A String", # URL of the Partner's portal for this Attachment. Partners may customise
+                # this to be a deep link to the specific resource on the Partner portal.
+                # This value may be validated to match approved Partner values.
+          },
+          "privateInterconnectInfo": { # Information for an interconnect attachment when this belongs to an # Output only. [Output Only] Information specific to an InterconnectAttachment.
+              # This property is populated if the interconnect that
+              # this is attached to is of type DEDICATED.
+              # interconnect of type DEDICATED.
+            "tag8021q": 42, # [Output Only] 802.1q encapsulation tag to be used for traffic between
+                # Google and the customer, going to and from this network and region.
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional interconnect attachment
+              # resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "remoteService": "A String", # Output only. [Output Only]
+              # If the attachment is on a Cross-Cloud Interconnect connection, this field
+              # contains the interconnect's remote location service provider. Example
+              # values: "Amazon Web Services" "Microsoft Azure".
+              #
+              # The field is set only for attachments on Cross-Cloud Interconnect
+              # connections. Its value is copied from the InterconnectRemoteLocation
+              # remoteService field.
+          "router": "A String", # URL of the Cloud Router to be used for dynamic routing. This router must be
+              # in the same region as this InterconnectAttachment. The
+              # InterconnectAttachment will automatically connect the Interconnect to the
+              # network & region within which the Cloud Router is configured.
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "stackType": "A String", # The stack type for this interconnect attachment to identify whether the
+              # IPv6 feature is enabled or not. If not specified, IPV4_ONLY
+              # will be used.
+              #
+              # This field can be both set at interconnect attachments creation and
+              # update interconnect attachment operations.
+          "state": "A String", # Output only. [Output Only] The current state of this attachment's functionality.
+              # Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,
+              # PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values
+              # PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used
+              # for only PARTNER and PARTNER_PROVIDER interconnect attachments.
+              # This state can take one of the following values:
+              #
+              #    - ACTIVE: The attachment has been turned up and is ready to use.
+              #    - UNPROVISIONED: The attachment is not ready to use yet, because turnup
+              #    is not complete.
+              #    - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet
+              #    been configured on the Partner side.
+              #    - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of
+              #    provisioning after a PARTNER_PROVIDER attachment was created that
+              #    references it.
+              #    - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER
+              #    attachment that is waiting for a customer to activate it.
+              #    - DEFUNCT:
+              #    The attachment was deleted externally and is no longer functional. This
+              #    could be because the associated Interconnect was removed, or because the
+              #    other side of a Partner attachment was deleted.
+          "subnetLength": 42, # Input only. Length of the IPv4 subnet mask.
+              # Allowed values:
+              #
+              #
+              #     - 29 (default)
+              #     - 30
+              #
+              # The default value is 29, except for Cross-Cloud Interconnect
+              # connections that use an InterconnectRemoteLocation with a
+              # constraints.subnetLengthRange.min equal to 30. For example,
+              # connections that use an Azure remote location fall into this
+              # category. In these cases, the default value is 30, and requesting
+              # 29 returns an error.
+              #
+              # Where both 29 and 30 are allowed, 29 is preferred, because it gives
+              # Google Cloud Support more debugging visibility.
+          "type": "A String", # The type of interconnect attachment this is, which can take one of the
+              # following values:
+              #
+              #    - DEDICATED: an attachment to a Dedicated Interconnect.
+              #    - PARTNER: an attachment to a Partner Interconnect, created by the
+              #    customer.
+              #    - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by
+              #    the partner.
+              #
+              # - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.
+          "vlanTag8021q": 42, # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.
+              # Only specified at creation time.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of addresses 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#interconnectAttachmentAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated
+      # lists of interconnect attachments.
+  "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, interconnectAttachment, requestId=None, x__xgafv=None) + 
Deletes the specified interconnect attachment.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  interconnectAttachment: string, Name of the interconnect attachment 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, interconnectAttachment, x__xgafv=None) + 
Returns the specified interconnect attachment.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  interconnectAttachment: string, Name of the interconnect attachment 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 an Interconnect Attachment (VLAN) resource.
+    #
+    # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+    # Cloud networks to your on-premises networks through an Interconnect.
+    # For more information, read
+    # Creating VLAN Attachments.
+  "adminEnabled": True or False, # Determines whether this Attachment will carry packets.
+      # Not present for PARTNER_PROVIDER.
+  "attachmentGroup": "A String", # Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.
+  "bandwidth": "A String", # Provisioned bandwidth capacity for the interconnect attachment. For
+      # attachments of type DEDICATED, the user can set the bandwidth.
+      # For attachments of type PARTNER, the Google Partner that is operating
+      # the interconnect must set the bandwidth.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,
+      # and can take one of the following values:
+      #
+      #    - BPS_50M: 50 Mbit/s
+      #    - BPS_100M: 100 Mbit/s
+      #    - BPS_200M: 200 Mbit/s
+      #    - BPS_300M: 300 Mbit/s
+      #    - BPS_400M: 400 Mbit/s
+      #    - BPS_500M: 500 Mbit/s
+      #    - BPS_1G: 1 Gbit/s
+      #    - BPS_2G: 2 Gbit/s
+      #    - BPS_5G: 5 Gbit/s
+      #    - BPS_10G: 10 Gbit/s
+      #    - BPS_20G: 20 Gbit/s
+      #    - BPS_50G: 50 Gbit/s
+      #    - BPS_100G: 100 Gbit/s
+      #    - BPS_400G: 400 Gbit/s
+  "candidateCloudRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      #
+      #    - Both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address must be the same.
+      #    - Max prefix length is 31.
+  "candidateCloudRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      #
+      #    - Both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address must be the same.
+      #    - Max prefix length is 126.
+  "candidateCustomerRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateCustomerRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateIpv6Subnets": [ # This field is not available.
+    "A String",
+  ],
+  "candidateSubnets": [ # Input only. Up to 16 candidate prefixes that can be used to restrict the allocation
+      # of cloudRouterIpAddress and customerRouterIpAddress for this attachment.
+      # All prefixes must be within link-local address space (169.254.0.0/16) and
+      # must be /29 or shorter (/28, /27, etc). Google will attempt to select an
+      # unused /29 from the supplied candidate prefix(es). The request will fail if
+      # all possible /29s are in use on Google's edge. If not supplied, Google will
+      # randomly select an unused /29 from all of link-local space.
+    "A String",
+  ],
+  "cloudRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router
+      # Interface for this interconnect attachment.
+  "cloudRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud
+      # Router Interface for this interconnect attachment.
+  "cloudRouterIpv6InterfaceId": "A String", # This field is not available.
+  "configurationConstraints": { # Output only. [Output Only] Constraints for this attachment, if any. The attachment does
+      # not work if these constraints are not met.
+    "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+        # requires/allows/disallows BGP MD5 authentication. This can take one of
+        # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+        #
+        # For example, a Cross-Cloud Interconnect connection to a remote cloud
+        # provider that requires BGP MD5 authentication has the
+        # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+        # field set to MD5_REQUIRED, and that property is propagated to the
+        # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+        # returned if MD5 is requested.
+    "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+        # support. Formatted as an array of inclusive ranges {min: min-value, max:
+        # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+        # allows the peer ASN to be 123 or anything in the range 64512-65534.
+        #
+        # This field is only advisory. Although the API accepts other ranges, these
+        # are the ranges that we recommend.
+      {
+        "max": 42,
+        "min": 42,
+      },
+    ],
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on the customer
+      # router subinterface for this interconnect attachment.
+  "customerRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on the
+      # customer router subinterface for this interconnect attachment.
+  "customerRouterIpv6InterfaceId": "A String", # This field is not available.
+  "dataplaneVersion": 42, # Output only. [Output Only] Dataplane version for this InterconnectAttachment. This
+      # field is only present for Dataplane version 2 and higher. Absence of this
+      # field in the API output indicates that the Dataplane is version 1.
+  "description": "A String", # An optional description of this resource.
+  "edgeAvailabilityDomain": "A String", # Input only. Desired availability domain for the attachment. Only available for type
+      # PARTNER, at creation time, and can take one of the following values:
+      #
+      #    - AVAILABILITY_DOMAIN_ANY
+      #    - AVAILABILITY_DOMAIN_1
+      #    - AVAILABILITY_DOMAIN_2
+      #
+      #
+      # For improved reliability, customers should configure a pair of attachments,
+      # one per availability domain. The selected availability domain will be
+      # provided to the Partner via the pairing key, so that the provisioned
+      # circuit will lie in the specified domain. If not specified, the value will
+      # default to AVAILABILITY_DOMAIN_ANY.
+  "encryption": "A String", # Indicates the user-supplied encryption option of this VLAN attachment
+      # (interconnectAttachment). Can only be specified at attachment creation
+      # for PARTNER or DEDICATED attachments.
+      # Possible values are:
+      #
+      #    - NONE - This is the default value, which means that the
+      #    VLAN attachment carries unencrypted traffic. VMs are able to send
+      #    traffic to, or receive traffic from, such a VLAN attachment.
+      #    - IPSEC - The VLAN attachment carries only encrypted
+      #    traffic that is encrypted by an IPsec device, such as an HA VPN gateway or
+      #    third-party IPsec VPN. VMs cannot directly send traffic to, or receive
+      #    traffic from, such a VLAN attachment. To use *HA VPN over Cloud
+      #    Interconnect*, the VLAN attachment must be created with this
+      #    option.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID, to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+      # [Deprecated] This field is not used.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnect": "A String", # URL of the underlying Interconnect object that this attachment's traffic
+      # will traverse through.
+  "ipsecInternalAddresses": [ # A list of URLs of addresses that have been reserved for the VLAN
+      # attachment. Used only for the VLAN attachment that has the encryption
+      # option as IPSEC. The addresses must be regional internal IP address ranges.
+      # When creating an HA VPN gateway over the VLAN attachment, if the attachment
+      # is configured to use a regional internal IP address, then the VPN gateway's
+      # IP address is allocated from the IP address range specified here. For
+      # example, if the HA VPN gateway's interface 0 is paired to this VLAN
+      # attachment, then a regional internal IP address for the VPN gateway
+      # interface 0 will be allocated from the IP address specified for this
+      # VLAN attachment.
+      # If this field is not specified when creating the VLAN attachment, then
+      # later on when creating an HA VPN gateway on this VLAN attachment, the HA
+      # VPN gateway's IP address is allocated from the regional external IP address
+      # pool.
+    "A String",
+  ],
+  "kind": "compute#interconnectAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.
+  "l2Forwarding": { # L2 Interconnect Attachment related configuration. # L2 Interconnect Attachment related config. This field is required if the
+      # type is L2_DEDICATED.
+      #
+      # The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)
+      # within L2 packets are mapped to the destination appliances IP addresses.
+      # The packet is then encapsulated with the appliance IP address and sent to
+      # the edge appliance.
+    "applianceMappings": { # Optional. A map of VLAN tags to appliances and optional inner mapping
+        # rules. If VLANs are not explicitly mapped to any appliance, the
+        # defaultApplianceIpAddress is used.
+        #
+        # Each VLAN tag can be a single number or a range of numbers in the range
+        # of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping
+        # VLAN tag ranges are enforced, and violating operations will be rejected.
+        #
+        # The VLAN tags in the Ethernet header must use an ethertype value of
+        # 0x88A8 or 0x8100.
+      "a_key": { # Two-level VLAN-to-Appliance mapping rule.
+        "applianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the destination IP
+            # address for ingress packets that match on a VLAN tag, but do not match
+            # a more specific inner VLAN tag.
+            #
+            # Unset field (null-value) indicates both VLAN tags are required to be
+            # mapped. Otherwise, defaultApplianceIpAddress is used.
+        "innerVlanToApplianceMappings": [ # Optional. Used to match against the inner VLAN when the packet
+            # contains two VLAN tags.
+            #
+            # A list of mapping rules from inner VLAN tags to IP addresses. If the
+            # inner VLAN is not explicitly mapped to an IP address range, the
+            # applianceIpAddress is used.
+          { # The inner VLAN-to-Appliance mapping.
+            "innerApplianceIpAddress": "A String", # Required in this object. A single IPv4 or IPv6 address used as the
+                # destination IP address for ingress packets that match on both VLAN
+                # tags.
+            "innerVlanTags": [ # Required in this object. Used to match the inner VLAN tag on the
+                # packet. Each entry can be a single number or a range of numbers in
+                # the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty
+                # and Non-overlapping VLAN tag ranges are enforced, and violating
+                # operations will be rejected.
+                #
+                # The inner VLAN tags must have an ethertype value of 0x8100.
+              "A String",
+            ],
+          },
+        ],
+        "name": "A String", # Optional. The name of this appliance mapping rule.
+      },
+    },
+    "defaultApplianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the default destination
+        # IP when there is no VLAN mapping result found.
+        #
+        # Unset field (null-value) indicates the unmatched packet should be
+        # dropped.
+    "geneveHeader": { # GeneveHeader related configurations. # Optional. It represents the structure of a Geneve (Generic Network
+        # Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various
+        # protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization
+        # environments.
+      "vni": 42, # Optional. VNI is a 24-bit unique virtual network identifier, from 0 to
+          # 16,777,215.
+    },
+    "network": "A String", # Required. Resource URL of the network to which this attachment belongs.
+    "tunnelEndpointIpAddress": "A String", # Required. A single IPv4 or IPv6 address. This address will be used as the
+        # source IP address for packets sent to the appliances, and must be used as
+        # the destination IP address for packets that should be sent out through
+        # this attachment.
+  },
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InterconnectAttachment,
+      # which is essentially a hash of the labels set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InterconnectAttachment.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "mtu": 42, # Maximum Transmission Unit (MTU), in bytes, of packets passing through this
+      # interconnect attachment.
+      # Valid values are 1440, 1460, 1500, and 8896. If not specified,
+      # the value will default to 1440.
+  "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.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of whether or not this interconnect
+      # attachment is functional, which can take one of the following values:
+      #
+      #    - OS_ACTIVE: The attachment has been turned up and is ready to
+      #    use.
+      #    - OS_UNPROVISIONED: The attachment is not ready to use yet,
+      #    because turnup is not complete.
+  "pairingKey": "A String", # [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not
+      # present for DEDICATED].
+      # The opaque identifier of a PARTNER attachment used to initiate
+      # provisioning with a selected partner.
+      # Of the form "XXXXX/region/domain"
+  "params": { # Additional interconnect attachment 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.
+        # 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",
+    },
+  },
+  "partnerAsn": "A String", # Optional BGP ASN for the router supplied by a Layer 3 Partner if they
+      # configured BGP on behalf of the customer.
+      # Output only for PARTNER type, input only for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+  "partnerMetadata": { # Informational metadata about Partner attachments from Partners to display # Informational metadata about Partner attachments from Partners to display
+      # to customers.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+      # to customers.  These fields are propagated from PARTNER_PROVIDER
+      # attachments to their corresponding PARTNER attachments.
+    "interconnectName": "A String", # Plain text name of the Interconnect this attachment is connected to, as
+        # displayed in the Partner's portal. For instance "Chicago 1".
+        # This value may be validated to match approved Partner values.
+    "partnerName": "A String", # Plain text name of the Partner providing this attachment.
+        # This value may be validated to match approved Partner values.
+    "portalUrl": "A String", # URL of the Partner's portal for this Attachment. Partners may customise
+        # this to be a deep link to the specific resource on the Partner portal.
+        # This value may be validated to match approved Partner values.
+  },
+  "privateInterconnectInfo": { # Information for an interconnect attachment when this belongs to an # Output only. [Output Only] Information specific to an InterconnectAttachment.
+      # This property is populated if the interconnect that
+      # this is attached to is of type DEDICATED.
+      # interconnect of type DEDICATED.
+    "tag8021q": 42, # [Output Only] 802.1q encapsulation tag to be used for traffic between
+        # Google and the customer, going to and from this network and region.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional interconnect attachment
+      # resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "remoteService": "A String", # Output only. [Output Only]
+      # If the attachment is on a Cross-Cloud Interconnect connection, this field
+      # contains the interconnect's remote location service provider. Example
+      # values: "Amazon Web Services" "Microsoft Azure".
+      #
+      # The field is set only for attachments on Cross-Cloud Interconnect
+      # connections. Its value is copied from the InterconnectRemoteLocation
+      # remoteService field.
+  "router": "A String", # URL of the Cloud Router to be used for dynamic routing. This router must be
+      # in the same region as this InterconnectAttachment. The
+      # InterconnectAttachment will automatically connect the Interconnect to the
+      # network & region within which the Cloud Router is configured.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for this interconnect attachment to identify whether the
+      # IPv6 feature is enabled or not. If not specified, IPV4_ONLY
+      # will be used.
+      #
+      # This field can be both set at interconnect attachments creation and
+      # update interconnect attachment operations.
+  "state": "A String", # Output only. [Output Only] The current state of this attachment's functionality.
+      # Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,
+      # PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values
+      # PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used
+      # for only PARTNER and PARTNER_PROVIDER interconnect attachments.
+      # This state can take one of the following values:
+      #
+      #    - ACTIVE: The attachment has been turned up and is ready to use.
+      #    - UNPROVISIONED: The attachment is not ready to use yet, because turnup
+      #    is not complete.
+      #    - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet
+      #    been configured on the Partner side.
+      #    - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of
+      #    provisioning after a PARTNER_PROVIDER attachment was created that
+      #    references it.
+      #    - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER
+      #    attachment that is waiting for a customer to activate it.
+      #    - DEFUNCT:
+      #    The attachment was deleted externally and is no longer functional. This
+      #    could be because the associated Interconnect was removed, or because the
+      #    other side of a Partner attachment was deleted.
+  "subnetLength": 42, # Input only. Length of the IPv4 subnet mask.
+      # Allowed values:
+      #
+      #
+      #     - 29 (default)
+      #     - 30
+      #
+      # The default value is 29, except for Cross-Cloud Interconnect
+      # connections that use an InterconnectRemoteLocation with a
+      # constraints.subnetLengthRange.min equal to 30. For example,
+      # connections that use an Azure remote location fall into this
+      # category. In these cases, the default value is 30, and requesting
+      # 29 returns an error.
+      #
+      # Where both 29 and 30 are allowed, 29 is preferred, because it gives
+      # Google Cloud Support more debugging visibility.
+  "type": "A String", # The type of interconnect attachment this is, which can take one of the
+      # following values:
+      #
+      #    - DEDICATED: an attachment to a Dedicated Interconnect.
+      #    - PARTNER: an attachment to a Partner Interconnect, created by the
+      #    customer.
+      #    - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by
+      #    the partner.
+      #
+      # - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.
+  "vlanTag8021q": 42, # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.
+      # Only specified at creation time.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates an InterconnectAttachment in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Interconnect Attachment (VLAN) resource.
+    # 
+    # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+    # Cloud networks to your on-premises networks through an Interconnect.
+    # For more information, read
+    # Creating VLAN Attachments.
+  "adminEnabled": True or False, # Determines whether this Attachment will carry packets.
+      # Not present for PARTNER_PROVIDER.
+  "attachmentGroup": "A String", # Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.
+  "bandwidth": "A String", # Provisioned bandwidth capacity for the interconnect attachment. For
+      # attachments of type DEDICATED, the user can set the bandwidth.
+      # For attachments of type PARTNER, the Google Partner that is operating
+      # the interconnect must set the bandwidth.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,
+      # and can take one of the following values:
+      # 
+      #    - BPS_50M: 50 Mbit/s
+      #    - BPS_100M: 100 Mbit/s
+      #    - BPS_200M: 200 Mbit/s
+      #    - BPS_300M: 300 Mbit/s
+      #    - BPS_400M: 400 Mbit/s
+      #    - BPS_500M: 500 Mbit/s
+      #    - BPS_1G: 1 Gbit/s
+      #    - BPS_2G: 2 Gbit/s
+      #    - BPS_5G: 5 Gbit/s
+      #    - BPS_10G: 10 Gbit/s
+      #    - BPS_20G: 20 Gbit/s
+      #    - BPS_50G: 50 Gbit/s
+      #    - BPS_100G: 100 Gbit/s
+      #    - BPS_400G: 400 Gbit/s
+  "candidateCloudRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      # 
+      #    - Both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address must be the same.
+      #    - Max prefix length is 31.
+  "candidateCloudRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      # 
+      #    - Both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address must be the same.
+      #    - Max prefix length is 126.
+  "candidateCustomerRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateCustomerRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateIpv6Subnets": [ # This field is not available.
+    "A String",
+  ],
+  "candidateSubnets": [ # Input only. Up to 16 candidate prefixes that can be used to restrict the allocation
+      # of cloudRouterIpAddress and customerRouterIpAddress for this attachment.
+      # All prefixes must be within link-local address space (169.254.0.0/16) and
+      # must be /29 or shorter (/28, /27, etc). Google will attempt to select an
+      # unused /29 from the supplied candidate prefix(es). The request will fail if
+      # all possible /29s are in use on Google's edge. If not supplied, Google will
+      # randomly select an unused /29 from all of link-local space.
+    "A String",
+  ],
+  "cloudRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router
+      # Interface for this interconnect attachment.
+  "cloudRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud
+      # Router Interface for this interconnect attachment.
+  "cloudRouterIpv6InterfaceId": "A String", # This field is not available.
+  "configurationConstraints": { # Output only. [Output Only] Constraints for this attachment, if any. The attachment does
+      # not work if these constraints are not met.
+    "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+        # requires/allows/disallows BGP MD5 authentication. This can take one of
+        # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+        #
+        # For example, a Cross-Cloud Interconnect connection to a remote cloud
+        # provider that requires BGP MD5 authentication has the
+        # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+        # field set to MD5_REQUIRED, and that property is propagated to the
+        # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+        # returned if MD5 is requested.
+    "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+        # support. Formatted as an array of inclusive ranges {min: min-value, max:
+        # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+        # allows the peer ASN to be 123 or anything in the range 64512-65534.
+        #
+        # This field is only advisory. Although the API accepts other ranges, these
+        # are the ranges that we recommend.
+      {
+        "max": 42,
+        "min": 42,
+      },
+    ],
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on the customer
+      # router subinterface for this interconnect attachment.
+  "customerRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on the
+      # customer router subinterface for this interconnect attachment.
+  "customerRouterIpv6InterfaceId": "A String", # This field is not available.
+  "dataplaneVersion": 42, # Output only. [Output Only] Dataplane version for this InterconnectAttachment. This
+      # field is only present for Dataplane version 2 and higher. Absence of this
+      # field in the API output indicates that the Dataplane is version 1.
+  "description": "A String", # An optional description of this resource.
+  "edgeAvailabilityDomain": "A String", # Input only. Desired availability domain for the attachment. Only available for type
+      # PARTNER, at creation time, and can take one of the following values:
+      # 
+      #    - AVAILABILITY_DOMAIN_ANY
+      #    - AVAILABILITY_DOMAIN_1
+      #    - AVAILABILITY_DOMAIN_2
+      # 
+      # 
+      # For improved reliability, customers should configure a pair of attachments,
+      # one per availability domain. The selected availability domain will be
+      # provided to the Partner via the pairing key, so that the provisioned
+      # circuit will lie in the specified domain. If not specified, the value will
+      # default to AVAILABILITY_DOMAIN_ANY.
+  "encryption": "A String", # Indicates the user-supplied encryption option of this VLAN attachment
+      # (interconnectAttachment). Can only be specified at attachment creation
+      # for PARTNER or DEDICATED attachments.
+      # Possible values are:
+      # 
+      #    - NONE - This is the default value, which means that the
+      #    VLAN attachment carries unencrypted traffic. VMs are able to send
+      #    traffic to, or receive traffic from, such a VLAN attachment.
+      #    - IPSEC - The VLAN attachment carries only encrypted
+      #    traffic that is encrypted by an IPsec device, such as an HA VPN gateway or
+      #    third-party IPsec VPN. VMs cannot directly send traffic to, or receive
+      #    traffic from, such a VLAN attachment. To use *HA VPN over Cloud
+      #    Interconnect*, the VLAN attachment must be created with this
+      #    option.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID, to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+      # [Deprecated] This field is not used.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnect": "A String", # URL of the underlying Interconnect object that this attachment's traffic
+      # will traverse through.
+  "ipsecInternalAddresses": [ # A list of URLs of addresses that have been reserved for the VLAN
+      # attachment. Used only for the VLAN attachment that has the encryption
+      # option as IPSEC. The addresses must be regional internal IP address ranges.
+      # When creating an HA VPN gateway over the VLAN attachment, if the attachment
+      # is configured to use a regional internal IP address, then the VPN gateway's
+      # IP address is allocated from the IP address range specified here. For
+      # example, if the HA VPN gateway's interface 0 is paired to this VLAN
+      # attachment, then a regional internal IP address for the VPN gateway
+      # interface 0 will be allocated from the IP address specified for this
+      # VLAN attachment.
+      # If this field is not specified when creating the VLAN attachment, then
+      # later on when creating an HA VPN gateway on this VLAN attachment, the HA
+      # VPN gateway's IP address is allocated from the regional external IP address
+      # pool.
+    "A String",
+  ],
+  "kind": "compute#interconnectAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.
+  "l2Forwarding": { # L2 Interconnect Attachment related configuration. # L2 Interconnect Attachment related config. This field is required if the
+      # type is L2_DEDICATED.
+      # 
+      # The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)
+      # within L2 packets are mapped to the destination appliances IP addresses.
+      # The packet is then encapsulated with the appliance IP address and sent to
+      # the edge appliance.
+    "applianceMappings": { # Optional. A map of VLAN tags to appliances and optional inner mapping
+        # rules. If VLANs are not explicitly mapped to any appliance, the
+        # defaultApplianceIpAddress is used.
+        #
+        # Each VLAN tag can be a single number or a range of numbers in the range
+        # of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping
+        # VLAN tag ranges are enforced, and violating operations will be rejected.
+        #
+        # The VLAN tags in the Ethernet header must use an ethertype value of
+        # 0x88A8 or 0x8100.
+      "a_key": { # Two-level VLAN-to-Appliance mapping rule.
+        "applianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the destination IP
+            # address for ingress packets that match on a VLAN tag, but do not match
+            # a more specific inner VLAN tag.
+            #
+            # Unset field (null-value) indicates both VLAN tags are required to be
+            # mapped. Otherwise, defaultApplianceIpAddress is used.
+        "innerVlanToApplianceMappings": [ # Optional. Used to match against the inner VLAN when the packet
+            # contains two VLAN tags.
+            #
+            # A list of mapping rules from inner VLAN tags to IP addresses. If the
+            # inner VLAN is not explicitly mapped to an IP address range, the
+            # applianceIpAddress is used.
+          { # The inner VLAN-to-Appliance mapping.
+            "innerApplianceIpAddress": "A String", # Required in this object. A single IPv4 or IPv6 address used as the
+                # destination IP address for ingress packets that match on both VLAN
+                # tags.
+            "innerVlanTags": [ # Required in this object. Used to match the inner VLAN tag on the
+                # packet. Each entry can be a single number or a range of numbers in
+                # the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty
+                # and Non-overlapping VLAN tag ranges are enforced, and violating
+                # operations will be rejected.
+                #
+                # The inner VLAN tags must have an ethertype value of 0x8100.
+              "A String",
+            ],
+          },
+        ],
+        "name": "A String", # Optional. The name of this appliance mapping rule.
+      },
+    },
+    "defaultApplianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the default destination
+        # IP when there is no VLAN mapping result found.
+        #
+        # Unset field (null-value) indicates the unmatched packet should be
+        # dropped.
+    "geneveHeader": { # GeneveHeader related configurations. # Optional. It represents the structure of a Geneve (Generic Network
+        # Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various
+        # protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization
+        # environments.
+      "vni": 42, # Optional. VNI is a 24-bit unique virtual network identifier, from 0 to
+          # 16,777,215.
+    },
+    "network": "A String", # Required. Resource URL of the network to which this attachment belongs.
+    "tunnelEndpointIpAddress": "A String", # Required. A single IPv4 or IPv6 address. This address will be used as the
+        # source IP address for packets sent to the appliances, and must be used as
+        # the destination IP address for packets that should be sent out through
+        # this attachment.
+  },
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InterconnectAttachment,
+      # which is essentially a hash of the labels set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InterconnectAttachment.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "mtu": 42, # Maximum Transmission Unit (MTU), in bytes, of packets passing through this
+      # interconnect attachment.
+      # Valid values are 1440, 1460, 1500, and 8896. If not specified,
+      # the value will default to 1440.
+  "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.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of whether or not this interconnect
+      # attachment is functional, which can take one of the following values:
+      # 
+      #    - OS_ACTIVE: The attachment has been turned up and is ready to
+      #    use.
+      #    - OS_UNPROVISIONED: The attachment is not ready to use yet,
+      #    because turnup is not complete.
+  "pairingKey": "A String", # [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not
+      # present for DEDICATED].
+      # The opaque identifier of a PARTNER attachment used to initiate
+      # provisioning with a selected partner.
+      # Of the form "XXXXX/region/domain"
+  "params": { # Additional interconnect attachment 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.
+        # 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",
+    },
+  },
+  "partnerAsn": "A String", # Optional BGP ASN for the router supplied by a Layer 3 Partner if they
+      # configured BGP on behalf of the customer.
+      # Output only for PARTNER type, input only for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+  "partnerMetadata": { # Informational metadata about Partner attachments from Partners to display # Informational metadata about Partner attachments from Partners to display
+      # to customers.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+      # to customers.  These fields are propagated from PARTNER_PROVIDER
+      # attachments to their corresponding PARTNER attachments.
+    "interconnectName": "A String", # Plain text name of the Interconnect this attachment is connected to, as
+        # displayed in the Partner's portal. For instance "Chicago 1".
+        # This value may be validated to match approved Partner values.
+    "partnerName": "A String", # Plain text name of the Partner providing this attachment.
+        # This value may be validated to match approved Partner values.
+    "portalUrl": "A String", # URL of the Partner's portal for this Attachment. Partners may customise
+        # this to be a deep link to the specific resource on the Partner portal.
+        # This value may be validated to match approved Partner values.
+  },
+  "privateInterconnectInfo": { # Information for an interconnect attachment when this belongs to an # Output only. [Output Only] Information specific to an InterconnectAttachment.
+      # This property is populated if the interconnect that
+      # this is attached to is of type DEDICATED.
+      # interconnect of type DEDICATED.
+    "tag8021q": 42, # [Output Only] 802.1q encapsulation tag to be used for traffic between
+        # Google and the customer, going to and from this network and region.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional interconnect attachment
+      # resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "remoteService": "A String", # Output only. [Output Only]
+      # If the attachment is on a Cross-Cloud Interconnect connection, this field
+      # contains the interconnect's remote location service provider. Example
+      # values: "Amazon Web Services" "Microsoft Azure".
+      # 
+      # The field is set only for attachments on Cross-Cloud Interconnect
+      # connections. Its value is copied from the InterconnectRemoteLocation
+      # remoteService field.
+  "router": "A String", # URL of the Cloud Router to be used for dynamic routing. This router must be
+      # in the same region as this InterconnectAttachment. The
+      # InterconnectAttachment will automatically connect the Interconnect to the
+      # network & region within which the Cloud Router is configured.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for this interconnect attachment to identify whether the
+      # IPv6 feature is enabled or not. If not specified, IPV4_ONLY
+      # will be used.
+      # 
+      # This field can be both set at interconnect attachments creation and
+      # update interconnect attachment operations.
+  "state": "A String", # Output only. [Output Only] The current state of this attachment's functionality.
+      # Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,
+      # PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values
+      # PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used
+      # for only PARTNER and PARTNER_PROVIDER interconnect attachments.
+      # This state can take one of the following values:
+      # 
+      #    - ACTIVE: The attachment has been turned up and is ready to use.
+      #    - UNPROVISIONED: The attachment is not ready to use yet, because turnup
+      #    is not complete.
+      #    - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet
+      #    been configured on the Partner side.
+      #    - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of
+      #    provisioning after a PARTNER_PROVIDER attachment was created that
+      #    references it.
+      #    - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER
+      #    attachment that is waiting for a customer to activate it.
+      #    - DEFUNCT:
+      #    The attachment was deleted externally and is no longer functional. This
+      #    could be because the associated Interconnect was removed, or because the
+      #    other side of a Partner attachment was deleted.
+  "subnetLength": 42, # Input only. Length of the IPv4 subnet mask.
+      # Allowed values:
+      # 
+      # 
+      #     - 29 (default)
+      #     - 30
+      # 
+      # The default value is 29, except for Cross-Cloud Interconnect
+      # connections that use an InterconnectRemoteLocation with a
+      # constraints.subnetLengthRange.min equal to 30. For example,
+      # connections that use an Azure remote location fall into this
+      # category. In these cases, the default value is 30, and requesting
+      # 29 returns an error.
+      # 
+      # Where both 29 and 30 are allowed, 29 is preferred, because it gives
+      # Google Cloud Support more debugging visibility.
+  "type": "A String", # The type of interconnect attachment this is, which can take one of the
+      # following values:
+      # 
+      #    - DEDICATED: an attachment to a Dedicated Interconnect.
+      #    - PARTNER: an attachment to a Partner Interconnect, created by the
+      #    customer.
+      #    - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by
+      #    the partner.
+      # 
+      # - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.
+  "vlanTag8021q": 42, # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.
+      # Only specified at creation time.
+}
+
+  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).
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of interconnect attachments contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request, and contains a list of interconnect
+    # attachments.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InterconnectAttachment resources.
+    { # Represents an Interconnect Attachment (VLAN) resource.
+        #
+        # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+        # Cloud networks to your on-premises networks through an Interconnect.
+        # For more information, read
+        # Creating VLAN Attachments.
+      "adminEnabled": True or False, # Determines whether this Attachment will carry packets.
+          # Not present for PARTNER_PROVIDER.
+      "attachmentGroup": "A String", # Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.
+      "bandwidth": "A String", # Provisioned bandwidth capacity for the interconnect attachment. For
+          # attachments of type DEDICATED, the user can set the bandwidth.
+          # For attachments of type PARTNER, the Google Partner that is operating
+          # the interconnect must set the bandwidth.
+          # Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,
+          # and can take one of the following values:
+          #
+          #    - BPS_50M: 50 Mbit/s
+          #    - BPS_100M: 100 Mbit/s
+          #    - BPS_200M: 200 Mbit/s
+          #    - BPS_300M: 300 Mbit/s
+          #    - BPS_400M: 400 Mbit/s
+          #    - BPS_500M: 500 Mbit/s
+          #    - BPS_1G: 1 Gbit/s
+          #    - BPS_2G: 2 Gbit/s
+          #    - BPS_5G: 5 Gbit/s
+          #    - BPS_10G: 10 Gbit/s
+          #    - BPS_20G: 20 Gbit/s
+          #    - BPS_50G: 50 Gbit/s
+          #    - BPS_100G: 100 Gbit/s
+          #    - BPS_400G: 400 Gbit/s
+      "candidateCloudRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the cloud router
+          # interface for this interconnect attachment.
+          #
+          #    - Both candidate_cloud_router_ip_address and
+          #    candidate_customer_router_ip_address fields must be set or both must be
+          #    unset.
+          #    - Prefix length of both candidate_cloud_router_ip_address and
+          #    candidate_customer_router_ip_address must be the same.
+          #    - Max prefix length is 31.
+      "candidateCloudRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the cloud router
+          # interface for this interconnect attachment.
+          #
+          #    - Both candidate_cloud_router_ipv6_address and
+          #    candidate_customer_router_ipv6_address fields must be set or both must be
+          #    unset.
+          #    - Prefix length of both candidate_cloud_router_ipv6_address and
+          #    candidate_customer_router_ipv6_address must be the same.
+          #    - Max prefix length is 126.
+      "candidateCustomerRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the customer router
+          # interface for this interconnect attachment.
+      "candidateCustomerRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the customer router
+          # interface for this interconnect attachment.
+      "candidateIpv6Subnets": [ # This field is not available.
+        "A String",
+      ],
+      "candidateSubnets": [ # Input only. Up to 16 candidate prefixes that can be used to restrict the allocation
+          # of cloudRouterIpAddress and customerRouterIpAddress for this attachment.
+          # All prefixes must be within link-local address space (169.254.0.0/16) and
+          # must be /29 or shorter (/28, /27, etc). Google will attempt to select an
+          # unused /29 from the supplied candidate prefix(es). The request will fail if
+          # all possible /29s are in use on Google's edge. If not supplied, Google will
+          # randomly select an unused /29 from all of link-local space.
+        "A String",
+      ],
+      "cloudRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router
+          # Interface for this interconnect attachment.
+      "cloudRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud
+          # Router Interface for this interconnect attachment.
+      "cloudRouterIpv6InterfaceId": "A String", # This field is not available.
+      "configurationConstraints": { # Output only. [Output Only] Constraints for this attachment, if any. The attachment does
+          # not work if these constraints are not met.
+        "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+            # requires/allows/disallows BGP MD5 authentication. This can take one of
+            # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+            #
+            # For example, a Cross-Cloud Interconnect connection to a remote cloud
+            # provider that requires BGP MD5 authentication has the
+            # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+            # field set to MD5_REQUIRED, and that property is propagated to the
+            # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+            # returned if MD5 is requested.
+        "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+            # support. Formatted as an array of inclusive ranges {min: min-value, max:
+            # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+            # allows the peer ASN to be 123 or anything in the range 64512-65534.
+            #
+            # This field is only advisory. Although the API accepts other ranges, these
+            # are the ranges that we recommend.
+          {
+            "max": 42,
+            "min": 42,
+          },
+        ],
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customerRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on the customer
+          # router subinterface for this interconnect attachment.
+      "customerRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on the
+          # customer router subinterface for this interconnect attachment.
+      "customerRouterIpv6InterfaceId": "A String", # This field is not available.
+      "dataplaneVersion": 42, # Output only. [Output Only] Dataplane version for this InterconnectAttachment. This
+          # field is only present for Dataplane version 2 and higher. Absence of this
+          # field in the API output indicates that the Dataplane is version 1.
+      "description": "A String", # An optional description of this resource.
+      "edgeAvailabilityDomain": "A String", # Input only. Desired availability domain for the attachment. Only available for type
+          # PARTNER, at creation time, and can take one of the following values:
+          #
+          #    - AVAILABILITY_DOMAIN_ANY
+          #    - AVAILABILITY_DOMAIN_1
+          #    - AVAILABILITY_DOMAIN_2
+          #
+          #
+          # For improved reliability, customers should configure a pair of attachments,
+          # one per availability domain. The selected availability domain will be
+          # provided to the Partner via the pairing key, so that the provisioned
+          # circuit will lie in the specified domain. If not specified, the value will
+          # default to AVAILABILITY_DOMAIN_ANY.
+      "encryption": "A String", # Indicates the user-supplied encryption option of this VLAN attachment
+          # (interconnectAttachment). Can only be specified at attachment creation
+          # for PARTNER or DEDICATED attachments.
+          # Possible values are:
+          #
+          #    - NONE - This is the default value, which means that the
+          #    VLAN attachment carries unencrypted traffic. VMs are able to send
+          #    traffic to, or receive traffic from, such a VLAN attachment.
+          #    - IPSEC - The VLAN attachment carries only encrypted
+          #    traffic that is encrypted by an IPsec device, such as an HA VPN gateway or
+          #    third-party IPsec VPN. VMs cannot directly send traffic to, or receive
+          #    traffic from, such a VLAN attachment. To use *HA VPN over Cloud
+          #    Interconnect*, the VLAN attachment must be created with this
+          #    option.
+      "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID, to be used when raising support tickets
+          # with Google or otherwise to debug backend connectivity issues.
+          # [Deprecated] This field is not used.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "interconnect": "A String", # URL of the underlying Interconnect object that this attachment's traffic
+          # will traverse through.
+      "ipsecInternalAddresses": [ # A list of URLs of addresses that have been reserved for the VLAN
+          # attachment. Used only for the VLAN attachment that has the encryption
+          # option as IPSEC. The addresses must be regional internal IP address ranges.
+          # When creating an HA VPN gateway over the VLAN attachment, if the attachment
+          # is configured to use a regional internal IP address, then the VPN gateway's
+          # IP address is allocated from the IP address range specified here. For
+          # example, if the HA VPN gateway's interface 0 is paired to this VLAN
+          # attachment, then a regional internal IP address for the VPN gateway
+          # interface 0 will be allocated from the IP address specified for this
+          # VLAN attachment.
+          # If this field is not specified when creating the VLAN attachment, then
+          # later on when creating an HA VPN gateway on this VLAN attachment, the HA
+          # VPN gateway's IP address is allocated from the regional external IP address
+          # pool.
+        "A String",
+      ],
+      "kind": "compute#interconnectAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.
+      "l2Forwarding": { # L2 Interconnect Attachment related configuration. # L2 Interconnect Attachment related config. This field is required if the
+          # type is L2_DEDICATED.
+          #
+          # The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)
+          # within L2 packets are mapped to the destination appliances IP addresses.
+          # The packet is then encapsulated with the appliance IP address and sent to
+          # the edge appliance.
+        "applianceMappings": { # Optional. A map of VLAN tags to appliances and optional inner mapping
+            # rules. If VLANs are not explicitly mapped to any appliance, the
+            # defaultApplianceIpAddress is used.
+            #
+            # Each VLAN tag can be a single number or a range of numbers in the range
+            # of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping
+            # VLAN tag ranges are enforced, and violating operations will be rejected.
+            #
+            # The VLAN tags in the Ethernet header must use an ethertype value of
+            # 0x88A8 or 0x8100.
+          "a_key": { # Two-level VLAN-to-Appliance mapping rule.
+            "applianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the destination IP
+                # address for ingress packets that match on a VLAN tag, but do not match
+                # a more specific inner VLAN tag.
+                #
+                # Unset field (null-value) indicates both VLAN tags are required to be
+                # mapped. Otherwise, defaultApplianceIpAddress is used.
+            "innerVlanToApplianceMappings": [ # Optional. Used to match against the inner VLAN when the packet
+                # contains two VLAN tags.
+                #
+                # A list of mapping rules from inner VLAN tags to IP addresses. If the
+                # inner VLAN is not explicitly mapped to an IP address range, the
+                # applianceIpAddress is used.
+              { # The inner VLAN-to-Appliance mapping.
+                "innerApplianceIpAddress": "A String", # Required in this object. A single IPv4 or IPv6 address used as the
+                    # destination IP address for ingress packets that match on both VLAN
+                    # tags.
+                "innerVlanTags": [ # Required in this object. Used to match the inner VLAN tag on the
+                    # packet. Each entry can be a single number or a range of numbers in
+                    # the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty
+                    # and Non-overlapping VLAN tag ranges are enforced, and violating
+                    # operations will be rejected.
+                    #
+                    # The inner VLAN tags must have an ethertype value of 0x8100.
+                  "A String",
+                ],
+              },
+            ],
+            "name": "A String", # Optional. The name of this appliance mapping rule.
+          },
+        },
+        "defaultApplianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the default destination
+            # IP when there is no VLAN mapping result found.
+            #
+            # Unset field (null-value) indicates the unmatched packet should be
+            # dropped.
+        "geneveHeader": { # GeneveHeader related configurations. # Optional. It represents the structure of a Geneve (Generic Network
+            # Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various
+            # protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization
+            # environments.
+          "vni": 42, # Optional. VNI is a 24-bit unique virtual network identifier, from 0 to
+              # 16,777,215.
+        },
+        "network": "A String", # Required. Resource URL of the network to which this attachment belongs.
+        "tunnelEndpointIpAddress": "A String", # Required. A single IPv4 or IPv6 address. This address will be used as the
+            # source IP address for packets sent to the appliances, and must be used as
+            # the destination IP address for packets that should be sent out through
+            # this attachment.
+      },
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InterconnectAttachment,
+          # which is essentially a hash of the labels set used for optimistic locking.
+          # The fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an InterconnectAttachment.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "mtu": 42, # Maximum Transmission Unit (MTU), in bytes, of packets passing through this
+          # interconnect attachment.
+          # Valid values are 1440, 1460, 1500, and 8896. If not specified,
+          # the value will default to 1440.
+      "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.
+      "operationalStatus": "A String", # Output only. [Output Only] The current status of whether or not this interconnect
+          # attachment is functional, which can take one of the following values:
+          #
+          #    - OS_ACTIVE: The attachment has been turned up and is ready to
+          #    use.
+          #    - OS_UNPROVISIONED: The attachment is not ready to use yet,
+          #    because turnup is not complete.
+      "pairingKey": "A String", # [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not
+          # present for DEDICATED].
+          # The opaque identifier of a PARTNER attachment used to initiate
+          # provisioning with a selected partner.
+          # Of the form "XXXXX/region/domain"
+      "params": { # Additional interconnect attachment 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.
+            # 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",
+        },
+      },
+      "partnerAsn": "A String", # Optional BGP ASN for the router supplied by a Layer 3 Partner if they
+          # configured BGP on behalf of the customer.
+          # Output only for PARTNER type, input only for PARTNER_PROVIDER, not
+          # available for DEDICATED.
+      "partnerMetadata": { # Informational metadata about Partner attachments from Partners to display # Informational metadata about Partner attachments from Partners to display
+          # to customers.
+          # Output only for PARTNER type, mutable for PARTNER_PROVIDER, not
+          # available for DEDICATED.
+          # to customers.  These fields are propagated from PARTNER_PROVIDER
+          # attachments to their corresponding PARTNER attachments.
+        "interconnectName": "A String", # Plain text name of the Interconnect this attachment is connected to, as
+            # displayed in the Partner's portal. For instance "Chicago 1".
+            # This value may be validated to match approved Partner values.
+        "partnerName": "A String", # Plain text name of the Partner providing this attachment.
+            # This value may be validated to match approved Partner values.
+        "portalUrl": "A String", # URL of the Partner's portal for this Attachment. Partners may customise
+            # this to be a deep link to the specific resource on the Partner portal.
+            # This value may be validated to match approved Partner values.
+      },
+      "privateInterconnectInfo": { # Information for an interconnect attachment when this belongs to an # Output only. [Output Only] Information specific to an InterconnectAttachment.
+          # This property is populated if the interconnect that
+          # this is attached to is of type DEDICATED.
+          # interconnect of type DEDICATED.
+        "tag8021q": 42, # [Output Only] 802.1q encapsulation tag to be used for traffic between
+            # Google and the customer, going to and from this network and region.
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional interconnect attachment
+          # resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "remoteService": "A String", # Output only. [Output Only]
+          # If the attachment is on a Cross-Cloud Interconnect connection, this field
+          # contains the interconnect's remote location service provider. Example
+          # values: "Amazon Web Services" "Microsoft Azure".
+          #
+          # The field is set only for attachments on Cross-Cloud Interconnect
+          # connections. Its value is copied from the InterconnectRemoteLocation
+          # remoteService field.
+      "router": "A String", # URL of the Cloud Router to be used for dynamic routing. This router must be
+          # in the same region as this InterconnectAttachment. The
+          # InterconnectAttachment will automatically connect the Interconnect to the
+          # network & region within which the Cloud Router is configured.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "stackType": "A String", # The stack type for this interconnect attachment to identify whether the
+          # IPv6 feature is enabled or not. If not specified, IPV4_ONLY
+          # will be used.
+          #
+          # This field can be both set at interconnect attachments creation and
+          # update interconnect attachment operations.
+      "state": "A String", # Output only. [Output Only] The current state of this attachment's functionality.
+          # Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,
+          # PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values
+          # PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used
+          # for only PARTNER and PARTNER_PROVIDER interconnect attachments.
+          # This state can take one of the following values:
+          #
+          #    - ACTIVE: The attachment has been turned up and is ready to use.
+          #    - UNPROVISIONED: The attachment is not ready to use yet, because turnup
+          #    is not complete.
+          #    - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet
+          #    been configured on the Partner side.
+          #    - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of
+          #    provisioning after a PARTNER_PROVIDER attachment was created that
+          #    references it.
+          #    - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER
+          #    attachment that is waiting for a customer to activate it.
+          #    - DEFUNCT:
+          #    The attachment was deleted externally and is no longer functional. This
+          #    could be because the associated Interconnect was removed, or because the
+          #    other side of a Partner attachment was deleted.
+      "subnetLength": 42, # Input only. Length of the IPv4 subnet mask.
+          # Allowed values:
+          #
+          #
+          #     - 29 (default)
+          #     - 30
+          #
+          # The default value is 29, except for Cross-Cloud Interconnect
+          # connections that use an InterconnectRemoteLocation with a
+          # constraints.subnetLengthRange.min equal to 30. For example,
+          # connections that use an Azure remote location fall into this
+          # category. In these cases, the default value is 30, and requesting
+          # 29 returns an error.
+          #
+          # Where both 29 and 30 are allowed, 29 is preferred, because it gives
+          # Google Cloud Support more debugging visibility.
+      "type": "A String", # The type of interconnect attachment this is, which can take one of the
+          # following values:
+          #
+          #    - DEDICATED: an attachment to a Dedicated Interconnect.
+          #    - PARTNER: an attachment to a Partner Interconnect, created by the
+          #    customer.
+          #    - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by
+          #    the partner.
+          #
+          # - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.
+      "vlanTag8021q": 42, # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.
+          # Only specified at creation time.
+    },
+  ],
+  "kind": "compute#interconnectAttachmentList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect
+      # attachments.
+  "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.
+  "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, interconnectAttachment, body=None, requestId=None, x__xgafv=None) + 
Updates the specified interconnect attachment 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)
+  interconnectAttachment: string, Name of the interconnect attachment to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Interconnect Attachment (VLAN) resource.
+    # 
+    # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+    # Cloud networks to your on-premises networks through an Interconnect.
+    # For more information, read
+    # Creating VLAN Attachments.
+  "adminEnabled": True or False, # Determines whether this Attachment will carry packets.
+      # Not present for PARTNER_PROVIDER.
+  "attachmentGroup": "A String", # Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.
+  "bandwidth": "A String", # Provisioned bandwidth capacity for the interconnect attachment. For
+      # attachments of type DEDICATED, the user can set the bandwidth.
+      # For attachments of type PARTNER, the Google Partner that is operating
+      # the interconnect must set the bandwidth.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,
+      # and can take one of the following values:
+      # 
+      #    - BPS_50M: 50 Mbit/s
+      #    - BPS_100M: 100 Mbit/s
+      #    - BPS_200M: 200 Mbit/s
+      #    - BPS_300M: 300 Mbit/s
+      #    - BPS_400M: 400 Mbit/s
+      #    - BPS_500M: 500 Mbit/s
+      #    - BPS_1G: 1 Gbit/s
+      #    - BPS_2G: 2 Gbit/s
+      #    - BPS_5G: 5 Gbit/s
+      #    - BPS_10G: 10 Gbit/s
+      #    - BPS_20G: 20 Gbit/s
+      #    - BPS_50G: 50 Gbit/s
+      #    - BPS_100G: 100 Gbit/s
+      #    - BPS_400G: 400 Gbit/s
+  "candidateCloudRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      # 
+      #    - Both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ip_address and
+      #    candidate_customer_router_ip_address must be the same.
+      #    - Max prefix length is 31.
+  "candidateCloudRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the cloud router
+      # interface for this interconnect attachment.
+      # 
+      #    - Both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address fields must be set or both must be
+      #    unset.
+      #    - Prefix length of both candidate_cloud_router_ipv6_address and
+      #    candidate_customer_router_ipv6_address must be the same.
+      #    - Max prefix length is 126.
+  "candidateCustomerRouterIpAddress": "A String", # Single IPv4 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateCustomerRouterIpv6Address": "A String", # Single IPv6 address + prefix length to be configured on the customer router
+      # interface for this interconnect attachment.
+  "candidateIpv6Subnets": [ # This field is not available.
+    "A String",
+  ],
+  "candidateSubnets": [ # Input only. Up to 16 candidate prefixes that can be used to restrict the allocation
+      # of cloudRouterIpAddress and customerRouterIpAddress for this attachment.
+      # All prefixes must be within link-local address space (169.254.0.0/16) and
+      # must be /29 or shorter (/28, /27, etc). Google will attempt to select an
+      # unused /29 from the supplied candidate prefix(es). The request will fail if
+      # all possible /29s are in use on Google's edge. If not supplied, Google will
+      # randomly select an unused /29 from all of link-local space.
+    "A String",
+  ],
+  "cloudRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router
+      # Interface for this interconnect attachment.
+  "cloudRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud
+      # Router Interface for this interconnect attachment.
+  "cloudRouterIpv6InterfaceId": "A String", # This field is not available.
+  "configurationConstraints": { # Output only. [Output Only] Constraints for this attachment, if any. The attachment does
+      # not work if these constraints are not met.
+    "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+        # requires/allows/disallows BGP MD5 authentication. This can take one of
+        # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+        #
+        # For example, a Cross-Cloud Interconnect connection to a remote cloud
+        # provider that requires BGP MD5 authentication has the
+        # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+        # field set to MD5_REQUIRED, and that property is propagated to the
+        # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+        # returned if MD5 is requested.
+    "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+        # support. Formatted as an array of inclusive ranges {min: min-value, max:
+        # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+        # allows the peer ASN to be 123 or anything in the range 64512-65534.
+        #
+        # This field is only advisory. Although the API accepts other ranges, these
+        # are the ranges that we recommend.
+      {
+        "max": 42,
+        "min": 42,
+      },
+    ],
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerRouterIpAddress": "A String", # Output only. [Output Only] IPv4 address + prefix length to be configured on the customer
+      # router subinterface for this interconnect attachment.
+  "customerRouterIpv6Address": "A String", # Output only. [Output Only] IPv6 address + prefix length to be configured on the
+      # customer router subinterface for this interconnect attachment.
+  "customerRouterIpv6InterfaceId": "A String", # This field is not available.
+  "dataplaneVersion": 42, # Output only. [Output Only] Dataplane version for this InterconnectAttachment. This
+      # field is only present for Dataplane version 2 and higher. Absence of this
+      # field in the API output indicates that the Dataplane is version 1.
+  "description": "A String", # An optional description of this resource.
+  "edgeAvailabilityDomain": "A String", # Input only. Desired availability domain for the attachment. Only available for type
+      # PARTNER, at creation time, and can take one of the following values:
+      # 
+      #    - AVAILABILITY_DOMAIN_ANY
+      #    - AVAILABILITY_DOMAIN_1
+      #    - AVAILABILITY_DOMAIN_2
+      # 
+      # 
+      # For improved reliability, customers should configure a pair of attachments,
+      # one per availability domain. The selected availability domain will be
+      # provided to the Partner via the pairing key, so that the provisioned
+      # circuit will lie in the specified domain. If not specified, the value will
+      # default to AVAILABILITY_DOMAIN_ANY.
+  "encryption": "A String", # Indicates the user-supplied encryption option of this VLAN attachment
+      # (interconnectAttachment). Can only be specified at attachment creation
+      # for PARTNER or DEDICATED attachments.
+      # Possible values are:
+      # 
+      #    - NONE - This is the default value, which means that the
+      #    VLAN attachment carries unencrypted traffic. VMs are able to send
+      #    traffic to, or receive traffic from, such a VLAN attachment.
+      #    - IPSEC - The VLAN attachment carries only encrypted
+      #    traffic that is encrypted by an IPsec device, such as an HA VPN gateway or
+      #    third-party IPsec VPN. VMs cannot directly send traffic to, or receive
+      #    traffic from, such a VLAN attachment. To use *HA VPN over Cloud
+      #    Interconnect*, the VLAN attachment must be created with this
+      #    option.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID, to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+      # [Deprecated] This field is not used.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnect": "A String", # URL of the underlying Interconnect object that this attachment's traffic
+      # will traverse through.
+  "ipsecInternalAddresses": [ # A list of URLs of addresses that have been reserved for the VLAN
+      # attachment. Used only for the VLAN attachment that has the encryption
+      # option as IPSEC. The addresses must be regional internal IP address ranges.
+      # When creating an HA VPN gateway over the VLAN attachment, if the attachment
+      # is configured to use a regional internal IP address, then the VPN gateway's
+      # IP address is allocated from the IP address range specified here. For
+      # example, if the HA VPN gateway's interface 0 is paired to this VLAN
+      # attachment, then a regional internal IP address for the VPN gateway
+      # interface 0 will be allocated from the IP address specified for this
+      # VLAN attachment.
+      # If this field is not specified when creating the VLAN attachment, then
+      # later on when creating an HA VPN gateway on this VLAN attachment, the HA
+      # VPN gateway's IP address is allocated from the regional external IP address
+      # pool.
+    "A String",
+  ],
+  "kind": "compute#interconnectAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.
+  "l2Forwarding": { # L2 Interconnect Attachment related configuration. # L2 Interconnect Attachment related config. This field is required if the
+      # type is L2_DEDICATED.
+      # 
+      # The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)
+      # within L2 packets are mapped to the destination appliances IP addresses.
+      # The packet is then encapsulated with the appliance IP address and sent to
+      # the edge appliance.
+    "applianceMappings": { # Optional. A map of VLAN tags to appliances and optional inner mapping
+        # rules. If VLANs are not explicitly mapped to any appliance, the
+        # defaultApplianceIpAddress is used.
+        #
+        # Each VLAN tag can be a single number or a range of numbers in the range
+        # of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping
+        # VLAN tag ranges are enforced, and violating operations will be rejected.
+        #
+        # The VLAN tags in the Ethernet header must use an ethertype value of
+        # 0x88A8 or 0x8100.
+      "a_key": { # Two-level VLAN-to-Appliance mapping rule.
+        "applianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the destination IP
+            # address for ingress packets that match on a VLAN tag, but do not match
+            # a more specific inner VLAN tag.
+            #
+            # Unset field (null-value) indicates both VLAN tags are required to be
+            # mapped. Otherwise, defaultApplianceIpAddress is used.
+        "innerVlanToApplianceMappings": [ # Optional. Used to match against the inner VLAN when the packet
+            # contains two VLAN tags.
+            #
+            # A list of mapping rules from inner VLAN tags to IP addresses. If the
+            # inner VLAN is not explicitly mapped to an IP address range, the
+            # applianceIpAddress is used.
+          { # The inner VLAN-to-Appliance mapping.
+            "innerApplianceIpAddress": "A String", # Required in this object. A single IPv4 or IPv6 address used as the
+                # destination IP address for ingress packets that match on both VLAN
+                # tags.
+            "innerVlanTags": [ # Required in this object. Used to match the inner VLAN tag on the
+                # packet. Each entry can be a single number or a range of numbers in
+                # the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty
+                # and Non-overlapping VLAN tag ranges are enforced, and violating
+                # operations will be rejected.
+                #
+                # The inner VLAN tags must have an ethertype value of 0x8100.
+              "A String",
+            ],
+          },
+        ],
+        "name": "A String", # Optional. The name of this appliance mapping rule.
+      },
+    },
+    "defaultApplianceIpAddress": "A String", # Optional. A single IPv4 or IPv6 address used as the default destination
+        # IP when there is no VLAN mapping result found.
+        #
+        # Unset field (null-value) indicates the unmatched packet should be
+        # dropped.
+    "geneveHeader": { # GeneveHeader related configurations. # Optional. It represents the structure of a Geneve (Generic Network
+        # Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various
+        # protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization
+        # environments.
+      "vni": 42, # Optional. VNI is a 24-bit unique virtual network identifier, from 0 to
+          # 16,777,215.
+    },
+    "network": "A String", # Required. Resource URL of the network to which this attachment belongs.
+    "tunnelEndpointIpAddress": "A String", # Required. A single IPv4 or IPv6 address. This address will be used as the
+        # source IP address for packets sent to the appliances, and must be used as
+        # the destination IP address for packets that should be sent out through
+        # this attachment.
+  },
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InterconnectAttachment,
+      # which is essentially a hash of the labels set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InterconnectAttachment.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "mtu": 42, # Maximum Transmission Unit (MTU), in bytes, of packets passing through this
+      # interconnect attachment.
+      # Valid values are 1440, 1460, 1500, and 8896. If not specified,
+      # the value will default to 1440.
+  "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.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of whether or not this interconnect
+      # attachment is functional, which can take one of the following values:
+      # 
+      #    - OS_ACTIVE: The attachment has been turned up and is ready to
+      #    use.
+      #    - OS_UNPROVISIONED: The attachment is not ready to use yet,
+      #    because turnup is not complete.
+  "pairingKey": "A String", # [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not
+      # present for DEDICATED].
+      # The opaque identifier of a PARTNER attachment used to initiate
+      # provisioning with a selected partner.
+      # Of the form "XXXXX/region/domain"
+  "params": { # Additional interconnect attachment 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.
+        # 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",
+    },
+  },
+  "partnerAsn": "A String", # Optional BGP ASN for the router supplied by a Layer 3 Partner if they
+      # configured BGP on behalf of the customer.
+      # Output only for PARTNER type, input only for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+  "partnerMetadata": { # Informational metadata about Partner attachments from Partners to display # Informational metadata about Partner attachments from Partners to display
+      # to customers.
+      # Output only for PARTNER type, mutable for PARTNER_PROVIDER, not
+      # available for DEDICATED.
+      # to customers.  These fields are propagated from PARTNER_PROVIDER
+      # attachments to their corresponding PARTNER attachments.
+    "interconnectName": "A String", # Plain text name of the Interconnect this attachment is connected to, as
+        # displayed in the Partner's portal. For instance "Chicago 1".
+        # This value may be validated to match approved Partner values.
+    "partnerName": "A String", # Plain text name of the Partner providing this attachment.
+        # This value may be validated to match approved Partner values.
+    "portalUrl": "A String", # URL of the Partner's portal for this Attachment. Partners may customise
+        # this to be a deep link to the specific resource on the Partner portal.
+        # This value may be validated to match approved Partner values.
+  },
+  "privateInterconnectInfo": { # Information for an interconnect attachment when this belongs to an # Output only. [Output Only] Information specific to an InterconnectAttachment.
+      # This property is populated if the interconnect that
+      # this is attached to is of type DEDICATED.
+      # interconnect of type DEDICATED.
+    "tag8021q": 42, # [Output Only] 802.1q encapsulation tag to be used for traffic between
+        # Google and the customer, going to and from this network and region.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional interconnect attachment
+      # resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "remoteService": "A String", # Output only. [Output Only]
+      # If the attachment is on a Cross-Cloud Interconnect connection, this field
+      # contains the interconnect's remote location service provider. Example
+      # values: "Amazon Web Services" "Microsoft Azure".
+      # 
+      # The field is set only for attachments on Cross-Cloud Interconnect
+      # connections. Its value is copied from the InterconnectRemoteLocation
+      # remoteService field.
+  "router": "A String", # URL of the Cloud Router to be used for dynamic routing. This router must be
+      # in the same region as this InterconnectAttachment. The
+      # InterconnectAttachment will automatically connect the Interconnect to the
+      # network & region within which the Cloud Router is configured.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for this interconnect attachment to identify whether the
+      # IPv6 feature is enabled or not. If not specified, IPV4_ONLY
+      # will be used.
+      # 
+      # This field can be both set at interconnect attachments creation and
+      # update interconnect attachment operations.
+  "state": "A String", # Output only. [Output Only] The current state of this attachment's functionality.
+      # Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,
+      # PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values
+      # PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used
+      # for only PARTNER and PARTNER_PROVIDER interconnect attachments.
+      # This state can take one of the following values:
+      # 
+      #    - ACTIVE: The attachment has been turned up and is ready to use.
+      #    - UNPROVISIONED: The attachment is not ready to use yet, because turnup
+      #    is not complete.
+      #    - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet
+      #    been configured on the Partner side.
+      #    - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of
+      #    provisioning after a PARTNER_PROVIDER attachment was created that
+      #    references it.
+      #    - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER
+      #    attachment that is waiting for a customer to activate it.
+      #    - DEFUNCT:
+      #    The attachment was deleted externally and is no longer functional. This
+      #    could be because the associated Interconnect was removed, or because the
+      #    other side of a Partner attachment was deleted.
+  "subnetLength": 42, # Input only. Length of the IPv4 subnet mask.
+      # Allowed values:
+      # 
+      # 
+      #     - 29 (default)
+      #     - 30
+      # 
+      # The default value is 29, except for Cross-Cloud Interconnect
+      # connections that use an InterconnectRemoteLocation with a
+      # constraints.subnetLengthRange.min equal to 30. For example,
+      # connections that use an Azure remote location fall into this
+      # category. In these cases, the default value is 30, and requesting
+      # 29 returns an error.
+      # 
+      # Where both 29 and 30 are allowed, 29 is preferred, because it gives
+      # Google Cloud Support more debugging visibility.
+  "type": "A String", # The type of interconnect attachment this is, which can take one of the
+      # following values:
+      # 
+      #    - DEDICATED: an attachment to a Dedicated Interconnect.
+      #    - PARTNER: an attachment to a Partner Interconnect, created by the
+      #    customer.
+      #    - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by
+      #    the partner.
+      # 
+      # - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.
+  "vlanTag8021q": 42, # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.
+      # Only specified at creation time.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on an InterconnectAttachment. To learn more about labels,
+read the Labeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.interconnectGroups.html b/docs/dyn/compute_preview.interconnectGroups.html new file mode 100644 index 0000000000..a3def64ffb --- /dev/null +++ b/docs/dyn/compute_preview.interconnectGroups.html @@ -0,0 +1,3542 @@ + + + +

Compute Engine API . interconnectGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ createMembers(project, interconnectGroup, body=None, x__xgafv=None)

+

Create Interconnects with redundancy by creating them in a specified

+

+ delete(project, interconnectGroup, requestId=None, x__xgafv=None)

+

Deletes the specified InterconnectGroup in the given scope

+

+ get(project, interconnectGroup, x__xgafv=None)

+

Returns the specified InterconnectGroup resource in the given scope.

+

+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getOperationalStatus(project, interconnectGroup, x__xgafv=None)

+

Returns the interconnectStatuses for the specified

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a InterconnectGroup in the specified project in the given scope

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the InterconnectGroups for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, interconnectGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patches the specified InterconnectGroup resource with the data included in

+

+ 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.
+
+ +
+ createMembers(project, interconnectGroup, body=None, x__xgafv=None) + 
Create Interconnects with redundancy by creating them in a specified
+interconnect group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectGroup: string, Name of the group resource to create members for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "request": {
+    "intentMismatchBehavior": "A String", # How to behave when configured.topologyCapability.supportedSLA would not
+        # equal intent.topologyCapability after this call.
+    "interconnects": [
+      {
+        "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+            # Interconnect is functional and can carry traffic.
+            # When set to false, no packets can be carried over the interconnect and
+            # no BGP routes are exchanged over it. By default, the status is set to
+            # true.
+        "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+            # authorized to request a crossconnect.
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "facility": "A String", # A zone-free location to use for all Interconnects created in this call,
+            # like "iad-1234".
+        "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+            #
+            #    - PARTNER: A partner-managed interconnection shared between
+            #    customers though a partner.
+            #    - DEDICATED: A dedicated physical
+            #    interconnection with the customer.
+            #
+            #  Note that a value IT_PRIVATE
+            # has been deprecated in favor of DEDICATED.
+        "linkType": "A String", # Type of link requested, which can take one of the following values:
+            #
+            #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+            #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+            #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4
+            #    optics.
+            #
+            #  Note that this field indicates the speed of each of the
+            # links in the bundle, not the speed of the entire bundle.
+        "name": "A String", # Name of the Interconnects to be created. This must be specified on the
+            # template and/or on each individual interconnect. The name, if not empty,
+            # must be 1-63 characters long, and comply with RFC1035.
+            # Specifically, any nonempty 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.
+        "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+            # notifications regarding this Interconnect. If specified, this will be
+            # used for notifications in addition to all other forms described, such as
+            # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+            # required for users who sign up for Cloud Interconnect using
+            # workforce identity federation.
+        "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies
+            # the location outside of Google's network that the interconnect is
+            # connected to.
+        "requestedFeatures": [ # Optional. List of features requested for this Interconnect connection,
+            # which can take one of the following values:
+            #
+            #    - IF_MACSEC: If specified, then the connection is created on MACsec
+            #    capable hardware ports. If not specified, non-MACsec capable ports will
+            #    also be considered.
+            #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+            #    exclusively for Cross-Site Networking. The connection can not be used for
+            #    Cross-Site Networking unless this feature is specified.
+          "A String",
+        ],
+        "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+            # customer.
+      },
+    ],
+    "templateInterconnect": { # Parameters for the Interconnects to create.
+      "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+          # Interconnect is functional and can carry traffic.
+          # When set to false, no packets can be carried over the interconnect and
+          # no BGP routes are exchanged over it. By default, the status is set to
+          # true.
+      "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+          # authorized to request a crossconnect.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "facility": "A String", # A zone-free location to use for all Interconnects created in this call,
+          # like "iad-1234".
+      "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+          #
+          #    - PARTNER: A partner-managed interconnection shared between
+          #    customers though a partner.
+          #    - DEDICATED: A dedicated physical
+          #    interconnection with the customer.
+          #
+          #  Note that a value IT_PRIVATE
+          # has been deprecated in favor of DEDICATED.
+      "linkType": "A String", # Type of link requested, which can take one of the following values:
+          #
+          #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+          #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+          #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4
+          #    optics.
+          #
+          #  Note that this field indicates the speed of each of the
+          # links in the bundle, not the speed of the entire bundle.
+      "name": "A String", # Name of the Interconnects to be created. This must be specified on the
+          # template and/or on each individual interconnect. The name, if not empty,
+          # must be 1-63 characters long, and comply with RFC1035.
+          # Specifically, any nonempty 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.
+      "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+          # notifications regarding this Interconnect. If specified, this will be
+          # used for notifications in addition to all other forms described, such as
+          # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+          # required for users who sign up for Cloud Interconnect using
+          # workforce identity federation.
+      "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies
+          # the location outside of Google's network that the interconnect is
+          # connected to.
+      "requestedFeatures": [ # Optional. List of features requested for this Interconnect connection,
+          # which can take one of the following values:
+          #
+          #    - IF_MACSEC: If specified, then the connection is created on MACsec
+          #    capable hardware ports. If not specified, non-MACsec capable ports will
+          #    also be considered.
+          #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+          #    exclusively for Cross-Site Networking. The connection can not be used for
+          #    Cross-Site Networking unless this feature is specified.
+        "A String",
+      ],
+      "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+          # customer.
+    },
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(project, interconnectGroup, requestId=None, x__xgafv=None) + 
Deletes the specified InterconnectGroup in the given scope
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectGroup: string, Name of the InterconnectGroup 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, interconnectGroup, x__xgafv=None) + 
Returns the specified InterconnectGroup resource in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectGroup: string, Name of the InterconnectGroup 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:
+
+    { # An interconnect group resource allows customers to create, analyze, and
+    # expand their redundant connections.
+  "configured": { # [Output Only] The status of the group as configured. This has the same
+      # structure as the operational field reported by the OperationalStatus
+      # method, but does not take into account the operational status of each
+      # resource.
+    "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+        # this group does or does not meet the requirements for the intended
+        # capability.
+      "intendedCapabilityBlockers": [
+        { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+            # from intent.topologyCapability. This list is empty if and only if those
+            # are the same.
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+              # Like physicalStructure.metros.facilities.facility, this is a numeric
+              # string like "5467".
+            "A String",
+          ],
+          "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+              # detail.
+            "A String",
+          ],
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". A blocker like
+              # INCOMPATIBLE_METROS will specify the problematic metros in this
+              # field.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Zone names are "zone1" and/or "zone2".
+            "A String",
+          ],
+        },
+      ],
+      "supportedSla": "A String",
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described by AIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this group. This is the only required field besides
+      # the name that must be specified on group creation.
+    "topologyCapability": "A String",
+  },
+  "interconnects": { # Interconnects in the InterconnectGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Interconnects per group" quota.
+    "a_key": { # An Interconnect in this InterconnectGroup.
+      "interconnect": "A String", # The URL of an Interconnect in this group. All Interconnects in the group
+          # are unique.
+    },
+  },
+  "kind": "compute#InterconnectGroup", # Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup
+  "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.
+  "physicalStructure": { # [Output Only] An analysis of the physical layout of Interconnects in this
+      # group. Every Interconnect in the group is shown once in this structure.
+    "metros": [
+      { # [Output Only] The metros Interconnects in this group are in.
+        "facilities": [
+          { # [Output Only] The facilities Interconnects in this metro are present
+              # in.
+            "facility": "A String", # Output only. [Output Only] The ID of this facility, as a numeric string like
+                # "5467". This is the third component of the location of Interconnects
+                # in this facility.
+            "zones": [
+              { # [Output Only] The zones that Interconnects in this facility are
+                  # present in.
+                "interconnects": [ # Output only. [Output Only] URLs of Interconnects in this redundancy group in the
+                    # given metro, facility, and zone.
+                  "A String",
+                ],
+                "zone": "A String", # Output only. [Output Only] The name of the zone, either "zone1" or "zone2".
+                    # This is the second component of the location of Interconnects in
+                    # this facility.
+              },
+            ],
+          },
+        ],
+        "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase string
+            # like "iad". This is the first component of the location of
+            # Interconnects underneath this.
+      },
+    ],
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+}
+
+ +
+ 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).
+}
+
+ +
+ getOperationalStatus(project, interconnectGroup, x__xgafv=None) + 
Returns the interconnectStatuses for the specified
+InterconnectGroup.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectGroup: string, Name of the interconnectGroup resource to query. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the InterconnectGroupsGetOperationalStatusResponse.
+  "etag": "A String",
+  "result": { # Request to get the status of the interconnect group with extra detail.
+    "configured": { # [Output Only] The status of the group as configured. This has the same # Output only. The configuration analysis, as returned by Get.
+        # structure as the operational field reported by the OperationalStatus
+        # method, but does not take into account the operational status of each
+        # resource.
+      "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+          # this group does or does not meet the requirements for the intended
+          # capability.
+        "intendedCapabilityBlockers": [
+          { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+              # from intent.topologyCapability. This list is empty if and only if those
+              # are the same.
+            "blockerType": "A String",
+            "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                # this requirement. This is set for every type of requirement.
+            "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                # why it's not met. This is set for every type of requirement.
+            "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+                # Like physicalStructure.metros.facilities.facility, this is a numeric
+                # string like "5467".
+              "A String",
+            ],
+            "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+                # detail.
+              "A String",
+            ],
+            "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                # These are three-letter lowercase strings like "iad". A blocker like
+                # INCOMPATIBLE_METROS will specify the problematic metros in this
+                # field.
+              "A String",
+            ],
+            "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                # Zone names are "zone1" and/or "zone2".
+              "A String",
+            ],
+          },
+        ],
+        "supportedSla": "A String",
+      },
+    },
+    "groupStatus": "A String", # Output only. Summarizes the status of the group.
+    "intent": { # The user's intent for this group. This is the only required field besides # Output only. The intent of the resource, as returned by Get.
+        # the name that must be specified on group creation.
+      "topologyCapability": "A String",
+    },
+    "interconnectStatuses": [
+      { # The status of one Interconnect in the group. The order is arbitrary.
+        "adminEnabled": True or False, # Output only. Whether the Interconnect is enabled.
+        "diagnostics": { # Diagnostics information about the Interconnect connection, which contains # Output only. The diagnostics of the Interconnect, as returned by the existing
+            # get-diagnostics method.
+            # detailed and current technical information about Google's side of the
+            # connection.
+          "arpCaches": [ # A list of InterconnectDiagnostics.ARPEntry objects,
+              # describing individual neighbors currently seen by the Google router in
+              # the ARP cache for the Interconnect.
+              # This will be empty when the Interconnect is not bundled.
+            { # Describing the ARP neighbor entries seen on this link
+              "ipAddress": "A String", # The IP address of this ARP neighbor.
+              "macAddress": "A String", # The MAC address of this ARP neighbor.
+            },
+          ],
+          "bundleAggregationType": "A String", # The aggregation type of the bundle interface.
+          "bundleOperationalStatus": "A String", # The operational status of the bundle interface.
+          "links": [ # A list of InterconnectDiagnostics.LinkStatus objects,
+              # describing the status for each link on the Interconnect.
+            {
+              "arpCaches": [ # A list of InterconnectDiagnostics.ARPEntry objects,
+                  # describing the ARP neighbor entries seen on this link.
+                  # This will be empty if the link is bundled
+                { # Describing the ARP neighbor entries seen on this link
+                  "ipAddress": "A String", # The IP address of this ARP neighbor.
+                  "macAddress": "A String", # The MAC address of this ARP neighbor.
+                },
+              ],
+              "circuitId": "A String", # The unique ID for this link assigned during turn up by Google.
+              "googleDemarc": "A String", # The Demarc address assigned by Google and provided in the LoA.
+              "lacpStatus": {
+                "googleSystemId": "A String", # System ID of the port on Google's side of the LACP exchange.
+                "neighborSystemId": "A String", # System ID of the port on the neighbor's side of the LACP exchange.
+                "state": "A String", # The state of a LACP link, which can take one of the following values:
+                    #
+                    #    - ACTIVE: The link is configured and active within the bundle.
+                    #    - DETACHED: The link is not configured within the bundle. This means
+                    #    that the rest of the object should be empty.
+              },
+              "macsec": { # Describes the status of MACsec encryption on the link. # Describes the status of MACsec encryption on this link.
+                "ckn": "A String", # Indicates the Connectivity Association Key Name (CKN)
+                    # currently being used if MACsec is operational.
+                "operational": True or False, # Indicates whether or not MACsec is operational on this link.
+              },
+              "operationalStatus": "A String", # The operational status of the link.
+              "receivingOpticalPower": { # An InterconnectDiagnostics.LinkOpticalPower object,
+                  # describing the current value and status of the received light level.
+                "state": "A String", # The status of the current value when compared to the warning and alarm
+                    # levels for the receiving or transmitting transceiver. Possible states
+                    # include:
+                    #
+                    #
+                    #     - OK: The value has not crossed a warning threshold.
+                    #     - LOW_WARNING: The value has crossed below the low
+                    #     warning threshold.
+                    #    - HIGH_WARNING: The value has
+                    #     crossed above the high warning threshold.
+                    #     - LOW_ALARM: The value has crossed below the low alarm
+                    #     threshold.
+                    #     - HIGH_ALARM: The value has crossed above the high alarm
+                    #     threshold.
+                "value": 3.14, # Value of the current receiving or transmitting optical power, read in
+                    # dBm. Take a known good optical value, give it a 10% margin and trigger
+                    # warnings relative to that value. In general, a -7dBm warning and a -11dBm
+                    # alarm are good optical value estimates for most links.
+              },
+              "transmittingOpticalPower": { # An InterconnectDiagnostics.LinkOpticalPower object,
+                  # describing the current value and status of the transmitted light level.
+                "state": "A String", # The status of the current value when compared to the warning and alarm
+                    # levels for the receiving or transmitting transceiver. Possible states
+                    # include:
+                    #
+                    #
+                    #     - OK: The value has not crossed a warning threshold.
+                    #     - LOW_WARNING: The value has crossed below the low
+                    #     warning threshold.
+                    #    - HIGH_WARNING: The value has
+                    #     crossed above the high warning threshold.
+                    #     - LOW_ALARM: The value has crossed below the low alarm
+                    #     threshold.
+                    #     - HIGH_ALARM: The value has crossed above the high alarm
+                    #     threshold.
+                "value": 3.14, # Value of the current receiving or transmitting optical power, read in
+                    # dBm. Take a known good optical value, give it a 10% margin and trigger
+                    # warnings relative to that value. In general, a -7dBm warning and a -11dBm
+                    # alarm are good optical value estimates for most links.
+              },
+            },
+          ],
+          "macAddress": "A String", # The MAC address of the Interconnect's bundle interface.
+        },
+        "interconnect": "A String", # Output only. The URL of the Interconnect being described.
+        "isActive": "A String", # Output only. Whether this interconnect is participating in the redundant
+            # configuration.
+      },
+    ],
+    "operational": { # [Output Only] The status of the group as configured. This has the same # Output only. The operational state of the group, including only active Interconnects.
+        # structure as the operational field reported by the OperationalStatus
+        # method, but does not take into account the operational status of each
+        # resource.
+      "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+          # this group does or does not meet the requirements for the intended
+          # capability.
+        "intendedCapabilityBlockers": [
+          { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+              # from intent.topologyCapability. This list is empty if and only if those
+              # are the same.
+            "blockerType": "A String",
+            "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                # this requirement. This is set for every type of requirement.
+            "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                # why it's not met. This is set for every type of requirement.
+            "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+                # Like physicalStructure.metros.facilities.facility, this is a numeric
+                # string like "5467".
+              "A String",
+            ],
+            "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+                # detail.
+              "A String",
+            ],
+            "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                # These are three-letter lowercase strings like "iad". A blocker like
+                # INCOMPATIBLE_METROS will specify the problematic metros in this
+                # field.
+              "A String",
+            ],
+            "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                # Zone names are "zone1" and/or "zone2".
+              "A String",
+            ],
+          },
+        ],
+        "supportedSla": "A String",
+      },
+    },
+  },
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a InterconnectGroup in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An interconnect group resource allows customers to create, analyze, and
+    # expand their redundant connections.
+  "configured": { # [Output Only] The status of the group as configured. This has the same
+      # structure as the operational field reported by the OperationalStatus
+      # method, but does not take into account the operational status of each
+      # resource.
+    "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+        # this group does or does not meet the requirements for the intended
+        # capability.
+      "intendedCapabilityBlockers": [
+        { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+            # from intent.topologyCapability. This list is empty if and only if those
+            # are the same.
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+              # Like physicalStructure.metros.facilities.facility, this is a numeric
+              # string like "5467".
+            "A String",
+          ],
+          "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+              # detail.
+            "A String",
+          ],
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". A blocker like
+              # INCOMPATIBLE_METROS will specify the problematic metros in this
+              # field.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Zone names are "zone1" and/or "zone2".
+            "A String",
+          ],
+        },
+      ],
+      "supportedSla": "A String",
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described by AIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this group. This is the only required field besides
+      # the name that must be specified on group creation.
+    "topologyCapability": "A String",
+  },
+  "interconnects": { # Interconnects in the InterconnectGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Interconnects per group" quota.
+    "a_key": { # An Interconnect in this InterconnectGroup.
+      "interconnect": "A String", # The URL of an Interconnect in this group. All Interconnects in the group
+          # are unique.
+    },
+  },
+  "kind": "compute#InterconnectGroup", # Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup
+  "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.
+  "physicalStructure": { # [Output Only] An analysis of the physical layout of Interconnects in this
+      # group. Every Interconnect in the group is shown once in this structure.
+    "metros": [
+      { # [Output Only] The metros Interconnects in this group are in.
+        "facilities": [
+          { # [Output Only] The facilities Interconnects in this metro are present
+              # in.
+            "facility": "A String", # Output only. [Output Only] The ID of this facility, as a numeric string like
+                # "5467". This is the third component of the location of Interconnects
+                # in this facility.
+            "zones": [
+              { # [Output Only] The zones that Interconnects in this facility are
+                  # present in.
+                "interconnects": [ # Output only. [Output Only] URLs of Interconnects in this redundancy group in the
+                    # given metro, facility, and zone.
+                  "A String",
+                ],
+                "zone": "A String", # Output only. [Output Only] The name of the zone, either "zone1" or "zone2".
+                    # This is the second component of the location of Interconnects in
+                    # this facility.
+              },
+            ],
+          },
+        ],
+        "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase string
+            # like "iad". This is the first component of the location of
+            # Interconnects underneath this.
+      },
+    ],
+  },
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the InterconnectGroups for a project in the given scope.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InterconnectGroup resources.
+    { # An interconnect group resource allows customers to create, analyze, and
+        # expand their redundant connections.
+      "configured": { # [Output Only] The status of the group as configured. This has the same
+          # structure as the operational field reported by the OperationalStatus
+          # method, but does not take into account the operational status of each
+          # resource.
+        "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+            # this group does or does not meet the requirements for the intended
+            # capability.
+          "intendedCapabilityBlockers": [
+            { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+                # from intent.topologyCapability. This list is empty if and only if those
+                # are the same.
+              "blockerType": "A String",
+              "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+                  # this requirement. This is set for every type of requirement.
+              "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+                  # why it's not met. This is set for every type of requirement.
+              "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+                  # Like physicalStructure.metros.facilities.facility, this is a numeric
+                  # string like "5467".
+                "A String",
+              ],
+              "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+                  # detail.
+                "A String",
+              ],
+              "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+                  # These are three-letter lowercase strings like "iad". A blocker like
+                  # INCOMPATIBLE_METROS will specify the problematic metros in this
+                  # field.
+                "A String",
+              ],
+              "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+                  # Zone names are "zone1" and/or "zone2".
+                "A String",
+              ],
+            },
+          ],
+          "supportedSla": "A String",
+        },
+      },
+      "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.
+      "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+          # If provided when patching a configuration in update mode, the provided
+          # token must match the current token or the update is rejected. This provides
+          # a reliable means of doing read-modify-write (optimistic locking) as
+          # described by AIP 154.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "intent": { # The user's intent for this group. This is the only required field besides
+          # the name that must be specified on group creation.
+        "topologyCapability": "A String",
+      },
+      "interconnects": { # Interconnects in the InterconnectGroup. Keys are arbitrary user-specified
+          # strings. Users are encouraged, but not required, to use their preferred
+          # format for resource links as keys.
+          # Note that there are add-members and remove-members methods in gcloud.
+          # The size of this map is limited by an "Interconnects per group" quota.
+        "a_key": { # An Interconnect in this InterconnectGroup.
+          "interconnect": "A String", # The URL of an Interconnect in this group. All Interconnects in the group
+              # are unique.
+        },
+      },
+      "kind": "compute#InterconnectGroup", # Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup
+      "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.
+      "physicalStructure": { # [Output Only] An analysis of the physical layout of Interconnects in this
+          # group. Every Interconnect in the group is shown once in this structure.
+        "metros": [
+          { # [Output Only] The metros Interconnects in this group are in.
+            "facilities": [
+              { # [Output Only] The facilities Interconnects in this metro are present
+                  # in.
+                "facility": "A String", # Output only. [Output Only] The ID of this facility, as a numeric string like
+                    # "5467". This is the third component of the location of Interconnects
+                    # in this facility.
+                "zones": [
+                  { # [Output Only] The zones that Interconnects in this facility are
+                      # present in.
+                    "interconnects": [ # Output only. [Output Only] URLs of Interconnects in this redundancy group in the
+                        # given metro, facility, and zone.
+                      "A String",
+                    ],
+                    "zone": "A String", # Output only. [Output Only] The name of the zone, either "zone1" or "zone2".
+                        # This is the second component of the location of Interconnects in
+                        # this facility.
+                  },
+                ],
+              },
+            ],
+            "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase string
+                # like "iad". This is the first component of the location of
+                # Interconnects underneath this.
+          },
+        ],
+      },
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    },
+  ],
+  "kind": "compute#InterconnectGroup",
+  "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.
+  "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.
+
+
+ +
+ patch(project, interconnectGroup, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patches the specified InterconnectGroup resource with the data included in
+the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectGroup: string, Name of the InterconnectGroup resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An interconnect group resource allows customers to create, analyze, and
+    # expand their redundant connections.
+  "configured": { # [Output Only] The status of the group as configured. This has the same
+      # structure as the operational field reported by the OperationalStatus
+      # method, but does not take into account the operational status of each
+      # resource.
+    "topologyCapability": { # [Output Only] How reliable this topology is configured to be, and why
+        # this group does or does not meet the requirements for the intended
+        # capability.
+      "intendedCapabilityBlockers": [
+        { # [Output Only] Reasons why configuration.topologyCapability.sla differs
+            # from intent.topologyCapability. This list is empty if and only if those
+            # are the same.
+          "blockerType": "A String",
+          "documentationLink": "A String", # Output only. [Output Only] The url of Google Cloud public documentation explaining
+              # this requirement. This is set for every type of requirement.
+          "explanation": "A String", # Output only. [Output Only] A human-readable explanation of this requirement and
+              # why it's not met. This is set for every type of requirement.
+          "facilities": [ # Output only. [Output Only] Facilities used to explain this blocker in more detail.
+              # Like physicalStructure.metros.facilities.facility, this is a numeric
+              # string like "5467".
+            "A String",
+          ],
+          "interconnects": [ # Output only. [Output Only] Interconnects used to explain this blocker in more
+              # detail.
+            "A String",
+          ],
+          "metros": [ # Output only. [Output Only] Metros used to explain this blocker in more detail.
+              # These are three-letter lowercase strings like "iad". A blocker like
+              # INCOMPATIBLE_METROS will specify the problematic metros in this
+              # field.
+            "A String",
+          ],
+          "zones": [ # Output only. [Output Only] Zones used to explain this blocker in more detail.
+              # Zone names are "zone1" and/or "zone2".
+            "A String",
+          ],
+        },
+      ],
+      "supportedSla": "A String",
+    },
+  },
+  "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.
+  "etag": "A String", # Opaque system-generated token that uniquely identifies the configuration.
+      # If provided when patching a configuration in update mode, the provided
+      # token must match the current token or the update is rejected. This provides
+      # a reliable means of doing read-modify-write (optimistic locking) as
+      # described by AIP 154.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "intent": { # The user's intent for this group. This is the only required field besides
+      # the name that must be specified on group creation.
+    "topologyCapability": "A String",
+  },
+  "interconnects": { # Interconnects in the InterconnectGroup. Keys are arbitrary user-specified
+      # strings. Users are encouraged, but not required, to use their preferred
+      # format for resource links as keys.
+      # Note that there are add-members and remove-members methods in gcloud.
+      # The size of this map is limited by an "Interconnects per group" quota.
+    "a_key": { # An Interconnect in this InterconnectGroup.
+      "interconnect": "A String", # The URL of an Interconnect in this group. All Interconnects in the group
+          # are unique.
+    },
+  },
+  "kind": "compute#InterconnectGroup", # Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup
+  "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.
+  "physicalStructure": { # [Output Only] An analysis of the physical layout of Interconnects in this
+      # group. Every Interconnect in the group is shown once in this structure.
+    "metros": [
+      { # [Output Only] The metros Interconnects in this group are in.
+        "facilities": [
+          { # [Output Only] The facilities Interconnects in this metro are present
+              # in.
+            "facility": "A String", # Output only. [Output Only] The ID of this facility, as a numeric string like
+                # "5467". This is the third component of the location of Interconnects
+                # in this facility.
+            "zones": [
+              { # [Output Only] The zones that Interconnects in this facility are
+                  # present in.
+                "interconnects": [ # Output only. [Output Only] URLs of Interconnects in this redundancy group in the
+                    # given metro, facility, and zone.
+                  "A String",
+                ],
+                "zone": "A String", # Output only. [Output Only] The name of the zone, either "zone1" or "zone2".
+                    # This is the second component of the location of Interconnects in
+                    # this facility.
+              },
+            ],
+          },
+        ],
+        "metro": "A String", # Output only. [Output Only] The name of the metro, as a three-letter lowercase string
+            # like "iad". This is the first component of the location of
+            # Interconnects underneath this.
+      },
+    ],
+  },
+  "selfLink": "A String", # Output only. [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).
+end_interface: MixerMutationRequestBuilder
+  updateMask: string, The list of fields to update.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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_preview.interconnectLocations.html b/docs/dyn/compute_preview.interconnectLocations.html new file mode 100644 index 0000000000..c720125c8a --- /dev/null +++ b/docs/dyn/compute_preview.interconnectLocations.html @@ -0,0 +1,443 @@ + + + +

Compute Engine API . interconnectLocations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, interconnectLocation, x__xgafv=None)

+

Returns the details for the specified interconnect location. Gets a list of

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of interconnect locations available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, interconnectLocation, x__xgafv=None) + 
Returns the details for the specified interconnect location. Gets a list of
+available interconnect locations by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectLocation: string, Name of the interconnect location 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 an Interconnect Attachment (VLAN) Location resource.
+    #
+    # You can use this resource to find location details about an Interconnect
+    # attachment (VLAN). For more information about interconnect attachments, read
+    # Creating VLAN Attachments.
+  "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in
+      # the address is separated by a newline character.
+  "availabilityZone": "A String", # [Output Only] Availability zone for this InterconnectLocation. Within a
+      # metropolitan area (metro), maintenance will not be simultaneously scheduled
+      # in more than one availability zone.  Example: "zone1" or "zone2".
+  "availableFeatures": [ # [Output only] List of features available at this InterconnectLocation,
+      # which can take one of the following values:
+      #
+      #    - IF_MACSEC
+      #    - IF_CROSS_SITE_NETWORK
+    "A String",
+  ],
+  "availableLinkTypes": [ # [Output only] List of link types available at this InterconnectLocation,
+      # which can take one of the following values:
+      #
+      #    - LINK_TYPE_ETHERNET_10G_LR
+      #    - LINK_TYPE_ETHERNET_100G_LR
+      #    - LINK_TYPE_ETHERNET_400G_LR4
+    "A String",
+  ],
+  "city": "A String", # [Output Only] Metropolitan area designator that indicates which city an
+      # interconnect is located.
+      # For example: "Chicago, IL", "Amsterdam, Netherlands".
+  "continent": "A String", # [Output Only] Continent for this location, which can take one of the
+      # following values:
+      #
+      #    - AFRICA
+      #    - ASIA_PAC
+      #    - EUROPE
+      #    - NORTH_AMERICA
+      #    - SOUTH_AMERICA
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "crossSiteInterconnectInfos": [ # [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo
+      # objects, that describe where Cross-Site Interconnect wires may connect to
+      # from this location and associated connection parameters. Cross-Site
+      # Interconnect isn't allowed to locations which are not listed.
+    { # Information about Cross-Site Interconnect wires which may be created
+        # between the containing location and another remote location.
+      "city": "A String", # Output only. The remote location for Cross-Site Interconnect wires. This specifies an
+          # InterconnectLocation city (metropolitan area designator), which itself
+          # may match multiple InterconnectLocations.
+      "maxDynamicPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for dynamic paths allowable per
+          # WireGroup for this metro.
+      "maxFixedPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for fixed paths allowable per WireGroup
+          # for this metro.
+    },
+  ],
+  "description": "A String", # Output only. [Output Only] An optional description of the resource.
+  "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).
+  "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,
+      # Ashburn-DC1).
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#interconnectLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations.
+  "name": "A String", # Output only. [Output Only] Name of the resource.
+  "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding
+      # with a netfac type in peeringdb).
+  "regionInfos": [ # Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that
+      # describe parameters pertaining to the relation between this
+      # InterconnectLocation and various Google Cloud regions.
+    { # Information about any potential InterconnectAttachments between an
+        # Interconnect at a specific InterconnectLocation, and a specific Cloud
+        # Region.
+      "expectedRttMs": "A String", # Output only. Expected round-trip time in milliseconds, from this InterconnectLocation
+          # to a VM in this region.
+      "l2ForwardingEnabled": True or False, # Output only. Identifies whether L2 Interconnect Attachments can be created in this
+          # region for interconnects that are in this location.
+      "locationPresence": "A String", # Output only. Identifies the network presence of this location.
+      "region": "A String", # Output only. URL for the region of this location.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "singleRegionProductionCriticalPeerLocations": [ # Output only. [Output Only] URLs of the other locations that can pair up with this
+      # location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and
+      # iad-zone2-5467 are Single-Region 99.99% peer locations of each other.
+    "A String",
+  ],
+  "status": "A String", # [Output Only] The status of this InterconnectLocation, which can take one
+      # of the following values:
+      #
+      #    - CLOSED: The InterconnectLocation is closed and is unavailable for
+      #    provisioning new Interconnects.
+      #    - AVAILABLE: The InterconnectLocation is available for provisioning new
+      #    Interconnects.
+  "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of interconnect locations available to 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request, and contains a list of interconnect locations.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InterconnectLocation resources.
+    { # Represents an Interconnect Attachment (VLAN) Location resource.
+        #
+        # You can use this resource to find location details about an Interconnect
+        # attachment (VLAN). For more information about interconnect attachments, read
+        # Creating VLAN Attachments.
+      "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in
+          # the address is separated by a newline character.
+      "availabilityZone": "A String", # [Output Only] Availability zone for this InterconnectLocation. Within a
+          # metropolitan area (metro), maintenance will not be simultaneously scheduled
+          # in more than one availability zone.  Example: "zone1" or "zone2".
+      "availableFeatures": [ # [Output only] List of features available at this InterconnectLocation,
+          # which can take one of the following values:
+          #
+          #    - IF_MACSEC
+          #    - IF_CROSS_SITE_NETWORK
+        "A String",
+      ],
+      "availableLinkTypes": [ # [Output only] List of link types available at this InterconnectLocation,
+          # which can take one of the following values:
+          #
+          #    - LINK_TYPE_ETHERNET_10G_LR
+          #    - LINK_TYPE_ETHERNET_100G_LR
+          #    - LINK_TYPE_ETHERNET_400G_LR4
+        "A String",
+      ],
+      "city": "A String", # [Output Only] Metropolitan area designator that indicates which city an
+          # interconnect is located.
+          # For example: "Chicago, IL", "Amsterdam, Netherlands".
+      "continent": "A String", # [Output Only] Continent for this location, which can take one of the
+          # following values:
+          #
+          #    - AFRICA
+          #    - ASIA_PAC
+          #    - EUROPE
+          #    - NORTH_AMERICA
+          #    - SOUTH_AMERICA
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "crossSiteInterconnectInfos": [ # [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo
+          # objects, that describe where Cross-Site Interconnect wires may connect to
+          # from this location and associated connection parameters. Cross-Site
+          # Interconnect isn't allowed to locations which are not listed.
+        { # Information about Cross-Site Interconnect wires which may be created
+            # between the containing location and another remote location.
+          "city": "A String", # Output only. The remote location for Cross-Site Interconnect wires. This specifies an
+              # InterconnectLocation city (metropolitan area designator), which itself
+              # may match multiple InterconnectLocations.
+          "maxDynamicPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for dynamic paths allowable per
+              # WireGroup for this metro.
+          "maxFixedPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for fixed paths allowable per WireGroup
+              # for this metro.
+        },
+      ],
+      "description": "A String", # Output only. [Output Only] An optional description of the resource.
+      "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).
+      "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,
+          # Ashburn-DC1).
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#interconnectLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations.
+      "name": "A String", # Output only. [Output Only] Name of the resource.
+      "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding
+          # with a netfac type in peeringdb).
+      "regionInfos": [ # Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that
+          # describe parameters pertaining to the relation between this
+          # InterconnectLocation and various Google Cloud regions.
+        { # Information about any potential InterconnectAttachments between an
+            # Interconnect at a specific InterconnectLocation, and a specific Cloud
+            # Region.
+          "expectedRttMs": "A String", # Output only. Expected round-trip time in milliseconds, from this InterconnectLocation
+              # to a VM in this region.
+          "l2ForwardingEnabled": True or False, # Output only. Identifies whether L2 Interconnect Attachments can be created in this
+              # region for interconnects that are in this location.
+          "locationPresence": "A String", # Output only. Identifies the network presence of this location.
+          "region": "A String", # Output only. URL for the region of this location.
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "singleRegionProductionCriticalPeerLocations": [ # Output only. [Output Only] URLs of the other locations that can pair up with this
+          # location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and
+          # iad-zone2-5467 are Single-Region 99.99% peer locations of each other.
+        "A String",
+      ],
+      "status": "A String", # [Output Only] The status of this InterconnectLocation, which can take one
+          # of the following values:
+          #
+          #    - CLOSED: The InterconnectLocation is closed and is unavailable for
+          #    provisioning new Interconnects.
+          #    - AVAILABLE: The InterconnectLocation is available for provisioning new
+          #    Interconnects.
+      "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+    },
+  ],
+  "kind": "compute#interconnectLocationList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect
+      # locations.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.interconnectRemoteLocations.html b/docs/dyn/compute_preview.interconnectRemoteLocations.html new file mode 100644 index 0000000000..07a85e3936 --- /dev/null +++ b/docs/dyn/compute_preview.interconnectRemoteLocations.html @@ -0,0 +1,504 @@ + + + +

Compute Engine API . interconnectRemoteLocations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, interconnectRemoteLocation, x__xgafv=None)

+

Returns the details for the specified interconnect remote location. Gets a

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of interconnect remote locations available to the

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, interconnectRemoteLocation, x__xgafv=None) + 
Returns the details for the specified interconnect remote location. Gets a
+list of available interconnect remote locations by making alist() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnectRemoteLocation: string, Name of the interconnect remote location 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 Cross-Cloud Interconnect Remote Location resource.
+    #
+    # You can use this resource to find remote location details about an
+    # Interconnect attachment (VLAN).
+  "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in
+      # the address is separated by a newline character.
+  "attachmentConfigurationConstraints": { # Output only. [Output Only] Subset of fields from InterconnectAttachment's
+      # |configurationConstraints| field that apply to all attachments for this
+      # remote location.
+    "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+        # requires/allows/disallows BGP MD5 authentication. This can take one of
+        # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+        #
+        # For example, a Cross-Cloud Interconnect connection to a remote cloud
+        # provider that requires BGP MD5 authentication has the
+        # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+        # field set to MD5_REQUIRED, and that property is propagated to the
+        # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+        # returned if MD5 is requested.
+    "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+        # support. Formatted as an array of inclusive ranges {min: min-value, max:
+        # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+        # allows the peer ASN to be 123 or anything in the range 64512-65534.
+        #
+        # This field is only advisory. Although the API accepts other ranges, these
+        # are the ranges that we recommend.
+      {
+        "max": 42,
+        "min": 42,
+      },
+    ],
+  },
+  "city": "A String", # Output only. [Output Only] Metropolitan area designator that indicates which city an
+      # interconnect is located.
+      # For example: "Chicago, IL", "Amsterdam, Netherlands".
+  "constraints": { # Output only. [Output Only] Constraints on the parameters for creating Cross-Cloud
+      # Interconnect and associated InterconnectAttachments.
+    "portPairRemoteLocation": "A String", # Output only. [Output Only] Port pair remote location constraints, which can take one
+        # of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION,
+        # PORT_PAIR_MATCHING_REMOTE_LOCATION.
+        #
+        # Google Cloud API refers only to individual ports, but the UI uses this
+        # field when ordering a pair of ports, to prevent users from accidentally
+        # ordering something that is incompatible with their cloud provider.
+        # Specifically, when ordering a redundant pair of Cross-Cloud Interconnect
+        # ports, and one of them uses a remote location with
+        # portPairMatchingRemoteLocation set to matching, the UI requires that
+        # both ports use the same remote location.
+    "portPairVlan": "A String", # Output only. [Output Only] Port pair VLAN constraints, which can take one of the
+        # following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN
+    "subnetLengthRange": { # Output only. [Output Only]
+        #
+        # [min-length, max-length]
+        #
+        # The minimum and maximum value (inclusive) for the IPv4 subnet
+        # length.
+        #
+        #  For example, an  interconnectRemoteLocation for Azure has {min: 30,
+        # max:
+        # 30} because Azure requires /30 subnets.
+        #
+        # This range specifies the values supported by both cloud providers.
+        # Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a
+        # remote cloud has no constraint on IPv4 subnet length, the range would
+        # thus be {min: 29, max: 30}.
+      "max": 42,
+      "min": 42,
+    },
+  },
+  "continent": "A String", # Output only. [Output Only] Continent for this location, which can take one of the
+      # following values:
+      #
+      #    - AFRICA
+      #    - ASIA_PAC
+      #    - EUROPE
+      #    - NORTH_AMERICA
+      #    - SOUTH_AMERICA
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Output only. [Output Only] An optional description of the resource.
+  "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).
+  "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,
+      # Ashburn-DC1).
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#interconnectRemoteLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote
+      # locations.
+  "lacp": "A String", # Output only. [Output Only] Link Aggregation Control Protocol (LACP) constraints, which
+      # can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED
+  "maxLagSize100Gbps": 42, # Output only. [Output Only]
+      # The maximum number of 100 Gbps ports supported in a link aggregation group
+      # (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed
+      # max_lag_size_100_gbps.
+  "maxLagSize10Gbps": 42, # Output only. [Output Only]
+      # The maximum number of 10 Gbps ports supported in a link aggregation group
+      # (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed
+      # max_lag_size_10_gbps.
+  "maxLagSize400Gbps": 42, # Output only. [Output Only]
+      # The maximum number of 400 Gbps ports supported in a link aggregation group
+      # (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed
+      # max_lag_size_400_gbps.
+  "name": "A String", # Output only. [Output Only] Name of the resource.
+  "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding
+      # with a netfac type in peeringdb).
+  "permittedConnections": [ # Output only. [Output Only] Permitted connections.
+    {
+      "interconnectLocation": "A String", # Output only. [Output Only] URL of an Interconnect location that is permitted to
+          # connect to this Interconnect remote location.
+    },
+  ],
+  "remoteService": "A String", # Output only. [Output Only] Indicates the service provider present at the remote
+      # location. Example values: "Amazon Web Services", "Microsoft Azure".
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "status": "A String", # Output only. [Output Only] The status of this InterconnectRemoteLocation, which can take
+      # one of the following values:
+      #
+      #    - CLOSED: The InterconnectRemoteLocation is closed and is unavailable
+      #    for provisioning new Cross-Cloud Interconnects.
+      #    - AVAILABLE: The
+      #    InterconnectRemoteLocation is available for provisioning new
+      #    Cross-Cloud Interconnects.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of interconnect remote locations available to 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request, and contains a list of interconnect remote
+    # locations.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InterconnectRemoteLocation resources.
+    { # Represents a Cross-Cloud Interconnect Remote Location resource.
+        #
+        # You can use this resource to find remote location details about an
+        # Interconnect attachment (VLAN).
+      "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in
+          # the address is separated by a newline character.
+      "attachmentConfigurationConstraints": { # Output only. [Output Only] Subset of fields from InterconnectAttachment's
+          # |configurationConstraints| field that apply to all attachments for this
+          # remote location.
+        "bgpMd5": "A String", # Output only. [Output Only] Whether the attachment's BGP session
+            # requires/allows/disallows BGP MD5 authentication. This can take one of
+            # the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.
+            #
+            # For example, a Cross-Cloud Interconnect connection to a remote cloud
+            # provider that requires BGP MD5 authentication has the
+            # interconnectRemoteLocation attachment_configuration_constraints.bgp_md5
+            # field set to MD5_REQUIRED, and that property is propagated to the
+            # attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is
+            # returned if MD5 is requested.
+        "bgpPeerAsnRanges": [ # Output only. [Output Only] List of ASN ranges that the remote location is known to
+            # support. Formatted as an array of inclusive ranges {min: min-value, max:
+            # max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]
+            # allows the peer ASN to be 123 or anything in the range 64512-65534.
+            #
+            # This field is only advisory. Although the API accepts other ranges, these
+            # are the ranges that we recommend.
+          {
+            "max": 42,
+            "min": 42,
+          },
+        ],
+      },
+      "city": "A String", # Output only. [Output Only] Metropolitan area designator that indicates which city an
+          # interconnect is located.
+          # For example: "Chicago, IL", "Amsterdam, Netherlands".
+      "constraints": { # Output only. [Output Only] Constraints on the parameters for creating Cross-Cloud
+          # Interconnect and associated InterconnectAttachments.
+        "portPairRemoteLocation": "A String", # Output only. [Output Only] Port pair remote location constraints, which can take one
+            # of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION,
+            # PORT_PAIR_MATCHING_REMOTE_LOCATION.
+            #
+            # Google Cloud API refers only to individual ports, but the UI uses this
+            # field when ordering a pair of ports, to prevent users from accidentally
+            # ordering something that is incompatible with their cloud provider.
+            # Specifically, when ordering a redundant pair of Cross-Cloud Interconnect
+            # ports, and one of them uses a remote location with
+            # portPairMatchingRemoteLocation set to matching, the UI requires that
+            # both ports use the same remote location.
+        "portPairVlan": "A String", # Output only. [Output Only] Port pair VLAN constraints, which can take one of the
+            # following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN
+        "subnetLengthRange": { # Output only. [Output Only]
+            #
+            # [min-length, max-length]
+            #
+            # The minimum and maximum value (inclusive) for the IPv4 subnet
+            # length.
+            #
+            #  For example, an  interconnectRemoteLocation for Azure has {min: 30,
+            # max:
+            # 30} because Azure requires /30 subnets.
+            #
+            # This range specifies the values supported by both cloud providers.
+            # Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a
+            # remote cloud has no constraint on IPv4 subnet length, the range would
+            # thus be {min: 29, max: 30}.
+          "max": 42,
+          "min": 42,
+        },
+      },
+      "continent": "A String", # Output only. [Output Only] Continent for this location, which can take one of the
+          # following values:
+          #
+          #    - AFRICA
+          #    - ASIA_PAC
+          #    - EUROPE
+          #    - NORTH_AMERICA
+          #    - SOUTH_AMERICA
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # Output only. [Output Only] An optional description of the resource.
+      "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).
+      "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,
+          # Ashburn-DC1).
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#interconnectRemoteLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote
+          # locations.
+      "lacp": "A String", # Output only. [Output Only] Link Aggregation Control Protocol (LACP) constraints, which
+          # can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED
+      "maxLagSize100Gbps": 42, # Output only. [Output Only]
+          # The maximum number of 100 Gbps ports supported in a link aggregation group
+          # (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed
+          # max_lag_size_100_gbps.
+      "maxLagSize10Gbps": 42, # Output only. [Output Only]
+          # The maximum number of 10 Gbps ports supported in a link aggregation group
+          # (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed
+          # max_lag_size_10_gbps.
+      "maxLagSize400Gbps": 42, # Output only. [Output Only]
+          # The maximum number of 400 Gbps ports supported in a link aggregation group
+          # (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed
+          # max_lag_size_400_gbps.
+      "name": "A String", # Output only. [Output Only] Name of the resource.
+      "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding
+          # with a netfac type in peeringdb).
+      "permittedConnections": [ # Output only. [Output Only] Permitted connections.
+        {
+          "interconnectLocation": "A String", # Output only. [Output Only] URL of an Interconnect location that is permitted to
+              # connect to this Interconnect remote location.
+        },
+      ],
+      "remoteService": "A String", # Output only. [Output Only] Indicates the service provider present at the remote
+          # location. Example values: "Amazon Web Services", "Microsoft Azure".
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "status": "A String", # Output only. [Output Only] The status of this InterconnectRemoteLocation, which can take
+          # one of the following values:
+          #
+          #    - CLOSED: The InterconnectRemoteLocation is closed and is unavailable
+          #    for provisioning new Cross-Cloud Interconnects.
+          #    - AVAILABLE: The
+          #    InterconnectRemoteLocation is available for provisioning new
+          #    Cross-Cloud Interconnects.
+    },
+  ],
+  "kind": "compute#interconnectRemoteLocationList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of
+      # interconnect remote locations.
+  "nextPageToken": "A String", # [Output Only] This token lets you 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.interconnects.html b/docs/dyn/compute_preview.interconnects.html new file mode 100644 index 0000000000..2d1d372171 --- /dev/null +++ b/docs/dyn/compute_preview.interconnects.html @@ -0,0 +1,2786 @@ + + + +

Compute Engine API . interconnects

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, interconnect, requestId=None, x__xgafv=None)

+

Deletes the specified Interconnect.

+

+ get(project, interconnect, x__xgafv=None)

+

Returns the specified Interconnect. Get a list of available Interconnects

+

+ getDiagnostics(project, interconnect, x__xgafv=None)

+

Returns the interconnectDiagnostics for the specified

+

+ getMacsecConfig(project, interconnect, x__xgafv=None)

+

Returns the interconnectMacsecConfig for the specified

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates an Interconnect in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Interconnects available to the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, interconnect, body=None, requestId=None, x__xgafv=None)

+

Updates the specified Interconnect with the data included in the request.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on an Interconnect. To learn more about labels,

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, interconnect, requestId=None, x__xgafv=None) + 
Deletes the specified Interconnect.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnect: string, Name of the interconnect 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, interconnect, x__xgafv=None) + 
Returns the specified Interconnect. Get a list of available Interconnects
+by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnect: string, Name of the interconnect 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 an Interconnect resource.
+    #
+    # An Interconnect resource is a dedicated connection between the Google
+    # Cloud network and your on-premises network. For more information, read the
+    # Dedicated Interconnect Overview.
+  "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud
+      # Interconnect.
+  "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+      # Interconnect is functional and can carry traffic.
+      # When set to false, no packets can be carried over the interconnect and
+      # no BGP routes are exchanged over it. By default, the status is set to true.
+  "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud # Configuration information for application awareness on this Cloud
+      # Interconnect.
+      # Interconnect.
+    "bandwidthPercentagePolicy": {
+      "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing
+          # type Bandwidth Percent.
+        { # Specify bandwidth percentages [1-100] for various traffic classes in
+            # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+            # All traffic classes must have a percentage value specified.
+          "percentage": 42, # Bandwidth percentage for a specific traffic class.
+          "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+        },
+      ],
+    },
+    "profileDescription": "A String", # Description for the application awareness profile on this Cloud
+        # Interconnect.
+    "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be
+        # applied in conjunction with StrictPriorityPolicy or
+        # BandwidthPercentagePolicy.
+      { # Specify bandwidth percentages [1-100] for various traffic classes in
+          # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+          # All traffic classes must have a percentage value specified.
+        "percentage": 42, # Bandwidth percentage for a specific traffic class.
+        "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+      },
+    ],
+    "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy.
+    },
+  },
+  "availableFeatures": [ # [Output only] List of features available for this Interconnect connection,
+      # which can take one of the following values:
+      #
+      #    - IF_MACSEC: If present, then the Interconnect connection is
+      #    provisioned on MACsec capable hardware ports. If not present, then the
+      #    Interconnect connection is provisioned on non-MACsec capable ports. Any
+      #    attempt to enable MACsec will fail.
+      #    - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is
+      #    provisioned exclusively for Cross-Site Networking. Any attempt to configure
+      #    VLAN attachments will fail. If not present, then the Interconnect
+      #    connection is not provisioned for Cross-Site Networking. Any attempt to use
+      #    it for Cross-Site Networking will fail.
+    "A String",
+  ],
+  "circuitInfos": [ # Output only. [Output Only] A list of CircuitInfo objects, that describe the individual
+      # circuits in this LAG.
+    { # Describes a single physical circuit between the Customer and Google.
+        # CircuitInfo objects are created by Google, so all fields are output only.
+      "customerDemarcId": "A String", # Customer-side demarc ID for this circuit.
+      "googleCircuitId": "A String", # Google-assigned unique ID for this circuit. Assigned at circuit turn-up.
+      "googleDemarcId": "A String", # Google-side demarc ID for this circuit. Assigned at circuit turn-up and
+          # provided by Google to the customer in the LOA.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+      # authorized to request a crossconnect.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "effectiveLocation": "A String", # Output only. URL of the InterconnectLocation object that represents where
+      # this connection is to be provisioned. By default it will be the same as the
+      # location field.
+  "expectedOutages": [ # Output only. [Output Only] A list of outages expected for this Interconnect.
+    { # Description of a planned outage on this Interconnect.
+      "affectedCircuits": [ # If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit
+          # IDs that will be affected.
+        "A String",
+      ],
+      "description": "A String", # A description about the purpose of the outage.
+      "endTime": "A String", # Scheduled end time for the outage (milliseconds since Unix
+          # epoch).
+      "issueType": "A String", # Form this outage is expected to take, which can take one of the following
+          # values:
+          #
+          #    - OUTAGE: The Interconnect may be completely out of service for
+          #    some or all of the specified window.
+          #    - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole
+          #    should remain up, but with reduced bandwidth.
+          #
+          #
+          # Note that the versions of this enum prefixed with "IT_" have been
+          # deprecated in favor of the unprefixed values.
+      "name": "A String", # Unique identifier for this outage notification.
+      "source": "A String", # The party that generated this notification, which can take the following
+          # value:
+          #
+          #    - GOOGLE: this notification as generated by Google.
+          #
+          #
+          # Note that the value of NSRC_GOOGLE has been deprecated in favor of
+          # GOOGLE.
+      "startTime": "A String", # Scheduled start time for the outage (milliseconds since Unix
+          # epoch).
+      "state": "A String", # State of this notification, which can take one of the following values:
+          #
+          #    - ACTIVE: This outage notification is active. The event could be in
+          #    the past, present, or future. See start_time and end_time for
+          #    scheduling.
+          #    - CANCELLED: The outage associated with this notification was cancelled
+          #    before the outage was due to start.
+          #    - COMPLETED: The outage associated with this notification is complete.
+          #
+          #
+          # Note that the versions of this enum prefixed with "NS_" have been
+          # deprecated in favor of the unprefixed values.
+    },
+  ],
+  "googleIpAddress": "A String", # Output only. [Output Only] IP address configured on the Google side of the Interconnect
+      # link. This can be used only for ping tests.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnectAttachments": [ # Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured
+      # to use  this Interconnect.
+    "A String",
+  ],
+  "interconnectGroups": [ # Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.
+      # Order is arbitrary and items are unique.
+    "A String",
+  ],
+  "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+      #
+      #    - PARTNER: A partner-managed interconnection shared between customers
+      #    though a partner.
+      #    - DEDICATED: A dedicated physical interconnection with the
+      #    customer.
+      #
+      #
+      # Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.
+  "kind": "compute#interconnect", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Interconnect, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Interconnect.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "linkType": "A String", # Type of link requested, which can take one of the following values:
+      #
+      #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+      #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+      #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.
+      #
+      #
+      #  Note that this field indicates the speed of each of
+      # the links in the bundle, not the speed of the entire bundle.
+  "location": "A String", # URL of the InterconnectLocation object that represents where this
+      # connection is to be provisioned.
+  "macsec": { # Configuration information for enabling Media Access Control security # Configuration that enables Media Access Control security (MACsec) on the
+      # Cloud Interconnect connection between Google and your on-premises router.
+      # (MACsec) on this Cloud Interconnect connection between Google and your
+      # on-premises router.
+    "failOpen": True or False, # If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google
+        # router to fallback to cleartext traffic if the MKA session cannot be
+        # established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the
+        # MKA session cannot be established with your router.
+    "preSharedKeys": [ # Required. A keychain placeholder describing a set of named key objects
+        # along with their start times. A MACsec CKN/CAK is generated for each
+        # key in the key chain. Google router automatically picks the key with
+        # the most recent startTime when establishing or re-establishing a MACsec
+        # secure link.
+      { # Describes a pre-shared key used to setup MACsec in static connectivity
+          # association key (CAK) mode.
+        "name": "A String", # Required. A name for this pre-shared key.
+            # 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.
+        "startTime": "A String", # A RFC3339 timestamp on or after which the key is
+            # valid. startTime can be in the future. If the keychain has a single
+            # key, startTime can be omitted. If the keychain has multiple keys,
+            # startTime is mandatory for each key. The start times of keys must be in
+            # increasing order. The start times of two consecutive keys must be
+            # at least 6 hours apart.
+      },
+    ],
+  },
+  "macsecEnabled": True or False, # Enable or disable MACsec on this Interconnect connection. MACsec enablement
+      # fails if the MACsec object is not specified.
+  "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.
+  "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+      # notifications regarding this Interconnect. If specified, this will be used
+      # for notifications in addition to all other forms described, such as
+      # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+      # required for users who sign up for Cloud Interconnect using
+      # workforce identity federation.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of this Interconnect's functionality,
+      # which can take one of the following values:
+      #
+      #    - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to
+      #    use. Attachments may be provisioned on this Interconnect.
+      #
+      # - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No
+      # attachments may be provisioned on this Interconnect.
+      # - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal
+      # maintenance. No attachments may be provisioned or updated on this
+      # Interconnect.
+  "params": { # Additional interconnect 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.
+        # 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",
+    },
+  },
+  "peerIpAddress": "A String", # Output only. [Output Only] IP address configured on the customer side of the
+      # Interconnect link. The customer should configure this IP address during
+      # turnup when prompted by Google NOC. This can be used only for ping tests.
+  "provisionedLinkCount": 42, # Output only. [Output Only] Number of links actually provisioned in this interconnect.
+  "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies the
+      # location outside of Google's network that the interconnect is connected to.
+  "requestedFeatures": [ # Optional. This parameter can be provided only with Interconnect INSERT. It
+      # isn't valid for Interconnect PATCH. List of features requested for this
+      # Interconnect connection, which can take one of the following values:
+      #
+      #    - IF_MACSEC: If specified, then the connection is created on MACsec
+      #    capable hardware ports. If not specified, non-MACsec capable ports will
+      #    also be considered.
+      #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+      #    exclusively for Cross-Site Networking. The connection can not be used for
+      #    Cross-Site Networking unless this feature is specified.
+    "A String",
+  ],
+  "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+      # customer.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. [Output Only] The current state of Interconnect functionality, which can
+      # take one of the following values:
+      #
+      #    - ACTIVE: The Interconnect is valid, turned up and ready to use.
+      #    Attachments may be provisioned on this Interconnect.
+      #    - UNPROVISIONED: The Interconnect has not completed turnup. No
+      #    attachments may be provisioned on this Interconnect.
+      #    - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.
+      #    No attachments may be provisioned or updated on this
+      #    Interconnect.
+  "subzone": "A String", # To be deprecated.
+  "wireGroups": [ # Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups
+      # configured to use this Interconnect. The Interconnect cannot be deleted if
+      # this list is non-empty.
+    "A String",
+  ],
+}
+
+ +
+ getDiagnostics(project, interconnect, x__xgafv=None) + 
Returns the interconnectDiagnostics for the specified
+Interconnect.
+
+In the event of a
+global outage, do not use this API to make decisions about where to
+redirect your network traffic.
+
+Unlike a VLAN attachment, which is regional, a Cloud Interconnect
+connection is a global resource. A global outage can prevent this
+API from functioning properly.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnect: string, Name of the interconnect resource to query. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the InterconnectsGetDiagnosticsRequest.
+  "result": { # Diagnostics information about the Interconnect connection, which contains
+      # detailed and current technical information about Google's side of the
+      # connection.
+    "arpCaches": [ # A list of InterconnectDiagnostics.ARPEntry objects,
+        # describing individual neighbors currently seen by the Google router in
+        # the ARP cache for the Interconnect.
+        # This will be empty when the Interconnect is not bundled.
+      { # Describing the ARP neighbor entries seen on this link
+        "ipAddress": "A String", # The IP address of this ARP neighbor.
+        "macAddress": "A String", # The MAC address of this ARP neighbor.
+      },
+    ],
+    "bundleAggregationType": "A String", # The aggregation type of the bundle interface.
+    "bundleOperationalStatus": "A String", # The operational status of the bundle interface.
+    "links": [ # A list of InterconnectDiagnostics.LinkStatus objects,
+        # describing the status for each link on the Interconnect.
+      {
+        "arpCaches": [ # A list of InterconnectDiagnostics.ARPEntry objects,
+            # describing the ARP neighbor entries seen on this link.
+            # This will be empty if the link is bundled
+          { # Describing the ARP neighbor entries seen on this link
+            "ipAddress": "A String", # The IP address of this ARP neighbor.
+            "macAddress": "A String", # The MAC address of this ARP neighbor.
+          },
+        ],
+        "circuitId": "A String", # The unique ID for this link assigned during turn up by Google.
+        "googleDemarc": "A String", # The Demarc address assigned by Google and provided in the LoA.
+        "lacpStatus": {
+          "googleSystemId": "A String", # System ID of the port on Google's side of the LACP exchange.
+          "neighborSystemId": "A String", # System ID of the port on the neighbor's side of the LACP exchange.
+          "state": "A String", # The state of a LACP link, which can take one of the following values:
+              #
+              #    - ACTIVE: The link is configured and active within the bundle.
+              #    - DETACHED: The link is not configured within the bundle. This means
+              #    that the rest of the object should be empty.
+        },
+        "macsec": { # Describes the status of MACsec encryption on the link. # Describes the status of MACsec encryption on this link.
+          "ckn": "A String", # Indicates the Connectivity Association Key Name (CKN)
+              # currently being used if MACsec is operational.
+          "operational": True or False, # Indicates whether or not MACsec is operational on this link.
+        },
+        "operationalStatus": "A String", # The operational status of the link.
+        "receivingOpticalPower": { # An InterconnectDiagnostics.LinkOpticalPower object,
+            # describing the current value and status of the received light level.
+          "state": "A String", # The status of the current value when compared to the warning and alarm
+              # levels for the receiving or transmitting transceiver. Possible states
+              # include:
+              #
+              #
+              #     - OK: The value has not crossed a warning threshold.
+              #     - LOW_WARNING: The value has crossed below the low
+              #     warning threshold.
+              #    - HIGH_WARNING: The value has
+              #     crossed above the high warning threshold.
+              #     - LOW_ALARM: The value has crossed below the low alarm
+              #     threshold.
+              #     - HIGH_ALARM: The value has crossed above the high alarm
+              #     threshold.
+          "value": 3.14, # Value of the current receiving or transmitting optical power, read in
+              # dBm. Take a known good optical value, give it a 10% margin and trigger
+              # warnings relative to that value. In general, a -7dBm warning and a -11dBm
+              # alarm are good optical value estimates for most links.
+        },
+        "transmittingOpticalPower": { # An InterconnectDiagnostics.LinkOpticalPower object,
+            # describing the current value and status of the transmitted light level.
+          "state": "A String", # The status of the current value when compared to the warning and alarm
+              # levels for the receiving or transmitting transceiver. Possible states
+              # include:
+              #
+              #
+              #     - OK: The value has not crossed a warning threshold.
+              #     - LOW_WARNING: The value has crossed below the low
+              #     warning threshold.
+              #    - HIGH_WARNING: The value has
+              #     crossed above the high warning threshold.
+              #     - LOW_ALARM: The value has crossed below the low alarm
+              #     threshold.
+              #     - HIGH_ALARM: The value has crossed above the high alarm
+              #     threshold.
+          "value": 3.14, # Value of the current receiving or transmitting optical power, read in
+              # dBm. Take a known good optical value, give it a 10% margin and trigger
+              # warnings relative to that value. In general, a -7dBm warning and a -11dBm
+              # alarm are good optical value estimates for most links.
+        },
+      },
+    ],
+    "macAddress": "A String", # The MAC address of the Interconnect's bundle interface.
+  },
+}
+
+ +
+ getMacsecConfig(project, interconnect, x__xgafv=None) + 
Returns the interconnectMacsecConfig for the specified
+Interconnect.
+
+Args:
+  project: string, Project ID for this request. (required)
+  interconnect: string, Name of the interconnect resource to query. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the InterconnectsGetMacsecConfigRequest.
+  "etag": "A String", # end_interface: MixerGetResponseWithEtagBuilder
+  "result": { # MACsec configuration information for the Interconnect connection. Contains
+      # the generated Connectivity Association Key Name (CKN) and the key (CAK) for
+      # this Interconnect connection.
+    "preSharedKeys": [ # A keychain placeholder describing a set of named key objects
+        # along with their start times. A MACsec CKN/CAK is generated for each key in
+        # the key chain. Google router automatically picks the key with the most
+        # recent startTime when establishing or re-establishing a MACsec secure link.
+      { # Describes a pre-shared key used to setup MACsec in static connectivity
+          # association key (CAK) mode.
+        "cak": "A String", # An auto-generated Connectivity Association Key (CAK) for this key.
+        "ckn": "A String", # An auto-generated Connectivity Association Key Name (CKN) for this key.
+        "name": "A String", # User provided name for this pre-shared key.
+        "startTime": "A String", # User provided timestamp on or after which this key is valid.
+      },
+    ],
+  },
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates an Interconnect 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 an Interconnect resource.
+    # 
+    # An Interconnect resource is a dedicated connection between the Google
+    # Cloud network and your on-premises network. For more information, read the
+    # Dedicated Interconnect Overview.
+  "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud
+      # Interconnect.
+  "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+      # Interconnect is functional and can carry traffic.
+      # When set to false, no packets can be carried over the interconnect and
+      # no BGP routes are exchanged over it. By default, the status is set to true.
+  "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud # Configuration information for application awareness on this Cloud
+      # Interconnect.
+      # Interconnect.
+    "bandwidthPercentagePolicy": {
+      "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing
+          # type Bandwidth Percent.
+        { # Specify bandwidth percentages [1-100] for various traffic classes in
+            # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+            # All traffic classes must have a percentage value specified.
+          "percentage": 42, # Bandwidth percentage for a specific traffic class.
+          "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+        },
+      ],
+    },
+    "profileDescription": "A String", # Description for the application awareness profile on this Cloud
+        # Interconnect.
+    "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be
+        # applied in conjunction with StrictPriorityPolicy or
+        # BandwidthPercentagePolicy.
+      { # Specify bandwidth percentages [1-100] for various traffic classes in
+          # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+          # All traffic classes must have a percentage value specified.
+        "percentage": 42, # Bandwidth percentage for a specific traffic class.
+        "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+      },
+    ],
+    "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy.
+    },
+  },
+  "availableFeatures": [ # [Output only] List of features available for this Interconnect connection,
+      # which can take one of the following values:
+      # 
+      #    - IF_MACSEC: If present, then the Interconnect connection is
+      #    provisioned on MACsec capable hardware ports. If not present, then the
+      #    Interconnect connection is provisioned on non-MACsec capable ports. Any
+      #    attempt to enable MACsec will fail.
+      #    - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is
+      #    provisioned exclusively for Cross-Site Networking. Any attempt to configure
+      #    VLAN attachments will fail. If not present, then the Interconnect
+      #    connection is not provisioned for Cross-Site Networking. Any attempt to use
+      #    it for Cross-Site Networking will fail.
+    "A String",
+  ],
+  "circuitInfos": [ # Output only. [Output Only] A list of CircuitInfo objects, that describe the individual
+      # circuits in this LAG.
+    { # Describes a single physical circuit between the Customer and Google.
+        # CircuitInfo objects are created by Google, so all fields are output only.
+      "customerDemarcId": "A String", # Customer-side demarc ID for this circuit.
+      "googleCircuitId": "A String", # Google-assigned unique ID for this circuit. Assigned at circuit turn-up.
+      "googleDemarcId": "A String", # Google-side demarc ID for this circuit. Assigned at circuit turn-up and
+          # provided by Google to the customer in the LOA.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+      # authorized to request a crossconnect.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "effectiveLocation": "A String", # Output only. URL of the InterconnectLocation object that represents where
+      # this connection is to be provisioned. By default it will be the same as the
+      # location field.
+  "expectedOutages": [ # Output only. [Output Only] A list of outages expected for this Interconnect.
+    { # Description of a planned outage on this Interconnect.
+      "affectedCircuits": [ # If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit
+          # IDs that will be affected.
+        "A String",
+      ],
+      "description": "A String", # A description about the purpose of the outage.
+      "endTime": "A String", # Scheduled end time for the outage (milliseconds since Unix
+          # epoch).
+      "issueType": "A String", # Form this outage is expected to take, which can take one of the following
+          # values:
+          #
+          #    - OUTAGE: The Interconnect may be completely out of service for
+          #    some or all of the specified window.
+          #    - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole
+          #    should remain up, but with reduced bandwidth.
+          #
+          #
+          # Note that the versions of this enum prefixed with "IT_" have been
+          # deprecated in favor of the unprefixed values.
+      "name": "A String", # Unique identifier for this outage notification.
+      "source": "A String", # The party that generated this notification, which can take the following
+          # value:
+          #
+          #    - GOOGLE: this notification as generated by Google.
+          #
+          #
+          # Note that the value of NSRC_GOOGLE has been deprecated in favor of
+          # GOOGLE.
+      "startTime": "A String", # Scheduled start time for the outage (milliseconds since Unix
+          # epoch).
+      "state": "A String", # State of this notification, which can take one of the following values:
+          #
+          #    - ACTIVE: This outage notification is active. The event could be in
+          #    the past, present, or future. See start_time and end_time for
+          #    scheduling.
+          #    - CANCELLED: The outage associated with this notification was cancelled
+          #    before the outage was due to start.
+          #    - COMPLETED: The outage associated with this notification is complete.
+          #
+          #
+          # Note that the versions of this enum prefixed with "NS_" have been
+          # deprecated in favor of the unprefixed values.
+    },
+  ],
+  "googleIpAddress": "A String", # Output only. [Output Only] IP address configured on the Google side of the Interconnect
+      # link. This can be used only for ping tests.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnectAttachments": [ # Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured
+      # to use  this Interconnect.
+    "A String",
+  ],
+  "interconnectGroups": [ # Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.
+      # Order is arbitrary and items are unique.
+    "A String",
+  ],
+  "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+      # 
+      #    - PARTNER: A partner-managed interconnection shared between customers
+      #    though a partner.
+      #    - DEDICATED: A dedicated physical interconnection with the
+      #    customer.
+      # 
+      # 
+      # Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.
+  "kind": "compute#interconnect", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Interconnect, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Interconnect.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "linkType": "A String", # Type of link requested, which can take one of the following values:
+      # 
+      #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+      #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+      #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.
+      # 
+      # 
+      #  Note that this field indicates the speed of each of
+      # the links in the bundle, not the speed of the entire bundle.
+  "location": "A String", # URL of the InterconnectLocation object that represents where this
+      # connection is to be provisioned.
+  "macsec": { # Configuration information for enabling Media Access Control security # Configuration that enables Media Access Control security (MACsec) on the
+      # Cloud Interconnect connection between Google and your on-premises router.
+      # (MACsec) on this Cloud Interconnect connection between Google and your
+      # on-premises router.
+    "failOpen": True or False, # If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google
+        # router to fallback to cleartext traffic if the MKA session cannot be
+        # established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the
+        # MKA session cannot be established with your router.
+    "preSharedKeys": [ # Required. A keychain placeholder describing a set of named key objects
+        # along with their start times. A MACsec CKN/CAK is generated for each
+        # key in the key chain. Google router automatically picks the key with
+        # the most recent startTime when establishing or re-establishing a MACsec
+        # secure link.
+      { # Describes a pre-shared key used to setup MACsec in static connectivity
+          # association key (CAK) mode.
+        "name": "A String", # Required. A name for this pre-shared key.
+            # 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.
+        "startTime": "A String", # A RFC3339 timestamp on or after which the key is
+            # valid. startTime can be in the future. If the keychain has a single
+            # key, startTime can be omitted. If the keychain has multiple keys,
+            # startTime is mandatory for each key. The start times of keys must be in
+            # increasing order. The start times of two consecutive keys must be
+            # at least 6 hours apart.
+      },
+    ],
+  },
+  "macsecEnabled": True or False, # Enable or disable MACsec on this Interconnect connection. MACsec enablement
+      # fails if the MACsec object is not specified.
+  "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.
+  "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+      # notifications regarding this Interconnect. If specified, this will be used
+      # for notifications in addition to all other forms described, such as
+      # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+      # required for users who sign up for Cloud Interconnect using
+      # workforce identity federation.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of this Interconnect's functionality,
+      # which can take one of the following values:
+      # 
+      #    - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to
+      #    use. Attachments may be provisioned on this Interconnect.
+      # 
+      # - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No
+      # attachments may be provisioned on this Interconnect.
+      # - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal
+      # maintenance. No attachments may be provisioned or updated on this
+      # Interconnect.
+  "params": { # Additional interconnect 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.
+        # 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",
+    },
+  },
+  "peerIpAddress": "A String", # Output only. [Output Only] IP address configured on the customer side of the
+      # Interconnect link. The customer should configure this IP address during
+      # turnup when prompted by Google NOC. This can be used only for ping tests.
+  "provisionedLinkCount": 42, # Output only. [Output Only] Number of links actually provisioned in this interconnect.
+  "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies the
+      # location outside of Google's network that the interconnect is connected to.
+  "requestedFeatures": [ # Optional. This parameter can be provided only with Interconnect INSERT. It
+      # isn't valid for Interconnect PATCH. List of features requested for this
+      # Interconnect connection, which can take one of the following values:
+      # 
+      #    - IF_MACSEC: If specified, then the connection is created on MACsec
+      #    capable hardware ports. If not specified, non-MACsec capable ports will
+      #    also be considered.
+      #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+      #    exclusively for Cross-Site Networking. The connection can not be used for
+      #    Cross-Site Networking unless this feature is specified.
+    "A String",
+  ],
+  "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+      # customer.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. [Output Only] The current state of Interconnect functionality, which can
+      # take one of the following values:
+      # 
+      #    - ACTIVE: The Interconnect is valid, turned up and ready to use.
+      #    Attachments may be provisioned on this Interconnect.
+      #    - UNPROVISIONED: The Interconnect has not completed turnup. No
+      #    attachments may be provisioned on this Interconnect.
+      #    - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.
+      #    No attachments may be provisioned or updated on this
+      #    Interconnect.
+  "subzone": "A String", # To be deprecated.
+  "wireGroups": [ # Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups
+      # configured to use this Interconnect. The Interconnect cannot be deleted if
+      # this list is non-empty.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of Interconnects available to 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response to the list request, and contains a list of interconnects.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Interconnect resources.
+    { # Represents an Interconnect resource.
+        #
+        # An Interconnect resource is a dedicated connection between the Google
+        # Cloud network and your on-premises network. For more information, read the
+        # Dedicated Interconnect Overview.
+      "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud
+          # Interconnect.
+      "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+          # Interconnect is functional and can carry traffic.
+          # When set to false, no packets can be carried over the interconnect and
+          # no BGP routes are exchanged over it. By default, the status is set to true.
+      "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud # Configuration information for application awareness on this Cloud
+          # Interconnect.
+          # Interconnect.
+        "bandwidthPercentagePolicy": {
+          "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing
+              # type Bandwidth Percent.
+            { # Specify bandwidth percentages [1-100] for various traffic classes in
+                # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+                # All traffic classes must have a percentage value specified.
+              "percentage": 42, # Bandwidth percentage for a specific traffic class.
+              "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+            },
+          ],
+        },
+        "profileDescription": "A String", # Description for the application awareness profile on this Cloud
+            # Interconnect.
+        "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be
+            # applied in conjunction with StrictPriorityPolicy or
+            # BandwidthPercentagePolicy.
+          { # Specify bandwidth percentages [1-100] for various traffic classes in
+              # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+              # All traffic classes must have a percentage value specified.
+            "percentage": 42, # Bandwidth percentage for a specific traffic class.
+            "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+          },
+        ],
+        "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy.
+        },
+      },
+      "availableFeatures": [ # [Output only] List of features available for this Interconnect connection,
+          # which can take one of the following values:
+          #
+          #    - IF_MACSEC: If present, then the Interconnect connection is
+          #    provisioned on MACsec capable hardware ports. If not present, then the
+          #    Interconnect connection is provisioned on non-MACsec capable ports. Any
+          #    attempt to enable MACsec will fail.
+          #    - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is
+          #    provisioned exclusively for Cross-Site Networking. Any attempt to configure
+          #    VLAN attachments will fail. If not present, then the Interconnect
+          #    connection is not provisioned for Cross-Site Networking. Any attempt to use
+          #    it for Cross-Site Networking will fail.
+        "A String",
+      ],
+      "circuitInfos": [ # Output only. [Output Only] A list of CircuitInfo objects, that describe the individual
+          # circuits in this LAG.
+        { # Describes a single physical circuit between the Customer and Google.
+            # CircuitInfo objects are created by Google, so all fields are output only.
+          "customerDemarcId": "A String", # Customer-side demarc ID for this circuit.
+          "googleCircuitId": "A String", # Google-assigned unique ID for this circuit. Assigned at circuit turn-up.
+          "googleDemarcId": "A String", # Google-side demarc ID for this circuit. Assigned at circuit turn-up and
+              # provided by Google to the customer in the LOA.
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+          # authorized to request a crossconnect.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "effectiveLocation": "A String", # Output only. URL of the InterconnectLocation object that represents where
+          # this connection is to be provisioned. By default it will be the same as the
+          # location field.
+      "expectedOutages": [ # Output only. [Output Only] A list of outages expected for this Interconnect.
+        { # Description of a planned outage on this Interconnect.
+          "affectedCircuits": [ # If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit
+              # IDs that will be affected.
+            "A String",
+          ],
+          "description": "A String", # A description about the purpose of the outage.
+          "endTime": "A String", # Scheduled end time for the outage (milliseconds since Unix
+              # epoch).
+          "issueType": "A String", # Form this outage is expected to take, which can take one of the following
+              # values:
+              #
+              #    - OUTAGE: The Interconnect may be completely out of service for
+              #    some or all of the specified window.
+              #    - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole
+              #    should remain up, but with reduced bandwidth.
+              #
+              #
+              # Note that the versions of this enum prefixed with "IT_" have been
+              # deprecated in favor of the unprefixed values.
+          "name": "A String", # Unique identifier for this outage notification.
+          "source": "A String", # The party that generated this notification, which can take the following
+              # value:
+              #
+              #    - GOOGLE: this notification as generated by Google.
+              #
+              #
+              # Note that the value of NSRC_GOOGLE has been deprecated in favor of
+              # GOOGLE.
+          "startTime": "A String", # Scheduled start time for the outage (milliseconds since Unix
+              # epoch).
+          "state": "A String", # State of this notification, which can take one of the following values:
+              #
+              #    - ACTIVE: This outage notification is active. The event could be in
+              #    the past, present, or future. See start_time and end_time for
+              #    scheduling.
+              #    - CANCELLED: The outage associated with this notification was cancelled
+              #    before the outage was due to start.
+              #    - COMPLETED: The outage associated with this notification is complete.
+              #
+              #
+              # Note that the versions of this enum prefixed with "NS_" have been
+              # deprecated in favor of the unprefixed values.
+        },
+      ],
+      "googleIpAddress": "A String", # Output only. [Output Only] IP address configured on the Google side of the Interconnect
+          # link. This can be used only for ping tests.
+      "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID to be used when raising support tickets
+          # with Google or otherwise to debug backend connectivity issues.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "interconnectAttachments": [ # Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured
+          # to use  this Interconnect.
+        "A String",
+      ],
+      "interconnectGroups": [ # Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.
+          # Order is arbitrary and items are unique.
+        "A String",
+      ],
+      "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+          #
+          #    - PARTNER: A partner-managed interconnection shared between customers
+          #    though a partner.
+          #    - DEDICATED: A dedicated physical interconnection with the
+          #    customer.
+          #
+          #
+          # Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.
+      "kind": "compute#interconnect", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Interconnect, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an Interconnect.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "linkType": "A String", # Type of link requested, which can take one of the following values:
+          #
+          #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+          #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+          #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.
+          #
+          #
+          #  Note that this field indicates the speed of each of
+          # the links in the bundle, not the speed of the entire bundle.
+      "location": "A String", # URL of the InterconnectLocation object that represents where this
+          # connection is to be provisioned.
+      "macsec": { # Configuration information for enabling Media Access Control security # Configuration that enables Media Access Control security (MACsec) on the
+          # Cloud Interconnect connection between Google and your on-premises router.
+          # (MACsec) on this Cloud Interconnect connection between Google and your
+          # on-premises router.
+        "failOpen": True or False, # If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google
+            # router to fallback to cleartext traffic if the MKA session cannot be
+            # established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the
+            # MKA session cannot be established with your router.
+        "preSharedKeys": [ # Required. A keychain placeholder describing a set of named key objects
+            # along with their start times. A MACsec CKN/CAK is generated for each
+            # key in the key chain. Google router automatically picks the key with
+            # the most recent startTime when establishing or re-establishing a MACsec
+            # secure link.
+          { # Describes a pre-shared key used to setup MACsec in static connectivity
+              # association key (CAK) mode.
+            "name": "A String", # Required. A name for this pre-shared key.
+                # 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.
+            "startTime": "A String", # A RFC3339 timestamp on or after which the key is
+                # valid. startTime can be in the future. If the keychain has a single
+                # key, startTime can be omitted. If the keychain has multiple keys,
+                # startTime is mandatory for each key. The start times of keys must be in
+                # increasing order. The start times of two consecutive keys must be
+                # at least 6 hours apart.
+          },
+        ],
+      },
+      "macsecEnabled": True or False, # Enable or disable MACsec on this Interconnect connection. MACsec enablement
+          # fails if the MACsec object is not specified.
+      "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.
+      "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+          # notifications regarding this Interconnect. If specified, this will be used
+          # for notifications in addition to all other forms described, such as
+          # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+          # required for users who sign up for Cloud Interconnect using
+          # workforce identity federation.
+      "operationalStatus": "A String", # Output only. [Output Only] The current status of this Interconnect's functionality,
+          # which can take one of the following values:
+          #
+          #    - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to
+          #    use. Attachments may be provisioned on this Interconnect.
+          #
+          # - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No
+          # attachments may be provisioned on this Interconnect.
+          # - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal
+          # maintenance. No attachments may be provisioned or updated on this
+          # Interconnect.
+      "params": { # Additional interconnect 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.
+            # 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",
+        },
+      },
+      "peerIpAddress": "A String", # Output only. [Output Only] IP address configured on the customer side of the
+          # Interconnect link. The customer should configure this IP address during
+          # turnup when prompted by Google NOC. This can be used only for ping tests.
+      "provisionedLinkCount": 42, # Output only. [Output Only] Number of links actually provisioned in this interconnect.
+      "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies the
+          # location outside of Google's network that the interconnect is connected to.
+      "requestedFeatures": [ # Optional. This parameter can be provided only with Interconnect INSERT. It
+          # isn't valid for Interconnect PATCH. List of features requested for this
+          # Interconnect connection, which can take one of the following values:
+          #
+          #    - IF_MACSEC: If specified, then the connection is created on MACsec
+          #    capable hardware ports. If not specified, non-MACsec capable ports will
+          #    also be considered.
+          #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+          #    exclusively for Cross-Site Networking. The connection can not be used for
+          #    Cross-Site Networking unless this feature is specified.
+        "A String",
+      ],
+      "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+          # customer.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+      "state": "A String", # Output only. [Output Only] The current state of Interconnect functionality, which can
+          # take one of the following values:
+          #
+          #    - ACTIVE: The Interconnect is valid, turned up and ready to use.
+          #    Attachments may be provisioned on this Interconnect.
+          #    - UNPROVISIONED: The Interconnect has not completed turnup. No
+          #    attachments may be provisioned on this Interconnect.
+          #    - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.
+          #    No attachments may be provisioned or updated on this
+          #    Interconnect.
+      "subzone": "A String", # To be deprecated.
+      "wireGroups": [ # Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups
+          # configured to use this Interconnect. The Interconnect cannot be deleted if
+          # this list is non-empty.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#interconnectList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects.
+  "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.
+  "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, interconnect, body=None, requestId=None, x__xgafv=None) + 
Updates the specified Interconnect 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)
+  interconnect: string, Name of the interconnect to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Interconnect resource.
+    # 
+    # An Interconnect resource is a dedicated connection between the Google
+    # Cloud network and your on-premises network. For more information, read the
+    # Dedicated Interconnect Overview.
+  "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud
+      # Interconnect.
+  "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the
+      # Interconnect is functional and can carry traffic.
+      # When set to false, no packets can be carried over the interconnect and
+      # no BGP routes are exchanged over it. By default, the status is set to true.
+  "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud # Configuration information for application awareness on this Cloud
+      # Interconnect.
+      # Interconnect.
+    "bandwidthPercentagePolicy": {
+      "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing
+          # type Bandwidth Percent.
+        { # Specify bandwidth percentages [1-100] for various traffic classes in
+            # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+            # All traffic classes must have a percentage value specified.
+          "percentage": 42, # Bandwidth percentage for a specific traffic class.
+          "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+        },
+      ],
+    },
+    "profileDescription": "A String", # Description for the application awareness profile on this Cloud
+        # Interconnect.
+    "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be
+        # applied in conjunction with StrictPriorityPolicy or
+        # BandwidthPercentagePolicy.
+      { # Specify bandwidth percentages [1-100] for various traffic classes in
+          # BandwidthPercentagePolicy. The sum of all percentages must equal 100.
+          # All traffic classes must have a percentage value specified.
+        "percentage": 42, # Bandwidth percentage for a specific traffic class.
+        "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified.
+      },
+    ],
+    "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy.
+    },
+  },
+  "availableFeatures": [ # [Output only] List of features available for this Interconnect connection,
+      # which can take one of the following values:
+      # 
+      #    - IF_MACSEC: If present, then the Interconnect connection is
+      #    provisioned on MACsec capable hardware ports. If not present, then the
+      #    Interconnect connection is provisioned on non-MACsec capable ports. Any
+      #    attempt to enable MACsec will fail.
+      #    - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is
+      #    provisioned exclusively for Cross-Site Networking. Any attempt to configure
+      #    VLAN attachments will fail. If not present, then the Interconnect
+      #    connection is not provisioned for Cross-Site Networking. Any attempt to use
+      #    it for Cross-Site Networking will fail.
+    "A String",
+  ],
+  "circuitInfos": [ # Output only. [Output Only] A list of CircuitInfo objects, that describe the individual
+      # circuits in this LAG.
+    { # Describes a single physical circuit between the Customer and Google.
+        # CircuitInfo objects are created by Google, so all fields are output only.
+      "customerDemarcId": "A String", # Customer-side demarc ID for this circuit.
+      "googleCircuitId": "A String", # Google-assigned unique ID for this circuit. Assigned at circuit turn-up.
+      "googleDemarcId": "A String", # Google-side demarc ID for this circuit. Assigned at circuit turn-up and
+          # provided by Google to the customer in the LOA.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customerName": "A String", # Customer name, to put in the Letter of Authorization as the party
+      # authorized to request a crossconnect.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "effectiveLocation": "A String", # Output only. URL of the InterconnectLocation object that represents where
+      # this connection is to be provisioned. By default it will be the same as the
+      # location field.
+  "expectedOutages": [ # Output only. [Output Only] A list of outages expected for this Interconnect.
+    { # Description of a planned outage on this Interconnect.
+      "affectedCircuits": [ # If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit
+          # IDs that will be affected.
+        "A String",
+      ],
+      "description": "A String", # A description about the purpose of the outage.
+      "endTime": "A String", # Scheduled end time for the outage (milliseconds since Unix
+          # epoch).
+      "issueType": "A String", # Form this outage is expected to take, which can take one of the following
+          # values:
+          #
+          #    - OUTAGE: The Interconnect may be completely out of service for
+          #    some or all of the specified window.
+          #    - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole
+          #    should remain up, but with reduced bandwidth.
+          #
+          #
+          # Note that the versions of this enum prefixed with "IT_" have been
+          # deprecated in favor of the unprefixed values.
+      "name": "A String", # Unique identifier for this outage notification.
+      "source": "A String", # The party that generated this notification, which can take the following
+          # value:
+          #
+          #    - GOOGLE: this notification as generated by Google.
+          #
+          #
+          # Note that the value of NSRC_GOOGLE has been deprecated in favor of
+          # GOOGLE.
+      "startTime": "A String", # Scheduled start time for the outage (milliseconds since Unix
+          # epoch).
+      "state": "A String", # State of this notification, which can take one of the following values:
+          #
+          #    - ACTIVE: This outage notification is active. The event could be in
+          #    the past, present, or future. See start_time and end_time for
+          #    scheduling.
+          #    - CANCELLED: The outage associated with this notification was cancelled
+          #    before the outage was due to start.
+          #    - COMPLETED: The outage associated with this notification is complete.
+          #
+          #
+          # Note that the versions of this enum prefixed with "NS_" have been
+          # deprecated in favor of the unprefixed values.
+    },
+  ],
+  "googleIpAddress": "A String", # Output only. [Output Only] IP address configured on the Google side of the Interconnect
+      # link. This can be used only for ping tests.
+  "googleReferenceId": "A String", # Output only. [Output Only] Google reference ID to be used when raising support tickets
+      # with Google or otherwise to debug backend connectivity issues.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interconnectAttachments": [ # Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured
+      # to use  this Interconnect.
+    "A String",
+  ],
+  "interconnectGroups": [ # Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.
+      # Order is arbitrary and items are unique.
+    "A String",
+  ],
+  "interconnectType": "A String", # Type of interconnect, which can take one of the following values:
+      # 
+      #    - PARTNER: A partner-managed interconnection shared between customers
+      #    though a partner.
+      #    - DEDICATED: A dedicated physical interconnection with the
+      #    customer.
+      # 
+      # 
+      # Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.
+  "kind": "compute#interconnect", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this Interconnect, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an Interconnect.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "linkType": "A String", # Type of link requested, which can take one of the following values:
+      # 
+      #    - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics
+      #    - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.
+      #    - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.
+      # 
+      # 
+      #  Note that this field indicates the speed of each of
+      # the links in the bundle, not the speed of the entire bundle.
+  "location": "A String", # URL of the InterconnectLocation object that represents where this
+      # connection is to be provisioned.
+  "macsec": { # Configuration information for enabling Media Access Control security # Configuration that enables Media Access Control security (MACsec) on the
+      # Cloud Interconnect connection between Google and your on-premises router.
+      # (MACsec) on this Cloud Interconnect connection between Google and your
+      # on-premises router.
+    "failOpen": True or False, # If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google
+        # router to fallback to cleartext traffic if the MKA session cannot be
+        # established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the
+        # MKA session cannot be established with your router.
+    "preSharedKeys": [ # Required. A keychain placeholder describing a set of named key objects
+        # along with their start times. A MACsec CKN/CAK is generated for each
+        # key in the key chain. Google router automatically picks the key with
+        # the most recent startTime when establishing or re-establishing a MACsec
+        # secure link.
+      { # Describes a pre-shared key used to setup MACsec in static connectivity
+          # association key (CAK) mode.
+        "name": "A String", # Required. A name for this pre-shared key.
+            # 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.
+        "startTime": "A String", # A RFC3339 timestamp on or after which the key is
+            # valid. startTime can be in the future. If the keychain has a single
+            # key, startTime can be omitted. If the keychain has multiple keys,
+            # startTime is mandatory for each key. The start times of keys must be in
+            # increasing order. The start times of two consecutive keys must be
+            # at least 6 hours apart.
+      },
+    ],
+  },
+  "macsecEnabled": True or False, # Enable or disable MACsec on this Interconnect connection. MACsec enablement
+      # fails if the MACsec object is not specified.
+  "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.
+  "nocContactEmail": "A String", # Email address to contact the customer NOC for operations and maintenance
+      # notifications regarding this Interconnect. If specified, this will be used
+      # for notifications in addition to all other forms described, such as
+      # Cloud Monitoring logs alerting and Cloud Notifications. This field is
+      # required for users who sign up for Cloud Interconnect using
+      # workforce identity federation.
+  "operationalStatus": "A String", # Output only. [Output Only] The current status of this Interconnect's functionality,
+      # which can take one of the following values:
+      # 
+      #    - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to
+      #    use. Attachments may be provisioned on this Interconnect.
+      # 
+      # - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No
+      # attachments may be provisioned on this Interconnect.
+      # - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal
+      # maintenance. No attachments may be provisioned or updated on this
+      # Interconnect.
+  "params": { # Additional interconnect 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.
+        # 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",
+    },
+  },
+  "peerIpAddress": "A String", # Output only. [Output Only] IP address configured on the customer side of the
+      # Interconnect link. The customer should configure this IP address during
+      # turnup when prompted by Google NOC. This can be used only for ping tests.
+  "provisionedLinkCount": 42, # Output only. [Output Only] Number of links actually provisioned in this interconnect.
+  "remoteLocation": "A String", # Indicates that this is a Cross-Cloud Interconnect. This field specifies the
+      # location outside of Google's network that the interconnect is connected to.
+  "requestedFeatures": [ # Optional. This parameter can be provided only with Interconnect INSERT. It
+      # isn't valid for Interconnect PATCH. List of features requested for this
+      # Interconnect connection, which can take one of the following values:
+      # 
+      #    - IF_MACSEC: If specified, then the connection is created on MACsec
+      #    capable hardware ports. If not specified, non-MACsec capable ports will
+      #    also be considered.
+      #    - IF_CROSS_SITE_NETWORK: If specified, then the connection is created
+      #    exclusively for Cross-Site Networking. The connection can not be used for
+      #    Cross-Site Networking unless this feature is specified.
+    "A String",
+  ],
+  "requestedLinkCount": 42, # Target number of physical links in the link bundle, as requested by the
+      # customer.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. [Output Only] The current state of Interconnect functionality, which can
+      # take one of the following values:
+      # 
+      #    - ACTIVE: The Interconnect is valid, turned up and ready to use.
+      #    Attachments may be provisioned on this Interconnect.
+      #    - UNPROVISIONED: The Interconnect has not completed turnup. No
+      #    attachments may be provisioned on this Interconnect.
+      #    - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.
+      #    No attachments may be provisioned or updated on this
+      #    Interconnect.
+  "subzone": "A String", # To be deprecated.
+  "wireGroups": [ # Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups
+      # configured to use this Interconnect. The Interconnect cannot be deleted if
+      # this list is non-empty.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on an Interconnect. To learn more about labels,
+read the Labeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.licenseCodes.html b/docs/dyn/compute_preview.licenseCodes.html new file mode 100644 index 0000000000..ac24e373c3 --- /dev/null +++ b/docs/dyn/compute_preview.licenseCodes.html @@ -0,0 +1,1468 @@ + + + +

Compute Engine API . licenseCodes

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, licenseCode, x__xgafv=None)

+

Return a specified license code. License codes are mirrored across

+

+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ 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.
+
+ +
+ get(project, licenseCode, x__xgafv=None) + 
Return a specified license code. License codes are mirrored across
+all projects that have permissions to read the License Code.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+Args:
+  project: string, Project ID for this request. (required)
+  licenseCode: string, Number corresponding to the License code 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 License Code resource.
+    #
+    # A License Code is a unique identifier used to represent alicense
+    # resource.
+    #  *Caution* This resource is intended for
+    # use only by third-party partners who are creatingCloud Marketplace
+    # images.
+  "allowedReplacementLicenses": [ # Specifies licenseCodes of licenses that can replace this license. Note:
+      # such replacements are allowed even if removable_from_disk is false.
+    "A String",
+  ],
+  "appendableToDisk": True or False, # If true, this license can be appended to an existing disk's set of
+      # licenses.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Output only. [Output Only] Description of this License Code.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "incompatibleLicenses": [ # Specifies licenseCodes of licenses that are incompatible with this license.
+      # If a license is incompatible with this license, it cannot be attached to
+      # the same disk or image.
+    "A String",
+  ],
+  "kind": "compute#licenseCode", # Output only. [Output Only] Type of resource. Always compute#licenseCode for
+      # licenses.
+  "licenseAlias": [ # [Output Only] URL and description aliases of Licenses with the same
+      # License Code.
+    {
+      "description": "A String", # Output only. [Output Only] Description of this License Code.
+      "selfLink": "A String", # Output only. [Output Only] URL of license corresponding to this License Code.
+    },
+  ],
+  "minimumRetention": { # A Duration represents a fixed-length span of time represented # If set, this license will be unable to be removed or replaced once attached
+      # to a disk until the minimum_retention period has passed.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "multiTenantOnly": True or False, # If true, this license can only be used on VMs on multi tenant nodes.
+  "name": "A String", # Output only. [Output Only] Name of the resource. The name is 1-20 characters long and
+      # must be a valid 64 bit integer.
+  "osLicense": True or False, # If true, indicates this is an OS license. Only one OS license can be
+      # attached to a disk or image at a time.
+  "removableFromDisk": True or False, # If true, this license can be removed from a disk's set of licenses, with no
+      # replacement license needed.
+  "requiredCoattachedLicenses": [ # Specifies the set of permissible coattached licenseCodes of licenses that
+      # satisfy the coattachment requirement of this license. At least one license
+      # from the set must be attached to the same disk or image as this license.
+    "A String",
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "soleTenantOnly": True or False, # If true, this license can only be used on VMs on sole tenant nodes.
+  "state": "A String", # Output only. [Output Only] Current state of this License Code.
+  "transferable": True or False, # Output only. [Output Only] If true, the license will remain attached when creating
+      # images or snapshots from disks. Otherwise, the license is not transferred.
+  "updateTimestamp": "A String", # Output only. [Output Only] Last update timestamp inRFC3339
+      # text format.
+}
+
+ +
+ 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.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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).
+}
+
+ +
+ setIamPolicy(project, resource, body=None, x__xgafv=None) + 
Sets the access control policy on the specified resource.
+Replaces any existing policy.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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_preview.licenses.html b/docs/dyn/compute_preview.licenses.html new file mode 100644 index 0000000000..3789d847a4 --- /dev/null +++ b/docs/dyn/compute_preview.licenses.html @@ -0,0 +1,2814 @@ + + + +

Compute Engine API . licenses

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, license, requestId=None, x__xgafv=None)

+

Deletes the specified license.

+

+ get(project, license, x__xgafv=None)

+

Returns the specified License 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)

+

Create a License resource in the specified project.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of licenses

+

+ 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.

+

+ update(project, license, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates a License resource in the specified project.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, license, requestId=None, x__xgafv=None) + 
Deletes the specified license.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+Args:
+  project: string, Project ID for this request. (required)
+  license: string, Name of the license 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, license, x__xgafv=None) + 
Returns the specified License resource.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+Args:
+  project: string, Project ID for this request. (required)
+  license: string, Name of the License 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 License resource.
+    #
+    # A License represents billing and aggregate usage data forpublic andmarketplace images.
+    #  *Caution* This resource is intended for
+    # use only by third-party partners who are creatingCloud Marketplace
+    # images.
+  "allowedReplacementLicenses": [ # Specifies licenseCodes of licenses that can replace this license. Note:
+      # such replacements are allowed even if removable_from_disk is false.
+    "A String",
+  ],
+  "appendableToDisk": True or False, # If true, this license can be appended to an existing disk's set of
+      # licenses.
+  "chargesUseFee": True or False, # [Output Only] Deprecated. This field no longer reflects whether a license
+      # charges a usage fee.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "incompatibleLicenses": [ # Specifies licenseCodes of licenses that are incompatible with this license.
+      # If a license is incompatible with this license, it cannot be attached to
+      # the same disk or image.
+    "A String",
+  ],
+  "kind": "compute#license", # Output only. [Output Only] Type of resource. Always compute#license for
+      # licenses.
+  "licenseCode": "A String", # [Output Only] The unique code used to attach this license to images,
+      # snapshots, and disks.
+  "minimumRetention": { # A Duration represents a fixed-length span of time represented # If set, this license will be unable to be removed or replaced once attached
+      # to a disk until the minimum_retention period has passed.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "multiTenantOnly": True or False, # If true, this license can only be used on VMs on multi tenant nodes.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+      # comply withRFC1035.
+  "osLicense": True or False, # If true, indicates this is an OS license. Only one OS license can be
+      # attached to a disk or image at a time.
+  "params": { # Additional license 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 license. 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",
+    },
+  },
+  "removableFromDisk": True or False, # If true, this license can be removed from a disk's set of licenses, with no
+      # replacement license needed.
+  "requiredCoattachedLicenses": [ # Specifies the set of permissible coattached licenseCodes of licenses that
+      # satisfy the coattachment requirement of this license. At least one license
+      # from the set must be attached to the same disk or image as this license.
+    "A String",
+  ],
+  "resourceRequirements": { # [Input Only] Deprecated.
+    "minGuestCpuCount": 42, # [Input Only] Deprecated. This field no longer reflects the minimum number
+        # of guest cpus required to use the Instance.
+    "minMemoryMb": 42, # [Input Only] Deprecated. This field no longer reflects the minimum memory
+        # required to use the Instance.
+  },
+  "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 with the resource id.
+  "soleTenantOnly": True or False, # If true, this license can only be used on VMs on sole tenant nodes.
+  "transferable": True or False, # If false, licenses will not be copied from the source resource when
+      # creating an image from a disk, disk from snapshot, or snapshot from disk.
+  "updateTimestamp": "A String", # Output only. [Output Only] Last update timestamp inRFC3339
+      # text format.
+}
+
+ +
+ 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.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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) + 
Create a License resource in the specified project.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a License resource.
+    # 
+    # A License represents billing and aggregate usage data forpublic andmarketplace images.
+    #  *Caution* This resource is intended for
+    # use only by third-party partners who are creatingCloud Marketplace
+    # images.
+  "allowedReplacementLicenses": [ # Specifies licenseCodes of licenses that can replace this license. Note:
+      # such replacements are allowed even if removable_from_disk is false.
+    "A String",
+  ],
+  "appendableToDisk": True or False, # If true, this license can be appended to an existing disk's set of
+      # licenses.
+  "chargesUseFee": True or False, # [Output Only] Deprecated. This field no longer reflects whether a license
+      # charges a usage fee.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "incompatibleLicenses": [ # Specifies licenseCodes of licenses that are incompatible with this license.
+      # If a license is incompatible with this license, it cannot be attached to
+      # the same disk or image.
+    "A String",
+  ],
+  "kind": "compute#license", # Output only. [Output Only] Type of resource. Always compute#license for
+      # licenses.
+  "licenseCode": "A String", # [Output Only] The unique code used to attach this license to images,
+      # snapshots, and disks.
+  "minimumRetention": { # A Duration represents a fixed-length span of time represented # If set, this license will be unable to be removed or replaced once attached
+      # to a disk until the minimum_retention period has passed.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "multiTenantOnly": True or False, # If true, this license can only be used on VMs on multi tenant nodes.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+      # comply withRFC1035.
+  "osLicense": True or False, # If true, indicates this is an OS license. Only one OS license can be
+      # attached to a disk or image at a time.
+  "params": { # Additional license 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 license. 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",
+    },
+  },
+  "removableFromDisk": True or False, # If true, this license can be removed from a disk's set of licenses, with no
+      # replacement license needed.
+  "requiredCoattachedLicenses": [ # Specifies the set of permissible coattached licenseCodes of licenses that
+      # satisfy the coattachment requirement of this license. At least one license
+      # from the set must be attached to the same disk or image as this license.
+    "A String",
+  ],
+  "resourceRequirements": { # [Input Only] Deprecated.
+    "minGuestCpuCount": 42, # [Input Only] Deprecated. This field no longer reflects the minimum number
+        # of guest cpus required to use the Instance.
+    "minMemoryMb": 42, # [Input Only] Deprecated. This field no longer reflects the minimum memory
+        # required to use the Instance.
+  },
+  "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 with the resource id.
+  "soleTenantOnly": True or False, # If true, this license can only be used on VMs on sole tenant nodes.
+  "transferable": True or False, # If false, licenses will not be copied from the source resource when
+      # creating an image from a disk, disk from snapshot, or snapshot from disk.
+  "updateTimestamp": "A String", # Output only. [Output Only] Last update timestamp inRFC3339
+      # text format.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of licenses
+available in the specified project. This method does not
+get any licenses that belong to other projects, including licenses attached
+to publicly-available images, like Debian 9. If you want to get a list of
+publicly-available licenses, use this method to make a request to the
+respective image project, such as debian-cloud orwindows-cloud.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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.
+  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 License resources.
+    { # Represents a License resource.
+        #
+        # A License represents billing and aggregate usage data forpublic andmarketplace images.
+        #  *Caution* This resource is intended for
+        # use only by third-party partners who are creatingCloud Marketplace
+        # images.
+      "allowedReplacementLicenses": [ # Specifies licenseCodes of licenses that can replace this license. Note:
+          # such replacements are allowed even if removable_from_disk is false.
+        "A String",
+      ],
+      "appendableToDisk": True or False, # If true, this license can be appended to an existing disk's set of
+          # licenses.
+      "chargesUseFee": True or False, # [Output Only] Deprecated. This field no longer reflects whether a license
+          # charges a usage fee.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional textual description of the resource; provided by the client
+          # when the resource is created.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "incompatibleLicenses": [ # Specifies licenseCodes of licenses that are incompatible with this license.
+          # If a license is incompatible with this license, it cannot be attached to
+          # the same disk or image.
+        "A String",
+      ],
+      "kind": "compute#license", # Output only. [Output Only] Type of resource. Always compute#license for
+          # licenses.
+      "licenseCode": "A String", # [Output Only] The unique code used to attach this license to images,
+          # snapshots, and disks.
+      "minimumRetention": { # A Duration represents a fixed-length span of time represented # If set, this license will be unable to be removed or replaced once attached
+          # to a disk until the minimum_retention period has passed.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "multiTenantOnly": True or False, # If true, this license can only be used on VMs on multi tenant nodes.
+      "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+          # comply withRFC1035.
+      "osLicense": True or False, # If true, indicates this is an OS license. Only one OS license can be
+          # attached to a disk or image at a time.
+      "params": { # Additional license 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 license. 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",
+        },
+      },
+      "removableFromDisk": True or False, # If true, this license can be removed from a disk's set of licenses, with no
+          # replacement license needed.
+      "requiredCoattachedLicenses": [ # Specifies the set of permissible coattached licenseCodes of licenses that
+          # satisfy the coattachment requirement of this license. At least one license
+          # from the set must be attached to the same disk or image as this license.
+        "A String",
+      ],
+      "resourceRequirements": { # [Input Only] Deprecated.
+        "minGuestCpuCount": 42, # [Input Only] Deprecated. This field no longer reflects the minimum number
+            # of guest cpus required to use the Instance.
+        "minMemoryMb": 42, # [Input Only] Deprecated. This field no longer reflects the minimum memory
+            # required to use the Instance.
+      },
+      "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 with the resource id.
+      "soleTenantOnly": True or False, # If true, this license can only be used on VMs on sole tenant nodes.
+      "transferable": True or False, # If false, licenses will not be copied from the source resource when
+          # creating an image from a disk, disk from snapshot, or snapshot from disk.
+      "updateTimestamp": "A String", # Output only. [Output Only] Last update timestamp inRFC3339
+          # text format.
+    },
+  ],
+  "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.
+  "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.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+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",
+  ],
+}
+
+ +
+ update(project, license, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates a License resource in the specified project.
+ *Caution* This resource is intended
+for use only by third-party partners who are creatingCloud Marketplace
+images.
+
+Args:
+  project: string, Project ID for this request. (required)
+  license: string, The license name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a License resource.
+    # 
+    # A License represents billing and aggregate usage data forpublic andmarketplace images.
+    #  *Caution* This resource is intended for
+    # use only by third-party partners who are creatingCloud Marketplace
+    # images.
+  "allowedReplacementLicenses": [ # Specifies licenseCodes of licenses that can replace this license. Note:
+      # such replacements are allowed even if removable_from_disk is false.
+    "A String",
+  ],
+  "appendableToDisk": True or False, # If true, this license can be appended to an existing disk's set of
+      # licenses.
+  "chargesUseFee": True or False, # [Output Only] Deprecated. This field no longer reflects whether a license
+      # charges a usage fee.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "incompatibleLicenses": [ # Specifies licenseCodes of licenses that are incompatible with this license.
+      # If a license is incompatible with this license, it cannot be attached to
+      # the same disk or image.
+    "A String",
+  ],
+  "kind": "compute#license", # Output only. [Output Only] Type of resource. Always compute#license for
+      # licenses.
+  "licenseCode": "A String", # [Output Only] The unique code used to attach this license to images,
+      # snapshots, and disks.
+  "minimumRetention": { # A Duration represents a fixed-length span of time represented # If set, this license will be unable to be removed or replaced once attached
+      # to a disk until the minimum_retention period has passed.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "multiTenantOnly": True or False, # If true, this license can only be used on VMs on multi tenant nodes.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+      # comply withRFC1035.
+  "osLicense": True or False, # If true, indicates this is an OS license. Only one OS license can be
+      # attached to a disk or image at a time.
+  "params": { # Additional license 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 license. 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",
+    },
+  },
+  "removableFromDisk": True or False, # If true, this license can be removed from a disk's set of licenses, with no
+      # replacement license needed.
+  "requiredCoattachedLicenses": [ # Specifies the set of permissible coattached licenseCodes of licenses that
+      # satisfy the coattachment requirement of this license. At least one license
+      # from the set must be attached to the same disk or image as this license.
+    "A String",
+  ],
+  "resourceRequirements": { # [Input Only] Deprecated.
+    "minGuestCpuCount": 42, # [Input Only] Deprecated. This field no longer reflects the minimum number
+        # of guest cpus required to use the Instance.
+    "minMemoryMb": 42, # [Input Only] Deprecated. This field no longer reflects the minimum memory
+        # required to use the Instance.
+  },
+  "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 with the resource id.
+  "soleTenantOnly": True or False, # If true, this license can only be used on VMs on sole tenant nodes.
+  "transferable": True or False, # If false, licenses will not be copied from the source resource when
+      # creating an image from a disk, disk from snapshot, or snapshot from disk.
+  "updateTimestamp": "A String", # Output only. [Output Only] Last update timestamp inRFC3339
+      # text format.
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.machineImages.html b/docs/dyn/compute_preview.machineImages.html new file mode 100644 index 0000000000..d2d0d2b1a6 --- /dev/null +++ b/docs/dyn/compute_preview.machineImages.html @@ -0,0 +1,7541 @@ + + + +

Compute Engine API . machineImages

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, machineImage, requestId=None, x__xgafv=None)

+

Deletes the specified machine image. Deleting a machine image is permanent

+

+ get(project, machineImage, x__xgafv=None)

+

Returns the specified machine image.

+

+ 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, sourceInstance=None, x__xgafv=None)

+

Creates a machine image in the specified project using the

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of machine images that are 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.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on a machine image. To learn more about labels, read theLabeling

+

+ 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, machineImage, requestId=None, x__xgafv=None) + 
Deletes the specified machine image. Deleting a machine image is permanent
+and cannot be undone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  machineImage: string, The name of the machine image 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, machineImage, x__xgafv=None) + 
Returns the specified machine image.
+
+Args:
+  project: string, Project ID for this request. (required)
+  machineImage: string, The name of the machine image. (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 machine image resource.
+    #
+    # A machine image is a Compute Engine resource that stores all the
+    # configuration, metadata, permissions, and data from one or more disks
+    # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent machine image by
+      # informing the OS to prepare for the snapshot process.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this machine image. The server
+      # defines this identifier.
+  "instanceProperties": { # [Output Only] Properties of source instance
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "kind": "compute#machineImage", # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this machine image, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # machine image.
+  "labels": { # Labels to apply to this machine image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "machineImageEncryptionKey": { # Encrypts the machine image using acustomer-supplied
+      # encryption key.
+      #
+      # After you encrypt a machine image using a customer-supplied key, you must
+      # provide the same key if you use the machine image later. For example, you
+      # must provide the encryption key when you create an instance from the
+      # encrypted machine image in a future request.
+      #
+      # Customer-supplied encryption keys do not protect access to metadata of the
+      # machine image.
+      #
+      # If you do not provide an encryption key when creating the machine image,
+      # then the machine image will be encrypted using an automatically generated
+      # key and you do not need to provide a key to use the machine image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "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.
+  "params": { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
+      # not persisted in the resource.
+    "resourceManagerTags": { # Input only. Resource manager tags to be bound to the machine 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/{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",
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "savedDisks": [ # Output only. An array of Machine Image specific properties for disks attached to the
+      # source instance
+    { # An instance-attached disk resource.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk.
+      "kind": "compute#savedDisk", # Output only. [Output Only] Type of the resource. Always compute#savedDisk
+          # for attached disks.
+      "sourceDisk": "A String", # Output only. Specifies a URL of the disk attached to the source instance.
+      "storageBytes": "A String", # Output only. [Output Only] Size of the individual disk snapshot used by this machine
+          # image.
+      "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+          # stable state or it is being adjusted as a result of shared storage
+          # reallocation. This status can either be UPDATING, meaning
+          # the size of the snapshot is being updated, or UP_TO_DATE,
+          # meaning the size of the snapshot is up-to-date.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] The URL for this machine image. The server defines this URL.
+  "sourceDiskEncryptionKeys": [ # [Input Only] Thecustomer-supplied
+      # encryption key of the disks attached to the source instance. Required
+      # if the source disk is protected by a customer-supplied encryption key.
+    {
+      "diskEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source disk. Required if the source disk is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceDisk": "A String", # URL of the disk attached to the source instance. This can be a full or
+          # valid partial URL. For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+          #    - projects/project/zones/zone/disks/disk
+          #    - zones/zone/disks/disk
+    },
+  ],
+  "sourceInstance": "A String", # The source instance used to create the machine image. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceProperties": { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
+      # instead for source instance related properties. New properties will not be
+      # added to this field.
+      # New properties will not be added to this field.
+    "canIpForward": True or False, # Enables instances created based on this machine image to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "deletionProtection": True or False, # Whether the instance created from this machine image should be protected
+        # against deletion.
+    "description": "A String", # An optional text description for the instances that are created from this
+        # machine image.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from this machine image.
+      { # DEPRECATED: Please use compute#savedDisk instead.
+          # An instance-attached disk resource.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies the name of the disk attached to the source instance.
+        "diskEncryptionKey": { # The encryption key for the disk.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in base-2 GB.
+        "diskType": "A String", # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
+            # pd-ssd
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable only
+            # for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. Specifies zero-based index of the disk that is attached to the source
+            # instance.
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME.
+        "kind": "compute#savedAttachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
+        "source": "A String", # Specifies a URL of the disk attached to the source instance.
+        "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the disk's snapshot by this
+            # machine image.
+        "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+            # stable state or it is being adjusted as a result of shared storage
+            # reallocation. This status can either be UPDATING, meaning
+            # the size of the snapshot is being updated, or UP_TO_DATE,
+            # meaning the size of the snapshot is up-to-date.
+        "type": "A String", # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from this machine image.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from this machine image.
+      "a_key": "A String",
+    },
+    "machineType": "A String", # The machine type to use for instances that are created from this machine
+        # image.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # this machine image. These pairs can consist of custom metadata or
+        # predefined keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances created from this machine
+        # image. The instance may be scheduled on the specified or newer
+        # cpu/platform. Applicable values are the friendly names of CPU platforms,
+        # such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "postKeyRevocationActionType": "A String", # PostKeyRevocationActionType of the instance.
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # this machine image.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from this
+        # machine image. Use metadata queries to obtain the access tokens for these
+        # instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
+        # image. The tags identify valid sources or targets for network firewalls.
+        # The setTags method can modify this list of tags. Each tag within the list
+        # must comply withRFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+  },
+  "status": "A String", # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
+  "storageLocations": [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
+      # stored.
+    "A String",
+  ],
+  "totalStorageBytes": "A String", # Output only. [Output Only] Total size of the storage used by the machine image.
+}
+
+ +
+ 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, sourceInstance=None, x__xgafv=None) + 
Creates a machine image in the specified project using the
+data that is included in the request. If you are creating a new machine
+image to update an existing instance, your new machine image should use the
+same network or, if applicable, the same subnetwork as the original
+instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a machine image resource.
+    # 
+    # A machine image is a Compute Engine resource that stores all the
+    # configuration, metadata, permissions, and data from one or more disks
+    # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent machine image by
+      # informing the OS to prepare for the snapshot process.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this machine image. The server
+      # defines this identifier.
+  "instanceProperties": { # [Output Only] Properties of source instance
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "kind": "compute#machineImage", # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this machine image, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # machine image.
+  "labels": { # Labels to apply to this machine image. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "machineImageEncryptionKey": { # Encrypts the machine image using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt a machine image using a customer-supplied key, you must
+      # provide the same key if you use the machine image later. For example, you
+      # must provide the encryption key when you create an instance from the
+      # encrypted machine image in a future request.
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata of the
+      # machine image.
+      # 
+      # If you do not provide an encryption key when creating the machine image,
+      # then the machine image will be encrypted using an automatically generated
+      # key and you do not need to provide a key to use the machine image later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "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.
+  "params": { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
+      # not persisted in the resource.
+    "resourceManagerTags": { # Input only. Resource manager tags to be bound to the machine 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/{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",
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "savedDisks": [ # Output only. An array of Machine Image specific properties for disks attached to the
+      # source instance
+    { # An instance-attached disk resource.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk.
+      "kind": "compute#savedDisk", # Output only. [Output Only] Type of the resource. Always compute#savedDisk
+          # for attached disks.
+      "sourceDisk": "A String", # Output only. Specifies a URL of the disk attached to the source instance.
+      "storageBytes": "A String", # Output only. [Output Only] Size of the individual disk snapshot used by this machine
+          # image.
+      "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+          # stable state or it is being adjusted as a result of shared storage
+          # reallocation. This status can either be UPDATING, meaning
+          # the size of the snapshot is being updated, or UP_TO_DATE,
+          # meaning the size of the snapshot is up-to-date.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] The URL for this machine image. The server defines this URL.
+  "sourceDiskEncryptionKeys": [ # [Input Only] Thecustomer-supplied
+      # encryption key of the disks attached to the source instance. Required
+      # if the source disk is protected by a customer-supplied encryption key.
+    {
+      "diskEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source disk. Required if the source disk is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceDisk": "A String", # URL of the disk attached to the source instance. This can be a full or
+          # valid partial URL. For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+          #    - projects/project/zones/zone/disks/disk
+          #    - zones/zone/disks/disk
+    },
+  ],
+  "sourceInstance": "A String", # The source instance used to create the machine image. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceProperties": { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
+      # instead for source instance related properties. New properties will not be
+      # added to this field.
+      # New properties will not be added to this field.
+    "canIpForward": True or False, # Enables instances created based on this machine image to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "deletionProtection": True or False, # Whether the instance created from this machine image should be protected
+        # against deletion.
+    "description": "A String", # An optional text description for the instances that are created from this
+        # machine image.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from this machine image.
+      { # DEPRECATED: Please use compute#savedDisk instead.
+          # An instance-attached disk resource.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies the name of the disk attached to the source instance.
+        "diskEncryptionKey": { # The encryption key for the disk.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in base-2 GB.
+        "diskType": "A String", # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
+            # pd-ssd
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable only
+            # for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. Specifies zero-based index of the disk that is attached to the source
+            # instance.
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME.
+        "kind": "compute#savedAttachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
+        "source": "A String", # Specifies a URL of the disk attached to the source instance.
+        "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the disk's snapshot by this
+            # machine image.
+        "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+            # stable state or it is being adjusted as a result of shared storage
+            # reallocation. This status can either be UPDATING, meaning
+            # the size of the snapshot is being updated, or UP_TO_DATE,
+            # meaning the size of the snapshot is up-to-date.
+        "type": "A String", # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from this machine image.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from this machine image.
+      "a_key": "A String",
+    },
+    "machineType": "A String", # The machine type to use for instances that are created from this machine
+        # image.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # this machine image. These pairs can consist of custom metadata or
+        # predefined keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances created from this machine
+        # image. The instance may be scheduled on the specified or newer
+        # cpu/platform. Applicable values are the friendly names of CPU platforms,
+        # such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "postKeyRevocationActionType": "A String", # PostKeyRevocationActionType of the instance.
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # this machine image.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from this
+        # machine image. Use metadata queries to obtain the access tokens for these
+        # instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
+        # image. The tags identify valid sources or targets for network firewalls.
+        # The setTags method can modify this list of tags. Each tag within the list
+        # must comply withRFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+  },
+  "status": "A String", # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
+  "storageLocations": [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
+      # stored.
+    "A String",
+  ],
+  "totalStorageBytes": "A String", # Output only. [Output Only] Total size of the storage used by the machine image.
+}
+
+  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).
+  sourceInstance: string, Required. Source instance that is used to create the machine image from.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of machine images that are 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of machine images.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of MachineImage resources.
+    { # Represents a machine image resource.
+        #
+        # A machine image is a Compute Engine resource that stores all the
+        # configuration, metadata, permissions, and data from one or more disks
+        # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent machine image by
+          # informing the OS to prepare for the snapshot process.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this machine image. The server
+          # defines this identifier.
+      "instanceProperties": { # [Output Only] Properties of source instance
+        "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+            # Note that for MachineImage, this is not supported yet.
+            # Options that would traditionally be configured in a BIOS belong
+            # here. Features that require operating system support may have
+            # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+            # disabled).
+          "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+          "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+          "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+          "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+              # multithreading (SMT) set this to 1. If unset, the maximum number
+              # of threads supported per core by the underlying processor is
+              # assumed.
+          "turboMode": "A String", # Turbo frequency mode to use for the instance.
+              # Supported modes include:
+              # * ALL_CORE_MAX
+              #
+              # Using empty string or not setting this field will use the platform-specific
+              # default turbo mode.
+          "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+              # the number of threads per core to compute the total number of virtual
+              # CPUs to expose to the instance. If unset, the number of cores is
+              # inferred from the instance's nominal CPU count and the underlying
+              # platform's SMT width.
+        },
+        "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+            # source IP addresses other than their own and receive packets with
+            # destination IP addresses other than their own. If these instances will be
+            # used as an IP gateway or it will be set as the next-hop in a Route
+            # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+            # documentation for more information.
+        "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+            # Note that for MachineImage, this is not supported yet.
+          "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+          "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+        },
+        "description": "A String", # An optional text description for the instances that are created from these
+            # properties.
+        "disks": [ # An array of disks that are associated with the instances that are created
+            # from these properties.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+            # created from these properties.
+          { # A specification of the type and number of accelerator cards attached to the
+              # instance.
+            "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+            "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                # If you are creating an instance template, specify only the
+                # accelerator name.
+                # See GPUs on Compute Engine
+                # for a full list of accelerator types.
+          },
+        ],
+        "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+            # "NONE". The default value is "NONE" if it is not specified.
+        "labels": { # Labels to apply to instances that are created from these properties.
+          "a_key": "A String",
+        },
+        "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+            # Local SSDs attached to the VM.
+        "machineType": "A String", # The machine type to use for instances that are created from these
+            # properties.
+            # This field only accepts a machine type name, for example `n2-standard-4`.
+            # If you use the machine type full or partial URL, for example
+            # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+            # the request will result in an `INTERNAL_ERROR`.
+        "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+            # these properties. These pairs can consist of custom metadata or predefined
+            # keys. SeeProject and
+            # instance metadata for more information.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve the resource.
+          "items": [ # Array of key/value pairs. The total size of all keys and values must be
+              # less than 512 KB.
+            { # Metadata
+              "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                  # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                  # This is reflected as part of a URL in the metadata server. Additionally, to
+                  # avoid ambiguity, keys must not conflict with any other metadata keys
+                  # for the project.
+              "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                  # have meaning as interpreted by the image running in the instance. The
+                  # only restriction placed on values is that their size must be less than
+                  # or equal to 262144 bytes (256 KiB).
+            },
+          ],
+          "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+              # for metadata.
+        },
+        "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+            # scheduled on the specified or newer cpu/platform. Applicable values are the
+            # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+            # information, read Specifying a
+            # Minimum CPU Platform.
+        "networkInterfaces": [ # An array of network access configurations for this interface.
+          { # A network interface resource attached to an instance.
+            "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                # no external internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                # with network_attachment.
+            "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                # This field will be ignored when inserting an Instance or
+                # adding a NetworkInterface. An up-to-date
+                # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+            "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                # or not. If enabled, also indicates the version of IGMP supported.
+            "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+            "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                # is no ipv6AccessConfig specified, then this instance will
+                # have no external IPv6 Internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                # accessed from the Internet. This field is always inherited from its
+                # subnetwork.
+                #
+                # Valid only if stackType is IPV4_IPV6.
+            "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                # use a static internal IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an internal IPv6 address from the instance's subnetwork.
+            "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+            "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                # server. For a VM, the network interface uses the nicN naming
+                # format. Where N is a value between 0 and7. The default interface value is nic0.
+            "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                # instance, if neither the network nor the subnetwork is specified, the
+                # default network global/networks/default is used. If the
+                # selected project doesn't have the default network, you must specify a
+                # network or subnet. If the network is not specified but the subnetwork is
+                # specified, the network is inferred.
+                #
+                # If you specify this property, you can specify the network as
+                # a full or partial URL. For example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                #       - projects/project/global/networks/network
+                #       - global/networks/default
+            "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                # to in the following format:
+                # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+            "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                # interface. If not specified by the user, an unused internal IP is
+                # assigned by the system.
+            "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                # VirtioNet.
+            "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+            "queueCount": 42, # The networking queue count that's specified by users for the network
+                # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                # if not specified by the users.
+            "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                # interface. Can only be used with network_attachment. It is not possible to
+                # use on its own however, network_attachment can be used without
+                # service_class_id.
+            "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                #
+                # This field can be both set at instance creation and update network
+                # interface operations.
+            "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                # resource is inlegacy
+                # mode, do not specify this field. If the network is in auto subnet
+                # mode, specifying the subnetwork is optional. If the network is in custom
+                # subnet mode, specifying the subnetwork is required. If you specify this
+                # field, you can specify the subnetwork as a full or partial URL. For
+                # example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                #    - regions/region/subnetworks/subnetwork
+            "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                # from 2 to 255 inclusively.
+          },
+        ],
+        "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+          "totalEgressBandwidthTier": "A String",
+        },
+        "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+            # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+            # Note that for MachineImage, this is not supported yet.
+        "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+            # Note that for MachineImage, this is not supported yet.
+          "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+              # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+              # Consuming reserved instances for examples.
+          "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+              # the name of your reservation as its value.
+          "values": [ # Corresponds to the label values of a reservation resource. This can be
+              # either a name to a reservation in the same project or
+              # "projects/different-project/reservations/some-reservation-name" to target a
+              # shared reservation in the same zone but in a different project.
+            "A String",
+          ],
+        },
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+            # these properties.
+            # Note that for MachineImage, this is not supported yet.
+          "A String",
+        ],
+        "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+            # these properties.
+          "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+              # terminated by Compute Engine (not terminated by a user). You can only set
+              # the automatic restart option for standard instances.Preemptible instances
+              # cannot be automatically restarted.
+              #
+              # By default, this is set to true so an instance is
+              # automatically restarted if it is terminated by Compute Engine.
+          "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+              # must be a number between 1 and the number of availability domains
+              # specified in the spread placement policy attached to the instance.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+              # ResourceStatus resource of the VM.
+          "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+            "enabled": True or False, # Opts-in for graceful shutdown.
+            "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                # graceful shutdown isn't complete after this time, then the instance
+                # transitions to the STOPPING state.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+              # within the range of [90, 330] with the increment of 30, if unset, the
+              # default behavior of host error recovery will be used.
+          "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+          "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+              # recovery of the Local Ssd state is attempted. Its value should be in
+              # between 0 and 168 hours with hour granularity and the default value being 1
+              # hour.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "locationHint": "A String", # An opaque location hint used to place the instance close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+              # the instance termination action will be performed at the end of the run
+              # duration.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+              # on a sole-tenant node.
+          "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+              # affinity for more information.
+              # Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which this Instance
+                #  could be scheduled.
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+              # the default behavior is MIGRATE. Forpreemptible instances,
+              # the default and only possible behavior is TERMINATE. For more
+              # information, see
+              #  Set
+              #  VM host maintenance policy.
+          "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+            "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                # else, the Local SSD data will be preserved when the instance is stopped
+                # at the end of the run duration/termination time.
+          },
+          "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+              # instance creation or while the instance isstopped and
+              # therefore, in a `TERMINATED` state. SeeInstance Life
+              # Cycle for more information on the possible instance states.
+          "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+              # Soft Off signal is triggered for Spot VMs only. If not specified,
+              # there will be no wait before the G2 Soft Off signal is triggered.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+          "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+              # Off and ACPI G3 Mechanical
+              # Off for Standard VMs and 30 seconds for Spot VMs.
+          "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+              # termination action will be performed at the termination time.
+        },
+        "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+            # service accounts are available to the instances that are created from
+            # these properties. Use metadata queries to obtain the access tokens for
+            # these instances.
+          { # A service account.
+            "email": "A String", # Email address of the service account.
+            "scopes": [ # The list of scopes to be made available for this service account.
+              "A String",
+            ],
+          },
+        ],
+        "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+          "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+              # default.
+          "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+              # default.
+          "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+              # default.
+        },
+        "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+            # properties. The tags identify valid sources or targets for network
+            # firewalls. The setTags method can modify this list of tags. Each tag within
+            # the list must comply with RFC1035.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the tags' contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update tags. You must always provide an
+              # up-to-date fingerprint hash in order to update or change tags.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+              # with RFC1035.
+            "A String",
+          ],
+        },
+        "workloadIdentityConfig": {
+          "identity": "A String",
+          "identityCertificateEnabled": True or False,
+        },
+      },
+      "kind": "compute#machineImage", # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this machine image, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # machine image.
+      "labels": { # Labels to apply to this machine image. These can be later modified by
+          # the setLabels method.
+        "a_key": "A String",
+      },
+      "machineImageEncryptionKey": { # Encrypts the machine image using acustomer-supplied
+          # encryption key.
+          #
+          # After you encrypt a machine image using a customer-supplied key, you must
+          # provide the same key if you use the machine image later. For example, you
+          # must provide the encryption key when you create an instance from the
+          # encrypted machine image in a future request.
+          #
+          # Customer-supplied encryption keys do not protect access to metadata of the
+          # machine image.
+          #
+          # If you do not provide an encryption key when creating the machine image,
+          # then the machine image will be encrypted using an automatically generated
+          # key and you do not need to provide a key to use the machine image later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "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.
+      "params": { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
+          # not persisted in the resource.
+        "resourceManagerTags": { # Input only. Resource manager tags to be bound to the machine 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/{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",
+        },
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "savedDisks": [ # Output only. An array of Machine Image specific properties for disks attached to the
+          # source instance
+        { # An instance-attached disk resource.
+          "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk.
+          "kind": "compute#savedDisk", # Output only. [Output Only] Type of the resource. Always compute#savedDisk
+              # for attached disks.
+          "sourceDisk": "A String", # Output only. Specifies a URL of the disk attached to the source instance.
+          "storageBytes": "A String", # Output only. [Output Only] Size of the individual disk snapshot used by this machine
+              # image.
+          "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+              # stable state or it is being adjusted as a result of shared storage
+              # reallocation. This status can either be UPDATING, meaning
+              # the size of the snapshot is being updated, or UP_TO_DATE,
+              # meaning the size of the snapshot is up-to-date.
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] The URL for this machine image. The server defines this URL.
+      "sourceDiskEncryptionKeys": [ # [Input Only] Thecustomer-supplied
+          # encryption key of the disks attached to the source instance. Required
+          # if the source disk is protected by a customer-supplied encryption key.
+        {
+          "diskEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source disk. Required if the source disk is
+              # protected by a customer-supplied encryption key.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceDisk": "A String", # URL of the disk attached to the source instance. This can be a full or
+              # valid partial URL. For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+              #    - projects/project/zones/zone/disks/disk
+              #    - zones/zone/disks/disk
+        },
+      ],
+      "sourceInstance": "A String", # The source instance used to create the machine image. 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/zones/zone/instances/instance
+          #    - projects/project/zones/zone/instances/instance
+      "sourceInstanceProperties": { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
+          # instead for source instance related properties. New properties will not be
+          # added to this field.
+          # New properties will not be added to this field.
+        "canIpForward": True or False, # Enables instances created based on this machine image to send packets with
+            # source IP addresses other than their own and receive packets with
+            # destination IP addresses other than their own. If these instances will be
+            # used as an IP gateway or it will be set as the next-hop in a Route
+            # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+            # documentation for more information.
+        "deletionProtection": True or False, # Whether the instance created from this machine image should be protected
+            # against deletion.
+        "description": "A String", # An optional text description for the instances that are created from this
+            # machine image.
+        "disks": [ # An array of disks that are associated with the instances that are created
+            # from this machine image.
+          { # DEPRECATED: Please use compute#savedDisk instead.
+              # An instance-attached disk resource.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies the name of the disk attached to the source instance.
+            "diskEncryptionKey": { # The encryption key for the disk.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in base-2 GB.
+            "diskType": "A String", # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
+                # pd-ssd
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable only
+                # for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. Specifies zero-based index of the disk that is attached to the source
+                # instance.
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME.
+            "kind": "compute#savedAttachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
+            "source": "A String", # Specifies a URL of the disk attached to the source instance.
+            "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the disk's snapshot by this
+                # machine image.
+            "storageBytesStatus": "A String", # Output only. [Output Only] An indicator whether storageBytes is in a
+                # stable state or it is being adjusted as a result of shared storage
+                # reallocation. This status can either be UPDATING, meaning
+                # the size of the snapshot is being updated, or UP_TO_DATE,
+                # meaning the size of the snapshot is up-to-date.
+            "type": "A String", # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
+          },
+        ],
+        "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+            # created from this machine image.
+          { # A specification of the type and number of accelerator cards attached to the
+              # instance.
+            "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+            "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                # If you are creating an instance template, specify only the
+                # accelerator name.
+                # See GPUs on Compute Engine
+                # for a full list of accelerator types.
+          },
+        ],
+        "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+            # "NONE". The default value is "NONE" if it is not specified.
+        "labels": { # Labels to apply to instances that are created from this machine image.
+          "a_key": "A String",
+        },
+        "machineType": "A String", # The machine type to use for instances that are created from this machine
+            # image.
+        "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+            # this machine image. These pairs can consist of custom metadata or
+            # predefined keys. SeeProject and
+            # instance metadata for more information.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve the resource.
+          "items": [ # Array of key/value pairs. The total size of all keys and values must be
+              # less than 512 KB.
+            { # Metadata
+              "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                  # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                  # This is reflected as part of a URL in the metadata server. Additionally, to
+                  # avoid ambiguity, keys must not conflict with any other metadata keys
+                  # for the project.
+              "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                  # have meaning as interpreted by the image running in the instance. The
+                  # only restriction placed on values is that their size must be less than
+                  # or equal to 262144 bytes (256 KiB).
+            },
+          ],
+          "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+              # for metadata.
+        },
+        "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances created from this machine
+            # image. The instance may be scheduled on the specified or newer
+            # cpu/platform. Applicable values are the friendly names of CPU platforms,
+            # such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+            # information, read Specifying a
+            # Minimum CPU Platform.
+        "networkInterfaces": [ # An array of network access configurations for this interface.
+          { # A network interface resource attached to an instance.
+            "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                # no external internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                # with network_attachment.
+            "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                # This field will be ignored when inserting an Instance or
+                # adding a NetworkInterface. An up-to-date
+                # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+            "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                # or not. If enabled, also indicates the version of IGMP supported.
+            "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+            "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                # is no ipv6AccessConfig specified, then this instance will
+                # have no external IPv6 Internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                # accessed from the Internet. This field is always inherited from its
+                # subnetwork.
+                #
+                # Valid only if stackType is IPV4_IPV6.
+            "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                # use a static internal IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an internal IPv6 address from the instance's subnetwork.
+            "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+            "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                # server. For a VM, the network interface uses the nicN naming
+                # format. Where N is a value between 0 and7. The default interface value is nic0.
+            "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                # instance, if neither the network nor the subnetwork is specified, the
+                # default network global/networks/default is used. If the
+                # selected project doesn't have the default network, you must specify a
+                # network or subnet. If the network is not specified but the subnetwork is
+                # specified, the network is inferred.
+                #
+                # If you specify this property, you can specify the network as
+                # a full or partial URL. For example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                #       - projects/project/global/networks/network
+                #       - global/networks/default
+            "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                # to in the following format:
+                # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+            "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                # interface. If not specified by the user, an unused internal IP is
+                # assigned by the system.
+            "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                # VirtioNet.
+            "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+            "queueCount": 42, # The networking queue count that's specified by users for the network
+                # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                # if not specified by the users.
+            "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                # interface. Can only be used with network_attachment. It is not possible to
+                # use on its own however, network_attachment can be used without
+                # service_class_id.
+            "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                #
+                # This field can be both set at instance creation and update network
+                # interface operations.
+            "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                # resource is inlegacy
+                # mode, do not specify this field. If the network is in auto subnet
+                # mode, specifying the subnetwork is optional. If the network is in custom
+                # subnet mode, specifying the subnetwork is required. If you specify this
+                # field, you can specify the subnetwork as a full or partial URL. For
+                # example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                #    - regions/region/subnetworks/subnetwork
+            "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                # from 2 to 255 inclusively.
+          },
+        ],
+        "postKeyRevocationActionType": "A String", # PostKeyRevocationActionType of the instance.
+        "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+            # this machine image.
+          "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+              # terminated by Compute Engine (not terminated by a user). You can only set
+              # the automatic restart option for standard instances.Preemptible instances
+              # cannot be automatically restarted.
+              #
+              # By default, this is set to true so an instance is
+              # automatically restarted if it is terminated by Compute Engine.
+          "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+              # must be a number between 1 and the number of availability domains
+              # specified in the spread placement policy attached to the instance.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+              # ResourceStatus resource of the VM.
+          "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+            "enabled": True or False, # Opts-in for graceful shutdown.
+            "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                # graceful shutdown isn't complete after this time, then the instance
+                # transitions to the STOPPING state.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+              # within the range of [90, 330] with the increment of 30, if unset, the
+              # default behavior of host error recovery will be used.
+          "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+          "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+              # recovery of the Local Ssd state is attempted. Its value should be in
+              # between 0 and 168 hours with hour granularity and the default value being 1
+              # hour.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "locationHint": "A String", # An opaque location hint used to place the instance close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+              # the instance termination action will be performed at the end of the run
+              # duration.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+              # on a sole-tenant node.
+          "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+              # affinity for more information.
+              # Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which this Instance
+                #  could be scheduled.
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+              # the default behavior is MIGRATE. Forpreemptible instances,
+              # the default and only possible behavior is TERMINATE. For more
+              # information, see
+              #  Set
+              #  VM host maintenance policy.
+          "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+            "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                # else, the Local SSD data will be preserved when the instance is stopped
+                # at the end of the run duration/termination time.
+          },
+          "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+              # instance creation or while the instance isstopped and
+              # therefore, in a `TERMINATED` state. SeeInstance Life
+              # Cycle for more information on the possible instance states.
+          "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+              # Soft Off signal is triggered for Spot VMs only. If not specified,
+              # there will be no wait before the G2 Soft Off signal is triggered.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+          "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+              # Off and ACPI G3 Mechanical
+              # Off for Standard VMs and 30 seconds for Spot VMs.
+          "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+              # termination action will be performed at the termination time.
+        },
+        "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+            # service accounts are available to the instances that are created from this
+            # machine image. Use metadata queries to obtain the access tokens for these
+            # instances.
+          { # A service account.
+            "email": "A String", # Email address of the service account.
+            "scopes": [ # The list of scopes to be made available for this service account.
+              "A String",
+            ],
+          },
+        ],
+        "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
+            # image. The tags identify valid sources or targets for network firewalls.
+            # The setTags method can modify this list of tags. Each tag within the list
+            # must comply withRFC1035.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the tags' contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update tags. You must always provide an
+              # up-to-date fingerprint hash in order to update or change tags.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+              # with RFC1035.
+            "A String",
+          ],
+        },
+      },
+      "status": "A String", # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
+      "storageLocations": [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
+          # stored.
+        "A String",
+      ],
+      "totalStorageBytes": "A String", # Output only. [Output Only] Total size of the storage used by the machine image.
+    },
+  ],
+  "kind": "compute#machineImageList", # Output only. [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists.
+  "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.
+  "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).
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on a machine image. To learn more about labels, read theLabeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.machineTypes.html b/docs/dyn/compute_preview.machineTypes.html new file mode 100644 index 0000000000..1346345dfc --- /dev/null +++ b/docs/dyn/compute_preview.machineTypes.html @@ -0,0 +1,633 @@ + + + +

Compute Engine API . machineTypes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of machine types.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, machineType, x__xgafv=None)

+

Returns the specified machine type.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of machine types available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of machine types.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of MachineTypesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of machine types.
+      "machineTypes": [ # [Output Only] A list of machine types contained in this scope.
+        { # Represents a Machine Type resource.
+            #
+            # You can use specific machine types for your VM instances based on performance
+            # and pricing requirements. For more information, readMachine Types.
+          "accelerators": [ # [Output Only] A list of accelerator configurations assigned to this
+              # machine type.
+            {
+              "guestAcceleratorCount": 42, # Number of accelerator cards exposed to the guest.
+              "guestAcceleratorType": "A String", # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
+            },
+          ],
+          "architecture": "A String", # [Output Only] The architecture of the machine type.
+          "bundledLocalSsds": { # [Output Only] The configuration of bundled local SSD for the machine type.
+            "defaultInterface": "A String", # The default disk interface if the interface is not specified.
+            "partitionCount": 42, # The number of partitions.
+          },
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
+              # Only applicable if the machine type is unavailable.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DELETED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DEPRECATED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to OBSOLETE. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+                # The suggested replacement resource must be the same kind of resource as the
+                # deprecated resource.
+            "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+                # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+                # warning indicating the deprecated resource and recommending its
+                # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+          },
+          "description": "A String", # [Output Only] An optional textual description of the resource.
+          "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the
+              # instance.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "imageSpaceGb": 42, # [Deprecated] This property is deprecated and will never be populated with
+              # any relevant values.
+          "isSharedCpu": True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
+              # types for more information.
+          "kind": "compute#machineType", # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
+          "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
+          "maximumPersistentDisksSizeGb": "A String", # [Output Only] Maximum total persistent disks size (GB) allowed.
+          "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance,
+              # defined in MB.
+          "name": "A String", # [Output Only] Name of the resource.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "zone": "A String", # [Output Only] The name of the zone where the machine type resides,
+              # such as us-central1-a.
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that appears when the machine types
+          # 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#machineTypeAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of
+      # machine types.
+  "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.
+
+ +
+ get(project, zone, machineType, x__xgafv=None) + 
Returns the specified machine type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  machineType: string, Name of the machine type 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 Machine Type resource.
+    #
+    # You can use specific machine types for your VM instances based on performance
+    # and pricing requirements. For more information, readMachine Types.
+  "accelerators": [ # [Output Only] A list of accelerator configurations assigned to this
+      # machine type.
+    {
+      "guestAcceleratorCount": 42, # Number of accelerator cards exposed to the guest.
+      "guestAcceleratorType": "A String", # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
+    },
+  ],
+  "architecture": "A String", # [Output Only] The architecture of the machine type.
+  "bundledLocalSsds": { # [Output Only] The configuration of bundled local SSD for the machine type.
+    "defaultInterface": "A String", # The default disk interface if the interface is not specified.
+    "partitionCount": 42, # The number of partitions.
+  },
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
+      # Only applicable if the machine type is unavailable.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional textual description of the resource.
+  "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the
+      # instance.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "imageSpaceGb": 42, # [Deprecated] This property is deprecated and will never be populated with
+      # any relevant values.
+  "isSharedCpu": True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
+      # types for more information.
+  "kind": "compute#machineType", # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
+  "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
+  "maximumPersistentDisksSizeGb": "A String", # [Output Only] Maximum total persistent disks size (GB) allowed.
+  "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance,
+      # defined in MB.
+  "name": "A String", # [Output Only] Name of the resource.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "zone": "A String", # [Output Only] The name of the zone where the machine type resides,
+      # such as us-central1-a.
+}
+
+ +
+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of machine types available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 machine types.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of MachineType resources.
+    { # Represents a Machine Type resource.
+        #
+        # You can use specific machine types for your VM instances based on performance
+        # and pricing requirements. For more information, readMachine Types.
+      "accelerators": [ # [Output Only] A list of accelerator configurations assigned to this
+          # machine type.
+        {
+          "guestAcceleratorCount": 42, # Number of accelerator cards exposed to the guest.
+          "guestAcceleratorType": "A String", # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
+        },
+      ],
+      "architecture": "A String", # [Output Only] The architecture of the machine type.
+      "bundledLocalSsds": { # [Output Only] The configuration of bundled local SSD for the machine type.
+        "defaultInterface": "A String", # The default disk interface if the interface is not specified.
+        "partitionCount": 42, # The number of partitions.
+      },
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
+          # Only applicable if the machine type is unavailable.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional textual description of the resource.
+      "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the
+          # instance.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "imageSpaceGb": 42, # [Deprecated] This property is deprecated and will never be populated with
+          # any relevant values.
+      "isSharedCpu": True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
+          # types for more information.
+      "kind": "compute#machineType", # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
+      "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
+      "maximumPersistentDisksSizeGb": "A String", # [Output Only] Maximum total persistent disks size (GB) allowed.
+      "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance,
+          # defined in MB.
+      "name": "A String", # [Output Only] Name of the resource.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "zone": "A String", # [Output Only] The name of the zone where the machine type resides,
+          # such as us-central1-a.
+    },
+  ],
+  "kind": "compute#machineTypeList", # Output only. [Output Only] Type of resource. Always compute#machineTypeList
+      # for lists of machine types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.managedRulesets.html b/docs/dyn/compute_preview.managedRulesets.html new file mode 100644 index 0000000000..1ca1a166b8 --- /dev/null +++ b/docs/dyn/compute_preview.managedRulesets.html @@ -0,0 +1,302 @@ + + + +

Compute Engine API . managedRulesets

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, managedRuleset, x__xgafv=None)

+

Gets the details for the specified managed ruleset name.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of all the managed rulesets available.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, managedRuleset, x__xgafv=None) + 
Gets the details for the specified managed ruleset name.
+
+Args:
+  project: string, Project ID for this request. (required)
+  managedRuleset: string, Name of the managed ruleset 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 ManagedRuleset resource.
+    #
+    # Managed internally by Cloud Armor CLH for Managed Rules features.
+    # Customers can only view these resources to modify their Security Policies.
+    # For more information, see
+    # https://cloud.google.com/armor/docs/.
+  "changeLog": "A String", # Output only. [Output Only] The change log for this managed ruleset.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # [Output Only] An optional description of this resource.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "name": "A String", # Name of the resource. Generated internally 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.
+  "ruleIds": [ # Output only. [Output Only] The list of managed rule IDs that are included in
+      # this managed ruleset.
+    "A String",
+  ],
+  "rulesetId": "A String", # Output only. [Output Only] The managed ruleset identifier that can be configured in
+      # Security Policy rules.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of all the managed rulesets available.
+
+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.
+  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",
+  "items": [ # The list of managed rulesets.
+    { # Represents a ManagedRuleset resource.
+        #
+        # Managed internally by Cloud Armor CLH for Managed Rules features.
+        # Customers can only view these resources to modify their Security Policies.
+        # For more information, see
+        # https://cloud.google.com/armor/docs/.
+      "changeLog": "A String", # Output only. [Output Only] The change log for this managed ruleset.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339 text format.
+      "description": "A String", # [Output Only] An optional description of this resource.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "name": "A String", # Name of the resource. Generated internally 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.
+      "ruleIds": [ # Output only. [Output Only] The list of managed rule IDs that are included in
+          # this managed ruleset.
+        "A String",
+      ],
+      "rulesetId": "A String", # Output only. [Output Only] The managed ruleset identifier that can be configured in
+          # Security Policy rules.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    },
+  ],
+  "nextPageToken": "A String",
+  "warning": {
+    "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.networkAttachments.html b/docs/dyn/compute_preview.networkAttachments.html new file mode 100644 index 0000000000..b4452f3897 --- /dev/null +++ b/docs/dyn/compute_preview.networkAttachments.html @@ -0,0 +1,3013 @@ + + + +

Compute Engine API . networkAttachments

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all NetworkAttachment resources,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, networkAttachment, requestId=None, x__xgafv=None)

+

Deletes the specified NetworkAttachment in the given scope

+

+ get(project, region, networkAttachment, x__xgafv=None)

+

Returns the specified NetworkAttachment resource in the given scope.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a NetworkAttachment in the specified project in the given scope

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the NetworkAttachments for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, networkAttachment, body=None, requestId=None, x__xgafv=None)

+

Patches the specified NetworkAttachment resource with the data included in

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all NetworkAttachment resources,
+regional and global, available to the specified project.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 NetworkAttachmentsScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NetworkAttachmentsScopedList resources.
+    "a_key": { # Name of the scope containing this set of NetworkAttachments.
+      "networkAttachments": [ # A list of NetworkAttachments contained in this scope.
+        { # NetworkAttachments
+            # A network attachment resource ...
+          "connectionEndpoints": [ # Output only. [Output Only] An array of connections for all the producers connected
+              # to this network attachment.
+            { # [Output Only] A connection connected to this network attachment.
+              "ipAddress": "A String", # The IPv4 address assigned to the producer instance network interface.
+                  # This value will be a range in case of Serverless.
+              "ipv6Address": "A String", # The IPv6 address assigned to the producer instance network interface.
+                  # This is only assigned when the stack types of both the instance network
+                  # interface and the consumer subnet are IPv4_IPv6.
+              "projectIdOrNum": "A String", # The project id or number of the interface to which the IP was assigned.
+              "secondaryIpCidrRanges": [ # Alias IP ranges from the same subnetwork.
+                "A String",
+              ],
+              "serviceClassId": "A String", # The service class id of the producer service to which the IP was
+                  # assigned.
+              "status": "A String", # The status of a connected endpoint to this network attachment.
+              "subnetwork": "A String", # The subnetwork used to assign the IP to the producer
+                  # instance network interface.
+              "subnetworkCidrRange": "A String", # Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal
+                  # IP was allocated from.
+            },
+          ],
+          "connectionPreference": "A String",
+          "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. An up-to-date
+              # fingerprint must be provided in order to patch.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+              # generates this identifier.
+          "kind": "compute#networkAttachment", # Output only. [Output Only] Type of the resource.
+          "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.
+          "network": "A String", # Output only. [Output Only] The URL of the network which the Network Attachment
+              # belongs to. Practically it is inferred by fetching the network of the first
+              # subnetwork associated. Because it is required that all the subnetworks must
+              # be from the same network, it is assured that the Network Attachment belongs
+              # to the same network as all the subnetworks.
+          "producerAcceptLists": [ # Projects or service class ids that are allowed to connect to this network
+              # attachment. The project can be specified using its id or number. Service
+              # class id can be specified as "serviceclasses/{service_class_id}".
+            "A String",
+          ],
+          "producerRejectLists": [ # Projects or service class ids that are not allowed to connect to this
+              # network attachment. The project can be specified using its id or number.
+              # Service class id can be specified as "serviceclasses/{service_class_id}".
+            "A String",
+          ],
+          "region": "A String", # Output only. [Output Only] URL of the region where the network attachment resides.
+              # This field applies only to the region 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 for this resource's resource id.
+          "subnetworks": [ # An array of URLs where each entry is the URL of a subnet
+              # provided by the service consumer to use for
+              # endpoints in the producers that connect to this network attachment.
+            "A String",
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # network attachments 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#networkAttachmentAggregatedList",
+  "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.
+  },
+}
+
+ +
+ 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, networkAttachment, requestId=None, x__xgafv=None) + 
Deletes the specified NetworkAttachment in the given scope
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  networkAttachment: string, Name of the NetworkAttachment 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, networkAttachment, x__xgafv=None) + 
Returns the specified NetworkAttachment resource in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  networkAttachment: string, Name of the NetworkAttachment 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:
+
+    { # NetworkAttachments
+    # A network attachment resource ...
+  "connectionEndpoints": [ # Output only. [Output Only] An array of connections for all the producers connected
+      # to this network attachment.
+    { # [Output Only] A connection connected to this network attachment.
+      "ipAddress": "A String", # The IPv4 address assigned to the producer instance network interface.
+          # This value will be a range in case of Serverless.
+      "ipv6Address": "A String", # The IPv6 address assigned to the producer instance network interface.
+          # This is only assigned when the stack types of both the instance network
+          # interface and the consumer subnet are IPv4_IPv6.
+      "projectIdOrNum": "A String", # The project id or number of the interface to which the IP was assigned.
+      "secondaryIpCidrRanges": [ # Alias IP ranges from the same subnetwork.
+        "A String",
+      ],
+      "serviceClassId": "A String", # The service class id of the producer service to which the IP was
+          # assigned.
+      "status": "A String", # The status of a connected endpoint to this network attachment.
+      "subnetwork": "A String", # The subnetwork used to assign the IP to the producer
+          # instance network interface.
+      "subnetworkCidrRange": "A String", # Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal
+          # IP was allocated from.
+    },
+  ],
+  "connectionPreference": "A String",
+  "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. An up-to-date
+      # fingerprint must be provided in order to patch.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#networkAttachment", # Output only. [Output Only] Type of the resource.
+  "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.
+  "network": "A String", # Output only. [Output Only] The URL of the network which the Network Attachment
+      # belongs to. Practically it is inferred by fetching the network of the first
+      # subnetwork associated. Because it is required that all the subnetworks must
+      # be from the same network, it is assured that the Network Attachment belongs
+      # to the same network as all the subnetworks.
+  "producerAcceptLists": [ # Projects or service class ids that are allowed to connect to this network
+      # attachment. The project can be specified using its id or number. Service
+      # class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "producerRejectLists": [ # Projects or service class ids that are not allowed to connect to this
+      # network attachment. The project can be specified using its id or number.
+      # Service class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the network attachment resides.
+      # This field applies only to the region 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 for this resource's resource id.
+  "subnetworks": [ # An array of URLs where each entry is the URL of a subnet
+      # provided by the service consumer to use for
+      # endpoints in the producers that connect to this network attachment.
+    "A String",
+  ],
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a NetworkAttachment in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # NetworkAttachments
+    # A network attachment resource ...
+  "connectionEndpoints": [ # Output only. [Output Only] An array of connections for all the producers connected
+      # to this network attachment.
+    { # [Output Only] A connection connected to this network attachment.
+      "ipAddress": "A String", # The IPv4 address assigned to the producer instance network interface.
+          # This value will be a range in case of Serverless.
+      "ipv6Address": "A String", # The IPv6 address assigned to the producer instance network interface.
+          # This is only assigned when the stack types of both the instance network
+          # interface and the consumer subnet are IPv4_IPv6.
+      "projectIdOrNum": "A String", # The project id or number of the interface to which the IP was assigned.
+      "secondaryIpCidrRanges": [ # Alias IP ranges from the same subnetwork.
+        "A String",
+      ],
+      "serviceClassId": "A String", # The service class id of the producer service to which the IP was
+          # assigned.
+      "status": "A String", # The status of a connected endpoint to this network attachment.
+      "subnetwork": "A String", # The subnetwork used to assign the IP to the producer
+          # instance network interface.
+      "subnetworkCidrRange": "A String", # Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal
+          # IP was allocated from.
+    },
+  ],
+  "connectionPreference": "A String",
+  "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. An up-to-date
+      # fingerprint must be provided in order to patch.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#networkAttachment", # Output only. [Output Only] Type of the resource.
+  "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.
+  "network": "A String", # Output only. [Output Only] The URL of the network which the Network Attachment
+      # belongs to. Practically it is inferred by fetching the network of the first
+      # subnetwork associated. Because it is required that all the subnetworks must
+      # be from the same network, it is assured that the Network Attachment belongs
+      # to the same network as all the subnetworks.
+  "producerAcceptLists": [ # Projects or service class ids that are allowed to connect to this network
+      # attachment. The project can be specified using its id or number. Service
+      # class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "producerRejectLists": [ # Projects or service class ids that are not allowed to connect to this
+      # network attachment. The project can be specified using its id or number.
+      # Service class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the network attachment resides.
+      # This field applies only to the region 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 for this resource's resource id.
+  "subnetworks": [ # An array of URLs where each entry is the URL of a subnet
+      # provided by the service consumer to use for
+      # endpoints in the producers that connect to this network attachment.
+    "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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the NetworkAttachments for a project in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of 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.
+  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 NetworkAttachment resources.
+    { # NetworkAttachments
+        # A network attachment resource ...
+      "connectionEndpoints": [ # Output only. [Output Only] An array of connections for all the producers connected
+          # to this network attachment.
+        { # [Output Only] A connection connected to this network attachment.
+          "ipAddress": "A String", # The IPv4 address assigned to the producer instance network interface.
+              # This value will be a range in case of Serverless.
+          "ipv6Address": "A String", # The IPv6 address assigned to the producer instance network interface.
+              # This is only assigned when the stack types of both the instance network
+              # interface and the consumer subnet are IPv4_IPv6.
+          "projectIdOrNum": "A String", # The project id or number of the interface to which the IP was assigned.
+          "secondaryIpCidrRanges": [ # Alias IP ranges from the same subnetwork.
+            "A String",
+          ],
+          "serviceClassId": "A String", # The service class id of the producer service to which the IP was
+              # assigned.
+          "status": "A String", # The status of a connected endpoint to this network attachment.
+          "subnetwork": "A String", # The subnetwork used to assign the IP to the producer
+              # instance network interface.
+          "subnetworkCidrRange": "A String", # Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal
+              # IP was allocated from.
+        },
+      ],
+      "connectionPreference": "A String",
+      "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. An up-to-date
+          # fingerprint must be provided in order to patch.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "kind": "compute#networkAttachment", # Output only. [Output Only] Type of the resource.
+      "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.
+      "network": "A String", # Output only. [Output Only] The URL of the network which the Network Attachment
+          # belongs to. Practically it is inferred by fetching the network of the first
+          # subnetwork associated. Because it is required that all the subnetworks must
+          # be from the same network, it is assured that the Network Attachment belongs
+          # to the same network as all the subnetworks.
+      "producerAcceptLists": [ # Projects or service class ids that are allowed to connect to this network
+          # attachment. The project can be specified using its id or number. Service
+          # class id can be specified as "serviceclasses/{service_class_id}".
+        "A String",
+      ],
+      "producerRejectLists": [ # Projects or service class ids that are not allowed to connect to this
+          # network attachment. The project can be specified using its id or number.
+          # Service class id can be specified as "serviceclasses/{service_class_id}".
+        "A String",
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the network attachment resides.
+          # This field applies only to the region 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 for this resource's resource id.
+      "subnetworks": [ # An array of URLs where each entry is the URL of a subnet
+          # provided by the service consumer to use for
+          # endpoints in the producers that connect to this network attachment.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#networkAttachmentList",
+  "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, networkAttachment, body=None, requestId=None, x__xgafv=None) + 
Patches the specified NetworkAttachment resource with the data included in
+the request. This method supports PATCH
+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)
+  networkAttachment: string, Name of the NetworkAttachment resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # NetworkAttachments
+    # A network attachment resource ...
+  "connectionEndpoints": [ # Output only. [Output Only] An array of connections for all the producers connected
+      # to this network attachment.
+    { # [Output Only] A connection connected to this network attachment.
+      "ipAddress": "A String", # The IPv4 address assigned to the producer instance network interface.
+          # This value will be a range in case of Serverless.
+      "ipv6Address": "A String", # The IPv6 address assigned to the producer instance network interface.
+          # This is only assigned when the stack types of both the instance network
+          # interface and the consumer subnet are IPv4_IPv6.
+      "projectIdOrNum": "A String", # The project id or number of the interface to which the IP was assigned.
+      "secondaryIpCidrRanges": [ # Alias IP ranges from the same subnetwork.
+        "A String",
+      ],
+      "serviceClassId": "A String", # The service class id of the producer service to which the IP was
+          # assigned.
+      "status": "A String", # The status of a connected endpoint to this network attachment.
+      "subnetwork": "A String", # The subnetwork used to assign the IP to the producer
+          # instance network interface.
+      "subnetworkCidrRange": "A String", # Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal
+          # IP was allocated from.
+    },
+  ],
+  "connectionPreference": "A String",
+  "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. An up-to-date
+      # fingerprint must be provided in order to patch.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#networkAttachment", # Output only. [Output Only] Type of the resource.
+  "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.
+  "network": "A String", # Output only. [Output Only] The URL of the network which the Network Attachment
+      # belongs to. Practically it is inferred by fetching the network of the first
+      # subnetwork associated. Because it is required that all the subnetworks must
+      # be from the same network, it is assured that the Network Attachment belongs
+      # to the same network as all the subnetworks.
+  "producerAcceptLists": [ # Projects or service class ids that are allowed to connect to this network
+      # attachment. The project can be specified using its id or number. Service
+      # class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "producerRejectLists": [ # Projects or service class ids that are not allowed to connect to this
+      # network attachment. The project can be specified using its id or number.
+      # Service class id can be specified as "serviceclasses/{service_class_id}".
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the network attachment resides.
+      # This field applies only to the region 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 for this resource's resource id.
+  "subnetworks": [ # An array of URLs where each entry is the URL of a subnet
+      # provided by the service consumer to use for
+      # endpoints in the producers that connect to this network attachment.
+    "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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.networkEdgeSecurityServices.html b/docs/dyn/compute_preview.networkEdgeSecurityServices.html new file mode 100644 index 0000000000..1e651dc029 --- /dev/null +++ b/docs/dyn/compute_preview.networkEdgeSecurityServices.html @@ -0,0 +1,1365 @@ + + + +

Compute Engine API . networkEdgeSecurityServices

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all NetworkEdgeSecurityService resources available to

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, networkEdgeSecurityService, requestId=None, x__xgafv=None)

+

Deletes the specified service.

+

+ get(project, region, networkEdgeSecurityService, x__xgafv=None)

+

Gets a specified NetworkEdgeSecurityService.

+

+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates a new service in the specified project using the data included in

+

+ patch(project, region, networkEdgeSecurityService, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all NetworkEdgeSecurityService resources available to
+the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NetworkEdgeSecurityServicesScopedList resources.
+    "a_key": { # Name of the scope containing this set of security policies.
+      "networkEdgeSecurityServices": [ # A list of NetworkEdgeSecurityServices contained in this scope.
+        { # Represents a Google Cloud Armor network edge security service resource.
+          "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be
+              # provided in order to update the NetworkEdgeSecurityService,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a NetworkEdgeSecurityService.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#networkEdgeSecurityService", # Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for
+              # NetworkEdgeSecurityServices
+          "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.
+          "region": "A String", # Output only. [Output Only] URL of the region where the resource resides. You must
+              # specify this field as part of the HTTP request URL. It is not settable as a
+              # field in the request body.
+          "securityPolicy": "A String", # The resource URL for the network edge security service associated with this
+              # network edge security service.
+          "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 with the resource id.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # security 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#networkEdgeSecurityServiceAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of
+      # Network Edge Security Services.
+  "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, networkEdgeSecurityService, requestId=None, x__xgafv=None) + 
Deletes the specified service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  networkEdgeSecurityService: string, Name of the network edge security service 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, networkEdgeSecurityService, x__xgafv=None) + 
Gets a specified NetworkEdgeSecurityService.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  networkEdgeSecurityService: string, Name of the network edge security service to get. (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 Google Cloud Armor network edge security service resource.
+  "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be
+      # provided in order to update the NetworkEdgeSecurityService,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a NetworkEdgeSecurityService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#networkEdgeSecurityService", # Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for
+      # NetworkEdgeSecurityServices
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource resides. You must
+      # specify this field as part of the HTTP request URL. It is not settable as a
+      # field in the request body.
+  "securityPolicy": "A String", # The resource URL for the network edge security service associated with this
+      # network edge security service.
+  "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 with the resource id.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates a new service in the specified project using the data 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 Google Cloud Armor network edge security service resource.
+  "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be
+      # provided in order to update the NetworkEdgeSecurityService,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a NetworkEdgeSecurityService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#networkEdgeSecurityService", # Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for
+      # NetworkEdgeSecurityServices
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource resides. You must
+      # specify this field as part of the HTTP request URL. It is not settable as a
+      # field in the request body.
+  "securityPolicy": "A String", # The resource URL for the network edge security service associated with this
+      # network edge security service.
+  "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 with the resource id.
+}
+
+  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).
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patch(project, region, networkEdgeSecurityService, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  networkEdgeSecurityService: string, Name of the network edge security service to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Google Cloud Armor network edge security service resource.
+  "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be
+      # provided in order to update the NetworkEdgeSecurityService,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a NetworkEdgeSecurityService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#networkEdgeSecurityService", # Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for
+      # NetworkEdgeSecurityServices
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the resource resides. You must
+      # specify this field as part of the HTTP request URL. It is not settable as a
+      # field in the request body.
+  "securityPolicy": "A String", # The resource URL for the network edge security service associated with this
+      # network edge security service.
+  "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 with the resource id.
+}
+
+  paths: string, A parameter (repeated)
+  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).
+  updateMask: string, Indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.networkEndpointGroups.html b/docs/dyn/compute_preview.networkEndpointGroups.html new file mode 100644 index 0000000000..0873cdfb64 --- /dev/null +++ b/docs/dyn/compute_preview.networkEndpointGroups.html @@ -0,0 +1,2717 @@ + + + +

Compute Engine API . networkEndpointGroups

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of network endpoint groups and sorts them by zone.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ attachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Attach a list of network endpoints to the specified network endpoint group.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, networkEndpointGroup, requestId=None, x__xgafv=None)

+

Deletes the specified network endpoint group. The network endpoints in the

+

+ detachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Detach a list of network endpoints from the specified network endpoint

+

+ get(project, zone, networkEndpointGroup, x__xgafv=None)

+

Returns the specified network endpoint group.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a network endpoint group in the specified project using the

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of network endpoint groups that are located in the

+

+ listNetworkEndpoints(project, zone, networkEndpointGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the network endpoints in the specified network endpoint group.

+

+ listNetworkEndpoints_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ testIamPermissions(project, zone, 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of network endpoint groups and sorts them by zone.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NetworkEndpointGroupsScopedList resources.
+    "a_key": { # The name of the scope that contains this set of network endpoint groups.
+      "networkEndpointGroups": [ # Output only. [Output Only] The list ofnetwork
+          # endpoint groups that are contained in this scope.
+        { # Represents a collection of network endpoints.
+            #
+            # A network endpoint group (NEG) defines how a set of endpoints should be
+            # reached, whether they are reachable, and where they are located.
+            # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+            #
+            # Note: Use the following APIs to manage network endpoint groups:
+            #
+            #    -
+            #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+            #    NEGs): zonal
+            #    API
+            #    -
+            #    To manage NEGs with regional scope (such as regional internet NEGs,
+            #    serverless NEGs, Private Service Connect NEGs): regional
+            #    API
+            #    -
+            #    To manage NEGs with global scope (such as global internet NEGs):global
+            #    API
+          "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+            "a_key": "A String",
+          },
+          "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+              # The service is optional, may be provided explicitly or in the
+              # URL mask. The version is optional and can only be provided
+              # explicitly or in the URL mask when service is present.
+              #
+              # Note: App Engine service must be in the same project and located in the
+              # same region as the Serverless NEG.
+            "service": "A String", # Optional serving service.
+                #
+                # The service name is case-sensitive and must be 1-63
+                # characters long.
+                #
+                # Example value: default, my-service.
+            "urlMask": "A String", # An URL
+                # mask is one of the main components of the Cloud Function.
+                #
+                # A template to parse service and version fields
+                # from a request URL. URL mask allows for routing to multiple App Engine
+                # services without having to create multiple Network Endpoint Groups and
+                # backend services.
+                #
+                # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+                # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+                # The URL mask will parse them to { service = "foo1", version = "v1"
+                # } and { service = "foo1", version = "v2" }
+                # respectively.
+            "version": "A String", # Optional serving version.
+                #
+                # The version name is case-sensitive and must be 1-100
+                # characters long.
+                #
+                # Example value: v1, v2.
+          },
+          "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+              # The function must be provided explicitly or in the URL mask.
+              #
+              # Note: Cloud Function must be in the same project and located in the same
+              # region as the Serverless NEG.
+            "function": "A String", # A user-defined name of the Cloud Function.
+                #
+                # The function name is case-sensitive and must be 1-63
+                # characters long.
+                #
+                # Example value: func1.
+            "urlMask": "A String", # An URL
+                # mask is one of the main components of the Cloud Function.
+                #
+                # A template to parse function field from a request URL. URL
+                # mask allows for routing to multiple Cloud Functions without having to
+                # create multiple Network Endpoint Groups and backend services.
+                #
+                # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+                # Serverless NEG with URL mask /<function>. The URL
+                # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+          },
+          "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+              # The service must be provided explicitly or in the URL mask.
+              # The tag is optional, may be provided explicitly or in the URL
+              # mask.
+              #
+              # Note: Cloud Run service must be in the same project and located in the same
+              # region as the Serverless NEG.
+            "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+                #
+                # The service must be 1-63 characters long, and comply withRFC1035.
+                #
+                # Example value: "run-service".
+            "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+                # fine-grained traffic routing information.
+                #
+                # The tag must be 1-63 characters long, and comply withRFC1035.
+                #
+                # Example value: "revision-0010".
+            "urlMask": "A String", # An URL
+                # mask is one of the main components of the Cloud Function.
+                #
+                # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+                # routing to multiple Run services without having to create multiple
+                # network endpoint groups and backend services.
+                #
+                # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+                # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+                # parse them to { service="bar1", tag="foo1" } and {
+                # service="bar2", tag="foo2" } respectively.
+          },
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "defaultPort": 42, # The default port used if the port number is not specified in the network
+              # endpoint.
+              #
+              # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+              # field must not be specified.
+          "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+          "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+              # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+              # if this field is not specified, a default network will be used.
+              # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+              # global NEGs.
+              # For all other network endpoint types, this field is required.
+          "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+          "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+              # type PRIVATE_SERVICE_CONNECT.
+            "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+                # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+                # L7 PSC-XLB.
+            "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+                # the PSC Producer side; should only be used for the
+                # PRIVATE_SERVICE_CONNECT NEG type
+            "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+                # Consumer.
+            "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+          },
+          "pscTargetService": "A String", # The target service url used to set up private service connection to
+              # a Google API or a PSC Producer Service Attachment.
+              # An example value is: asia-northeast3-cloudkms.googleapis.com.
+              #
+              # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+          "region": "A String", # Output only. [Output Only] The URL of theregion
+              # where the network endpoint group is located.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+          "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+              # belong.
+          "zone": "A String", # Output only. [Output Only] The URL of thezone
+              # where the network endpoint group is located.
+        },
+      ],
+      "warning": { # Output only. [Output Only] An informational warning that replaces the list of network
+          # endpoint groups 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#networkEndpointGroupAggregatedList", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated
+      # lists of network endpoint groups.
+  "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.
+
+
+ +
+ attachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Attach a list of network endpoints to the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group where you are attaching network
+endpoints to. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be attached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, networkEndpointGroup, requestId=None, x__xgafv=None) + 
Deletes the specified network endpoint group. The network endpoints in the
+NEG and the VM instances they belong to are not terminated when the NEG is
+deleted. Note that the NEG cannot be deleted if there are backend services
+referencing it.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group to delete. It should comply with
+RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ detachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Detach a list of network endpoints from the specified network endpoint
+group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group where you are removing network
+endpoints. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be detached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, networkEndpointGroup, x__xgafv=None) + 
Returns the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group. It should comply with RFC1035. (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 collection of network endpoints.
+    #
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    #
+    # Note: Use the following APIs to manage network endpoint groups:
+    #
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      #
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      #
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a network endpoint group in the specified project using the
+parameters that are included in the request.
+
+Note: Use the following APIs to manage network endpoint groups:
+   
+   - 
+   To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+   NEGs): zonal
+   API
+   - 
+   To manage NEGs with regional scope (such as regional internet NEGs,
+   serverless NEGs, Private Service Connect NEGs): regional
+   API
+   - 
+   To manage NEGs with global scope (such as global internet NEGs):global
+   API
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+you want to create the network endpoint group. It should comply with
+RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a collection of network endpoints.
+    # 
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    # 
+    # Note: Use the following APIs to manage network endpoint groups:
+    # 
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      # 
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      # 
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of network endpoint groups that are located in the
+specified project and zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone
+where the network endpoint group is located. It should comply with 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.
+  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 NetworkEndpointGroup resources.
+    { # Represents a collection of network endpoints.
+        #
+        # A network endpoint group (NEG) defines how a set of endpoints should be
+        # reached, whether they are reachable, and where they are located.
+        # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+        #
+        # Note: Use the following APIs to manage network endpoint groups:
+        #
+        #    -
+        #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+        #    NEGs): zonal
+        #    API
+        #    -
+        #    To manage NEGs with regional scope (such as regional internet NEGs,
+        #    serverless NEGs, Private Service Connect NEGs): regional
+        #    API
+        #    -
+        #    To manage NEGs with global scope (such as global internet NEGs):global
+        #    API
+      "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+        "a_key": "A String",
+      },
+      "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service is optional, may be provided explicitly or in the
+          # URL mask. The version is optional and can only be provided
+          # explicitly or in the URL mask when service is present.
+          #
+          # Note: App Engine service must be in the same project and located in the
+          # same region as the Serverless NEG.
+        "service": "A String", # Optional serving service.
+            #
+            # The service name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: default, my-service.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse service and version fields
+            # from a request URL. URL mask allows for routing to multiple App Engine
+            # services without having to create multiple Network Endpoint Groups and
+            # backend services.
+            #
+            # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+            # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+            # The URL mask will parse them to { service = "foo1", version = "v1"
+            # } and { service = "foo1", version = "v2" }
+            # respectively.
+        "version": "A String", # Optional serving version.
+            #
+            # The version name is case-sensitive and must be 1-100
+            # characters long.
+            #
+            # Example value: v1, v2.
+      },
+      "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The function must be provided explicitly or in the URL mask.
+          #
+          # Note: Cloud Function must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "function": "A String", # A user-defined name of the Cloud Function.
+            #
+            # The function name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: func1.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse function field from a request URL. URL
+            # mask allows for routing to multiple Cloud Functions without having to
+            # create multiple Network Endpoint Groups and backend services.
+            #
+            # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+            # Serverless NEG with URL mask /<function>. The URL
+            # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+      },
+      "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service must be provided explicitly or in the URL mask.
+          # The tag is optional, may be provided explicitly or in the URL
+          # mask.
+          #
+          # Note: Cloud Run service must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+            #
+            # The service must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "run-service".
+        "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+            # fine-grained traffic routing information.
+            #
+            # The tag must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "revision-0010".
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+            # routing to multiple Run services without having to create multiple
+            # network endpoint groups and backend services.
+            #
+            # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+            # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+            # parse them to { service="bar1", tag="foo1" } and {
+            # service="bar2", tag="foo2" } respectively.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultPort": 42, # The default port used if the port number is not specified in the network
+          # endpoint.
+          #
+          # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+          # field must not be specified.
+      "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+      "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+          # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+          # if this field is not specified, a default network will be used.
+          # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+          # global NEGs.
+          # For all other network endpoint types, this field is required.
+      "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+      "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+          # type PRIVATE_SERVICE_CONNECT.
+        "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+            # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+            # L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+            # the PSC Producer side; should only be used for the
+            # PRIVATE_SERVICE_CONNECT NEG type
+        "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+            # Consumer.
+        "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+      },
+      "pscTargetService": "A String", # The target service url used to set up private service connection to
+          # a Google API or a PSC Producer Service Attachment.
+          # An example value is: asia-northeast3-cloudkms.googleapis.com.
+          #
+          # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the network endpoint group is located.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+      "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+          # belong.
+      "zone": "A String", # Output only. [Output Only] The URL of thezone
+          # where the network endpoint group is located.
+    },
+  ],
+  "kind": "compute#networkEndpointGroupList", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group
+      # lists.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints(project, zone, networkEndpointGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the network endpoints in the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group from which you want to generate a
+list of included network endpoints. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "healthStatus": "A String", # Optional query parameter for showing the health status of each network
+      # endpoint. Valid options are SKIP or SHOW. If you
+      # don't specify this parameter, the health status of network endpoints will
+      # not be provided.
+}
+
+  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.
+  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 NetworkEndpointWithHealthStatus resources.
+    {
+      "healths": [ # Output only. [Output only] The health status of network endpoint.
+          #
+          # Optional. Displayed only if the network endpoint has centralized health
+          # checking configured.
+        {
+          "backendService": { # URL of the backend service associated with the health state of the network
+              # endpoint.
+            "backendService": "A String",
+          },
+          "forwardingRule": { # URL of the forwarding rule associated with the health state of the network
+              # endpoint.
+            "forwardingRule": "A String",
+          },
+          "healthCheck": { # A full or valid partial URL to a health check. For example, the following are # URL of the health check associated with the health state of the network
+              # endpoint.
+              # valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+              #    - projects/project-id/global/httpHealthChecks/health-check
+              #    - global/httpHealthChecks/health-check
+            "healthCheck": "A String",
+          },
+          "healthCheckService": { # A full or valid partial URL to a health check service. For example, the # URL of the health check service associated with the health state of the
+              # network endpoint.
+              # following are valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - regions/us-west1/healthCheckServices/health-check-service
+            "healthCheckService": "A String",
+          },
+          "healthState": "A String", # Health state of the network endpoint determined based on the health checks
+              # configured.
+          "ipv6HealthState": "A String", # Health state of the ipv6 network endpoint determined based on the health
+              # checks configured.
+        },
+      ],
+      "networkEndpoint": { # The network endpoint. # Output only. [Output only] The network endpoint.
+        "annotations": { # Optional metadata defined as annotations on the network endpoint.
+          "a_key": "A String",
+        },
+        "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+            #
+            # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+        "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+            # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+        "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+            # Optional, the field presence depends on the network endpoint type. The
+            # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+            #
+            # The instance must be in the same zone of network endpoint group (for zonal
+            # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+            # If the ipAddress is specified, it must belongs to the VM
+            # instance.
+            #
+            # The name must be 1-63 characters long, and comply withRFC1035
+            # or be a valid URL pointing to an existing instance.
+        "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+            # VM in Compute Engine (either the primary IP or as part of an aliased IP
+            # range). If the IP address is not specified, then the primary IP address for
+            # the VM instance in the network that the network endpoint group belongs to
+            # will be used.
+            #
+            # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+            # address of the attached VM instance that matches the subnetwork of the NEG.
+            # The primary internal IP address from any NIC of a multi-NIC VM instance can
+            # be added to a NEG as long as it matches the NEG subnetwork.
+        "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+        "port": 42, # Optional port number of network endpoint. If not specified, the
+            # defaultPort for the network endpoint group will be used.
+            #
+            # This field can not be set for network endpoints of typeGCE_VM_IP.
+      },
+    },
+  ],
+  "kind": "compute#networkEndpointGroupsListNetworkEndpoints", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list
+      # of network endpoints in the specified network endpoint group.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints_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.
+
+
+ +
+ testIamPermissions(project, zone, 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)
+  zone: string, The name of the zone 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_preview.networkFirewallPolicies.html b/docs/dyn/compute_preview.networkFirewallPolicies.html new file mode 100644 index 0000000000..bcac335bd0 --- /dev/null +++ b/docs/dyn/compute_preview.networkFirewallPolicies.html @@ -0,0 +1,8916 @@ + + + +

Compute Engine API . networkFirewallPolicies

+

Instance Methods

+

+ addAssociation(project, firewallPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None)

+

Inserts an association for the specified firewall policy.

+

+ addPacketMirroringRule(project, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None)

+

Inserts a packet mirroring rule into a firewall policy.

+

+ addRule(project, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None)

+

Inserts a rule into a firewall policy.

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of network firewall policies, listing network

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ cloneRules(project, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

+

Copies rules to the specified firewall policy.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, firewallPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified policy.

+

+ get(project, firewallPolicy, x__xgafv=None)

+

Returns the specified network firewall policy.

+

+ getAssociation(project, firewallPolicy, name=None, x__xgafv=None)

+

Gets an association with the specified name.

+

+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getPacketMirroringRule(project, firewallPolicy, priority=None, x__xgafv=None)

+

Gets a packet mirroring rule of the specified priority.

+

+ getRule(project, firewallPolicy, priority=None, x__xgafv=None)

+

Gets a rule of the specified priority.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a new policy in the specified project using the data included in

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all the policies that have been configured for the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, firewallPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request.

+

+ patchPacketMirroringRule(project, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None)

+

Patches a packet mirroring rule of the specified priority.

+

+ patchRule(project, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None)

+

Patches a rule of the specified priority.

+

+ removeAssociation(project, firewallPolicy, name=None, requestId=None, x__xgafv=None)

+

Removes an association for the specified firewall policy.

+

+ removePacketMirroringRule(project, firewallPolicy, priority=None, requestId=None, x__xgafv=None)

+

Deletes a packet mirroring rule of the specified priority.

+

+ removeRule(project, firewallPolicy, priority=None, requestId=None, x__xgafv=None)

+

Deletes a rule of the specified priority.

+

+ 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

+
+ addAssociation(project, firewallPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None) + 
Inserts an association for the specified firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+  replaceExistingAssociation: boolean, Indicates whether or not to replace it if an association of the attachment
+already exists. This is false by default, in which case an error will be
+returned if an association already exists.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addPacketMirroringRule(project, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None) + 
Inserts a packet mirroring rule into a firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  maxPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  minPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addRule(project, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None) + 
Inserts a rule into a firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  maxPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  minPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of network firewall policies, listing network
+firewall policies from all applicable scopes (global and regional) and
+grouping the results per scope.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of FirewallPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of addresses.
+      "firewallPolicies": [ # A list of firewall policies contained in this scope.
+        { # Represents a Firewall Policy resource.
+          "associations": [ # A list of associations that belong to this firewall policy.
+            {
+              "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+              "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+                  # of the firewall policy of the association.
+              "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+              "name": "A String", # The name for an association.
+              "priority": 42, # An integer indicating the priority of an association. The priority
+                  # must be a positive value between 1 and 2147483647.
+                  # Firewall Policies are evaluated from highest to lowest priority where 1
+                  # is the highest priority and 2147483647 is the lowest priority.
+                  # The default value is `1000`. If two associations have the same priority
+                  # then lexicographical order on association names is applied.
+              "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+            },
+          ],
+          "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.
+          "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+              # Organization firewall policy. The name should be unique in the organization
+              # in which the firewall policy is created.
+              # This field is not applicable to network firewall policies.
+              # This name must be set on creation and cannot be changed.
+              # The name must be 1-63 characters long, and comply
+              # with RFC1035. 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.
+          "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # firewall policy.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+          "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+              # [Output Only] numeric ID allocated by Google Cloud which uniquely
+              # identifies the Organization Firewall Policy.
+          "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+            { # Represents a rule that describes one or more match conditions along with
+                # the action to be taken when traffic matches this condition (allow or deny).
+              "action": "A String", # The Action to perform when the client connection triggers the rule.
+                  # Valid actions for firewall rules are: "allow", "deny",
+                  # "apply_security_profile_group" and "goto_next" (
+                  # "apply_security_profile_group" can be specified only for global
+                  # network firewall policies or hierarchical firewall policies).
+                  # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+                  # and "goto_next".
+              "description": "A String", # An optional description for this resource.
+              "direction": "A String", # The direction in which this rule applies.
+              "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+                  # the firewall policy rule is not enforced and traffic behaves as if it did
+                  # not exist. If this is unspecified, the firewall policy rule will be
+                  # enabled.
+              "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+                  # enabled, logs will be exported to the configured export destination in
+                  # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+                  # cannot enable logging on "goto_next" rules.
+              "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+              "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+                  # If it evaluates to true, the corresponding 'action' is enforced.
+                  # Exactly one field must be specified.
+                "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                    # Maximum number of destination address groups is 10.
+                  "A String",
+                ],
+                "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                    # traffic destination.
+                    # Maximum number of destination fqdn allowed is 100.
+                  "A String",
+                ],
+                "destIpRanges": [ # CIDR IP address range.
+                    # Maximum number of destination CIDR IP ranges allowed is 5000.
+                  "A String",
+                ],
+                "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - NON_INTERNET
+                "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - NON_INTERNET
+                "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                    # of traffic. Should be specified as 2 letter country code defined as per
+                    # ISO 3166 alpha-2 country codes. ex."US"
+                    # Maximum number of dest region codes allowed is 5000.
+                  "A String",
+                ],
+                "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                    # The IPs in these lists will be matched against traffic destination.
+                  "A String",
+                ],
+                "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+                  {
+                    "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                        # required when creating a firewall rule. This value can either be
+                        # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                        # protocol number.
+                    "ports": [ # An optional list of ports to which this rule applies. This field is
+                        # only applicable for UDP or TCP protocol. Each entry must be either
+                        # an integer or a range. If not specified, this rule applies to
+                        # connections through any port.
+                        #
+                        # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                      "A String",
+                    ],
+                  },
+                ],
+                "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                    # Maximum number of source address groups is 10.
+                  "A String",
+                ],
+                "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                    # traffic source.
+                    # Maximum number of source fqdn allowed is 100.
+                  "A String",
+                ],
+                "srcIpRanges": [ # CIDR IP address range.
+                    # Maximum number of source CIDR IP ranges allowed is 5000.
+                  "A String",
+                ],
+                "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - INTRA_VPC
+                    #      - NON_INTERNET
+                    #      - VPC_NETWORKS
+                "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - INTRA_VPC
+                    #      - NON_INTERNET
+                    #      - VPC_NETWORKS
+                "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+                  "A String",
+                ],
+                "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                    # of traffic. Should be specified as 2 letter country code defined as per
+                    # ISO 3166 alpha-2 country codes. ex."US"
+                    # Maximum number of source region codes allowed is 5000.
+                  "A String",
+                ],
+                "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                    # of the traffic.
+                    # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                    # and there is no srcIpRange, this rule will be ignored.
+                    # Maximum number of source tag values allowed is 256.
+                  {
+                    "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                    "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                        # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                        # or its network is deleted.
+                  },
+                ],
+                "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                    # The IPs in these lists will be matched against traffic source.
+                  "A String",
+                ],
+              },
+              "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+                  # must be a positive value between 0 and 2147483647.
+                  # Rules are evaluated from highest to lowest priority where 0 is the
+                  # highest priority and 2147483647 is the lowest priority.
+              "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+                  # and can be updated.
+              "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+                  # rule.
+              "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+                  # Example:
+                  # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+                  # Must be specified if action is one of 'apply_security_profile_group' or
+                  # 'mirror'. Cannot be specified for other actions. Can be specified only
+                  # for global network firewall policies or hierarchical firewall policies.
+              "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+                  # This field allows you to control which load balancers get this rule.
+                  # For example, the following are valid values:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+                  #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+                  #      - projects/project/global/
+                  #      forwardingRules/forwardingRule
+                  #      - projects/project/regions/region/forwardingRules/
+                  #      forwardingRule
+                "A String",
+              ],
+              "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+                  # allows you to control which network's VMs get this rule.  If this field
+                  # is left blank, all VMs within the organization will receive the rule.
+                "A String",
+              ],
+              "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+                  # applies to. If targetSecureTag are specified, then the
+                  # firewall rule applies only to instances in the VPC network that have one
+                  # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+                  # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+                  # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+                  # to all instances on the specified network.
+                  # Maximum number of target label tags allowed is 256.
+                {
+                  "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                  "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                      # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                      # or its network is deleted.
+                },
+              ],
+              "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+                  # applied with this rule.
+                "A String",
+              ],
+              "targetType": "A String", # Target types of the firewall policy rule.
+                  # Default value is INSTANCES.
+              "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+                  # Can be set only if action = 'apply_security_profile_group' and cannot
+                  # be set for other actions.
+            },
+          ],
+          "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+              # This field is not applicable to network firewall policies.
+          "policyType": "A String", # The type of the firewall policy. This field can be one of
+              # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+              #
+              # Note: if not specified then VPC_POLICY will be used.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+              # This field is not applicable to global firewall policies.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+              # policy can not exceed a set number of tuples.
+          "rules": [ # A list of rules that belong to this policy.
+              # There must always be a default rule (rule with priority 2147483647 and
+              # match "*"). If no rules are provided when creating a firewall policy, a
+              # default rule with action "allow" will be added.
+            { # Represents a rule that describes one or more match conditions along with
+                # the action to be taken when traffic matches this condition (allow or deny).
+              "action": "A String", # The Action to perform when the client connection triggers the rule.
+                  # Valid actions for firewall rules are: "allow", "deny",
+                  # "apply_security_profile_group" and "goto_next" (
+                  # "apply_security_profile_group" can be specified only for global
+                  # network firewall policies or hierarchical firewall policies).
+                  # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+                  # and "goto_next".
+              "description": "A String", # An optional description for this resource.
+              "direction": "A String", # The direction in which this rule applies.
+              "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+                  # the firewall policy rule is not enforced and traffic behaves as if it did
+                  # not exist. If this is unspecified, the firewall policy rule will be
+                  # enabled.
+              "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+                  # enabled, logs will be exported to the configured export destination in
+                  # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+                  # cannot enable logging on "goto_next" rules.
+              "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+              "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+                  # If it evaluates to true, the corresponding 'action' is enforced.
+                  # Exactly one field must be specified.
+                "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                    # Maximum number of destination address groups is 10.
+                  "A String",
+                ],
+                "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                    # traffic destination.
+                    # Maximum number of destination fqdn allowed is 100.
+                  "A String",
+                ],
+                "destIpRanges": [ # CIDR IP address range.
+                    # Maximum number of destination CIDR IP ranges allowed is 5000.
+                  "A String",
+                ],
+                "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - NON_INTERNET
+                "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - NON_INTERNET
+                "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                    # of traffic. Should be specified as 2 letter country code defined as per
+                    # ISO 3166 alpha-2 country codes. ex."US"
+                    # Maximum number of dest region codes allowed is 5000.
+                  "A String",
+                ],
+                "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                    # The IPs in these lists will be matched against traffic destination.
+                  "A String",
+                ],
+                "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+                  {
+                    "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                        # required when creating a firewall rule. This value can either be
+                        # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                        # protocol number.
+                    "ports": [ # An optional list of ports to which this rule applies. This field is
+                        # only applicable for UDP or TCP protocol. Each entry must be either
+                        # an integer or a range. If not specified, this rule applies to
+                        # connections through any port.
+                        #
+                        # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                      "A String",
+                    ],
+                  },
+                ],
+                "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                    # Maximum number of source address groups is 10.
+                  "A String",
+                ],
+                "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                    # traffic source.
+                    # Maximum number of source fqdn allowed is 100.
+                  "A String",
+                ],
+                "srcIpRanges": [ # CIDR IP address range.
+                    # Maximum number of source CIDR IP ranges allowed is 5000.
+                  "A String",
+                ],
+                "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - INTRA_VPC
+                    #      - NON_INTERNET
+                    #      - VPC_NETWORKS
+                "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                    #
+                    #
+                    #      - UNSPECIFIED
+                    #      - INTERNET
+                    #      - INTRA_VPC
+                    #      - NON_INTERNET
+                    #      - VPC_NETWORKS
+                "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+                  "A String",
+                ],
+                "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                    # of traffic. Should be specified as 2 letter country code defined as per
+                    # ISO 3166 alpha-2 country codes. ex."US"
+                    # Maximum number of source region codes allowed is 5000.
+                  "A String",
+                ],
+                "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                    # of the traffic.
+                    # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                    # and there is no srcIpRange, this rule will be ignored.
+                    # Maximum number of source tag values allowed is 256.
+                  {
+                    "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                    "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                        # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                        # or its network is deleted.
+                  },
+                ],
+                "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                    # The IPs in these lists will be matched against traffic source.
+                  "A String",
+                ],
+              },
+              "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+                  # must be a positive value between 0 and 2147483647.
+                  # Rules are evaluated from highest to lowest priority where 0 is the
+                  # highest priority and 2147483647 is the lowest priority.
+              "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+                  # and can be updated.
+              "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+                  # rule.
+              "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+                  # Example:
+                  # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+                  # Must be specified if action is one of 'apply_security_profile_group' or
+                  # 'mirror'. Cannot be specified for other actions. Can be specified only
+                  # for global network firewall policies or hierarchical firewall policies.
+              "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+                  # This field allows you to control which load balancers get this rule.
+                  # For example, the following are valid values:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+                  #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+                  #      - projects/project/global/
+                  #      forwardingRules/forwardingRule
+                  #      - projects/project/regions/region/forwardingRules/
+                  #      forwardingRule
+                "A String",
+              ],
+              "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+                  # allows you to control which network's VMs get this rule.  If this field
+                  # is left blank, all VMs within the organization will receive the rule.
+                "A String",
+              ],
+              "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+                  # applies to. If targetSecureTag are specified, then the
+                  # firewall rule applies only to instances in the VPC network that have one
+                  # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+                  # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+                  # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+                  # to all instances on the specified network.
+                  # Maximum number of target label tags allowed is 256.
+                {
+                  "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                  "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                      # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                      # or its network is deleted.
+                },
+              ],
+              "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+                  # applied with this rule.
+                "A String",
+              ],
+              "targetType": "A String", # Target types of the firewall policy rule.
+                  # Default value is INSTANCES.
+              "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+                  # Can be set only if action = 'apply_security_profile_group' and cannot
+                  # be set for other actions.
+            },
+          ],
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+          "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+              # unique in the organization in which the firewall policy is created.
+              # This field is not applicable to network firewall policies.
+              # This name must be set on creation and cannot be changed. The name must be
+              # 1-63 characters long, and comply with RFC1035.
+              # 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.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of firewall 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#networkFirewallPolicyAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of
+      # network firewall 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. [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.
+
+
+ +
+ cloneRules(project, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None) + 
Copies rules to the specified firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (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).
+  sourceFirewallPolicy: string, The firewall policy from which to copy rules.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, firewallPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, firewallPolicy, x__xgafv=None) + 
Returns the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to get. (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 Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      #
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+ +
+ getAssociation(project, firewallPolicy, name=None, x__xgafv=None) + 
Gets an association with the specified name.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to which the queried association belongs. (required)
+  name: string, The name of the association to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+ +
+ 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).
+}
+
+ +
+ getPacketMirroringRule(project, firewallPolicy, priority=None, x__xgafv=None) + 
Gets a packet mirroring rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      #
+      #
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+ +
+ getRule(project, firewallPolicy, priority=None, x__xgafv=None) + 
Gets a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      #
+      #
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a new policy 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 Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all the policies that have been configured for 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.
+  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 FirewallPolicy resources.
+    { # Represents a Firewall Policy resource.
+      "associations": [ # A list of associations that belong to this firewall policy.
+        {
+          "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+          "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+              # of the firewall policy of the association.
+          "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+          "name": "A String", # The name for an association.
+          "priority": 42, # An integer indicating the priority of an association. The priority
+              # must be a positive value between 1 and 2147483647.
+              # Firewall Policies are evaluated from highest to lowest priority where 1
+              # is the highest priority and 2147483647 is the lowest priority.
+              # The default value is `1000`. If two associations have the same priority
+              # then lexicographical order on association names is applied.
+          "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+        },
+      ],
+      "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.
+      "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+          # Organization firewall policy. The name should be unique in the organization
+          # in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed.
+          # The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # firewall policy.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+      "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+          # [Output Only] numeric ID allocated by Google Cloud which uniquely
+          # identifies the Organization Firewall Policy.
+      "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+          # This field is not applicable to network firewall policies.
+      "policyType": "A String", # The type of the firewall policy. This field can be one of
+          # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+          #
+          # Note: if not specified then VPC_POLICY will be used.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+          # This field is not applicable to global firewall policies.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+          # policy can not exceed a set number of tuples.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule (rule with priority 2147483647 and
+          # match "*"). If no rules are provided when creating a firewall policy, a
+          # default rule with action "allow" will be added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+          # unique in the organization in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed. The name must be
+          # 1-63 characters long, and comply with RFC1035.
+          # 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.
+    },
+  ],
+  "kind": "compute#firewallPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies
+  "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.
+  "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, firewallPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchPacketMirroringRule(project, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None) + 
Patches a packet mirroring rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  priority: integer, The priority of the rule to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(project, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None) + 
Patches a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  priority: integer, The priority of the rule to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeAssociation(project, firewallPolicy, name=None, requestId=None, x__xgafv=None) + 
Removes an association for the specified firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  name: string, Name for the attachment that will be removed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removePacketMirroringRule(project, firewallPolicy, priority=None, requestId=None, x__xgafv=None) + 
Deletes a packet mirroring rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  priority: integer, The priority of the rule to remove from the firewall policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(project, firewallPolicy, priority=None, requestId=None, x__xgafv=None) + 
Deletes a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  priority: integer, The priority of the rule to remove from the firewall policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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_preview.networkProfiles.html b/docs/dyn/compute_preview.networkProfiles.html new file mode 100644 index 0000000000..77cfd2fe82 --- /dev/null +++ b/docs/dyn/compute_preview.networkProfiles.html @@ -0,0 +1,432 @@ + + + +

Compute Engine API . networkProfiles

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, networkProfile, x__xgafv=None)

+

Returns the specified network profile.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of network profiles available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, networkProfile, x__xgafv=None) + 
Returns the specified network profile.
+
+Args:
+  project: string, Project ID for this request. (required)
+  networkProfile: string, Name of the network profile 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:
+
+    { # NetworkProfile represents a Google managed network profile resource.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Output only. [Output Only] An optional description of this resource.
+  "features": { # Output only. [Output Only] Features supported by the network.
+    "addressPurposes": [ # Specifies what address purposes are supported. If empty, all address
+        # purposes are supported.
+      "A String",
+    ],
+    "allowAddressCreation": "A String", # Specifies whether address creation is allowed.
+    "allowAliasIpRanges": "A String", # Specifies whether alias IP ranges (and secondary address ranges) are
+        # allowed.
+    "allowAutoModeSubnet": "A String", # Specifies whether auto mode subnet creation is allowed.
+    "allowClassDFirewalls": "A String", # Specifies whether firewalls for Class D address ranges are supported.
+    "allowCloudNat": "A String", # Specifies whether cloud NAT creation is allowed.
+    "allowCloudRouter": "A String", # Specifies whether cloud router creation is allowed.
+    "allowDefaultNicAttachment": "A String", # Specifies whether default NIC attachment is allowed.
+    "allowExternalIpAccess": "A String", # Specifies whether VMs are allowed to have external IP access on network
+        # interfaces connected to this VPC.
+    "allowFirewallPolicy": "A String", # Specifies whether firewall policy can be attached to the network.
+    "allowInterconnect": "A String", # Specifies whether Cloud Interconnect creation is allowed.
+    "allowIpForwarding": "A String", # Specifies whether IP forwarding is allowed.
+    "allowLoadBalancing": "A String", # Specifies whether cloud load balancing is allowed.
+    "allowMultiNicInSameNetwork": "A String", # Specifies whether multi-nic in the same network is allowed.
+    "allowMultiNicInSameSubnetwork": "A String", # Specifies whether multi-nic in the same subnetwork is allowed.
+    "allowMulticast": "A String", # Specifies whether multicast is allowed.
+    "allowNcc": "A String", # Specifies whether NCC is allowed.
+    "allowNetworkMigration": "A String", # Specifies whether VM network migration is allowed.
+    "allowPacketMirroring": "A String", # Specifies whether Packet Mirroring 1.0 is supported.
+    "allowPrivateGoogleAccess": "A String", # Specifies whether private Google access is allowed.
+    "allowPsc": "A String", # Specifies whether PSC creation is allowed.
+    "allowSameNetworkUnicast": "A String", # Specifies whether unicast within the same network is allowed.
+    "allowStaticRoutes": "A String", # Specifies whether static route creation is allowed.
+    "allowSubInterfaces": "A String", # Specifies whether sub interfaces are allowed.
+    "allowSubnetworkCreation": "A String", # Specifies whether subnetwork creation is allowed.
+    "allowVpcFirewallRules": "A String", # Specifies whether VPC firewall rules can be created under the network.
+    "allowVpcPeering": "A String", # Specifies whether VPC peering is allowed.
+    "allowVpn": "A String", # Specifies whether VPN creation is allowed.
+    "firewallPolicyTypes": [
+      "A String",
+    ],
+    "interfaceTypes": [ # If set, limits the interface types that the network supports. If
+        # empty, all interface types are supported.
+      "A String",
+    ],
+    "multicast": "A String", # Specifies which type of multicast is supported.
+    "predefinedNetworkInternalIpv6Range": "A String", # Specifies a predefined internal IPv6 range for the network.
+    "predefinedSubnetworkRanges": [ # Predefined subnetwork ranges for the network.
+      {
+        "ipv6Range": "A String", # The IPv6 range of the predefined subnetwork.
+        "namePrefix": "A String", # The naming prefix of the predefined subnetwork.
+      },
+    ],
+    "subnetPurposes": [ # Specifies which subnetwork purposes are supported.
+      "A String",
+    ],
+    "subnetStackTypes": [ # Specifies which subnetwork stack types are supported.
+      "A String",
+    ],
+    "subnetworkPurposes": [ # Output only. Specifies which subnetwork purposes are supported.
+      "A String",
+    ],
+    "subnetworkStackTypes": [ # Output only. Specifies which subnetwork stack types are supported.
+      "A String",
+    ],
+    "unicast": "A String", # Specifies which type of unicast is supported.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#networkProfile", # Output only. [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles.
+  "location": { # Output only. [Output Only] Location to which the network is restricted.
+    "name": "A String",
+    "scope": "A String",
+  },
+  "name": "A String", # Output only. [Output Only] Name of the resource.
+  "profileType": { # Output only. [Output Only] Type of the network profile.
+    "networkType": "A String",
+    "rdmaSubtype": "A String",
+    "ullSubtype": "A String",
+    "vpcSubtype": "A String",
+  },
+  "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 with the resource id.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of network profiles available to 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.
+  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 network profiles.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of NetworkProfile resources.
+    { # NetworkProfile represents a Google managed network profile resource.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # Output only. [Output Only] An optional description of this resource.
+      "features": { # Output only. [Output Only] Features supported by the network.
+        "addressPurposes": [ # Specifies what address purposes are supported. If empty, all address
+            # purposes are supported.
+          "A String",
+        ],
+        "allowAddressCreation": "A String", # Specifies whether address creation is allowed.
+        "allowAliasIpRanges": "A String", # Specifies whether alias IP ranges (and secondary address ranges) are
+            # allowed.
+        "allowAutoModeSubnet": "A String", # Specifies whether auto mode subnet creation is allowed.
+        "allowClassDFirewalls": "A String", # Specifies whether firewalls for Class D address ranges are supported.
+        "allowCloudNat": "A String", # Specifies whether cloud NAT creation is allowed.
+        "allowCloudRouter": "A String", # Specifies whether cloud router creation is allowed.
+        "allowDefaultNicAttachment": "A String", # Specifies whether default NIC attachment is allowed.
+        "allowExternalIpAccess": "A String", # Specifies whether VMs are allowed to have external IP access on network
+            # interfaces connected to this VPC.
+        "allowFirewallPolicy": "A String", # Specifies whether firewall policy can be attached to the network.
+        "allowInterconnect": "A String", # Specifies whether Cloud Interconnect creation is allowed.
+        "allowIpForwarding": "A String", # Specifies whether IP forwarding is allowed.
+        "allowLoadBalancing": "A String", # Specifies whether cloud load balancing is allowed.
+        "allowMultiNicInSameNetwork": "A String", # Specifies whether multi-nic in the same network is allowed.
+        "allowMultiNicInSameSubnetwork": "A String", # Specifies whether multi-nic in the same subnetwork is allowed.
+        "allowMulticast": "A String", # Specifies whether multicast is allowed.
+        "allowNcc": "A String", # Specifies whether NCC is allowed.
+        "allowNetworkMigration": "A String", # Specifies whether VM network migration is allowed.
+        "allowPacketMirroring": "A String", # Specifies whether Packet Mirroring 1.0 is supported.
+        "allowPrivateGoogleAccess": "A String", # Specifies whether private Google access is allowed.
+        "allowPsc": "A String", # Specifies whether PSC creation is allowed.
+        "allowSameNetworkUnicast": "A String", # Specifies whether unicast within the same network is allowed.
+        "allowStaticRoutes": "A String", # Specifies whether static route creation is allowed.
+        "allowSubInterfaces": "A String", # Specifies whether sub interfaces are allowed.
+        "allowSubnetworkCreation": "A String", # Specifies whether subnetwork creation is allowed.
+        "allowVpcFirewallRules": "A String", # Specifies whether VPC firewall rules can be created under the network.
+        "allowVpcPeering": "A String", # Specifies whether VPC peering is allowed.
+        "allowVpn": "A String", # Specifies whether VPN creation is allowed.
+        "firewallPolicyTypes": [
+          "A String",
+        ],
+        "interfaceTypes": [ # If set, limits the interface types that the network supports. If
+            # empty, all interface types are supported.
+          "A String",
+        ],
+        "multicast": "A String", # Specifies which type of multicast is supported.
+        "predefinedNetworkInternalIpv6Range": "A String", # Specifies a predefined internal IPv6 range for the network.
+        "predefinedSubnetworkRanges": [ # Predefined subnetwork ranges for the network.
+          {
+            "ipv6Range": "A String", # The IPv6 range of the predefined subnetwork.
+            "namePrefix": "A String", # The naming prefix of the predefined subnetwork.
+          },
+        ],
+        "subnetPurposes": [ # Specifies which subnetwork purposes are supported.
+          "A String",
+        ],
+        "subnetStackTypes": [ # Specifies which subnetwork stack types are supported.
+          "A String",
+        ],
+        "subnetworkPurposes": [ # Output only. Specifies which subnetwork purposes are supported.
+          "A String",
+        ],
+        "subnetworkStackTypes": [ # Output only. Specifies which subnetwork stack types are supported.
+          "A String",
+        ],
+        "unicast": "A String", # Specifies which type of unicast is supported.
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#networkProfile", # Output only. [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles.
+      "location": { # Output only. [Output Only] Location to which the network is restricted.
+        "name": "A String",
+        "scope": "A String",
+      },
+      "name": "A String", # Output only. [Output Only] Name of the resource.
+      "profileType": { # Output only. [Output Only] Type of the network profile.
+        "networkType": "A String",
+        "rdmaSubtype": "A String",
+        "ullSubtype": "A String",
+        "vpcSubtype": "A String",
+      },
+      "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 with the resource id.
+    },
+  ],
+  "kind": "compute#networkProfileList", # Output only. [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.networks.html b/docs/dyn/compute_preview.networks.html new file mode 100644 index 0000000000..1343ef4ce0 --- /dev/null +++ b/docs/dyn/compute_preview.networks.html @@ -0,0 +1,4672 @@ + + + +

Compute Engine API . networks

+

Instance Methods

+

+ addPeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Adds a peering to the specified network.

+

+ cancelRequestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Cancel requests to remove a peering from the specified network. Applicable

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, network, requestId=None, x__xgafv=None)

+

Deletes the specified network.

+

+ get(project, network, x__xgafv=None)

+

Returns the specified network.

+

+ getEffectiveFirewalls(project, network, x__xgafv=None)

+

Returns the effective firewalls on a given network.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a network in the specified project using the data included

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of networks available to the specified project.

+

+ listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, x__xgafv=None)

+

Lists the peering routes exchanged over peering connection.

+

+ listPeeringRoutes_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, network, body=None, requestId=None, x__xgafv=None)

+

Patches the specified network with the data included in the request.

+

+ removePeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Removes a peering from the specified network.

+

+ requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Requests to remove a peering from the specified network. Applicable only

+

+ switchToCustomMode(project, network, requestId=None, x__xgafv=None)

+

Switches the network mode from auto subnet mode to custom subnet mode.

+

+ updatePeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Updates the specified network peering with the data included in the

+

Method Details

+
+ addPeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Adds a peering to the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to add peering to. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "autoCreateRoutes": True or False, # This field will be deprecated soon. Useexchange_subnet_routes in network_peering
+      # instead.
+      # Indicates whether full mesh connectivity is created and managed
+      # automatically between peered networks. Currently this field should always
+      # be true since Google Compute Engine will automatically create and manage
+      # subnetwork routes between two networks when peering state isACTIVE.
+  "name": "A String", # Name of the peering, which should conform to RFC1035.
+  "networkPeering": { # A network peering attached to a network resource. The message includes the # Network peering parameters.
+      # In order to specify route policies for peering using import and export
+      # custom routes, you must specify all peering related parameters
+      # (name, peer network,exchange_subnet_routes) in the network_peering
+      # field.
+      # The corresponding fields in NetworksAddPeeringRequest will be
+      # deprecated soon.
+      # peering name, peer network, peering state, and a flag indicating whether
+      # Google Compute Engine should automatically create routes for the peering.
+    "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+        # Indicates whether full mesh connectivity is created and managed
+        # automatically between peered networks. Currently this field should always
+        # be true since Google Compute Engine will automatically create and manage
+        # subnetwork routes between two networks when peering state isACTIVE.
+    "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+        # as a whole.
+        # local peering. This field provides information about the effective settings
+        # for the connection as a whole, including pending delete/update requests for
+        # CONSENSUS peerings.
+      "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+          # and delete for a consensus peering connection.
+          # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+          # strategy to CONSENSUS.
+        "deleteStatus": "A String", # The status of the delete request.
+        "updateStatus": "A String", # The status of the update request.
+      },
+      "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+          # settings of the network peerings.
+        "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+        "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+            # peer network.
+        "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+        "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+            # from the peer network.
+        "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+            # exported between peer networks.
+      },
+      "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+          # peering connection.
+    },
+    "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+        # automatically between peered networks. Currently this field should always
+        # be true since Google Compute Engine will automatically create and manage
+        # subnetwork routes between two networks when peering state isACTIVE.
+    "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+        # false.
+    "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+        # is true, all subnet routes are exported.IPv4
+        # special-use ranges are always
+        # exported to peers and are not controlled by this field.
+    "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+        # false.
+    "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+        # is false.IPv4
+        # special-use ranges are always
+        # imported from peers and are not controlled by this field.
+    "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+        # The name must comply withRFC1035.
+        # Specifically, the name must be 1-63 characters long and match regular
+        # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+        # lowercase letter, and all the following characters must be a dash,
+        # lowercase letter, or digit, except the last character, which cannot be a
+        # dash.
+    "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+        # peer network may belong to a different project. If the partial URL does not
+        # contain project, it is assumed that the peer network is in the same project
+        # as the current network.
+    "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+    "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+        # exported between peer networks. The default value is IPV4_ONLY.
+    "state": "A String", # Output only. [Output Only] State for the peering.
+    "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+    "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+        # peering connection configuration.
+  },
+  "peerNetwork": "A String", # URL of the peer network.  It can be either full URL or partial URL. The
+      # peer network may belong to a different project. If the partial URL does not
+      # contain project, it is assumed that the peer network is in the same project
+      # as the current network.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ cancelRequestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Cancel requests to remove a peering from the specified network. Applicable
+only for PeeringConnection with update_strategy=CONSENSUS.  Cancels a
+request to remove a peering from the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to remove peering from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "name": "A String", # Name of the peering, which should 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, network, requestId=None, x__xgafv=None) + 
Deletes the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, network, x__xgafv=None) + 
Returns the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network 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 VPC Network resource.
+    #
+    # Networks connect resources to each other and to the internet. For more
+    # information, readVirtual Private Cloud (VPC) Network.
+  "IPv4Range": "A String", # Deprecated in favor of subnet mode networks.
+      # The range of internal addresses that are legal on this network. This
+      # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
+      # created.
+  "autoCreateSubnetworks": True or False, # Must be set to create a VPC network. If not set, a legacy network is
+      # created.
+      #
+      # When set to true, the VPC network is created in auto mode.
+      # When set to false, the VPC network is created in custom mode.
+      #
+      # An auto mode VPC network starts with one subnet per region. Each subnet
+      # has a predetermined range as described inAuto mode VPC network IP ranges.
+      #
+      # For custom mode VPC networks, you can add subnets using the subnetworksinsert
+      # method.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "enableUlaInternalIpv6": True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
+      # a /48 from google defined ULA prefix fd20::/20.
+      # .
+  "firewallPolicy": "A String", # Output only. [Output Only] URL of the firewall policy the network is associated with.
+  "gatewayIPv4": "A String", # [Output Only] The gateway address for default routing out of the network,
+      # selected by Google Cloud.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Range": "A String", # When enabling ula internal ipv6, caller optionally can specify the /48
+      # range they want from the google defined ULA prefix fd20::/20. The input
+      # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
+      # Operation will fail if the speficied /48 is already in used by another
+      # resource. If the field is not speficied, then a /48 range will be randomly
+      # allocated from fd20::/20 and returned via this field.
+      # .
+  "kind": "compute#network", # Output only. [Output Only] Type of the resource. Always compute#network for
+      # networks.
+  "mtu": 42, # Maximum Transmission Unit in bytes.
+      # The minimum value for this field is 1300 and the maximum value is 8896.
+      # The suggested value is 1500, which is the default MTU used on the
+      # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
+      # value defaults to 1460.
+  "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])?`. The first character must be a
+      # lowercase letter, and all following characters (except for the last
+      # character) must be a dash, lowercase letter, or digit. The last character
+      # must be a lowercase letter or digit.
+  "networkFirewallPolicyEnforcementOrder": "A String", # The network firewall policy enforcement order. Can be either
+      # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
+      # AFTER_CLASSIC_FIREWALL if the field is not specified.
+  "networkProfile": "A String", # A full or partial URL of the network profile to apply to this network.
+      # This field can be set only at resource creation time. For example, the
+      # following are valid URLs:
+      #
+      #    - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
+      #    - projects/{project_id}/global/networkProfiles/{network_profile_name}
+  "params": { # Additional network 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "peerings": [ # Output only. [Output Only] A list of network peerings for the resource.
+    { # A network peering attached to a network resource. The message includes the
+        # peering name, peer network, peering state, and a flag indicating whether
+        # Google Compute Engine should automatically create routes for the peering.
+      "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+          # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+          # as a whole.
+          # local peering. This field provides information about the effective settings
+          # for the connection as a whole, including pending delete/update requests for
+          # CONSENSUS peerings.
+        "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+            # and delete for a consensus peering connection.
+            # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+            # strategy to CONSENSUS.
+          "deleteStatus": "A String", # The status of the delete request.
+          "updateStatus": "A String", # The status of the update request.
+        },
+        "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+            # settings of the network peerings.
+          "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+          "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+              # peer network.
+          "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+          "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+              # from the peer network.
+          "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+              # exported between peer networks.
+        },
+        "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+            # peering connection.
+      },
+      "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+          # false.
+      "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+          # is true, all subnet routes are exported.IPv4
+          # special-use ranges are always
+          # exported to peers and are not controlled by this field.
+      "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+          # false.
+      "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+          # is false.IPv4
+          # special-use ranges are always
+          # imported from peers and are not controlled by this field.
+      "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+          # The name must comply withRFC1035.
+          # Specifically, the name must be 1-63 characters long and match regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+          # lowercase letter, and all the following characters must be a dash,
+          # lowercase letter, or digit, except the last character, which cannot be a
+          # dash.
+      "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+          # peer network may belong to a different project. If the partial URL does not
+          # contain project, it is assumed that the peer network is in the same project
+          # as the current network.
+      "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+      "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+          # exported between peer networks. The default value is IPV4_ONLY.
+      "state": "A String", # Output only. [Output Only] State for the peering.
+      "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+      "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+          # peering connection configuration.
+    },
+  ],
+  "routingConfig": { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network.  Used by Cloud
+      # Router to determine what type of network-wide routing behavior to enforce.
+      # includes the list of routers associated with the network, and a flag
+      # indicating the type of routing behavior to enforce network-wide.
+    "bgpAlwaysCompareMed": True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
+        # different neighbor ASNs when using the STANDARD BGP best path selection
+        # algorithm.
+    "bgpBestPathSelectionMode": "A String", # The BGP best path selection algorithm to be employed within this network
+        # for dynamic routes learned by Cloud Routers. Can be LEGACY
+        # (default) or STANDARD.
+    "bgpInterRegionCost": "A String", # Allows to define a preferred approach for handling inter-region cost in
+        # the selection process when using the STANDARD BGP best path
+        # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
+    "effectiveBgpAlwaysCompareMed": True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
+        # field.
+    "effectiveBgpInterRegionCost": "A String", # Output only. [Output Only] Effective value of the bgp_inter_region_cost
+        # field.
+    "routingMode": "A String", # The network-wide routing mode to use. If set to REGIONAL,
+        # this network's Cloud Routers will only advertise routes with subnets
+        # of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise
+        # routes with all subnets of this network, across regions.
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "subnetworks": [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
+      # in this VPC network.
+    "A String",
+  ],
+}
+
+ +
+ getEffectiveFirewalls(project, network, x__xgafv=None) + 
Returns the effective firewalls on a given network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network for this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "firewallPolicys": [ # [Output Only] Effective firewalls from firewall policy. It returns Global
+      # Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get
+      # Regional Network Firewall Policies as well.
+    {
+      "displayName": "A String", # Output only. [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy.
+      "name": "A String", # Output only. [Output Only] The name of the firewall policy.
+      "packetMirroringRules": [ # Output only. [Output Only] The packet mirroring rules that apply to the network.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "priority": 42, # Output only. [Output only] Priority of firewall policy association. Not applicable for
+          # type=HIERARCHY.
+      "rules": [ # [Output Only] The rules that apply to the network.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy.
+      "type": "A String", # Output only. [Output Only] The type of the firewall policy.
+    },
+  ],
+  "firewalls": [ # Effective firewalls on the network.
+    { # Represents a Firewall Rule resource.
+        #
+        # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+        # instances. For more information, readFirewall rules.
+      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a permitted connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a denied connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+          # traffic that has destination IP address in these ranges. These ranges must
+          # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+          # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+          # specify the sourceTags fields.
+      "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+          # firewall rule is not enforced and the network behaves as if it did not
+          # exist. If this is unspecified, the firewall rule will be enabled.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+          # for firewall rules.
+      "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+          # logging is enabled, logs will be exported to Cloud Logging.
+        "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+            # rule.
+        "metadata": "A String", # This field can only be specified for a particular firewall rule if
+            # logging is enabled for that rule. This field denotes whether to include
+            # or exclude metadata for firewall logs.
+      },
+      "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # URL of the network resource for this firewall rule. If not
+          # specified when creating a firewall rule, the default network
+          # is used:
+          #
+          # global/networks/default
+          #
+          # If you choose to specify this field, you can specify the network as a full
+          # or partial URL. For example, the following are all valid URLs:
+          #
+          #    -
+          #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+          #    - projects/myproject/global/networks/my-network
+          #    - global/networks/default
+      "params": { # Additional firewall 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "priority": 42, # Priority for this rule.
+          # This is an integer between `0` and `65535`, both inclusive.
+          # The default value is `1000`.
+          # Relative priorities determine which rule takes effect if multiple rules
+          # apply. Lower values indicate higher priority. For example, a rule with
+          # priority `0` has higher precedence than a rule with priority `1`.
+          # DENY rules take precedence over ALLOW rules if they have equal priority.
+          # Note that VPC networks have implied
+          # rules with a priority of `65535`. To avoid conflicts with the implied
+          # rules, use a priority number less than `65535`.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+          # that has a source IP address in these ranges. These ranges must be
+          # expressed inCIDR format. One or both of sourceRanges
+          # and sourceTags may be set.
+          # If both fields are set, the rule applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP
+          # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+          # both fields for the rule to
+          # apply. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+          # traffic originating from an instance with a service account in this list.
+          # Source service accounts cannot be used to control traffic to an instance's
+          # external IP address because service accounts are associated with an
+          # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+          # If both are set, the firewall applies to traffic that
+          # has a source IP address within the sourceRanges OR a source
+          # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+          # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+        "A String",
+      ],
+      "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+          # with source IPs that match the primary network interfaces of VM instances
+          # that have the tag and are in the same VPC network.
+          # Source tags cannot be used to control traffic to an instance's external IP
+          # address, it only applies to traffic between instances in the same virtual
+          # network. Because tags are associated with instances, not IP addresses.
+          # One or both of sourceRanges and sourceTags may be
+          # set. If both fields are set, the firewall applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP from a
+          # resource with a matching tag listed in the sourceTags
+          # field. The connection does not need to match both fields for the
+          # firewall to apply.
+        "A String",
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+          # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+          # If neither targetServiceAccounts nor targetTags
+          # are specified, the firewall rule applies to all instances on the specified
+          # network.
+        "A String",
+      ],
+      "targetTags": [ # A list of tags that controls which instances the firewall rule
+          # applies to. If targetTags are specified, then the firewall
+          # rule applies only to instances in the VPC network that have one of those
+          # tags. If no targetTags are specified, the firewall rule
+          # applies to all instances on the specified network.
+        "A String",
+      ],
+    },
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a network 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 VPC Network resource.
+    # 
+    # Networks connect resources to each other and to the internet. For more
+    # information, readVirtual Private Cloud (VPC) Network.
+  "IPv4Range": "A String", # Deprecated in favor of subnet mode networks.
+      # The range of internal addresses that are legal on this network. This
+      # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
+      # created.
+  "autoCreateSubnetworks": True or False, # Must be set to create a VPC network. If not set, a legacy network is
+      # created.
+      # 
+      # When set to true, the VPC network is created in auto mode.
+      # When set to false, the VPC network is created in custom mode.
+      # 
+      # An auto mode VPC network starts with one subnet per region. Each subnet
+      # has a predetermined range as described inAuto mode VPC network IP ranges.
+      # 
+      # For custom mode VPC networks, you can add subnets using the subnetworksinsert
+      # method.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "enableUlaInternalIpv6": True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
+      # a /48 from google defined ULA prefix fd20::/20.
+      # .
+  "firewallPolicy": "A String", # Output only. [Output Only] URL of the firewall policy the network is associated with.
+  "gatewayIPv4": "A String", # [Output Only] The gateway address for default routing out of the network,
+      # selected by Google Cloud.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Range": "A String", # When enabling ula internal ipv6, caller optionally can specify the /48
+      # range they want from the google defined ULA prefix fd20::/20. The input
+      # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
+      # Operation will fail if the speficied /48 is already in used by another
+      # resource. If the field is not speficied, then a /48 range will be randomly
+      # allocated from fd20::/20 and returned via this field.
+      # .
+  "kind": "compute#network", # Output only. [Output Only] Type of the resource. Always compute#network for
+      # networks.
+  "mtu": 42, # Maximum Transmission Unit in bytes.
+      # The minimum value for this field is 1300 and the maximum value is 8896.
+      # The suggested value is 1500, which is the default MTU used on the
+      # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
+      # value defaults to 1460.
+  "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])?`. The first character must be a
+      # lowercase letter, and all following characters (except for the last
+      # character) must be a dash, lowercase letter, or digit. The last character
+      # must be a lowercase letter or digit.
+  "networkFirewallPolicyEnforcementOrder": "A String", # The network firewall policy enforcement order. Can be either
+      # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
+      # AFTER_CLASSIC_FIREWALL if the field is not specified.
+  "networkProfile": "A String", # A full or partial URL of the network profile to apply to this network.
+      # This field can be set only at resource creation time. For example, the
+      # following are valid URLs:
+      # 
+      #    - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
+      #    - projects/{project_id}/global/networkProfiles/{network_profile_name}
+  "params": { # Additional network 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "peerings": [ # Output only. [Output Only] A list of network peerings for the resource.
+    { # A network peering attached to a network resource. The message includes the
+        # peering name, peer network, peering state, and a flag indicating whether
+        # Google Compute Engine should automatically create routes for the peering.
+      "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+          # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+          # as a whole.
+          # local peering. This field provides information about the effective settings
+          # for the connection as a whole, including pending delete/update requests for
+          # CONSENSUS peerings.
+        "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+            # and delete for a consensus peering connection.
+            # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+            # strategy to CONSENSUS.
+          "deleteStatus": "A String", # The status of the delete request.
+          "updateStatus": "A String", # The status of the update request.
+        },
+        "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+            # settings of the network peerings.
+          "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+          "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+              # peer network.
+          "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+          "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+              # from the peer network.
+          "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+              # exported between peer networks.
+        },
+        "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+            # peering connection.
+      },
+      "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+          # false.
+      "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+          # is true, all subnet routes are exported.IPv4
+          # special-use ranges are always
+          # exported to peers and are not controlled by this field.
+      "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+          # false.
+      "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+          # is false.IPv4
+          # special-use ranges are always
+          # imported from peers and are not controlled by this field.
+      "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+          # The name must comply withRFC1035.
+          # Specifically, the name must be 1-63 characters long and match regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+          # lowercase letter, and all the following characters must be a dash,
+          # lowercase letter, or digit, except the last character, which cannot be a
+          # dash.
+      "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+          # peer network may belong to a different project. If the partial URL does not
+          # contain project, it is assumed that the peer network is in the same project
+          # as the current network.
+      "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+      "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+          # exported between peer networks. The default value is IPV4_ONLY.
+      "state": "A String", # Output only. [Output Only] State for the peering.
+      "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+      "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+          # peering connection configuration.
+    },
+  ],
+  "routingConfig": { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network.  Used by Cloud
+      # Router to determine what type of network-wide routing behavior to enforce.
+      # includes the list of routers associated with the network, and a flag
+      # indicating the type of routing behavior to enforce network-wide.
+    "bgpAlwaysCompareMed": True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
+        # different neighbor ASNs when using the STANDARD BGP best path selection
+        # algorithm.
+    "bgpBestPathSelectionMode": "A String", # The BGP best path selection algorithm to be employed within this network
+        # for dynamic routes learned by Cloud Routers. Can be LEGACY
+        # (default) or STANDARD.
+    "bgpInterRegionCost": "A String", # Allows to define a preferred approach for handling inter-region cost in
+        # the selection process when using the STANDARD BGP best path
+        # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
+    "effectiveBgpAlwaysCompareMed": True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
+        # field.
+    "effectiveBgpInterRegionCost": "A String", # Output only. [Output Only] Effective value of the bgp_inter_region_cost
+        # field.
+    "routingMode": "A String", # The network-wide routing mode to use. If set to REGIONAL,
+        # this network's Cloud Routers will only advertise routes with subnets
+        # of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise
+        # routes with all subnets of this network, across regions.
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "subnetworks": [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
+      # in this VPC network.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of networks available to 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.
+  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 networks.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Network resources.
+    { # Represents a VPC Network resource.
+        #
+        # Networks connect resources to each other and to the internet. For more
+        # information, readVirtual Private Cloud (VPC) Network.
+      "IPv4Range": "A String", # Deprecated in favor of subnet mode networks.
+          # The range of internal addresses that are legal on this network. This
+          # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
+          # created.
+      "autoCreateSubnetworks": True or False, # Must be set to create a VPC network. If not set, a legacy network is
+          # created.
+          #
+          # When set to true, the VPC network is created in auto mode.
+          # When set to false, the VPC network is created in custom mode.
+          #
+          # An auto mode VPC network starts with one subnet per region. Each subnet
+          # has a predetermined range as described inAuto mode VPC network IP ranges.
+          #
+          # For custom mode VPC networks, you can add subnets using the subnetworksinsert
+          # method.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "enableUlaInternalIpv6": True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
+          # a /48 from google defined ULA prefix fd20::/20.
+          # .
+      "firewallPolicy": "A String", # Output only. [Output Only] URL of the firewall policy the network is associated with.
+      "gatewayIPv4": "A String", # [Output Only] The gateway address for default routing out of the network,
+          # selected by Google Cloud.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "internalIpv6Range": "A String", # When enabling ula internal ipv6, caller optionally can specify the /48
+          # range they want from the google defined ULA prefix fd20::/20. The input
+          # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
+          # Operation will fail if the speficied /48 is already in used by another
+          # resource. If the field is not speficied, then a /48 range will be randomly
+          # allocated from fd20::/20 and returned via this field.
+          # .
+      "kind": "compute#network", # Output only. [Output Only] Type of the resource. Always compute#network for
+          # networks.
+      "mtu": 42, # Maximum Transmission Unit in bytes.
+          # The minimum value for this field is 1300 and the maximum value is 8896.
+          # The suggested value is 1500, which is the default MTU used on the
+          # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
+          # value defaults to 1460.
+      "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])?`. The first character must be a
+          # lowercase letter, and all following characters (except for the last
+          # character) must be a dash, lowercase letter, or digit. The last character
+          # must be a lowercase letter or digit.
+      "networkFirewallPolicyEnforcementOrder": "A String", # The network firewall policy enforcement order. Can be either
+          # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
+          # AFTER_CLASSIC_FIREWALL if the field is not specified.
+      "networkProfile": "A String", # A full or partial URL of the network profile to apply to this network.
+          # This field can be set only at resource creation time. For example, the
+          # following are valid URLs:
+          #
+          #    - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
+          #    - projects/{project_id}/global/networkProfiles/{network_profile_name}
+      "params": { # Additional network 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "peerings": [ # Output only. [Output Only] A list of network peerings for the resource.
+        { # A network peering attached to a network resource. The message includes the
+            # peering name, peer network, peering state, and a flag indicating whether
+            # Google Compute Engine should automatically create routes for the peering.
+          "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+              # Indicates whether full mesh connectivity is created and managed
+              # automatically between peered networks. Currently this field should always
+              # be true since Google Compute Engine will automatically create and manage
+              # subnetwork routes between two networks when peering state isACTIVE.
+          "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+              # as a whole.
+              # local peering. This field provides information about the effective settings
+              # for the connection as a whole, including pending delete/update requests for
+              # CONSENSUS peerings.
+            "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+                # and delete for a consensus peering connection.
+                # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+                # strategy to CONSENSUS.
+              "deleteStatus": "A String", # The status of the delete request.
+              "updateStatus": "A String", # The status of the update request.
+            },
+            "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+                # settings of the network peerings.
+              "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+              "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+                  # peer network.
+              "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+              "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+                  # from the peer network.
+              "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+                  # exported between peer networks.
+            },
+            "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+                # peering connection.
+          },
+          "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+              # automatically between peered networks. Currently this field should always
+              # be true since Google Compute Engine will automatically create and manage
+              # subnetwork routes between two networks when peering state isACTIVE.
+          "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+              # false.
+          "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+              # is true, all subnet routes are exported.IPv4
+              # special-use ranges are always
+              # exported to peers and are not controlled by this field.
+          "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+              # false.
+          "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+              # is false.IPv4
+              # special-use ranges are always
+              # imported from peers and are not controlled by this field.
+          "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+              # The name must comply withRFC1035.
+              # Specifically, the name must be 1-63 characters long and match regular
+              # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+              # lowercase letter, and all the following characters must be a dash,
+              # lowercase letter, or digit, except the last character, which cannot be a
+              # dash.
+          "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+              # peer network may belong to a different project. If the partial URL does not
+              # contain project, it is assumed that the peer network is in the same project
+              # as the current network.
+          "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+          "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+              # exported between peer networks. The default value is IPV4_ONLY.
+          "state": "A String", # Output only. [Output Only] State for the peering.
+          "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+          "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+              # peering connection configuration.
+        },
+      ],
+      "routingConfig": { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network.  Used by Cloud
+          # Router to determine what type of network-wide routing behavior to enforce.
+          # includes the list of routers associated with the network, and a flag
+          # indicating the type of routing behavior to enforce network-wide.
+        "bgpAlwaysCompareMed": True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
+            # different neighbor ASNs when using the STANDARD BGP best path selection
+            # algorithm.
+        "bgpBestPathSelectionMode": "A String", # The BGP best path selection algorithm to be employed within this network
+            # for dynamic routes learned by Cloud Routers. Can be LEGACY
+            # (default) or STANDARD.
+        "bgpInterRegionCost": "A String", # Allows to define a preferred approach for handling inter-region cost in
+            # the selection process when using the STANDARD BGP best path
+            # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
+        "effectiveBgpAlwaysCompareMed": True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
+            # field.
+        "effectiveBgpInterRegionCost": "A String", # Output only. [Output Only] Effective value of the bgp_inter_region_cost
+            # field.
+        "routingMode": "A String", # The network-wide routing mode to use. If set to REGIONAL,
+            # this network's Cloud Routers will only advertise routes with subnets
+            # of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise
+            # routes with all subnets of this network, across regions.
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "subnetworks": [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
+          # in this VPC network.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#networkList", # Output only. [Output Only] Type of resource. Always compute#networkList for
+      # lists of networks.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, x__xgafv=None) + 
Lists the peering routes exchanged over peering connection.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network for this request. (required)
+  direction: string, The direction of the exchanged routes.
+    Allowed values
+      INCOMING - For routes exported from peer network.
+      OUTGOING - For routes exported from local network.
+  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.
+  peeringName: string, The response will show routes exchanged over the given peering connection.
+  region: string, The region of the request. The response will include all subnet routes,
+static routes and dynamic routes in the region.
+  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 ExchangedPeeringRoute resources.
+    {
+      "destRange": "A String", # The destination range of the route.
+      "imported": True or False, # True if the peering route has been imported from a peer. The actual import
+          # happens if the field networkPeering.importCustomRoutes is true
+          # for this network, and networkPeering.exportCustomRoutes is
+          # true for the peer network, and the import does not result in a route
+          # conflict.
+      "nextHopRegion": "A String", # The region of peering route next hop, only applies to dynamic routes.
+      "priority": 42, # The priority of the peering route.
+      "type": "A String", # The type of the peering route.
+    },
+  ],
+  "kind": "compute#exchangedPeeringRoutesList", # Output only. [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering
+      # routes lists.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listPeeringRoutes_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, network, body=None, requestId=None, x__xgafv=None) + 
Patches the specified network with the data included in the request.
+Only routingConfig can be modified.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a VPC Network resource.
+    # 
+    # Networks connect resources to each other and to the internet. For more
+    # information, readVirtual Private Cloud (VPC) Network.
+  "IPv4Range": "A String", # Deprecated in favor of subnet mode networks.
+      # The range of internal addresses that are legal on this network. This
+      # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
+      # created.
+  "autoCreateSubnetworks": True or False, # Must be set to create a VPC network. If not set, a legacy network is
+      # created.
+      # 
+      # When set to true, the VPC network is created in auto mode.
+      # When set to false, the VPC network is created in custom mode.
+      # 
+      # An auto mode VPC network starts with one subnet per region. Each subnet
+      # has a predetermined range as described inAuto mode VPC network IP ranges.
+      # 
+      # For custom mode VPC networks, you can add subnets using the subnetworksinsert
+      # method.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "enableUlaInternalIpv6": True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
+      # a /48 from google defined ULA prefix fd20::/20.
+      # .
+  "firewallPolicy": "A String", # Output only. [Output Only] URL of the firewall policy the network is associated with.
+  "gatewayIPv4": "A String", # [Output Only] The gateway address for default routing out of the network,
+      # selected by Google Cloud.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Range": "A String", # When enabling ula internal ipv6, caller optionally can specify the /48
+      # range they want from the google defined ULA prefix fd20::/20. The input
+      # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
+      # Operation will fail if the speficied /48 is already in used by another
+      # resource. If the field is not speficied, then a /48 range will be randomly
+      # allocated from fd20::/20 and returned via this field.
+      # .
+  "kind": "compute#network", # Output only. [Output Only] Type of the resource. Always compute#network for
+      # networks.
+  "mtu": 42, # Maximum Transmission Unit in bytes.
+      # The minimum value for this field is 1300 and the maximum value is 8896.
+      # The suggested value is 1500, which is the default MTU used on the
+      # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
+      # value defaults to 1460.
+  "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])?`. The first character must be a
+      # lowercase letter, and all following characters (except for the last
+      # character) must be a dash, lowercase letter, or digit. The last character
+      # must be a lowercase letter or digit.
+  "networkFirewallPolicyEnforcementOrder": "A String", # The network firewall policy enforcement order. Can be either
+      # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
+      # AFTER_CLASSIC_FIREWALL if the field is not specified.
+  "networkProfile": "A String", # A full or partial URL of the network profile to apply to this network.
+      # This field can be set only at resource creation time. For example, the
+      # following are valid URLs:
+      # 
+      #    - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
+      #    - projects/{project_id}/global/networkProfiles/{network_profile_name}
+  "params": { # Additional network 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "peerings": [ # Output only. [Output Only] A list of network peerings for the resource.
+    { # A network peering attached to a network resource. The message includes the
+        # peering name, peer network, peering state, and a flag indicating whether
+        # Google Compute Engine should automatically create routes for the peering.
+      "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+          # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+          # as a whole.
+          # local peering. This field provides information about the effective settings
+          # for the connection as a whole, including pending delete/update requests for
+          # CONSENSUS peerings.
+        "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+            # and delete for a consensus peering connection.
+            # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+            # strategy to CONSENSUS.
+          "deleteStatus": "A String", # The status of the delete request.
+          "updateStatus": "A String", # The status of the update request.
+        },
+        "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+            # settings of the network peerings.
+          "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+          "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+              # peer network.
+          "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+          "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+              # from the peer network.
+          "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+              # exported between peer networks.
+        },
+        "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+            # peering connection.
+      },
+      "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+          # automatically between peered networks. Currently this field should always
+          # be true since Google Compute Engine will automatically create and manage
+          # subnetwork routes between two networks when peering state isACTIVE.
+      "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+          # false.
+      "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+          # is true, all subnet routes are exported.IPv4
+          # special-use ranges are always
+          # exported to peers and are not controlled by this field.
+      "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+          # false.
+      "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+          # is false.IPv4
+          # special-use ranges are always
+          # imported from peers and are not controlled by this field.
+      "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+          # The name must comply withRFC1035.
+          # Specifically, the name must be 1-63 characters long and match regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+          # lowercase letter, and all the following characters must be a dash,
+          # lowercase letter, or digit, except the last character, which cannot be a
+          # dash.
+      "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+          # peer network may belong to a different project. If the partial URL does not
+          # contain project, it is assumed that the peer network is in the same project
+          # as the current network.
+      "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+      "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+          # exported between peer networks. The default value is IPV4_ONLY.
+      "state": "A String", # Output only. [Output Only] State for the peering.
+      "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+      "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+          # peering connection configuration.
+    },
+  ],
+  "routingConfig": { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network.  Used by Cloud
+      # Router to determine what type of network-wide routing behavior to enforce.
+      # includes the list of routers associated with the network, and a flag
+      # indicating the type of routing behavior to enforce network-wide.
+    "bgpAlwaysCompareMed": True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
+        # different neighbor ASNs when using the STANDARD BGP best path selection
+        # algorithm.
+    "bgpBestPathSelectionMode": "A String", # The BGP best path selection algorithm to be employed within this network
+        # for dynamic routes learned by Cloud Routers. Can be LEGACY
+        # (default) or STANDARD.
+    "bgpInterRegionCost": "A String", # Allows to define a preferred approach for handling inter-region cost in
+        # the selection process when using the STANDARD BGP best path
+        # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
+    "effectiveBgpAlwaysCompareMed": True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
+        # field.
+    "effectiveBgpInterRegionCost": "A String", # Output only. [Output Only] Effective value of the bgp_inter_region_cost
+        # field.
+    "routingMode": "A String", # The network-wide routing mode to use. If set to REGIONAL,
+        # this network's Cloud Routers will only advertise routes with subnets
+        # of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise
+        # routes with all subnets of this network, across regions.
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "subnetworks": [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
+      # in this VPC network.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removePeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Removes a peering from the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to remove peering from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "name": "A String", # Name of the peering, which should 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Requests to remove a peering from the specified network. Applicable only
+for PeeringConnection with update_strategy=CONSENSUS.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to remove peering from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "name": "A String", # Name of the peering, which should 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ switchToCustomMode(project, network, requestId=None, x__xgafv=None) + 
Switches the network mode from auto subnet mode to custom subnet mode.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network to be updated. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updatePeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Updates the specified network peering with the data included in the
+request. You can only modify the NetworkPeering.export_custom_routes field
+and the NetworkPeering.import_custom_routes field.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource which the updated peering is belonging to. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkPeering": { # A network peering attached to a network resource. The message includes the
+      # peering name, peer network, peering state, and a flag indicating whether
+      # Google Compute Engine should automatically create routes for the peering.
+    "autoCreateRoutes": True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
+        # Indicates whether full mesh connectivity is created and managed
+        # automatically between peered networks. Currently this field should always
+        # be true since Google Compute Engine will automatically create and manage
+        # subnetwork routes between two networks when peering state isACTIVE.
+    "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
+        # as a whole.
+        # local peering. This field provides information about the effective settings
+        # for the connection as a whole, including pending delete/update requests for
+        # CONSENSUS peerings.
+      "consensusState": { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
+          # and delete for a consensus peering connection.
+          # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
+          # strategy to CONSENSUS.
+        "deleteStatus": "A String", # The status of the delete request.
+        "updateStatus": "A String", # The status of the update request.
+      },
+      "trafficConfiguration": { # The active connectivity settings for the peering connection based on the
+          # settings of the network peerings.
+        "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+        "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the
+            # peer network.
+        "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+        "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported
+            # from the peer network.
+        "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or
+            # exported between peer networks.
+      },
+      "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this
+          # peering connection.
+    },
+    "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed
+        # automatically between peered networks. Currently this field should always
+        # be true since Google Compute Engine will automatically create and manage
+        # subnetwork routes between two networks when peering state isACTIVE.
+    "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is
+        # false.
+    "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value
+        # is true, all subnet routes are exported.IPv4
+        # special-use ranges are always
+        # exported to peers and are not controlled by this field.
+    "importCustomRoutes": True or False, # Whether to import the custom routes from peer network. The default value is
+        # false.
+    "importSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are imported. The default value
+        # is false.IPv4
+        # special-use ranges are always
+        # imported from peers and are not controlled by this field.
+    "name": "A String", # Name of this peering. Provided by the client when the peering is created.
+        # The name must comply withRFC1035.
+        # Specifically, the name must be 1-63 characters long and match regular
+        # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
+        # lowercase letter, and all the following characters must be a dash,
+        # lowercase letter, or digit, except the last character, which cannot be a
+        # dash.
+    "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The
+        # peer network may belong to a different project. If the partial URL does not
+        # contain project, it is assumed that the peer network is in the same project
+        # as the current network.
+    "peerMtu": 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
+    "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or
+        # exported between peer networks. The default value is IPV4_ONLY.
+    "state": "A String", # Output only. [Output Only] State for the peering.
+    "stateDetails": "A String", # Output only. [Output Only] Details about the current state of the peering.
+    "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the
+        # peering connection configuration.
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.nodeGroups.html b/docs/dyn/compute_preview.nodeGroups.html new file mode 100644 index 0000000000..9aaa09ca21 --- /dev/null +++ b/docs/dyn/compute_preview.nodeGroups.html @@ -0,0 +1,4879 @@ + + + +

Compute Engine API . nodeGroups

+

Instance Methods

+

+ addNodes(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Adds specified number of nodes to the node group.

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of node groups.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, nodeGroup, requestId=None, x__xgafv=None)

+

Deletes the specified NodeGroup resource.

+

+ deleteNodes(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Deletes specified nodes from the node group.

+

+ get(project, zone, nodeGroup, x__xgafv=None)

+

Returns the specified NodeGroup. Get a list of available NodeGroups

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, initialNodeCount, body=None, requestId=None, x__xgafv=None)

+

Creates a NodeGroup resource in the specified project using the data

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of node groups available to the specified project.

+

+ listNodes(project, zone, nodeGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists nodes in the node group.

+

+ listNodes_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Updates the specified node group.

+

+ performMaintenance(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Perform maintenance on a subset of nodes in the node group.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setNodeTemplate(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Updates the node template of the node group.

+

+ simulateMaintenanceEvent(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

+

Simulates maintenance event on specified nodes from the node group.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ addNodes(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Adds specified number of nodes to the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "additionalNodeCount": 42, # Count of additional nodes to be added to the node group.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of node groups.
+Note: use nodeGroups.listNodes for more details about each group.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NodeGroupsScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of node groups.
+      "nodeGroups": [ # [Output Only] A list of node groups contained in this scope.
+        { # Represents a sole-tenant Node Group resource.
+            #
+            # A sole-tenant node is a physical server that is dedicated to
+            # hosting VM instances only for your specific project. Use sole-tenant nodes to
+            # keep your instances physically separated from instances in other projects, or
+            # to group your instances together on the same host hardware. For more
+            # information, readSole-tenant nodes.
+          "autoscalingPolicy": { # Specifies how autoscaling should behave.
+            "maxNodes": 42, # The maximum number of nodes that the group should have. Must be set if
+                # autoscaling is enabled. Maximum value allowed is 100.
+            "minNodes": 42, # The minimum number of nodes that the group should have.
+            "mode": "A String", # The autoscaling mode. Set to one of: ON, OFF,
+                # or ONLY_SCALE_OUT. For more information, see
+                # Autoscaler modes.
+          },
+          "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",
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#nodeGroup", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.
+          "locationHint": "A String", # An opaque location hint used to place the Node close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+              # The location hint here on the NodeGroup overrides any location_hint
+              # present in the NodeTemplate.
+          "maintenanceInterval": "A String", # Specifies the frequency of planned maintenance events. The accepted values
+              # are: `AS_NEEDED` and `RECURRENT`.
+          "maintenancePolicy": "A String", # Specifies how to handle instances when a node in the group undergoes
+              # maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.
+              # The default value is DEFAULT. For more information, see
+              # Maintenance policies.
+          "maintenanceWindow": { # Time window specified for daily maintenance operations. GCE's internal
+              # maintenance will be performed within this window.
+            "maintenanceDuration": { # A Duration represents a fixed-length span of time represented # Output only. [Output only] A predetermined duration for the window, automatically
+                # chosen to be the smallest possible in the given scenario.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+                # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+                # example, both 13:00-5 and 08:00 are valid.
+          },
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "nodeTemplate": "A String", # URL of the node template to create the node group from.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Share-settings for the node group
+            "projectMap": { # A map of project id and project config. This is only valid when
+                # share_type's value is SPECIFIC_PROJECTS.
+              "a_key": { # Config for each project in the share settings.
+                "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                    # parent map.
+              },
+            },
+            "shareType": "A String", # Type of sharing for this shared-reservation
+          },
+          "size": 42, # Output only. [Output Only] The total number of nodes in the node group.
+          "status": "A String",
+          "zone": "A String", # Output only. [Output Only] The name of the zone where the node group resides,
+              # such as us-central1-a.
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that appears when the nodeGroup
+          # 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#nodeGroupAggregatedList", # Output only. [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node
+      # groups.
+  "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, zone, nodeGroup, requestId=None, x__xgafv=None) + 
Deletes the specified NodeGroup resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteNodes(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Deletes specified nodes from the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource whose nodes will be deleted. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "nodes": [ # Names of the nodes to delete.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, nodeGroup, x__xgafv=None) + 
Returns the specified NodeGroup. Get a list of available NodeGroups
+by making a list() request.
+Note: the "nodes" field should not be used. Use nodeGroups.listNodes
+instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the node group 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 sole-tenant Node Group resource.
+    #
+    # A sole-tenant node is a physical server that is dedicated to
+    # hosting VM instances only for your specific project. Use sole-tenant nodes to
+    # keep your instances physically separated from instances in other projects, or
+    # to group your instances together on the same host hardware. For more
+    # information, readSole-tenant nodes.
+  "autoscalingPolicy": { # Specifies how autoscaling should behave.
+    "maxNodes": 42, # The maximum number of nodes that the group should have. Must be set if
+        # autoscaling is enabled. Maximum value allowed is 100.
+    "minNodes": 42, # The minimum number of nodes that the group should have.
+    "mode": "A String", # The autoscaling mode. Set to one of: ON, OFF,
+        # or ONLY_SCALE_OUT. For more information, see
+        # Autoscaler modes.
+  },
+  "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",
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeGroup", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.
+  "locationHint": "A String", # An opaque location hint used to place the Node close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+      # The location hint here on the NodeGroup overrides any location_hint
+      # present in the NodeTemplate.
+  "maintenanceInterval": "A String", # Specifies the frequency of planned maintenance events. The accepted values
+      # are: `AS_NEEDED` and `RECURRENT`.
+  "maintenancePolicy": "A String", # Specifies how to handle instances when a node in the group undergoes
+      # maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.
+      # The default value is DEFAULT. For more information, see
+      # Maintenance policies.
+  "maintenanceWindow": { # Time window specified for daily maintenance operations. GCE's internal
+      # maintenance will be performed within this window.
+    "maintenanceDuration": { # A Duration represents a fixed-length span of time represented # Output only. [Output only] A predetermined duration for the window, automatically
+        # chosen to be the smallest possible in the given scenario.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+        # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+        # example, both 13:00-5 and 08:00 are valid.
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "nodeTemplate": "A String", # URL of the node template to create the node group from.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Share-settings for the node group
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "size": 42, # Output only. [Output Only] The total number of nodes in the node group.
+  "status": "A String",
+  "zone": "A String", # Output only. [Output Only] The name of the zone where the node group resides,
+      # such as us-central1-a.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, initialNodeCount, body=None, requestId=None, x__xgafv=None) + 
Creates a NodeGroup resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  initialNodeCount: integer, Initial count of nodes in the node group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a sole-tenant Node Group resource.
+    # 
+    # A sole-tenant node is a physical server that is dedicated to
+    # hosting VM instances only for your specific project. Use sole-tenant nodes to
+    # keep your instances physically separated from instances in other projects, or
+    # to group your instances together on the same host hardware. For more
+    # information, readSole-tenant nodes.
+  "autoscalingPolicy": { # Specifies how autoscaling should behave.
+    "maxNodes": 42, # The maximum number of nodes that the group should have. Must be set if
+        # autoscaling is enabled. Maximum value allowed is 100.
+    "minNodes": 42, # The minimum number of nodes that the group should have.
+    "mode": "A String", # The autoscaling mode. Set to one of: ON, OFF,
+        # or ONLY_SCALE_OUT. For more information, see
+        # Autoscaler modes.
+  },
+  "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",
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeGroup", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.
+  "locationHint": "A String", # An opaque location hint used to place the Node close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+      # The location hint here on the NodeGroup overrides any location_hint
+      # present in the NodeTemplate.
+  "maintenanceInterval": "A String", # Specifies the frequency of planned maintenance events. The accepted values
+      # are: `AS_NEEDED` and `RECURRENT`.
+  "maintenancePolicy": "A String", # Specifies how to handle instances when a node in the group undergoes
+      # maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.
+      # The default value is DEFAULT. For more information, see
+      # Maintenance policies.
+  "maintenanceWindow": { # Time window specified for daily maintenance operations. GCE's internal
+      # maintenance will be performed within this window.
+    "maintenanceDuration": { # A Duration represents a fixed-length span of time represented # Output only. [Output only] A predetermined duration for the window, automatically
+        # chosen to be the smallest possible in the given scenario.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+        # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+        # example, both 13:00-5 and 08:00 are valid.
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "nodeTemplate": "A String", # URL of the node template to create the node group from.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Share-settings for the node group
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "size": 42, # Output only. [Output Only] The total number of nodes in the node group.
+  "status": "A String",
+  "zone": "A String", # Output only. [Output Only] The name of the zone where the node group resides,
+      # such as us-central1-a.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of node groups available to the specified project.
+Note: use nodeGroups.listNodes for more details about each group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 nodeGroups.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of NodeGroup resources.
+    { # Represents a sole-tenant Node Group resource.
+        #
+        # A sole-tenant node is a physical server that is dedicated to
+        # hosting VM instances only for your specific project. Use sole-tenant nodes to
+        # keep your instances physically separated from instances in other projects, or
+        # to group your instances together on the same host hardware. For more
+        # information, readSole-tenant nodes.
+      "autoscalingPolicy": { # Specifies how autoscaling should behave.
+        "maxNodes": 42, # The maximum number of nodes that the group should have. Must be set if
+            # autoscaling is enabled. Maximum value allowed is 100.
+        "minNodes": 42, # The minimum number of nodes that the group should have.
+        "mode": "A String", # The autoscaling mode. Set to one of: ON, OFF,
+            # or ONLY_SCALE_OUT. For more information, see
+            # Autoscaler modes.
+      },
+      "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",
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#nodeGroup", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.
+      "locationHint": "A String", # An opaque location hint used to place the Node close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+          # The location hint here on the NodeGroup overrides any location_hint
+          # present in the NodeTemplate.
+      "maintenanceInterval": "A String", # Specifies the frequency of planned maintenance events. The accepted values
+          # are: `AS_NEEDED` and `RECURRENT`.
+      "maintenancePolicy": "A String", # Specifies how to handle instances when a node in the group undergoes
+          # maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.
+          # The default value is DEFAULT. For more information, see
+          # Maintenance policies.
+      "maintenanceWindow": { # Time window specified for daily maintenance operations. GCE's internal
+          # maintenance will be performed within this window.
+        "maintenanceDuration": { # A Duration represents a fixed-length span of time represented # Output only. [Output only] A predetermined duration for the window, automatically
+            # chosen to be the smallest possible in the given scenario.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+            # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+            # example, both 13:00-5 and 08:00 are valid.
+      },
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "nodeTemplate": "A String", # URL of the node template to create the node group from.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Share-settings for the node group
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "size": 42, # Output only. [Output Only] The total number of nodes in the node group.
+      "status": "A String",
+      "zone": "A String", # Output only. [Output Only] The name of the zone where the node group resides,
+          # such as us-central1-a.
+    },
+  ],
+  "kind": "compute#nodeGroupList", # Output only. [Output Only] Type of resource.Always compute#nodeGroupList
+      # for lists of node groups.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNodes(project, zone, nodeGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists nodes in the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource whose nodes you want to list. (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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Node resources.
+    {
+      "accelerators": [ # Accelerators for this node.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "consumedResources": { # Output only. Node resources that are reserved by all instances.
+        "guestCpus": 42, # Output only. The number of virtual CPUs that are available to the instance.
+        "localSsdGb": 42, # Output only. The amount of local SSD storage available to the instance,
+            # defined in GiB.
+        "memoryMb": 42, # Output only. The amount of physical memory available to the instance,
+            # defined in MiB.
+        "minNodeCpus": 42, # Output only. The minimal guaranteed number of virtual CPUs that are reserved.
+      },
+      "cpuOvercommitType": "A String", # CPU overcommit.
+      "disks": [ # Local disk configurations.
+        {
+          "diskCount": 42, # Specifies the number of such disks.
+          "diskSizeGb": 42, # Specifies the size of the disk in base-2 GB.
+          "diskType": "A String", # Specifies the desired disk type on the node. This disk type must be a
+              # local storage type (e.g.: local-ssd).
+              # Note that for nodeTemplates, this should be the name of the disk type and
+              # not its URL.
+        },
+      ],
+      "instanceConsumptionData": [ # Output only. Instance data that shows consumed resources on the node.
+        {
+          "consumptionInfo": { # Output only. Resources consumed by the instance.
+            "guestCpus": 42, # Output only. The number of virtual CPUs that are available to the instance.
+            "localSsdGb": 42, # Output only. The amount of local SSD storage available to the instance,
+                # defined in GiB.
+            "memoryMb": 42, # Output only. The amount of physical memory available to the instance,
+                # defined in MiB.
+            "minNodeCpus": 42, # Output only. The minimal guaranteed number of virtual CPUs that are reserved.
+          },
+          "instance": "A String", # Output only. Server-defined URL for the instance.
+        },
+      ],
+      "instances": [ # Instances scheduled on this node.
+        "A String",
+      ],
+      "name": "A String", # The name of the node.
+      "nodeType": "A String", # The type of this node.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "serverBinding": { # Binding properties for the physical server.
+        "type": "A String",
+      },
+      "serverId": "A String", # Server ID associated with this node.
+      "status": "A String",
+      "totalResources": { # Output only. Total amount of available resources on the node.
+        "guestCpus": 42, # Output only. The number of virtual CPUs that are available to the instance.
+        "localSsdGb": 42, # Output only. The amount of local SSD storage available to the instance,
+            # defined in GiB.
+        "memoryMb": 42, # Output only. The amount of physical memory available to the instance,
+            # defined in MiB.
+        "minNodeCpus": 42, # Output only. The minimal guaranteed number of virtual CPUs that are reserved.
+      },
+      "upcomingMaintenance": { # Upcoming Maintenance notification information. # Output only. [Output Only] The information about an upcoming maintenance event.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+  ],
+  "kind": "compute#nodeGroupsListNodes", # Output only. [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the
+      # specified node group.
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listNodes_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, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Updates the specified node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a sole-tenant Node Group resource.
+    # 
+    # A sole-tenant node is a physical server that is dedicated to
+    # hosting VM instances only for your specific project. Use sole-tenant nodes to
+    # keep your instances physically separated from instances in other projects, or
+    # to group your instances together on the same host hardware. For more
+    # information, readSole-tenant nodes.
+  "autoscalingPolicy": { # Specifies how autoscaling should behave.
+    "maxNodes": 42, # The maximum number of nodes that the group should have. Must be set if
+        # autoscaling is enabled. Maximum value allowed is 100.
+    "minNodes": 42, # The minimum number of nodes that the group should have.
+    "mode": "A String", # The autoscaling mode. Set to one of: ON, OFF,
+        # or ONLY_SCALE_OUT. For more information, see
+        # Autoscaler modes.
+  },
+  "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",
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeGroup", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.
+  "locationHint": "A String", # An opaque location hint used to place the Node close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+      # The location hint here on the NodeGroup overrides any location_hint
+      # present in the NodeTemplate.
+  "maintenanceInterval": "A String", # Specifies the frequency of planned maintenance events. The accepted values
+      # are: `AS_NEEDED` and `RECURRENT`.
+  "maintenancePolicy": "A String", # Specifies how to handle instances when a node in the group undergoes
+      # maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.
+      # The default value is DEFAULT. For more information, see
+      # Maintenance policies.
+  "maintenanceWindow": { # Time window specified for daily maintenance operations. GCE's internal
+      # maintenance will be performed within this window.
+    "maintenanceDuration": { # A Duration represents a fixed-length span of time represented # Output only. [Output only] A predetermined duration for the window, automatically
+        # chosen to be the smallest possible in the given scenario.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+        # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+        # example, both 13:00-5 and 08:00 are valid.
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "nodeTemplate": "A String", # URL of the node template to create the node group from.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Share-settings for the node group
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "size": 42, # Output only. [Output Only] The total number of nodes in the node group.
+  "status": "A String",
+  "zone": "A String", # Output only. [Output Only] The name of the zone where the node group resides,
+      # such as us-central1-a.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ performMaintenance(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Perform maintenance on a subset of nodes in the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the node group scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "nodes": [ # [Required] List of nodes affected by the call.
+    "A String",
+  ],
+  "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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).
+}
+
+ +
+ setNodeTemplate(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Updates the node template of the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "nodeTemplate": "A String", # Full or partial URL of the node template resource to be updated for this
+      # node group.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ simulateMaintenanceEvent(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None) + 
Simulates maintenance event on specified nodes from the node group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeGroup: string, Name of the NodeGroup resource whose nodes will go under maintenance
+simulation. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "nodes": [ # Names of the nodes to go under maintenance simulation.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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_preview.nodeTemplates.html b/docs/dyn/compute_preview.nodeTemplates.html new file mode 100644 index 0000000000..36f724e795 --- /dev/null +++ b/docs/dyn/compute_preview.nodeTemplates.html @@ -0,0 +1,2649 @@ + + + +

Compute Engine API . nodeTemplates

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of node templates.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, nodeTemplate, requestId=None, x__xgafv=None)

+

Deletes the specified NodeTemplate resource.

+

+ get(project, region, nodeTemplate, x__xgafv=None)

+

Returns the specified node template.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a NodeTemplate resource in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of node templates available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of node templates.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NodeTemplatesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of node templates.
+      "nodeTemplates": [ # [Output Only] A list of node templates contained in this scope.
+        { # Represent a sole-tenant Node Template resource.
+            #
+            # You can use a template to define properties for nodes in a node group. For
+            # more information, readCreating node groups
+            # and instances.
+          "accelerators": [
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "cpuOvercommitType": "A String", # CPU overcommit.
+          "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.
+          "disks": [
+            {
+              "diskCount": 42, # Specifies the number of such disks.
+              "diskSizeGb": 42, # Specifies the size of the disk in base-2 GB.
+              "diskType": "A String", # Specifies the desired disk type on the node. This disk type must be a
+                  # local storage type (e.g.: local-ssd).
+                  # Note that for nodeTemplates, this should be the name of the disk type and
+                  # not its URL.
+            },
+          ],
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#nodeTemplate", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "nodeAffinityLabels": { # Labels to use for node affinity, which will be used in instance scheduling.
+            "a_key": "A String",
+          },
+          "nodeType": "A String", # The node type to use for nodes group that are created from this template.
+          "nodeTypeFlexibility": { # Do not use. Instead, use the node_type property.
+            "cpus": "A String",
+            "localSsd": "A String",
+            "memory": "A String",
+          },
+          "region": "A String", # Output only. [Output Only] The name of the region where the node template resides,
+              # such as us-central1.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "serverBinding": { # Sets the binding properties for the physical server. Valid values include:
+              #
+              #    - *[Default]* RESTART_NODE_ON_ANY_SERVER:
+              #    Restarts VMs on any available
+              #    physical server
+              #    - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same
+              #    physical server whenever possible
+              #
+              #
+              #
+              # See Sole-tenant
+              # node options for more information.
+            "type": "A String",
+          },
+          "status": "A String", # Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.
+          "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that appears when the node templates
+          # 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#nodeTemplateAggregatedList", # Output only. [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of
+      # node templates.
+  "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, nodeTemplate, requestId=None, x__xgafv=None) + 
Deletes the specified NodeTemplate resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  nodeTemplate: string, Name of the NodeTemplate 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, nodeTemplate, x__xgafv=None) + 
Returns the specified node template.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  nodeTemplate: string, Name of the node template 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:
+
+    { # Represent a sole-tenant Node Template resource.
+    #
+    # You can use a template to define properties for nodes in a node group. For
+    # more information, readCreating node groups
+    # and instances.
+  "accelerators": [
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+  "cpuOvercommitType": "A String", # CPU overcommit.
+  "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.
+  "disks": [
+    {
+      "diskCount": 42, # Specifies the number of such disks.
+      "diskSizeGb": 42, # Specifies the size of the disk in base-2 GB.
+      "diskType": "A String", # Specifies the desired disk type on the node. This disk type must be a
+          # local storage type (e.g.: local-ssd).
+          # Note that for nodeTemplates, this should be the name of the disk type and
+          # not its URL.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeTemplate", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "nodeAffinityLabels": { # Labels to use for node affinity, which will be used in instance scheduling.
+    "a_key": "A String",
+  },
+  "nodeType": "A String", # The node type to use for nodes group that are created from this template.
+  "nodeTypeFlexibility": { # Do not use. Instead, use the node_type property.
+    "cpus": "A String",
+    "localSsd": "A String",
+    "memory": "A String",
+  },
+  "region": "A String", # Output only. [Output Only] The name of the region where the node template resides,
+      # such as us-central1.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "serverBinding": { # Sets the binding properties for the physical server. Valid values include:
+      #
+      #    - *[Default]* RESTART_NODE_ON_ANY_SERVER:
+      #    Restarts VMs on any available
+      #    physical server
+      #    - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same
+      #    physical server whenever possible
+      #
+      #
+      #
+      # See Sole-tenant
+      # node options for more information.
+    "type": "A String",
+  },
+  "status": "A String", # Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a NodeTemplate resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represent a sole-tenant Node Template resource.
+    # 
+    # You can use a template to define properties for nodes in a node group. For
+    # more information, readCreating node groups
+    # and instances.
+  "accelerators": [
+    { # A specification of the type and number of accelerator cards attached to the
+        # instance.
+      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+          # If you are creating an instance template, specify only the
+          # accelerator name.
+          # See GPUs on Compute Engine
+          # for a full list of accelerator types.
+    },
+  ],
+  "cpuOvercommitType": "A String", # CPU overcommit.
+  "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.
+  "disks": [
+    {
+      "diskCount": 42, # Specifies the number of such disks.
+      "diskSizeGb": 42, # Specifies the size of the disk in base-2 GB.
+      "diskType": "A String", # Specifies the desired disk type on the node. This disk type must be a
+          # local storage type (e.g.: local-ssd).
+          # Note that for nodeTemplates, this should be the name of the disk type and
+          # not its URL.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeTemplate", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "nodeAffinityLabels": { # Labels to use for node affinity, which will be used in instance scheduling.
+    "a_key": "A String",
+  },
+  "nodeType": "A String", # The node type to use for nodes group that are created from this template.
+  "nodeTypeFlexibility": { # Do not use. Instead, use the node_type property.
+    "cpus": "A String",
+    "localSsd": "A String",
+    "memory": "A String",
+  },
+  "region": "A String", # Output only. [Output Only] The name of the region where the node template resides,
+      # such as us-central1.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "serverBinding": { # Sets the binding properties for the physical server. Valid values include:
+      # 
+      #    - *[Default]* RESTART_NODE_ON_ANY_SERVER:
+      #    Restarts VMs on any available
+      #    physical server
+      #    - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same
+      #    physical server whenever possible
+      # 
+      # 
+      # 
+      # See Sole-tenant
+      # node options for more information.
+    "type": "A String",
+  },
+  "status": "A String", # Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of node templates available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region 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.
+  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 node templates.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of NodeTemplate resources.
+    { # Represent a sole-tenant Node Template resource.
+        #
+        # You can use a template to define properties for nodes in a node group. For
+        # more information, readCreating node groups
+        # and instances.
+      "accelerators": [
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "cpuOvercommitType": "A String", # CPU overcommit.
+      "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.
+      "disks": [
+        {
+          "diskCount": 42, # Specifies the number of such disks.
+          "diskSizeGb": 42, # Specifies the size of the disk in base-2 GB.
+          "diskType": "A String", # Specifies the desired disk type on the node. This disk type must be a
+              # local storage type (e.g.: local-ssd).
+              # Note that for nodeTemplates, this should be the name of the disk type and
+              # not its URL.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#nodeTemplate", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "nodeAffinityLabels": { # Labels to use for node affinity, which will be used in instance scheduling.
+        "a_key": "A String",
+      },
+      "nodeType": "A String", # The node type to use for nodes group that are created from this template.
+      "nodeTypeFlexibility": { # Do not use. Instead, use the node_type property.
+        "cpus": "A String",
+        "localSsd": "A String",
+        "memory": "A String",
+      },
+      "region": "A String", # Output only. [Output Only] The name of the region where the node template resides,
+          # such as us-central1.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "serverBinding": { # Sets the binding properties for the physical server. Valid values include:
+          #
+          #    - *[Default]* RESTART_NODE_ON_ANY_SERVER:
+          #    Restarts VMs on any available
+          #    physical server
+          #    - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same
+          #    physical server whenever possible
+          #
+          #
+          #
+          # See Sole-tenant
+          # node options for more information.
+        "type": "A String",
+      },
+      "status": "A String", # Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.
+      "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+    },
+  ],
+  "kind": "compute#nodeTemplateList", # Output only. [Output Only] Type of resource.Always compute#nodeTemplateList
+      # for lists of node templates.
+  "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.
+  "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, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.nodeTypes.html b/docs/dyn/compute_preview.nodeTypes.html new file mode 100644 index 0000000000..86dcab1599 --- /dev/null +++ b/docs/dyn/compute_preview.nodeTypes.html @@ -0,0 +1,594 @@ + + + +

Compute Engine API . nodeTypes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of node types.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, nodeType, x__xgafv=None)

+

Returns the specified node type.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of node types available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of node types.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NodeTypesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of node types.
+      "nodeTypes": [ # [Output Only] A list of node types contained in this scope.
+        { # Represent a sole-tenant Node Type resource.
+            #
+            # Each node within a node group must have a node type. A node type specifies
+            # the total amount of cores and memory for that node. Currently, the only
+            # available node type is n1-node-96-624 node type that has 96
+            # vCPUs and 624 GB of memory, available in multiple zones. For more information
+            # readNode types.
+          "cpuPlatform": "A String", # [Output Only] The CPU platform used by this node type.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this node type.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DELETED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DEPRECATED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to OBSOLETE. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+                # The suggested replacement resource must be the same kind of resource as the
+                # deprecated resource.
+            "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+                # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+                # warning indicating the deprecated resource and recommending its
+                # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+          },
+          "description": "A String", # [Output Only] An optional textual description of the resource.
+          "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the node
+              # type.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#nodeType", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeType for node types.
+          "localSsdGb": 42, # [Output Only] Local SSD available to the node type, defined in GB.
+          "maxVms": 42, # Output only. [Output Only] Maximum number of VMs that can be created for this node type.
+          "memoryMb": 42, # [Output Only] The amount of physical memory available to the node type,
+              # defined in MB.
+          "name": "A String", # [Output Only] Name of the resource.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "zone": "A String", # Output only. [Output Only] The name of the zone where the node type resides,
+              # such as us-central1-a.
+        },
+      ],
+      "warning": { # [Output Only] An informational warning that appears when the node types
+          # 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#nodeTypeAggregatedList", # Output only. [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node
+      # types.
+  "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.
+
+ +
+ get(project, zone, nodeType, x__xgafv=None) + 
Returns the specified node type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  nodeType: string, Name of the node type 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:
+
+    { # Represent a sole-tenant Node Type resource.
+    #
+    # Each node within a node group must have a node type. A node type specifies
+    # the total amount of cores and memory for that node. Currently, the only
+    # available node type is n1-node-96-624 node type that has 96
+    # vCPUs and 624 GB of memory, available in multiple zones. For more information
+    # readNode types.
+  "cpuPlatform": "A String", # [Output Only] The CPU platform used by this node type.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this node type.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional textual description of the resource.
+  "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the node
+      # type.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#nodeType", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeType for node types.
+  "localSsdGb": 42, # [Output Only] Local SSD available to the node type, defined in GB.
+  "maxVms": 42, # Output only. [Output Only] Maximum number of VMs that can be created for this node type.
+  "memoryMb": 42, # [Output Only] The amount of physical memory available to the node type,
+      # defined in MB.
+  "name": "A String", # [Output Only] Name of the resource.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "zone": "A String", # Output only. [Output Only] The name of the zone where the node type resides,
+      # such as us-central1-a.
+}
+
+ +
+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of node types available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 node types.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of NodeType resources.
+    { # Represent a sole-tenant Node Type resource.
+        #
+        # Each node within a node group must have a node type. A node type specifies
+        # the total amount of cores and memory for that node. Currently, the only
+        # available node type is n1-node-96-624 node type that has 96
+        # vCPUs and 624 GB of memory, available in multiple zones. For more information
+        # readNode types.
+      "cpuPlatform": "A String", # [Output Only] The CPU platform used by this node type.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this node type.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional textual description of the resource.
+      "guestCpus": 42, # [Output Only] The number of virtual CPUs that are available to the node
+          # type.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#nodeType", # Output only. [Output Only] The type of the resource. Alwayscompute#nodeType for node types.
+      "localSsdGb": 42, # [Output Only] Local SSD available to the node type, defined in GB.
+      "maxVms": 42, # Output only. [Output Only] Maximum number of VMs that can be created for this node type.
+      "memoryMb": 42, # [Output Only] The amount of physical memory available to the node type,
+          # defined in MB.
+      "name": "A String", # [Output Only] Name of the resource.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "zone": "A String", # Output only. [Output Only] The name of the zone where the node type resides,
+          # such as us-central1-a.
+    },
+  ],
+  "kind": "compute#nodeTypeList", # Output only. [Output Only] Type of resource.Always compute#nodeTypeList for
+      # lists of node types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.organizationSecurityPolicies.html b/docs/dyn/compute_preview.organizationSecurityPolicies.html new file mode 100644 index 0000000000..a4f201463e --- /dev/null +++ b/docs/dyn/compute_preview.organizationSecurityPolicies.html @@ -0,0 +1,7479 @@ + + + +

Compute Engine API . organizationSecurityPolicies

+

Instance Methods

+

+ addAssociation(securityPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None)

+

Inserts an association for the specified security policy.

+

+ addRule(securityPolicy, body=None, requestId=None, x__xgafv=None)

+

Inserts a rule into a security policy.

+

+ close()

+

Close httplib2 connections.

+

+ copyRules(securityPolicy, requestId=None, sourceSecurityPolicy=None, x__xgafv=None)

+

Copies rules to the specified security policy.

+

+ delete(securityPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified policy.

+

+ get(securityPolicy, x__xgafv=None)

+

List all of the ordered rules present in a single specified policy.

+

+ getAssociation(securityPolicy, name=None, x__xgafv=None)

+

Gets an association with the specified name.

+

+ getRule(securityPolicy, priority=None, x__xgafv=None)

+

Gets a rule at the specified priority.

+

+ insert(body=None, parentId=None, requestId=None, x__xgafv=None)

+

Creates a new policy in the specified organization using the data included

+

+ list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None)

+

List all the policies that have been configured for the specified

+

+ listAssociations(targetResource=None, x__xgafv=None)

+

Lists associations of a specified target, i.e., organization or folder.

+

+ listPreconfiguredExpressionSets(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None)

+

Gets the current list of preconfigured Web Application Firewall (WAF)

+

+ list_next()

+

Retrieves the next page of results.

+

+ move(securityPolicy, parentId=None, requestId=None, x__xgafv=None)

+

Moves the specified security policy.

+

+ patch(securityPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request.

+

+ patchRule(securityPolicy, body=None, priority=None, requestId=None, x__xgafv=None)

+

Patches a rule at the specified priority.

+

+ removeAssociation(securityPolicy, name=None, requestId=None, x__xgafv=None)

+

Removes an association for the specified security policy.

+

+ removeRule(securityPolicy, priority=None, requestId=None, x__xgafv=None)

+

Deletes a rule at the specified priority.

+

Method Details

+
+ addAssociation(securityPolicy, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None) + 
Inserts an association for the specified security policy.
+
+This has billing implications.  Projects in the hierarchy with effective
+hierarchical security policies will be automatically enrolled into Cloud
+Armor Enterprise if not already enrolled.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.addAssociation
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "attachmentId": "A String", # The resource that the security policy is attached to.
+  "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+  "excludedFolders": [ # A list of folders to exclude from the security policy.
+    "A String",
+  ],
+  "excludedProjects": [ # A list of projects to exclude from the security policy.
+    "A String",
+  ],
+  "name": "A String", # The name for an association.
+  "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+  "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+}
+
+  replaceExistingAssociation: boolean, Indicates whether or not to replace it if an association of the attachment
+already exists. This is false by default, in which case an error will be
+returned if an association already exists.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addRule(securityPolicy, body=None, requestId=None, x__xgafv=None) + 
Inserts a rule into a security policy.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.addRule instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ copyRules(securityPolicy, requestId=None, sourceSecurityPolicy=None, x__xgafv=None) + 
Copies rules to the specified security policy.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.cloneRules
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (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).
+  sourceSecurityPolicy: string, The security policy from which to copy rules.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(securityPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified policy.
+
+Use this API to remove Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to remove firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.delete instead.
+
+Args:
+  securityPolicy: string, Name of the security policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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(securityPolicy, x__xgafv=None) + 
List all of the ordered rules present in a single specified policy.
+
+Use this API to read Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to read firewall policies. This usage is now
+disabled for most organizations. Use firewallPolicies.get instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to get. (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 Google Cloud Armor security policy resource.
+    #
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      #
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      #
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      #
+      #
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      #
+      # Example:
+      #
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+ +
+ getAssociation(securityPolicy, name=None, x__xgafv=None) + 
Gets an association with the specified name.
+
+Use this API to read Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to read firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.getAssociation
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to which the queried rule belongs. (required)
+  name: string, The name of the association to get from the security policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "attachmentId": "A String", # The resource that the security policy is attached to.
+  "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+  "excludedFolders": [ # A list of folders to exclude from the security policy.
+    "A String",
+  ],
+  "excludedProjects": [ # A list of projects to exclude from the security policy.
+    "A String",
+  ],
+  "name": "A String", # The name for an association.
+  "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+  "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+}
+
+ +
+ getRule(securityPolicy, priority=None, x__xgafv=None) + 
Gets a rule at the specified priority.
+
+Use this API to read Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to read firewall policies. This usage is now
+disabled for most organizations. Use firewallPolicies.getRule instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the security policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      #
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      #
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      #
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      #
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      #
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      #
+      # Example:
+      #
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      #
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+ +
+ insert(body=None, parentId=None, requestId=None, x__xgafv=None) + 
Creates a new policy in the specified organization using the data included
+in the request.
+
+Use this API to add Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to add firewall policies. This usage is now
+disabled for most organizations. Use firewallPolicies.insert instead.
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  parentId: string, Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]"
+if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the
+parent is an organization.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None) + 
List all the policies that have been configured for the specified
+organization.
+
+Use this API to read Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to read firewall policies. This usage is now
+disabled for most organizations. Use firewallPolicies.list instead.
+
+Args:
+  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.
+  parentId: string, Parent ID for this request.
+  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 SecurityPolicy resources.
+    { # Represents a Google Cloud Armor security policy resource.
+        #
+        # Only external backend services that use load balancers can
+        # reference a security policy. For more information, see
+        # Google Cloud Armor security policy overview.
+      "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+        "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "ruleVisibility": "A String", # Rule visibility can be one of the following:
+              # STANDARD - opaque rules. (default)
+              # PREMIUM - transparent rules.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+              # customizable thresholds.
+            {
+              "autoDeployConfidenceThreshold": 3.14,
+              "autoDeployExpirationSec": 42,
+              "autoDeployImpactedBaselineThreshold": 3.14,
+              "autoDeployLoadThreshold": 3.14,
+              "detectionAbsoluteQps": 3.14,
+              "detectionLoadThreshold": 3.14,
+              "detectionRelativeToBaselineQps": 3.14,
+              "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+                  # The name must be unique within the security policy.
+              "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+                  # on specified granular traffic units.
+                { # Configurations to specifc granular traffic units processed by
+                    # Adaptive Protection.
+                  "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                      # type constitutes a separate traffic unit.
+                      # It can only be set to true if `value` is empty.
+                  "type": "A String", # Type of this configuration.
+                  "value": "A String", # Requests that match this value constitute a granular traffic unit.
+                },
+              ],
+            },
+          ],
+        },
+      },
+      "advancedOptionsConfig": {
+        "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+            # json_parsing is set to STANDARD.
+          "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+              #
+              # As per RFC 1341, a Content-Type header value has the following format:
+              #
+              # Content-Type := type "/" subtype *[";" parameter]
+              #
+              # When configuring a custom Content-Type header value, only the
+              # type/subtype needs to be specified, and the parameters should be
+              # excluded.
+            "A String",
+          ],
+        },
+        "jsonParsing": "A String",
+        "logLevel": "A String",
+        "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+            # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+            # Values are case insensitive.
+        "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+            # resolving the callers client IP address.
+          "A String",
+        ],
+      },
+      "associations": [ # A list of associations that belong to this policy.
+        {
+          "attachmentId": "A String", # The resource that the security policy is attached to.
+          "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+          "excludedFolders": [ # A list of folders to exclude from the security policy.
+            "A String",
+          ],
+          "excludedProjects": [ # A list of projects to exclude from the security policy.
+            "A String",
+          ],
+          "name": "A String", # The name for an association.
+          "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+          "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "ddosProtectionConfig": {
+        "ddosAdaptiveProtection": "A String",
+        "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+            # builds DDoS mitigations that minimize collateral damage. It quantifies
+            # this as the fraction of a non-abuse baseline that's inadvertently
+            # blocked.
+            #
+            # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+            # not be deployed. Using a lower value will prioritize keeping collateral
+            # damage low, possibly at the cost of its effectiveness in rate limiting
+            # some or all of the attack. It should typically be unset, so Advanced DDoS
+            # (and Adaptive Protection) uses the best mitigation it can find. Setting
+            # the threshold is advised if there are logs for false positive detections
+            # with high collateral damage, and will cause Advanced DDoS to attempt to
+            # find a less aggressive rule that satisfies the constraint. If a suitable
+            # rule cannot be found, the system falls back to either no mitigation for
+            # smaller attacks or broader network throttles for larger ones.
+        "ddosProtection": "A String",
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+      "recaptchaOptionsConfig": {
+        "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+            # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+            # the security policy. The specified site key needs to be created from the
+            # reCAPTCHA API. The user is responsible for the validity of the specified
+            # site key. If not specified, a Google-managed site key is used.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+          # resides. This field is not applicable to global security policies.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule which is a rule with priority
+          # 2147483647 and match all condition (for the match condition this means
+          # match  "*" for srcIpRanges and for the networkMatch condition every field
+          # must be either match "*" or not set). If no rules are provided when
+          # creating a security policy, a default rule with action "allow" will be
+          # added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the rule is matched.
+              # The following are the valid actions:
+              #
+              #    - allow: allow access to target.
+              #    - deny(STATUS): deny access to target, returns the
+              #    HTTP response code specified. Valid values for `STATUS`
+              #    are 403, 404, and 502.
+              #    - rate_based_ban: limit client traffic to the configured
+              #    threshold and ban the client if the traffic exceeds the threshold.
+              #    Configure parameters for this action in RateLimitOptions. Requires
+              #    rate_limit_options to be set.
+              #    - redirect: redirect to a different target. This can
+              #    either be an internal reCAPTCHA redirect, or an external URL-based
+              #    redirect via a 302 response. Parameters for this action can be configured
+              #    via redirectOptions. This action is only supported in Global Security
+              #    Policies of type CLOUD_ARMOR.
+              #    - throttle: limit
+              #    client traffic to the configured threshold. Configure parameters for this
+              #    action in rateLimitOptions. Requires rate_limit_options to be set for
+              #    this.
+              #    - fairshare (preview only): when traffic reaches the
+              #    threshold limit, requests from the clients matching this rule begin to be
+              #    rate-limited using the Fair Share algorithm. This action is only allowed
+              #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "headerAction": { # Optional, additional actions that are performed on headers.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+                # present.
+              {
+                "headerName": "A String", # The name of the header to set.
+                "headerValue": "A String", # The value to set the named header to.
+              },
+            ],
+          },
+          "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "config": { # The configuration options available when specifying versioned_expr.
+                # This field must be specified if versioned_expr is specified and cannot
+                # be specified if versioned_expr is not specified.
+              "srcIpRanges": [ # CIDR IP address range.
+                  # Maximum number of src_ip_ranges allowed is 10.
+                "A String",
+              ],
+            },
+            "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+                # A CEVAL expression is used to specify match criteria such as origin.ip,
+                # source.region_code and contents in the request header.
+                # Expressions containing `evaluateThreatIntelligence` require a Cloud
+                # Armor Enterprise subscription and are not supported in Edge Policies
+                # nor in Regional Policies. Expressions containing
+                # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+                # Enterprise subscription and are only supported in Global Security
+                # 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.
+            },
+            "exprOptions": { # The configuration options available when specifying a user defined
+                # CEVAL expression (i.e., 'expr').
+              "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+                  # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+                "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # action-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+                "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # session-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+              },
+            },
+            "versionedExpr": "A String", # Preconfigured versioned expression.
+                # If this field is specified, config must also be specified.
+                # Available preconfigured expressions along with their requirements are:
+                # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+                # config.
+          },
+          "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+              # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+              # 'action' is enforced.
+              #
+              # The match criteria for a rule consists of built-in match fields (like
+              # 'srcIpRanges') and potentially multiple user-defined match fields
+              # ('userDefinedFields').
+              #
+              # Field values may be extracted directly from the packet or derived from it
+              # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+              # (e.g. 'srcPorts'). A user-defined field is only present if the base
+              # header is found in the packet and the entire field is in bounds.
+              #
+              # Each match field may specify which values can match it, listing one or
+              # more ranges, prefixes, or exact values that are considered a match for
+              # the field. A field value must be present in order to match a specified
+              # match field. If no match values are specified for a match field, then any
+              # field value is considered to match it, and it's not required to be
+              # present. For strings specifying '*' is also equivalent to match all.
+              #
+              # For a packet to match a rule, all specified match fields must match the
+              # corresponding field values derived from the packet.
+              #
+              # Example:
+              #
+              # networkMatch:
+              #   srcIpRanges:
+              #   - "192.0.2.0/24"
+              #   - "198.51.100.0/24"
+              #   userDefinedFields:
+              #   - name: "ipv4_fragment_offset"
+              #     values:
+              #     - "1-0x1fff"
+              #
+              # The above match condition matches packets with a source IP in
+              # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+              # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+              # against.
+            "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+                # format.
+              "A String",
+            ],
+            "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+                # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+                # "253-254"), or one of the following protocol names: "tcp", "udp",
+                # "icmp", "esp", "ah", "ipip", or "sctp".
+              "A String",
+            ],
+            "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+              42,
+            ],
+            "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+              "A String",
+            ],
+            "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+                # IP address.
+              "A String",
+            ],
+            "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+                # matching values for that field.
+              {
+                "name": "A String", # Name of the user-defined field, as given in the definition.
+                "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                    # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                    # range (e.g.  "0x400-0x7ff").
+                  "A String",
+                ],
+              },
+            ],
+          },
+          "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+              # does not evaluate preconfigured WAF rules, i.e., if
+              # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+            "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+              {
+                "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                    # preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                    # from inspection during preconfigured WAF evaluation. Note that the
+                    # parameter can be in the query string or in the POST body.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                    # inspection during preconfigured WAF evaluation. When specifying this
+                    # field, the query or fragment part should be excluded.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                    # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                    # IDs under the WAF rule set.
+                  "A String",
+                ],
+                "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+              },
+            ],
+          },
+          "preview": True or False, # If set to true, the specified action is not enforced.
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+              # "fairshare". Cannot be specified for any other actions.
+            "banDurationSec": 42, # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, determines the time (in seconds)
+                # the traffic will continue to be banned by the rate limit after the
+                # rate falls below the threshold.
+            "banThreshold": { # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, the key will be banned for the
+                # configured 'ban_duration_sec' when the number of requests that exceed
+                # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+            "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+                # threshold. Valid option is "allow" only.
+            "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKey" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the value
+                #    is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of the
+                #    HTTPS request. The key value is truncated to the first 128 bytes. The
+                #    key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the request
+                #    originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration or
+                #    an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #
+                #
+                # For "fairshare" action, this value is limited to ALL i.e. a single rate
+                # limit threshold is enforced for all the requests matching the rule.
+            "enforceOnKeyConfigs": [ # If specified, any combination of values of
+                # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+                # ratelimit threshold/action is enforced. You can specify up to 3
+                # enforce_on_key_configs. If enforce_on_key_configs is specified,
+                # enforce_on_key must not be specified.
+              {
+                "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                    # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                    # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                    # taken as the key value.
+                "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                    # values are:
+                    #
+                    #    - ALL: A single rate limit threshold is applied to all
+                    #    the requests matching this rule. This is the default value if
+                    #    "enforceOnKeyConfigs" is not configured.
+                    #    - IP: The source IP address of
+                    #    the request is the key. Each IP has this limit enforced
+                    #    separately.
+                    #    - HTTP_HEADER: The value of the HTTP
+                    #    header whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the header value. If no
+                    #    such header is present in the request, the key type defaults toALL.
+                    #    - XFF_IP: The first IP address (i.e. the
+                    #    originating client IP address) specified in the list of IPs under
+                    #    X-Forwarded-For HTTP header. If no such header is present or the
+                    #    value is not a valid IP, the key defaults to the source IP address of
+                    #    the request i.e. key type IP.
+                    #    - HTTP_COOKIE: The value of the HTTP
+                    #    cookie whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the cookie value. If no
+                    #    such cookie is present in the request, the key type defaults toALL.
+                    #    - HTTP_PATH: The URL path of the HTTP request. The key
+                    #    value is truncated to the first 128 bytes.
+                    #    - SNI: Server name indication in the TLS session of
+                    #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                    #    The key type defaults to ALL on a HTTP session.
+                    #    - REGION_CODE: The country/region from which the
+                    #    request originates.
+                    #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+                    #    - USER_IP: The IP address of the originating client,
+                    #    which is resolved based on "userIpRequestHeaders" configured with the
+                    #    security policy. If there is no "userIpRequestHeaders" configuration
+                    #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                    #    - ASN: The autonomous system number of the originating
+                    #    client. If not available, the key type defaults toALL.
+                    #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+              },
+            ],
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+                # value.
+                # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+                # value.
+            "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+                # threshold, to either deny with a specified HTTP response code, or
+                # redirect to a different endpoint.
+                # Valid options are `deny(STATUS)`, where valid values for
+                # `STATUS` are 403, 404, 429, and 502, and
+                # `redirect`, where the redirect parameters come from
+                # `exceedRedirectOptions` below.
+                # The `redirect` action is only supported in Global Security Policies of
+                # type CLOUD_ARMOR.
+            "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+                # action. Cannot be specified if the exceed action is not redirect.
+                # This field is only supported in Global Security Policies of type
+                # CLOUD_ARMOR.
+              "target": "A String", # Target for the redirect action. This is required if the type is
+                  # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+              "type": "A String", # Type of the redirect action. Possible values are:
+                  #
+                  #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                  #    challenge assessment.
+                  #    - EXTERNAL_302: redirect to a different URL via a 302
+                  #    response.
+            },
+            "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+          },
+          "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+              # other actions.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "target": "A String", # Target for the redirect action. This is required if the type is
+                # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+            "type": "A String", # Type of the redirect action. Possible values are:
+                #
+                #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                #    challenge assessment.
+                #    - EXTERNAL_302: redirect to a different URL via a 302
+                #    response.
+          },
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "shortName": "A String", # User-provided name of the organization security policy. The name should be
+          # unique in the organization in which the security policy is created. This
+          # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+          # The name must be 1-63 characters long, and comply with
+          # https://www.ietf.org/rfc/rfc1035.txt. 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.
+      "type": "A String", # The type indicates the intended use of the security policy.
+          #
+          #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services.
+          #    They filter requests before they hit the origin servers.
+          #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services
+          #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+          #    They filter requests before the request is served from Google's cache.
+          #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+          #    internal service policies can be configured to filter HTTP requests
+          #    targeting services managed by Traffic Director in a service mesh. They
+          #    filter requests before the request is served from the application.
+          #
+          # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+          # can be configured to filter packets targeting network load balancing
+          # resources such as backend services, target pools, target instances, and
+          # instances with external IPs. They filter requests before the request is
+          # served from the application.
+          #
+          #
+          # This field can be set only at resource creation time.
+      "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+          # user-defined field consists of up to 4 bytes extracted from a fixed offset
+          # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+          # optional mask to select certain bits. Rules may then specify matching
+          # values for these fields.
+          #
+          # Example:
+          #
+          #  userDefinedFields:
+          #  - name: "ipv4_fragment_offset"
+          #    base: IPV4
+          #    offset: 6
+          #    size: 2
+          #    mask: "0x1fff"
+        {
+          "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+              #
+              #    - IPV4: Points to the beginning of the IPv4 header.
+              #    - IPV6: Points to the beginning of the IPv6 header.
+              #    - TCP: Points to the beginning of the TCP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #    - UDP: Points to the beginning of the UDP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #
+              #
+              # required
+          "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+              # before matching. Encoded as a hexadecimal number (starting with "0x").
+              # The last byte of the field (in network byte order) corresponds to the
+              # least significant byte of the mask.
+          "name": "A String", # The name of this field. Must be unique within the policy.
+          "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+              # 'base'.
+          "size": 42, # Size of the field in bytes. Valid values: 1-4.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#securityPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies
+  "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.
+  "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.
+  },
+}
+
+ +
+ listAssociations(targetResource=None, x__xgafv=None) + 
Lists associations of a specified target, i.e., organization or folder.
+
+Use this API to read Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to read firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.listAssociations
+instead.
+
+Args:
+  targetResource: string, The target resource to list associations. It is an organization, or a
+folder.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "associations": [ # A list of associations.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "kind": "compute#organizationSecurityPoliciesListAssociationsResponse", # Output only. [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists
+      # of securityPolicy associations.
+}
+
+ +
+ listPreconfiguredExpressionSets(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, x__xgafv=None) + 
Gets the current list of preconfigured Web Application Firewall (WAF)
+expressions.
+
+Args:
+  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.
+  parentId: string, Parent ID for this request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "preconfiguredExpressionSets": {
+    "wafRules": {
+      "expressionSets": [ # List of entities that are currently supported for WAF rules.
+        {
+          "aliases": [ # A list of alternate IDs. The format should be:
+              # - E.g. XSS-stable
+              # Generic suffix like "stable" is particularly useful if a policy
+              # likes to avail newer set of expressions without having to change
+              # the policy.
+              # A given alias name can't be used for more than one entity set.
+            "A String",
+          ],
+          "expressions": [ # List of available expressions.
+            {
+              "id": "A String", # Expression ID should uniquely identify the origin of the expression.
+                  # E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set
+                  # version 2.9.1 rule id 973337.
+                  # The ID could be used to determine the individual attack definition
+                  # that has been detected. It could also be used to exclude it from
+                  # the policy in case of false positive.
+                  # required
+              "sensitivity": 42, # The sensitivity value associated with the WAF rule ID. This corresponds
+                  # to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for
+                  # opt-in only rules.
+            },
+          ],
+          "id": "A String", # Google specified expression set ID. The format should be:
+              # - E.g. XSS-20170329
+              # required
+        },
+      ],
+    },
+  },
+}
+
+ +
+ 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.
+
+
+ +
+ move(securityPolicy, parentId=None, requestId=None, x__xgafv=None) + 
Moves the specified security policy.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.move instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  parentId: string, The new parent of the security policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patch(securityPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.patch instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(securityPolicy, body=None, priority=None, requestId=None, x__xgafv=None) + 
Patches a rule at the specified priority.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.patchRule
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  priority: integer, The priority of the rule to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeAssociation(securityPolicy, name=None, requestId=None, x__xgafv=None) + 
Removes an association for the specified security policy.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.removeAssociation
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  name: string, Name for the attachment that will be removed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(securityPolicy, priority=None, requestId=None, x__xgafv=None) + 
Deletes a rule at the specified priority.
+
+Use this API to modify Cloud Armor policies. Previously, alpha and beta
+versions of this API were used to modify firewall policies. This usage is
+now disabled for most organizations. Use firewallPolicies.removeRule
+instead.
+
+Args:
+  securityPolicy: string, Name of the security policy to update. (required)
+  priority: integer, The priority of the rule to remove from the security policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.packetMirrorings.html b/docs/dyn/compute_preview.packetMirrorings.html new file mode 100644 index 0000000000..e121d7bf7b --- /dev/null +++ b/docs/dyn/compute_preview.packetMirrorings.html @@ -0,0 +1,1934 @@ + + + +

Compute Engine API . packetMirrorings

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of packetMirrorings.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, packetMirroring, requestId=None, x__xgafv=None)

+

Deletes the specified PacketMirroring resource.

+

+ get(project, region, packetMirroring, x__xgafv=None)

+

Returns the specified PacketMirroring resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a PacketMirroring resource in the specified project and region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of PacketMirroring resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, packetMirroring, body=None, requestId=None, x__xgafv=None)

+

Patches the specified PacketMirroring resource with the data included in

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of packetMirrorings.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 packetMirrorings.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of PacketMirroring resources.
+    "a_key": { # Name of the scope containing this set of packetMirrorings.
+      "packetMirrorings": [ # A list of packetMirrorings contained in this scope.
+        { # Represents a Packet Mirroring resource.
+            #
+            # Packet Mirroring clones the traffic of specified instances in your Virtual
+            # Private Cloud (VPC) network and forwards it to a collector destination,
+            # such as an instance group of an internal TCP/UDP load balancer, for analysis
+            # or examination.
+            # For more information about setting up Packet Mirroring, seeUsing Packet Mirroring.
+          "collectorIlb": { # The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector
+              # for mirrored traffic.
+              # The specified forwarding rule must have isMirroringCollector
+              # set to true.
+            "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the forwarding rule; defined by the
+                # server.
+            "url": "A String", # Resource URL to the forwarding rule representing the ILB
+                # configured as destination of the mirrored traffic.
+          },
+          "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.
+          "enable": "A String", # Indicates whether or not this packet mirroring takes effect.
+              # If set to FALSE, this packet mirroring policy will not be enforced on the
+              # network.
+              #
+              # The default is TRUE.
+          "filter": { # Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.
+            "IPProtocols": [ # Protocols that apply as filter on mirrored traffic.
+                # If no protocols are specified, all traffic that matches the specified
+                # CIDR ranges is mirrored.
+                # If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is
+                # mirrored.
+              "A String",
+            ],
+            "cidrRanges": [ # One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source
+                # (ingress) or destination (egress) IP in the IP header. If no ranges are
+                # specified, all IPv4 traffic that matches the specified IPProtocols is
+                # mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4
+                # traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use
+                # "0.0.0.0/0,::/0".
+              "A String",
+            ],
+            "direction": "A String", # Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.
+                # The default is BOTH.
+          },
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#packetMirroring", # Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.
+          "mirroredResources": { # PacketMirroring mirroredResourceInfos.
+              # MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks
+              # and/or tags for which traffic from/to all VM instances will be mirrored.
+            "instances": [ # A set of virtual machine instances that are being mirrored.
+                # They must live in zones contained in the same region as this
+                # packetMirroring.
+                #
+                # Note that this config will apply only to those network interfaces of the
+                # Instances that belong to the network specified in this packetMirroring.
+                #
+                # You may specify a maximum of 50 Instances.
+              {
+                "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the instance; defined by the
+                    # server.
+                "url": "A String", # Resource URL to the virtual machine instance which is being mirrored.
+              },
+            ],
+            "subnetworks": [ # A set of subnetworks for which traffic from/to all VM instances will be
+                # mirrored. They must live in the same region as this packetMirroring.
+                #
+                # You may specify a maximum of 5 subnetworks.
+              {
+                "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the subnetwork; defined by the
+                    # server.
+                "url": "A String", # Resource URL to the subnetwork for which
+                    # traffic from/to all VM instances will be mirrored.
+              },
+            ],
+            "tags": [ # A set of mirrored tags. Traffic from/to all VM instances that have one or
+                # more of these tags will be mirrored.
+              "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.
+          "network": { # Specifies the mirrored VPC network. Only packets in this network will be
+              # mirrored. All mirrored VMs should have a NIC in the given network.
+              # All mirrored subnetworks should belong to the given network.
+            "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the network; defined by the server.
+            "url": "A String", # URL of the network resource.
+          },
+          "priority": 42, # The priority of applying this configuration. Priority is used to break ties
+              # in cases where there is more than one matching rule. In the case of two
+              # rules that apply for a given Instance, the one with the lowest-numbered
+              # priority value wins.
+              #
+              # Default value is 1000. Valid range is 0 through 65535.
+          "region": "A String", # [Output Only] URI of the region where the packetMirroring resides.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of packetMirrorings 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#packetMirroringAggregatedList", # 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, packetMirroring, requestId=None, x__xgafv=None) + 
Deletes the specified PacketMirroring resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  packetMirroring: string, Name of the PacketMirroring 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, packetMirroring, x__xgafv=None) + 
Returns the specified PacketMirroring resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  packetMirroring: string, Name of the PacketMirroring 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 Packet Mirroring resource.
+    #
+    # Packet Mirroring clones the traffic of specified instances in your Virtual
+    # Private Cloud (VPC) network and forwards it to a collector destination,
+    # such as an instance group of an internal TCP/UDP load balancer, for analysis
+    # or examination.
+    # For more information about setting up Packet Mirroring, seeUsing Packet Mirroring.
+  "collectorIlb": { # The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector
+      # for mirrored traffic.
+      # The specified forwarding rule must have isMirroringCollector
+      # set to true.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the forwarding rule; defined by the
+        # server.
+    "url": "A String", # Resource URL to the forwarding rule representing the ILB
+        # configured as destination of the mirrored traffic.
+  },
+  "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.
+  "enable": "A String", # Indicates whether or not this packet mirroring takes effect.
+      # If set to FALSE, this packet mirroring policy will not be enforced on the
+      # network.
+      #
+      # The default is TRUE.
+  "filter": { # Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.
+    "IPProtocols": [ # Protocols that apply as filter on mirrored traffic.
+        # If no protocols are specified, all traffic that matches the specified
+        # CIDR ranges is mirrored.
+        # If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is
+        # mirrored.
+      "A String",
+    ],
+    "cidrRanges": [ # One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source
+        # (ingress) or destination (egress) IP in the IP header. If no ranges are
+        # specified, all IPv4 traffic that matches the specified IPProtocols is
+        # mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4
+        # traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use
+        # "0.0.0.0/0,::/0".
+      "A String",
+    ],
+    "direction": "A String", # Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.
+        # The default is BOTH.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#packetMirroring", # Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.
+  "mirroredResources": { # PacketMirroring mirroredResourceInfos.
+      # MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks
+      # and/or tags for which traffic from/to all VM instances will be mirrored.
+    "instances": [ # A set of virtual machine instances that are being mirrored.
+        # They must live in zones contained in the same region as this
+        # packetMirroring.
+        #
+        # Note that this config will apply only to those network interfaces of the
+        # Instances that belong to the network specified in this packetMirroring.
+        #
+        # You may specify a maximum of 50 Instances.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the instance; defined by the
+            # server.
+        "url": "A String", # Resource URL to the virtual machine instance which is being mirrored.
+      },
+    ],
+    "subnetworks": [ # A set of subnetworks for which traffic from/to all VM instances will be
+        # mirrored. They must live in the same region as this packetMirroring.
+        #
+        # You may specify a maximum of 5 subnetworks.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the subnetwork; defined by the
+            # server.
+        "url": "A String", # Resource URL to the subnetwork for which
+            # traffic from/to all VM instances will be mirrored.
+      },
+    ],
+    "tags": [ # A set of mirrored tags. Traffic from/to all VM instances that have one or
+        # more of these tags will be mirrored.
+      "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.
+  "network": { # Specifies the mirrored VPC network. Only packets in this network will be
+      # mirrored. All mirrored VMs should have a NIC in the given network.
+      # All mirrored subnetworks should belong to the given network.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the network; defined by the server.
+    "url": "A String", # URL of the network resource.
+  },
+  "priority": 42, # The priority of applying this configuration. Priority is used to break ties
+      # in cases where there is more than one matching rule. In the case of two
+      # rules that apply for a given Instance, the one with the lowest-numbered
+      # priority value wins.
+      #
+      # Default value is 1000. Valid range is 0 through 65535.
+  "region": "A String", # [Output Only] URI of the region where the packetMirroring resides.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a PacketMirroring resource in the specified project and region
+using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Packet Mirroring resource.
+    # 
+    # Packet Mirroring clones the traffic of specified instances in your Virtual
+    # Private Cloud (VPC) network and forwards it to a collector destination,
+    # such as an instance group of an internal TCP/UDP load balancer, for analysis
+    # or examination.
+    # For more information about setting up Packet Mirroring, seeUsing Packet Mirroring.
+  "collectorIlb": { # The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector
+      # for mirrored traffic.
+      # The specified forwarding rule must have isMirroringCollector
+      # set to true.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the forwarding rule; defined by the
+        # server.
+    "url": "A String", # Resource URL to the forwarding rule representing the ILB
+        # configured as destination of the mirrored traffic.
+  },
+  "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.
+  "enable": "A String", # Indicates whether or not this packet mirroring takes effect.
+      # If set to FALSE, this packet mirroring policy will not be enforced on the
+      # network.
+      # 
+      # The default is TRUE.
+  "filter": { # Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.
+    "IPProtocols": [ # Protocols that apply as filter on mirrored traffic.
+        # If no protocols are specified, all traffic that matches the specified
+        # CIDR ranges is mirrored.
+        # If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is
+        # mirrored.
+      "A String",
+    ],
+    "cidrRanges": [ # One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source
+        # (ingress) or destination (egress) IP in the IP header. If no ranges are
+        # specified, all IPv4 traffic that matches the specified IPProtocols is
+        # mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4
+        # traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use
+        # "0.0.0.0/0,::/0".
+      "A String",
+    ],
+    "direction": "A String", # Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.
+        # The default is BOTH.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#packetMirroring", # Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.
+  "mirroredResources": { # PacketMirroring mirroredResourceInfos.
+      # MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks
+      # and/or tags for which traffic from/to all VM instances will be mirrored.
+    "instances": [ # A set of virtual machine instances that are being mirrored.
+        # They must live in zones contained in the same region as this
+        # packetMirroring.
+        #
+        # Note that this config will apply only to those network interfaces of the
+        # Instances that belong to the network specified in this packetMirroring.
+        #
+        # You may specify a maximum of 50 Instances.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the instance; defined by the
+            # server.
+        "url": "A String", # Resource URL to the virtual machine instance which is being mirrored.
+      },
+    ],
+    "subnetworks": [ # A set of subnetworks for which traffic from/to all VM instances will be
+        # mirrored. They must live in the same region as this packetMirroring.
+        #
+        # You may specify a maximum of 5 subnetworks.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the subnetwork; defined by the
+            # server.
+        "url": "A String", # Resource URL to the subnetwork for which
+            # traffic from/to all VM instances will be mirrored.
+      },
+    ],
+    "tags": [ # A set of mirrored tags. Traffic from/to all VM instances that have one or
+        # more of these tags will be mirrored.
+      "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.
+  "network": { # Specifies the mirrored VPC network. Only packets in this network will be
+      # mirrored. All mirrored VMs should have a NIC in the given network.
+      # All mirrored subnetworks should belong to the given network.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the network; defined by the server.
+    "url": "A String", # URL of the network resource.
+  },
+  "priority": 42, # The priority of applying this configuration. Priority is used to break ties
+      # in cases where there is more than one matching rule. In the case of two
+      # rules that apply for a given Instance, the one with the lowest-numbered
+      # priority value wins.
+      # 
+      # Default value is 1000. Valid range is 0 through 65535.
+  "region": "A String", # [Output Only] URI of the region where the packetMirroring resides.
+  "selfLink": "A String", # Output only. [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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of PacketMirroring resources available to the specified
+project and region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 PacketMirroring resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of PacketMirroring resources.
+    { # Represents a Packet Mirroring resource.
+        #
+        # Packet Mirroring clones the traffic of specified instances in your Virtual
+        # Private Cloud (VPC) network and forwards it to a collector destination,
+        # such as an instance group of an internal TCP/UDP load balancer, for analysis
+        # or examination.
+        # For more information about setting up Packet Mirroring, seeUsing Packet Mirroring.
+      "collectorIlb": { # The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector
+          # for mirrored traffic.
+          # The specified forwarding rule must have isMirroringCollector
+          # set to true.
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the forwarding rule; defined by the
+            # server.
+        "url": "A String", # Resource URL to the forwarding rule representing the ILB
+            # configured as destination of the mirrored traffic.
+      },
+      "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.
+      "enable": "A String", # Indicates whether or not this packet mirroring takes effect.
+          # If set to FALSE, this packet mirroring policy will not be enforced on the
+          # network.
+          #
+          # The default is TRUE.
+      "filter": { # Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.
+        "IPProtocols": [ # Protocols that apply as filter on mirrored traffic.
+            # If no protocols are specified, all traffic that matches the specified
+            # CIDR ranges is mirrored.
+            # If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is
+            # mirrored.
+          "A String",
+        ],
+        "cidrRanges": [ # One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source
+            # (ingress) or destination (egress) IP in the IP header. If no ranges are
+            # specified, all IPv4 traffic that matches the specified IPProtocols is
+            # mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4
+            # traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use
+            # "0.0.0.0/0,::/0".
+          "A String",
+        ],
+        "direction": "A String", # Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.
+            # The default is BOTH.
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#packetMirroring", # Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.
+      "mirroredResources": { # PacketMirroring mirroredResourceInfos.
+          # MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks
+          # and/or tags for which traffic from/to all VM instances will be mirrored.
+        "instances": [ # A set of virtual machine instances that are being mirrored.
+            # They must live in zones contained in the same region as this
+            # packetMirroring.
+            #
+            # Note that this config will apply only to those network interfaces of the
+            # Instances that belong to the network specified in this packetMirroring.
+            #
+            # You may specify a maximum of 50 Instances.
+          {
+            "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the instance; defined by the
+                # server.
+            "url": "A String", # Resource URL to the virtual machine instance which is being mirrored.
+          },
+        ],
+        "subnetworks": [ # A set of subnetworks for which traffic from/to all VM instances will be
+            # mirrored. They must live in the same region as this packetMirroring.
+            #
+            # You may specify a maximum of 5 subnetworks.
+          {
+            "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the subnetwork; defined by the
+                # server.
+            "url": "A String", # Resource URL to the subnetwork for which
+                # traffic from/to all VM instances will be mirrored.
+          },
+        ],
+        "tags": [ # A set of mirrored tags. Traffic from/to all VM instances that have one or
+            # more of these tags will be mirrored.
+          "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.
+      "network": { # Specifies the mirrored VPC network. Only packets in this network will be
+          # mirrored. All mirrored VMs should have a NIC in the given network.
+          # All mirrored subnetworks should belong to the given network.
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the network; defined by the server.
+        "url": "A String", # URL of the network resource.
+      },
+      "priority": 42, # The priority of applying this configuration. Priority is used to break ties
+          # in cases where there is more than one matching rule. In the case of two
+          # rules that apply for a given Instance, the one with the lowest-numbered
+          # priority value wins.
+          #
+          # Default value is 1000. Valid range is 0 through 65535.
+      "region": "A String", # [Output Only] URI of the region where the packetMirroring resides.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+    },
+  ],
+  "kind": "compute#packetMirroringList", # Output only. [Output Only] Type of resource. Always compute#packetMirroring
+      # for packetMirrorings.
+  "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.
+  "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, packetMirroring, body=None, requestId=None, x__xgafv=None) + 
Patches the specified PacketMirroring 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)
+  packetMirroring: string, Name of the PacketMirroring resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Packet Mirroring resource.
+    # 
+    # Packet Mirroring clones the traffic of specified instances in your Virtual
+    # Private Cloud (VPC) network and forwards it to a collector destination,
+    # such as an instance group of an internal TCP/UDP load balancer, for analysis
+    # or examination.
+    # For more information about setting up Packet Mirroring, seeUsing Packet Mirroring.
+  "collectorIlb": { # The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector
+      # for mirrored traffic.
+      # The specified forwarding rule must have isMirroringCollector
+      # set to true.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the forwarding rule; defined by the
+        # server.
+    "url": "A String", # Resource URL to the forwarding rule representing the ILB
+        # configured as destination of the mirrored traffic.
+  },
+  "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.
+  "enable": "A String", # Indicates whether or not this packet mirroring takes effect.
+      # If set to FALSE, this packet mirroring policy will not be enforced on the
+      # network.
+      # 
+      # The default is TRUE.
+  "filter": { # Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.
+    "IPProtocols": [ # Protocols that apply as filter on mirrored traffic.
+        # If no protocols are specified, all traffic that matches the specified
+        # CIDR ranges is mirrored.
+        # If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is
+        # mirrored.
+      "A String",
+    ],
+    "cidrRanges": [ # One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source
+        # (ingress) or destination (egress) IP in the IP header. If no ranges are
+        # specified, all IPv4 traffic that matches the specified IPProtocols is
+        # mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4
+        # traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use
+        # "0.0.0.0/0,::/0".
+      "A String",
+    ],
+    "direction": "A String", # Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.
+        # The default is BOTH.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#packetMirroring", # Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.
+  "mirroredResources": { # PacketMirroring mirroredResourceInfos.
+      # MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks
+      # and/or tags for which traffic from/to all VM instances will be mirrored.
+    "instances": [ # A set of virtual machine instances that are being mirrored.
+        # They must live in zones contained in the same region as this
+        # packetMirroring.
+        #
+        # Note that this config will apply only to those network interfaces of the
+        # Instances that belong to the network specified in this packetMirroring.
+        #
+        # You may specify a maximum of 50 Instances.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the instance; defined by the
+            # server.
+        "url": "A String", # Resource URL to the virtual machine instance which is being mirrored.
+      },
+    ],
+    "subnetworks": [ # A set of subnetworks for which traffic from/to all VM instances will be
+        # mirrored. They must live in the same region as this packetMirroring.
+        #
+        # You may specify a maximum of 5 subnetworks.
+      {
+        "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the subnetwork; defined by the
+            # server.
+        "url": "A String", # Resource URL to the subnetwork for which
+            # traffic from/to all VM instances will be mirrored.
+      },
+    ],
+    "tags": [ # A set of mirrored tags. Traffic from/to all VM instances that have one or
+        # more of these tags will be mirrored.
+      "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.
+  "network": { # Specifies the mirrored VPC network. Only packets in this network will be
+      # mirrored. All mirrored VMs should have a NIC in the given network.
+      # All mirrored subnetworks should belong to the given network.
+    "canonicalUrl": "A String", # Output only. [Output Only] Unique identifier for the network; defined by the server.
+    "url": "A String", # URL of the network resource.
+  },
+  "priority": 42, # The priority of applying this configuration. Priority is used to break ties
+      # in cases where there is more than one matching rule. In the case of two
+      # rules that apply for a given Instance, the one with the lowest-numbered
+      # priority value wins.
+      # 
+      # Default value is 1000. Valid range is 0 through 65535.
+  "region": "A String", # [Output Only] URI of the region where the packetMirroring resides.
+  "selfLink": "A String", # Output only. [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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.previewFeatures.html b/docs/dyn/compute_preview.previewFeatures.html new file mode 100644 index 0000000000..1add07b867 --- /dev/null +++ b/docs/dyn/compute_preview.previewFeatures.html @@ -0,0 +1,736 @@ + + + +

Compute Engine API . previewFeatures

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, previewFeature, x__xgafv=None)

+

Returns the details of the given PreviewFeature.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Returns the details of the given PreviewFeature.

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, previewFeature, body=None, requestId=None, x__xgafv=None)

+

Patches the given PreviewFeature. This method is used to enable or disable

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, previewFeature, x__xgafv=None) + 
Returns the details of the given PreviewFeature.
+
+Args:
+  project: string, Project ID for this request. (required)
+  previewFeature: string, Name of the PreviewFeature for this request. (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 single Google Compute Engine preview feature.
+  "activationStatus": "A String", # Specifies whether the feature is enabled or disabled.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Output only. [Output Only] Description of the feature.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#previewFeature", # Output only. [Output only] The type of the feature. Always "compute#previewFeature" for
+      # preview features.
+  "name": "A String", # Name of the feature.
+  "rolloutOperation": { # Represents the rollout operation # Rollout operation of the feature.
+    "rolloutInput": { # Represents the input for the rollout operation. # Input only. The input for the rollout operation.
+      "name": "A String", # The name of the rollout plan
+          # Ex.
+          # organizations//locations/global/rolloutPlans/
+          # Ex.
+          # folders//locations/global/rolloutPlans/
+          # Ex.
+          # projects//locations/global/rolloutPlans/.
+      "predefinedRolloutPlan": "A String", # Predefined rollout plan.
+    },
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "status": { # [Output Only] The status of the feature. # Output only. [Output only] Status of the feature.
+    "description": "A String", # Output only. [Output Only] The description of the feature.
+    "helpLink": "A String", # Output only. [Output Only] Link to the public documentation for the feature.
+    "releaseStatus": { # [Output Only] The release status of the feature.
+      "stage": "A String", # Output only. [Output Only] The stage of the feature.
+      "updateDate": { # Represents a whole or partial calendar date, such as a birthday. The time of # Output only. The last date when a feature transitioned between ReleaseStatuses.
+          # day and time zone are either specified elsewhere or are insignificant. The
+          # date is relative to the Gregorian Calendar. This can represent one of the
+          # following:
+          #
+          # * A full date, with non-zero year, month, and day values.
+          # * A month and day, with a zero year (for example, an anniversary).
+          # * A year on its own, with a zero month and a zero day.
+          # * A year and month, with a zero day (for example, a credit card expiration
+          #   date).
+          #
+          # Related types:
+          #
+          # * google.type.TimeOfDay
+          # * google.type.DateTime
+          # * google.protobuf.Timestamp
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+            # to specify a year by itself or a year and month where the day isn't
+            # significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+            # month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+            # a year.
+      },
+    },
+  },
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Returns the details of the given PreviewFeature.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of PreviewFeature resources.
+    { # Represents a single Google Compute Engine preview feature.
+      "activationStatus": "A String", # Specifies whether the feature is enabled or disabled.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # Output only. [Output Only] Description of the feature.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#previewFeature", # Output only. [Output only] The type of the feature. Always "compute#previewFeature" for
+          # preview features.
+      "name": "A String", # Name of the feature.
+      "rolloutOperation": { # Represents the rollout operation # Rollout operation of the feature.
+        "rolloutInput": { # Represents the input for the rollout operation. # Input only. The input for the rollout operation.
+          "name": "A String", # The name of the rollout plan
+              # Ex.
+              # organizations//locations/global/rolloutPlans/
+              # Ex.
+              # folders//locations/global/rolloutPlans/
+              # Ex.
+              # projects//locations/global/rolloutPlans/.
+          "predefinedRolloutPlan": "A String", # Predefined rollout plan.
+        },
+      },
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "status": { # [Output Only] The status of the feature. # Output only. [Output only] Status of the feature.
+        "description": "A String", # Output only. [Output Only] The description of the feature.
+        "helpLink": "A String", # Output only. [Output Only] Link to the public documentation for the feature.
+        "releaseStatus": { # [Output Only] The release status of the feature.
+          "stage": "A String", # Output only. [Output Only] The stage of the feature.
+          "updateDate": { # Represents a whole or partial calendar date, such as a birthday. The time of # Output only. The last date when a feature transitioned between ReleaseStatuses.
+              # day and time zone are either specified elsewhere or are insignificant. The
+              # date is relative to the Gregorian Calendar. This can represent one of the
+              # following:
+              #
+              # * A full date, with non-zero year, month, and day values.
+              # * A month and day, with a zero year (for example, an anniversary).
+              # * A year on its own, with a zero month and a zero day.
+              # * A year and month, with a zero day (for example, a credit card expiration
+              #   date).
+              #
+              # Related types:
+              #
+              # * google.type.TimeOfDay
+              # * google.type.DateTime
+              # * google.protobuf.Timestamp
+            "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+                # to specify a year by itself or a year and month where the day isn't
+                # significant.
+            "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+                # month and day.
+            "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+                # a year.
+          },
+        },
+      },
+    },
+  ],
+  "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.
+
+
+ +
+ update(project, previewFeature, body=None, requestId=None, x__xgafv=None) + 
Patches the given PreviewFeature. This method is used to enable or disable
+a PreviewFeature.
+
+Args:
+  project: string, Project ID for this request. (required)
+  previewFeature: string, Name of the PreviewFeature for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a single Google Compute Engine preview feature.
+  "activationStatus": "A String", # Specifies whether the feature is enabled or disabled.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Output only. [Output Only] Description of the feature.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#previewFeature", # Output only. [Output only] The type of the feature. Always "compute#previewFeature" for
+      # preview features.
+  "name": "A String", # Name of the feature.
+  "rolloutOperation": { # Represents the rollout operation # Rollout operation of the feature.
+    "rolloutInput": { # Represents the input for the rollout operation. # Input only. The input for the rollout operation.
+      "name": "A String", # The name of the rollout plan
+          # Ex.
+          # organizations//locations/global/rolloutPlans/
+          # Ex.
+          # folders//locations/global/rolloutPlans/
+          # Ex.
+          # projects//locations/global/rolloutPlans/.
+      "predefinedRolloutPlan": "A String", # Predefined rollout plan.
+    },
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "status": { # [Output Only] The status of the feature. # Output only. [Output only] Status of the feature.
+    "description": "A String", # Output only. [Output Only] The description of the feature.
+    "helpLink": "A String", # Output only. [Output Only] Link to the public documentation for the feature.
+    "releaseStatus": { # [Output Only] The release status of the feature.
+      "stage": "A String", # Output only. [Output Only] The stage of the feature.
+      "updateDate": { # Represents a whole or partial calendar date, such as a birthday. The time of # Output only. The last date when a feature transitioned between ReleaseStatuses.
+          # day and time zone are either specified elsewhere or are insignificant. The
+          # date is relative to the Gregorian Calendar. This can represent one of the
+          # following:
+          #
+          # * A full date, with non-zero year, month, and day values.
+          # * A month and day, with a zero year (for example, an anniversary).
+          # * A year on its own, with a zero month and a zero day.
+          # * A year and month, with a zero day (for example, a credit card expiration
+          #   date).
+          #
+          # Related types:
+          #
+          # * google.type.TimeOfDay
+          # * google.type.DateTime
+          # * google.protobuf.Timestamp
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+            # to specify a year by itself or a year and month where the day isn't
+            # significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+            # month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+            # a year.
+      },
+    },
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.projectViews.html b/docs/dyn/compute_preview.projectViews.html new file mode 100644 index 0000000000..0bd3d017bf --- /dev/null +++ b/docs/dyn/compute_preview.projectViews.html @@ -0,0 +1,206 @@ + + + +

Compute Engine API . projectViews

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, x__xgafv=None)

+

Returns the specified global ProjectViews resource, with a regional

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, x__xgafv=None) + 
Returns the specified global ProjectViews resource, with a regional
+context.
+This regional API endpoint reads resource metadata from regional
+read-only replicas. Because changes are copied to these regional replicas
+asynchronously, for real-time resource reads or any write operations
+(creating, updating, or deleting resources), use the global
+[projects.get](https://cloud.google.com/compute/docs/reference/rest/v1/projects/get)
+endpoint.
+
+Args:
+  project: string, Required. Project ID for this request. This is part of the URL path. (required)
+  region: string, Required. Name of the region for this request. This is part of the URL path. (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 ProjectView resource.
+    #
+    # A ProjectView resource contains read-only project data which is available
+    # globally.
+  "project": { # Represents a Project resource. # The project data.
+      # The returned Project data does not contain regional or zonal quota
+      # usage data. Global quota limits are present. For accurate, real-time quota
+      # usage numbers, query the global
+      # [projects.get](https://cloud.google.com/compute/docs/reference/rest/v1/projects/get)
+      # endpoint.
+      #
+      # A project is used to organize resources in a Google Cloud Platform
+      # environment. For more information, read about the
+      # Resource Hierarchy.
+    "cloudArmorTier": "A String", # Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the
+        # following values: CA_STANDARD,CA_ENTERPRISE_PAYGO.
+        #
+        # If this field is not specified, it is assumed to beCA_STANDARD.
+    "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this
+        # project. See Custom
+        # metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+        # text format.
+    "defaultNetworkTier": "A String", # This signifies the default network tier used for configuring resources of
+        # the project and can only take the following values:PREMIUM, STANDARD. Initially the default network
+        # tier is PREMIUM.
+    "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+    "description": "A String", # An optional textual description of the resource.
+    "enabledFeatures": [ # An optional list of restricted features enabled for use on this project.
+      "A String",
+    ],
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server. This is *not* the project ID, and is
+        # just a unique ID used by Compute Engine to identify resources.
+    "kind": "compute#project", # Output only. [Output Only] Type of the resource. Always compute#project for
+        # projects.
+    "name": "A String", # The project ID. For example: my-example-project. Use the
+        # project ID to make requests to Compute Engine.
+    "quotas": [ # [Output Only] Quotas assigned to this project.
+      { # A quotas entry.
+        "limit": 3.14, # [Output Only] Quota limit for this metric.
+        "metric": "A String", # [Output Only] Name of the quota metric.
+        "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+            # is applied.
+        "usage": 3.14, # [Output Only] Current usage of this metric.
+      },
+    ],
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage # An optional naming prefix for daily usage reports and the Google Cloud
+        # Storage bucket where they are stored.
+        # report. Contains bucket_name and report_name prefix.
+      "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report
+          # object is stored. The Google Service Account is granted write access to
+          # this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://
+          # or https://storage.googleapis.com/ in front of it, such
+          # as gs://example-bucket.
+      "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.
+          # If you supply a prefix, it should conform to Cloud Storageobject naming
+          # conventions.
+    },
+    "vmDnsSetting": "A String", # Output only. [Output Only] Default internal DNS setting used by VMs running in
+        # this project.
+    "xpnProjectStatus": "A String", # [Output Only] The role this project has in a shared VPC configuration.
+        # Currently, only projects with the host role, which is specified by the
+        # value HOST, are differentiated.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.projects.html b/docs/dyn/compute_preview.projects.html new file mode 100644 index 0000000000..ffe894506e --- /dev/null +++ b/docs/dyn/compute_preview.projects.html @@ -0,0 +1,3874 @@ + + + +

Compute Engine API . projects

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ disableXpnHost(project, requestId=None, x__xgafv=None)

+

Disable this project as a shared VPC host project.

+

+ disableXpnResource(project, body=None, requestId=None, x__xgafv=None)

+

Disable a service resource (also known as service project) associated with

+

+ enableXpnHost(project, requestId=None, x__xgafv=None)

+

Enable this project as a shared VPC host project.

+

+ enableXpnResource(project, body=None, requestId=None, x__xgafv=None)

+

Enable service resource (a.k.a service project) for a host project, so that

+

+ get(project, x__xgafv=None)

+

Returns the specified Project resource.

+

+ getXpnHost(project, x__xgafv=None)

+

Gets the shared VPC host project that this project links to. May be empty

+

+ getXpnResources(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Gets service resources (a.k.a service project) associated with this host

+

+ getXpnResources_next()

+

Retrieves the next page of results.

+

+ listXpnHosts(project, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all shared VPC host projects visible to the user in an organization.

+

+ listXpnHosts_next()

+

Retrieves the next page of results.

+

+ moveDisk(project, body=None, requestId=None, x__xgafv=None)

+

Moves a persistent disk from one zone to another.

+

+ moveInstance(project, body=None, requestId=None, x__xgafv=None)

+

Moves an instance and its attached persistent disks from one zone to

+

+ setCloudArmorTier(project, body=None, requestId=None, x__xgafv=None)

+

Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the

+

+ setCommonInstanceMetadata(project, body=None, requestId=None, x__xgafv=None)

+

Sets metadata common to all instances within the specified project using

+

+ setDefaultNetworkTier(project, body=None, requestId=None, x__xgafv=None)

+

Sets the default network tier of the project. The default network tier is

+

+ setUsageExportBucket(project, body=None, requestId=None, x__xgafv=None)

+

Enables the usage export feature and sets theusage export bucket

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ disableXpnHost(project, requestId=None, x__xgafv=None) + 
Disable this project as a shared VPC host project.
+
+Args:
+  project: string, Project ID for this request. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ disableXpnResource(project, body=None, requestId=None, x__xgafv=None) + 
Disable a service resource (also known as service project) associated with
+this host project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "xpnResource": { # Service resource (a.k.a service project) ID. # Service resource (a.k.a service project) ID.
+    "id": "A String", # The ID of the service resource. In the case of projects, this field
+        # supports project id (e.g., my-project-123) and project number
+        # (e.g. 12345678).
+    "type": "A String", # The type of the service 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ enableXpnHost(project, requestId=None, x__xgafv=None) + 
Enable this project as a shared VPC host project.
+
+Args:
+  project: string, Project ID for this request. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ enableXpnResource(project, body=None, requestId=None, x__xgafv=None) + 
Enable service resource (a.k.a service project) for a host project, so that
+subnets in the host project can be used by instances in the service
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "xpnResource": { # Service resource (a.k.a service project) ID. # Service resource (a.k.a service project) ID.
+    "id": "A String", # The ID of the service resource. In the case of projects, this field
+        # supports project id (e.g., my-project-123) and project number
+        # (e.g. 12345678).
+    "type": "A String", # The type of the service 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Returns the specified Project resource.
+
+To decrease latency for this method, you can optionally omit any unneeded
+information from the response by using a field mask. This practice is
+especially recommended for unused quota information (the `quotas` field).
+To exclude one or more fields, set your request's `fields` query parameter
+to only include the fields you need. For example, to only include the `id`
+and `selfLink` fields, add the query parameter `?fields=id,selfLink` to
+your request.
+
+Args:
+  project: string, Project ID for this request. (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 Project resource.
+    #
+    # A project is used to organize resources in a Google Cloud Platform
+    # environment. For more information, read about the
+    # Resource Hierarchy.
+  "cloudArmorTier": "A String", # Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the
+      # following values: CA_STANDARD,CA_ENTERPRISE_PAYGO.
+      #
+      # If this field is not specified, it is assumed to beCA_STANDARD.
+  "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this
+      # project. See Custom
+      # metadata for more information.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the metadata's contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update metadata. You must always provide an
+        # up-to-date fingerprint hash in order to update or change metadata,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve the resource.
+    "items": [ # Array of key/value pairs. The total size of all keys and values must be
+        # less than 512 KB.
+      { # Metadata
+        "key": "A String", # Key for the metadata entry. Keys must conform to the following
+            # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+            # This is reflected as part of a URL in the metadata server. Additionally, to
+            # avoid ambiguity, keys must not conflict with any other metadata keys
+            # for the project.
+        "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+            # have meaning as interpreted by the image running in the instance. The
+            # only restriction placed on values is that their size must be less than
+            # or equal to 262144 bytes (256 KiB).
+      },
+    ],
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultNetworkTier": "A String", # This signifies the default network tier used for configuring resources of
+      # the project and can only take the following values:PREMIUM, STANDARD. Initially the default network
+      # tier is PREMIUM.
+  "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+  "description": "A String", # An optional textual description of the resource.
+  "enabledFeatures": [ # An optional list of restricted features enabled for use on this project.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server. This is *not* the project ID, and is
+      # just a unique ID used by Compute Engine to identify resources.
+  "kind": "compute#project", # Output only. [Output Only] Type of the resource. Always compute#project for
+      # projects.
+  "name": "A String", # The project ID. For example: my-example-project. Use the
+      # project ID to make requests to Compute Engine.
+  "quotas": [ # [Output Only] Quotas assigned to this project.
+    { # A quotas entry.
+      "limit": 3.14, # [Output Only] Quota limit for this metric.
+      "metric": "A String", # [Output Only] Name of the quota metric.
+      "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+          # is applied.
+      "usage": 3.14, # [Output Only] Current usage of this metric.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage # An optional naming prefix for daily usage reports and the Google Cloud
+      # Storage bucket where they are stored.
+      # report. Contains bucket_name and report_name prefix.
+    "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report
+        # object is stored. The Google Service Account is granted write access to
+        # this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://
+        # or https://storage.googleapis.com/ in front of it, such
+        # as gs://example-bucket.
+    "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.
+        # If you supply a prefix, it should conform to Cloud Storageobject naming
+        # conventions.
+  },
+  "vmDnsSetting": "A String", # Output only. [Output Only] Default internal DNS setting used by VMs running in
+      # this project.
+  "xpnProjectStatus": "A String", # [Output Only] The role this project has in a shared VPC configuration.
+      # Currently, only projects with the host role, which is specified by the
+      # value HOST, are differentiated.
+}
+
+ +
+ getXpnHost(project, x__xgafv=None) + 
Gets the shared VPC host project that this project links to. May be empty
+if no link exists.
+
+Args:
+  project: string, Project ID for this request. (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 Project resource.
+    #
+    # A project is used to organize resources in a Google Cloud Platform
+    # environment. For more information, read about the
+    # Resource Hierarchy.
+  "cloudArmorTier": "A String", # Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the
+      # following values: CA_STANDARD,CA_ENTERPRISE_PAYGO.
+      #
+      # If this field is not specified, it is assumed to beCA_STANDARD.
+  "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this
+      # project. See Custom
+      # metadata for more information.
+    "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+        # the metadata's contents and used for optimistic locking. The
+        # fingerprint is initially generated by Compute Engine and changes after
+        # every request to modify or update metadata. You must always provide an
+        # up-to-date fingerprint hash in order to update or change metadata,
+        # otherwise the request will fail with error412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve the resource.
+    "items": [ # Array of key/value pairs. The total size of all keys and values must be
+        # less than 512 KB.
+      { # Metadata
+        "key": "A String", # Key for the metadata entry. Keys must conform to the following
+            # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+            # This is reflected as part of a URL in the metadata server. Additionally, to
+            # avoid ambiguity, keys must not conflict with any other metadata keys
+            # for the project.
+        "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+            # have meaning as interpreted by the image running in the instance. The
+            # only restriction placed on values is that their size must be less than
+            # or equal to 262144 bytes (256 KiB).
+      },
+    ],
+    "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+        # for metadata.
+  },
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultNetworkTier": "A String", # This signifies the default network tier used for configuring resources of
+      # the project and can only take the following values:PREMIUM, STANDARD. Initially the default network
+      # tier is PREMIUM.
+  "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+  "description": "A String", # An optional textual description of the resource.
+  "enabledFeatures": [ # An optional list of restricted features enabled for use on this project.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server. This is *not* the project ID, and is
+      # just a unique ID used by Compute Engine to identify resources.
+  "kind": "compute#project", # Output only. [Output Only] Type of the resource. Always compute#project for
+      # projects.
+  "name": "A String", # The project ID. For example: my-example-project. Use the
+      # project ID to make requests to Compute Engine.
+  "quotas": [ # [Output Only] Quotas assigned to this project.
+    { # A quotas entry.
+      "limit": 3.14, # [Output Only] Quota limit for this metric.
+      "metric": "A String", # [Output Only] Name of the quota metric.
+      "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+          # is applied.
+      "usage": 3.14, # [Output Only] Current usage of this metric.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage # An optional naming prefix for daily usage reports and the Google Cloud
+      # Storage bucket where they are stored.
+      # report. Contains bucket_name and report_name prefix.
+    "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report
+        # object is stored. The Google Service Account is granted write access to
+        # this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://
+        # or https://storage.googleapis.com/ in front of it, such
+        # as gs://example-bucket.
+    "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.
+        # If you supply a prefix, it should conform to Cloud Storageobject naming
+        # conventions.
+  },
+  "vmDnsSetting": "A String", # Output only. [Output Only] Default internal DNS setting used by VMs running in
+      # this project.
+  "xpnProjectStatus": "A String", # [Output Only] The role this project has in a shared VPC configuration.
+      # Currently, only projects with the host role, which is specified by the
+      # value HOST, are differentiated.
+}
+
+ +
+ getXpnResources(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Gets service resources (a.k.a service project) associated with this host
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "kind": "compute#projectsGetXpnResources", # Output only. [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources
+      # (a.k.a service projects)
+  "nextPageToken": "A String", # Output only. [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.
+  "resources": [ # Service resources (a.k.a service projects) attached to this project as
+      # their shared VPC host.
+    { # Service resource (a.k.a service project) ID.
+      "id": "A String", # The ID of the service resource. In the case of projects, this field
+          # supports project id (e.g., my-project-123) and project number
+          # (e.g. 12345678).
+      "type": "A String", # The type of the service resource.
+    },
+  ],
+}
+
+ +
+ getXpnResources_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.
+
+
+ +
+ listXpnHosts(project, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all shared VPC host projects visible to the user in an organization.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "organization": "A String", # Optional organization ID managed by Cloud Resource Manager, for which to
+      # list shared VPC host projects. If not specified, the organization will be
+      # inferred from the project.
+}
+
+  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.
+  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": [ # [Output Only] A list of shared VPC host project URLs.
+    { # Represents a Project resource.
+        #
+        # A project is used to organize resources in a Google Cloud Platform
+        # environment. For more information, read about the
+        # Resource Hierarchy.
+      "cloudArmorTier": "A String", # Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the
+          # following values: CA_STANDARD,CA_ENTERPRISE_PAYGO.
+          #
+          # If this field is not specified, it is assumed to beCA_STANDARD.
+      "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this
+          # project. See Custom
+          # metadata for more information.
+        "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+            # the metadata's contents and used for optimistic locking. The
+            # fingerprint is initially generated by Compute Engine and changes after
+            # every request to modify or update metadata. You must always provide an
+            # up-to-date fingerprint hash in order to update or change metadata,
+            # otherwise the request will fail with error412 conditionNotMet.
+            #
+            # To see the latest fingerprint, make a get() request to
+            # retrieve the resource.
+        "items": [ # Array of key/value pairs. The total size of all keys and values must be
+            # less than 512 KB.
+          { # Metadata
+            "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                # This is reflected as part of a URL in the metadata server. Additionally, to
+                # avoid ambiguity, keys must not conflict with any other metadata keys
+                # for the project.
+            "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                # have meaning as interpreted by the image running in the instance. The
+                # only restriction placed on values is that their size must be less than
+                # or equal to 262144 bytes (256 KiB).
+          },
+        ],
+        "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+            # for metadata.
+      },
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultNetworkTier": "A String", # This signifies the default network tier used for configuring resources of
+          # the project and can only take the following values:PREMIUM, STANDARD. Initially the default network
+          # tier is PREMIUM.
+      "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+      "description": "A String", # An optional textual description of the resource.
+      "enabledFeatures": [ # An optional list of restricted features enabled for use on this project.
+        "A String",
+      ],
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server. This is *not* the project ID, and is
+          # just a unique ID used by Compute Engine to identify resources.
+      "kind": "compute#project", # Output only. [Output Only] Type of the resource. Always compute#project for
+          # projects.
+      "name": "A String", # The project ID. For example: my-example-project. Use the
+          # project ID to make requests to Compute Engine.
+      "quotas": [ # [Output Only] Quotas assigned to this project.
+        { # A quotas entry.
+          "limit": 3.14, # [Output Only] Quota limit for this metric.
+          "metric": "A String", # [Output Only] Name of the quota metric.
+          "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+              # is applied.
+          "usage": 3.14, # [Output Only] Current usage of this metric.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage # An optional naming prefix for daily usage reports and the Google Cloud
+          # Storage bucket where they are stored.
+          # report. Contains bucket_name and report_name prefix.
+        "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report
+            # object is stored. The Google Service Account is granted write access to
+            # this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://
+            # or https://storage.googleapis.com/ in front of it, such
+            # as gs://example-bucket.
+        "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.
+            # If you supply a prefix, it should conform to Cloud Storageobject naming
+            # conventions.
+      },
+      "vmDnsSetting": "A String", # Output only. [Output Only] Default internal DNS setting used by VMs running in
+          # this project.
+      "xpnProjectStatus": "A String", # [Output Only] The role this project has in a shared VPC configuration.
+          # Currently, only projects with the host role, which is specified by the
+          # value HOST, are differentiated.
+    },
+  ],
+  "kind": "compute#xpnHostList", # Output only. [Output Only] Type of resource. Always compute#xpnHostList for
+      # lists of shared VPC hosts.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listXpnHosts_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.
+
+
+ +
+ moveDisk(project, body=None, requestId=None, x__xgafv=None) + 
Moves a persistent disk from one zone to another.
+*Note*: The moveDisk API will be deprecated on September 29, 2026.
+
+Starting September 29, 2025, you can't use the moveDisk API on new
+projects. To move a disk to a different region or zone, follow the steps in
+[Change the location of a
+disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd).
+
+Projects that already use the moveDisk API can continue usage until
+September 29, 2026.
+
+Starting November 1, 2025, API responses will include a warning message in
+the response body about the upcoming deprecation. You can skip the message
+to continue using the service without interruption.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "destinationZone": "A String", # The URL of the destination zone to move the disk. This can be a full or
+      # partial URL. For example, the following are all valid URLs to a zone:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone
+      #    - projects/project/zones/zone
+      #    - zones/zone
+  "targetDisk": "A String", # The URL of the target disk to move. This can be a full or partial URL.
+      # For example, the following are all valid URLs to a disk:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #    - projects/project/zones/zone/disks/disk
+      #    - zones/zone/disks/disk
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ moveInstance(project, body=None, requestId=None, x__xgafv=None) + 
Moves an instance and its attached persistent disks from one zone to
+another.
+*Note*: Moving VMs or disks by using this method might
+ cause unexpected behavior. For more information, see the [known
+ issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior).
+[Deprecated] This method is deprecated. See [moving instance across
+zones](/compute/docs/instances/moving-instance-across-zones) instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "destinationZone": "A String", # The URL of the destination zone to move the instance. This can be a full or
+      # partial URL. For example, the following are all valid URLs to a zone:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone
+      #    - projects/project/zones/zone
+      #    - zones/zone
+  "targetInstance": "A String", # The URL of the target instance to move. This can be a full or partial URL.
+      # For example, the following are all valid URLs to an instance:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+      #    - zones/zone/instances/instance
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setCloudArmorTier(project, body=None, requestId=None, x__xgafv=None) + 
Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the
+billing account of the project must be subscribed to Cloud Armor
+Enterprise. See Subscribing
+to Cloud Armor Enterprise for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "cloudArmorTier": "A String", # Managed protection tier to be set.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setCommonInstanceMetadata(project, body=None, requestId=None, x__xgafv=None) + 
Sets metadata common to all instances within 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:
+
+{ # A metadata key/value entry.
+  "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve the resource.
+  "items": [ # Array of key/value pairs. The total size of all keys and values must be
+      # less than 512 KB.
+    { # Metadata
+      "key": "A String", # Key for the metadata entry. Keys must conform to the following
+          # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+          # This is reflected as part of a URL in the metadata server. Additionally, to
+          # avoid ambiguity, keys must not conflict with any other metadata keys
+          # for the project.
+      "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+          # have meaning as interpreted by the image running in the instance. The
+          # only restriction placed on values is that their size must be less than
+          # or equal to 262144 bytes (256 KiB).
+    },
+  ],
+  "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+      # for metadata.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setDefaultNetworkTier(project, body=None, requestId=None, x__xgafv=None) + 
Sets the default network tier of the project. The default network tier is
+used when an address/forwardingRule/instance is created without specifying
+the network tier field.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkTier": "A String", # Default network tier to be set.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setUsageExportBucket(project, body=None, requestId=None, x__xgafv=None) + 
Enables the usage export feature and sets theusage export bucket
+where reports are stored. If you provide an empty request body using this
+method, the usage export feature will be disabled.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The location in Cloud Storage and naming method of the daily usage
+    # report. Contains bucket_name and report_name prefix.
+  "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report
+      # object is stored. The Google Service Account is granted write access to
+      # this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://
+      # or https://storage.googleapis.com/ in front of it, such
+      # as gs://example-bucket.
+  "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.
+      # If you supply a prefix, it should conform to Cloud Storageobject naming
+      # conventions.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.publicAdvertisedPrefixes.html b/docs/dyn/compute_preview.publicAdvertisedPrefixes.html new file mode 100644 index 0000000000..007f500baf --- /dev/null +++ b/docs/dyn/compute_preview.publicAdvertisedPrefixes.html @@ -0,0 +1,2073 @@ + + + +

Compute Engine API . publicAdvertisedPrefixes

+

Instance Methods

+

+ announce(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None)

+

Announces the specified PublicAdvertisedPrefix

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None)

+

Deletes the specified PublicAdvertisedPrefix

+

+ get(project, publicAdvertisedPrefix, x__xgafv=None)

+

Returns the specified PublicAdvertisedPrefix resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a PublicAdvertisedPrefix in the specified project

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the PublicAdvertisedPrefixes for a project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, publicAdvertisedPrefix, body=None, requestId=None, x__xgafv=None)

+

Patches the specified Router resource with the data included in the

+

+ withdraw(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None)

+

Withdraws the specified PublicAdvertisedPrefix

+

Method Details

+
+ announce(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None) + 
Announces the specified PublicAdvertisedPrefix
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicAdvertisedPrefix: string, The name of the public advertised prefix. It should comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None) + 
Deletes the specified PublicAdvertisedPrefix
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicAdvertisedPrefix: string, Name of the PublicAdvertisedPrefix 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, publicAdvertisedPrefix, x__xgafv=None) + 
Returns the specified PublicAdvertisedPrefix resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicAdvertisedPrefix: string, Name of the PublicAdvertisedPrefix 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:
+
+    { # A public advertised prefix represents an aggregated IP prefix or netblock
+    # which customers bring to cloud. The IP prefix is a single unit of route
+    # advertisement and is announced globally to the internet.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "dnsVerificationIp": "A String", # The address to be used for reverse DNS verification.
+  "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 new PublicAdvertisedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicAdvertisedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The address range, in CIDR format, represented by this public advertised
+      # prefix.
+  "ipv6AccessType": "A String", # The internet access type for IPv6 Public Advertised Prefixes.
+  "kind": "compute#publicAdvertisedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.
+  "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.
+  "pdpScope": "A String", # Specifies how child public delegated prefix will be scoped. It could
+      # be one of following values:
+      #
+      #
+      #      - `REGIONAL`: The public delegated prefix is regional only. The
+      #      provisioning will take a few minutes.
+      #      - `GLOBAL`: The public delegated prefix is global only. The
+      #      provisioning will take ~4 weeks.
+      #      - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is
+      #       BYOIP V1 legacy prefix. This is output only value and no longer
+      #       supported in BYOIP V2.
+  "publicDelegatedPrefixs": [ # Output only. [Output Only] The list of public delegated prefixes that exist for this
+      # public advertised prefix.
+    { # Represents a CIDR range which can be used to assign addresses.
+      "ipRange": "A String", # The IP address range of the public delegated prefix
+      "name": "A String", # The name of the public delegated prefix
+      "project": "A String", # The project number of the public delegated prefix
+      "region": "A String", # The region of the public delegated prefix if it is regional. If absent,
+          # the prefix is global.
+      "status": "A String", # The status of the public delegated prefix. Possible values are:
+          #   INITIALIZING: The public delegated prefix is being initialized and
+          #     addresses cannot be created yet.
+          #   ANNOUNCED: The public delegated prefix is active.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "sharedSecret": "A String", # [Output Only] The shared secret to be used for reverse DNS verification.
+  "status": "A String", # The status of the public advertised prefix. Possible values include:
+      #
+      #
+      #      - `INITIAL`: RPKI validation is complete.
+      #      - `PTR_CONFIGURED`: User has configured the PTR.
+      #      - `VALIDATED`: Reverse DNS lookup is successful.
+      #      - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.
+      #      - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being
+      #      configured.
+      #      - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.
+      #      - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a PublicAdvertisedPrefix in the specified project
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A public advertised prefix represents an aggregated IP prefix or netblock
+    # which customers bring to cloud. The IP prefix is a single unit of route
+    # advertisement and is announced globally to the internet.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "dnsVerificationIp": "A String", # The address to be used for reverse DNS verification.
+  "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 new PublicAdvertisedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicAdvertisedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The address range, in CIDR format, represented by this public advertised
+      # prefix.
+  "ipv6AccessType": "A String", # The internet access type for IPv6 Public Advertised Prefixes.
+  "kind": "compute#publicAdvertisedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.
+  "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.
+  "pdpScope": "A String", # Specifies how child public delegated prefix will be scoped. It could
+      # be one of following values:
+      # 
+      # 
+      #      - `REGIONAL`: The public delegated prefix is regional only. The
+      #      provisioning will take a few minutes.
+      #      - `GLOBAL`: The public delegated prefix is global only. The
+      #      provisioning will take ~4 weeks.
+      #      - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is
+      #       BYOIP V1 legacy prefix. This is output only value and no longer
+      #       supported in BYOIP V2.
+  "publicDelegatedPrefixs": [ # Output only. [Output Only] The list of public delegated prefixes that exist for this
+      # public advertised prefix.
+    { # Represents a CIDR range which can be used to assign addresses.
+      "ipRange": "A String", # The IP address range of the public delegated prefix
+      "name": "A String", # The name of the public delegated prefix
+      "project": "A String", # The project number of the public delegated prefix
+      "region": "A String", # The region of the public delegated prefix if it is regional. If absent,
+          # the prefix is global.
+      "status": "A String", # The status of the public delegated prefix. Possible values are:
+          #   INITIALIZING: The public delegated prefix is being initialized and
+          #     addresses cannot be created yet.
+          #   ANNOUNCED: The public delegated prefix is active.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "sharedSecret": "A String", # [Output Only] The shared secret to be used for reverse DNS verification.
+  "status": "A String", # The status of the public advertised prefix. Possible values include:
+      # 
+      # 
+      #      - `INITIAL`: RPKI validation is complete.
+      #      - `PTR_CONFIGURED`: User has configured the PTR.
+      #      - `VALIDATED`: Reverse DNS lookup is successful.
+      #      - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.
+      #      - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being
+      #      configured.
+      #      - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.
+      #      - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the PublicAdvertisedPrefixes for a 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.
+  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 PublicAdvertisedPrefix resources.
+    { # A public advertised prefix represents an aggregated IP prefix or netblock
+        # which customers bring to cloud. The IP prefix is a single unit of route
+        # advertisement and is announced globally to the internet.
+      "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+      "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.
+      "dnsVerificationIp": "A String", # The address to be used for reverse DNS verification.
+      "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 new PublicAdvertisedPrefix. An up-to-date
+          # fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with
+          # error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a PublicAdvertisedPrefix.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "ipCidrRange": "A String", # The address range, in CIDR format, represented by this public advertised
+          # prefix.
+      "ipv6AccessType": "A String", # The internet access type for IPv6 Public Advertised Prefixes.
+      "kind": "compute#publicAdvertisedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.
+      "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.
+      "pdpScope": "A String", # Specifies how child public delegated prefix will be scoped. It could
+          # be one of following values:
+          #
+          #
+          #      - `REGIONAL`: The public delegated prefix is regional only. The
+          #      provisioning will take a few minutes.
+          #      - `GLOBAL`: The public delegated prefix is global only. The
+          #      provisioning will take ~4 weeks.
+          #      - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is
+          #       BYOIP V1 legacy prefix. This is output only value and no longer
+          #       supported in BYOIP V2.
+      "publicDelegatedPrefixs": [ # Output only. [Output Only] The list of public delegated prefixes that exist for this
+          # public advertised prefix.
+        { # Represents a CIDR range which can be used to assign addresses.
+          "ipRange": "A String", # The IP address range of the public delegated prefix
+          "name": "A String", # The name of the public delegated prefix
+          "project": "A String", # The project number of the public delegated prefix
+          "region": "A String", # The region of the public delegated prefix if it is regional. If absent,
+              # the prefix is global.
+          "status": "A String", # The status of the public delegated prefix. Possible values are:
+              #   INITIALIZING: The public delegated prefix is being initialized and
+              #     addresses cannot be created yet.
+              #   ANNOUNCED: The public delegated prefix is active.
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "sharedSecret": "A String", # [Output Only] The shared secret to be used for reverse DNS verification.
+      "status": "A String", # The status of the public advertised prefix. Possible values include:
+          #
+          #
+          #      - `INITIAL`: RPKI validation is complete.
+          #      - `PTR_CONFIGURED`: User has configured the PTR.
+          #      - `VALIDATED`: Reverse DNS lookup is successful.
+          #      - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.
+          #      - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being
+          #      configured.
+          #      - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.
+          #      - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.
+    },
+  ],
+  "kind": "compute#publicAdvertisedPrefixList", # Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.
+  "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, publicAdvertisedPrefix, 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)
+  publicAdvertisedPrefix: string, Name of the PublicAdvertisedPrefix resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A public advertised prefix represents an aggregated IP prefix or netblock
+    # which customers bring to cloud. The IP prefix is a single unit of route
+    # advertisement and is announced globally to the internet.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "dnsVerificationIp": "A String", # The address to be used for reverse DNS verification.
+  "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 new PublicAdvertisedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicAdvertisedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The address range, in CIDR format, represented by this public advertised
+      # prefix.
+  "ipv6AccessType": "A String", # The internet access type for IPv6 Public Advertised Prefixes.
+  "kind": "compute#publicAdvertisedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.
+  "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.
+  "pdpScope": "A String", # Specifies how child public delegated prefix will be scoped. It could
+      # be one of following values:
+      # 
+      # 
+      #      - `REGIONAL`: The public delegated prefix is regional only. The
+      #      provisioning will take a few minutes.
+      #      - `GLOBAL`: The public delegated prefix is global only. The
+      #      provisioning will take ~4 weeks.
+      #      - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is
+      #       BYOIP V1 legacy prefix. This is output only value and no longer
+      #       supported in BYOIP V2.
+  "publicDelegatedPrefixs": [ # Output only. [Output Only] The list of public delegated prefixes that exist for this
+      # public advertised prefix.
+    { # Represents a CIDR range which can be used to assign addresses.
+      "ipRange": "A String", # The IP address range of the public delegated prefix
+      "name": "A String", # The name of the public delegated prefix
+      "project": "A String", # The project number of the public delegated prefix
+      "region": "A String", # The region of the public delegated prefix if it is regional. If absent,
+          # the prefix is global.
+      "status": "A String", # The status of the public delegated prefix. Possible values are:
+          #   INITIALIZING: The public delegated prefix is being initialized and
+          #     addresses cannot be created yet.
+          #   ANNOUNCED: The public delegated prefix is active.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "sharedSecret": "A String", # [Output Only] The shared secret to be used for reverse DNS verification.
+  "status": "A String", # The status of the public advertised prefix. Possible values include:
+      # 
+      # 
+      #      - `INITIAL`: RPKI validation is complete.
+      #      - `PTR_CONFIGURED`: User has configured the PTR.
+      #      - `VALIDATED`: Reverse DNS lookup is successful.
+      #      - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.
+      #      - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being
+      #      configured.
+      #      - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.
+      #      - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ withdraw(project, publicAdvertisedPrefix, requestId=None, x__xgafv=None) + 
Withdraws the specified PublicAdvertisedPrefix
+
+Args:
+  project: string, Project ID for this request. (required)
+  publicAdvertisedPrefix: string, The name of the public advertised prefix. It should comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.publicDelegatedPrefixes.html b/docs/dyn/compute_preview.publicDelegatedPrefixes.html new file mode 100644 index 0000000000..b802a3a320 --- /dev/null +++ b/docs/dyn/compute_preview.publicDelegatedPrefixes.html @@ -0,0 +1,2410 @@ + + + +

Compute Engine API . publicDelegatedPrefixes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Lists all PublicDelegatedPrefix resources owned by the specific project

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ announce(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

+

Announces the specified PublicDelegatedPrefix in the given region.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

+

Deletes the specified PublicDelegatedPrefix in the given region.

+

+ get(project, region, publicDelegatedPrefix, x__xgafv=None)

+

Returns the specified PublicDelegatedPrefix resource in the given region.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a PublicDelegatedPrefix in the specified project in the given

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the PublicDelegatedPrefixes for a project in the given region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

+

Patches the specified PublicDelegatedPrefix resource with the data included

+

+ withdraw(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

+

Withdraws the specified PublicDelegatedPrefix in the given region.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Lists all PublicDelegatedPrefix resources owned by the specific project
+across all scopes.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of PublicDelegatedPrefixesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of
+        # PublicDelegatedPrefixes.
+      "publicDelegatedPrefixes": [ # [Output Only] A list of PublicDelegatedPrefixes contained in this scope.
+        { # A PublicDelegatedPrefix resource represents an IP block within a
+            # PublicAdvertisedPrefix that is configured within a single cloud scope
+            # (global or region). IPs in the block can be allocated to resources within
+            # that scope. Public delegated prefixes may be further broken up into
+            # smaller IP blocks in the same scope as the parent block.
+          "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+              # This field is optional and cannot be set for prefixes in DELEGATION mode.
+              # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+          "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+          "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.
+          "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+              # Applicable for IPv4 PDPs only.
+          "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 new PublicDelegatedPrefix. An up-to-date
+              # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+              # error 412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a PublicDelegatedPrefix.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+              # generates this identifier.
+          "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+              # delegated prefix.
+          "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+              # Inherited from parent prefix.
+          "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+          "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+          "mode": "A String", # The public delegated prefix mode for IPv6 only.
+          "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.
+          "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+              # PublicDelegatedPrefix.
+          "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+              # delegated prefix.
+            { # Represents a sub PublicDelegatedPrefix.
+              "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+              "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+                  # Applicable for IPv4 PDPs only.
+              "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+                  # delegated prefix.
+              "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+                  # Prefixes. Inherited from parent prefix.
+              "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+                  # delegatee project.
+              "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+              "name": "A String", # The name of the sub public delegated prefix.
+              "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+                  # regional. If absent, the sub prefix is global.
+              "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+            },
+          ],
+          "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+              # This field applies only to the region 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.
+          "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+              # of following values:
+              #
+              #
+              #      - `INITIALIZING` The public delegated prefix is being initialized and
+              #      addresses cannot be created yet.
+              #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+              #      prefix and is active.
+              #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+              #      use.
+              #      - `DELETING` The public delegated prefix is being deprovsioned.
+              #      - `ACTIVE` The public delegated prefix is ready to use.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of
+          # public delegated prefixes 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#publicDelegatedPrefixAggregatedList", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated
+      # lists of public delegated prefixes.
+  "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.
+  "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.
+
+
+ +
+ announce(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None) + 
Announces the specified PublicDelegatedPrefix in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of theregion where
+the public delegated prefix is located. It should comply with RFC1035. (required)
+  publicDelegatedPrefix: string, The name of the public delegated prefix. It should comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None) + 
Deletes the specified PublicDelegatedPrefix in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, publicDelegatedPrefix, x__xgafv=None) + 
Returns the specified PublicDelegatedPrefix resource in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix 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:
+
+    { # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      #
+      #
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a PublicDelegatedPrefix 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 of this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      # 
+      # 
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the PublicDelegatedPrefixes for a project in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of 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.
+  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 PublicDelegatedPrefix resources.
+    { # A PublicDelegatedPrefix resource represents an IP block within a
+        # PublicAdvertisedPrefix that is configured within a single cloud scope
+        # (global or region). IPs in the block can be allocated to resources within
+        # that scope. Public delegated prefixes may be further broken up into
+        # smaller IP blocks in the same scope as the parent block.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+          # This field is optional and cannot be set for prefixes in DELEGATION mode.
+          # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+      "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+      "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.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "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 new PublicDelegatedPrefix. An up-to-date
+          # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+          # error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a PublicDelegatedPrefix.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+          # Inherited from parent prefix.
+      "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+      "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+      "mode": "A String", # The public delegated prefix mode for IPv6 only.
+      "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.
+      "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+          # PublicDelegatedPrefix.
+      "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+          # delegated prefix.
+        { # Represents a sub PublicDelegatedPrefix.
+          "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+          "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+              # Applicable for IPv4 PDPs only.
+          "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+              # delegated prefix.
+          "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+              # Prefixes. Inherited from parent prefix.
+          "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+              # delegatee project.
+          "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+          "name": "A String", # The name of the sub public delegated prefix.
+          "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+              # regional. If absent, the sub prefix is global.
+          "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+          # This field applies only to the region 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.
+      "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+          # of following values:
+          #
+          #
+          #      - `INITIALIZING` The public delegated prefix is being initialized and
+          #      addresses cannot be created yet.
+          #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+          #      prefix and is active.
+          #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+          #      use.
+          #      - `DELETING` The public delegated prefix is being deprovsioned.
+          #      - `ACTIVE` The public delegated prefix is ready to use.
+    },
+  ],
+  "kind": "compute#publicDelegatedPrefixList", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated
+      # prefixes.
+  "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, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None) + 
Patches the specified PublicDelegatedPrefix 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)
+  publicDelegatedPrefix: string, Name of the PublicDelegatedPrefix resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A PublicDelegatedPrefix resource represents an IP block within a
+    # PublicAdvertisedPrefix that is configured within a single cloud scope
+    # (global or region). IPs in the block can be allocated to resources within
+    # that scope. Public delegated prefixes may be further broken up into
+    # smaller IP blocks in the same scope as the parent block.
+  "allocatablePrefixLength": 42, # The allocatable prefix length supported by this public delegated prefix.
+      # This field is optional and cannot be set for prefixes in DELEGATION mode.
+      # It cannot be set for IPv4 prefixes either, and it always defaults to 32.
+  "byoipApiVersion": "A String", # Output only. [Output Only] The version of BYOIP API.
+  "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.
+  "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+      # Applicable for IPv4 PDPs only.
+  "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 new PublicDelegatedPrefix. An up-to-date
+      # fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with
+      # error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a PublicDelegatedPrefix.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this public
+      # delegated prefix.
+  "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.
+      # Inherited from parent prefix.
+  "isLiveMigration": True or False, # If true, the prefix will be live migrated.
+  "kind": "compute#publicDelegatedPrefix", # Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.
+  "mode": "A String", # The public delegated prefix mode for IPv6 only.
+  "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.
+  "parentPrefix": "A String", # The URL of parent prefix. Either PublicAdvertisedPrefix or
+      # PublicDelegatedPrefix.
+  "publicDelegatedSubPrefixs": [ # The list of sub public delegated prefixes that exist for this public
+      # delegated prefix.
+    { # Represents a sub PublicDelegatedPrefix.
+      "allocatablePrefixLength": 42, # The allocatable prefix length supported by this PublicDelegatedSubPrefix.
+      "delegateeProject": "A String", # Name of the project scoping this PublicDelegatedSubPrefix.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enableEnhancedIpv4Allocation": True or False, # Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.
+          # Applicable for IPv4 PDPs only.
+      "ipCidrRange": "A String", # The IP address range, in CIDR format, represented by this sub public
+          # delegated prefix.
+      "ipv6AccessType": "A String", # Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub
+          # Prefixes. Inherited from parent prefix.
+      "isAddress": True or False, # Whether the sub prefix is delegated to create Address resources in the
+          # delegatee project.
+      "mode": "A String", # The PublicDelegatedSubPrefix mode for IPv6 only.
+      "name": "A String", # The name of the sub public delegated prefix.
+      "region": "A String", # Output only. [Output Only] The region of the sub public delegated prefix if it is
+          # regional. If absent, the sub prefix is global.
+      "status": "A String", # Output only. [Output Only] The status of the sub public delegated prefix.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the public delegated prefix resides.
+      # This field applies only to the region 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.
+  "status": "A String", # [Output Only] The status of the public delegated prefix, which can be one
+      # of following values:
+      # 
+      # 
+      #      - `INITIALIZING` The public delegated prefix is being initialized and
+      #      addresses cannot be created yet.
+      #      - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration
+      #      prefix and is active.
+      #      - `ANNOUNCED` The public delegated prefix is announced and ready to
+      #      use.
+      #      - `DELETING` The public delegated prefix is being deprovsioned.
+      #      - `ACTIVE` The public delegated prefix is ready to use.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ withdraw(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None) + 
Withdraws the specified PublicDelegatedPrefix in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of theregion where
+the public delegated prefix is located. It should comply with RFC1035. (required)
+  publicDelegatedPrefix: string, The name of the public delegated prefix. It should comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionAutoscalers.html b/docs/dyn/compute_preview.regionAutoscalers.html new file mode 100644 index 0000000000..4ab96b3b4f --- /dev/null +++ b/docs/dyn/compute_preview.regionAutoscalers.html @@ -0,0 +1,3230 @@ + + + +

Compute Engine API . regionAutoscalers

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, autoscaler, requestId=None, x__xgafv=None)

+

Deletes the specified autoscaler.

+

+ get(project, region, autoscaler, x__xgafv=None)

+

Returns the specified autoscaler.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates an autoscaler in the specified project using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of autoscalers contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None)

+

Updates an autoscaler in the specified project using

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None)

+

Updates an autoscaler in the specified project using

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, autoscaler, requestId=None, x__xgafv=None) + 
Deletes the specified autoscaler.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  autoscaler: string, Name of the autoscaler 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, autoscaler, x__xgafv=None) + 
Returns the specified autoscaler.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  autoscaler: string, Name of the autoscaler 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 an Autoscaler resource.
+    #
+    # Google Compute Engine has two Autoscaler resources:
+    #
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    #
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    #
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    #
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      #
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      #
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      #
+      #
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates an autoscaler in the specified project using
+the data 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 an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of autoscalers contained within
+the specified 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.
+  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 autoscalers.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Autoscaler resources.
+    { # Represents an Autoscaler resource.
+        #
+        # Google Compute Engine has two Autoscaler resources:
+        #
+        # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+        # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+        #
+        # Use autoscalers to automatically add or delete instances from a
+        # managed instance group according to your defined autoscaling policy.
+        # For more information, read Autoscaling Groups of Instances.
+        #
+        # For zonal managed instance groups resource, use the autoscaler
+        # resource.
+        #
+        # For regional managed instance groups, use theregionAutoscalers resource.
+      "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+          # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+          #
+          # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+        "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+            # instance. This is referred to as the
+            # [initialization period](/compute/docs/autoscaler#cool_down_period).
+            # Specifying an accurate initialization period improves
+            # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+            # data from VMs that are still initializing because those VMs might not yet
+            # represent normal usage of your application. The default initialization
+            # period is 60 seconds.
+            #
+            # Initialization periods might vary because of numerous
+            # factors. We recommend that you test how long your application takes to
+            # initialize. To do this, create a VM and time your application's startup
+            # process.
+        "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+            # based on the average CPU utilization of a managed instance group.
+          "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+              # Valid values are:
+              #
+              # * NONE (default). No predictive method is used. The autoscaler scales the
+              # group to meet current demand based on real-time metrics.
+              # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+              # monitoring daily and weekly load patterns and scaling out ahead of
+              # anticipated demand.
+          "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+              # a float value in the range (0, 1]. If not specified, the default is0.6.
+              #
+              # If the CPU level is below the target utilization, the autoscaler scales
+              # in the number of instances until it reaches the minimum number of
+              # instances you specified or until the average CPU of your instances
+              # reaches the target utilization.
+              #
+              # If the average CPU is above the target utilization, the autoscaler
+              # scales out until it reaches the maximum number of instances you
+              # specified or until the average utilization reaches the target
+              # utilization.
+        },
+        "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+          { # Custom utilization metric policy.
+            "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+                # used to select a specific TimeSeries for the purpose of autoscaling and
+                # to determine whether the metric is exporting per-instance or
+                # per-group data.
+                #
+                # For the filter to be valid for autoscaling purposes, the following rules
+                # apply:
+                #
+                #
+                #     - You can only use the AND operator for joining
+                #        selectors.
+                #     - You can only use direct equality comparison operator
+                #        (=) without any functions for each selector.
+                #     - You can specify the metric in both the filter string and in the
+                #        metric field. However, if specified in both places, the metric must
+                #        be identical.
+                #     - The monitored resource type
+                #        determines what kind of values are expected for the metric. If it is
+                #        a gce_instance, the autoscaler expects the metric to
+                #        include a separate TimeSeries for each instance in a group. In such a
+                #        case, you cannot filter on resource labels.
+                #
+                #
+                #    If the resource type is any other value, the autoscaler expects
+                #        this metric to contain values that apply to the entire autoscaled
+                #        instance group and resource label filtering can be performed to
+                #        point autoscaler at the correct TimeSeries to scale upon. This is
+                #        called a *per-group metric* for the purpose of autoscaling.
+                #
+                #        If not specified, the type defaults to
+                #        gce_instance.
+                #
+                #
+                #
+                # Try to provide a filter that is selective enough to pick just one
+                # TimeSeries for the autoscaled group or for each of the instances (if you
+                # are using gce_instance resource type). If multiple
+                # TimeSeries are returned upon the query execution, the autoscaler will sum
+                # their respective values to obtain its scaling value.
+            "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+                # cannot have negative values.
+                #
+                # The metric must have a value type of INT64 orDOUBLE.
+            "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+                # total amount of work to be done or resource usage, set this value to an
+                # amount assigned for a single instance of the scaled group. Autoscaler
+                # keeps the number of instances proportional to the value of this
+                # metric. The metric itself does not change value due to group
+                # resizing.
+                #
+                # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+                # or a custom metric exporting the total number of requests coming to
+                # your instances.
+                #
+                # A bad example would be a metric exporting an average or median latency,
+                # since this value can't include a chunk assignable to a single instance,
+                # it could be better used with utilization_target instead.
+            "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+                # must be a positive value. A utilization metric scales number of
+                # virtual machines handling requests to increase or decrease
+                # proportionally to the metric.
+                #
+                # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+                # The autoscaler works to keep this value constant for each of the
+                # instances.
+            "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+                # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+          },
+        ],
+        "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+          "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+              # configuration) that the autoscaler maintains. Must be a positive float
+              # value. If not defined, the default is 0.8.
+        },
+        "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+            # is required when creating or updating an autoscaler. The maximum number
+            # of replicas must not be lower than minimal number of replicas.
+        "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+            # This cannot be less than 0. If not provided, autoscaler chooses a
+            # default value depending on maximum number of instances allowed.
+        "mode": "A String", # Defines the operating mode for this policy.
+            # The following modes are available:
+            #
+            #    - OFF: Disables the autoscaler but maintains its
+            #    configuration.
+            #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+            #    VM instances only.
+            #    - ON: Enables all autoscaler activities according to its
+            #    policy.
+            #
+            #
+            # For more information, see
+            # "Turning off or restricting an autoscaler"
+        "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+            # recommends an abrupt scale in of a MIG, it will be throttled as specified
+            # by the parameters below.
+          "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+              # recommendation during the window autoscaler looks at when computing
+              # recommendations. Possibly all these VMs can be deleted at once so user
+              # service needs to be prepared to lose that many VMs in one step.
+            "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                #
+                #
+                #
+                #     - If the value is fixed, then the calculated
+                #      value is equal to the fixed value.
+                #     - If the value is a percent, then the
+                #     calculated
+                #      value is percent/100 * targetSize. For example,
+                #      the calculated value of a 80% of a managed instance group
+                #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                #      is a remainder, the number is rounded.
+            "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+            "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                # example, specify 80 for 80%.
+          },
+          "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+              # include directives regarding slower scale in, as described above.
+        },
+        "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+            # can be set on an autoscaler, and they can overlap. During overlapping
+            # periods the greatest min_required_replicas of all scaling schedules is
+            # applied. Up to 128 scaling schedules are allowed.
+          "a_key": { # Scaling based on user-defined schedule. The message describes a single
+              # scaling schedule. A scaling schedule changes the minimum number of VM
+              # instances an autoscaler can recommend, which can trigger scaling out.
+            "description": "A String", # A description of a scaling schedule.
+            "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+                # autoscaler recommendations. If set to true, then a scaling schedule has
+                # no effect. This field is optional, and its value is false by default.
+            "durationSec": 42, # The duration of time intervals, in seconds, for which this
+                # scaling schedule is to run. The minimum allowed value is 300.
+                # This field is required.
+            "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+                # recommend in time intervals starting according to schedule. This field is
+                # required.
+            "schedule": "A String", # The start timestamps of time intervals when this scaling
+                # schedule is to provide a scaling signal. This field uses the extended
+                # cron format (with an optional year field). The expression can describe a
+                # single timestamp if the optional year is set, in which case the scaling
+                # schedule runs once. The schedule is interpreted with respect to
+                # time_zone. This field is required. Note: These timestamps only describe
+                # when autoscaler starts providing the scaling signal. The VMs
+                # need additional time to become serving.
+            "timeZone": "A String", # The time zone to use when interpreting the schedule.
+                # The value of this field must be a time zone name from the tz database:
+                # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+                # default value of "UTC" if left empty.
+          },
+        },
+        "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+            # making scale-in decisions. This is referred to as the
+            # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+            # This might appear as a delay in scaling in but it is an important mechanism
+            # for your application to not have fluctuating size due to short term load
+            # fluctuations.
+            #
+            # The default stabilization period is 600 seconds.
+      },
+      "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.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+          # for autoscalers.
+      "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.
+      "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+          # autoscaler. Autoscaler calculates the recommended MIG size even when the
+          # autoscaling policy mode is different from ON. This field is empty when
+          # autoscaler is not connected to an existing managed instance group or
+          # autoscaler did not generate its prediction.
+      "region": "A String", # Output only. [Output Only] URL of theregion
+          # where the instance group resides (for autoscalers living in regional
+          # scope).
+      "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+        "a_key": {
+          "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+              # Note: this is a timestamp when a schedule actually became active, not when
+              # it was planned to do so.
+              # The timestamp is in RFC3339
+              # text format.
+          "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+              # Note: this is a timestamp when a schedule is planned to run, but the actual
+              # time might be slightly different.
+              # The timestamp is in RFC3339
+              # text format.
+          "state": "A String", # [Output Only] The current state of a scaling schedule.
+        },
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+          # possible values:
+          #
+          #    - PENDING:
+          #      Autoscaler backend hasn't read new/updated configuration.
+          #    - DELETING:
+          #      Configuration is being deleted.
+          #    - ACTIVE:
+          #      Configuration is acknowledged to be effective. Some warnings might
+          #      be present in the statusDetails field.
+          #    - ERROR:
+          #      Configuration has errors. Actionable for users. Details are present in
+          #      the statusDetails field.
+          #
+          #
+          # New values might be added in the future.
+      "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+          # autoscaler. Read the documentation forCommonly
+          # returned status messages for examples of status messages you might
+          # encounter.
+        {
+          "message": "A String", # The status message.
+          "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+              # values:
+              #
+              #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+              #      All instances in the instance group are unhealthy (not in RUNNING
+              #      state).
+              #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+              #      There is no backend service attached to the instance group.
+              #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+              #      Autoscaler recommends a size greater than maxNumReplicas.
+              #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+              #      The custom metric samples are not exported often enough to be
+              #      a credible base for autoscaling.
+              #    - CUSTOM_METRIC_INVALID (ERROR):
+              #      The custom metric that was specified does not exist or does not have
+              #      the necessary labels.
+              #    - MIN_EQUALS_MAX (WARNING):
+              #      The minNumReplicas is equal to maxNumReplicas. This means the
+              #      autoscaler cannot add or remove instances from the instance group.
+              #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+              #      The autoscaler did not receive any data from the custom metric
+              #      configured for autoscaling.
+              #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+              #      The autoscaler is configured to scale based on a load balancing signal
+              #      but the instance group has not received any requests from the load
+              #      balancer.
+              #    - MODE_OFF (WARNING):
+              #      Autoscaling is turned off. The number of instances in the group won't
+              #      change automatically. The autoscaling configuration is preserved.
+              #    - MODE_ONLY_UP (WARNING):
+              #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+              #      instances but not remove any.
+              #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+              #      The instance group cannot be autoscaled because it has more than one
+              #      backend service attached to it.
+              #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+              #      There is insufficient quota for the necessary resources, such as CPU or
+              #      number of instances.
+              #    - REGION_RESOURCE_STOCKOUT (ERROR):
+              #      Shown only for regional autoscalers: there is a resource stockout in
+              #      the chosen region.
+              #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+              #      The target to be scaled does not exist.
+              #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+              #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+              #      has been configured for maxRate.
+              #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+              #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+              #      For regional autoscalers: in at least one of the zones you're using
+              #      there is a resource stockout.
+              #
+              #
+              # New values might be added in the future. Some of the values might not be
+              # available in all API versions.
+        },
+      ],
+      "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+          # field is required when creating an autoscaler.
+      "zone": "A String", # Output only. [Output Only] URL of thezone
+          # where the instance group resides (for autoscalers living in zonal scope).
+    },
+  ],
+  "kind": "compute#regionAutoscalerList", # 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.
+  "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, autoscaler=None, body=None, requestId=None, x__xgafv=None) + 
Updates an autoscaler in the specified project using
+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)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  autoscaler: string, Name of the autoscaler to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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",
+  ],
+}
+
+ +
+ update(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None) + 
Updates an autoscaler in the specified project using
+the data 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 an Autoscaler resource.
+    # 
+    # Google Compute Engine has two Autoscaler resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/autoscalers)
+    # * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)
+    # 
+    # Use autoscalers to automatically add or delete instances from a
+    # managed instance group according to your defined autoscaling policy.
+    # For more information, read Autoscaling Groups of Instances.
+    # 
+    # For zonal managed instance groups resource, use the autoscaler
+    # resource.
+    # 
+    # For regional managed instance groups, use theregionAutoscalers resource.
+  "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define
+      # one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.
+      # 
+      # If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%.
+    "coolDownPeriodSec": 42, # The number of seconds that your application takes to initialize on a VM
+        # instance. This is referred to as the
+        # [initialization period](/compute/docs/autoscaler#cool_down_period).
+        # Specifying an accurate initialization period improves
+        # autoscaler decisions. For example, when scaling out, the autoscaler ignores
+        # data from VMs that are still initializing because those VMs might not yet
+        # represent normal usage of your application. The default initialization
+        # period is 60 seconds.
+        #
+        # Initialization periods might vary because of numerous
+        # factors. We recommend that you test how long your application takes to
+        # initialize. To do this, create a VM and time your application's startup
+        # process.
+    "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale
+        # based on the average CPU utilization of a managed instance group.
+      "predictiveMethod": "A String", # Indicates whether predictive autoscaling based on CPU metric is enabled.
+          # Valid values are:
+          #
+          # * NONE (default). No predictive method is used. The autoscaler scales the
+          # group to meet current demand based on real-time metrics.
+          # * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by
+          # monitoring daily and weekly load patterns and scaling out ahead of
+          # anticipated demand.
+      "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler maintains. Must be
+          # a float value in the range (0, 1]. If not specified, the default is0.6.
+          #
+          # If the CPU level is below the target utilization, the autoscaler scales
+          # in the number of instances until it reaches the minimum number of
+          # instances you specified or until the average CPU of your instances
+          # reaches the target utilization.
+          #
+          # If the average CPU is above the target utilization, the autoscaler
+          # scales out until it reaches the maximum number of instances you
+          # specified or until the average utilization reaches the target
+          # utilization.
+    },
+    "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+      { # Custom utilization metric policy.
+        "filter": "A String", # A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is
+            # used to select a specific TimeSeries for the purpose of autoscaling and
+            # to determine whether the metric is exporting per-instance or
+            # per-group data.
+            #
+            # For the filter to be valid for autoscaling purposes, the following rules
+            # apply:
+            #
+            #
+            #     - You can only use the AND operator for joining
+            #        selectors.
+            #     - You can only use direct equality comparison operator
+            #        (=) without any functions for each selector.
+            #     - You can specify the metric in both the filter string and in the
+            #        metric field. However, if specified in both places, the metric must
+            #        be identical.
+            #     - The monitored resource type
+            #        determines what kind of values are expected for the metric. If it is
+            #        a gce_instance, the autoscaler expects the metric to
+            #        include a separate TimeSeries for each instance in a group. In such a
+            #        case, you cannot filter on resource labels.
+            #
+            #
+            #    If the resource type is any other value, the autoscaler expects
+            #        this metric to contain values that apply to the entire autoscaled
+            #        instance group and resource label filtering can be performed to
+            #        point autoscaler at the correct TimeSeries to scale upon. This is
+            #        called a *per-group metric* for the purpose of autoscaling.
+            #
+            #        If not specified, the type defaults to
+            #        gce_instance.
+            #
+            #
+            #
+            # Try to provide a filter that is selective enough to pick just one
+            # TimeSeries for the autoscaled group or for each of the instances (if you
+            # are using gce_instance resource type). If multiple
+            # TimeSeries are returned upon the query execution, the autoscaler will sum
+            # their respective values to obtain its scaling value.
+        "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric
+            # cannot have negative values.
+            #
+            # The metric must have a value type of INT64 orDOUBLE.
+        "singleInstanceAssignment": 3.14, # If scaling is based on a per-group metric value that represents the
+            # total amount of work to be done or resource usage, set this value to an
+            # amount assigned for a single instance of the scaled group. Autoscaler
+            # keeps the number of instances proportional to the value of this
+            # metric. The metric itself does not change value due to group
+            # resizing.
+            #
+            # A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages
+            # or a custom metric exporting the total number of requests coming to
+            # your instances.
+            #
+            # A bad example would be a metric exporting an average or median latency,
+            # since this value can't include a chunk assignable to a single instance,
+            # it could be better used with utilization_target instead.
+        "utilizationTarget": 3.14, # The target value of the metric that autoscaler maintains. This
+            # must be a positive value. A utilization metric scales number of
+            # virtual machines handling requests to increase or decrease
+            # proportionally to the metric.
+            #
+            # For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.
+            # The autoscaler works to keep this value constant for each of the
+            # instances.
+        "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver
+            # Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.
+      },
+    ],
+    "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+      "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(S) load balancing
+          # configuration) that the autoscaler maintains. Must be a positive float
+          # value. If not defined, the default is 0.8.
+    },
+    "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale out to. This
+        # is required when creating or updating an autoscaler. The maximum number
+        # of replicas must not be lower than minimal number of replicas.
+    "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale in to.
+        # This cannot be less than 0. If not provided, autoscaler chooses a
+        # default value depending on maximum number of instances allowed.
+    "mode": "A String", # Defines the operating mode for this policy.
+        # The following modes are available:
+        #
+        #    - OFF: Disables the autoscaler but maintains its
+        #    configuration.
+        #    - ONLY_SCALE_OUT: Restricts the autoscaler to add
+        #    VM instances only.
+        #    - ON: Enables all autoscaler activities according to its
+        #    policy.
+        #
+        #
+        # For more information, see
+        # "Turning off or restricting an autoscaler"
+    "scaleInControl": { # Configuration that allows for slower scale in so that even if Autoscaler
+        # recommends an abrupt scale in of a MIG, it will be throttled as specified
+        # by the parameters below.
+      "maxScaledInReplicas": { # Encapsulates numeric value that can be either absolute or relative. # Maximum allowed number (or %) of VMs that can be deducted from the peak
+          # recommendation during the window autoscaler looks at when computing
+          # recommendations. Possibly all these VMs can be deleted at once so user
+          # service needs to be prepared to lose that many VMs in one step.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+      "timeWindowSec": 42, # How far back autoscaling looks when computing recommendations to
+          # include directives regarding slower scale in, as described above.
+    },
+    "scalingSchedules": { # Scaling schedules defined for an autoscaler. Multiple schedules
+        # can be set on an autoscaler, and they can overlap. During overlapping
+        # periods the greatest min_required_replicas of all scaling schedules is
+        # applied. Up to 128 scaling schedules are allowed.
+      "a_key": { # Scaling based on user-defined schedule. The message describes a single
+          # scaling schedule. A scaling schedule changes the minimum number of VM
+          # instances an autoscaler can recommend, which can trigger scaling out.
+        "description": "A String", # A description of a scaling schedule.
+        "disabled": True or False, # A boolean value that specifies whether a scaling schedule can influence
+            # autoscaler recommendations. If set to true, then a scaling schedule has
+            # no effect. This field is optional, and its value is false by default.
+        "durationSec": 42, # The duration of time intervals, in seconds, for which this
+            # scaling schedule is to run. The minimum allowed value is 300.
+            # This field is required.
+        "minRequiredReplicas": 42, # The minimum number of VM instances that the autoscaler will
+            # recommend in time intervals starting according to schedule. This field is
+            # required.
+        "schedule": "A String", # The start timestamps of time intervals when this scaling
+            # schedule is to provide a scaling signal. This field uses the extended
+            # cron format (with an optional year field). The expression can describe a
+            # single timestamp if the optional year is set, in which case the scaling
+            # schedule runs once. The schedule is interpreted with respect to
+            # time_zone. This field is required. Note: These timestamps only describe
+            # when autoscaler starts providing the scaling signal. The VMs
+            # need additional time to become serving.
+        "timeZone": "A String", # The time zone to use when interpreting the schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://en.wikipedia.org/wiki/Tz_database. This field is assigned a
+            # default value of "UTC" if left empty.
+      },
+    },
+    "stabilizationPeriodSec": 42, # The number of seconds that autoscaler waits for load stabilization before
+        # making scale-in decisions. This is referred to as the
+        # [stabilization period](/compute/docs/autoscaler#stabilization_period).
+        # This might appear as a delay in scaling in but it is an important mechanism
+        # for your application to not have fluctuating size due to short term load
+        # fluctuations.
+        #
+        # The default stabilization period is 600 seconds.
+  },
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#autoscaler", # Output only. [Output Only] Type of the resource. Always compute#autoscaler
+      # for autoscalers.
+  "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.
+  "recommendedSize": 42, # Output only. [Output Only] Target recommended MIG size (number of instances) computed by
+      # autoscaler. Autoscaler calculates the recommended MIG size even when the
+      # autoscaling policy mode is different from ON. This field is empty when
+      # autoscaler is not connected to an existing managed instance group or
+      # autoscaler did not generate its prediction.
+  "region": "A String", # Output only. [Output Only] URL of theregion
+      # where the instance group resides (for autoscalers living in regional
+      # scope).
+  "scalingScheduleStatus": { # Output only. [Output Only] Status information of existing scaling schedules.
+    "a_key": {
+      "lastStartTime": "A String", # [Output Only] The last time the scaling schedule became active.
+          # Note: this is a timestamp when a schedule actually became active, not when
+          # it was planned to do so.
+          # The timestamp is in RFC3339
+          # text format.
+      "nextStartTime": "A String", # [Output Only] The next time the scaling schedule is to become active.
+          # Note: this is a timestamp when a schedule is planned to run, but the actual
+          # time might be slightly different.
+          # The timestamp is in RFC3339
+          # text format.
+      "state": "A String", # [Output Only] The current state of a scaling schedule.
+    },
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the autoscaler configuration. Current set of
+      # possible values:
+      # 
+      #    - PENDING:
+      #      Autoscaler backend hasn't read new/updated configuration.
+      #    - DELETING:
+      #      Configuration is being deleted.
+      #    - ACTIVE:
+      #      Configuration is acknowledged to be effective. Some warnings might
+      #      be present in the statusDetails field.
+      #    - ERROR:
+      #      Configuration has errors. Actionable for users. Details are present in
+      #      the statusDetails field.
+      # 
+      # 
+      # New values might be added in the future.
+  "statusDetails": [ # [Output Only] Human-readable details about the current state of the
+      # autoscaler. Read the documentation forCommonly
+      # returned status messages for examples of status messages you might
+      # encounter.
+    {
+      "message": "A String", # The status message.
+      "type": "A String", # The type of error, warning, or notice returned. Current set of possible
+          # values:
+          #
+          #    - ALL_INSTANCES_UNHEALTHY (WARNING):
+          #      All instances in the instance group are unhealthy (not in RUNNING
+          #      state).
+          #    - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
+          #      There is no backend service attached to the instance group.
+          #    - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):
+          #      Autoscaler recommends a size greater than maxNumReplicas.
+          #    - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):
+          #      The custom metric samples are not exported often enough to be
+          #      a credible base for autoscaling.
+          #    - CUSTOM_METRIC_INVALID (ERROR):
+          #      The custom metric that was specified does not exist or does not have
+          #      the necessary labels.
+          #    - MIN_EQUALS_MAX (WARNING):
+          #      The minNumReplicas is equal to maxNumReplicas. This means the
+          #      autoscaler cannot add or remove instances from the instance group.
+          #    - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):
+          #      The autoscaler did not receive any data from the custom metric
+          #      configured for autoscaling.
+          #    - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):
+          #      The autoscaler is configured to scale based on a load balancing signal
+          #      but the instance group has not received any requests from the load
+          #      balancer.
+          #    - MODE_OFF (WARNING):
+          #      Autoscaling is turned off. The number of instances in the group won't
+          #      change automatically. The autoscaling configuration is preserved.
+          #    - MODE_ONLY_UP (WARNING):
+          #      Autoscaling is in the "Autoscale only out" mode. The autoscaler can add
+          #      instances but not remove any.
+          #    - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):
+          #      The instance group cannot be autoscaled because it has more than one
+          #      backend service attached to it.
+          #    - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):
+          #      There is insufficient quota for the necessary resources, such as CPU or
+          #      number of instances.
+          #    - REGION_RESOURCE_STOCKOUT (ERROR):
+          #      Shown only for regional autoscalers: there is a resource stockout in
+          #      the chosen region.
+          #    - SCALING_TARGET_DOES_NOT_EXIST (ERROR):
+          #      The target to be scaled does not exist.
+          #    - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION
+          #      (ERROR): Autoscaling does not work with an HTTP/S load balancer that
+          #      has been configured for maxRate.
+          #    - ZONE_RESOURCE_STOCKOUT (ERROR):
+          #      For zonal autoscalers: there is a resource stockout in the chosen zone.
+          #      For regional autoscalers: in at least one of the zones you're using
+          #      there is a resource stockout.
+          #
+          #
+          # New values might be added in the future. Some of the values might not be
+          # available in all API versions.
+    },
+  ],
+  "target": "A String", # URL of the managed instance group that this autoscaler will scale. This
+      # field is required when creating an autoscaler.
+  "zone": "A String", # Output only. [Output Only] URL of thezone
+      # where the instance group resides (for autoscalers living in zonal scope).
+}
+
+  autoscaler: string, Name of the autoscaler to update.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionBackendBuckets.html b/docs/dyn/compute_preview.regionBackendBuckets.html new file mode 100644 index 0000000000..808b0ee755 --- /dev/null +++ b/docs/dyn/compute_preview.regionBackendBuckets.html @@ -0,0 +1,3604 @@ + + + +

Compute Engine API . regionBackendBuckets

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, backendBucket, requestId=None, x__xgafv=None)

+

Deletes the specified regional BackendBucket resource.

+

+ get(project, region, backendBucket, x__xgafv=None)

+

Returns the specified regional BackendBucket resource.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a RegionBackendBucket in the specified project in the given scope

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of BackendBucket resources available to the specified

+

+ listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of all usable backend buckets in the specified project in

+

+ listUsable_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, backendBucket, body=None, requestId=None, x__xgafv=None)

+

Updates the specified BackendBucket resource with the data included in the

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, backendBucket, requestId=None, x__xgafv=None) + 
Deletes the specified regional BackendBucket resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendBucket: string, Name of the BackendBucket 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, backendBucket, x__xgafv=None) + 
Returns the specified regional BackendBucket resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendBucket: string, Name of the BackendBucket 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 Storage Bucket resource.
+    #
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      #
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a RegionBackendBucket in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Storage Bucket resource.
+    # 
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      # 
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of BackendBucket resources available to the specified
+project in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of 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.
+  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 BackendBucket resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendBucket resources.
+    { # Represents a Cloud Storage Bucket resource.
+        #
+        # This Cloud Storage bucket resource is referenced by a URL map of a load
+        # balancer. For more information, readBackend Buckets.
+      "bucketName": "A String", # Cloud Storage bucket name.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+            # Cloud CDN.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+              # parameters are always included. '&' and '=' will be percent encoded
+              # and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+        "A String",
+      ],
+      "description": "A String", # An optional textual description of the resource; provided by the client
+          # when the resource is created.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend bucket.
+      "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+      "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+      "kind": "compute#backendBucket", # Output only. Type of the resource.
+      "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+          # load balancer.
+          #
+          # If loadBalancingScheme is not specified, the backend bucket can be used by
+          # classic global external load balancers, or global application external load
+          # balancers, or both.
+      "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.
+      "params": { # Additional Backend Bucket 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+          # resides. This field is not applicable to global backend buckets.
+          # 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.
+      "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+              # BackendBucket.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#backendBucketList", # 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.
+  "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.
+  },
+}
+
+ +
+ listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of all usable backend buckets in the specified project in
+the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request.
+It must be a string that meets the requirements in 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.
+  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 BackendBucket resources.
+    { # Represents a Cloud Storage Bucket resource.
+        #
+        # This Cloud Storage bucket resource is referenced by a URL map of a load
+        # balancer. For more information, readBackend Buckets.
+      "bucketName": "A String", # Cloud Storage bucket name.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+            # Cloud CDN.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+              # parameters are always included. '&' and '=' will be percent encoded
+              # and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+        "A String",
+      ],
+      "description": "A String", # An optional textual description of the resource; provided by the client
+          # when the resource is created.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend bucket.
+      "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+      "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+      "kind": "compute#backendBucket", # Output only. Type of the resource.
+      "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+          # load balancer.
+          #
+          # If loadBalancingScheme is not specified, the backend bucket can be used by
+          # classic global external load balancers, or global application external load
+          # balancers, or both.
+      "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.
+      "params": { # Additional Backend Bucket 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+          # resides. This field is not applicable to global backend buckets.
+          # 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.
+      "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+              # BackendBucket.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#usableBackendBucketList", # Output only. [Output Only] Type of resource. Alwayscompute#usableBackendBucketList for lists of usable backend
+      # buckets.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable_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, backendBucket, body=None, requestId=None, x__xgafv=None) + 
Updates the specified  BackendBucket 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)
+  backendBucket: string, Name of the BackendBucket resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Storage Bucket resource.
+    # 
+    # This Cloud Storage bucket resource is referenced by a URL map of a load
+    # balancer. For more information, readBackend Buckets.
+  "bucketName": "A String", # Cloud Storage bucket name.
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend bucket. # Cloud CDN configuration for this BackendBucket.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for # The CacheKeyPolicy for this CdnPolicy.
+        # Cloud CDN.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. Default
+          # parameters are always included. '&' and '=' will be percent encoded
+          # and not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customResponseHeaders": [ # Headers that the Application Load Balancer should add to proxied responses.
+    "A String",
+  ],
+  "description": "A String", # An optional textual description of the resource; provided by the client
+      # when the resource is created.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend bucket.
+  "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "kind": "compute#backendBucket", # Output only. Type of the resource.
+  "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7
+      # load balancer.
+      # 
+      # If loadBalancingScheme is not specified, the backend bucket can be used by
+      # classic global external load balancers, or global application external load
+      # balancers, or both.
+  "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.
+  "params": { # Additional Backend Bucket 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend bucket
+      # resides. This field is not applicable to global backend buckets.
+      # 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.
+  "usedBy": [ # Output only. [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for UrlMaps referencing that
+          # BackendBucket.
+    },
+  ],
+}
+
+  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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.regionBackendServices.html b/docs/dyn/compute_preview.regionBackendServices.html new file mode 100644 index 0000000000..c227bba590 --- /dev/null +++ b/docs/dyn/compute_preview.regionBackendServices.html @@ -0,0 +1,11354 @@ + + + +

Compute Engine API . regionBackendServices

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, backendService, requestId=None, x__xgafv=None)

+

Deletes the specified regional BackendService resource.

+

+ get(project, region, backendService, x__xgafv=None)

+

Returns the specified regional BackendService resource.

+

+ getHealth(project, region, backendService, body=None, x__xgafv=None)

+

Gets the most recent health check results for this

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a regional BackendService resource in the specified project using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of regional BackendService resources available to the

+

+ listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of all usable backend services for Application Load

+

+ listUsable_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, backendService, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional BackendService resource with the data

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setSecurityPolicy(project, region, backendService, body=None, requestId=None, x__xgafv=None)

+

Sets the Google Cloud Armor security policy for the specified backend

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, region, backendService, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional BackendService resource with the data

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, backendService, requestId=None, x__xgafv=None) + 
Deletes the specified regional BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, backendService, x__xgafv=None) + 
Returns the specified regional BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService 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 Backend Service resource.
+    #
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    #
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    #
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    #
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      #
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      #
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      #
+      # This field is applicable to either:
+      #
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      #
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      #
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      #
+      # The value of this field must be in the range [0, 100].
+      #
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      #
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      #
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      #
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      #
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      #
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      #
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      #
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      #
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      #
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      #
+      #
+      #
+      # This field is applicable to either:
+      #
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      #
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      #
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      #
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      #
+      #
+      #
+      # This field is applicable to either:
+      #
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      #
+      #
+      #
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      #
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      #
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      #
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      #
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      #
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      #
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      #
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      #
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      #
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      #
+      # Applicable backend endpoints can be:
+      #
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      #
+      #
+      #
+      # Applicable backend service types can be:
+      #
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      #
+      #
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      #
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      #
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      #
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      #
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      #
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      #
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      #
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      #
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      #
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+ +
+ getHealth(project, region, backendService, body=None, x__xgafv=None) + 
Gets the most recent health check results for this
+regional BackendService.
+
+Args:
+  project: string, A parameter (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource for which to get health. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "group": "A String", # A URI referencing one of the instance groups or network endpoint groups
+      # listed in the backend service.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "annotations": { # Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "healthStatus": [ # Health state of the backend instances or endpoints in requested instance or
+      # network endpoint group, determined based on configured health checks.
+    {
+      "annotations": { # Metadata defined as annotations for network endpoint.
+        "a_key": "A String",
+      },
+      "forwardingRule": "A String", # URL of the forwarding rule associated with the health status of the
+          # instance.
+      "forwardingRuleIp": "A String", # A forwarding rule IP address assigned to this instance.
+      "healthState": "A String", # Health state of the IPv4 address of the instance.
+      "instance": "A String", # URL of the instance resource.
+      "ipAddress": "A String", # For target pool based Network Load Balancing, it indicates the forwarding
+          # rule's IP address assigned to this instance. For other types of load
+          # balancing, the field indicates VM internal ip.
+      "ipv6Address": "A String",
+      "ipv6HealthState": "A String", # Health state of the IPv6 address of the instance.
+      "port": 42, # The named port of the instance group, not necessarily the port that is
+          # health-checked.
+      "weight": "A String",
+      "weightError": "A String",
+    },
+  ],
+  "kind": "compute#backendServiceGroupHealth", # Output only. [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend
+      # services.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a regional BackendService resource in the specified project using
+the data included in the request. For more information, see
+Backend services overview.
+
+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 Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of regional BackendService resources available to the
+specified 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.
+  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 BackendService resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendService resources.
+    { # Represents a Backend Service resource.
+        #
+        # A backend service defines how Google Cloud load balancers distribute traffic.
+        # The backend service configuration contains a set of values, such as the
+        # protocol used to connect to backends, various distribution and session
+        # settings, health checks, and timeouts. These settings provide fine-grained
+        # control over how your load balancer behaves. Most of the settings have
+        # default values that allow for easy configuration if you need to get started
+        # quickly.
+        #
+        # Backend services in Google Compute Engine can be either regionally or
+        # globally scoped.
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+        #
+        # For more information, seeBackend
+        # Services.
+      "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+          # Load Balancers and Traffic Director and requires
+          # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+          #
+          # If set to 0, the cookie is non-persistent and lasts only until
+          # the end of the browser session (or equivalent). The maximum allowed value
+          # is two weeks (1,209,600).
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+      "backends": [ # The list of backends that serve this BackendService.
+        { # Message containing information of one individual backend.
+          "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+              # handle additional traffic or is fully loaded. For usage guidelines, see
+              # Connection balancing mode.
+              #
+              # Backends must use compatible balancing modes. Backends of a backend
+              # service may use different balancing modes. For more information, see
+              # Supported balancing modes and target capacity settings and
+              # Restrictions and guidance for instance groups.
+              #
+              # Note: Currently, if you use the API to configure incompatible balancing
+              # modes, the configuration might be accepted even though it has no impact
+              # and is ignored. Specifically, Backend.maxUtilization is ignored when
+              # Backend.balancingMode is RATE. In the future, this incompatible combination
+              # will be rejected.
+          "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+              # mode.
+              # The default value is 1, which means the group serves up to
+              # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+              # completely drained, offering 0% of its available capacity. The valid ranges
+              # are 0.0 and [0.1,1.0].
+              # You cannot configure a setting larger than 0 and smaller than0.1.
+              # You cannot configure a setting of 0 when there is only one
+              # backend attached to the backend service.
+              #
+              # Not available with backends that don't support using abalancingMode. This includes backends such as global
+              # internet NEGs, regional serverless NEGs, and PSC NEGs.
+          "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+              # BalancingMode.
+            { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+              "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+                  # Monitoring, but is not used for load balancing.
+              "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+                  # balancing mode. The valid range is [0.0, 1.0].
+              "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                  # long and match the regular expression
+                  # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                  # first character must be a lowercase letter, and all following
+                  # characters must be a dash, period, underscore, lowercase letter, or
+                  # digit, except the last character, which cannot be a dash, period, or
+                  # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                  # field can only be used for a global or regional backend service with the
+                  # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+            },
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one
+              # failover backend can be configured for a given BackendService.
+              #
+              # This field can only be used for a regional external Passthrough Network
+              # Load Balancer or a regional internal Passthrough Network Load Balancer.
+          "group": "A String", # The fully-qualified URL of aninstance
+              # group or network endpoint
+              # group (NEG) resource. To determine what types of backends a load
+              # balancer supports, see the [Backend services
+              # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+              #
+              # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+              # or NEG. Partial URLs are not supported.
+              #
+              # If haPolicy is specified, backends must refer to NEG resources of type
+              # GCE_VM_IP.
+          "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode. Not available if the backend'sbalancingMode is RATE.
+          "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+              # For usage guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+              # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+              # usage guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+              #
+              # 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:
+              #
+              #    - PREFERRED: Backends with this preference level will be
+              #    filled up to their capacity limits first, based on RTT.
+              #    - DEFAULT:  If preferred backends don't have enough
+              #    capacity, backends in this layer would be used and traffic would be
+              #    assigned based on the load balancing algorithm you use. This is the
+              #    default
+              #
+              #
+              #
+              # For global external Passthrough Network Load Balancers, the following
+              # restrictions apply:
+              #
+              #    - At most one backend can be marked as PREFERRED.
+              #    - PREFERRED and DEFAULT backends cannot reside
+              #    in the same Cloud region.
+          "trafficDuration": "A String",
+        },
+      ],
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+          # specified load balancer types.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+            # CDN.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # query_string_whitelist and query_string_blacklist. If neither is set, the
+              # entire query string will be included. If false, the query string will be
+              # excluded from the cache key entirely.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+          # backend service.
+        "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+            # there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+            # not specified, there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+            # service. If not specified, there is no limit.
+        "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+            # This parameter is respected by both the HTTP/1.1 and HTTP/2
+            # implementations. If not specified, there is no limit. Setting this
+            # parameter to 1 will effectively disable keep alive.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+            # not specified, the default is 1.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+        "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+            # instance. For supported load balancers and protocols, as described inEnabling
+            # connection draining.
+      },
+      "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+          # tracking policy settings are only available for external passthrough
+          # Network Load Balancers and internal passthrough Network Load Balancers.
+          #
+          # connectionTrackingPolicy cannot be specified with haPolicy.
+        "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+            # value is DEFAULT_FOR_PROTOCOL.
+            #
+            # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+            # persist on unhealthy backends only for connection-oriented protocols
+            # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+            # Affinity is configured for 5-tuple. They do not persist forUDP.
+            #
+            # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+            # the existing connections on the unhealthy backend are never persisted on
+            # the unhealthy backend. They are always diverted to newly selected healthy
+            # backends (unless all backends are unhealthy).
+            #
+            # If set to ALWAYS_PERSIST, existing connections always
+            # persist on unhealthy backends regardless of protocol and session
+            # affinity. It is generally not recommended to use this mode overriding the
+            # default.
+            #
+            # For more details, see [Connection Persistence for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+            # and [Connection Persistence for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+        "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+            # Balancers. This option is not available publicly.
+        "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+            # matching traffic (in seconds).
+            #
+            # For internal passthrough Network Load Balancers:
+            #
+            #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+            #    - It can be set only if Connection Tracking is less than 5-tuple
+            #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+            #    Mode is PER_SESSION).
+            #
+            #
+            #
+            # For external passthrough Network Load Balancers the default is 60
+            # seconds. This option is not available publicly.
+        "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+            # options:
+            #
+            #    - PER_CONNECTION: This is the default mode. The Connection
+            #    Tracking is performed as per the Connection Key (default Hash Method) for
+            #    the specific protocol.
+            #    - PER_SESSION: The Connection Tracking is performed as per
+            #    the configured Session Affinity. It matches the configured Session
+            #    Affinity.
+            #
+            #
+            #
+            # For more details, see [Tracking Mode for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+            # and [Tracking Mode for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+      },
+      "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+          # affinity based on HTTP headers, cookies or other properties. This load
+          # balancing policy is applicable only for HTTP connections. The affinity to a
+          # particular destination host will be lost when one or more hosts are
+          # added/removed from the destination service. This field specifies parameters
+          # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+            # be used as the hash key for the consistent hash load balancer. If the
+            # cookie is not present, it will be generated. This field is applicable if
+            # the sessionAffinity is set to HTTP_COOKIE.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+            # for load balancing policies that use a consistent hash.
+          "name": "A String", # Name of the cookie.
+          "path": "A String", # Path to set for the cookie.
+          "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+            # applicable if the sessionAffinity is set toHEADER_FIELD.
+        "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+            # 1024. Larger ring sizes result in more granular load distributions. If the
+            # number of hosts in the load balancing pool is larger than the ring size,
+            # each host will be assigned a single virtual node.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+        { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+            # locality_lb_policy.
+          "dryRun": True or False, # If true, the metric data is not used for load balancing.
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend service.
+      "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+          # global external Application Load Balancer.
+      "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+          # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+          # externalManagedMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+          # external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # Session affinity options will slightly affect this routing behavior, for
+          # more details, see:Session
+          # Affinity.
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+          # as a backup (failover) backend.
+          # For load balancers that have configurable failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+          # Network Load Balancers.
+          # failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough
+          # Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # On failover or failback, this field indicates whether connection draining
+          # will be honored. Google Cloud has a fixed connection draining timeout of
+          # 10 minutes. A setting of true terminates existing TCP
+          # connections to the active pool during failover and failback, immediately
+          # draining traffic. A setting of false allows existing TCP
+          # connections to persist, even on VMs no longer in the active pool, for up
+          # to the duration of the connection draining timeout (10 minutes).
+        "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+            #
+            # The default is false.
+        "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+            # load balancer are dropped when all primary and all backup backend VMs are
+            # unhealthy.If set to false, connections are distributed
+            # among all primary VMs when all primary and all backup backend VMs are
+            #  unhealthy.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+            # The default is false.
+        "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+            # failover when the number of healthy primary VMs equals zero.
+            # For all other values, the load balancer performs a failover when the
+            # total number of healthy primary VMs is less than this ratio.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      },
+      "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 BackendService. An up-to-date fingerprint must be provided in
+          # order to update the BackendService, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a BackendService.
+      "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+          # Protocol Forwarding.
+          #
+          # The backends of this regional backend service must only specify zonal
+          # network endpoint groups (NEGs) of type GCE_VM_IP.
+          #
+          # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+          # regional backend service must set the network field. All zonal NEGs must
+          # belong to the same network. However, individual NEGs can
+          # belong to different subnetworks of that network.
+          #
+          # When haPolicy is specified, the set of attached network endpoints across
+          # all backends comprise an High Availability domain from which one endpoint
+          # is selected as the active endpoint (the leader) that receives all
+          # traffic.
+          #
+          # haPolicy can be added only at backend service creation time. Once set up,
+          # it cannot be deleted.
+          #
+          # Note that haPolicy is not for load balancing, and therefore cannot be
+          # specified with sessionAffinity, connectionTrackingPolicy, and
+          # failoverPolicy.
+          #
+          # haPolicy requires customers to be responsible for tracking backend
+          # endpoint health and electing a leader among the healthy endpoints.
+          # Therefore, haPolicy cannot be specified with healthChecks.
+          # haPolicy can only be specified for External Passthrough
+          # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+          # Load Balancers.
+        "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+            # achieve it.
+            #
+            # Supported values are:
+            #
+            #    - DISABLED: Fast IP Move is disabled. You can only use the
+            #    haPolicy.leader API to update the leader.
+            #    - >GARP_RA: Provides a method to very quickly define a new network
+            #    endpoint as the leader. This method is faster than updating the leader
+            #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+            #    hosting the network endpoint that should become the new leader sends
+            #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+            #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+            #    temporarily associates the forwarding rule IP address with that VM, and
+            #    both new and in-flight packets are quickly delivered to that VM.
+            #
+            #
+            #
+            # Note the important properties of the Fast IP Move functionality:
+            #
+            #    - The GARP/RA-initiated re-routing stays active for approximately 20
+            #    minutes. After triggering fast failover, you must also
+            #    appropriately set the haPolicy.leader.
+            #    -  The new leader instance should continue to send GARP/RA packets
+            #    periodically every 10 seconds until at least 10 minutes after updating
+            #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+            #    - After triggering a fast failover, we recommend that you wait at least
+            #    3 seconds before sending another GARP/RA packet from a different VM
+            #    instance to avoid race conditions.
+            #    - Don't send GARP/RA packets from different VM
+            #    instances at the same time. If multiple instances continue to send
+            #    GARP/RA packets, traffic might be routed to different destinations in an
+            #    alternating order. This condition ceases when a single instance
+            #    issues a GARP/RA packet.
+            #    - The GARP/RA request always takes priority over the leader API.
+            #    Using the haPolicy.leader API to change the leader to a different
+            #    instance will have no effect until the GARP/RA request becomes
+            #    inactive.
+            #    - The GARP/RA packets should follow the GARP/RA
+            #    Packet Specifications..
+            #    -  When multiple forwarding rules refer to a regional backend service,
+            #    you need only send a GARP or RA packet for a single forwarding rule
+            #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+            #    backend service will also be moved to the sender of the GARP or RA
+            #    packet.
+            #
+            #
+            #
+            # The following are the Fast IP Move limitations (that is, when fastIPMove
+            # is not DISABLED):
+            #
+            #    - Multiple forwarding rules cannot use the same IP address if one of
+            #    them refers to a regional backend service with fastIPMove.
+            #    - The regional backend service must set the network field, and all
+            #    NEGs must belong to that network. However, individual
+            #    NEGs can belong to different subnetworks of that network.
+            #    - The maximum number of network endpoints across all backends of a
+            #    backend service with fastIPMove is 32.
+            #    - The maximum number of backend services with fastIPMove that can have
+            #    the same network endpoint attached to one of its backends is 64.
+            #    - The maximum number of backend services with fastIPMove in a VPC in a
+            #    region is 64.
+            #    - The network endpoints that are attached to a backend of a backend
+            #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+            #    - Traffic directed to the leader by a static route next hop will not be
+            #    redirected to a new leader by fast failover. Such traffic will only be
+            #    redirected once an haPolicy.leader update has taken effect. Only traffic
+            #    to the forwarding rule's virtual IP will be redirected to a new leader by
+            #    fast failover.
+            #
+            #
+            # haPolicy.fastIPMove can be set only at backend service creation time.
+            # Once set, it cannot be updated.
+            #
+            # By default, fastIpMove is set to DISABLED.
+        "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+            # this service as the active endpoint (the leader) that receives all
+            # traffic.
+            #
+            # When the leader changes, there is no connection draining to persist
+            # existing connections on the old leader.
+            #
+            # You are responsible for selecting a suitable endpoint as the
+            # leader. For example, preferring a healthy endpoint over unhealthy ones.
+            # Note that this service does not track backend endpoint health, and
+            # selects the configured leader unconditionally.
+          "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+              # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+              # that the leader is attached to.
+              #
+              # The leader's backendGroup must already be specified as a backend of
+              # this backend service. Removing a backend that is designated as the
+              # leader's backendGroup is not permitted.
+          "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+              # designated as the leader.
+              #
+              # This network endpoint cannot be detached from the NEG specified in
+              # the haPolicy.leader.backendGroup until the leader is updated with
+              # another network endpoint, or the leader is removed from the haPolicy.
+            "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+                # instance must already be attached to the NEG specified in the
+                # haPolicy.leader.backendGroup.
+                #
+                # The value must be a valid RFC1035 name (1-63 characters) or a valid
+                # instance URL.
+                # Authorization requires the following IAM permission on the
+                # specified resource instance: compute.instances.use
+          },
+        },
+      },
+      "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+          # httpsHealthChecks (legacy) resource for health checking this backend
+          # service. Not all backend services support legacy health checks. See
+          # Load balancer guide. Currently, at most one health check can be
+          # specified for each backend service. Backend services with
+          # instance group or zonal NEG backends must have a health check unless
+          # haPolicy is specified. Backend services with internet or serverless NEG
+          # backends must not have a health check.
+          #
+          # healthChecks[] cannot be specified with haPolicy.
+        "A String",
+      ],
+      "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+          # Not available for internal passthrough Network Load Balancers and external
+          # passthrough Network Load Balancers.
+        "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+            # incoming requests.
+        "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+        "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+            # For security reasons, this value cannot be retrieved via the API.
+            # Instead, the SHA-256 hash of the value is returned in the
+            # oauth2ClientSecretSha256 field.
+            #
+            # @InputOnly
+        "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+          # from the client to the backend for proxyless gRPC).
+          # The possible values are:
+          #
+          #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv4
+          #    health checks are used to check the health of the backends. This is the
+          #    default setting.
+          #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+          #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+          #    address).
+          #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv6
+          #    health checks are used to check the health of the backends.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    -  Advanced global external Application Load Balancer (load balancing
+          #    scheme EXTERNAL_MANAGED),
+          #    -  Regional external Application Load
+          #    Balancer,
+          #    -  Internal proxy Network Load Balancer (load balancing
+          #    scheme INTERNAL_MANAGED),
+          #    -  Regional internal Application Load
+          #    Balancer (load balancing scheme INTERNAL_MANAGED),
+          #    -  Traffic
+          #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+          #    INTERNAL_SELF_MANAGED).
+      "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+          # for backend services.
+      "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+          # created for one type of load balancer cannot be used with another.
+          # For more information, refer to
+          # Backend services product and scheme table.
+      "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+          # preference. When you use localityLbPolicies, you must set at least one
+          # value for either the localityLbPolicies[].policy or the
+          # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+          # value set in the localityLbPolicy field.
+          #
+          # For an example of how to use this field, seeDefine
+          # a list of preferred policies.
+          #
+          # Caution: This field and its children are intended for use in a service mesh
+          # that includes gRPC clients only. Envoy proxies can't use backend services
+          # that have this configuration.
+        { # Container for either a built-in LB policy supported by gRPC or Envoy or
+            # a custom one implemented by the end user.
+          "customPolicy": { # The configuration for a custom policy implemented by the user and
+              # deployed with the client.
+            "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+                # by a locally installed custom policy implementation.
+            "name": "A String", # Identifies the custom policy.
+                #
+                # The value should match the name of a custom implementation registered
+                # on the gRPC clients. It should follow protocol buffer message naming
+                # conventions and include the full path (for example,
+                # myorg.CustomLbPolicy). The maximum length is 256 characters.
+                #
+                # Do not specify the same custom policy more than once for a
+                # backend. If you do, the configuration is rejected.
+                #
+                # For an example of how to use this field, seeUse
+                # a custom policy.
+          },
+          "policy": { # The configuration for a built-in load balancing policy.
+            "name": "A String", # The name of a locality load-balancing policy. Valid values include
+                # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+                # about these values, see the description of localityLbPolicy.
+                #
+                # Do not specify the same policy more than once for a
+                # backend. If you do, the configuration is rejected.
+          },
+        },
+      ],
+      "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+          # possible values are:
+          #
+          #    - ROUND_ROBIN: This is a simple policy in which each healthy
+          #    backend is selected in round robin order. This is the default.
+          #    - LEAST_REQUEST: An O(1) algorithm which
+          #    selects two random healthy hosts and picks the host which has fewer active
+          #    requests.
+          #    - RING_HASH: The ring/modulo hash load balancer implements
+          #    consistent hashing to backends. The algorithm has the property that the
+          #    addition/removal of a host from a set of N hosts only affects 1/N of the
+          #    requests.
+          #    - RANDOM: The load balancer selects a random healthy
+          #    host.
+          #    - ORIGINAL_DESTINATION: Backend host is selected
+          #    based on the client connection metadata, i.e., connections are opened to
+          #    the same address as the destination address of the incoming connection
+          #    before the connection was redirected to the load balancer.
+          #    - MAGLEV: used as a drop in replacement for the ring hash
+          #    load balancer. Maglev is not as stable as ring hash but has faster table
+          #    lookup build times and host selection times. For more information about
+          #    Maglev, see Maglev:
+          #    A Fast and Reliable Software Network Load Balancer.
+          #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+          #    Load Balancing using weights computed from Backend reported Custom Metrics.
+          #    If set, the Backend Service responses are expected to contain non-standard
+          #    HTTP response header field Endpoint-Load-Metrics. The reported
+          #    metrics to use for computing the weights are specified via thecustomMetrics field.
+          #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+          #    health check reported weights. If set, the backend service must configure
+          #    an HTTP-based Health Check, and health check replies are expected to
+          #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+          #    weights. If set, load balancing is weighted based on the per-endpoint
+          #    weights reported in the last processed health check replies, as long as
+          #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+          #    Otherwise, load balancing remains equal-weight.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+          #    EXTERNAL_MANAGED.
+          #
+          #
+          #
+          # If sessionAffinity is not configured—that is, if session
+          # affinity remains at the default value of NONE—then the
+          # default value for localityLbPolicy
+          # is ROUND_ROBIN. If session affinity is set to a value other
+          # than NONE,
+          # then the default value for localityLbPolicy isMAGLEV.
+          #
+          # Only ROUND_ROBIN and RING_HASH are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # localityLbPolicy cannot be specified with haPolicy.
+      "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+          # by this backend service. If logging is enabled, logs will be exported to
+          # Stackdriver.
+          # backend service.
+        "enable": True or False, # Denotes whether to enable logging for the load balancer
+            # traffic served by this backend service. The default value is false.
+        "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+            # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+            # of optional fields you want to include in the logs. For example:
+            # serverInstance, serverGkeDetails.cluster,
+            # serverGkeDetails.pod.podNamespace
+          "A String",
+        ],
+        "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+            # service. Configures whether all, none or a subset of optional fields
+            # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+            # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+        "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+            # service. The value of the field must be in [0, 1]. This configures the
+            # sampling rate of requests to the load balancer where 1.0 means all logged
+            # requests are reported and 0.0 means no logged requests are reported. The
+            # default value is 1.0.
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+          # service. Duration is computed from the beginning of the stream until the
+          # response has been completely processed, including all retries. A stream
+          # that does not complete in this duration is closed.
+          #
+          # If not specified, there will be no timeout limit, i.e. the maximum
+          # duration is infinite.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # This field is only allowed when the loadBalancingScheme of
+          # the backend service is INTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+          # controller and read by the backend RCTH
+        "a_key": "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.
+      "network": "A String", # The URL of the network to which this backend service belongs.
+          #
+          # This field must be set for Internal Passthrough Network Load Balancers when
+          # the haPolicy is enabled, and for External Passthrough Network Load
+          # Balancers when the haPolicy fastIpMove is enabled.
+          #
+          # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+      "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+          # Load Balancers.
+          #
+          # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+        "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+            # endpoints in the local zone.
+          "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+              # possible values are:
+              #
+              #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+              #    is disabled. The load balancer distributes new connections to all
+              #    healthy backend endpoints across all zones.
+              #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there are no healthy
+              #    backend endpoints in the local zone, the load balancer distributes
+              #    new connections to all backend endpoints in the local zone.
+              #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there aren't enough
+              #    healthy backend endpoints in the local zone, the load balancer
+              #    distributes new connections to all healthy backend endpoints across all
+              #    zones.
+          "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+              # of healthy backend endpoints in a zone to the count of backend
+              # endpoints in that same zone is equal to or above this threshold, the
+              # load balancer distributes new connections to all healthy endpoints in
+              # the local zone only. When the ratio of the count of healthy backend
+              # endpoints in a zone to the count of backend endpoints in that same
+              # zone is below this threshold, the load balancer distributes all new
+              # 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
+          # considered disabled.
+          #
+          # Results of the outlier detection algorithm (ejection of endpoints from the
+          # load balancing pool and returning them back to the pool) are executed
+          # independently by each proxy instance of the load balancer. In most cases,
+          # more than one proxy instance handles the traffic received by a backend
+          # service. Thus, it is possible that an unhealthy endpoint is detected and
+          # ejected by only some of the proxies, and while this happens, other proxies
+          # may continue to send requests to the same unhealthy endpoint until they
+          # detect and eject the unhealthy endpoint.
+          #
+          # Applicable backend endpoints can be:
+          #
+          #    - VM instances in an Instance Group
+          #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+          #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+          #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+          #    Functions Services
+          #    - Private Service Connect NEGs, that resolve to
+          #    Google-managed regional API endpoints or managed services published using
+          #    Private Service Connect
+          #
+          #
+          #
+          # Applicable backend service types can be:
+          #
+          #    - A global backend service with the loadBalancingScheme set to
+          #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+          #    - A regional backend
+          #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+          #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+          #    supported for Serverless NEGs.
+          #
+          #
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # pool for the backend service.
+        "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+            # or 30s.
+            #
+            # After a backend endpoint is returned back to the load balancing pool, it
+            # can be ejected again in another ejection analysis. Thus, the total ejection
+            # time is equal to the base ejection time multiplied by the number of times
+            # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+            # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+            # return code qualifies as an error. Defaults to 5.
+        "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+            # connection errors that are mapped to one of those status codes) before a
+            # consecutive gateway failure ejection occurs. Defaults to 3.
+        "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive 5xx. This setting can be
+            # used to disable ejection or to ramp it up slowly. Defaults to 0.
+        "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive gateway failures. This
+            # setting can be used to disable ejection or to ramp it up slowly. Defaults
+            # to 100.
+        "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through success rate statistics. This setting
+            # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+            # ejections and backend endpoints being returned to service. The interval is
+            # equal to the number of seconds as defined in
+            # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+            # in outlierDetection.interval.nanos. Defaults to 1 second.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+            # backend service that can be ejected if the ejection conditions are met.
+            # Defaults to 50%.
+        "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+            # enough request volume to detect success rate outliers. If the number of
+            # backend endpoints is fewer than this setting, outlier detection via success
+            # rate statistics is not performed for any backend endpoint in the load
+            # balancing pool. Defaults to 5.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+            # (as defined by the interval duration above) to include this backend
+            # endpoint in success rate based outlier detection. If the volume is lower
+            # than this setting, outlier detection via success rate statistics is not
+            # performed for that backend endpoint. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+            # outlier ejection. The ejection threshold is the difference between the mean
+            # success rate, and the product of this factor and the standard deviation of
+            # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+            # is divided by a thousand to get a double. That is, if the desired factor
+            # is 1.9, the runtime value should be 1900. Defaults to 1900.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+      },
+      "params": { # Additional Backend Service 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+          # the backend. The default value is 80.
+          # For internal passthrough Network Load Balancers and external passthrough
+          # Network Load Balancers, omit port.
+      "portName": "A String", # A named port on a backend instance group representing the port for
+          # communication to the backend VMs in that group. The
+          # named port must be [defined on each backend instance
+          # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+          # This parameter has no meaning if the backends are NEGs. For internal
+          # passthrough Network Load Balancers and external passthrough Network Load
+          # Balancers, omit port_name.
+      "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+          #
+          # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+          # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+          # configuration.
+          # Refer to
+          # Load balancing features for more information.
+          #
+          # Must be set to GRPC when the backend service is referenced by a URL map
+          # that is bound to target gRPC proxy.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+          # resides. This field is not applicable to global backend services.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # backend service.
+      "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+          # service. This field is applicable to a global backend service with the
+          # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+            # storage buckets that support AWS's Signature Version 4 for authentication.
+            # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+            # private storage buckets that support Signature Version 4 for authentication.
+            # The service name for generating the authentication header will always default
+            # to 's3'.
+          "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+              # creating a backend that uses AWS v4 signature authentication, but will not
+              # be returned as part of the configuration when queried with a REST API GET
+              # request.
+              #
+              # @InputOnly
+          "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+          "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+              # keep track of different iterations of your access key.
+          "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+              # the name of the region your cloud uses to host your origin.  For example,
+              # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+        },
+        "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+            # that describes how clients should authenticate with this service's
+            # backends.
+            #
+            #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+            # to INTERNAL_SELF_MANAGED.
+            #
+            #  If left blank, communications are not encrypted.
+        "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+            # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+            # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+            # specified values, the communication continues. Otherwise, it fails. This
+            # additional check enables the client to verify that the server is authorized
+            # to run the requested service.
+            #
+            #  Note that the contents of the server
+            # certificate's subjectAltName field are configured by the
+            # Public Key Infrastructure which provisions server identities.
+            #
+            #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+            # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+            # mode).
+          "A String",
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+          #
+          # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+          # If set, lists of backends and health checks must be both empty.
+        "A String",
+      ],
+      "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+          #
+          # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+          # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+          # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+          # global backend service, the service lb policy must be global. For a
+          # regional backend service, the service lb policy must be regional and in the
+          # same region.
+      "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+          #
+          # Only NONE and HEADER_FIELD are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # For more details, see:
+          # [Session
+          # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+          #
+          # sessionAffinity cannot be specified with haPolicy.
+      "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+          # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+        "name": "A String", # Name of the cookie.
+        "path": "A String", # Path to set for the cookie.
+        "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+          # Currently this is applicable only for Internal TCP/UDP load balancing,
+          # Internal HTTP(S) load balancing and Traffic Director.
+        "policy": "A String",
+      },
+      "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+          # type of load balancer. For more information see,
+          # Backend service settings.
+          # The default is 30 seconds.
+          # The full range of timeout values allowed goes from 1
+          # through 2,147,483,647 seconds.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # Instead, use maxStreamDuration.
+      "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+          # when the backend protocol is SSL, HTTPS or HTTP2.
+        "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+            # networksecurity.googleapis.com namespace. Can be used in authenticating
+            # TLS connections to the backend, as specified by the authenticationMode
+            # field. Can only be specified if authenticationMode is not NONE.
+        "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+            #
+            #
+            # Use this property to configure the load balancer back-end to use
+            # certificates and roots of trust provisioned by the Managed Workload
+            # Identity system.
+            #
+            #  The `identity` property is the
+            # fully-specified SPIFFE ID to use in the SVID presented by the Load
+            # Balancer Workload.
+            #
+            #  The SPIFFE ID must be a resource starting with the
+            # `trustDomain` property value, followed by the path to the Managed
+            # Workload Identity.
+            #
+            #  Supported SPIFFE ID format:
+            #
+            #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+            #
+            #
+            # The Trust Domain within the Managed Identity must refer to a valid
+            # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+            # will be inherited from the Workload Identity Pool.
+            #
+            #  Restrictions:
+            #
+            #    - If you set the `identity` property, you cannot manually set
+            #    the following fields:
+            #        - tlsSettings.sni
+            #       - tlsSettings.subjectAltNames
+            #       - tlsSettings.authenticationConfig
+            #
+            #
+            # When defining a `identity` for a RegionBackendServices, the
+            # corresponding Workload Identity Pool must have a ca_pool
+            # configured in the same region.
+            #
+            #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+        "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+            # balancer sends this string as the SNI hostname in the TLS connection to
+            # the backend, and requires that this string match a Subject Alternative
+            # Name (SAN) in the backend's server certificate. With a Regional Internet
+            # NEG backend, if the SNI is specified here, the load balancer uses it
+            # regardless of whether the Regional Internet NEG is specified with FQDN or
+            # IP address and port. When both sni and subjectAltNames[] are specified,
+            # the load balancer matches the backend certificate's SAN only to
+            # subjectAltNames[].
+        "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+            # verifies during a TLS handshake with the backend. When the server
+            # presents its X.509 certificate to the Load Balancer, the Load Balancer
+            # inspects the certificate's SAN field, and requires that at least one SAN
+            # match one of the subjectAltNames in the list. This field is limited to 5
+            # entries. When both sni and subjectAltNames[] are specified, the load
+            # balancer matches the backend certificate's SAN only to subjectAltNames[].
+          { # A Subject Alternative Name that the load balancer matches against the SAN
+              # field in the TLS certificate provided by the backend, specified as either
+              # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+            "dnsName": "A String", # The SAN specified as a DNS Name.
+            "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+          },
+        ],
+      },
+      "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+              # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+              # and ForwardingRule.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#backendServiceList", # Output only. [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of all usable backend services for Application Load
+Balancers and Proxy Network Load Balancers in the specified project in the
+given region. Backend services for external and internal passthrough
+Network Load Balancers are not included in the response.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request.
+It must be a string that meets the requirements in 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.
+  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 usable BackendService resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of BackendService resources.
+    { # Represents a Backend Service resource.
+        #
+        # A backend service defines how Google Cloud load balancers distribute traffic.
+        # The backend service configuration contains a set of values, such as the
+        # protocol used to connect to backends, various distribution and session
+        # settings, health checks, and timeouts. These settings provide fine-grained
+        # control over how your load balancer behaves. Most of the settings have
+        # default values that allow for easy configuration if you need to get started
+        # quickly.
+        #
+        # Backend services in Google Compute Engine can be either regionally or
+        # globally scoped.
+        #
+        # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+        # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+        #
+        # For more information, seeBackend
+        # Services.
+      "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+          # Load Balancers and Traffic Director and requires
+          # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+          #
+          # If set to 0, the cookie is non-persistent and lasts only until
+          # the end of the browser session (or equivalent). The maximum allowed value
+          # is two weeks (1,209,600).
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+      "backends": [ # The list of backends that serve this BackendService.
+        { # Message containing information of one individual backend.
+          "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+              # handle additional traffic or is fully loaded. For usage guidelines, see
+              # Connection balancing mode.
+              #
+              # Backends must use compatible balancing modes. Backends of a backend
+              # service may use different balancing modes. For more information, see
+              # Supported balancing modes and target capacity settings and
+              # Restrictions and guidance for instance groups.
+              #
+              # Note: Currently, if you use the API to configure incompatible balancing
+              # modes, the configuration might be accepted even though it has no impact
+              # and is ignored. Specifically, Backend.maxUtilization is ignored when
+              # Backend.balancingMode is RATE. In the future, this incompatible combination
+              # will be rejected.
+          "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+              # mode.
+              # The default value is 1, which means the group serves up to
+              # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+              # completely drained, offering 0% of its available capacity. The valid ranges
+              # are 0.0 and [0.1,1.0].
+              # You cannot configure a setting larger than 0 and smaller than0.1.
+              # You cannot configure a setting of 0 when there is only one
+              # backend attached to the backend service.
+              #
+              # Not available with backends that don't support using abalancingMode. This includes backends such as global
+              # internet NEGs, regional serverless NEGs, and PSC NEGs.
+          "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+              # BalancingMode.
+            { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+              "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+                  # Monitoring, but is not used for load balancing.
+              "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+                  # balancing mode. The valid range is [0.0, 1.0].
+              "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+                  # long and match the regular expression
+                  # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+                  # first character must be a lowercase letter, and all following
+                  # characters must be a dash, period, underscore, lowercase letter, or
+                  # digit, except the last character, which cannot be a dash, period, or
+                  # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+                  # field can only be used for a global or regional backend service with the
+                  # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+            },
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one
+              # failover backend can be configured for a given BackendService.
+              #
+              # This field can only be used for a regional external Passthrough Network
+              # Load Balancer or a regional internal Passthrough Network Load Balancer.
+          "group": "A String", # The fully-qualified URL of aninstance
+              # group or network endpoint
+              # group (NEG) resource. To determine what types of backends a load
+              # balancer supports, see the [Backend services
+              # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+              #
+              # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+              # or NEG. Partial URLs are not supported.
+              #
+              # If haPolicy is specified, backends must refer to NEG resources of type
+              # GCE_VM_IP.
+          "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode. Not available if the backend'sbalancingMode is RATE.
+          "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+              # guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+              # For usage guidelines, seeConnection
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isRATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+              # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+              # Not available if backend's balancingMode is RATE
+              # or CONNECTION.
+          "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+              # usage guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+              # guidelines, seeRate
+              # balancing mode and Utilization
+              # balancing mode.
+              #
+              # Not available if the backend's balancingMode isCONNECTION.
+          "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+              #
+              # 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:
+              #
+              #    - PREFERRED: Backends with this preference level will be
+              #    filled up to their capacity limits first, based on RTT.
+              #    - DEFAULT:  If preferred backends don't have enough
+              #    capacity, backends in this layer would be used and traffic would be
+              #    assigned based on the load balancing algorithm you use. This is the
+              #    default
+              #
+              #
+              #
+              # For global external Passthrough Network Load Balancers, the following
+              # restrictions apply:
+              #
+              #    - At most one backend can be marked as PREFERRED.
+              #    - PREFERRED and DEFAULT backends cannot reside
+              #    in the same Cloud region.
+          "trafficDuration": "A String",
+        },
+      ],
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+          # specified load balancer types.
+        "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+            # Pragma or Authorization headers. Up to 5 headers can be specified.
+            # The cache is bypassed for all cdnPolicy.cacheMode settings.
+          { # Bypass the cache when the specified request headers are present,
+              # e.g. Pragma or Authorization headers. Values are case insensitive.
+              # The presence of such a header overrides the cache_mode setting.
+            "headerName": "A String", # The header field name to match on when bypassing cache.
+                # Values are case-insensitive.
+          },
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+            # CDN.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # query_string_whitelist and query_string_blacklist. If neither is set, the
+              # entire query string will be included. If false, the query string will be
+              # excluded from the cache key entirely.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify query_string_whitelist or
+              # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+              # not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+            # The possible values are:
+            # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+            # headers to cache content. Responses without these headers will not be
+            # cached at Google's edge, and will require a full trip to the origin on
+            # every request, potentially impacting performance and increasing load on
+            # the origin server.
+            # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+            # "no-store" or "no-cache" directives in Cache-Control response headers.
+            # Warning: this may result in Cloud CDN caching private,
+            # per-user (user identifiable) content.
+            # CACHE_ALL_STATIC Automatically cache static content,
+            # including common image formats, media (video and audio), and web assets
+            # (JavaScript and CSS). Requests and responses that are marked as
+            # uncacheable, as well as dynamic content (including HTML), will not be
+            # cached.
+            #
+            # If no value is provided for cdnPolicy.cacheMode, it defaults
+            # to CACHE_ALL_STATIC.
+        "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+            # used to clamp the max-age (or Expires) value sent to the client.  With
+            # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+            # response max-age directive, along with a "public" directive.  For
+            # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+            # from the origin (if specified), or else sets the response max-age
+            # directive to the lesser of the client_ttl and default_ttl, and also
+            # ensures a "public" cache-control directive is present.
+            # If a client TTL is not specified, a default value (1 hour) will be used.
+            # The maximum allowed value is 31,622,400s (1 year).
+        "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+            # responses that do not have an existing valid TTL (max-age or s-maxage).
+            # Setting a TTL of "0" means "always revalidate".
+            # The value of defaultTTL cannot be set to a value greater than that of
+            # maxTTL, but can be equal.
+            # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+            # will overwrite the TTL set in all responses. The maximum allowed value is
+            # 31,622,400s (1 year), noting that infrequently accessed objects may be
+            # evicted from the cache before the defined TTL.
+        "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+            # origin.
+            # Cache directives that attempt to set a max-age or s-maxage higher than
+            # this, or an Expires header more than maxTTL seconds in the future will
+            # be capped at the value of maxTTL, as if it were the value of an
+            # s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified.
+            # Setting a TTL of "0" means "always revalidate".
+            # The maximum allowed value is 31,622,400s (1 year), noting that
+            # infrequently accessed objects may be evicted from the cache before
+            # the defined TTL.
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+            # negative caching applies to responses with the specified response code
+            # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+            # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+            # to all responses with the specified response code, and override any
+            # caching headers.
+            # By default, Cloud CDN will apply the following default TTLs to these
+            # status codes:
+            # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # HTTP 404 (Not Found), 410 (Gone),
+            # 451 (Unavailable For Legal Reasons): 120s
+            # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+            # These defaults can be overridden in negative_caching_policy.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # negative_caching must be enabled to configure negative_caching_policy.
+            # Omitting the policy and leaving negative_caching enabled will use
+            # Cloud CDN's default cache TTLs.
+            # Note that when specifying an explicit negative_caching_policy, you
+            # should take care to specify a cache TTL for all response codes
+            # that you wish to cache. Cloud CDN will not apply any default
+            # negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes), noting that
+                # infrequently accessed objects may be evicted from the cache before the
+                # defined TTL.
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin.
+        "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+        "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+            # considered fresh. After this time period, the response will be
+            # revalidated before being served. Defaults to 1hr (3600s).  When serving
+            # responses to signed URL requests, Cloud CDN will internally behave as
+            # though all responses from this backend had a "Cache-Control:
+            # public, max-age=[TTL]" header, regardless of any existing
+            # Cache-Control header. The actual headers served in responses will not be
+            # altered.
+        "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+          "A String",
+        ],
+      },
+      "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+          # backend service.
+        "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+            # there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+            # not specified, there is no limit.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+            # service. If not specified, there is no limit.
+        "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+            # This parameter is respected by both the HTTP/1.1 and HTTP/2
+            # implementations. If not specified, there is no limit. Setting this
+            # parameter to 1 will effectively disable keep alive.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+        "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+            # not specified, the default is 1.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+      },
+      "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+          # the client's Accept-Encoding header.
+      "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+        "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+            # instance. For supported load balancers and protocols, as described inEnabling
+            # connection draining.
+      },
+      "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+          # tracking policy settings are only available for external passthrough
+          # Network Load Balancers and internal passthrough Network Load Balancers.
+          #
+          # connectionTrackingPolicy cannot be specified with haPolicy.
+        "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+            # value is DEFAULT_FOR_PROTOCOL.
+            #
+            # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+            # persist on unhealthy backends only for connection-oriented protocols
+            # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+            # Affinity is configured for 5-tuple. They do not persist forUDP.
+            #
+            # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+            # the existing connections on the unhealthy backend are never persisted on
+            # the unhealthy backend. They are always diverted to newly selected healthy
+            # backends (unless all backends are unhealthy).
+            #
+            # If set to ALWAYS_PERSIST, existing connections always
+            # persist on unhealthy backends regardless of protocol and session
+            # affinity. It is generally not recommended to use this mode overriding the
+            # default.
+            #
+            # For more details, see [Connection Persistence for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+            # and [Connection Persistence for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+        "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+            # Balancers. This option is not available publicly.
+        "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+            # matching traffic (in seconds).
+            #
+            # For internal passthrough Network Load Balancers:
+            #
+            #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+            #    - It can be set only if Connection Tracking is less than 5-tuple
+            #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+            #    Mode is PER_SESSION).
+            #
+            #
+            #
+            # For external passthrough Network Load Balancers the default is 60
+            # seconds. This option is not available publicly.
+        "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+            # options:
+            #
+            #    - PER_CONNECTION: This is the default mode. The Connection
+            #    Tracking is performed as per the Connection Key (default Hash Method) for
+            #    the specific protocol.
+            #    - PER_SESSION: The Connection Tracking is performed as per
+            #    the configured Session Affinity. It matches the configured Session
+            #    Affinity.
+            #
+            #
+            #
+            # For more details, see [Tracking Mode for Network Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+            # and [Tracking Mode for Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+      },
+      "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+          # affinity based on HTTP headers, cookies or other properties. This load
+          # balancing policy is applicable only for HTTP connections. The affinity to a
+          # particular destination host will be lost when one or more hosts are
+          # added/removed from the destination service. This field specifies parameters
+          # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+            # be used as the hash key for the consistent hash load balancer. If the
+            # cookie is not present, it will be generated. This field is applicable if
+            # the sessionAffinity is set to HTTP_COOKIE.
+            #
+            # Not supported when the backend service is referenced by a URL map that is
+            # bound to target gRPC proxy that has validateForProxyless field set to true.
+            # for load balancing policies that use a consistent hash.
+          "name": "A String", # Name of the cookie.
+          "path": "A String", # Path to set for the cookie.
+          "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+            # applicable if the sessionAffinity is set toHEADER_FIELD.
+        "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+            # 1024. Larger ring sizes result in more granular load distributions. If the
+            # number of hosts in the load balancing pool is larger than the ring size,
+            # each host will be assigned a single virtual node.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+        { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+            # locality_lb_policy.
+          "dryRun": True or False, # If true, the metric data is not used for load balancing.
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+          # custom
+          # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+          # this backend service.
+      "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+          # global external Application Load Balancer.
+      "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+          # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+          #
+          # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+          # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+          # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+          # externalManagedMigrationTestingPercentage.
+          #
+          # Rolling back a migration requires the states to be set in reverse order. So
+          # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+          # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+          # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+          # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+      "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+          # external Application Load Balancer.
+          #
+          # The value of this field must be in the range [0, 100].
+          #
+          # Session affinity options will slightly affect this routing behavior, for
+          # more details, see:Session
+          # Affinity.
+          #
+          # This value can only be set if the loadBalancingScheme in the BackendService
+          # is set to EXTERNAL (when using the classic Application Load Balancer) and
+          # the migration state is TEST_BY_PERCENTAGE.
+      "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+          # as a backup (failover) backend.
+          # For load balancers that have configurable failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+          # Network Load Balancers.
+          # failover:
+          # [Internal passthrough Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+          # and [external passthrough
+          # Network Load
+          # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+          # On failover or failback, this field indicates whether connection draining
+          # will be honored. Google Cloud has a fixed connection draining timeout of
+          # 10 minutes. A setting of true terminates existing TCP
+          # connections to the active pool during failover and failback, immediately
+          # draining traffic. A setting of false allows existing TCP
+          # connections to persist, even on VMs no longer in the active pool, for up
+          # to the duration of the connection draining timeout (10 minutes).
+        "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+            #
+            # The default is false.
+        "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+            # load balancer are dropped when all primary and all backup backend VMs are
+            # unhealthy.If set to false, connections are distributed
+            # among all primary VMs when all primary and all backup backend VMs are
+            #  unhealthy.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external passthrough
+            # Network Load
+            # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+            # The default is false.
+        "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+            # failover when the number of healthy primary VMs equals zero.
+            # For all other values, the load balancer performs a failover when the
+            # total number of healthy primary VMs is less than this ratio.
+            # For load balancers that have configurable
+            # failover:
+            # [Internal TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+            # and [external TCP/UDP Load
+            # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      },
+      "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 BackendService. An up-to-date fingerprint must be provided in
+          # order to update the BackendService, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a BackendService.
+      "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+          # Protocol Forwarding.
+          #
+          # The backends of this regional backend service must only specify zonal
+          # network endpoint groups (NEGs) of type GCE_VM_IP.
+          #
+          # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+          # regional backend service must set the network field. All zonal NEGs must
+          # belong to the same network. However, individual NEGs can
+          # belong to different subnetworks of that network.
+          #
+          # When haPolicy is specified, the set of attached network endpoints across
+          # all backends comprise an High Availability domain from which one endpoint
+          # is selected as the active endpoint (the leader) that receives all
+          # traffic.
+          #
+          # haPolicy can be added only at backend service creation time. Once set up,
+          # it cannot be deleted.
+          #
+          # Note that haPolicy is not for load balancing, and therefore cannot be
+          # specified with sessionAffinity, connectionTrackingPolicy, and
+          # failoverPolicy.
+          #
+          # haPolicy requires customers to be responsible for tracking backend
+          # endpoint health and electing a leader among the healthy endpoints.
+          # Therefore, haPolicy cannot be specified with healthChecks.
+          # haPolicy can only be specified for External Passthrough
+          # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+          # Load Balancers.
+        "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+            # achieve it.
+            #
+            # Supported values are:
+            #
+            #    - DISABLED: Fast IP Move is disabled. You can only use the
+            #    haPolicy.leader API to update the leader.
+            #    - >GARP_RA: Provides a method to very quickly define a new network
+            #    endpoint as the leader. This method is faster than updating the leader
+            #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+            #    hosting the network endpoint that should become the new leader sends
+            #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+            #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+            #    temporarily associates the forwarding rule IP address with that VM, and
+            #    both new and in-flight packets are quickly delivered to that VM.
+            #
+            #
+            #
+            # Note the important properties of the Fast IP Move functionality:
+            #
+            #    - The GARP/RA-initiated re-routing stays active for approximately 20
+            #    minutes. After triggering fast failover, you must also
+            #    appropriately set the haPolicy.leader.
+            #    -  The new leader instance should continue to send GARP/RA packets
+            #    periodically every 10 seconds until at least 10 minutes after updating
+            #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+            #    - After triggering a fast failover, we recommend that you wait at least
+            #    3 seconds before sending another GARP/RA packet from a different VM
+            #    instance to avoid race conditions.
+            #    - Don't send GARP/RA packets from different VM
+            #    instances at the same time. If multiple instances continue to send
+            #    GARP/RA packets, traffic might be routed to different destinations in an
+            #    alternating order. This condition ceases when a single instance
+            #    issues a GARP/RA packet.
+            #    - The GARP/RA request always takes priority over the leader API.
+            #    Using the haPolicy.leader API to change the leader to a different
+            #    instance will have no effect until the GARP/RA request becomes
+            #    inactive.
+            #    - The GARP/RA packets should follow the GARP/RA
+            #    Packet Specifications..
+            #    -  When multiple forwarding rules refer to a regional backend service,
+            #    you need only send a GARP or RA packet for a single forwarding rule
+            #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+            #    backend service will also be moved to the sender of the GARP or RA
+            #    packet.
+            #
+            #
+            #
+            # The following are the Fast IP Move limitations (that is, when fastIPMove
+            # is not DISABLED):
+            #
+            #    - Multiple forwarding rules cannot use the same IP address if one of
+            #    them refers to a regional backend service with fastIPMove.
+            #    - The regional backend service must set the network field, and all
+            #    NEGs must belong to that network. However, individual
+            #    NEGs can belong to different subnetworks of that network.
+            #    - The maximum number of network endpoints across all backends of a
+            #    backend service with fastIPMove is 32.
+            #    - The maximum number of backend services with fastIPMove that can have
+            #    the same network endpoint attached to one of its backends is 64.
+            #    - The maximum number of backend services with fastIPMove in a VPC in a
+            #    region is 64.
+            #    - The network endpoints that are attached to a backend of a backend
+            #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+            #    - Traffic directed to the leader by a static route next hop will not be
+            #    redirected to a new leader by fast failover. Such traffic will only be
+            #    redirected once an haPolicy.leader update has taken effect. Only traffic
+            #    to the forwarding rule's virtual IP will be redirected to a new leader by
+            #    fast failover.
+            #
+            #
+            # haPolicy.fastIPMove can be set only at backend service creation time.
+            # Once set, it cannot be updated.
+            #
+            # By default, fastIpMove is set to DISABLED.
+        "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+            # this service as the active endpoint (the leader) that receives all
+            # traffic.
+            #
+            # When the leader changes, there is no connection draining to persist
+            # existing connections on the old leader.
+            #
+            # You are responsible for selecting a suitable endpoint as the
+            # leader. For example, preferring a healthy endpoint over unhealthy ones.
+            # Note that this service does not track backend endpoint health, and
+            # selects the configured leader unconditionally.
+          "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+              # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+              # that the leader is attached to.
+              #
+              # The leader's backendGroup must already be specified as a backend of
+              # this backend service. Removing a backend that is designated as the
+              # leader's backendGroup is not permitted.
+          "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+              # designated as the leader.
+              #
+              # This network endpoint cannot be detached from the NEG specified in
+              # the haPolicy.leader.backendGroup until the leader is updated with
+              # another network endpoint, or the leader is removed from the haPolicy.
+            "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+                # instance must already be attached to the NEG specified in the
+                # haPolicy.leader.backendGroup.
+                #
+                # The value must be a valid RFC1035 name (1-63 characters) or a valid
+                # instance URL.
+                # Authorization requires the following IAM permission on the
+                # specified resource instance: compute.instances.use
+          },
+        },
+      },
+      "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+          # httpsHealthChecks (legacy) resource for health checking this backend
+          # service. Not all backend services support legacy health checks. See
+          # Load balancer guide. Currently, at most one health check can be
+          # specified for each backend service. Backend services with
+          # instance group or zonal NEG backends must have a health check unless
+          # haPolicy is specified. Backend services with internet or serverless NEG
+          # backends must not have a health check.
+          #
+          # healthChecks[] cannot be specified with haPolicy.
+        "A String",
+      ],
+      "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+          # Not available for internal passthrough Network Load Balancers and external
+          # passthrough Network Load Balancers.
+        "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+            # incoming requests.
+        "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+        "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+            # For security reasons, this value cannot be retrieved via the API.
+            # Instead, the SHA-256 hash of the value is returned in the
+            # oauth2ClientSecretSha256 field.
+            #
+            # @InputOnly
+        "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+          # from the client to the backend for proxyless gRPC).
+          # The possible values are:
+          #
+          #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv4
+          #    health checks are used to check the health of the backends. This is the
+          #    default setting.
+          #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+          #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+          #    address).
+          #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+          #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+          #    Group), regardless of traffic from the client to the proxy. Only IPv6
+          #    health checks are used to check the health of the backends.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    -  Advanced global external Application Load Balancer (load balancing
+          #    scheme EXTERNAL_MANAGED),
+          #    -  Regional external Application Load
+          #    Balancer,
+          #    -  Internal proxy Network Load Balancer (load balancing
+          #    scheme INTERNAL_MANAGED),
+          #    -  Regional internal Application Load
+          #    Balancer (load balancing scheme INTERNAL_MANAGED),
+          #    -  Traffic
+          #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+          #    INTERNAL_SELF_MANAGED).
+      "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+          # for backend services.
+      "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+          # created for one type of load balancer cannot be used with another.
+          # For more information, refer to
+          # Backend services product and scheme table.
+      "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+          # preference. When you use localityLbPolicies, you must set at least one
+          # value for either the localityLbPolicies[].policy or the
+          # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+          # value set in the localityLbPolicy field.
+          #
+          # For an example of how to use this field, seeDefine
+          # a list of preferred policies.
+          #
+          # Caution: This field and its children are intended for use in a service mesh
+          # that includes gRPC clients only. Envoy proxies can't use backend services
+          # that have this configuration.
+        { # Container for either a built-in LB policy supported by gRPC or Envoy or
+            # a custom one implemented by the end user.
+          "customPolicy": { # The configuration for a custom policy implemented by the user and
+              # deployed with the client.
+            "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+                # by a locally installed custom policy implementation.
+            "name": "A String", # Identifies the custom policy.
+                #
+                # The value should match the name of a custom implementation registered
+                # on the gRPC clients. It should follow protocol buffer message naming
+                # conventions and include the full path (for example,
+                # myorg.CustomLbPolicy). The maximum length is 256 characters.
+                #
+                # Do not specify the same custom policy more than once for a
+                # backend. If you do, the configuration is rejected.
+                #
+                # For an example of how to use this field, seeUse
+                # a custom policy.
+          },
+          "policy": { # The configuration for a built-in load balancing policy.
+            "name": "A String", # The name of a locality load-balancing policy. Valid values include
+                # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+                # about these values, see the description of localityLbPolicy.
+                #
+                # Do not specify the same policy more than once for a
+                # backend. If you do, the configuration is rejected.
+          },
+        },
+      ],
+      "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+          # possible values are:
+          #
+          #    - ROUND_ROBIN: This is a simple policy in which each healthy
+          #    backend is selected in round robin order. This is the default.
+          #    - LEAST_REQUEST: An O(1) algorithm which
+          #    selects two random healthy hosts and picks the host which has fewer active
+          #    requests.
+          #    - RING_HASH: The ring/modulo hash load balancer implements
+          #    consistent hashing to backends. The algorithm has the property that the
+          #    addition/removal of a host from a set of N hosts only affects 1/N of the
+          #    requests.
+          #    - RANDOM: The load balancer selects a random healthy
+          #    host.
+          #    - ORIGINAL_DESTINATION: Backend host is selected
+          #    based on the client connection metadata, i.e., connections are opened to
+          #    the same address as the destination address of the incoming connection
+          #    before the connection was redirected to the load balancer.
+          #    - MAGLEV: used as a drop in replacement for the ring hash
+          #    load balancer. Maglev is not as stable as ring hash but has faster table
+          #    lookup build times and host selection times. For more information about
+          #    Maglev, see Maglev:
+          #    A Fast and Reliable Software Network Load Balancer.
+          #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+          #    Load Balancing using weights computed from Backend reported Custom Metrics.
+          #    If set, the Backend Service responses are expected to contain non-standard
+          #    HTTP response header field Endpoint-Load-Metrics. The reported
+          #    metrics to use for computing the weights are specified via thecustomMetrics field.
+          #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+          #    health check reported weights. If set, the backend service must configure
+          #    an HTTP-based Health Check, and health check replies are expected to
+          #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+          #    weights. If set, load balancing is weighted based on the per-endpoint
+          #    weights reported in the last processed health check replies, as long as
+          #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+          #    Otherwise, load balancing remains equal-weight.
+          #
+          #
+          #
+          # This field is applicable to either:
+          #
+          #    - A regional backend service with the service protocol set to HTTP,
+          #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+          #    INTERNAL_MANAGED.
+          #    - A global backend service with the
+          #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+          #    EXTERNAL_MANAGED.
+          #
+          #
+          #
+          # If sessionAffinity is not configured—that is, if session
+          # affinity remains at the default value of NONE—then the
+          # default value for localityLbPolicy
+          # is ROUND_ROBIN. If session affinity is set to a value other
+          # than NONE,
+          # then the default value for localityLbPolicy isMAGLEV.
+          #
+          # Only ROUND_ROBIN and RING_HASH are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # localityLbPolicy cannot be specified with haPolicy.
+      "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+          # by this backend service. If logging is enabled, logs will be exported to
+          # Stackdriver.
+          # backend service.
+        "enable": True or False, # Denotes whether to enable logging for the load balancer
+            # traffic served by this backend service. The default value is false.
+        "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+          { # Determines which HTTP headers will be logged to Stackdriver.
+            "headerName": "A String", # The name of the header to be logged.
+          },
+        ],
+        "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+            # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+            # of optional fields you want to include in the logs. For example:
+            # serverInstance, serverGkeDetails.cluster,
+            # serverGkeDetails.pod.podNamespace
+          "A String",
+        ],
+        "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+            # service. Configures whether all, none or a subset of optional fields
+            # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+            # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+        "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+            # service. The value of the field must be in [0, 1]. This configures the
+            # sampling rate of requests to the load balancer where 1.0 means all logged
+            # requests are reported and 0.0 means no logged requests are reported. The
+            # default value is 1.0.
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+          # service. Duration is computed from the beginning of the stream until the
+          # response has been completely processed, including all retries. A stream
+          # that does not complete in this duration is closed.
+          #
+          # If not specified, there will be no timeout limit, i.e. the maximum
+          # duration is infinite.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # This field is only allowed when the loadBalancingScheme of
+          # the backend service is INTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+          # controller and read by the backend RCTH
+        "a_key": "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.
+      "network": "A String", # The URL of the network to which this backend service belongs.
+          #
+          # This field must be set for Internal Passthrough Network Load Balancers when
+          # the haPolicy is enabled, and for External Passthrough Network Load
+          # Balancers when the haPolicy fastIpMove is enabled.
+          #
+          # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+      "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+          # Load Balancers.
+          #
+          # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+        "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+            # endpoints in the local zone.
+          "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+              # possible values are:
+              #
+              #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+              #    is disabled. The load balancer distributes new connections to all
+              #    healthy backend endpoints across all zones.
+              #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there are no healthy
+              #    backend endpoints in the local zone, the load balancer distributes
+              #    new connections to all backend endpoints in the local zone.
+              #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+              #    enabled. The load balancer distributes new connections to all healthy
+              #    backend endpoints in the local zone only. If there aren't enough
+              #    healthy backend endpoints in the local zone, the load balancer
+              #    distributes new connections to all healthy backend endpoints across all
+              #    zones.
+          "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+              # of healthy backend endpoints in a zone to the count of backend
+              # endpoints in that same zone is equal to or above this threshold, the
+              # load balancer distributes new connections to all healthy endpoints in
+              # the local zone only. When the ratio of the count of healthy backend
+              # endpoints in a zone to the count of backend endpoints in that same
+              # zone is below this threshold, the load balancer distributes all new
+              # 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
+          # considered disabled.
+          #
+          # Results of the outlier detection algorithm (ejection of endpoints from the
+          # load balancing pool and returning them back to the pool) are executed
+          # independently by each proxy instance of the load balancer. In most cases,
+          # more than one proxy instance handles the traffic received by a backend
+          # service. Thus, it is possible that an unhealthy endpoint is detected and
+          # ejected by only some of the proxies, and while this happens, other proxies
+          # may continue to send requests to the same unhealthy endpoint until they
+          # detect and eject the unhealthy endpoint.
+          #
+          # Applicable backend endpoints can be:
+          #
+          #    - VM instances in an Instance Group
+          #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+          #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+          #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+          #    Functions Services
+          #    - Private Service Connect NEGs, that resolve to
+          #    Google-managed regional API endpoints or managed services published using
+          #    Private Service Connect
+          #
+          #
+          #
+          # Applicable backend service types can be:
+          #
+          #    - A global backend service with the loadBalancingScheme set to
+          #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+          #    - A regional backend
+          #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+          #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+          #    supported for Serverless NEGs.
+          #
+          #
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # pool for the backend service.
+        "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+            # or 30s.
+            #
+            # After a backend endpoint is returned back to the load balancing pool, it
+            # can be ejected again in another ejection analysis. Thus, the total ejection
+            # time is equal to the base ejection time multiplied by the number of times
+            # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+            # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+            # return code qualifies as an error. Defaults to 5.
+        "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+            # connection errors that are mapped to one of those status codes) before a
+            # consecutive gateway failure ejection occurs. Defaults to 3.
+        "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive 5xx. This setting can be
+            # used to disable ejection or to ramp it up slowly. Defaults to 0.
+        "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through consecutive gateway failures. This
+            # setting can be used to disable ejection or to ramp it up slowly. Defaults
+            # to 100.
+        "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+            # outlier status is detected through success rate statistics. This setting
+            # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+            # ejections and backend endpoints being returned to service. The interval is
+            # equal to the number of seconds as defined in
+            # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+            # in outlierDetection.interval.nanos. Defaults to 1 second.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+            # backend service that can be ejected if the ejection conditions are met.
+            # Defaults to 50%.
+        "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+            # enough request volume to detect success rate outliers. If the number of
+            # backend endpoints is fewer than this setting, outlier detection via success
+            # rate statistics is not performed for any backend endpoint in the load
+            # balancing pool. Defaults to 5.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+            # (as defined by the interval duration above) to include this backend
+            # endpoint in success rate based outlier detection. If the volume is lower
+            # than this setting, outlier detection via success rate statistics is not
+            # performed for that backend endpoint. Defaults to 100.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+        "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+            # outlier ejection. The ejection threshold is the difference between the mean
+            # success rate, and the product of this factor and the standard deviation of
+            # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+            # is divided by a thousand to get a double. That is, if the desired factor
+            # is 1.9, the runtime value should be 1900. Defaults to 1900.
+            #
+            # Not supported when the backend service uses Serverless NEG.
+      },
+      "params": { # Additional Backend Service 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+          # the backend. The default value is 80.
+          # For internal passthrough Network Load Balancers and external passthrough
+          # Network Load Balancers, omit port.
+      "portName": "A String", # A named port on a backend instance group representing the port for
+          # communication to the backend VMs in that group. The
+          # named port must be [defined on each backend instance
+          # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+          # This parameter has no meaning if the backends are NEGs. For internal
+          # passthrough Network Load Balancers and external passthrough Network Load
+          # Balancers, omit port_name.
+      "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+          #
+          # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+          # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+          # configuration.
+          # Refer to
+          # Load balancing features for more information.
+          #
+          # Must be set to GRPC when the backend service is referenced by a URL map
+          # that is bound to target gRPC proxy.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+          # resides. This field is not applicable to global backend services.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # backend service.
+      "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+          # service. This field is applicable to a global backend service with the
+          # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+        "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+            # storage buckets that support AWS's Signature Version 4 for authentication.
+            # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+            # private storage buckets that support Signature Version 4 for authentication.
+            # The service name for generating the authentication header will always default
+            # to 's3'.
+          "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+              # creating a backend that uses AWS v4 signature authentication, but will not
+              # be returned as part of the configuration when queried with a REST API GET
+              # request.
+              #
+              # @InputOnly
+          "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+          "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+              # keep track of different iterations of your access key.
+          "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+              # the name of the region your cloud uses to host your origin.  For example,
+              # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+        },
+        "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+            # that describes how clients should authenticate with this service's
+            # backends.
+            #
+            #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+            # to INTERNAL_SELF_MANAGED.
+            #
+            #  If left blank, communications are not encrypted.
+        "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+            # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+            # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+            # specified values, the communication continues. Otherwise, it fails. This
+            # additional check enables the client to verify that the server is authorized
+            # to run the requested service.
+            #
+            #  Note that the contents of the server
+            # certificate's subjectAltName field are configured by the
+            # Public Key Infrastructure which provisions server identities.
+            #
+            #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+            # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+            # mode).
+          "A String",
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+          #
+          # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+          # If set, lists of backends and health checks must be both empty.
+        "A String",
+      ],
+      "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+          #
+          # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+          # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+          # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+          # global backend service, the service lb policy must be global. For a
+          # regional backend service, the service lb policy must be regional and in the
+          # same region.
+      "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+          #
+          # Only NONE and HEADER_FIELD are supported
+          # when the backend service is referenced by a URL map that is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          # For more details, see:
+          # [Session
+          # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+          #
+          # sessionAffinity cannot be specified with haPolicy.
+      "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+          # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+        "name": "A String", # Name of the cookie.
+        "path": "A String", # Path to set for the cookie.
+        "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+          # Currently this is applicable only for Internal TCP/UDP load balancing,
+          # Internal HTTP(S) load balancing and Traffic Director.
+        "policy": "A String",
+      },
+      "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+          # type of load balancer. For more information see,
+          # Backend service settings.
+          # The default is 30 seconds.
+          # The full range of timeout values allowed goes from 1
+          # through 2,147,483,647 seconds.
+          #
+          # This value can be overridden in the PathMatcher configuration of the
+          # UrlMap that references this backend service.
+          #
+          # Not supported when the backend service is referenced by a URL map that is
+          # bound to target gRPC proxy that has validateForProxyless field set to true.
+          # Instead, use maxStreamDuration.
+      "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+          # when the backend protocol is SSL, HTTPS or HTTP2.
+        "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+            # networksecurity.googleapis.com namespace. Can be used in authenticating
+            # TLS connections to the backend, as specified by the authenticationMode
+            # field. Can only be specified if authenticationMode is not NONE.
+        "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+            #
+            #
+            # Use this property to configure the load balancer back-end to use
+            # certificates and roots of trust provisioned by the Managed Workload
+            # Identity system.
+            #
+            #  The `identity` property is the
+            # fully-specified SPIFFE ID to use in the SVID presented by the Load
+            # Balancer Workload.
+            #
+            #  The SPIFFE ID must be a resource starting with the
+            # `trustDomain` property value, followed by the path to the Managed
+            # Workload Identity.
+            #
+            #  Supported SPIFFE ID format:
+            #
+            #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+            #
+            #
+            # The Trust Domain within the Managed Identity must refer to a valid
+            # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+            # will be inherited from the Workload Identity Pool.
+            #
+            #  Restrictions:
+            #
+            #    - If you set the `identity` property, you cannot manually set
+            #    the following fields:
+            #        - tlsSettings.sni
+            #       - tlsSettings.subjectAltNames
+            #       - tlsSettings.authenticationConfig
+            #
+            #
+            # When defining a `identity` for a RegionBackendServices, the
+            # corresponding Workload Identity Pool must have a ca_pool
+            # configured in the same region.
+            #
+            #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+        "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+            # balancer sends this string as the SNI hostname in the TLS connection to
+            # the backend, and requires that this string match a Subject Alternative
+            # Name (SAN) in the backend's server certificate. With a Regional Internet
+            # NEG backend, if the SNI is specified here, the load balancer uses it
+            # regardless of whether the Regional Internet NEG is specified with FQDN or
+            # IP address and port. When both sni and subjectAltNames[] are specified,
+            # the load balancer matches the backend certificate's SAN only to
+            # subjectAltNames[].
+        "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+            # verifies during a TLS handshake with the backend. When the server
+            # presents its X.509 certificate to the Load Balancer, the Load Balancer
+            # inspects the certificate's SAN field, and requires that at least one SAN
+            # match one of the subjectAltNames in the list. This field is limited to 5
+            # entries. When both sni and subjectAltNames[] are specified, the load
+            # balancer matches the backend certificate's SAN only to subjectAltNames[].
+          { # A Subject Alternative Name that the load balancer matches against the SAN
+              # field in the TLS certificate provided by the backend, specified as either
+              # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+            "dnsName": "A String", # The SAN specified as a DNS Name.
+            "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+          },
+        ],
+      },
+      "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+        {
+          "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+              # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+              # and ForwardingRule.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#usableBackendServiceList", # Output only. [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend
+      # services.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable_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, backendService, body=None, requestId=None, x__xgafv=None) + 
Updates the specified regional BackendService resource with the data
+included in the request. For more information, see 
+Understanding backend services This method
+supports PATCH semantics and uses the JSON 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)
+  backendService: string, Name of the BackendService resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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).
+}
+
+ +
+ setSecurityPolicy(project, region, backendService, body=None, requestId=None, x__xgafv=None) + 
Sets the Google Cloud Armor security policy for the specified backend
+service. For more information, seeGoogle
+Cloud Armor Overview
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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",
+  ],
+}
+
+ +
+ update(project, region, backendService, body=None, requestId=None, x__xgafv=None) + 
Updates the specified regional BackendService resource with the data
+included in the request. For more information,
+see 
+Backend services overview.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Backend Service resource.
+    # 
+    # A backend service defines how Google Cloud load balancers distribute traffic.
+    # The backend service configuration contains a set of values, such as the
+    # protocol used to connect to backends, various distribution and session
+    # settings, health checks, and timeouts. These settings provide fine-grained
+    # control over how your load balancer behaves. Most of the settings have
+    # default values that allow for easy configuration if you need to get started
+    # quickly.
+    # 
+    # Backend services in Google Compute Engine can be either regionally or
+    # globally scoped.
+    # 
+    # * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+    # * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)
+    # 
+    # For more information, seeBackend
+    # Services.
+  "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds. This setting is applicable to Application
+      # Load Balancers and Traffic Director and requires
+      # GENERATED_COOKIE or HTTP_COOKIE session affinity.
+      # 
+      # If set to 0, the cookie is non-persistent and lasts only until
+      # the end of the browser session (or equivalent). The maximum allowed value
+      # is two weeks (1,209,600).
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+  "backends": [ # The list of backends that serve this BackendService.
+    { # Message containing information of one individual backend.
+      "balancingMode": "A String", # Specifies how to determine whether the backend of a load balancer can
+          # handle additional traffic or is fully loaded. For usage guidelines, see
+          # Connection balancing mode.
+          #
+          # Backends must use compatible balancing modes. Backends of a backend
+          # service may use different balancing modes. For more information, see
+          # Supported balancing modes and target capacity settings and
+          # Restrictions and guidance for instance groups.
+          #
+          # Note: Currently, if you use the API to configure incompatible balancing
+          # modes, the configuration might be accepted even though it has no impact
+          # and is ignored. Specifically, Backend.maxUtilization is ignored when
+          # Backend.balancingMode is RATE. In the future, this incompatible combination
+          # will be rejected.
+      "capacityScaler": 3.14, # A multiplier applied to the backend's target capacity of its balancing
+          # mode.
+          # The default value is 1, which means the group serves up to
+          # 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is
+          # completely drained, offering 0% of its available capacity. The valid ranges
+          # are 0.0 and [0.1,1.0].
+          # You cannot configure a setting larger than 0 and smaller than0.1.
+          # You cannot configure a setting of 0 when there is only one
+          # backend attached to the backend service.
+          #
+          # Not available with backends that don't support using abalancingMode. This includes backends such as global
+          # internet NEGs, regional serverless NEGs, and PSC NEGs.
+      "customMetrics": [ # List of custom metrics that are used for CUSTOM_METRICS
+          # BalancingMode.
+        { # Custom Metrics are used for CUSTOM_METRICS balancing_mode.
+          "dryRun": True or False, # If true, the metric data is collected and reported to Cloud
+              # Monitoring, but is not used for load balancing.
+          "maxUtilization": 3.14, # Optional parameter to define a target utilization for the Custom Metrics
+              # balancing mode. The valid range is [0.0, 1.0].
+          "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+              # long and match the regular expression
+              # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+              # first character must be a lowercase letter, and all following
+              # characters must be a dash, period, underscore, lowercase letter, or
+              # digit, except the last character, which cannot be a dash, period, or
+              # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+              # field can only be used for a global or regional backend service with the
+              # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "failover": True or False, # This field designates whether this is a failover backend. More than one
+          # failover backend can be configured for a given BackendService.
+          #
+          # This field can only be used for a regional external Passthrough Network
+          # Load Balancer or a regional internal Passthrough Network Load Balancer.
+      "group": "A String", # The fully-qualified URL of aninstance
+          # group or network endpoint
+          # group (NEG) resource. To determine what types of backends a load
+          # balancer supports, see the [Backend services
+          # overview](https://cloud.google.com/load-balancing/docs/backend-service#backends).
+          #
+          # You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group
+          # or NEG. Partial URLs are not supported.
+          #
+          # If haPolicy is specified, backends must refer to NEG resources of type
+          # GCE_VM_IP.
+      "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode. Not available if the backend'sbalancingMode is RATE.
+      "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections.  For usage
+          # guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections.
+          # For usage guidelines, seeConnection
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isRATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or
+          # instance group. Not available if backend's balancingMode isRATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM.
+          # Not available if backend's balancingMode is RATE
+          # or CONNECTION.
+      "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For
+          # usage guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage
+          # guidelines, seeRate
+          # balancing mode and Utilization
+          # balancing mode.
+          #
+          # Not available if the backend's balancingMode isCONNECTION.
+      "maxUtilization": 3.14, # Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].
+          #
+          # 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:
+          #
+          #    - PREFERRED: Backends with this preference level will be
+          #    filled up to their capacity limits first, based on RTT.
+          #    - DEFAULT:  If preferred backends don't have enough
+          #    capacity, backends in this layer would be used and traffic would be
+          #    assigned based on the load balancing algorithm you use. This is the
+          #    default
+          #
+          #
+          #
+          # For global external Passthrough Network Load Balancers, the following
+          # restrictions apply:
+          #
+          #    - At most one backend can be marked as PREFERRED.
+          #    - PREFERRED and DEFAULT backends cannot reside
+          #    in the same Cloud region.
+      "trafficDuration": "A String",
+    },
+  ],
+  "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for
+      # specified load balancer types.
+    "bypassCacheOnRequestHeaders": [ # Bypass the cache when the specified request headers are matched - e.g.
+        # Pragma or Authorization headers. Up to 5 headers can be specified.
+        # The cache is bypassed for all cdnPolicy.cacheMode settings.
+      { # Bypass the cache when the specified request headers are present,
+          # e.g. Pragma or Authorization headers. Values are case insensitive.
+          # The presence of such a header overrides the cache_mode setting.
+        "headerName": "A String", # The header field name to match on when bypassing cache.
+            # Values are case-insensitive.
+      },
+    ],
+    "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud # The CacheKeyPolicy for this CdnPolicy.
+        # CDN.
+      "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+      "includeHttpHeaders": [ # Allows HTTP request headers (by name) to be used in the cache key.
+        "A String",
+      ],
+      "includeNamedCookies": [ # Allows HTTP cookies (by name) to be used in the cache key.
+          # The name=value pair will be used in the cache key Cloud CDN generates.
+        "A String",
+      ],
+      "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+          # query_string_whitelist and query_string_blacklist. If neither is set, the
+          # entire query string will be included. If false, the query string will be
+          # excluded from the cache key entirely.
+      "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other
+          # parameters will be included. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+      "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other
+          # parameters will be excluded. Either specify query_string_whitelist or
+          # query_string_blacklist, not both. '&' and '=' will be percent encoded and
+          # not treated as delimiters.
+        "A String",
+      ],
+    },
+    "cacheMode": "A String", # Specifies the cache setting for all responses from this backend.
+        # The possible values are:
+        # USE_ORIGIN_HEADERS Requires the origin to set valid caching
+        # headers to cache content. Responses without these headers will not be
+        # cached at Google's edge, and will require a full trip to the origin on
+        # every request, potentially impacting performance and increasing load on
+        # the origin server.
+        # FORCE_CACHE_ALL Cache all content, ignoring any "private",
+        # "no-store" or "no-cache" directives in Cache-Control response headers.
+        # Warning: this may result in Cloud CDN caching private,
+        # per-user (user identifiable) content.
+        # CACHE_ALL_STATIC Automatically cache static content,
+        # including common image formats, media (video and audio), and web assets
+        # (JavaScript and CSS). Requests and responses that are marked as
+        # uncacheable, as well as dynamic content (including HTML), will not be
+        # cached.
+        #
+        # If no value is provided for cdnPolicy.cacheMode, it defaults
+        # to CACHE_ALL_STATIC.
+    "clientTtl": 42, # Specifies a separate client (e.g. browser client) maximum TTL. This is
+        # used to clamp the max-age (or Expires) value sent to the client.  With
+        # FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
+        # response max-age directive, along with a "public" directive.  For
+        # cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
+        # from the origin (if specified), or else sets the response max-age
+        # directive to the lesser of the client_ttl and default_ttl, and also
+        # ensures a "public" cache-control directive is present.
+        # If a client TTL is not specified, a default value (1 hour) will be used.
+        # The maximum allowed value is 31,622,400s (1 year).
+    "defaultTtl": 42, # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-maxage).
+        # Setting a TTL of "0" means "always revalidate".
+        # The value of defaultTTL cannot be set to a value greater than that of
+        # maxTTL, but can be equal.
+        # When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
+        # will overwrite the TTL set in all responses. The maximum allowed value is
+        # 31,622,400s (1 year), noting that infrequently accessed objects may be
+        # evicted from the cache before the defined TTL.
+    "maxTtl": 42, # Specifies the maximum allowed TTL for cached content served by this
+        # origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than
+        # this, or an Expires header more than maxTTL seconds in the future will
+        # be capped at the value of maxTTL, as if it were the value of an
+        # s-maxage Cache-Control directive.
+        # Headers sent to the client will not be modified.
+        # Setting a TTL of "0" means "always revalidate".
+        # The maximum allowed value is 31,622,400s (1 year), noting that
+        # infrequently accessed objects may be evicted from the cache before
+        # the defined TTL.
+    "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+        # to apply fine-grained caching for common errors or redirects.
+        # This can reduce the load on your origin and improve end-user
+        # experience by reducing response latency.
+        # When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
+        # negative caching applies to responses with the specified response code
+        # that lack any Cache-Control, Expires, or Pragma: no-cache directives.
+        # When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
+        # to all responses with the specified response code, and override any
+        # caching headers.
+        # By default, Cloud CDN will apply the following default TTLs to these
+        # status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+        # HTTP 404 (Not Found), 410 (Gone),
+        # 451 (Unavailable For Legal Reasons): 120s
+        # HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
+        # These defaults can be overridden in negative_caching_policy.
+    "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+        # negative_caching must be enabled to configure negative_caching_policy.
+        # Omitting the policy and leaving negative_caching enabled will use
+        # Cloud CDN's default cache TTLs.
+        # Note that when specifying an explicit negative_caching_policy, you
+        # should take care to specify a cache TTL for all response codes
+        # that you wish to cache. Cloud CDN will not apply any default
+        # negative caching when a policy exists.
+      { # Specify CDN TTLs for response error codes.
+        "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+            # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+            # specified as values, and you cannot specify a status code more than
+            # once.
+        "ttl": 42, # The TTL (in seconds) for which to cache responses with the
+            # corresponding status code.
+            # The maximum allowed value is 1800s (30 minutes), noting that
+            # infrequently accessed objects may be evicted from the cache before the
+            # defined TTL.
+      },
+    ],
+    "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+        # requests into a small number of requests to the origin.
+    "serveWhileStale": 42, # Serve existing content from the cache (if available) when revalidating
+        # content with the origin, or when an error is encountered when refreshing
+        # the cache.
+        # This setting defines the default "max-stale" duration for any cached
+        # responses that do not specify a max-stale directive. Stale responses that
+        # exceed the TTL configured here will not be served. The default limit
+        # (max-stale) is 86400s (1 day), which will allow stale content to be
+        # served up to this limit beyond the max-age (or s-maxage) of a cached
+        # response.
+        # The maximum allowed value is 604800 (1 week).
+        # Set this to zero (0) to disable serve-while-stale.
+    "signedUrlCacheMaxAgeSec": "A String", # Maximum number of seconds the response to a signed URL request will be
+        # considered fresh. After this time period, the response will be
+        # revalidated before being served. Defaults to 1hr (3600s).  When serving
+        # responses to signed URL requests, Cloud CDN will internally behave as
+        # though all responses from this backend had a "Cache-Control:
+        # public, max-age=[TTL]" header, regardless of any existing
+        # Cache-Control header. The actual headers served in responses will not be
+        # altered.
+    "signedUrlKeyNames": [ # [Output Only] Names of the keys for signing request URLs.
+      "A String",
+    ],
+  },
+  "circuitBreakers": { # Settings controlling the volume of requests, connections and retries to this
+      # backend service.
+    "maxConnections": 42, # The maximum number of connections to the backend service. If not specified,
+        # there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxPendingRequests": 42, # The maximum number of pending requests allowed to the backend service. If
+        # not specified, there is no limit.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRequests": 42, # The maximum number of parallel requests that allowed to the backend
+        # service. If not specified, there is no limit.
+    "maxRequestsPerConnection": 42, # Maximum requests for a single connection to the backend service.
+        # This parameter is respected by both the HTTP/1.1 and HTTP/2
+        # implementations. If not specified, there is no limit. Setting this
+        # parameter to 1 will effectively disable keep alive.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+    "maxRetries": 42, # The maximum number of parallel retries allowed to the backend cluster. If
+        # not specified, the default is 1.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+  },
+  "compressionMode": "A String", # Compress text responses using Brotli or gzip compression, based on
+      # the client's Accept-Encoding header.
+  "connectionDraining": { # Message containing connection draining configuration. # connectionDraining cannot be specified with haPolicy.
+    "drainingTimeoutSec": 42, # Configures a duration timeout for existing requests on a removed backend
+        # instance. For supported load balancers and protocols, as described inEnabling
+        # connection draining.
+  },
+  "connectionTrackingPolicy": { # Connection Tracking configuration for this BackendService. # Connection Tracking configuration for this BackendService. Connection
+      # tracking policy settings are only available for external passthrough
+      # Network Load Balancers and internal passthrough Network Load Balancers.
+      # 
+      # connectionTrackingPolicy cannot be specified with haPolicy.
+    "connectionPersistenceOnUnhealthyBackends": "A String", # Specifies connection persistence when backends are unhealthy. The default
+        # value is DEFAULT_FOR_PROTOCOL.
+        #
+        # If set to DEFAULT_FOR_PROTOCOL, the existing connections
+        # persist on unhealthy backends only for connection-oriented protocols
+        # (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
+        # Affinity is configured for 5-tuple. They do not persist forUDP.
+        #
+        # If set to NEVER_PERSIST, after a backend becomes unhealthy,
+        # the existing connections on the unhealthy backend are never persisted on
+        # the unhealthy backend. They are always diverted to newly selected healthy
+        # backends (unless all backends are unhealthy).
+        #
+        # If set to ALWAYS_PERSIST, existing connections always
+        # persist on unhealthy backends regardless of protocol and session
+        # affinity. It is generally not recommended to use this mode overriding the
+        # default.
+        #
+        # For more details, see [Connection Persistence for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)
+        # and [Connection Persistence for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).
+    "enableStrongAffinity": True or False, # Enable Strong Session Affinity for external passthrough Network Load
+        # Balancers. This option is not available publicly.
+    "idleTimeoutSec": 42, # Specifies how long to keep a Connection Tracking entry while there is no
+        # matching traffic (in seconds).
+        #
+        # For internal passthrough Network Load Balancers:
+        #
+        #    - The minimum (default) is 10 minutes and the maximum is 16 hours.
+        #    - It can be set only if Connection Tracking is less than 5-tuple
+        #    (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
+        #    Mode is PER_SESSION).
+        #
+        #
+        #
+        # For external passthrough Network Load Balancers the default is 60
+        # seconds. This option is not available publicly.
+    "trackingMode": "A String", # Specifies the key used for connection tracking. There are two
+        # options:
+        #
+        #    - PER_CONNECTION: This is the default mode. The Connection
+        #    Tracking is performed as per the Connection Key (default Hash Method) for
+        #    the specific protocol.
+        #    - PER_SESSION: The Connection Tracking is performed as per
+        #    the configured Session Affinity. It matches the configured Session
+        #    Affinity.
+        #
+        #
+        #
+        # For more details, see [Tracking Mode for Network Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)
+        # and [Tracking Mode for Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).
+  },
+  "consistentHash": { # This message defines settings for a consistent hash style load balancer. # Consistent Hash-based load balancing can be used to provide soft session
+      # affinity based on HTTP headers, cookies or other properties. This load
+      # balancing policy is applicable only for HTTP connections. The affinity to a
+      # particular destination host will be lost when one or more hosts are
+      # added/removed from the destination service. This field specifies parameters
+      # that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "httpCookie": { # The information about the HTTP Cookie on which the hash function is based # Hash is based on HTTP Cookie. This field describes a HTTP cookie that will
+        # be used as the hash key for the consistent hash load balancer. If the
+        # cookie is not present, it will be generated. This field is applicable if
+        # the sessionAffinity is set to HTTP_COOKIE.
+        #
+        # Not supported when the backend service is referenced by a URL map that is
+        # bound to target gRPC proxy that has validateForProxyless field set to true.
+        # for load balancing policies that use a consistent hash.
+      "name": "A String", # Name of the cookie.
+      "path": "A String", # Path to set for the cookie.
+      "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "httpHeaderName": "A String", # The hash based on the value of the specified header field. This field is
+        # applicable if the sessionAffinity is set toHEADER_FIELD.
+    "minimumRingSize": "A String", # The minimum number of virtual nodes to use for the hash ring. Defaults to
+        # 1024. Larger ring sizes result in more granular load distributions. If the
+        # number of hosts in the load balancing pool is larger than the ring size,
+        # each host will be assigned a single virtual node.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customMetrics": [ # List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.
+    { # Custom Metrics are used for WEIGHTED_ROUND_ROBIN
+        # locality_lb_policy.
+      "dryRun": True or False, # If true, the metric data is not used for load balancing.
+      "name": "A String", # Name of a custom utilization signal. The name must be 1-64 characters
+          # long and match the regular expression
+          # `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the
+          # first character must be a lowercase letter, and all following
+          # characters must be a dash, period, underscore, lowercase letter, or
+          # digit, except the last character, which cannot be a dash, period, or
+          # underscore. For usage guidelines, see Custom Metrics balancing mode. This
+          # field can only be used for a global or regional backend service with the
+          # loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.
+    },
+  ],
+  "customRequestHeaders": [ # Headers that the load balancer adds to proxied requests. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "customResponseHeaders": [ # Headers that the load balancer adds to proxied responses. See [Creating
+      # custom
+      # headers](https://cloud.google.com/load-balancing/docs/custom-headers).
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "edgeSecurityPolicy": "A String", # [Output Only] The resource URL for the edge security policy associated with
+      # this backend service.
+  "enableCDN": True or False, # If true, enables Cloud CDN for the backend service of a
+      # global external Application Load Balancer.
+  "externalManagedMigrationState": "A String", # Specifies the canary migration state. Possible values are PREPARE,
+      # TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.
+      # 
+      # To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be
+      # changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before
+      # the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using
+      # externalManagedMigrationTestingPercentage.
+      # 
+      # Rolling back a migration requires the states to be set in reverse order. So
+      # changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to
+      # be set to TEST_ALL_TRAFFIC at the same time. Optionally, the
+      # TEST_BY_PERCENTAGE state can be used to migrate some traffic back to
+      # EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.
+  "externalManagedMigrationTestingPercentage": 3.14, # Determines the fraction of requests that should be processed by the Global
+      # external Application Load Balancer.
+      # 
+      # The value of this field must be in the range [0, 100].
+      # 
+      # Session affinity options will slightly affect this routing behavior, for
+      # more details, see:Session
+      # Affinity.
+      # 
+      # This value can only be set if the loadBalancingScheme in the BackendService
+      # is set to EXTERNAL (when using the classic Application Load Balancer) and
+      # the migration state is TEST_BY_PERCENTAGE.
+  "failoverPolicy": { # For load balancers that have configurable # Requires at least one backend instance group to be defined
+      # as a backup (failover) backend.
+      # For load balancers that have configurable failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough
+      # Network Load Balancers.
+      # failover:
+      # [Internal passthrough Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+      # and [external passthrough
+      # Network Load
+      # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+      # On failover or failback, this field indicates whether connection draining
+      # will be honored. Google Cloud has a fixed connection draining timeout of
+      # 10 minutes. A setting of true terminates existing TCP
+      # connections to the active pool during failover and failback, immediately
+      # draining traffic. A setting of false allows existing TCP
+      # connections to persist, even on VMs no longer in the active pool, for up
+      # to the duration of the connection draining timeout (10 minutes).
+    "disableConnectionDrainOnFailover": True or False, # This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
+        #
+        # The default is false.
+    "dropTrafficIfUnhealthy": True or False, # If set to true, connections to the
+        # load balancer are dropped when all primary and all backup backend VMs are
+        # unhealthy.If set to false, connections are distributed
+        # among all primary VMs when all primary and all backup backend VMs are
+        #  unhealthy.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external passthrough
+        # Network Load
+        # Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+        # The default is false.
+    "failoverRatio": 3.14, # The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a
+        # failover when the number of healthy primary VMs equals zero.
+        # For all other values, the load balancer performs a failover when the
+        # total number of healthy primary VMs is less than this ratio.
+        # For load balancers that have configurable
+        # failover:
+        # [Internal TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)
+        # and [external TCP/UDP Load
+        # Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).
+  },
+  "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 BackendService. An up-to-date fingerprint must be provided in
+      # order to update the BackendService, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a BackendService.
+  "haPolicy": { # Configures self-managed High Availability (HA) for External and Internal
+      # Protocol Forwarding.
+      # 
+      # The backends of this regional backend service must only specify zonal
+      # network endpoint groups (NEGs) of type GCE_VM_IP.
+      # 
+      # When haPolicy is set for an Internal Passthrough Network Load Balancer, the
+      # regional backend service must set the network field. All zonal NEGs must
+      # belong to the same network. However, individual NEGs can
+      # belong to different subnetworks of that network.
+      # 
+      # When haPolicy is specified, the set of attached network endpoints across
+      # all backends comprise an High Availability domain from which one endpoint
+      # is selected as the active endpoint (the leader) that receives all
+      # traffic.
+      # 
+      # haPolicy can be added only at backend service creation time. Once set up,
+      # it cannot be deleted.
+      # 
+      # Note that haPolicy is not for load balancing, and therefore cannot be
+      # specified with sessionAffinity, connectionTrackingPolicy, and
+      # failoverPolicy.
+      # 
+      # haPolicy requires customers to be responsible for tracking backend
+      # endpoint health and electing a leader among the healthy endpoints.
+      # Therefore, haPolicy cannot be specified with healthChecks.
+      # haPolicy can only be specified for External Passthrough
+      # Network Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network
+      # Load Balancers.
+    "fastIPMove": "A String", # Specifies whether fast IP move is enabled, and if so, the mechanism to
+        # achieve it.
+        #
+        # Supported values are:
+        #
+        #    - DISABLED: Fast IP Move is disabled. You can only use the
+        #    haPolicy.leader API to update the leader.
+        #    - >GARP_RA: Provides a method to very quickly define a new network
+        #    endpoint as the leader. This method is faster than updating the leader
+        #    using the haPolicy.leader API. Fast IP move works as follows: The VM
+        #    hosting the network endpoint that should become the new leader sends
+        #    either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router
+        #    Advertisement(RA) packet (IPv6).  Google Cloud immediately but
+        #    temporarily associates the forwarding rule IP address with that VM, and
+        #    both new and in-flight packets are quickly delivered to that VM.
+        #
+        #
+        #
+        # Note the important properties of the Fast IP Move functionality:
+        #
+        #    - The GARP/RA-initiated re-routing stays active for approximately 20
+        #    minutes. After triggering fast failover, you must also
+        #    appropriately set the haPolicy.leader.
+        #    -  The new leader instance should continue to send GARP/RA packets
+        #    periodically every 10 seconds until at least 10 minutes after updating
+        #    the haPolicy.leader (but stop immediately if it is no longer the leader).
+        #    - After triggering a fast failover, we recommend that you wait at least
+        #    3 seconds before sending another GARP/RA packet from a different VM
+        #    instance to avoid race conditions.
+        #    - Don't send GARP/RA packets from different VM
+        #    instances at the same time. If multiple instances continue to send
+        #    GARP/RA packets, traffic might be routed to different destinations in an
+        #    alternating order. This condition ceases when a single instance
+        #    issues a GARP/RA packet.
+        #    - The GARP/RA request always takes priority over the leader API.
+        #    Using the haPolicy.leader API to change the leader to a different
+        #    instance will have no effect until the GARP/RA request becomes
+        #    inactive.
+        #    - The GARP/RA packets should follow the GARP/RA
+        #    Packet Specifications..
+        #    -  When multiple forwarding rules refer to a regional backend service,
+        #    you need only send a GARP or RA packet for a single forwarding rule
+        #    virtual IP. The virtual IPs for all forwarding rules targeting the same
+        #    backend service will also be moved to the sender of the GARP or RA
+        #    packet.
+        #
+        #
+        #
+        # The following are the Fast IP Move limitations (that is, when fastIPMove
+        # is not DISABLED):
+        #
+        #    - Multiple forwarding rules cannot use the same IP address if one of
+        #    them refers to a regional backend service with fastIPMove.
+        #    - The regional backend service must set the network field, and all
+        #    NEGs must belong to that network. However, individual
+        #    NEGs can belong to different subnetworks of that network.
+        #    - The maximum number of network endpoints across all backends of a
+        #    backend service with fastIPMove is 32.
+        #    - The maximum number of backend services with fastIPMove that can have
+        #    the same network endpoint attached to one of its backends is 64.
+        #    - The maximum number of backend services with fastIPMove in a VPC in a
+        #    region is 64.
+        #    - The network endpoints that are attached to a backend of a backend
+        #    service with fastIPMove cannot resolve to Gen3+ machines for IPv6.
+        #    - Traffic directed to the leader by a static route next hop will not be
+        #    redirected to a new leader by fast failover. Such traffic will only be
+        #    redirected once an haPolicy.leader update has taken effect. Only traffic
+        #    to the forwarding rule's virtual IP will be redirected to a new leader by
+        #    fast failover.
+        #
+        #
+        # haPolicy.fastIPMove can be set only at backend service creation time.
+        # Once set, it cannot be updated.
+        #
+        # By default, fastIpMove is set to DISABLED.
+    "leader": { # Selects one of the network endpoints attached to the backend NEGs of
+        # this service as the active endpoint (the leader) that receives all
+        # traffic.
+        #
+        # When the leader changes, there is no connection draining to persist
+        # existing connections on the old leader.
+        #
+        # You are responsible for selecting a suitable endpoint as the
+        # leader. For example, preferring a healthy endpoint over unhealthy ones.
+        # Note that this service does not track backend endpoint health, and
+        # selects the configured leader unconditionally.
+      "backendGroup": "A String", # A fully-qualified URL (starting with https://www.googleapis.com/)
+          # of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints
+          # that the leader is attached to.
+          #
+          # The leader's backendGroup must already be specified as a backend of
+          # this backend service. Removing a backend that is designated as the
+          # leader's backendGroup is not permitted.
+      "networkEndpoint": { # The network endpoint within the leader.backendGroup that is
+          # designated as the leader.
+          #
+          # This network endpoint cannot be detached from the NEG specified in
+          # the haPolicy.leader.backendGroup until the leader is updated with
+          # another network endpoint, or the leader is removed from the haPolicy.
+        "instance": "A String", # The name of the VM instance of the leader network endpoint. The
+            # instance must already be attached to the NEG specified in the
+            # haPolicy.leader.backendGroup.
+            #
+            # The value must be a valid RFC1035 name (1-63 characters) or a valid
+            # instance URL.
+            # Authorization requires the following IAM permission on the
+            # specified resource instance: compute.instances.use
+      },
+    },
+  },
+  "healthChecks": [ # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
+      # httpsHealthChecks (legacy) resource for health checking this backend
+      # service. Not all backend services support legacy health checks. See
+      # Load balancer guide. Currently, at most one health check can be
+      # specified for each backend service. Backend services with
+      # instance group or zonal NEG backends must have a health check unless
+      # haPolicy is specified. Backend services with internet or serverless NEG
+      # backends must not have a health check.
+      # 
+      # healthChecks[] cannot be specified with haPolicy.
+    "A String",
+  ],
+  "iap": { # Identity-Aware Proxy # The configurations for Identity-Aware Proxy on this resource.
+      # Not available for internal passthrough Network Load Balancers and external
+      # passthrough Network Load Balancers.
+    "enabled": True or False, # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.
+    "oauth2ClientId": "A String", # OAuth2 client ID to use for the authentication flow.
+    "oauth2ClientSecret": "A String", # OAuth2 client secret to use for the authentication flow.
+        # For security reasons, this value cannot be retrieved via the API.
+        # Instead, the SHA-256 hash of the value is returned in the
+        # oauth2ClientSecretSha256 field.
+        #
+        # @InputOnly
+    "oauth2ClientSecretSha256": "A String", # Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ipAddressSelectionPolicy": "A String", # Specifies a preference for traffic sent from the proxy to the backend (or
+      # from the client to the backend for proxyless gRPC).
+      # The possible values are:
+      # 
+      #    - IPV4_ONLY: Only send IPv4 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv4
+      #    health checks are used to check the health of the backends. This is the
+      #    default setting.
+      #    - PREFER_IPV6: Prioritize the connection to the endpoint's
+      #    IPv6 address over its IPv4 address (provided there is a healthy IPv6
+      #    address).
+      #    - IPV6_ONLY: Only send IPv6 traffic to the backends of the
+      #    backend service (Instance Group, Managed Instance Group, Network Endpoint
+      #    Group), regardless of traffic from the client to the proxy. Only IPv6
+      #    health checks are used to check the health of the backends.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    -  Advanced global external Application Load Balancer (load balancing
+      #    scheme EXTERNAL_MANAGED),
+      #    -  Regional external Application Load
+      #    Balancer,
+      #    -  Internal proxy Network Load Balancer (load balancing
+      #    scheme INTERNAL_MANAGED),
+      #    -  Regional internal Application Load
+      #    Balancer (load balancing scheme INTERNAL_MANAGED),
+      #    -  Traffic
+      #    Director with Envoy proxies and proxyless gRPC (load balancing scheme
+      #    INTERNAL_SELF_MANAGED).
+  "kind": "compute#backendService", # Output only. [Output Only] Type of resource. Always compute#backendService
+      # for backend services.
+  "loadBalancingScheme": "A String", # Specifies the load balancer type. A backend service
+      # created for one type of load balancer cannot be used with another.
+      # For more information, refer to
+      # Backend services product and scheme table.
+  "localityLbPolicies": [ # A list of locality load-balancing policies to be used in order of
+      # preference. When you use localityLbPolicies, you must set at least one
+      # value for either the localityLbPolicies[].policy or the
+      # localityLbPolicies[].customPolicy field. localityLbPolicies overrides any
+      # value set in the localityLbPolicy field.
+      # 
+      # For an example of how to use this field, seeDefine
+      # a list of preferred policies.
+      # 
+      # Caution: This field and its children are intended for use in a service mesh
+      # that includes gRPC clients only. Envoy proxies can't use backend services
+      # that have this configuration.
+    { # Container for either a built-in LB policy supported by gRPC or Envoy or
+        # a custom one implemented by the end user.
+      "customPolicy": { # The configuration for a custom policy implemented by the user and
+          # deployed with the client.
+        "data": "A String", # An optional, arbitrary JSON object with configuration data, understood
+            # by a locally installed custom policy implementation.
+        "name": "A String", # Identifies the custom policy.
+            #
+            # The value should match the name of a custom implementation registered
+            # on the gRPC clients. It should follow protocol buffer message naming
+            # conventions and include the full path (for example,
+            # myorg.CustomLbPolicy). The maximum length is 256 characters.
+            #
+            # Do not specify the same custom policy more than once for a
+            # backend. If you do, the configuration is rejected.
+            #
+            # For an example of how to use this field, seeUse
+            # a custom policy.
+      },
+      "policy": { # The configuration for a built-in load balancing policy.
+        "name": "A String", # The name of a locality load-balancing policy. Valid values include
+            # ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information
+            # about these values, see the description of localityLbPolicy.
+            #
+            # Do not specify the same policy more than once for a
+            # backend. If you do, the configuration is rejected.
+      },
+    },
+  ],
+  "localityLbPolicy": "A String", # The load balancing algorithm used within the scope of the locality. The
+      # possible values are:
+      # 
+      #    - ROUND_ROBIN: This is a simple policy in which each healthy
+      #    backend is selected in round robin order. This is the default.
+      #    - LEAST_REQUEST: An O(1) algorithm which
+      #    selects two random healthy hosts and picks the host which has fewer active
+      #    requests.
+      #    - RING_HASH: The ring/modulo hash load balancer implements
+      #    consistent hashing to backends. The algorithm has the property that the
+      #    addition/removal of a host from a set of N hosts only affects 1/N of the
+      #    requests.
+      #    - RANDOM: The load balancer selects a random healthy
+      #    host.
+      #    - ORIGINAL_DESTINATION: Backend host is selected
+      #    based on the client connection metadata, i.e., connections are opened to
+      #    the same address as the destination address of the incoming connection
+      #    before the connection was redirected to the load balancer.
+      #    - MAGLEV: used as a drop in replacement for the ring hash
+      #    load balancer. Maglev is not as stable as ring hash but has faster table
+      #    lookup build times and host selection times. For more information about
+      #    Maglev, see Maglev:
+      #    A Fast and Reliable Software Network Load Balancer.
+      #    - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin
+      #    Load Balancing using weights computed from Backend reported Custom Metrics.
+      #    If set, the Backend Service responses are expected to contain non-standard
+      #    HTTP response header field Endpoint-Load-Metrics. The reported
+      #    metrics to use for computing the weights are specified via thecustomMetrics field.
+      #    - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via
+      #    health check reported weights. If set, the backend service must configure
+      #    an HTTP-based Health Check, and health check replies are expected to
+      #    contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint
+      #    weights. If set, load balancing is weighted based on the per-endpoint
+      #    weights reported in the last processed health check replies, as long as
+      #    every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.
+      #    Otherwise, load balancing remains equal-weight.
+      # 
+      # 
+      # 
+      # This field is applicable to either:
+      # 
+      #    - A regional backend service with the service protocol set to HTTP,
+      #    HTTPS, HTTP2 or H2C, and load_balancing_scheme set to
+      #    INTERNAL_MANAGED.
+      #    - A global backend service with the
+      #    load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
+      #    EXTERNAL_MANAGED.
+      # 
+      # 
+      # 
+      # If sessionAffinity is not configured—that is, if session
+      # affinity remains at the default value of NONE—then the
+      # default value for localityLbPolicy
+      # is ROUND_ROBIN. If session affinity is set to a value other
+      # than NONE,
+      # then the default value for localityLbPolicy isMAGLEV.
+      # 
+      # Only ROUND_ROBIN and RING_HASH are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # localityLbPolicy cannot be specified with haPolicy.
+  "logConfig": { # The available logging options for the load balancer traffic served by this # This field denotes the logging options for the load balancer traffic served
+      # by this backend service. If logging is enabled, logs will be exported to
+      # Stackdriver.
+      # backend service.
+    "enable": True or False, # Denotes whether to enable logging for the load balancer
+        # traffic served by this backend service. The default value is false.
+    "loggingHttpRequestHeaders": [ # The list of request headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "loggingHttpResponseHeaders": [ # The list of response headers that will be logged to Stackdriver.
+      { # Determines which HTTP headers will be logged to Stackdriver.
+        "headerName": "A String", # The name of the header to be logged.
+      },
+    ],
+    "optionalFields": [ # This field can only be specified if logging is enabled for this backend
+        # service and "logConfig.optionalMode" was set to CUSTOM. Contains a list
+        # of optional fields you want to include in the logs. For example:
+        # serverInstance, serverGkeDetails.cluster,
+        # serverGkeDetails.pod.podNamespace
+      "A String",
+    ],
+    "optionalMode": "A String", # This field can only be specified if logging is enabled for this backend
+        # service. Configures whether all, none or a subset of optional fields
+        # should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,
+        # EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
+    "sampleRate": 3.14, # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+  },
+  "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the default maximum duration (timeout) for streams to this
+      # service. Duration is computed from the beginning of the stream until the
+      # response has been completely processed, including all retries. A stream
+      # that does not complete in this duration is closed.
+      # 
+      # If not specified, there will be no timeout limit, i.e. the maximum
+      # duration is infinite.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # This field is only allowed when the loadBalancingScheme of
+      # the backend service is INTERNAL_SELF_MANAGED.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "metadatas": { # Deployment metadata associated with the resource to be set by a GKE hub
+      # controller and read by the backend RCTH
+    "a_key": "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.
+  "network": "A String", # The URL of the network to which this backend service belongs.
+      # 
+      # This field must be set for Internal Passthrough Network Load Balancers when
+      # the haPolicy is enabled, and for External Passthrough Network Load
+      # Balancers when the haPolicy fastIpMove is enabled.
+      # 
+      # This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.
+  "networkPassThroughLbTrafficPolicy": { # Configures traffic steering properties of internal passthrough Network
+      # Load Balancers.
+      # 
+      # networkPassThroughLbTrafficPolicy cannot be specified with haPolicy.
+    "zonalAffinity": { # When configured, new connections are load balanced across healthy backend
+        # endpoints in the local zone.
+      "spillover": "A String", # This field indicates whether zonal affinity is enabled or not. The
+          # possible values are:
+          #
+          #    - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity
+          #    is disabled. The load balancer distributes new connections to all
+          #    healthy backend endpoints across all zones.
+          #    - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there are no healthy
+          #    backend endpoints in the local zone, the load balancer distributes
+          #    new connections to all backend endpoints in the local zone.
+          #    - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is
+          #    enabled. The load balancer distributes new connections to all healthy
+          #    backend endpoints in the local zone only. If there aren't enough
+          #    healthy backend endpoints in the local zone, the load balancer
+          #    distributes new connections to all healthy backend endpoints across all
+          #    zones.
+      "spilloverRatio": 3.14, # The value of the field must be in [0, 1]. When the ratio of the count
+          # of healthy backend endpoints in a zone to the count of backend
+          # endpoints in that same zone is equal to or above this threshold, the
+          # load balancer distributes new connections to all healthy endpoints in
+          # the local zone only. When the ratio of the count of healthy backend
+          # endpoints in a zone to the count of backend endpoints in that same
+          # zone is below this threshold, the load balancer distributes all new
+          # 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
+      # considered disabled.
+      # 
+      # Results of the outlier detection algorithm (ejection of endpoints from the
+      # load balancing pool and returning them back to the pool) are executed
+      # independently by each proxy instance of the load balancer. In most cases,
+      # more than one proxy instance handles the traffic received by a backend
+      # service. Thus, it is possible that an unhealthy endpoint is detected and
+      # ejected by only some of the proxies, and while this happens, other proxies
+      # may continue to send requests to the same unhealthy endpoint until they
+      # detect and eject the unhealthy endpoint.
+      # 
+      # Applicable backend endpoints can be:
+      # 
+      #    - VM instances in an Instance Group
+      #    - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)
+      #    - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)
+      #    - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud
+      #    Functions Services
+      #    - Private Service Connect NEGs, that resolve to
+      #    Google-managed regional API endpoints or managed services published using
+      #    Private Service Connect
+      # 
+      # 
+      # 
+      # Applicable backend service types can be:
+      # 
+      #    - A global backend service with the loadBalancingScheme set to
+      #    INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED.
+      #    - A regional backend
+      #    service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
+      #    loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not
+      #    supported for Serverless NEGs.
+      # 
+      # 
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # pool for the backend service.
+    "baseEjectionTime": { # A Duration represents a fixed-length span of time represented # The base time that a backend endpoint is ejected for. Defaults to 30000ms
+        # or 30s.
+        #
+        # After a backend endpoint is returned back to the load balancing pool, it
+        # can be ejected again in another ejection analysis. Thus, the total ejection
+        # time is equal to the base ejection time multiplied by the number of times
+        # the backend endpoint has been ejected. Defaults to 30000ms or 30s.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "consecutiveErrors": 42, # Number of consecutive errors before a backend endpoint is ejected from the
+        # load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx
+        # return code qualifies as an error. Defaults to 5.
+    "consecutiveGatewayFailure": 42, # The number of consecutive gateway failures (502, 503, 504 status or
+        # connection errors that are mapped to one of those status codes) before a
+        # consecutive gateway failure ejection occurs. Defaults to 3.
+    "enforcingConsecutiveErrors": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive 5xx. This setting can be
+        # used to disable ejection or to ramp it up slowly. Defaults to 0.
+    "enforcingConsecutiveGatewayFailure": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through consecutive gateway failures. This
+        # setting can be used to disable ejection or to ramp it up slowly. Defaults
+        # to 100.
+    "enforcingSuccessRate": 42, # The percentage chance that a backend endpoint will be ejected when an
+        # outlier status is detected through success rate statistics. This setting
+        # can be used to disable ejection or to ramp it up slowly. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "interval": { # A Duration represents a fixed-length span of time represented # Time interval between ejection analysis sweeps. This can result in both new
+        # ejections and backend endpoints being returned to service. The interval is
+        # equal to the number of seconds as defined in
+        # outlierDetection.interval.seconds plus the number of nanoseconds as defined
+        # in outlierDetection.interval.nanos. Defaults to 1 second.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "maxEjectionPercent": 42, # Maximum percentage of backend endpoints in the load balancing pool for the
+        # backend service that can be ejected if the ejection conditions are met.
+        # Defaults to 50%.
+    "successRateMinimumHosts": 42, # The number of backend endpoints in the load balancing pool that must have
+        # enough request volume to detect success rate outliers. If the number of
+        # backend endpoints is fewer than this setting, outlier detection via success
+        # rate statistics is not performed for any backend endpoint in the load
+        # balancing pool. Defaults to 5.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval
+        # (as defined by the interval duration above) to include this backend
+        # endpoint in success rate based outlier detection. If the volume is lower
+        # than this setting, outlier detection via success rate statistics is not
+        # performed for that backend endpoint. Defaults to 100.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+    "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate
+        # outlier ejection. The ejection threshold is the difference between the mean
+        # success rate, and the product of this factor and the standard deviation of
+        # the mean success rate: mean - (stdev * successRateStdevFactor). This factor
+        # is divided by a thousand to get a double. That is, if the desired factor
+        # is 1.9, the runtime value should be 1900. Defaults to 1900.
+        #
+        # Not supported when the backend service uses Serverless NEG.
+  },
+  "params": { # Additional Backend Service 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "port": 42, # Deprecated in favor of portName. The TCP port to connect on
+      # the backend. The default value is 80.
+      # For internal passthrough Network Load Balancers and external passthrough
+      # Network Load Balancers, omit port.
+  "portName": "A String", # A named port on a backend instance group representing the port for
+      # communication to the backend VMs in that group. The
+      # named port must be [defined on each backend instance
+      # group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).
+      # This parameter has no meaning if the backends are NEGs. For internal
+      # passthrough Network Load Balancers and external passthrough Network Load
+      # Balancers, omit port_name.
+  "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+      # 
+      # Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
+      # UNSPECIFIED, depending on the chosen load balancer or Traffic Director
+      # configuration.
+      # Refer to
+      # Load balancing features for more information.
+      # 
+      # Must be set to GRPC when the backend service is referenced by a URL map
+      # that is bound to target gRPC proxy.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional backend service
+      # resides. This field is not applicable to global backend services.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # backend service.
+  "securitySettings": { # The authentication and authorization settings for a BackendService. # This field specifies the security settings that apply to this backend
+      # service. This field is applicable to a global backend service with the
+      # load_balancing_scheme set to INTERNAL_SELF_MANAGED.
+    "awsV4Authentication": { # Contains the configurations necessary to generate a signature for access to # The configuration needed to generate a signature for access to private
+        # storage buckets that support AWS's Signature Version 4 for authentication.
+        # Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.
+        # private storage buckets that support Signature Version 4 for authentication.
+        # The service name for generating the authentication header will always default
+        # to 's3'.
+      "accessKey": "A String", # The access key used for s3 bucket authentication. Required for updating or
+          # creating a backend that uses AWS v4 signature authentication, but will not
+          # be returned as part of the configuration when queried with a REST API GET
+          # request.
+          #
+          # @InputOnly
+      "accessKeyId": "A String", # The identifier of an access key used for s3 bucket authentication.
+      "accessKeyVersion": "A String", # The optional version identifier for the access key. You can use this to
+          # keep track of different iterations of your access key.
+      "originRegion": "A String", # The name of the cloud region of your origin. This is a free-form field with
+          # the name of the region your cloud uses to host your origin.  For example,
+          # "us-east-1" for AWS or "us-ashburn-1" for OCI.
+    },
+    "clientTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ClientTlsPolicy resource
+        # that describes how clients should authenticate with this service's
+        # backends.
+        #
+        #  clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set
+        # to INTERNAL_SELF_MANAGED.
+        #
+        #  If left blank, communications are not encrypted.
+    "subjectAltNames": [ # Optional. A list of Subject Alternative Names (SANs) that the client
+        # verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate
+        # to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the
+        # specified values, the communication continues. Otherwise, it fails. This
+        # additional check enables the client to verify that the server is authorized
+        # to run the requested service.
+        #
+        #  Note that the contents of the server
+        # certificate's subjectAltName field are configured by the
+        # Public Key Infrastructure which provisions server identities.
+        #
+        #  Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+        # Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS
+        # mode).
+      "A String",
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serviceBindings": [ # URLs of networkservices.ServiceBinding resources.
+      # 
+      # Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED.
+      # If set, lists of backends and health checks must be both empty.
+    "A String",
+  ],
+  "serviceLbPolicy": "A String", # URL to networkservices.ServiceLbPolicy resource.
+      # 
+      # Can only be set if load balancing scheme is EXTERNAL_MANAGED,
+      # INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and
+      # EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a
+      # global backend service, the service lb policy must be global. For a
+      # regional backend service, the service lb policy must be regional and in the
+      # same region.
+  "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+      # 
+      # Only NONE and HEADER_FIELD are supported
+      # when the backend service is referenced by a URL map that is bound to
+      # target gRPC proxy that has validateForProxyless field set to true.
+      # 
+      # For more details, see:
+      # [Session
+      # Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).
+      # 
+      # sessionAffinity cannot be specified with haPolicy.
+  "strongSessionAffinityCookie": { # The HTTP cookie used for stateful session affinity. # Describes the HTTP cookie used for stateful session affinity. This field is
+      # applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY.
+    "name": "A String", # Name of the cookie.
+    "path": "A String", # Path to set for the cookie.
+    "ttl": { # A Duration represents a fixed-length span of time represented # Lifetime of the cookie.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+  },
+  "subsetting": { # Subsetting configuration for this BackendService. # subsetting cannot be specified with haPolicy.
+      # Currently this is applicable only for Internal TCP/UDP load balancing,
+      # Internal HTTP(S) load balancing and Traffic Director.
+    "policy": "A String",
+  },
+  "timeoutSec": 42, # The backend service timeout has a different meaning depending on the
+      # type of load balancer. For more information see,
+      # Backend service settings.
+      # The default is 30 seconds.
+      # The full range of timeout values allowed goes from 1
+      # through 2,147,483,647 seconds.
+      # 
+      # This value can be overridden in the PathMatcher configuration of the
+      # UrlMap that references this backend service.
+      # 
+      # Not supported when the backend service is referenced by a URL map that is
+      # bound to target gRPC proxy that has validateForProxyless field set to true.
+      # Instead, use maxStreamDuration.
+  "tlsSettings": { # Configuration for Backend Authenticated TLS and mTLS. May only be specified
+      # when the backend protocol is SSL, HTTPS or HTTP2.
+    "authenticationConfig": "A String", # Reference to the BackendAuthenticationConfig resource from the
+        # networksecurity.googleapis.com namespace. Can be used in authenticating
+        # TLS connections to the backend, as specified by the authenticationMode
+        # field. Can only be specified if authenticationMode is not NONE.
+    "identity": "A String", # Assigns the Managed Identity for the BackendService Workload.
+        #
+        #
+        # Use this property to configure the load balancer back-end to use
+        # certificates and roots of trust provisioned by the Managed Workload
+        # Identity system.
+        #
+        #  The `identity` property is the
+        # fully-specified SPIFFE ID to use in the SVID presented by the Load
+        # Balancer Workload.
+        #
+        #  The SPIFFE ID must be a resource starting with the
+        # `trustDomain` property value, followed by the path to the Managed
+        # Workload Identity.
+        #
+        #  Supported SPIFFE ID format:
+        #
+        #    - //<trust_domain>/ns/<namespace>/sa/<subject>
+        #
+        #
+        # The Trust Domain within the Managed Identity must refer to a valid
+        # Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig
+        # will be inherited from the Workload Identity Pool.
+        #
+        #  Restrictions:
+        #
+        #    - If you set the `identity` property, you cannot manually set
+        #    the following fields:
+        #        - tlsSettings.sni
+        #       - tlsSettings.subjectAltNames
+        #       - tlsSettings.authenticationConfig
+        #
+        #
+        # When defining a `identity` for a RegionBackendServices, the
+        # corresponding Workload Identity Pool must have a ca_pool
+        # configured in the same region.
+        #
+        #  The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.
+    "sni": "A String", # Server Name Indication - see RFC3546 section 3.1. If set, the load
+        # balancer sends this string as the SNI hostname in the TLS connection to
+        # the backend, and requires that this string match a Subject Alternative
+        # Name (SAN) in the backend's server certificate. With a Regional Internet
+        # NEG backend, if the SNI is specified here, the load balancer uses it
+        # regardless of whether the Regional Internet NEG is specified with FQDN or
+        # IP address and port. When both sni and subjectAltNames[] are specified,
+        # the load balancer matches the backend certificate's SAN only to
+        # subjectAltNames[].
+    "subjectAltNames": [ # A list of Subject Alternative Names (SANs) that the Load Balancer
+        # verifies during a TLS handshake with the backend. When the server
+        # presents its X.509 certificate to the Load Balancer, the Load Balancer
+        # inspects the certificate's SAN field, and requires that at least one SAN
+        # match one of the subjectAltNames in the list. This field is limited to 5
+        # entries. When both sni and subjectAltNames[] are specified, the load
+        # balancer matches the backend certificate's SAN only to subjectAltNames[].
+      { # A Subject Alternative Name that the load balancer matches against the SAN
+          # field in the TLS certificate provided by the backend, specified as either
+          # a DNS name or a URI, in accordance with RFC 5280 4.2.1.6
+        "dnsName": "A String", # The SAN specified as a DNS Name.
+        "uniformResourceIdentifier": "A String", # The SAN specified as a URI.
+      },
+    ],
+  },
+  "usedBy": [ # Output only. [Output Only] List of resources referencing given backend service.
+    {
+      "reference": "A String", # Output only. [Output Only] Server-defined URL for resources referencing given
+          # BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies
+          # and ForwardingRule.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionCommitments.html b/docs/dyn/compute_preview.regionCommitments.html new file mode 100644 index 0000000000..baa39de00f --- /dev/null +++ b/docs/dyn/compute_preview.regionCommitments.html @@ -0,0 +1,2977 @@ + + + +

Compute Engine API . regionCommitments

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of commitments by region.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, commitment, x__xgafv=None)

+

Returns the specified commitment resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a commitment in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of commitments contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, region, commitment, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates the specified commitment with the data included in the request.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of commitments by region.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of CommitmentsScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of commitments.
+      "commitments": [ # [Output Only] The list of commitments contained in this scope.
+        { # Represents a regional resource-based commitment resource.
+            #
+            # Creating this commitment resource means that you are purchasing a
+            # resource-based committed use contract, with an explicit start and end time.
+            # You can purchase resource-based commitments for both hardware and software
+            # resources. For more information, read
+            # Resource-based committed use discounts
+          "autoRenew": True or False, # Specifies whether to automatically renew the commitment at the end of its
+              # current term. The default value is false. If you set the field
+              # to true, each time your commitment reaches the end of its
+              # term, Compute Engine automatically renews it for another term. You can
+              # update this field anytime before the commitment expires. For example, if
+              # the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can
+              # update this field until 11:59 PM UTC-8 on January 2, 2027.
+          "category": "A String", # The category of the commitment; specifies whether the commitment is for
+              # hardware or software resources. Category MACHINE specifies
+              # that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.
+              # Category LICENSE specifies that you are committing to software
+              # licenses, listed in licenseResources.
+              # Note that if you specify MACHINE commitments, then you must
+              # also specify a type to indicate the machine series of the
+              # hardware resource that you are committing to.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "customEndTimestamp": "A String", # [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired
+              # commitment's end date is later than the start date + term duration.
+          "description": "A String", # An optional description of the commitment. You can provide this property
+              # when you create the resource.
+          "endTimestamp": "A String", # Output only. [Output Only] Commitment end time inRFC3339
+              # text format.
+          "existingReservations": [
+            "A String",
+          ],
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#commitment", # Output only. [Output Only] Type of the resource. Always compute#commitment
+              # for commitments.
+          "licenseResource": { # Commitment for a particular license resource. # The license specification required as part of a license commitment.
+            "amount": "A String", # The number of licenses you plan to purchase.
+            "coresPerLicense": "A String", # The number of cores per license.
+            "license": "A String", # The applicable license URI.
+          },
+          "mergeSourceCommitments": [ # The list of source commitments that you are merging to create the new
+              # merged commitment. For more information, see
+              # Merging commitments.
+            "A String",
+          ],
+          "name": "A String", # Name of the commitment. You must specify a name when you purchase the
+              # commitment. 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.
+          "params": { # Additional commitment 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 commitment. 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",
+            },
+          },
+          "plan": "A String", # The minimum time duration that you commit to purchasing resources.
+              # The plan that you choose determines the preset term length of the
+              # commitment (which is 1 year or 3 years) and affects the discount rate that
+              # you receive for your resources. Committing to a longer time duration
+              # typically gives you a higher discount rate. The supported values for this
+              # field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).
+          "region": "A String", # Output only. [Output Only] URL of the region where the commitment and committed
+              # resources are located.
+          "reservations": [ # The list of new reservations that you want to create and attach to this
+              # commitment.
+              #
+              # You must attach reservations to your commitment if your commitment
+              # specifies any GPUs or Local SSD disks. For more information, see
+              # Attach reservations to resource-based commitments.
+              #
+              # Specify this property only if you want to create new
+              # reservations to attach. To attach existing reservations, specify theexistingReservations property instead.
+            { # Represents a reservation resource.  A reservation ensures that capacity is
+                # held in a specific zone even if the reserved VMs are not running. For more
+                # information, read  Reserving zonal
+                # resources.
+              "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+                  # deployment type reservations.
+                  # type reservations.
+                "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+              },
+              "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+                  # count of CPUs) and can account for multiple instance SKUs. In other words,
+                  # one can create instances of varying shapes against this reservation.
+                "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+                  {
+                    "accelerator": { # Properties of accelerator resources in this reservation.
+                      "acceleratorCount": 42, # Number of accelerators of specified type.
+                      "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                          # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                    },
+                  },
+                ],
+                "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+                  {
+                    "accelerator": { # Properties of accelerator resources in this reservation.
+                      "acceleratorCount": 42, # Number of accelerators of specified type.
+                      "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                          # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                    },
+                  },
+                ],
+                "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+                    # belong to.
+                "workloadType": "A String", # The workload type of the instances that will target this reservation.
+              },
+              "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+                  # displays for reservations that are tied to a commitment.
+              "confidentialComputeType": "A String",
+              "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+                  # text format.
+              "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+                  # automatically delete this resource.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+                  #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+              "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+                  # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+                  # enrolled in early access maintenance and the standard notice applies.
+              "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+                  # for example, to fix hardware errors.
+              "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+                  # defined by the server.
+              "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+              "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+                  # displays for reservations that are tied to multiple commitments.
+                "A String",
+              ],
+              "name": "A String", # The name of the resource, provided by the client when initially creating
+                  # the resource. The resource 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.
+              "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).
+              "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+                  # will not be shared with Google Cloud managed services.
+                "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+              },
+              "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+                  # resource. It is populated for each instance of the Allocation
+                  # resource, and includes the api_version the
+                  # instance was retrieved through, and its canonical
+                  # resource_type name.
+                "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+                    # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+                "resourceType": "A String", # The canonical resource type name in the format of a resource type
+                    # as defined by [AIP-123](https://google.aip.dev/123).
+                    # For example, `"compute.googleapis.com/Instance"`.
+              },
+              "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+                  # user, and the value is resource policy url. This is to define placement
+                  # policy with reservation.
+                "a_key": "A String",
+              },
+              "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+                "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+                  "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+                  "healthStatus": "A String", # The health status of the reservation.
+                  "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+                },
+                "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+                "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+                  "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+                  "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+                  "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                      # Describes number of hosts in the block that have ongoing maintenance.
+                  "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                      # Describes number of hosts in the block that have pending maintenance.
+                  "schedulingType": "A String", # The type of maintenance for the reservation.
+                  "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+                      # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                      # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+                      # Domains). Not all VM Families will support this field.
+                  "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+                      #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                      #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+                      #  Domains). Not all VM Families will support this field.
+                  "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+                    "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+                    "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                        # This timestamp value is in RFC3339 text format.
+                    "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+                    "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+                      "A String",
+                    ],
+                    "maintenanceStatus": "A String",
+                    "type": "A String", # Defines the type of maintenance.
+                    "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                        # This timestamp value is in RFC3339 text format.
+                    "windowStartTime": "A String", # The current start time of the maintenance window.
+                        # This timestamp value is in RFC3339 text format.
+                  },
+                },
+                "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+                  "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+                  "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+                      # service name.
+                    "a_key": "A String",
+                  },
+                },
+              },
+              "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+              "schedulingType": "A String", # The type of maintenance for the reservation.
+              "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+              "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+                  # optional. For more information about the syntax and options for this
+                  # field and its subfields, see the guide for creating
+                  # a shared reservation.
+                "projectMap": { # A map of project id and project config. This is only valid when
+                    # share_type's value is SPECIFIC_PROJECTS.
+                  "a_key": { # Config for each project in the share settings.
+                    "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                        # parent map.
+                  },
+                },
+                "shareType": "A String", # Type of sharing for this shared-reservation
+              },
+              "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+                  #  configuration.
+                "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+                "count": "A String", # Specifies the number of resources that are allocated.
+                "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+                "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+                    # Next ID: 10
+                  "guestAccelerators": [ # Specifies accelerator type and count.
+                    { # A specification of the type and number of accelerator cards attached to the
+                        # instance.
+                      "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                      "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                          # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                          # If you are creating an instance template, specify only the
+                          # accelerator name.
+                          # See GPUs on Compute Engine
+                          # for a full list of accelerator types.
+                    },
+                  ],
+                  "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                      # of disk is local-ssd.
+                    {
+                      "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                          # either SCSI or NVME. The default isSCSI.
+                          # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                    },
+                  ],
+                  "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                      # resources.
+                      # This field is for use by internal tools that use the public API.
+                  "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                      # and fixed amount of memory. This also includes specifying custom
+                      # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+                  "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+                },
+                "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+                    # this field, you must exclude the instanceProperties field.
+                    #
+                    # This field is optional, and it can be a full or partial URL. For example,
+                    # the following are all valid URLs to an instance template:
+                    #
+                    #
+                    #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+                    #       - projects/project/global/instanceTemplates/instanceTemplate
+                    #       - global/instanceTemplates/instanceTemplate
+              },
+              "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+                  # for "any" reservation. If the field is set, then only VMs that target
+                  # the reservation by name can consume from this reservation.
+              "status": "A String", # Output only. [Output Only] The status of the reservation.
+                  #
+                  #
+                  #      - CREATING: Reservation resources are being
+                  #        allocated.
+                  #      - READY: Reservation resources have been allocated,
+                  #        and the reservation is ready for use.
+                  #      - DELETING: Reservation deletion is in progress.
+                  #      - UPDATING: Reservation update is in progress.
+              "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+                  # reservation is created within a commitment.
+            },
+          ],
+          "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Commitment resource.
+            "customTermEligibilityEndTimestamp": "A String", # Output only. [Output Only] Indicates the end time of customer's eligibility to send
+                # custom term requests in RFC3339 text format. Term extension requests that
+                # (not the end time in the request) after this time will be rejected.
+          },
+          "resources": [ # The list of all the hardware resources, with their types and amounts, that
+              # you want to commit to. Specify as a separate entry in the list for each
+              # individual resource type.
+            { # Commitment for a particular hardware resource (a commitment is composed of
+                # one or more of these).
+              "acceleratorType": "A String", # Name of the accelerator type or GPU resource. Specify this field only when
+                  # the type of hardware resource is ACCELERATOR.
+              "amount": "A String", # The quantity of the hardware resource that you want to commit to purchasing
+                  # (in a type-dependent unit).
+                  #
+                  #    - For vCPUs, you must specify an integer value.
+                  #    - For memory, you specify the amount of MB that you want. The value you
+                  #    specify must be a multiple of 256 MB, with up to 6.5 GB of
+                  #    memory per every vCPU.
+                  #    - For GPUs, you must specify an integer value.
+                  #    - For Local SSD disks, you must specify the amount in GB. The size of a
+                  #    single Local SSD disk is 375 GB.
+              "type": "A String", # The type of hardware resource that you want to specify.
+                  # You can specify any of the following values:
+                  #
+                  #    - VCPU
+                  #    - MEMORY
+                  #    - LOCAL_SSD
+                  #    - ACCELERATOR
+                  #
+                  #
+                  #
+                  # Specify as a separate entry in the list for each
+                  # individual resource type.
+            },
+          ],
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "splitSourceCommitment": "A String", # The source commitment from which you are transferring resources to create
+              # the new split commitment. For more information, see
+              # Split commitments.
+          "startTimestamp": "A String", # Output only. [Output Only] Commitment start time inRFC3339
+              # text format.
+          "status": "A String", # Output only. [Output Only] Status of the commitment with regards to eventual expiration
+              # (each commitment has an end date defined). Status can be one of the
+              # following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.
+          "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+          "type": "A String", # The type of commitment; specifies the
+              # machine series for which you want to commit to purchasing resources.
+              # The choice of machine series affects the discount rate and the eligible
+              # resource types.
+              #
+              #  The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,
+              #  COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For
+              # example, type MEMORY_OPTIMIZED specifies a commitment that
+              # applies only to eligible resources of memory optimized M1 and M2 machine
+              # series. Type GENERAL_PURPOSE specifies a commitment that
+              # applies only to eligible resources of general purpose N1 machine series.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of commitments
+          # 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#commitmentAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of
+      # commitments.
+  "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.
+
+ +
+ get(project, region, commitment, x__xgafv=None) + 
Returns the specified commitment resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  commitment: string, Name of the commitment 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 regional resource-based commitment resource.
+    #
+    # Creating this commitment resource means that you are purchasing a
+    # resource-based committed use contract, with an explicit start and end time.
+    # You can purchase resource-based commitments for both hardware and software
+    # resources. For more information, read
+    # Resource-based committed use discounts
+  "autoRenew": True or False, # Specifies whether to automatically renew the commitment at the end of its
+      # current term. The default value is false. If you set the field
+      # to true, each time your commitment reaches the end of its
+      # term, Compute Engine automatically renews it for another term. You can
+      # update this field anytime before the commitment expires. For example, if
+      # the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can
+      # update this field until 11:59 PM UTC-8 on January 2, 2027.
+  "category": "A String", # The category of the commitment; specifies whether the commitment is for
+      # hardware or software resources. Category MACHINE specifies
+      # that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.
+      # Category LICENSE specifies that you are committing to software
+      # licenses, listed in licenseResources.
+      # Note that if you specify MACHINE commitments, then you must
+      # also specify a type to indicate the machine series of the
+      # hardware resource that you are committing to.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customEndTimestamp": "A String", # [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired
+      # commitment's end date is later than the start date + term duration.
+  "description": "A String", # An optional description of the commitment. You can provide this property
+      # when you create the resource.
+  "endTimestamp": "A String", # Output only. [Output Only] Commitment end time inRFC3339
+      # text format.
+  "existingReservations": [
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#commitment", # Output only. [Output Only] Type of the resource. Always compute#commitment
+      # for commitments.
+  "licenseResource": { # Commitment for a particular license resource. # The license specification required as part of a license commitment.
+    "amount": "A String", # The number of licenses you plan to purchase.
+    "coresPerLicense": "A String", # The number of cores per license.
+    "license": "A String", # The applicable license URI.
+  },
+  "mergeSourceCommitments": [ # The list of source commitments that you are merging to create the new
+      # merged commitment. For more information, see
+      # Merging commitments.
+    "A String",
+  ],
+  "name": "A String", # Name of the commitment. You must specify a name when you purchase the
+      # commitment. 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.
+  "params": { # Additional commitment 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 commitment. 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",
+    },
+  },
+  "plan": "A String", # The minimum time duration that you commit to purchasing resources.
+      # The plan that you choose determines the preset term length of the
+      # commitment (which is 1 year or 3 years) and affects the discount rate that
+      # you receive for your resources. Committing to a longer time duration
+      # typically gives you a higher discount rate. The supported values for this
+      # field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).
+  "region": "A String", # Output only. [Output Only] URL of the region where the commitment and committed
+      # resources are located.
+  "reservations": [ # The list of new reservations that you want to create and attach to this
+      # commitment.
+      #
+      # You must attach reservations to your commitment if your commitment
+      # specifies any GPUs or Local SSD disks. For more information, see
+      # Attach reservations to resource-based commitments.
+      #
+      # Specify this property only if you want to create new
+      # reservations to attach. To attach existing reservations, specify theexistingReservations property instead.
+    { # Represents a reservation resource.  A reservation ensures that capacity is
+        # held in a specific zone even if the reserved VMs are not running. For more
+        # information, read  Reserving zonal
+        # resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+          # deployment type reservations.
+          # type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
+      "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+          # count of CPUs) and can account for multiple instance SKUs. In other words,
+          # one can create instances of varying shapes against this reservation.
+        "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+            # belong to.
+        "workloadType": "A String", # The workload type of the instances that will target this reservation.
+      },
+      "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+          # displays for reservations that are tied to a commitment.
+      "confidentialComputeType": "A String",
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+          # automatically delete this resource.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+          #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+      "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+          # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+          # enrolled in early access maintenance and the standard notice applies.
+      "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+          # for example, to fix hardware errors.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+      "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+          # displays for reservations that are tied to multiple commitments.
+        "A String",
+      ],
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "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).
+      "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+          # will not be shared with Google Cloud managed services.
+        "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+      },
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+          # resource. It is populated for each instance of the Allocation
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+          # user, and the value is resource policy url. This is to define placement
+          # policy with reservation.
+        "a_key": "A String",
+      },
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+        "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+          "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+          "healthStatus": "A String", # The health status of the reservation.
+          "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+        },
+        "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+        "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+          "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+          "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+          "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have ongoing maintenance.
+          "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have pending maintenance.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+              # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+              # Domains). Not all VM Families will support this field.
+          "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+              #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+              #  Domains). Not all VM Families will support this field.
+          "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+            "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+            "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                # This timestamp value is in RFC3339 text format.
+            "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+            "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+              "A String",
+            ],
+            "maintenanceStatus": "A String",
+            "type": "A String", # Defines the type of maintenance.
+            "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                # This timestamp value is in RFC3339 text format.
+            "windowStartTime": "A String", # The current start time of the maintenance window.
+                # This timestamp value is in RFC3339 text format.
+          },
+        },
+        "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+          "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+          "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+              # service name.
+            "a_key": "A String",
+          },
+        },
+      },
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+          # optional. For more information about the syntax and options for this
+          # field and its subfields, see the guide for creating
+          # a shared reservation.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+          #  configuration.
+        "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+        "count": "A String", # Specifies the number of resources that are allocated.
+        "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+        "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+            # Next ID: 10
+          "guestAccelerators": [ # Specifies accelerator type and count.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+              # of disk is local-ssd.
+            {
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. The default isSCSI.
+                  # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+            },
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+              # and fixed amount of memory. This also includes specifying custom
+              # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+          "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+        },
+        "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+            # this field, you must exclude the instanceProperties field.
+            #
+            # This field is optional, and it can be a full or partial URL. For example,
+            # the following are all valid URLs to an instance template:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+            #       - projects/project/global/instanceTemplates/instanceTemplate
+            #       - global/instanceTemplates/instanceTemplate
+      },
+      "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+          # for "any" reservation. If the field is set, then only VMs that target
+          # the reservation by name can consume from this reservation.
+      "status": "A String", # Output only. [Output Only] The status of the reservation.
+          #
+          #
+          #      - CREATING: Reservation resources are being
+          #        allocated.
+          #      - READY: Reservation resources have been allocated,
+          #        and the reservation is ready for use.
+          #      - DELETING: Reservation deletion is in progress.
+          #      - UPDATING: Reservation update is in progress.
+      "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+          # reservation is created within a commitment.
+    },
+  ],
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Commitment resource.
+    "customTermEligibilityEndTimestamp": "A String", # Output only. [Output Only] Indicates the end time of customer's eligibility to send
+        # custom term requests in RFC3339 text format. Term extension requests that
+        # (not the end time in the request) after this time will be rejected.
+  },
+  "resources": [ # The list of all the hardware resources, with their types and amounts, that
+      # you want to commit to. Specify as a separate entry in the list for each
+      # individual resource type.
+    { # Commitment for a particular hardware resource (a commitment is composed of
+        # one or more of these).
+      "acceleratorType": "A String", # Name of the accelerator type or GPU resource. Specify this field only when
+          # the type of hardware resource is ACCELERATOR.
+      "amount": "A String", # The quantity of the hardware resource that you want to commit to purchasing
+          # (in a type-dependent unit).
+          #
+          #    - For vCPUs, you must specify an integer value.
+          #    - For memory, you specify the amount of MB that you want. The value you
+          #    specify must be a multiple of 256 MB, with up to 6.5 GB of
+          #    memory per every vCPU.
+          #    - For GPUs, you must specify an integer value.
+          #    - For Local SSD disks, you must specify the amount in GB. The size of a
+          #    single Local SSD disk is 375 GB.
+      "type": "A String", # The type of hardware resource that you want to specify.
+          # You can specify any of the following values:
+          #
+          #    - VCPU
+          #    - MEMORY
+          #    - LOCAL_SSD
+          #    - ACCELERATOR
+          #
+          #
+          #
+          # Specify as a separate entry in the list for each
+          # individual resource type.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "splitSourceCommitment": "A String", # The source commitment from which you are transferring resources to create
+      # the new split commitment. For more information, see
+      # Split commitments.
+  "startTimestamp": "A String", # Output only. [Output Only] Commitment start time inRFC3339
+      # text format.
+  "status": "A String", # Output only. [Output Only] Status of the commitment with regards to eventual expiration
+      # (each commitment has an end date defined). Status can be one of the
+      # following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "type": "A String", # The type of commitment; specifies the
+      # machine series for which you want to commit to purchasing resources.
+      # The choice of machine series affects the discount rate and the eligible
+      # resource types.
+      #
+      #  The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,
+      #  COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For
+      # example, type MEMORY_OPTIMIZED specifies a commitment that
+      # applies only to eligible resources of memory optimized M1 and M2 machine
+      # series. Type GENERAL_PURPOSE specifies a commitment that
+      # applies only to eligible resources of general purpose N1 machine series.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a commitment in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a regional resource-based commitment resource.
+    # 
+    # Creating this commitment resource means that you are purchasing a
+    # resource-based committed use contract, with an explicit start and end time.
+    # You can purchase resource-based commitments for both hardware and software
+    # resources. For more information, read
+    # Resource-based committed use discounts
+  "autoRenew": True or False, # Specifies whether to automatically renew the commitment at the end of its
+      # current term. The default value is false. If you set the field
+      # to true, each time your commitment reaches the end of its
+      # term, Compute Engine automatically renews it for another term. You can
+      # update this field anytime before the commitment expires. For example, if
+      # the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can
+      # update this field until 11:59 PM UTC-8 on January 2, 2027.
+  "category": "A String", # The category of the commitment; specifies whether the commitment is for
+      # hardware or software resources. Category MACHINE specifies
+      # that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.
+      # Category LICENSE specifies that you are committing to software
+      # licenses, listed in licenseResources.
+      # Note that if you specify MACHINE commitments, then you must
+      # also specify a type to indicate the machine series of the
+      # hardware resource that you are committing to.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customEndTimestamp": "A String", # [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired
+      # commitment's end date is later than the start date + term duration.
+  "description": "A String", # An optional description of the commitment. You can provide this property
+      # when you create the resource.
+  "endTimestamp": "A String", # Output only. [Output Only] Commitment end time inRFC3339
+      # text format.
+  "existingReservations": [
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#commitment", # Output only. [Output Only] Type of the resource. Always compute#commitment
+      # for commitments.
+  "licenseResource": { # Commitment for a particular license resource. # The license specification required as part of a license commitment.
+    "amount": "A String", # The number of licenses you plan to purchase.
+    "coresPerLicense": "A String", # The number of cores per license.
+    "license": "A String", # The applicable license URI.
+  },
+  "mergeSourceCommitments": [ # The list of source commitments that you are merging to create the new
+      # merged commitment. For more information, see
+      # Merging commitments.
+    "A String",
+  ],
+  "name": "A String", # Name of the commitment. You must specify a name when you purchase the
+      # commitment. 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.
+  "params": { # Additional commitment 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 commitment. 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",
+    },
+  },
+  "plan": "A String", # The minimum time duration that you commit to purchasing resources.
+      # The plan that you choose determines the preset term length of the
+      # commitment (which is 1 year or 3 years) and affects the discount rate that
+      # you receive for your resources. Committing to a longer time duration
+      # typically gives you a higher discount rate. The supported values for this
+      # field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).
+  "region": "A String", # Output only. [Output Only] URL of the region where the commitment and committed
+      # resources are located.
+  "reservations": [ # The list of new reservations that you want to create and attach to this
+      # commitment.
+      # 
+      # You must attach reservations to your commitment if your commitment
+      # specifies any GPUs or Local SSD disks. For more information, see
+      # Attach reservations to resource-based commitments.
+      # 
+      # Specify this property only if you want to create new
+      # reservations to attach. To attach existing reservations, specify theexistingReservations property instead.
+    { # Represents a reservation resource.  A reservation ensures that capacity is
+        # held in a specific zone even if the reserved VMs are not running. For more
+        # information, read  Reserving zonal
+        # resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+          # deployment type reservations.
+          # type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
+      "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+          # count of CPUs) and can account for multiple instance SKUs. In other words,
+          # one can create instances of varying shapes against this reservation.
+        "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+            # belong to.
+        "workloadType": "A String", # The workload type of the instances that will target this reservation.
+      },
+      "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+          # displays for reservations that are tied to a commitment.
+      "confidentialComputeType": "A String",
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+          # automatically delete this resource.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+          #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+      "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+          # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+          # enrolled in early access maintenance and the standard notice applies.
+      "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+          # for example, to fix hardware errors.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+      "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+          # displays for reservations that are tied to multiple commitments.
+        "A String",
+      ],
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "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).
+      "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+          # will not be shared with Google Cloud managed services.
+        "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+      },
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+          # resource. It is populated for each instance of the Allocation
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+          # user, and the value is resource policy url. This is to define placement
+          # policy with reservation.
+        "a_key": "A String",
+      },
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+        "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+          "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+          "healthStatus": "A String", # The health status of the reservation.
+          "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+        },
+        "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+        "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+          "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+          "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+          "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have ongoing maintenance.
+          "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have pending maintenance.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+              # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+              # Domains). Not all VM Families will support this field.
+          "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+              #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+              #  Domains). Not all VM Families will support this field.
+          "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+            "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+            "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                # This timestamp value is in RFC3339 text format.
+            "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+            "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+              "A String",
+            ],
+            "maintenanceStatus": "A String",
+            "type": "A String", # Defines the type of maintenance.
+            "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                # This timestamp value is in RFC3339 text format.
+            "windowStartTime": "A String", # The current start time of the maintenance window.
+                # This timestamp value is in RFC3339 text format.
+          },
+        },
+        "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+          "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+          "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+              # service name.
+            "a_key": "A String",
+          },
+        },
+      },
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+          # optional. For more information about the syntax and options for this
+          # field and its subfields, see the guide for creating
+          # a shared reservation.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+          #  configuration.
+        "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+        "count": "A String", # Specifies the number of resources that are allocated.
+        "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+        "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+            # Next ID: 10
+          "guestAccelerators": [ # Specifies accelerator type and count.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+              # of disk is local-ssd.
+            {
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. The default isSCSI.
+                  # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+            },
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+              # and fixed amount of memory. This also includes specifying custom
+              # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+          "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+        },
+        "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+            # this field, you must exclude the instanceProperties field.
+            #
+            # This field is optional, and it can be a full or partial URL. For example,
+            # the following are all valid URLs to an instance template:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+            #       - projects/project/global/instanceTemplates/instanceTemplate
+            #       - global/instanceTemplates/instanceTemplate
+      },
+      "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+          # for "any" reservation. If the field is set, then only VMs that target
+          # the reservation by name can consume from this reservation.
+      "status": "A String", # Output only. [Output Only] The status of the reservation.
+          #
+          #
+          #      - CREATING: Reservation resources are being
+          #        allocated.
+          #      - READY: Reservation resources have been allocated,
+          #        and the reservation is ready for use.
+          #      - DELETING: Reservation deletion is in progress.
+          #      - UPDATING: Reservation update is in progress.
+      "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+          # reservation is created within a commitment.
+    },
+  ],
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Commitment resource.
+    "customTermEligibilityEndTimestamp": "A String", # Output only. [Output Only] Indicates the end time of customer's eligibility to send
+        # custom term requests in RFC3339 text format. Term extension requests that
+        # (not the end time in the request) after this time will be rejected.
+  },
+  "resources": [ # The list of all the hardware resources, with their types and amounts, that
+      # you want to commit to. Specify as a separate entry in the list for each
+      # individual resource type.
+    { # Commitment for a particular hardware resource (a commitment is composed of
+        # one or more of these).
+      "acceleratorType": "A String", # Name of the accelerator type or GPU resource. Specify this field only when
+          # the type of hardware resource is ACCELERATOR.
+      "amount": "A String", # The quantity of the hardware resource that you want to commit to purchasing
+          # (in a type-dependent unit).
+          #
+          #    - For vCPUs, you must specify an integer value.
+          #    - For memory, you specify the amount of MB that you want. The value you
+          #    specify must be a multiple of 256 MB, with up to 6.5 GB of
+          #    memory per every vCPU.
+          #    - For GPUs, you must specify an integer value.
+          #    - For Local SSD disks, you must specify the amount in GB. The size of a
+          #    single Local SSD disk is 375 GB.
+      "type": "A String", # The type of hardware resource that you want to specify.
+          # You can specify any of the following values:
+          #
+          #    - VCPU
+          #    - MEMORY
+          #    - LOCAL_SSD
+          #    - ACCELERATOR
+          #
+          #
+          #
+          # Specify as a separate entry in the list for each
+          # individual resource type.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "splitSourceCommitment": "A String", # The source commitment from which you are transferring resources to create
+      # the new split commitment. For more information, see
+      # Split commitments.
+  "startTimestamp": "A String", # Output only. [Output Only] Commitment start time inRFC3339
+      # text format.
+  "status": "A String", # Output only. [Output Only] Status of the commitment with regards to eventual expiration
+      # (each commitment has an end date defined). Status can be one of the
+      # following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "type": "A String", # The type of commitment; specifies the
+      # machine series for which you want to commit to purchasing resources.
+      # The choice of machine series affects the discount rate and the eligible
+      # resource types.
+      # 
+      #  The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,
+      #  COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For
+      # example, type MEMORY_OPTIMIZED specifies a commitment that
+      # applies only to eligible resources of memory optimized M1 and M2 machine
+      # series. Type GENERAL_PURPOSE specifies a commitment that
+      # applies only to eligible resources of general purpose N1 machine series.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of commitments contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 Commitment resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Commitment resources.
+    { # Represents a regional resource-based commitment resource.
+        #
+        # Creating this commitment resource means that you are purchasing a
+        # resource-based committed use contract, with an explicit start and end time.
+        # You can purchase resource-based commitments for both hardware and software
+        # resources. For more information, read
+        # Resource-based committed use discounts
+      "autoRenew": True or False, # Specifies whether to automatically renew the commitment at the end of its
+          # current term. The default value is false. If you set the field
+          # to true, each time your commitment reaches the end of its
+          # term, Compute Engine automatically renews it for another term. You can
+          # update this field anytime before the commitment expires. For example, if
+          # the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can
+          # update this field until 11:59 PM UTC-8 on January 2, 2027.
+      "category": "A String", # The category of the commitment; specifies whether the commitment is for
+          # hardware or software resources. Category MACHINE specifies
+          # that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.
+          # Category LICENSE specifies that you are committing to software
+          # licenses, listed in licenseResources.
+          # Note that if you specify MACHINE commitments, then you must
+          # also specify a type to indicate the machine series of the
+          # hardware resource that you are committing to.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customEndTimestamp": "A String", # [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired
+          # commitment's end date is later than the start date + term duration.
+      "description": "A String", # An optional description of the commitment. You can provide this property
+          # when you create the resource.
+      "endTimestamp": "A String", # Output only. [Output Only] Commitment end time inRFC3339
+          # text format.
+      "existingReservations": [
+        "A String",
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#commitment", # Output only. [Output Only] Type of the resource. Always compute#commitment
+          # for commitments.
+      "licenseResource": { # Commitment for a particular license resource. # The license specification required as part of a license commitment.
+        "amount": "A String", # The number of licenses you plan to purchase.
+        "coresPerLicense": "A String", # The number of cores per license.
+        "license": "A String", # The applicable license URI.
+      },
+      "mergeSourceCommitments": [ # The list of source commitments that you are merging to create the new
+          # merged commitment. For more information, see
+          # Merging commitments.
+        "A String",
+      ],
+      "name": "A String", # Name of the commitment. You must specify a name when you purchase the
+          # commitment. 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.
+      "params": { # Additional commitment 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 commitment. 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",
+        },
+      },
+      "plan": "A String", # The minimum time duration that you commit to purchasing resources.
+          # The plan that you choose determines the preset term length of the
+          # commitment (which is 1 year or 3 years) and affects the discount rate that
+          # you receive for your resources. Committing to a longer time duration
+          # typically gives you a higher discount rate. The supported values for this
+          # field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).
+      "region": "A String", # Output only. [Output Only] URL of the region where the commitment and committed
+          # resources are located.
+      "reservations": [ # The list of new reservations that you want to create and attach to this
+          # commitment.
+          #
+          # You must attach reservations to your commitment if your commitment
+          # specifies any GPUs or Local SSD disks. For more information, see
+          # Attach reservations to resource-based commitments.
+          #
+          # Specify this property only if you want to create new
+          # reservations to attach. To attach existing reservations, specify theexistingReservations property instead.
+        { # Represents a reservation resource.  A reservation ensures that capacity is
+            # held in a specific zone even if the reserved VMs are not running. For more
+            # information, read  Reserving zonal
+            # resources.
+          "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+              # deployment type reservations.
+              # type reservations.
+            "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+          },
+          "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+              # count of CPUs) and can account for multiple instance SKUs. In other words,
+              # one can create instances of varying shapes against this reservation.
+            "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+                # belong to.
+            "workloadType": "A String", # The workload type of the instances that will target this reservation.
+          },
+          "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+              # displays for reservations that are tied to a commitment.
+          "confidentialComputeType": "A String",
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+              # automatically delete this resource.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+              #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+          "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+              # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+              # enrolled in early access maintenance and the standard notice applies.
+          "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+              # for example, to fix hardware errors.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+          "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+              # displays for reservations that are tied to multiple commitments.
+            "A String",
+          ],
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "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).
+          "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+              # will not be shared with Google Cloud managed services.
+            "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+          },
+          "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+              # resource. It is populated for each instance of the Allocation
+              # resource, and includes the api_version the
+              # instance was retrieved through, and its canonical
+              # resource_type name.
+            "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+                # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+            "resourceType": "A String", # The canonical resource type name in the format of a resource type
+                # as defined by [AIP-123](https://google.aip.dev/123).
+                # For example, `"compute.googleapis.com/Instance"`.
+          },
+          "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+              # user, and the value is resource policy url. This is to define placement
+              # policy with reservation.
+            "a_key": "A String",
+          },
+          "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+            "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+              "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+              "healthStatus": "A String", # The health status of the reservation.
+              "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+            },
+            "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+            "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+              "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+              "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+              "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                  # Describes number of hosts in the block that have ongoing maintenance.
+              "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                  # Describes number of hosts in the block that have pending maintenance.
+              "schedulingType": "A String", # The type of maintenance for the reservation.
+              "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+                  # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                  # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+                  # Domains). Not all VM Families will support this field.
+              "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+                  #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                  #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+                  #  Domains). Not all VM Families will support this field.
+              "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+                "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+                "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                    # This timestamp value is in RFC3339 text format.
+                "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+                "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+                  "A String",
+                ],
+                "maintenanceStatus": "A String",
+                "type": "A String", # Defines the type of maintenance.
+                "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                    # This timestamp value is in RFC3339 text format.
+                "windowStartTime": "A String", # The current start time of the maintenance window.
+                    # This timestamp value is in RFC3339 text format.
+              },
+            },
+            "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+              "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+              "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+                  # service name.
+                "a_key": "A String",
+              },
+            },
+          },
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+          "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+              # optional. For more information about the syntax and options for this
+              # field and its subfields, see the guide for creating
+              # a shared reservation.
+            "projectMap": { # A map of project id and project config. This is only valid when
+                # share_type's value is SPECIFIC_PROJECTS.
+              "a_key": { # Config for each project in the share settings.
+                "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                    # parent map.
+              },
+            },
+            "shareType": "A String", # Type of sharing for this shared-reservation
+          },
+          "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+              #  configuration.
+            "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+            "count": "A String", # Specifies the number of resources that are allocated.
+            "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+            "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+                # Next ID: 10
+              "guestAccelerators": [ # Specifies accelerator type and count.
+                { # A specification of the type and number of accelerator cards attached to the
+                    # instance.
+                  "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                  "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                      # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                      # If you are creating an instance template, specify only the
+                      # accelerator name.
+                      # See GPUs on Compute Engine
+                      # for a full list of accelerator types.
+                },
+              ],
+              "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                  # of disk is local-ssd.
+                {
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                      # either SCSI or NVME. The default isSCSI.
+                      # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                },
+              ],
+              "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                  # resources.
+                  # This field is for use by internal tools that use the public API.
+              "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                  # and fixed amount of memory. This also includes specifying custom
+                  # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+              "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+            },
+            "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+                # this field, you must exclude the instanceProperties field.
+                #
+                # This field is optional, and it can be a full or partial URL. For example,
+                # the following are all valid URLs to an instance template:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+                #       - projects/project/global/instanceTemplates/instanceTemplate
+                #       - global/instanceTemplates/instanceTemplate
+          },
+          "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+              # for "any" reservation. If the field is set, then only VMs that target
+              # the reservation by name can consume from this reservation.
+          "status": "A String", # Output only. [Output Only] The status of the reservation.
+              #
+              #
+              #      - CREATING: Reservation resources are being
+              #        allocated.
+              #      - READY: Reservation resources have been allocated,
+              #        and the reservation is ready for use.
+              #      - DELETING: Reservation deletion is in progress.
+              #      - UPDATING: Reservation update is in progress.
+          "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+              # reservation is created within a commitment.
+        },
+      ],
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Commitment resource.
+        "customTermEligibilityEndTimestamp": "A String", # Output only. [Output Only] Indicates the end time of customer's eligibility to send
+            # custom term requests in RFC3339 text format. Term extension requests that
+            # (not the end time in the request) after this time will be rejected.
+      },
+      "resources": [ # The list of all the hardware resources, with their types and amounts, that
+          # you want to commit to. Specify as a separate entry in the list for each
+          # individual resource type.
+        { # Commitment for a particular hardware resource (a commitment is composed of
+            # one or more of these).
+          "acceleratorType": "A String", # Name of the accelerator type or GPU resource. Specify this field only when
+              # the type of hardware resource is ACCELERATOR.
+          "amount": "A String", # The quantity of the hardware resource that you want to commit to purchasing
+              # (in a type-dependent unit).
+              #
+              #    - For vCPUs, you must specify an integer value.
+              #    - For memory, you specify the amount of MB that you want. The value you
+              #    specify must be a multiple of 256 MB, with up to 6.5 GB of
+              #    memory per every vCPU.
+              #    - For GPUs, you must specify an integer value.
+              #    - For Local SSD disks, you must specify the amount in GB. The size of a
+              #    single Local SSD disk is 375 GB.
+          "type": "A String", # The type of hardware resource that you want to specify.
+              # You can specify any of the following values:
+              #
+              #    - VCPU
+              #    - MEMORY
+              #    - LOCAL_SSD
+              #    - ACCELERATOR
+              #
+              #
+              #
+              # Specify as a separate entry in the list for each
+              # individual resource type.
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "splitSourceCommitment": "A String", # The source commitment from which you are transferring resources to create
+          # the new split commitment. For more information, see
+          # Split commitments.
+      "startTimestamp": "A String", # Output only. [Output Only] Commitment start time inRFC3339
+          # text format.
+      "status": "A String", # Output only. [Output Only] Status of the commitment with regards to eventual expiration
+          # (each commitment has an end date defined). Status can be one of the
+          # following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.
+      "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+      "type": "A String", # The type of commitment; specifies the
+          # machine series for which you want to commit to purchasing resources.
+          # The choice of machine series affects the discount rate and the eligible
+          # resource types.
+          #
+          #  The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,
+          #  COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For
+          # example, type MEMORY_OPTIMIZED specifies a commitment that
+          # applies only to eligible resources of memory optimized M1 and M2 machine
+          # series. Type GENERAL_PURPOSE specifies a commitment that
+          # applies only to eligible resources of general purpose N1 machine series.
+    },
+  ],
+  "kind": "compute#commitmentList", # Output only. [Output Only] Type of resource. Always compute#commitmentList
+      # for lists of commitments.
+  "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.
+  "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.
+
+
+ +
+ update(project, region, commitment, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the specified commitment 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 updated: auto_renew and plan.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  commitment: string, Name of the commitment that you want to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a regional resource-based commitment resource.
+    # 
+    # Creating this commitment resource means that you are purchasing a
+    # resource-based committed use contract, with an explicit start and end time.
+    # You can purchase resource-based commitments for both hardware and software
+    # resources. For more information, read
+    # Resource-based committed use discounts
+  "autoRenew": True or False, # Specifies whether to automatically renew the commitment at the end of its
+      # current term. The default value is false. If you set the field
+      # to true, each time your commitment reaches the end of its
+      # term, Compute Engine automatically renews it for another term. You can
+      # update this field anytime before the commitment expires. For example, if
+      # the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can
+      # update this field until 11:59 PM UTC-8 on January 2, 2027.
+  "category": "A String", # The category of the commitment; specifies whether the commitment is for
+      # hardware or software resources. Category MACHINE specifies
+      # that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.
+      # Category LICENSE specifies that you are committing to software
+      # licenses, listed in licenseResources.
+      # Note that if you specify MACHINE commitments, then you must
+      # also specify a type to indicate the machine series of the
+      # hardware resource that you are committing to.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customEndTimestamp": "A String", # [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired
+      # commitment's end date is later than the start date + term duration.
+  "description": "A String", # An optional description of the commitment. You can provide this property
+      # when you create the resource.
+  "endTimestamp": "A String", # Output only. [Output Only] Commitment end time inRFC3339
+      # text format.
+  "existingReservations": [
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#commitment", # Output only. [Output Only] Type of the resource. Always compute#commitment
+      # for commitments.
+  "licenseResource": { # Commitment for a particular license resource. # The license specification required as part of a license commitment.
+    "amount": "A String", # The number of licenses you plan to purchase.
+    "coresPerLicense": "A String", # The number of cores per license.
+    "license": "A String", # The applicable license URI.
+  },
+  "mergeSourceCommitments": [ # The list of source commitments that you are merging to create the new
+      # merged commitment. For more information, see
+      # Merging commitments.
+    "A String",
+  ],
+  "name": "A String", # Name of the commitment. You must specify a name when you purchase the
+      # commitment. 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.
+  "params": { # Additional commitment 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 commitment. 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",
+    },
+  },
+  "plan": "A String", # The minimum time duration that you commit to purchasing resources.
+      # The plan that you choose determines the preset term length of the
+      # commitment (which is 1 year or 3 years) and affects the discount rate that
+      # you receive for your resources. Committing to a longer time duration
+      # typically gives you a higher discount rate. The supported values for this
+      # field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).
+  "region": "A String", # Output only. [Output Only] URL of the region where the commitment and committed
+      # resources are located.
+  "reservations": [ # The list of new reservations that you want to create and attach to this
+      # commitment.
+      # 
+      # You must attach reservations to your commitment if your commitment
+      # specifies any GPUs or Local SSD disks. For more information, see
+      # Attach reservations to resource-based commitments.
+      # 
+      # Specify this property only if you want to create new
+      # reservations to attach. To attach existing reservations, specify theexistingReservations property instead.
+    { # Represents a reservation resource.  A reservation ensures that capacity is
+        # held in a specific zone even if the reserved VMs are not running. For more
+        # information, read  Reserving zonal
+        # resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+          # deployment type reservations.
+          # type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
+      "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+          # count of CPUs) and can account for multiple instance SKUs. In other words,
+          # one can create instances of varying shapes against this reservation.
+        "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+            # belong to.
+        "workloadType": "A String", # The workload type of the instances that will target this reservation.
+      },
+      "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+          # displays for reservations that are tied to a commitment.
+      "confidentialComputeType": "A String",
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+          # automatically delete this resource.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+          #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+      "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+          # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+          # enrolled in early access maintenance and the standard notice applies.
+      "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+          # for example, to fix hardware errors.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+      "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+          # displays for reservations that are tied to multiple commitments.
+        "A String",
+      ],
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "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).
+      "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+          # will not be shared with Google Cloud managed services.
+        "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+      },
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+          # resource. It is populated for each instance of the Allocation
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+          # user, and the value is resource policy url. This is to define placement
+          # policy with reservation.
+        "a_key": "A String",
+      },
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+        "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+          "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+          "healthStatus": "A String", # The health status of the reservation.
+          "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+        },
+        "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+        "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+          "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+          "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+          "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have ongoing maintenance.
+          "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have pending maintenance.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+              # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+              # Domains). Not all VM Families will support this field.
+          "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+              #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+              #  Domains). Not all VM Families will support this field.
+          "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+            "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+            "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                # This timestamp value is in RFC3339 text format.
+            "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+            "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+              "A String",
+            ],
+            "maintenanceStatus": "A String",
+            "type": "A String", # Defines the type of maintenance.
+            "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                # This timestamp value is in RFC3339 text format.
+            "windowStartTime": "A String", # The current start time of the maintenance window.
+                # This timestamp value is in RFC3339 text format.
+          },
+        },
+        "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+          "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+          "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+              # service name.
+            "a_key": "A String",
+          },
+        },
+      },
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+          # optional. For more information about the syntax and options for this
+          # field and its subfields, see the guide for creating
+          # a shared reservation.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+          #  configuration.
+        "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+        "count": "A String", # Specifies the number of resources that are allocated.
+        "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+        "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+            # Next ID: 10
+          "guestAccelerators": [ # Specifies accelerator type and count.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+              # of disk is local-ssd.
+            {
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. The default isSCSI.
+                  # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+            },
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+              # and fixed amount of memory. This also includes specifying custom
+              # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+          "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+        },
+        "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+            # this field, you must exclude the instanceProperties field.
+            #
+            # This field is optional, and it can be a full or partial URL. For example,
+            # the following are all valid URLs to an instance template:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+            #       - projects/project/global/instanceTemplates/instanceTemplate
+            #       - global/instanceTemplates/instanceTemplate
+      },
+      "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+          # for "any" reservation. If the field is set, then only VMs that target
+          # the reservation by name can consume from this reservation.
+      "status": "A String", # Output only. [Output Only] The status of the reservation.
+          #
+          #
+          #      - CREATING: Reservation resources are being
+          #        allocated.
+          #      - READY: Reservation resources have been allocated,
+          #        and the reservation is ready for use.
+          #      - DELETING: Reservation deletion is in progress.
+          #      - UPDATING: Reservation update is in progress.
+      "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+          # reservation is created within a commitment.
+    },
+  ],
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Commitment resource.
+    "customTermEligibilityEndTimestamp": "A String", # Output only. [Output Only] Indicates the end time of customer's eligibility to send
+        # custom term requests in RFC3339 text format. Term extension requests that
+        # (not the end time in the request) after this time will be rejected.
+  },
+  "resources": [ # The list of all the hardware resources, with their types and amounts, that
+      # you want to commit to. Specify as a separate entry in the list for each
+      # individual resource type.
+    { # Commitment for a particular hardware resource (a commitment is composed of
+        # one or more of these).
+      "acceleratorType": "A String", # Name of the accelerator type or GPU resource. Specify this field only when
+          # the type of hardware resource is ACCELERATOR.
+      "amount": "A String", # The quantity of the hardware resource that you want to commit to purchasing
+          # (in a type-dependent unit).
+          #
+          #    - For vCPUs, you must specify an integer value.
+          #    - For memory, you specify the amount of MB that you want. The value you
+          #    specify must be a multiple of 256 MB, with up to 6.5 GB of
+          #    memory per every vCPU.
+          #    - For GPUs, you must specify an integer value.
+          #    - For Local SSD disks, you must specify the amount in GB. The size of a
+          #    single Local SSD disk is 375 GB.
+      "type": "A String", # The type of hardware resource that you want to specify.
+          # You can specify any of the following values:
+          #
+          #    - VCPU
+          #    - MEMORY
+          #    - LOCAL_SSD
+          #    - ACCELERATOR
+          #
+          #
+          #
+          # Specify as a separate entry in the list for each
+          # individual resource type.
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "splitSourceCommitment": "A String", # The source commitment from which you are transferring resources to create
+      # the new split commitment. For more information, see
+      # Split commitments.
+  "startTimestamp": "A String", # Output only. [Output Only] Commitment start time inRFC3339
+      # text format.
+  "status": "A String", # Output only. [Output Only] Status of the commitment with regards to eventual expiration
+      # (each commitment has an end date defined). Status can be one of the
+      # following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.
+  "statusMessage": "A String", # Output only. [Output Only] An optional, human-readable explanation of the status.
+  "type": "A String", # The type of commitment; specifies the
+      # machine series for which you want to commit to purchasing resources.
+      # The choice of machine series affects the discount rate and the eligible
+      # resource types.
+      # 
+      #  The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,
+      #  COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For
+      # example, type MEMORY_OPTIMIZED specifies a commitment that
+      # applies only to eligible resources of memory optimized M1 and M2 machine
+      # series. Type GENERAL_PURPOSE specifies a commitment that
+      # applies only to eligible resources of general purpose N1 machine series.
+}
+
+  paths: string, A parameter (repeated)
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionCompositeHealthChecks.html b/docs/dyn/compute_preview.regionCompositeHealthChecks.html new file mode 100644 index 0000000000..373b924364 --- /dev/null +++ b/docs/dyn/compute_preview.regionCompositeHealthChecks.html @@ -0,0 +1,1667 @@ + + + +

Compute Engine API . regionCompositeHealthChecks

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all CompositeHealthCheck resources (all

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, compositeHealthCheck, requestId=None, x__xgafv=None)

+

Deletes the specified CompositeHealthCheck in the given region

+

+ get(project, region, compositeHealthCheck, x__xgafv=None)

+

Returns the specified CompositeHealthCheck resource in the given region.

+

+ getHealth(project, region, compositeHealthCheck, x__xgafv=None)

+

Gets the most recent health check results for this

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Create a CompositeHealthCheck in the specified project in the given region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the CompositeHealthChecks for a project in the given region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, compositeHealthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional CompositeHealthCheck resource

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all CompositeHealthCheck resources (all
+regional) 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.
+  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 CompositeHealthChecksScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of CompositeHealthChecksScopedList resources.
+    "a_key": { # Name of the scope containing this set of CompositeHealthChecks.
+      "compositeHealthChecks": [ # A list of CompositeHealthChecks contained in this scope.
+        { # Represents a composite health check.
+            #
+            # A composite health check resource specifies the health source resources and
+            # the health destination resource to which the aggregated health result from
+            # the health source resources is delivered.
+          "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 CompositeHealthCheck. An up-to-date fingerprint
+              # must be provided in order to patch the CompositeHealthCheck; Otherwise,
+              # the request will fail with error 412 conditionNotMet. To see
+              # the latest fingerprint, make a get() request to retrieve the
+              # CompositeHealthCheck.
+          "healthDestination": "A String", # URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have
+              # load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region
+              # as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.
+          "healthSources": [ # URLs to the HealthSource resources whose results are AND'ed.
+              # I.e. he aggregated result is is HEALTHY only if all sources
+              # are HEALTHY. Must have at least 1. Must not have more than 10.
+              # Must be regional and in the same region as theCompositeHealthCheck. Can be mutated.
+            "A String",
+          ],
+          "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+              # generates this identifier.
+          "kind": "compute#compositeHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+          "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.
+          "region": "A String", # Output only. [Output Only] URL of the region where the composite health check 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 composite health checks
+          # 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#compositeHealthCheckAggregatedList", # 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, compositeHealthCheck, requestId=None, x__xgafv=None) + 
Deletes the specified CompositeHealthCheck in the given region
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  compositeHealthCheck: string, Name of the CompositeHealthCheck 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, compositeHealthCheck, x__xgafv=None) + 
Returns the specified CompositeHealthCheck resource in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  compositeHealthCheck: string, Name of the CompositeHealthCheck 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 composite health check.
+    #
+    # A composite health check resource specifies the health source resources and
+    # the health destination resource to which the aggregated health result from
+    # the health source resources is delivered.
+  "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 CompositeHealthCheck. An up-to-date fingerprint
+      # must be provided in order to patch the CompositeHealthCheck; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # CompositeHealthCheck.
+  "healthDestination": "A String", # URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have
+      # load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region
+      # as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.
+  "healthSources": [ # URLs to the HealthSource resources whose results are AND'ed.
+      # I.e. he aggregated result is is HEALTHY only if all sources
+      # are HEALTHY. Must have at least 1. Must not have more than 10.
+      # Must be regional and in the same region as theCompositeHealthCheck. Can be mutated.
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#compositeHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the composite health check 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.
+}
+
+ +
+ getHealth(project, region, compositeHealthCheck, x__xgafv=None) + 
Gets the most recent health check results for this
+regional CompositeHealthCheck.
+
+Args:
+  project: string, Name of the project scoping this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  compositeHealthCheck: string, Name of the CompositeHealthCheck resource to get health for. (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 RegionCompositeHealthChecks.GetHealth
+  "healthSources": [ # Health sources and their corresponding health states.
+    {
+      "healthState": "A String", # Health state of the associated HealthSource resource.
+      "source": "A String", # Fully qualified URL of the associated HealthSource resource.
+    },
+  ],
+  "healthState": "A String", # Health state of the CompositeHealthCheck.
+  "kind": "compute#compositeHealthCheckHealth", # Output only. [Output Only] Type of resource. Alwayscompute#compositeHealthCheckHealth for the health of
+      # composite health checks.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Create a CompositeHealthCheck 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 composite health check.
+    # 
+    # A composite health check resource specifies the health source resources and
+    # the health destination resource to which the aggregated health result from
+    # the health source resources is delivered.
+  "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 CompositeHealthCheck. An up-to-date fingerprint
+      # must be provided in order to patch the CompositeHealthCheck; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # CompositeHealthCheck.
+  "healthDestination": "A String", # URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have
+      # load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region
+      # as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.
+  "healthSources": [ # URLs to the HealthSource resources whose results are AND'ed.
+      # I.e. he aggregated result is is HEALTHY only if all sources
+      # are HEALTHY. Must have at least 1. Must not have more than 10.
+      # Must be regional and in the same region as theCompositeHealthCheck. Can be mutated.
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#compositeHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the composite health check 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the CompositeHealthChecks 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.
+  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 CompositeHealthCheck resources.
+    { # Represents a composite health check.
+        #
+        # A composite health check resource specifies the health source resources and
+        # the health destination resource to which the aggregated health result from
+        # the health source resources is delivered.
+      "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 CompositeHealthCheck. An up-to-date fingerprint
+          # must be provided in order to patch the CompositeHealthCheck; Otherwise,
+          # the request will fail with error 412 conditionNotMet. To see
+          # the latest fingerprint, make a get() request to retrieve the
+          # CompositeHealthCheck.
+      "healthDestination": "A String", # URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have
+          # load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region
+          # as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.
+      "healthSources": [ # URLs to the HealthSource resources whose results are AND'ed.
+          # I.e. he aggregated result is is HEALTHY only if all sources
+          # are HEALTHY. Must have at least 1. Must not have more than 10.
+          # Must be regional and in the same region as theCompositeHealthCheck. Can be mutated.
+        "A String",
+      ],
+      "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+          # generates this identifier.
+      "kind": "compute#compositeHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+      "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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the composite health check 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#compositeHealthCheckList", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+  "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, compositeHealthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates the specified regional CompositeHealthCheck 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)
+  compositeHealthCheck: string, Name of the CompositeHealthCheck 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 composite health check.
+    # 
+    # A composite health check resource specifies the health source resources and
+    # the health destination resource to which the aggregated health result from
+    # the health source resources is delivered.
+  "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 CompositeHealthCheck. An up-to-date fingerprint
+      # must be provided in order to patch the CompositeHealthCheck; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # CompositeHealthCheck.
+  "healthDestination": "A String", # URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have
+      # load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region
+      # as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.
+  "healthSources": [ # URLs to the HealthSource resources whose results are AND'ed.
+      # I.e. he aggregated result is is HEALTHY only if all sources
+      # are HEALTHY. Must have at least 1. Must not have more than 10.
+      # Must be regional and in the same region as theCompositeHealthCheck. Can be mutated.
+    "A String",
+  ],
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#compositeHealthCheck", # Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the composite health check 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionDiskTypes.html b/docs/dyn/compute_preview.regionDiskTypes.html new file mode 100644 index 0000000000..b2571fcaab --- /dev/null +++ b/docs/dyn/compute_preview.regionDiskTypes.html @@ -0,0 +1,372 @@ + + + +

Compute Engine API . regionDiskTypes

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, diskType, x__xgafv=None)

+

Returns the specified regional disk type.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of regional disk types available to the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, diskType, x__xgafv=None) + 
Returns the specified regional disk type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  diskType: string, Name of the disk type 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 Disk Type resource.
+    #
+    # Google Compute Engine has two Disk Type resources:
+    #
+    # * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)
+    # * [Zonal](/compute/docs/reference/rest/v1/diskTypes)
+    #
+    # You can choose from a variety of disk types based on your needs.
+    # For more information, readStorage options.
+    #
+    # The diskTypes resource represents disk types for a zonal
+    # persistent disk.
+    # For more information, readZonal persistent disks.
+    #
+    # The regionDiskTypes resource represents disk types for a
+    # regional persistent disk. For more information, read Regional persistent disks.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional description of this resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#diskType", # Output only. [Output Only] Type of the resource. Always compute#diskType
+      # for disk types.
+  "name": "A String", # [Output Only] Name of the resource.
+  "region": "A String", # [Output Only] URL of the region where the disk type resides. Only
+      # applicable for regional resources.
+      # 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.
+  "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size,
+      # such as "10GB-10TB".
+  "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of regional disk types available to the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region 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.
+  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 DiskType resources.
+    { # Represents a Disk Type resource.
+        #
+        # Google Compute Engine has two Disk Type resources:
+        #
+        # * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)
+        # * [Zonal](/compute/docs/reference/rest/v1/diskTypes)
+        #
+        # You can choose from a variety of disk types based on your needs.
+        # For more information, readStorage options.
+        #
+        # The diskTypes resource represents disk types for a zonal
+        # persistent disk.
+        # For more information, readZonal persistent disks.
+        #
+        # The regionDiskTypes resource represents disk types for a
+        # regional persistent disk. For more information, read Regional persistent disks.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional description of this resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#diskType", # Output only. [Output Only] Type of the resource. Always compute#diskType
+          # for disk types.
+      "name": "A String", # [Output Only] Name of the resource.
+      "region": "A String", # [Output Only] URL of the region where the disk type resides. Only
+          # applicable for regional resources.
+          # 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.
+      "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size,
+          # such as "10GB-10TB".
+      "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#regionDiskTypeList", # Output only. [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionDisks.html b/docs/dyn/compute_preview.regionDisks.html new file mode 100644 index 0000000000..6aec7a9150 --- /dev/null +++ b/docs/dyn/compute_preview.regionDisks.html @@ -0,0 +1,8122 @@ + + + +

Compute Engine API . regionDisks

+

Instance Methods

+

+ addResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Adds existing resource policies to a regional disk. You can only add one

+

+ bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)

+

Bulk create a set of disks.

+

+ close()

+

Close httplib2 connections.

+

+ createSnapshot(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Creates a snapshot of a specified persistent disk. For regular snapshot

+

+ delete(project, region, disk, requestId=None, x__xgafv=None)

+

Deletes the specified regional persistent disk. Deleting a regional disk

+

+ get(project, region, disk, x__xgafv=None)

+

Returns a specified regional persistent disk.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, sourceImage=None, x__xgafv=None)

+

Creates a persistent regional disk in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of persistent disks contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Removes resource policies from a regional disk.

+

+ resize(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Resizes the specified regional persistent disk.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on the target regional disk.

+

+ startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Starts asynchronous replication.

+

+ stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None)

+

Stops asynchronous replication.

+

+ stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None)

+

Stops asynchronous replication for a consistency group of disks.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ 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

+

+ updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None)

+

Rotates the customer-managed

+

Method Details

+
+ addResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Adds existing resource policies to a regional disk. You can only add one
+policy which will be applied to this disk for scheduling snapshot
+creation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Resource policies to be added to this disk.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ bulkInsert(project, region, body=None, requestId=None, x__xgafv=None) + 
Bulk create a set of disks.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.disks.bulkInsert and
+    # compute.regionDisks.bulkInsert. It is only used to process
+    # requests and is not persisted.
+  "instantSnapshotGroupParameters": { # The parameters for the instant snapshot group.
+    "sourceInstantSnapshotGroup": "A String", # The source instant 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/zones/zone/instantSnapshotGroups/instantSnapshotGroup
+        #      - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
+        #      - zones/zone/instantSnapshotGroups/instantSnapshotGroup
+  },
+  "snapshotGroupParameters": { # The parameters for the snapshot group. The usage of snapshot group feature
+      # is restricted.
+    "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:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        regions/region/resourcePolicies/resourcePolicy
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ createSnapshot(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Creates a snapshot of a specified persistent disk. For regular snapshot
+creation, consider using snapshots.insert
+instead, as that method supports more features, such as creating snapshots
+in a project different from the source disk project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  disk: string, Name of the regional persistent disk to snapshot. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk Snapshot resource.
+    # 
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      # 
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(project, region, disk, requestId=None, x__xgafv=None) + 
Deletes the specified regional persistent disk. Deleting a regional disk
+removes all the replicas of its data permanently and is irreversible.
+However, deleting a disk does not delete anysnapshots
+previously made from the disk. You must separatelydelete
+snapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  disk: string, Name of the regional persistent disk 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, disk, x__xgafv=None) + 
Returns a specified regional persistent disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  disk: string, Name of the regional persistent disk 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 Persistent Disk resource.
+    #
+    # Google Compute Engine has two Disk resources:
+    #
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    #
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    #
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    #
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      #
+      #
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      #
+      #
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      #
+      # Encryption keys do not protect access to metadata of the disk.
+      #
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      #
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      #
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      #
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      #
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        zones/zone/disks/disk
+      #
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      #
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      #
+      # projects/debian-cloud/global/images/family/debian-9
+      #
+      #
+      # Alternatively, use a specific version of a public operating system image:
+      #
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      #
+      #
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      #
+      # global/images/my-custom-image
+      #
+      #
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      #
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      #
+      #
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, sourceImage=None, x__xgafv=None) + 
Creates a persistent regional disk in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk resource.
+    # 
+    # Google Compute Engine has two Disk resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    # 
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    # 
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    # 
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      # 
+      # 
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      # 
+      # 
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      # 
+      # Encryption keys do not protect access to metadata of the disk.
+      # 
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      # 
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      # 
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      # 
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      # 
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      # 
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      # 
+      # projects/debian-cloud/global/images/family/debian-9
+      # 
+      # 
+      # Alternatively, use a specific version of a public operating system image:
+      # 
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      # 
+      # 
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      # 
+      # global/images/my-custom-image
+      # 
+      # 
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      # 
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      # 
+      # 
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  sourceImage: string, Source image to restore onto a disk. This field is optional.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of persistent disks contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of Disk resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Disk resources.
+    { # Represents a Persistent Disk resource.
+        #
+        # Google Compute Engine has two Disk resources:
+        #
+        # * [Zonal](/compute/docs/reference/rest/v1/disks)
+        # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+        #
+        # Persistent disks are required for running your VM instances.
+        # Create both boot and non-boot (data) persistent disks. For more information,
+        # read Persistent Disks. For more
+        # storage options, read Storage options.
+        #
+        # The disks resource represents a zonal persistent disk.
+        # For more information, readZonal persistent disks.
+        #
+        # The regionDisks resource represents a
+        # regional persistent disk.  For more information, read
+        # Regional resources.
+      "accessMode": "A String", # The access mode of the disk.
+          #
+          #
+          #      - READ_WRITE_SINGLE: The default AccessMode, means the
+          #      disk can be attached to single instance in RW mode.
+          #      - READ_WRITE_MANY: The AccessMode means the disk can be
+          #      attached to multiple instances in RW mode.
+          #      - READ_ONLY_MANY: The AccessMode means the disk can be
+          #      attached to multiple instances in RO mode.
+          #
+          #
+          # The AccessMode is only valid for Hyperdisk disk types.
+      "architecture": "A String", # The architecture of the disk. Valid values are
+          # ARM64 or X86_64.
+      "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+      "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+        "a_key": {
+          "asyncReplicationDisk": {
+            "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+                # started on the disk as a member of a group.
+            "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+                # 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/zones/zone/disks/disk
+                #    - projects/project/zones/zone/disks/disk
+                #    - zones/zone/disks/disk
+            "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+                # to or from the current disk. This value identifies the exact disk that
+                # was used to create this replication. For example, if you started
+                # replicating the persistent disk from a disk that was later deleted and
+                # recreated under the same name, the disk ID would identify the exact
+                # version of the disk that was used.
+          },
+        },
+      },
+      "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.
+      "diskEncryptionKey": { # Encrypts the disk using a
+          # customer-supplied encryption key or a
+          # customer-managed encryption key.
+          #
+          # Encryption keys do not protect access to metadata of the disk.
+          #
+          # After you encrypt a disk with a customer-supplied key, you must provide the
+          # same key if you use the disk later. For example, to create a disk snapshot,
+          # to create a disk image, to create a machine image, or to attach the disk to
+          # a virtual machine.
+          #
+          # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+          # name once the disk is created. The disk is encrypted with this version of
+          # the key. In the response, diskEncryptionKey.kmsKeyName appears
+          # in the following format:
+          #
+          # "diskEncryptionKey.kmsKeyName":
+          # "projects/kms_project_id/locations/region/keyRings/
+          # key_region/cryptoKeys/key
+          # /cryptoKeysVersions/version
+          #
+          # If you do not provide an encryption key when creating the disk, then the
+          # disk is encrypted using an automatically generated key and you don't need
+          # to provide a key to use the disk later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+      "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+          # only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+          # disks.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a disk.
+      "labels": { # Labels to apply to this disk. These can be later modified by
+          # the setLabels method.
+        "a_key": "A String",
+      },
+      "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+          # text format.
+      "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+          # text format.
+      "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+        "A String",
+      ],
+      "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+        "A String",
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+          # This field is for use by internal tools that use the public API.
+      "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.
+      "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": { # 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/{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",
+        },
+      },
+      "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+          # If not present in a request, a default value is used.
+          # The currently supported size is 4096, other sizes may be added in
+          # the future.
+          # If an unsupported value is requested, the error message will list
+          # the supported values for the caller's project.
+      "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+          # of I/O operations per second that the disk can handle. Values must be
+          # between 10,000 and 120,000. For more details, see theExtreme persistent
+          # disk documentation.
+      "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+          # number of throughput mb per second that the disk can handle. Values must be
+          # greater than or equal to 1.
+      "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+          # regional resources.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+          # for regional resources.
+        "A String",
+      ],
+      "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+        "A String",
+      ],
+      "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+        "asyncPrimaryDisk": {
+          "state": "A String",
+        },
+        "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+          "a_key": {
+            "state": "A String",
+          },
+        },
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+          # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+          # persistent disk.
+          #
+          # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+          # source.
+          # Acceptable values are greater than 0.
+      "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+          # that was created using a consistency group.
+      "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+          # that was created using a consistency group.
+      "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        zones/zone/disks/disk
+          #
+          #      -
+          #        regions/region/disks/disk
+      "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+          # value identifies the exact disk that was used to create this persistent
+          # disk. For example, if you created the persistent disk from a disk that
+          # was later deleted and recreated under the same name, the source disk ID
+          # would identify the exact version of the disk that was used.
+      "sourceImage": "A String", # The source image used to create this disk. If the source image is
+          # deleted, this field will not be set.
+          #
+          # To create a disk with one of the public operating system images, specify
+          # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+          #
+          # projects/debian-cloud/global/images/family/debian-9
+          #
+          #
+          # Alternatively, use a specific version of a public operating system image:
+          #
+          # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+          #
+          #
+          # To create a disk with a custom image that you created, specify the
+          # image name in the following format:
+          #
+          # global/images/my-custom-image
+          #
+          #
+          # You can also specify a custom image by its image family, which returns
+          # the latest version of the image in that family. Replace the image name
+          # with family/family-name:
+          #
+          # global/images/family/my-image-family
+      "sourceImageEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source image. Required if the source image is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+          # value identifies the exact image that was used to create this persistent
+          # disk. For example, if you created the persistent disk from an image that
+          # was later deleted and recreated under the same name, the source image ID
+          # would identify the exact version of the image that was used.
+      "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+          #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+          #    - zones/zone/instantSnapshots/instantSnapshot
+      "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+          # disk. This value identifies the exact instant snapshot that was used to
+          # create this persistent disk. For example, if you created the persistent
+          # disk from an instant snapshot that was later deleted and recreated under
+          # the same name, the source instant snapshot ID would identify the exact
+          # version of the instant snapshot that was used.
+      "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+          #    - projects/project/global/snapshots/snapshot
+          #      - global/snapshots/snapshot
+      "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+          # encryption key of the source snapshot. Required if the source snapshot
+          # is protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+          # value identifies the exact snapshot that was used to create this persistent
+          # disk. For example, if you created the persistent disk from a snapshot that
+          # was later deleted and recreated under the same name, the source snapshot ID
+          # would identify the exact version of the snapshot that was used.
+      "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+          # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+          # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+          # https://storage.googleapis.com/. This flag is not optimized for creating
+          # multiple disks from a source storage object. To create many disks from a
+          # source storage object, use gcloud compute images
+          # import instead.
+      "status": "A String", # Output only. [Output Only] The status of disk creation.
+          #
+          #
+          #      - CREATING: Disk is provisioning.
+          #      - RESTORING: Source data is being copied into the
+          #      disk.
+          #      - FAILED: Disk creation failed.
+          #      - READY: Disk is ready for use.
+          #      - DELETING: Disk is deleting.
+      "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+          #      - projects/project/zones/zone/storagePools/storagePool
+          #    - zones/zone/storagePools/storagePool
+      "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.
+      "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+          # in form:projects/project/zones/zone/instances/instance
+        "A String",
+      ],
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#diskList", # Output only. [Output Only] Type of resource. Always compute#diskList for
+      # lists of disks.
+  "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.
+  "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.
+
+
+ +
+ removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Removes resource policies from a regional disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resourcePolicies": [ # Resource policies to be removed from this disk.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resize(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Resizes the specified regional persistent disk.
+
+Args:
+  project: string, The project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  disk: string, Name of the regional persistent disk. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sizeGb": "A String", # The new size of the regional persistent disk, which is specified in GB.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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).
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on the target regional disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Starts asynchronous replication.
+Must be invoked on the primary disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, The name of the persistent disk. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "asyncSecondaryDisk": "A String", # The secondary disk to start asynchronous replication to.
+      # 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None) + 
Stops asynchronous replication.
+Can be invoked either on the primary or on the secondary disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, The name of the persistent disk. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None) + 
Stops asynchronous replication for a consistency group of disks.
+Can be invoked either in the primary or secondary scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. This must be the region of the
+primary or secondary disks in the consistency group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.disks.stopGroupAsyncReplication and
+    # compute.regionDisks.stopGroupAsyncReplication. It is only used to process
+    # requests and is not persisted.
+  "resourcePolicy": "A String", # The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.
+      # This may be a full or partial URL, such as:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        projects/project/regions/region/resourcePolicies/resourcePolicy
+      # 
+      #      -
+      #        regions/region/resourcePolicies/resourcePolicy
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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",
+  ],
+}
+
+ +
+ 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.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, The disk name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk resource.
+    # 
+    # Google Compute Engine has two Disk resources:
+    # 
+    # * [Zonal](/compute/docs/reference/rest/v1/disks)
+    # * [Regional](/compute/docs/reference/rest/v1/regionDisks)
+    # 
+    # Persistent disks are required for running your VM instances.
+    # Create both boot and non-boot (data) persistent disks. For more information,
+    # read Persistent Disks. For more
+    # storage options, read Storage options.
+    # 
+    # The disks resource represents a zonal persistent disk.
+    # For more information, readZonal persistent disks.
+    # 
+    # The regionDisks resource represents a
+    # regional persistent disk.  For more information, read
+    # Regional resources.
+  "accessMode": "A String", # The access mode of the disk.
+      # 
+      # 
+      #      - READ_WRITE_SINGLE: The default AccessMode, means the
+      #      disk can be attached to single instance in RW mode.
+      #      - READ_WRITE_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RW mode.
+      #      - READ_ONLY_MANY: The AccessMode means the disk can be
+      #      attached to multiple instances in RO mode.
+      # 
+      # 
+      # The AccessMode is only valid for Hyperdisk disk types.
+  "architecture": "A String", # The architecture of the disk. Valid values are
+      # ARM64 or X86_64.
+  "asyncPrimaryDisk": { # Disk asynchronously replicated into this disk.
+    "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+        # started on the disk as a member of a group.
+    "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+        # 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/zones/zone/disks/disk
+        #    - projects/project/zones/zone/disks/disk
+        #    - zones/zone/disks/disk
+    "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+        # to or from the current disk. This value identifies the exact disk that
+        # was used to create this replication. For example, if you started
+        # replicating the persistent disk from a disk that was later deleted and
+        # recreated under the same name, the disk ID would identify the exact
+        # version of the disk that was used.
+  },
+  "asyncSecondaryDisks": { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
+    "a_key": {
+      "asyncReplicationDisk": {
+        "consistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "consistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
+            # started on the disk as a member of a group.
+        "disk": "A String", # The other disk asynchronously replicated to or from the current disk.
+            # 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/zones/zone/disks/disk
+            #    - projects/project/zones/zone/disks/disk
+            #    - zones/zone/disks/disk
+        "diskId": "A String", # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
+            # to or from the current disk. This value identifies the exact disk that
+            # was used to create this replication. For example, if you started
+            # replicating the persistent disk from a disk that was later deleted and
+            # recreated under the same name, the disk ID would identify the exact
+            # version of the disk that was used.
+      },
+    },
+  },
+  "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.
+  "diskEncryptionKey": { # Encrypts the disk using a
+      # customer-supplied encryption key or a
+      # customer-managed encryption key.
+      # 
+      # Encryption keys do not protect access to metadata of the disk.
+      # 
+      # After you encrypt a disk with a customer-supplied key, you must provide the
+      # same key if you use the disk later. For example, to create a disk snapshot,
+      # to create a disk image, to create a machine image, or to attach the disk to
+      # a virtual machine.
+      # 
+      # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
+      # name once the disk is created. The disk is encrypted with this version of
+      # the key. In the response, diskEncryptionKey.kmsKeyName appears
+      # in the following format:
+      # 
+      # "diskEncryptionKey.kmsKeyName":
+      # "projects/kms_project_id/locations/region/keyRings/
+      # key_region/cryptoKeys/key
+      # /cryptoKeysVersions/version
+      # 
+      # If you do not provide an encryption key when creating the disk, then the
+      # disk is encrypted using an automatically generated key and you don't need
+      # to provide a key to use the disk later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+  "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+      # only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#disk", # Output only. [Output Only] Type of the resource. Always compute#disk for
+      # disks.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this disk, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a disk.
+  "labels": { # Labels to apply to this disk. These can be later modified by
+      # the setLabels method.
+    "a_key": "A String",
+  },
+  "lastAttachTimestamp": "A String", # Output only. [Output Only] Last attach timestamp inRFC3339
+      # text format.
+  "lastDetachTimestamp": "A String", # Output only. [Output Only] Last detach timestamp inRFC3339
+      # text format.
+  "licenseCodes": [ # Integer license codes indicating which licenses are attached to this disk.
+    "A String",
+  ],
+  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the disk close to other resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "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": { # 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/{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",
+    },
+  },
+  "physicalBlockSizeBytes": "A String", # Physical block size of the persistent disk, in bytes.
+      # If not present in a request, a default value is used.
+      # The currently supported size is 4096, other sizes may be added in
+      # the future.
+      # If an unsupported value is requested, the error message will list
+      # the supported values for the caller's project.
+  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+      # of I/O operations per second that the disk can handle. Values must be
+      # between 10,000 and 120,000. For more details, see theExtreme persistent
+      # disk documentation.
+  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+      # number of throughput mb per second that the disk can handle. Values must be
+      # greater than or equal to 1.
+  "region": "A String", # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
+      # regional resources.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "replicaZones": [ # URLs of the zones where the disk should be replicated to. Only applicable
+      # for regional resources.
+    "A String",
+  ],
+  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+    "A String",
+  ],
+  "resourceStatus": { # Output only. [Output Only] Status information for the disk resource.
+    "asyncPrimaryDisk": {
+      "state": "A String",
+    },
+    "asyncSecondaryDisks": { # Key: disk, value: AsyncReplicationStatus message
+      "a_key": {
+        "state": "A String",
+      },
+    },
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "sizeGb": "A String", # Size, in GB, of the persistent disk. You can specify
+      # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
+      # persistent disk.
+      # 
+      # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
+      # source.
+      # Acceptable values are greater than 0.
+  "sourceConsistencyGroupPolicy": "A String", # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceConsistencyGroupPolicyId": "A String", # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
+      # that was created using a consistency group.
+  "sourceDisk": "A String", # The source disk used to create this disk. 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/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The unique ID of the disk used to create this disk. This
+      # value identifies the exact disk that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a disk that
+      # was later deleted and recreated under the same name, the source disk ID
+      # would identify the exact version of the disk that was used.
+  "sourceImage": "A String", # The source image used to create this disk. If the source image is
+      # deleted, this field will not be set.
+      # 
+      # To create a disk with one of the public operating system images, specify
+      # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+      # 
+      # projects/debian-cloud/global/images/family/debian-9
+      # 
+      # 
+      # Alternatively, use a specific version of a public operating system image:
+      # 
+      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+      # 
+      # 
+      # To create a disk with a custom image that you created, specify the
+      # image name in the following format:
+      # 
+      # global/images/my-custom-image
+      # 
+      # 
+      # You can also specify a custom image by its image family, which returns
+      # the latest version of the image in that family. Replace the image name
+      # with family/family-name:
+      # 
+      # global/images/family/my-image-family
+  "sourceImageEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source image. Required if the source image is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceImageId": "A String", # Output only. [Output Only] The ID value of the image used to create this disk. This
+      # value identifies the exact image that was used to create this persistent
+      # disk. For example, if you created the persistent disk from an image that
+      # was later deleted and recreated under the same name, the source image ID
+      # would identify the exact version of the image that was used.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this disk. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # disk. This value identifies the exact instant snapshot that was used to
+      # create this persistent disk. For example, if you created the persistent
+      # disk from an instant snapshot that was later deleted and recreated under
+      # the same name, the source instant snapshot ID would identify the exact
+      # version of the instant snapshot that was used.
+  "sourceSnapshot": "A String", # The source snapshot used to create this disk. 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/snapshots/snapshot
+      #    - projects/project/global/snapshots/snapshot
+      #      - global/snapshots/snapshot
+  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+      # encryption key of the source snapshot. Required if the source snapshot
+      # is protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceSnapshotId": "A String", # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
+      # value identifies the exact snapshot that was used to create this persistent
+      # disk. For example, if you created the persistent disk from a snapshot that
+      # was later deleted and recreated under the same name, the source snapshot ID
+      # would identify the exact version of the snapshot that was used.
+  "sourceStorageObject": "A String", # The full Google Cloud Storage URI where the disk image is stored. This file
+      # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+      # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
+      # https://storage.googleapis.com/. This flag is not optimized for creating
+      # multiple disks from a source storage object. To create many disks from a
+      # source storage object, use gcloud compute images
+      # import instead.
+  "status": "A String", # Output only. [Output Only] The status of disk creation.
+      # 
+      # 
+      #      - CREATING: Disk is provisioning.
+      #      - RESTORING: Source data is being copied into the
+      #      disk.
+      #      - FAILED: Disk creation failed.
+      #      - READY: Disk is ready for use.
+      #      - DELETING: Disk is deleting.
+  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+      #      - projects/project/zones/zone/storagePools/storagePool
+      #    - zones/zone/storagePools/storagePool
+  "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.
+  "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances)
+      # in form:projects/project/zones/zone/instances/instance
+    "A String",
+  ],
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the disk resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  paths: string, A parameter (repeated)
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None) + 
Rotates the customer-managed
+encryption key to the latest version for the specified persistent disk.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  disk: string, Name of the Disk resource, should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "kmsKeyName": "A String", # Optional. The new KMS key to replace the current one on the disk. If empty, the disk
+      # will be re-encrypted using the primary version of the disk's current KMS
+      # key.
+      # 
+      # The KMS key can be provided in the following formats:
+      # 
+      # 
+      #      - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key
+      # 
+      # 
+      # Where project is the project ID or
+      # project number.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionHealthAggregationPolicies.html b/docs/dyn/compute_preview.regionHealthAggregationPolicies.html new file mode 100644 index 0000000000..85681c97bf --- /dev/null +++ b/docs/dyn/compute_preview.regionHealthAggregationPolicies.html @@ -0,0 +1,1715 @@ + + + +

Compute Engine API . regionHealthAggregationPolicies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=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, 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, 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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionHealthCheckServices.html b/docs/dyn/compute_preview.regionHealthCheckServices.html new file mode 100644 index 0000000000..eaac581051 --- /dev/null +++ b/docs/dyn/compute_preview.regionHealthCheckServices.html @@ -0,0 +1,1728 @@ + + + +

Compute Engine API . regionHealthCheckServices

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all HealthCheckService resources,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, healthCheckService, requestId=None, x__xgafv=None)

+

Deletes the specified regional HealthCheckService.

+

+ get(project, region, healthCheckService, x__xgafv=None)

+

Returns the specified regional HealthCheckService resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a regional HealthCheckService resource in the

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all the HealthCheckService resources that have been

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, healthCheckService, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional HealthCheckService resource

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all HealthCheckService 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.
+  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 HealthCheckServicesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HealthCheckServicesScopedList resources.
+    "a_key": { # Name of the scope containing this set of HealthCheckServices.
+      "resources": [ # A list of HealthCheckServices contained in this scope.
+        { # Represents a Health-Check as a Service resource.
+          "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 HealthCheckService. An up-to-date fingerprint must
+              # be provided in order to patch/update the HealthCheckService; Otherwise, the
+              # request will fail with error 412 conditionNotMet. To see the
+              # latest fingerprint, make a get() request to retrieve the
+              # HealthCheckService.
+          "healthChecks": [ # A list of URLs to the HealthCheck resources. Must have
+              # at 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
+              # regional HealthCheckService, theHealthCheck must be regional and in the same
+              # region. 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
+              # global HealthChecks must specify sourceRegions,
+              # and HealthChecks that specify sourceRegions can
+              # only be used with global INTERNET_IP_PORTNetworkEndpointGroups.
+            "A String",
+          ],
+          "healthStatusAggregationPolicy": "A String", # Optional. Policy for how the results from multiple health checks
+              # for the same endpoint are aggregated. Defaults to NO_AGGREGATION
+              # if unspecified.
+              #
+              #    - NO_AGGREGATION. An EndpointHealth message is
+              #    returned for each  pair in the health check
+              #    service.
+              #    - 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.
+              #
+              # .
+              # This is only allowed with regional HealthCheckService.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#healthCheckService", # Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.
+          "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+              # with RFC1035. 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.
+          "networkEndpointGroups": [ # A list of URLs to the NetworkEndpointGroup
+              # resources. Must not have more than 100.  For regionalHealthCheckService, NEGs must be in
+              # zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups
+              # must be global INTERNET_IP_PORT.
+            "A String",
+          ],
+          "notificationEndpoints": [ # A list of URLs to the NotificationEndpoint
+              # resources. Must not have more than 10.  A list of endpoints for
+              # receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the
+              # same region. For global HealthCheckService,NotificationEndpoint must be global.
+            "A String",
+          ],
+          "region": "A String", # Output only. [Output Only] URL of the region where the health check service
+              # resides. This field is not applicable to global health check services.
+              # 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.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#healthCheckServiceAggregatedList", # 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, healthCheckService, requestId=None, x__xgafv=None) + 
Deletes the specified regional HealthCheckService.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthCheckService: string, Name of the HealthCheckService to delete. The name
+must be 1-63 characters long, and comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, healthCheckService, x__xgafv=None) + 
Returns the specified regional HealthCheckService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthCheckService: string, Name of the HealthCheckService to update. The name
+must be 1-63 characters long, and comply with RFC1035. (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-Check as a Service resource.
+  "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 HealthCheckService. An up-to-date fingerprint must
+      # be provided in order to patch/update the HealthCheckService; Otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # HealthCheckService.
+  "healthChecks": [ # A list of URLs to the HealthCheck resources. Must have
+      # at 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
+      # regional HealthCheckService, theHealthCheck must be regional and in the same
+      # region. 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
+      # global HealthChecks must specify sourceRegions,
+      # and HealthChecks that specify sourceRegions can
+      # only be used with global INTERNET_IP_PORTNetworkEndpointGroups.
+    "A String",
+  ],
+  "healthStatusAggregationPolicy": "A String", # Optional. Policy for how the results from multiple health checks
+      # for the same endpoint are aggregated. Defaults to NO_AGGREGATION
+      # if unspecified.
+      #
+      #    - NO_AGGREGATION. An EndpointHealth message is
+      #    returned for each  pair in the health check
+      #    service.
+      #    - 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.
+      #
+      # .
+      # This is only allowed with regional HealthCheckService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheckService", # Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "networkEndpointGroups": [ # A list of URLs to the NetworkEndpointGroup
+      # resources. Must not have more than 100.  For regionalHealthCheckService, NEGs must be in
+      # zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups
+      # must be global INTERNET_IP_PORT.
+    "A String",
+  ],
+  "notificationEndpoints": [ # A list of URLs to the NotificationEndpoint
+      # resources. Must not have more than 10.  A list of endpoints for
+      # receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the
+      # same region. For global HealthCheckService,NotificationEndpoint must be global.
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the health check service
+      # resides. This field is not applicable to global health check services.
+      # 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.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a regional HealthCheckService resource in the
+specified project and region using the data 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-Check as a Service resource.
+  "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 HealthCheckService. An up-to-date fingerprint must
+      # be provided in order to patch/update the HealthCheckService; Otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # HealthCheckService.
+  "healthChecks": [ # A list of URLs to the HealthCheck resources. Must have
+      # at 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
+      # regional HealthCheckService, theHealthCheck must be regional and in the same
+      # region. 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
+      # global HealthChecks must specify sourceRegions,
+      # and HealthChecks that specify sourceRegions can
+      # only be used with global INTERNET_IP_PORTNetworkEndpointGroups.
+    "A String",
+  ],
+  "healthStatusAggregationPolicy": "A String", # Optional. Policy for how the results from multiple health checks
+      # for the same endpoint are aggregated. Defaults to NO_AGGREGATION
+      # if unspecified.
+      # 
+      #    - NO_AGGREGATION. An EndpointHealth message is
+      #    returned for each  pair in the health check
+      #    service.
+      #    - 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.
+      # 
+      # .
+      # This is only allowed with regional HealthCheckService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheckService", # Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "networkEndpointGroups": [ # A list of URLs to the NetworkEndpointGroup
+      # resources. Must not have more than 100.  For regionalHealthCheckService, NEGs must be in
+      # zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups
+      # must be global INTERNET_IP_PORT.
+    "A String",
+  ],
+  "notificationEndpoints": [ # A list of URLs to the NotificationEndpoint
+      # resources. Must not have more than 10.  A list of endpoints for
+      # receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the
+      # same region. For global HealthCheckService,NotificationEndpoint must be global.
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the health check service
+      # resides. This field is not applicable to global health check services.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all the HealthCheckService resources that have been
+configured for the specified 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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # Output only. A list of HealthCheckService resources.
+    { # Represents a Health-Check as a Service resource.
+      "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 HealthCheckService. An up-to-date fingerprint must
+          # be provided in order to patch/update the HealthCheckService; Otherwise, the
+          # request will fail with error 412 conditionNotMet. To see the
+          # latest fingerprint, make a get() request to retrieve the
+          # HealthCheckService.
+      "healthChecks": [ # A list of URLs to the HealthCheck resources. Must have
+          # at 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
+          # regional HealthCheckService, theHealthCheck must be regional and in the same
+          # region. 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
+          # global HealthChecks must specify sourceRegions,
+          # and HealthChecks that specify sourceRegions can
+          # only be used with global INTERNET_IP_PORTNetworkEndpointGroups.
+        "A String",
+      ],
+      "healthStatusAggregationPolicy": "A String", # Optional. Policy for how the results from multiple health checks
+          # for the same endpoint are aggregated. Defaults to NO_AGGREGATION
+          # if unspecified.
+          #
+          #    - NO_AGGREGATION. An EndpointHealth message is
+          #    returned for each  pair in the health check
+          #    service.
+          #    - 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.
+          #
+          # .
+          # This is only allowed with regional HealthCheckService.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#healthCheckService", # Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.
+      "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "networkEndpointGroups": [ # A list of URLs to the NetworkEndpointGroup
+          # resources. Must not have more than 100.  For regionalHealthCheckService, NEGs must be in
+          # zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups
+          # must be global INTERNET_IP_PORT.
+        "A String",
+      ],
+      "notificationEndpoints": [ # A list of URLs to the NotificationEndpoint
+          # resources. Must not have more than 10.  A list of endpoints for
+          # receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the
+          # same region. For global HealthCheckService,NotificationEndpoint must be global.
+        "A String",
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the health check service
+          # resides. This field is not applicable to global health check services.
+          # 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.
+    },
+  ],
+  "kind": "compute#healthCheckServicesList", # Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of
+      # HealthCheckServices.
+  "nextPageToken": "A String", # Output only. [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.
+  "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, healthCheckService, body=None, requestId=None, x__xgafv=None) + 
Updates the specified regional HealthCheckService 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)
+  healthCheckService: string, Name of the HealthCheckService 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-Check as a Service resource.
+  "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 HealthCheckService. An up-to-date fingerprint must
+      # be provided in order to patch/update the HealthCheckService; Otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # HealthCheckService.
+  "healthChecks": [ # A list of URLs to the HealthCheck resources. Must have
+      # at 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
+      # regional HealthCheckService, theHealthCheck must be regional and in the same
+      # region. 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
+      # global HealthChecks must specify sourceRegions,
+      # and HealthChecks that specify sourceRegions can
+      # only be used with global INTERNET_IP_PORTNetworkEndpointGroups.
+    "A String",
+  ],
+  "healthStatusAggregationPolicy": "A String", # Optional. Policy for how the results from multiple health checks
+      # for the same endpoint are aggregated. Defaults to NO_AGGREGATION
+      # if unspecified.
+      # 
+      #    - NO_AGGREGATION. An EndpointHealth message is
+      #    returned for each  pair in the health check
+      #    service.
+      #    - 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.
+      # 
+      # .
+      # This is only allowed with regional HealthCheckService.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheckService", # Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "networkEndpointGroups": [ # A list of URLs to the NetworkEndpointGroup
+      # resources. Must not have more than 100.  For regionalHealthCheckService, NEGs must be in
+      # zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups
+      # must be global INTERNET_IP_PORT.
+    "A String",
+  ],
+  "notificationEndpoints": [ # A list of URLs to the NotificationEndpoint
+      # resources. Must not have more than 10.  A list of endpoints for
+      # receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the
+      # same region. For global HealthCheckService,NotificationEndpoint must be global.
+    "A String",
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the health check service
+      # resides. This field is not applicable to global health check services.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionHealthChecks.html b/docs/dyn/compute_preview.regionHealthChecks.html new file mode 100644 index 0000000000..3db79d91d9 --- /dev/null +++ b/docs/dyn/compute_preview.regionHealthChecks.html @@ -0,0 +1,3280 @@ + + + +

Compute Engine API . regionHealthChecks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, healthCheck, requestId=None, x__xgafv=None)

+

Deletes the specified HealthCheck resource.

+

+ get(project, region, healthCheck, x__xgafv=None)

+

Returns the specified HealthCheck resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a HealthCheck resource in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of HealthCheck resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, healthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HealthCheck resource in the specified project using the data

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, region, healthCheck, body=None, requestId=None, x__xgafv=None)

+

Updates a HealthCheck resource in the specified project using the data

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, healthCheck, requestId=None, x__xgafv=None) + 
Deletes the specified HealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthCheck: string, Name of the HealthCheck 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, healthCheck, x__xgafv=None) + 
Returns the specified HealthCheck resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthCheck: string, Name of the HealthCheck 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 check resource.
+    #
+    # Google Compute Engine has two health check resources:
+    #
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    #
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    #
+    # **Load balancing**
+    #
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    #
+    # **Autohealing in MIGs**
+    #
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    #
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      #
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a HealthCheck resource in the specified project using the data
+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 check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of HealthCheck resources available to the specified
+project.
+
+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.
+  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 HealthCheck resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HealthCheck resources.
+    { # Represents a health check resource.
+        #
+        # Google Compute Engine has two health check resources:
+        #
+        # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+        # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+        #
+        # These health check resources can be used for load balancing and for
+        # autohealing VMs in a managed instance group (MIG).
+        #
+        # **Load balancing**
+        #
+        # Health check requirements vary depending on the type of load balancer. For
+        # details about the type of health check supported for
+        # each load balancer and corresponding backend type,
+        # see Health
+        # checks overview: Load balancer guide.
+        #
+        # **Autohealing in MIGs**
+        #
+        # The health checks that you use for autohealing VMs in a MIG can be either
+        # regional or global. For more information, see  Set up an
+        # application health check and autohealing.
+        #
+        # For more information, seeHealth checks
+        # overview.
+      "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+          # seconds.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "grpcHealthCheck": {
+        "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+            # value of grpc_service_name has the following meanings by convention:
+            #
+            # - Empty service_name means the overall status of all services at the
+            # backend.
+            #
+            # - Non-empty service_name means the health of that gRPC service, as defined
+            # by the owner of the service.
+            #
+            # The grpc_service_name can only be ASCII.
+        "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+            # values are 1 through 65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+      },
+      "grpcTlsHealthCheck": {
+        "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+            # value of grpc_service_name has the following meanings by convention:
+            #
+            # - Empty service_name means the overall status of all services at the
+            # backend.
+            #
+            # - Non-empty service_name means the health of that gRPC service, as defined
+            # by the owner of the service.
+            #
+            # The grpc_service_name can only be ASCII.
+        "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+            # values are 1 through 65535.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+      },
+      "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+          # many consecutive successes. The default value is 2.
+      "http2HealthCheck": {
+        "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "httpHealthCheck": {
+        "host": "A String", # The value of the host header in the HTTP health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 80. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Also supported in legacy HTTP health checks for target pools.
+            # The health check supports all backends supported by the backend service
+            # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+            # network endpoint groups, and instance group backends.
+            # USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for pass-through load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "httpsHealthCheck": {
+        "host": "A String", # The value of the host header in the HTTPS health check request. If left
+            # empty (default value), the host header is set to the destination IP address
+            # to which health check packets are sent. The destination IP address depends
+            # on the type of load balancer. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+        "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+            # HTTP 200 (OK) status code, you can configure the health check to pass only
+            # when the backend sends this specific ASCII response string within the first
+            # 1024 bytes of the HTTP response body. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#healthCheck", # Output only. Type of the resource.
+      "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+          # will be exported to Stackdriver.
+        "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+            # means no health check logging will be done.
+      },
+      "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.
+          # For example, a name that is 1-63 characters long, matches the regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+          # RFC1035. This regular expression describes a name where the first
+          # character is a lowercase letter, and all following characters are a dash,
+          # lowercase letter, or digit, except the last character, which isn't a dash.
+      "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+          # global health checks.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+          # regions are specified, then exactly 3 regions should be specified. The
+          # region names must be valid names of Google Cloud regions.
+          # This can only be set for global health check.
+          # If this list is non-empty, then there are restrictions
+          # on what other health check fields are supported and what other resources
+          # can use this health check:
+          #
+          #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+          #    - The TCP request field is not supported.
+          #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+          #    supported.
+          #    - The checkIntervalSec field must be at least 30.
+          #    - The health check cannot be used with BackendService nor with managed
+          #    instance group auto-healing.
+        "A String",
+      ],
+      "sslHealthCheck": {
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 443. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            #  USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+            # 1024 bytes in length, after establishing the TCP connection and SSL
+            # handshake.
+        "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+            # TCP connection and the TLS handshake, you can configure the health check to
+            # pass only when the backend sends this exact response ASCII string, up to
+            # 1024 bytes in length. For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+      },
+      "tcpHealthCheck": {
+        "port": 42, # The TCP port number to which the health check prober sends packets. The
+            # default value is 80. Valid values are 1 through65535.
+        "portName": "A String", # Not supported.
+        "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+            # following values:
+            # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+            # for passthrough load balancers and backend services for proxy load
+            # balancers. Not supported by target pools. The health check supports all
+            # backends supported by the backend service provided the backend can be
+            # health checked. For example, GCE_VM_IP network endpoint
+            # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+            # group backends.
+            # USE_NAMED_PORT: Not supported.
+            # USE_SERVING_PORT: Provides an indirect method of specifying
+            # the health check port by referring to the backend service. Only supported
+            # by backend services for proxy load balancers. Not supported by target
+            # pools.  Not supported by backend services for passthrough load balancers.
+            # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+            # backends.
+            #
+            # For GCE_VM_IP_PORT network endpoint group backends, the health
+            # check uses the port number specified for each endpoint in the network
+            # endpoint group.  For instance group backends, the health check uses the
+            # port number determined by looking up the backend service's named port in
+            # the instance group's list of named ports.
+        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+            # backend, either NONE or PROXY_V1. The default
+            # is NONE.
+        "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+            # 1024 bytes in length, after establishing the TCP connection.
+        "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+            # TCP connection, you can configure the health check to pass only when the
+            # backend sends this exact response ASCII string, up to 1024 bytes in length.
+            # For details, see:
+            # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+      },
+      "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+          # 5 seconds. It is invalid for timeoutSec to have greater
+          # value than checkIntervalSec.
+      "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+          # Exactly one of the protocol-specific health check fields must be specified,
+          # which must match type field.
+      "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+          # consecutive failures. The default value is 2.
+    },
+  ],
+  "kind": "compute#healthCheckList", # 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.
+  "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, healthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HealthCheck resource in the specified project using 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)
+  healthCheck: string, Name of the HealthCheck resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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",
+  ],
+}
+
+ +
+ update(project, region, healthCheck, body=None, requestId=None, x__xgafv=None) + 
Updates a HealthCheck resource in the specified project using the data
+included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthCheck: string, Name of the HealthCheck resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health check resource.
+    # 
+    # Google Compute Engine has two health check resources:
+    # 
+    # * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)
+    # * [Global](/compute/docs/reference/rest/v1/healthChecks)
+    # 
+    # These health check resources can be used for load balancing and for
+    # autohealing VMs in a managed instance group (MIG).
+    # 
+    # **Load balancing**
+    # 
+    # Health check requirements vary depending on the type of load balancer. For
+    # details about the type of health check supported for
+    # each load balancer and corresponding backend type,
+    # see Health
+    # checks overview: Load balancer guide.
+    # 
+    # **Autohealing in MIGs**
+    # 
+    # The health checks that you use for autohealing VMs in a MIG can be either
+    # regional or global. For more information, see  Set up an
+    # application health check and autohealing.
+    # 
+    # For more information, seeHealth checks
+    # overview.
+  "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5
+      # seconds.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "grpcHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "grpcTlsHealthCheck": {
+    "grpcServiceName": "A String", # The gRPC service name for the health check. This field is optional. The
+        # value of grpc_service_name has the following meanings by convention:
+        #
+        # - Empty service_name means the overall status of all services at the
+        # backend.
+        #
+        # - Non-empty service_name means the health of that gRPC service, as defined
+        # by the owner of the service.
+        #
+        # The grpc_service_name can only be ASCII.
+    "port": 42, # The TCP port number to which the health check prober sends packets. Valid
+        # values are 1 through 65535.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+  },
+  "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this
+      # many consecutive successes. The default value is 2.
+  "http2HealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP/2 health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP/2 health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTP health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Also supported in legacy HTTP health checks for target pools.
+        # The health check supports all backends supported by the backend service
+        # provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT
+        # network endpoint groups, and instance group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for pass-through load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTP health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "httpsHealthCheck": {
+    "host": "A String", # The value of the host header in the HTTPS health check request. If left
+        # empty (default value), the host header is set to the destination IP address
+        # to which health check packets are sent. The destination IP address depends
+        # on the type of load balancer. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "requestPath": "A String", # The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.
+    "response": "A String", # Creates a content-based HTTPS health check. In addition to the required
+        # HTTP 200 (OK) status code, you can configure the health check to pass only
+        # when the backend sends this specific ASCII response string within the first
+        # 1024 bytes of the HTTP response body. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthCheck", # Output only. Type of the resource.
+  "logConfig": { # Configuration of logging on a health check. If logging is enabled, logs # Configure logging on this health check.
+      # will be exported to Stackdriver.
+    "enable": True or False, # Indicates whether or not to export logs. This is false by default, which
+        # means no health check logging will be done.
+  },
+  "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.
+      # For example, a name that is 1-63 characters long, matches the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with
+      # RFC1035. This regular expression describes a name where the first
+      # character is a lowercase letter, and all following characters are a dash,
+      # lowercase letter, or digit, except the last character, which isn't a dash.
+  "region": "A String", # Output only. [Output Only] Region where the health check resides.  Not applicable to
+      # global health checks.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sourceRegions": [ # The list of cloud regions from which health checks are performed. If any
+      # regions are specified, then exactly 3 regions should be specified. The
+      # region names must be valid names of Google Cloud regions.
+      # This can only be set for global health check.
+      # If this list is non-empty, then there are restrictions
+      # on what other health check fields are supported and what other resources
+      # can use this health check:
+      # 
+      #    - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.
+      #    - The TCP request field is not supported.
+      #    - The proxyHeader field for HTTP, HTTPS, and TCP is not
+      #    supported.
+      #    - The checkIntervalSec field must be at least 30.
+      #    - The health check cannot be used with BackendService nor with managed
+      #    instance group auto-healing.
+    "A String",
+  ],
+  "sslHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 443. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        #  USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection and SSL
+        # handshake.
+    "response": "A String", # Creates a content-based SSL health check. In addition to establishing a
+        # TCP connection and the TLS handshake, you can configure the health check to
+        # pass only when the backend sends this exact response ASCII string, up to
+        # 1024 bytes in length. For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "tcpHealthCheck": {
+    "port": 42, # The TCP port number to which the health check prober sends packets. The
+        # default value is 80. Valid values are 1 through65535.
+    "portName": "A String", # Not supported.
+    "portSpecification": "A String", # Specifies how a port is selected for health checking. Can be one of the
+        # following values:
+        # USE_FIXED_PORT: Specifies a port number explicitly using theport field  in the health check. Supported by backend services
+        # for passthrough load balancers and backend services for proxy load
+        # balancers. Not supported by target pools. The health check supports all
+        # backends supported by the backend service provided the backend can be
+        # health checked. For example, GCE_VM_IP network endpoint
+        # groups, GCE_VM_IP_PORT network endpoint groups, and instance
+        # group backends.
+        # USE_NAMED_PORT: Not supported.
+        # USE_SERVING_PORT: Provides an indirect method of specifying
+        # the health check port by referring to the backend service. Only supported
+        # by backend services for proxy load balancers. Not supported by target
+        # pools.  Not supported by backend services for passthrough load balancers.
+        # Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group
+        # backends.
+        #
+        # For GCE_VM_IP_PORT network endpoint group backends, the health
+        # check uses the port number specified for each endpoint in the network
+        # endpoint group.  For instance group backends, the health check uses the
+        # port number determined by looking up the backend service's named port in
+        # the instance group's list of named ports.
+    "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+        # backend, either NONE or PROXY_V1. The default
+        # is NONE.
+    "request": "A String", # Instructs the health check prober to send this exact ASCII string, up to
+        # 1024 bytes in length, after establishing the TCP connection.
+    "response": "A String", # Creates a content-based TCP health check. In addition to establishing a
+        # TCP connection, you can configure the health check to pass only when the
+        # backend sends this exact response ASCII string, up to 1024 bytes in length.
+        # For details, see:
+        # https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp
+  },
+  "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is
+      # 5 seconds. It is invalid for timeoutSec to have greater
+      # value than checkIntervalSec.
+  "type": "A String", # Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.
+      # Exactly one of the protocol-specific health check fields must be specified,
+      # which must match type field.
+  "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many
+      # consecutive failures. The default value is 2.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionHealthSources.html b/docs/dyn/compute_preview.regionHealthSources.html new file mode 100644 index 0000000000..7cf1951b3e --- /dev/null +++ b/docs/dyn/compute_preview.regionHealthSources.html @@ -0,0 +1,1695 @@ + + + +

Compute Engine API . regionHealthSources

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all HealthSource resources (all

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, healthSource, requestId=None, x__xgafv=None)

+

Deletes the specified HealthSource in the given region

+

+ get(project, region, healthSource, x__xgafv=None)

+

Returns the specified HealthSource resource in the given region.

+

+ getHealth(project, region, healthSource, x__xgafv=None)

+

Gets the most recent health check results for this

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Create a HealthSource in the specified project in the given region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the HealthSources for a project in the given region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, healthSource, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional HealthSource resource

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all HealthSource resources (all
+regional) available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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 HealthSourcesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HealthSourcesScopedList resources.
+    "a_key": { # Name of the scope containing this set of HealthSources.
+      "healthSources": [ # A list of HealthSources contained in this scope.
+        { # Represents a health source.
+            #
+            # A health source resource specifies the source resources and the health
+            # aggregation policy applied to the source resources to determine the
+            # aggregated health status.
+          "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 HealthSource. An up-to-date fingerprint
+              # must be provided in order to patch the HealthSource; Otherwise, the request
+              # will fail with error 412 conditionNotMet. To see the latest
+              # fingerprint, make a get() request to retrieve the
+              # HealthSource.
+          "healthAggregationPolicy": "A String", # URL to the HealthAggregationPolicy resource. Must be set. Must
+              # be regional and in the same region as the HealthSource. Can be
+              # mutated.
+          "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+              # generates this identifier.
+          "kind": "compute#healthSource", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+          "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.
+          "region": "A String", # Output only. [Output Only] URL of the region where the health source 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.
+          "sourceType": "A String", # Specifies the type of the HealthSource. The only allowed value
+              # is BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.
+          "sources": [ # URLs to the source resources. Must be size 1. Must be aBackendService if
+              # the sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional
+              # and in the same region as the HealthSource (cross-region
+              # deployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be
+              # mutated.
+            "A String",
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # health sources 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#healthSourceAggregatedList", # 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, healthSource, requestId=None, x__xgafv=None) + 
Deletes the specified HealthSource in the given region
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthSource: string, Name of the HealthSource 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, healthSource, x__xgafv=None) + 
Returns the specified HealthSource resource in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthSource: string, Name of the HealthSource 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 source.
+    #
+    # A health source resource specifies the source resources and the health
+    # aggregation policy applied to the source resources to determine the
+    # aggregated health status.
+  "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 HealthSource. An up-to-date fingerprint
+      # must be provided in order to patch the HealthSource; Otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # HealthSource.
+  "healthAggregationPolicy": "A String", # URL to the HealthAggregationPolicy resource. Must be set. Must
+      # be regional and in the same region as the HealthSource. Can be
+      # mutated.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#healthSource", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health source 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.
+  "sourceType": "A String", # Specifies the type of the HealthSource. The only allowed value
+      # is BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.
+  "sources": [ # URLs to the source resources. Must be size 1. Must be aBackendService if
+      # the sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional
+      # and in the same region as the HealthSource (cross-region
+      # deployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be
+      # mutated.
+    "A String",
+  ],
+}
+
+ +
+ getHealth(project, region, healthSource, x__xgafv=None) + 
Gets the most recent health check results for this
+regional HealthSource.
+
+Args:
+  project: string, Name of the project scoping this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthSource: string, Name of the HealthSource resource to get health for. (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 RegionHealthSources.GetHealth
+  "healthState": "A String", # Health state of the HealthSource.
+  "kind": "compute#healthSourceHealth", # Output only. [Output Only] Type of resource. Alwayscompute#healthSourceHealth for the health of health sources.
+  "sources": [ # Health state details of the sources.
+    {
+      "backends": [ # Represents an instance group or network endpoint group behind the source
+          # backend service. Only used if the sourceType of the regionHealthSource
+          # is BACKEND_SERVICE.
+        {
+          "endpointCount": 42, # Total number of endpoints when determining the health of the
+              # regionHealthSource.
+          "group": "A String", # Fully qualified URL of an instance group or network endpoint group
+              # behind the source backend service.
+          "healthyEndpointCount": 42, # Number of endpoints considered healthy when determining health of the
+              # regionHealthSource.
+        },
+      ],
+      "forwardingRule": "A String", # Fully qualified URL of the forwarding rule associated with the source
+          # resource if it is a L4ILB backend service.
+      "source": "A String", # Fully qualified URL of the associated source resource. This is always a
+          # backend service URL.
+    },
+  ],
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Create a HealthSource 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 source.
+    # 
+    # A health source resource specifies the source resources and the health
+    # aggregation policy applied to the source resources to determine the
+    # aggregated health status.
+  "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 HealthSource. An up-to-date fingerprint
+      # must be provided in order to patch the HealthSource; Otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # HealthSource.
+  "healthAggregationPolicy": "A String", # URL to the HealthAggregationPolicy resource. Must be set. Must
+      # be regional and in the same region as the HealthSource. Can be
+      # mutated.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#healthSource", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health source 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.
+  "sourceType": "A String", # Specifies the type of the HealthSource. The only allowed value
+      # is BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.
+  "sources": [ # URLs to the source resources. Must be size 1. Must be aBackendService if
+      # the sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional
+      # and in the same region as the HealthSource (cross-region
+      # deployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be
+      # mutated.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the HealthSources 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.
+  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 HealthSource resources.
+    { # Represents a health source.
+        #
+        # A health source resource specifies the source resources and the health
+        # aggregation policy applied to the source resources to determine the
+        # aggregated health status.
+      "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 HealthSource. An up-to-date fingerprint
+          # must be provided in order to patch the HealthSource; Otherwise, the request
+          # will fail with error 412 conditionNotMet. To see the latest
+          # fingerprint, make a get() request to retrieve the
+          # HealthSource.
+      "healthAggregationPolicy": "A String", # URL to the HealthAggregationPolicy resource. Must be set. Must
+          # be regional and in the same region as the HealthSource. Can be
+          # mutated.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+          # generates this identifier.
+      "kind": "compute#healthSource", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+      "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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the health source 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.
+      "sourceType": "A String", # Specifies the type of the HealthSource. The only allowed value
+          # is BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.
+      "sources": [ # URLs to the source resources. Must be size 1. Must be aBackendService if
+          # the sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional
+          # and in the same region as the HealthSource (cross-region
+          # deployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be
+          # mutated.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#healthSourceList", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+  "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, healthSource, body=None, requestId=None, x__xgafv=None) + 
Updates the specified regional HealthSource 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)
+  healthSource: string, Name of the HealthSource 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 source.
+    # 
+    # A health source resource specifies the source resources and the health
+    # aggregation policy applied to the source resources to determine the
+    # aggregated health status.
+  "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 HealthSource. An up-to-date fingerprint
+      # must be provided in order to patch the HealthSource; Otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # HealthSource.
+  "healthAggregationPolicy": "A String", # URL to the HealthAggregationPolicy resource. Must be set. Must
+      # be regional and in the same region as the HealthSource. Can be
+      # mutated.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#healthSource", # Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health source 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.
+  "sourceType": "A String", # Specifies the type of the HealthSource. The only allowed value
+      # is BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.
+  "sources": [ # URLs to the source resources. Must be size 1. Must be aBackendService if
+      # the sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional
+      # and in the same region as the HealthSource (cross-region
+      # deployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be
+      # mutated.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionInstanceGroupManagerResizeRequests.html b/docs/dyn/compute_preview.regionInstanceGroupManagerResizeRequests.html new file mode 100644 index 0000000000..c597761a9e --- /dev/null +++ b/docs/dyn/compute_preview.regionInstanceGroupManagerResizeRequests.html @@ -0,0 +1,2178 @@ + + + +

Compute Engine API . regionInstanceGroupManagerResizeRequests

+

Instance Methods

+

+ cancel(project, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)

+

Cancels the specified resize request.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)

+

Deletes the specified, inactive resize request. Requests that are still

+

+ get(project, region, instanceGroupManager, resizeRequest, x__xgafv=None)

+

Returns all of the details about the specified resize request.

+

+ insert(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Creates a new Resize Request that starts provisioning VMs immediately

+

+ list(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of Resize Requests that are contained in the

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ cancel(project, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None) + 
Cancels the specified resize request.
+Cancelled resize request no longer waits for the resources to be
+provisioned. Cancel is only possible for requests that are in accepted
+state.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+Name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request to cancel.
+Name should conform to RFC1035 or be a resource ID. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None) + 
Deletes the specified, inactive resize request. Requests that are still
+active cannot be deleted. Deleting request does not delete instances that
+were provisioned previously.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+Name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request to delete.
+Name should conform to RFC1035 or be a resource ID. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instanceGroupManager, resizeRequest, x__xgafv=None) + 
Returns all of the details about the specified resize request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+Name should conform to RFC1035 or be a resource ID. (required)
+  resizeRequest: string, The name of the resize request.
+Name should conform to RFC1035 or be a resource ID. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # InstanceGroupManagerResizeRequest represents a request to create
+    # a number of VMs: either immediately or by queuing the request for the
+    # specified time. This resize request is nested under InstanceGroupManager
+    # and the VMs created by this request are added to the owning
+    # InstanceGroupManager.
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+      # identifier.
+  "instances": [ # The names of instances to be created by this resize request. The number of
+      # names specified determines the number of instances to create. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'resize_by'.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+  "name": "A String", # The name of this resize request. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "region": "A String", # Output only. The URL of a region
+      # where the resize request is located. Populated only for regional resize
+      # requests.
+  "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+      # At the end of the run duration instance will be deleted.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'instances'.
+  "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. Current state of the request.
+  "status": { # Output only. Status of the request.
+    "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+        # the ResizeRequest that caused the transition to the FAILED state.
+        # Contrary to the last_attempt errors, this field is final and errors are
+        # never removed from here, as the ResizeRequest is not going to retry.
+      "errors": [ # [Output Only] The array of errors encountered while processing this
+          # operation.
+        { # Represents a single error encountered during the processing of an
+            # 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.
+            { # Container for structured error details providing additional context
+                # specific to the encountered error code.
+              "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                  #
+                  # 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. # Links and information to help the user resolve the error.
+                  #
+                  # 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 # A localized human-readable error message intended for end users.
+                  # 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. # Details about quota limits and metrics when a quota is exceeded.
+                "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.
+        },
+      ],
+    },
+    "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+        # temporary since the ResizeRequest can retry, as long as it's still active
+        # and the last attempt value can either be cleared or replaced with a
+        # different error. Since ResizeRequest retries infrequently, the value may
+        # be stale and no longer show an active problem. The value is cleared when
+        # ResizeRequest transitions to the final state (becomes inactive). If the
+        # final state is FAILED the error describing it will be stored in the
+        # "error" field only.
+      "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+        "errors": [ # [Output Only] The array of errors encountered while processing this
+            # operation.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+    },
+  },
+  "zone": "A String", # Output only. The URL of a zone
+      # where the resize request is located. Populated only for zonal resize
+      # requests.
+}
+
+ +
+ insert(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Creates a new Resize Request that starts provisioning VMs immediately
+or queues VM creation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, Name of the managed instance group to which the resize request is scoped.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # InstanceGroupManagerResizeRequest represents a request to create
+    # a number of VMs: either immediately or by queuing the request for the
+    # specified time. This resize request is nested under InstanceGroupManager
+    # and the VMs created by this request are added to the owning
+    # InstanceGroupManager.
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+      # identifier.
+  "instances": [ # The names of instances to be created by this resize request. The number of
+      # names specified determines the number of instances to create. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'resize_by'.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+  "name": "A String", # The name of this resize request. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "region": "A String", # Output only. The URL of a region
+      # where the resize request is located. Populated only for regional resize
+      # requests.
+  "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+      # At the end of the run duration instance will be deleted.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+      # target size will be increased by this number. This field cannot be used
+      # together with 'instances'.
+  "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+  "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+  "state": "A String", # Output only. Current state of the request.
+  "status": { # Output only. Status of the request.
+    "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+        # the ResizeRequest that caused the transition to the FAILED state.
+        # Contrary to the last_attempt errors, this field is final and errors are
+        # never removed from here, as the ResizeRequest is not going to retry.
+      "errors": [ # [Output Only] The array of errors encountered while processing this
+          # operation.
+        { # Represents a single error encountered during the processing of an
+            # 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.
+            { # Container for structured error details providing additional context
+                # specific to the encountered error code.
+              "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                  #
+                  # 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. # Links and information to help the user resolve the error.
+                  #
+                  # 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 # A localized human-readable error message intended for end users.
+                  # 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. # Details about quota limits and metrics when a quota is exceeded.
+                "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.
+        },
+      ],
+    },
+    "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+        # temporary since the ResizeRequest can retry, as long as it's still active
+        # and the last attempt value can either be cleared or replaced with a
+        # different error. Since ResizeRequest retries infrequently, the value may
+        # be stale and no longer show an active problem. The value is cleared when
+        # ResizeRequest transitions to the final state (becomes inactive). If the
+        # final state is FAILED the error describing it will be stored in the
+        # "error" field only.
+      "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+        "errors": [ # [Output Only] The array of errors encountered while processing this
+            # operation.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+    },
+  },
+  "zone": "A String", # Output only. The URL of a zone
+      # where the resize request is located. Populated only for zonal resize
+      # requests.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of Resize Requests that are contained in the
+managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region
+scoping this request. Name should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group. The 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # Output only. Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Resize Request resources.
+    { # InstanceGroupManagerResizeRequest represents a request to create
+        # a number of VMs: either immediately or by queuing the request for the
+        # specified time. This resize request is nested under InstanceGroupManager
+        # and the VMs created by this request are added to the owning
+        # InstanceGroupManager.
+      "creationTimestamp": "A String", # Output only. The creation timestamp for this resize request inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource.
+      "id": "A String", # Output only. A unique identifier for this resource type. The server generates this
+          # identifier.
+      "instances": [ # The names of instances to be created by this resize request. The number of
+          # names specified determines the number of instances to create. The group's
+          # target size will be increased by this number. This field cannot be used
+          # together with 'resize_by'.
+        {
+          "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+              # optimistic locking. It is ignored when inserting a per-instance
+              # config. An up-to-date fingerprint must be provided in order to update an
+              # existing per-instance configuration or the field needs to be unset.
+          "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+              # Serves as a merge key during UpdatePerInstanceConfigs
+              # operations, that is, if a per-instance configuration with the same name
+              # exists then it will be updated, otherwise a new one will be created for the
+              # VM instance with the same name. An attempt to create a per-instance
+              # configuration for a VM instance that either doesn't exist or is not part
+              # of the group will result in an error.
+          "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+              # preserved state generated from a stateful policy.
+            "disks": { # Preserved disks defined for this instance.
+                # This map is keyed with the device names of the disks.
+              "a_key": {
+                "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                    # update, instance recreate operations. This flag is used to configure
+                    # if the disk should be deleted after it is no longer used by the group,
+                    # e.g. when the given instance or the whole MIG is deleted.
+                    # Note: disks attached in READ_ONLY mode cannot be
+                    # auto-deleted.
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                    # disk in READ_WRITE mode.
+                "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                    # to the VM instance.
+              },
+            },
+            "externalIPs": { # Preserved external IPs defined for this instance.
+                # This map is keyed with the name of the network interface.
+              "a_key": {
+                "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                    # update or VM instance recreate operations.
+                    # This flag is used to configure if the IP reservation should be deleted
+                    # after it is no longer used by the group, e.g. when the given instance
+                    # or the whole group is deleted.
+                "ipAddress": { # Ip address representation
+                  "address": "A String", # The URL of the reservation for this IP address.
+                  "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                      # network interface.
+                },
+              },
+            },
+            "internalIPs": { # Preserved internal IPs defined for this instance.
+                # This map is keyed with the name of the network interface.
+              "a_key": {
+                "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                    # update or VM instance recreate operations.
+                    # This flag is used to configure if the IP reservation should be deleted
+                    # after it is no longer used by the group, e.g. when the given instance
+                    # or the whole group is deleted.
+                "ipAddress": { # Ip address representation
+                  "address": "A String", # The URL of the reservation for this IP address.
+                  "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                      # network interface.
+                },
+              },
+            },
+            "metadata": { # Preserved metadata defined for this instance.
+              "a_key": "A String",
+            },
+          },
+          "status": "A String", # The status of applying this per-instance configuration on the corresponding
+              # managed instance.
+        },
+      ],
+      "kind": "compute#instanceGroupManagerResizeRequest", # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
+      "name": "A String", # The name of this resize request. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "region": "A String", # Output only. The URL of a region
+          # where the resize request is located. Populated only for regional resize
+          # requests.
+      "requestedRunDuration": { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
+          # At the end of the run duration instance will be deleted.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "resizeBy": 42, # The number of instances to be created by this resize request. The group's
+          # target size will be increased by this number. This field cannot be used
+          # together with 'instances'.
+      "selfLink": "A String", # Output only. The URL for this resize request. The server defines this URL.
+      "selfLinkWithId": "A String", # Output only. Server-defined URL for this resource with the resource id.
+      "state": "A String", # Output only. Current state of the request.
+      "status": { # Output only. Status of the request.
+        "error": { # Output only. Fatal errors encountered during the queueing or provisioning phases of
+            # the ResizeRequest that caused the transition to the FAILED state.
+            # Contrary to the last_attempt errors, this field is final and errors are
+            # never removed from here, as the ResizeRequest is not going to retry.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "lastAttempt": { # Output only. Information about the last attempt to fulfill the request. The value is
+            # temporary since the ResizeRequest can retry, as long as it's still active
+            # and the last attempt value can either be cleared or replaced with a
+            # different error. Since ResizeRequest retries infrequently, the value may
+            # be stale and no longer show an active problem. The value is cleared when
+            # ResizeRequest transitions to the final state (becomes inactive). If the
+            # final state is FAILED the error describing it will be stored in the
+            # "error" field only.
+          "error": { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+        },
+      },
+      "zone": "A String", # Output only. The URL of a zone
+          # where the resize request is located. Populated only for zonal resize
+          # requests.
+    },
+  ],
+  "kind": "compute#regionInstanceGroupManagerResizeRequestList", # Output only. Type of the resource. Alwayscompute#regionInstanceGroupManagerResizeRequestList for
+      # a list of Resize Requests.
+  "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.
+  "unreachables": [ # 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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionInstanceGroupManagers.html b/docs/dyn/compute_preview.regionInstanceGroupManagers.html new file mode 100644 index 0000000000..b4f64fc76a --- /dev/null +++ b/docs/dyn/compute_preview.regionInstanceGroupManagers.html @@ -0,0 +1,12414 @@ + + + +

Compute Engine API . regionInstanceGroupManagers

+

Instance Methods

+

+ abandonInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances to be immediately removed from the managed

+

+ applyUpdatesToInstances(project, region, instanceGroupManager, body=None, x__xgafv=None)

+

Apply updates to selected instances the managed instance group.

+

+ close()

+

Close httplib2 connections.

+

+ createInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Creates instances with per-instance configurations in this regional managed

+

+ delete(project, region, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Deletes the specified managed instance group and all of the instances

+

+ deleteInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ deletePerInstanceConfigs(project, region, instanceGroupManager, body=None, x__xgafv=None)

+

Deletes selected per-instance configurations for the managed instance

+

+ get(project, region, instanceGroupManager, x__xgafv=None)

+

Returns all of the details about the specified managed instance group.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a managed instance group using the information that you specify

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of managed instance groups that are contained

+

+ listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all errors thrown by actions on instances for a given regional

+

+ listErrors_next()

+

Retrieves the next page of results.

+

+ listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the instances in the managed instance group and instances that are

+

+ listManagedInstances_next()

+

Retrieves the next page of results.

+

+ listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all of the per-instance configurations defined for the managed

+

+ listPerInstanceConfigs_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Updates a managed instance group using the information that you specify

+

+ patchPerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Inserts or patches per-instance configurations for the managed instance

+

+ recreateInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified VM instances in the managed instance group to be

+

+ resize(project, region, instanceGroupManager, size, requestId=None, x__xgafv=None)

+

Changes the intended size of the managed instance group. If you increase

+

+ resumeInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ setInstanceTemplate(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Sets the instance template to use when creating new instances or recreating

+

+ setTargetPools(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Modifies the target pools to which all new instances in this group are

+

+ startInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ stopInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ suspendInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Flags the specified instances in the managed instance group to be

+

+ updatePerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Inserts or updates per-instance configurations for the managed instance

+

Method Details

+
+ abandonInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances to be immediately removed from the managed
+instance group. Abandoning an instance does not delete the
+instance, but it does remove the instance from any target pools that are
+applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
+number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
+not yet been removed from the group. You must separately verify the
+status of the abandoning action with thelistmanagedinstances
+method.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to abandon. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ applyUpdatesToInstances(project, region, instanceGroupManager, body=None, x__xgafv=None) + 
Apply updates to selected instances the managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request, should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # RegionInstanceGroupManagers.applyUpdatesToInstances
+  "allInstances": True or False, # Flag to update all instances instead of specified list of "instances".
+      # If the flag is set to true then the instances may not be specified
+      # in the request.
+  "instances": [ # The list of URLs of one or more instances for which you want to apply
+      # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+  "minimalAction": "A String", # The minimal action that you want to perform on each instance during the
+      # update:
+      # 
+      # 
+      #      - REPLACE: At minimum, delete the instance and create it
+      #      again.
+      #    - RESTART: Stop the instance and start it
+      #      again.
+      #    - REFRESH: Do not stop the instance and limit
+      #      disruption as much as possible.
+      #    - NONE: Do not
+      #      disrupt the instance at all.
+      # 
+      # 
+      # By default, the minimum action is NONE. If your update
+      # requires a more disruptive action than you set with this flag, the
+      # necessary action is performed to execute the update.
+  "mostDisruptiveAllowedAction": "A String", # The most disruptive action that you want to perform on each instance during
+      # the update:
+      # 
+      # 
+      #      - REPLACE: Delete the instance and create it again.
+      #      - RESTART: Stop the instance and start it again.
+      #      - REFRESH: Do not stop the instance and limit disruption
+      #      as much as possible.
+      #    - NONE: Do not disrupt the
+      #      instance at all.
+      # 
+      # 
+      # By default, the most disruptive allowed action is REPLACE. If
+      # your update requires a more disruptive action than you set with this flag,
+      # the update request will fail.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ createInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Creates instances with per-instance configurations in this regional managed
+instance group. Instances are created using the current instance template.
+The create instances operation is marked DONE if
+the createInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
+method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of theregion
+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:
+
+{ # RegionInstanceGroupManagers.createInstances
+  "instances": [ # [Required] List of specifications of per-instance configs.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ delete(project, region, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Deletes the specified managed instance group and all of the instances
+in that group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group to delete. (required)
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deleteInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+immediately deleted. The instances are also removed from any target
+pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
+instances that you delete.
+The deleteInstances operation is marked DONE if
+the deleteInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances
+method.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to delete. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+  "skipInstancesOnValidationError": True or False, # Specifies whether the request should proceed despite the inclusion of
+      # instances that are not members of the group or that are already in the
+      # process of being deleted or abandoned. If this field is set to `false` and
+      # such an instance is specified in the request, the operation fails. The
+      # operation always fails if the request contains a malformed instance URL or
+      # a reference to an instance that exists in a zone or region other than the
+      # group's zone or region.
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ deletePerInstanceConfigs(project, region, instanceGroupManager, body=None, x__xgafv=None) + 
Deletes selected per-instance configurations for the managed instance
+group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request, 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:
+
+{ # RegionInstanceGroupManagers.deletePerInstanceConfigs
+  "names": [ # The list of instance names for which we want to delete per-instance configs
+      # on this managed instance group.
+    "A String",
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instanceGroupManager, x__xgafv=None) + 
Returns all of the details about the specified managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group 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 Managed Instance Group resource.
+    #
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    #
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    #
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      #
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      #
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      #
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      #
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a managed instance group using the information that you specify
+in the request. After the group is created, instances in the group are
+created using the specified instance template.
+This operation is marked as DONE when the group is created
+even if the instances in the group have not yet been created. You must
+separately verify the status of the individual instances with thelistmanagedinstances
+method.
+
+A regional managed instance group can contain up to 2000 instances.
+
+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 Managed Instance Group resource.
+    # 
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    # 
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    # 
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      # 
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      # 
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of managed instance groups that are contained
+within the specified 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.
+  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 managed instance groups.
+  "id": "A String", # Output only. Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceGroupManager resources.
+    { # Represents a Managed Instance Group resource.
+        #
+        # An instance group is a collection of VM instances that you can manage as a
+        # single entity. For more information, readInstance groups.
+        #
+        # For zonal Managed Instance Group, use the instanceGroupManagers
+        # resource.
+        #
+        # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+      "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+          # for the group.
+        "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+            #
+            # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+            # instances to apply the configuration. To apply the configuration, set the
+            # group's updatePolicy.type field to use proactive updates or
+            # use the applyUpdatesToInstances method.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+          "labels": { # The label key-value pairs that you want to patch onto the instance.
+            "a_key": "A String",
+          },
+          "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+              # more information, see Project and
+              # instance metadata.
+            "a_key": "A String",
+          },
+        },
+      },
+      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+          # only one value.
+        {
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
+          "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+              # initialize and run its startup script. During a VM's initial delay
+              # period, the MIG ignores unsuccessful health checks because the VM might
+              # be in the startup process. This prevents the MIG from prematurely
+              # recreating a VM. If the health check receives a healthy response during
+              # the initial delay, it indicates that the startup process is complete and
+              # the VM is ready. The value of initial delay must be between 0 and 3600
+              # seconds. The default value is 0.
+        },
+      ],
+      "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+          # all VMs in a MIG. The maximum character length is 58 and the name must
+          # comply with RFC1035 format.
+          #
+          # When a VM is created in the group, the MIG appends a hyphen and a random
+          # four-character string to the base instance name. If you want the MIG to
+          # assign sequential numbers instead of a random string, then end the base
+          # instance name with a hyphen followed by one or more hash symbols. The hash
+          # symbols indicate the number of digits. For example, a base instance name of
+          # "vm-###" results in "vm-001" as a VM name.
+          # @pattern
+          # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+      "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+          # text format.
+      "currentActions": { # Output only. The list of instance actions and the number of instances
+          # in this managed instance group that are scheduled for each of those
+          # actions.
+        "abandoning": 42, # Output only. The total number of instances in the managed instance group
+            # that are scheduled to be abandoned. Abandoning an instance removes it
+            # from the managed instance group without deleting it.
+        "creating": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be created or are currently being created. If the group
+            # fails to create any of these instances, it tries again until it creates
+            # the instance successfully.
+            #
+            # If you have disabled creation retries, this field will not be populated;
+            # instead, the creatingWithoutRetries field will be populated.
+        "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+            # will attempt to create. The group attempts to create each instance
+            # only once. If the group fails to create any of these instances, it
+            # decreases the group's targetSize value accordingly.
+        "deleting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be deleted or are currently being deleted.
+        "none": 42, # Output only. The number of instances in the managed instance group that
+            # are running and have no scheduled actions.
+        "recreating": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be recreated or are currently being being recreated.
+            # Recreating an instance deletes the existing root persistent disk
+            # and creates a new disk from the image that is defined in the
+            # instance template.
+        "refreshing": 42, # Output only. The number of instances in the managed instance group that
+            # are being reconfigured with properties that do not require a restart
+            # or a recreate action. For example, setting or removing target
+            # pools for the instance.
+        "restarting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be restarted or are currently being restarted.
+        "resuming": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be resumed or are currently being resumed.
+        "starting": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be started or are currently being started.
+        "stopping": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be stopped or are currently being stopped.
+        "suspending": 42, # Output only. The number of instances in the managed instance group that
+            # are scheduled to be suspended or are currently being suspended.
+        "verifying": 42, # Output only. The number of instances in the managed instance group that
+            # are being verified. See the managedInstances[].currentAction
+            # property in the listManagedInstances method documentation.
+      },
+      "description": "A String", # An optional description of this resource.
+      "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+          # zones in a regional managed instance group.
+        "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+            # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+        "zones": [ # Zones where the regional managed instance group will create and manage
+            # its instances.
+            # By default, a regional MIG doesn't automatically select an AI zone to create
+            # instances, even if an AI zone is available in the specified region. To
+            # create instances in an AI zone in the selected region, you must explicitly
+            # specify it in the distribution policy together with the other preferred
+            # zones.
+          {
+            "zone": "A String", # The URL of thezone.
+                # The zone must exist in the region where the managed instance group is
+                # located.
+          },
+        ],
+      },
+      "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+          # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+          # fingerprint must be provided in order to update the InstanceGroupManager,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an InstanceGroupManager.
+      "id": "A String", # Output only. A unique identifier for this resource type. The server
+          # generates this identifier.
+      "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+          # types of machines.
+          # Instance flexibility configuration on MIG overrides instance
+          # template configuration.
+        "instanceSelections": { # Named instance selections configuring properties that the group will use
+            # when creating new VMs.
+          "a_key": {
+            "disks": [ # List of disks to be attached to the instances created from this
+                # selection.
+              { # An instance-attached disk resource.
+                "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                    # or X86_64.
+                "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                    # deleted (but not when the disk is detached from the instance).
+                "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                    # partition of the disk for its root filesystem.
+                "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                    # running within the instance. This name can be used to reference the device
+                    # for mounting, resizing, and so on, from within the instance.
+                    #
+                    # If not specified, the server chooses a default device name to apply to this
+                    # disk, in the form persistent-disk-x, where x is a number
+                    # assigned by Google Compute Engine. This field is only applicable for
+                    # persistent disks.
+                "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                    # encryption key.
+                    #
+                    # If you are creating a new disk, this field encrypts the new disk using
+                    # an encryption key that you provide. If you are attaching an existing
+                    # disk that is already encrypted, this field decrypts the disk using
+                    # the customer-supplied encryption key.
+                    #
+                    # If you encrypt a disk using a customer-supplied key, you must provide the
+                    # same key again when you attempt to use this resource at a later time. For
+                    # example, you must provide the key when you create a snapshot or an image
+                    # from the disk or when you attach the disk to a virtual machine instance.
+                    #
+                    # If you do not provide an encryption key, then the disk will be encrypted
+                    # using an automatically generated key and you do not need to provide a key
+                    # to use the disk later.
+                    #
+                    # Note:
+                    #
+                    # Instance templates do not storecustomer-supplied
+                    # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                    #
+                    # You cannot create VMs that have disks with customer-supplied keys using
+                    # the bulk
+                    # insert method.
+                  "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                      # For example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      #
+                      # The fully-qualifed key name may be returned for resource GET requests. For
+                      # example:
+                      #
+                      # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                      # key_region/cryptoKeys/key
+                      # /cryptoKeyVersions/1
+                  "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                      # key. If absent, the Compute Engine default service account is used.
+                      # For example:
+                      #
+                      # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                  "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies a 256-bit customer-supplied
+                      # encryption key, encoded in RFC
+                      # 4648 base64 to either encrypt or decrypt this resource. You can
+                      # provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rawKey":
+                      # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                  "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                      # customer-supplied encryption key to either encrypt or decrypt this
+                      # resource. You can provide either the rawKey or thersaEncryptedKey.
+                      # For example:
+                      #
+                      # "rsaEncryptedKey":
+                      # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                      # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                      # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                      #
+                      # The key must meet the following requirements before you can provide it to
+                      # Compute Engine:
+                      #
+                      #    1. The key is wrapped using a RSA public key certificate provided by
+                      #    Google.
+                      #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                      #    encoding.
+                      #
+                      # Gets the RSA public key certificate provided by Google at:
+                      #
+                      #
+                      # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                  "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                      # [Output only] TheRFC
+                      # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                      # encryption key that protects this resource.
+                },
+                "diskSizeGb": "A String", # The size of the disk in GB.
+                "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                    # currently attached to another instance. If you try to force attach a zonal
+                    # disk to an instance, you will receive an error.
+                "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                    # only for bootable images. Read
+                    # Enabling guest operating system features to see a list of available
+                    # options.
+                  { # Guest OS features.
+                    "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                        # separate values. Set to one or more of the following values:
+                        #
+                        #    - VIRTIO_SCSI_MULTIQUEUE
+                        #    - WINDOWS
+                        #    - MULTI_IP_SUBNET
+                        #    - UEFI_COMPATIBLE
+                        #    - GVNIC
+                        #    - SEV_CAPABLE
+                        #    - SUSPEND_RESUME_COMPATIBLE
+                        #    - SEV_LIVE_MIGRATABLE_V2
+                        #    - SEV_SNP_CAPABLE
+                        #    - TDX_CAPABLE
+                        #    - IDPF
+                        #    - SNP_SVSM_CAPABLE
+                        #    - CCA_CAPABLE
+                        #    - SUSPEND_SAFE_FPR
+                        #
+                        #
+                        # For more information, see
+                        # Enabling guest operating system features.
+                  },
+                ],
+                "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                    # boot disk. If you have many disks attached to an instance, each
+                    # disk would have a unique index number.
+                "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                    # alongside the new instance. Use initialization parameters to create boot
+                    # disks or local SSDs attached to the new instance.
+                    #
+                    # This field is persisted and returned for instanceTemplate and not returned
+                    # in the context of instance.
+                    #
+                    # This property is mutually exclusive with the source property;
+                    # you can only define one or the other, but not both.
+                  "architecture": "A String", # The architecture of the attached disk. Valid values are
+                      # arm64 or x86_64.
+                  "description": "A String", # An optional description. Provide this property when creating the disk.
+                  "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                      # of the instance. If a disk with the same name already exists in the given
+                      # region, the existing disk is attached to the new instance and the
+                      # new disk is not created.
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                      # 10 GB. If you specify a sourceImage, which is required for
+                      # boot disks, the default size is the size of the sourceImage.
+                      # If you do not specify a sourceImage, the default disk size
+                      # is 500 GB.
+                  "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                      # disk. For valid disk type values, see
+                      # Supported types for Hyperdisk volumes and
+                      # Persistent Disk type variables.
+                      #
+                      # When creating a single instance, you must provide either the full or
+                      # partial URL of the disk type. For example, the following values are
+                      # valid:
+                      #
+                      #
+                      #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                      #      - projects/project/zones/zone/diskTypes/diskType
+                      #      - zones/zone/diskTypes/diskType
+                      #
+                      #
+                      #
+                      # When creating an instance template, instance flexibility policy, or when
+                      # creating or updating an all-instances configuration, you specify the
+                      # disk type without a URL, for example, hyperdisk-balanced.
+                      #
+                      # If you omit this field for a disk, the default disk type depends on
+                      # the instance's machine series, as follows.
+                      #
+                      #
+                      #     - For first- and second-generation machine series like N1, N2, T2, and
+                      #     M1, the
+                      #        default disk type is Standard Persistent Disk
+                      #        (pd-standard).
+                      #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                      #     (pd-balanced).
+                      #    - For other third-generation machine
+                      #     series like A3, H3, Z3, all
+                      #         fourth-generation types like C4, N4, M4, and newer machine series,
+                      #         the default is Hyperdisk Balanced
+                      #         (hyperdisk-balanced).
+                      #
+                      #
+                      #
+                      # The disk type you specify must be compatible with the instance's machine
+                      # series. For a list of machine series that support Persistent Disk, see Machine
+                      # series support for Persistent Disk.
+                      #
+                      # For a list of machine series that support Hyperdisk, seeMachine
+                      # series support for Hyperdisk.
+                  "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+                  "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                      # persistent disks.
+                    "a_key": "A String",
+                  },
+                  "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                    "A String",
+                  ],
+                  "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                      # is to use the existing disk.
+                  "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                      # of I/O operations per second that the disk can handle. Values must be
+                      # between 10,000 and 120,000. For more details, see theExtreme persistent
+                      # disk documentation.
+                  "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                      # number of throughput mb per second that the disk can handle. Values must
+                      # greater than or equal to 1.
+                  "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                      # the URLs of the zones where the disk should be replicated to.
+                      # You must provide exactly two replica zones, and one zone must be the same
+                      # as the instance zone.
+                    "A String",
+                  ],
+                  "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/{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",
+                  },
+                  "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                      # Specified using the full or partial URL. For instance template, specify
+                      # only the resource policy name.
+                    "A String",
+                  ],
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                      # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                      # is required.
+                      #
+                      # To create a disk with one of the public operating system
+                      # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                      #
+                      # projects/debian-cloud/global/images/family/debian-9
+                      #
+                      #
+                      # Alternatively, use a specific version of a public operating system image:
+                      #
+                      # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                      #
+                      #
+                      # To create a disk with a custom image that you created, specify the
+                      # image name in the following format:
+                      #
+                      # global/images/my-custom-image
+                      #
+                      #
+                      # You can also specify a custom image by its image family, which returns
+                      # the latest version of the image in that family. Replace the image name
+                      # with family/family-name:
+                      #
+                      # global/images/family/my-image-family
+                      #
+                      #
+                      # If the source image is deleted later, this field will not be set.
+                  "sourceImageEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source image. Required if the source image is
+                      # protected by a customer-supplied encryption key.
+                      #
+                      # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                      # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                      # source images are encrypted with your own keys.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                      # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                      # is required.
+                      #
+                      # To create a disk with a snapshot that you created, specify the
+                      # snapshot name in the following format:
+                      #
+                      # global/snapshots/my-backup
+                      #
+                      #
+                      # If the source snapshot is deleted later, this field will not be set.
+                      #
+                      # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                      # an image instead when you create VMs using
+                      # the bulk
+                      # insert method.
+                  "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                      # encryption key of the source snapshot.
+                    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                        # For example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        #
+                        # The fully-qualifed key name may be returned for resource GET requests. For
+                        # example:
+                        #
+                        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                        # key_region/cryptoKeys/key
+                        # /cryptoKeyVersions/1
+                    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                        # key. If absent, the Compute Engine default service account is used.
+                        # For example:
+                        #
+                        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies a 256-bit customer-supplied
+                        # encryption key, encoded in RFC
+                        # 4648 base64 to either encrypt or decrypt this resource. You can
+                        # provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rawKey":
+                        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                        # customer-supplied encryption key to either encrypt or decrypt this
+                        # resource. You can provide either the rawKey or thersaEncryptedKey.
+                        # For example:
+                        #
+                        # "rsaEncryptedKey":
+                        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                        #
+                        # The key must meet the following requirements before you can provide it to
+                        # Compute Engine:
+                        #
+                        #    1. The key is wrapped using a RSA public key certificate provided by
+                        #    Google.
+                        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                        #    encoding.
+                        #
+                        # Gets the RSA public key certificate provided by Google at:
+                        #
+                        #
+                        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                        # [Output only] TheRFC
+                        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                        # encryption key that protects this resource.
+                  },
+                  "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                      #      - projects/project/zones/zone/storagePools/storagePool
+                      #    - zones/zone/storagePools/storagePool
+                },
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                    # either SCSI or NVME. For most machine types, the
+                    # default is SCSI. Local SSDs can use either NVME or SCSI.
+                    # In certain configurations, persistent disks can use NVMe. For more
+                    # information, seeAbout
+                    # persistent disks.
+                "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+                "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+                  "A String",
+                ],
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                    # in READ_WRITE mode.
+                "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                    # field is set to PRESERVED if the LocalSSD data has been saved
+                    # to a persistent location by customer request.  (see the
+                    # discard_local_ssd option on Stop/Suspend).
+                    # Read-only in the api.
+                "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                    # these are public keys which are safe to store in public
+                  "dbs": [ # The Key Database (db).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "dbxs": [ # The forbidden key database (dbx).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "keks": [ # The Key Exchange Key (KEK).
+                    {
+                      "content": "A String", # The raw content in the secure keys file.
+                      "fileType": "A String", # The file type of source file.
+                    },
+                  ],
+                  "pk": { # The Platform Key (PK).
+                    "content": "A String", # The raw content in the secure keys file.
+                    "fileType": "A String", # The file type of source file.
+                  },
+                },
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                    # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                    # is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using
+                    # this property. This field is only applicable for persistent disks.
+                    #
+                    # 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.
+              },
+            ],
+            "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+              "A String",
+            ],
+            "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+                # e.g. 'Intel Ice Lake'.
+            "rank": 42, # Preference of this instance selection. Lower number means higher
+                # preference. MIG will first try to create a VM based on the machine-type
+                # with lowest rank and fallback to next rank based on availability.
+                # Machine types and instance selections with the same rank have the same
+                # preference.
+          },
+        },
+      },
+      "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+      "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+        "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+            # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+            # applies to the VMs on which your application fails a health check.
+            # Valid values are
+            #
+            #    - REPAIR (default): MIG automatically repairs a failed VM
+            #    by recreating it. For more information, see About
+            #    repairing VMs in a MIG.
+            #    - DO_NOTHING: MIG does not repair a failed VM.
+        "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+            # configuration when repairing a VM. Valid options are:
+            #
+            #
+            #
+            #      -  NO (default): If configuration updates are available, they are not
+            #      forcefully applied during repair. Instead, configuration updates are
+            #      applied according to the group's update policy.
+            #
+            #      -  YES: If configuration updates are available, they are applied
+            #      during repair.
+        "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+            # unhealthy when the application running on that VM fails a health check.
+            # Valid values are:
+            #
+            #    - DEFAULT_ACTION (default): MIG uses the same action
+            #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+            #    - REPAIR: MIG automatically repairs an unhealthy VM by
+            #    recreating it.
+            #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+            #    For more information, see
+            #    About repairing VMs in a MIG.
+        "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+          "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+              # Valid values are:
+              #
+              #    - NO (default): MIG cannot change a VM's zone during a
+              #    repair.
+              #    - YES: MIG can select a different zone for the VM during
+              #    a repair.
+        },
+      },
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create all new instances
+          # in the managed instance group. The templates for existing instances in the
+          # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+      "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+      "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+          # this managed instance group.
+      "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+          # to this Instance Group Manager.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the managed instance group resides (for regional resources).
+      "resourcePolicies": { # Resource policies for this managed instance group.
+        "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+            # instance group.
+            # It can be a full or partial URL. For example, the following are
+            # all valid URLs to a workload policy:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+            #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+            #       - regions/region/resourcePolicies/resourcePolicy
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. Reserved for future use.
+      "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+          # this URL.
+      "standbyPolicy": { # Standby policy for stopped and suspended instances.
+        "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+            # stop a VM after that VM was created. The initial delay gives the
+            # initialization script the time to prepare your VM for a quick scale out.
+            # The value of initial delay must be between 0 and 3600 seconds. The
+            # default value is 0.
+        "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+            # group scales out. The default mode is `MANUAL`.
+      },
+      "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+        "preservedState": { # Configuration of preserved resources.
+          "disks": { # Disks created on the instances that will be preserved on instance
+              # delete, update, etc. This map is keyed with the device names of
+              # the disks.
+            "a_key": {
+              "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the disk should be deleted after it
+                  # is no longer used by the group, e.g. when the given instance or
+                  # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+            },
+          },
+          "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+              # instance delete, update, etc. This map is keyed with the network
+              # interface name.
+            "a_key": {
+              "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the IP reservation should be deleted
+                  # after it is no longer used by the group, e.g. when the given instance
+                  # or the whole group is deleted.
+            },
+          },
+          "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+              # instance delete, update, etc. This map is keyed with the network
+              # interface name.
+            "a_key": {
+              "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                  # update or VM instance recreate operations.
+                  # This flag is used to configure if the IP reservation should be deleted
+                  # after it is no longer used by the group, e.g. when the given instance
+                  # or the whole group is deleted.
+            },
+          },
+        },
+      },
+      "status": { # Output only. The status of this managed instance group.
+        "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+          "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+              # This value is in RFC3339 text format.
+          "effective": True or False, # Output only. A bit indicating whether this configuration has
+              # been applied to all managed instances in the group.
+        },
+        "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+            # Currently only one accelerator topology is supported.
+          {
+            "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+                # The value is the same as configured in the WorkloadPolicy.
+            "state": "A String", # Output only. The state of the accelerator topology.
+            "stateDetails": { # Output only. The result of the latest accelerator topology state
+                # check.
+              "error": { # Output only. Encountered errors.
+                "errors": [ # [Output Only] The array of errors encountered while processing this
+                    # operation.
+                  { # Represents a single error encountered during the processing of an
+                      # 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.
+                      { # Container for structured error details providing additional context
+                          # specific to the encountered error code.
+                        "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                            #
+                            # 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. # Links and information to help the user resolve the error.
+                            #
+                            # 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 # A localized human-readable error message intended for end users.
+                            # 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. # Details about quota limits and metrics when a quota is exceeded.
+                          "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.
+                  },
+                ],
+              },
+              "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+                  # has // RFC3339 //
+                  # text format.
+            },
+          },
+        ],
+        "autoscaler": "A String", # Output only. The URL of theAutoscaler
+            # that targets this instance group manager.
+        "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+            # targetSizePolicy.mode is set to BULK.
+          "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+          "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+              # operation.
+            "error": { # Output only. Errors encountered during bulk instance operation.
+              "errors": [ # [Output Only] The array of errors encountered while processing this
+                  # operation.
+                { # Represents a single error encountered during the processing of an
+                    # 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.
+                    { # Container for structured error details providing additional context
+                        # specific to the encountered error code.
+                      "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                          #
+                          # 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. # Links and information to help the user resolve the error.
+                          #
+                          # 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 # A localized human-readable error message intended for end users.
+                          # 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. # Details about quota limits and metrics when a quota is exceeded.
+                        "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.
+                },
+              ],
+            },
+            "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+                # operation. Timestamp is in RFC3339 text format.
+          },
+        },
+        "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+            # in this managed instance group that have the status. Currently only shown
+            # for TPU MIGs
+            # instance group that have the status. For more information about how to
+            # interpret each status check the instance lifecycle documentation.
+            # Currently only shown for TPU MIGs.
+          "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+              # that have DEPROVISIONING status.
+          "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+              # have been deleted. Includes only instances that would be shown in the
+              # listManagedInstances method and not all instances that have been
+              # deleted in the lifetime of the MIG.
+              # Does not include FlexStart instances that are waiting for the resources
+              # availability, they are considered as 'pending'.
+          "pending": 42, # Output only. The number of instances in the managed instance group
+              # that have PENDING status, that is FlexStart instances that are waiting
+              # for resources. Instances that do not exist because of the other reasons
+              # are counted as 'non_existent'.
+          "pendingStop": 42, # Output only. The number of instances in the managed instance group
+              # that have PENDING_STOP status.
+          "provisioning": 42, # Output only. The number of instances in the managed instance group
+              # that have PROVISIONING status.
+          "repairing": 42, # Output only. The number of instances in the managed instance group
+              # that have REPAIRING status.
+          "running": 42, # Output only. The number of instances in the managed instance group
+              # that have RUNNING status.
+          "staging": 42, # Output only. The number of instances in the managed instance group
+              # that have STAGING status.
+          "stopped": 42, # Output only. The number of instances in the managed instance group
+              # that have STOPPED status.
+          "stopping": 42, # Output only. The number of instances in the managed instance group
+              # that have STOPPING status.
+          "suspended": 42, # Output only. The number of instances in the managed instance group
+              # that have SUSPENDED status.
+          "suspending": 42, # Output only. The number of instances in the managed instance group
+              # that have SUSPENDING status.
+          "terminated": 42, # Output only. The number of instances in the managed instance group
+              # that have TERMINATED status.
+        },
+        "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+            # stable state. A stable state means that: none of the instances in the
+            # managed instance group is currently undergoing any type of change (for
+            # example, creation, restart, or deletion); no future changes are scheduled
+            # for instances in the managed instance group; and the managed instance
+            # group itself is not being modified.
+        "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+          "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+              # has stateful configuration, that is, if you have configured any items
+              # in a stateful policy or in per-instance configs.
+              # The group might report that it has no stateful configuration even when
+              # there is still some preserved state on a managed instance, for example,
+              # if you have deleted all PICs but not yet applied those deletions.
+          "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+            "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+                # (listed in the output of a listPerInstanceConfigs API call) have
+                # status EFFECTIVE or there are no per-instance-configs.
+          },
+        },
+        "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+            # target version specified by version field on Instance Group
+            # Manager.
+          "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+              # in this managed instance group, i.e. all instances are in their target
+              # version. Instances' target version are specified byversion field on Instance Group Manager.
+        },
+      },
+      "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+          # apply to all of the instances in the managed instance group.
+        "A String",
+      ],
+      "targetSize": 42, # The target number of running instances for this managed instance group.
+          # You can reduce this number by using the instanceGroupManager
+          # deleteInstances or abandonInstances methods. Resizing the group also
+          # changes this number.
+      "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+          # size.
+        "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+            # individually or all at once.
+      },
+      "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+          # This number changes when you:
+          #
+          #    - Stop instance using the stopInstances
+          #    method or start instances using the startInstances
+          #    method.
+          #    - Manually change the targetStoppedSize using the update
+          #    method.
+      "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+          # This number changes when you:
+          #
+          #    - Suspend instance using the suspendInstances
+          #    method or resume instances using the resumeInstances
+          #    method.
+          #    - Manually change the targetSuspendedSize using the update
+          #    method.
+      "updatePolicy": { # The update policy for this managed instance group.
+        "instanceRedistributionType": "A String", # The
+            # instance redistribution policy for regional managed instance groups.
+            # Valid values are:
+            #
+            #    - PROACTIVE (default): The group attempts to maintain an
+            #    even distribution of VM instances across zones in the region.
+            #    - NONE: For non-autoscaled groups, proactive
+            #    redistribution is disabled.
+        "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+            # either a fixed number or, if the group has 10 or more instances, a
+            # percentage. If you set a percentage, the number of instances is rounded
+            # if necessary.  The default value for maxSurge is a fixed
+            # value equal to the number of zones in which the managed instance group
+            # operates.
+            #
+            # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+          "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+              #
+              #
+              #
+              #     - If the value is fixed, then the calculated
+              #      value is equal to the fixed value.
+              #     - If the value is a percent, then the
+              #     calculated
+              #      value is percent/100 * targetSize. For example,
+              #      the calculated value of a 80% of a managed instance group
+              #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+              #      is a remainder, the number is rounded.
+          "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+          "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+              # example, specify 80 for 80%.
+        },
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+            # process. An instance is considered available if all of the following
+            # conditions are satisfied:
+            #
+            #
+            #
+            #      - The instance's status is
+            #      RUNNING.
+            #    - If there is a health
+            #      check on the instance group, the instance's health check status
+            #      must be HEALTHY at least once. If there is no health check
+            #      on the group, then the instance only needs to have a status of
+            #      RUNNING to be considered available.
+            #
+            #
+            # This value can be either a fixed number or, if the group has 10 or more
+            # instances, a percentage. If you set a percentage, the number of instances
+            # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+            # in which the managed instance group operates.
+            #
+            # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+          "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+              #
+              #
+              #
+              #     - If the value is fixed, then the calculated
+              #      value is equal to the fixed value.
+              #     - If the value is a percent, then the
+              #     calculated
+              #      value is percent/100 * targetSize. For example,
+              #      the calculated value of a 80% of a managed instance group
+              #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+              #      is a remainder, the number is rounded.
+          "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+          "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+              # example, specify 80 for 80%.
+        },
+        "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+            # disruption as much as possible or to apply a more disruptive action than
+            # is necessary.
+            #
+            #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+            #    Compute Engine performs the necessary action to execute the update.
+            #    - To apply a more disruptive action than is strictly necessary, set the
+            #    minimal action to RESTART or REPLACE. For
+            #    example, Compute Engine does not need to restart a VM to change its
+            #    metadata. But if your application reads instance metadata only when a VM
+            #    is restarted, you can set the minimal action to RESTART in
+            #    order to pick up metadata changes.
+        "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+            # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+            # as much as possible. RESTART to allow actions that can be
+            # applied without instance replacing or REPLACE to allow all
+            # possible actions. If the Updater determines that the minimal update
+            # action needed is more disruptive than most disruptive allowed action you
+            # specify it will not perform the update at all.
+        "replacementMethod": "A String", # What action should be used to replace instances.
+            # See minimal_action.REPLACE
+        "type": "A String", # The type
+            # of update process. You can specify either PROACTIVE so
+            # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+            # to update.
+      },
+      "versions": [ # Specifies the instance templates used by this managed instance group to
+          # create instances.
+          #
+          # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+          # group. This field overrides the top-level instanceTemplate
+          # field. Read more about therelationships
+          # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+          # remaining instances. For more information, read aboutcanary
+          # updates.
+        {
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+              # instance group. The group uses this template to create new instances in
+              # the managed instance group until the `targetSize` for this version is
+              # reached. The templates for existing instances in the group do not change
+              # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+              # existing instances are updated until the `targetSize` for this version is
+              # reached.
+          "name": "A String", # Name of the version. Unique among all versions in the scope of this
+              # managed instance group.
+          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+              # from the template will be equal to:
+              #
+              #
+              #      - If expressed as a fixed number, the minimum of either
+              #       targetSize.fixed or
+              #       instanceGroupManager.targetSize is used.
+              #      - if expressed as a percent, the targetSize
+              #      would be (targetSize.percent/100 *
+              #      InstanceGroupManager.targetSize) If there is a remainder, the
+              #      number is rounded.
+              #
+              #  If unset, this version will update any remaining instances not
+              # updated by another version. ReadStarting
+              # a canary update for more information.
+            "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+                #
+                #
+                #
+                #     - If the value is fixed, then the calculated
+                #      value is equal to the fixed value.
+                #     - If the value is a percent, then the
+                #     calculated
+                #      value is percent/100 * targetSize. For example,
+                #      the calculated value of a 80% of a managed instance group
+                #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+                #      is a remainder, the number is rounded.
+            "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+            "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+                # example, specify 80 for 80%.
+          },
+        },
+      ],
+      "zone": "A String", # Output only. The URL of azone
+          # where the managed instance group is located (for zonal resources).
+    },
+  ],
+  "kind": "compute#regionInstanceGroupManagerList", # Output only. The resource type, which is always compute#instanceGroupManagerList for a
+      # list of managed instance groups that exist in th regional scope.
+  "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.
+  },
+}
+
+ +
+ listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all errors thrown by actions on instances for a given regional
+managed instance group. The filter andorderBy query parameters are not supported.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request.
+This should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+It must be a string that meets the requirements in RFC1035, or an
+unsigned long integer: must match regexp pattern:
+(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "items": [ # [Output Only] The list of errors of the managed instance group.
+    {
+      "error": { # Output only. Contents of the error.
+        "code": "A String", # Output only. Error code.
+        "message": "A String", # Output only. Error message.
+      },
+      "instanceActionDetails": { # Output only. Details of the instance action that triggered this error.
+          # May be null, if the error was not caused by an action on an instance.
+          # This field is optional.
+        "action": "A String", # Output only. Action that managed instance group was executing on the instance when the
+            # error occurred. Possible values:
+        "instance": "A String", # Output only. The URL of the instance. The URL can be set even if the instance has not
+            # yet been created.
+        "version": { # Output only. Version this instance was created from, or was being
+            # created from, but the creation failed. Corresponds to one of the versions
+            # that were set on the Instance Group Manager resource at the time this
+            # instance was being created.
+          "instanceTemplate": "A String", # Output only. [Output Only] The intended template of the instance. This field is empty
+              # when current_action is one of { DELETING, ABANDONING }.
+          "name": "A String", # Output only. [Output Only] Name of the version.
+        },
+      },
+      "timestamp": "A String", # Output only. The time that this error occurred. This value is in RFC3339 text format.
+    },
+  ],
+  "nextPageToken": "A String", # Output only. [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.
+}
+
+ +
+ listErrors_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.
+
+
+ +
+ listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the instances in the managed instance group and instances that are
+scheduled to be created. The list includes any current actions
+that the group has scheduled for its instances. The orderBy
+query parameter is not supported.   The `pageToken` query parameter is
+supported only if the group's `listManagedInstancesResults` field is set
+to `PAGINATED`.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the managed instance group. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "managedInstances": [ # A list of managed instances.
+    { # A Managed Instance resource.
+      "currentAction": "A String", # Output only. [Output Only] The current action that the managed instance group has
+          # scheduled for the instance. Possible values:
+          #
+          #    - NONE The instance is running, and the managed
+          #    instance group does not have any scheduled actions for this instance.
+          #    - CREATING The managed instance group is creating this
+          #    instance. If the group fails to create this instance, it will try again
+          #    until it is successful.
+          #    - CREATING_WITHOUT_RETRIES The managed instance group
+          #    is attempting to create this instance only once. If the group fails
+          #    to create this instance, it does not try again and the group'stargetSize value is decreased instead.
+          #    - RECREATING The managed instance group is recreating
+          #    this instance.
+          #    - DELETING The managed instance group is permanently
+          #    deleting this instance.
+          #    - ABANDONING The managed instance group is abandoning
+          #    this instance. The instance will be removed from the instance group
+          #    and from any target pools that are associated with this group.
+          #    - RESTARTING The managed instance group is restarting
+          #    the instance.
+          #    - REFRESHING The managed instance group is applying
+          #    configuration changes to the instance without stopping it. For example,
+          #    the group can update the target pool list for an instance without
+          #    stopping that instance.
+          #    - VERIFYING The managed instance group has created the
+          #    instance and it is in the process of being verified.
+      "id": "A String", # Output only. [Output only] The unique identifier for this resource. This field is empty
+          # when instance does not exist.
+      "instance": "A String", # Output only. [Output Only] The URL of the instance. The URL can exist even if the
+          # instance has not yet been created.
+      "instanceHealth": [ # Output only. [Output Only] Health state of the instance per health-check.
+        {
+          "detailedHealthState": "A String", # Output only. [Output Only] The current detailed instance health state.
+          "healthCheck": "A String", # Output only. [Output Only] The URL for the health check that verifies whether the
+              # instance is healthy.
+        },
+      ],
+      "instanceStatus": "A String", # Output only. [Output Only] The status of the instance. This field is empty when
+          # the instance does not exist.
+      "lastAttempt": { # Output only. [Output Only] Information about the last attempt to create or delete
+          # the instance.
+        "errors": { # Output only. [Output Only] Encountered errors during the last attempt to create or
+            # delete the instance.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+      },
+      "name": "A String", # Output only. [Output Only] The name of the instance. The name always exists even if the
+          # instance has not yet been created.
+      "preservedStateFromConfig": { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
+          # for this instance.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "preservedStateFromPolicy": { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
+          # for this instance.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "propertiesFromFlexibilityPolicy": { # Output only. [Output Only] Instance properties selected for this instance resulting from
+          # InstanceFlexibilityPolicy.
+        "disks": [ # List of disks to be attached to the instance.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineType": "A String", # Output only. The machine type to be used for this instance.
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance.
+            # e.g. 'Intel Ice Lake'.
+      },
+      "scheduling": { # Output only. Information about the termination timestamp of the instance, if applicable.
+        "gracefulShutdownTimestamp": "A String", # Output only. The timestamp at which the underlying instance will be
+            # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
+        "terminationTimestamp": "A String", # Output only. The timestamp at which the managed instance will be terminated. This is
+            # in RFC3339 text
+            # format.
+      },
+      "shutdownDetails": { # Output only. Specifies the graceful shutdown details if the instance is in
+          # `PENDING_STOP` state or there is a programmed stop scheduled.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # Output only. The duration for graceful shutdown. Only applicable when the instance is
+            # in `PENDING_STOP` state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestTimestamp": "A String", # Output only. Past timestamp indicating the beginning of `PENDING_STOP` state of
+            # instance in RFC3339
+            # text format.
+      },
+      "targetStatus": "A String", # Output only. The eventual status of the instance. The instance group
+          # manager will not be identified as stable till each managed instance reaches
+          # its targetStatus.
+      "version": { # Output only. [Output Only] Intended version of this instance.
+        "instanceTemplate": "A String", # Output only. [Output Only] The intended template of the instance. This field is empty
+            # when current_action is one of { DELETING, ABANDONING }.
+        "name": "A String", # Output only. [Output Only] Name of the version.
+      },
+    },
+  ],
+  "nextPageToken": "A String", # Output only. [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.
+}
+
+ +
+ listManagedInstances_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.
+
+
+ +
+ listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all of the per-instance configurations defined for the managed
+instance group. The orderBy query parameter is not supported.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request, should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group. It 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "items": [ # Output only. [Output Only] The list of PerInstanceConfig.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listPerInstanceConfigs_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, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Updates a managed instance group using the information that you specify
+in the request.
+This operation is marked as DONE when the group is patched
+even if the instances in the group are still in the process of being
+patched. You must separately verify the status of the individual instances
+with the listmanagedinstances
+method. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules.
+
+If you update your group to specify a new template or instance
+configuration, it's possible that your intended specification for each VM
+in the group is different from the current state of that VM. To learn how
+to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
+a MIG.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the instance group manager. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Managed Instance Group resource.
+    # 
+    # An instance group is a collection of VM instances that you can manage as a
+    # single entity. For more information, readInstance groups.
+    # 
+    # For zonal Managed Instance Group, use the instanceGroupManagers
+    # resource.
+    # 
+    # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
+  "allInstancesConfig": { # Specifies configuration that overrides the instance template configuration
+      # for the group.
+    "properties": { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
+        #
+        # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's
+        # instances to apply the configuration. To apply the configuration, set the
+        # group's updatePolicy.type field to use proactive updates or
+        # use the applyUpdatesToInstances method.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID.
+      "labels": { # The label key-value pairs that you want to patch onto the instance.
+        "a_key": "A String",
+      },
+      "metadata": { # The metadata key-value pairs that you want to patch onto the instance. For
+          # more information, see Project and
+          # instance metadata.
+        "a_key": "A String",
+      },
+    },
+  },
+  "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify
+      # only one value.
+    {
+      "healthCheck": "A String", # The URL for the health check that signals autohealing.
+      "initialDelaySec": 42, # The initial delay is the number of seconds that a new VM takes to
+          # initialize and run its startup script. During a VM's initial delay
+          # period, the MIG ignores unsuccessful health checks because the VM might
+          # be in the startup process. This prevents the MIG from prematurely
+          # recreating a VM. If the health check receives a healthy response during
+          # the initial delay, it indicates that the startup process is complete and
+          # the VM is ready. The value of initial delay must be between 0 and 3600
+          # seconds. The default value is 0.
+    },
+  ],
+  "baseInstanceName": "A String", # The base instance name is a prefix that you want to attach to the names of
+      # all VMs in a MIG. The maximum character length is 58 and the name must
+      # comply with RFC1035 format.
+      # 
+      # When a VM is created in the group, the MIG appends a hyphen and a random
+      # four-character string to the base instance name. If you want the MIG to
+      # assign sequential numbers instead of a random string, then end the base
+      # instance name with a hyphen followed by one or more hash symbols. The hash
+      # symbols indicate the number of digits. For example, a base instance name of
+      # "vm-###" results in "vm-001" as a VM name.
+      # @pattern
+      # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
+  "creationTimestamp": "A String", # Output only. The creation timestamp for this managed instance group inRFC3339
+      # text format.
+  "currentActions": { # Output only. The list of instance actions and the number of instances
+      # in this managed instance group that are scheduled for each of those
+      # actions.
+    "abandoning": 42, # Output only. The total number of instances in the managed instance group
+        # that are scheduled to be abandoned. Abandoning an instance removes it
+        # from the managed instance group without deleting it.
+    "creating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be created or are currently being created. If the group
+        # fails to create any of these instances, it tries again until it creates
+        # the instance successfully.
+        #
+        # If you have disabled creation retries, this field will not be populated;
+        # instead, the creatingWithoutRetries field will be populated.
+    "creatingWithoutRetries": 42, # Output only. The number of instances that the managed instance group
+        # will attempt to create. The group attempts to create each instance
+        # only once. If the group fails to create any of these instances, it
+        # decreases the group's targetSize value accordingly.
+    "deleting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be deleted or are currently being deleted.
+    "none": 42, # Output only. The number of instances in the managed instance group that
+        # are running and have no scheduled actions.
+    "recreating": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be recreated or are currently being being recreated.
+        # Recreating an instance deletes the existing root persistent disk
+        # and creates a new disk from the image that is defined in the
+        # instance template.
+    "refreshing": 42, # Output only. The number of instances in the managed instance group that
+        # are being reconfigured with properties that do not require a restart
+        # or a recreate action. For example, setting or removing target
+        # pools for the instance.
+    "restarting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be restarted or are currently being restarted.
+    "resuming": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be resumed or are currently being resumed.
+    "starting": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be started or are currently being started.
+    "stopping": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be stopped or are currently being stopped.
+    "suspending": 42, # Output only. The number of instances in the managed instance group that
+        # are scheduled to be suspended or are currently being suspended.
+    "verifying": 42, # Output only. The number of instances in the managed instance group that
+        # are being verified. See the managedInstances[].currentAction
+        # property in the listManagedInstances method documentation.
+  },
+  "description": "A String", # An optional description of this resource.
+  "distributionPolicy": { # Policy specifying the intended distribution of managed instances across
+      # zones in a regional managed instance group.
+    "targetShape": "A String", # The distribution shape to which the group converges either proactively or
+        # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
+    "zones": [ # Zones where the regional managed instance group will create and manage
+        # its instances.
+        # By default, a regional MIG doesn't automatically select an AI zone to create
+        # instances, even if an AI zone is available in the specified region. To
+        # create instances in an AI zone in the selected region, you must explicitly
+        # specify it in the distribution policy together with the other preferred
+        # zones.
+      {
+        "zone": "A String", # The URL of thezone.
+            # The zone must exist in the region where the managed instance group is
+            # located.
+      },
+    ],
+  },
+  "fingerprint": "A String", # Fingerprint of this resource. This field may be used in optimistic locking.
+      # It will be ignored when inserting an InstanceGroupManager. An up-to-date
+      # fingerprint must be provided in order to update the InstanceGroupManager,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an InstanceGroupManager.
+  "id": "A String", # Output only. A unique identifier for this resource type. The server
+      # generates this identifier.
+  "instanceFlexibilityPolicy": { # Instance flexibility allowing MIG to create VMs from multiple
+      # types of machines.
+      # Instance flexibility configuration on MIG overrides instance
+      # template configuration.
+    "instanceSelections": { # Named instance selections configuring properties that the group will use
+        # when creating new VMs.
+      "a_key": {
+        "disks": [ # List of disks to be attached to the instances created from this
+            # selection.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16".
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": 42, # Preference of this instance selection. Lower number means higher
+            # preference. MIG will first try to create a VM based on the machine-type
+            # with lowest rank and fallback to next rank based on availability.
+            # Machine types and instance selections with the same rank have the same
+            # preference.
+      },
+    },
+  },
+  "instanceGroup": "A String", # Output only. The URL of the Instance Group resource.
+  "instanceLifecyclePolicy": { # The repair policy for this managed instance group.
+    "defaultActionOnFailure": "A String", # The action that a MIG performs on a failed VM. If the value of the
+        # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
+        # applies to the VMs on which your application fails a health check.
+        # Valid values are
+        #
+        #    - REPAIR (default): MIG automatically repairs a failed VM
+        #    by recreating it. For more information, see About
+        #    repairing VMs in a MIG.
+        #    - DO_NOTHING: MIG does not repair a failed VM.
+    "forceUpdateOnRepair": "A String", # A bit indicating whether to forcefully apply the group's latest
+        # configuration when repairing a VM. Valid options are:
+        #
+        #
+        #
+        #      -  NO (default): If configuration updates are available, they are not
+        #      forcefully applied during repair. Instead, configuration updates are
+        #      applied according to the group's update policy.
+        #
+        #      -  YES: If configuration updates are available, they are applied
+        #      during repair.
+    "onFailedHealthCheck": "A String", # The action that a MIG performs on an unhealthy VM. A VM is marked as
+        # unhealthy when the application running on that VM fails a health check.
+        # Valid values are:
+        #
+        #    - DEFAULT_ACTION (default): MIG uses the same action
+        #    configured for instanceLifecyclePolicy.defaultActionOnFailure field.
+        #    - REPAIR: MIG automatically repairs an unhealthy VM by
+        #    recreating it.
+        #    - DO_NOTHING: MIG doesn't repair an unhealthy VM.
+        #    For more information, see
+        #    About repairing VMs in a MIG.
+    "onRepair": { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
+      "allowChangingZone": "A String", # Specifies whether the MIG can change a VM's zone during a repair.
+          # Valid values are:
+          #
+          #    - NO (default): MIG cannot change a VM's zone during a
+          #    repair.
+          #    - YES: MIG can select a different zone for the VM during
+          #    a repair.
+    },
+  },
+  "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+      # instance group. The group uses this template to create all new instances
+      # in the managed instance group. The templates for existing instances in the
+      # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
+  "kind": "compute#instanceGroupManager", # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
+  "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for
+      # this managed instance group.
+  "name": "A String", # The name of the managed instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # [Output Only] Named ports configured on the Instance Groups complementary
+      # to this Instance Group Manager.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the managed instance group resides (for regional resources).
+  "resourcePolicies": { # Resource policies for this managed instance group.
+    "workloadPolicy": "A String", # The URL of the workload policy that is specified for this managed
+        # instance group.
+        # It can be a full or partial URL. For example, the following are
+        # all valid URLs to a workload policy:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - projects/project/regions/region/resourcePolicies/resourcePolicy
+        #       - regions/region/resourcePolicies/resourcePolicy
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. Reserved for future use.
+  "selfLink": "A String", # Output only. The URL for this managed instance group. The server defines
+      # this URL.
+  "standbyPolicy": { # Standby policy for stopped and suspended instances.
+    "initialDelaySec": 42, # Specifies the number of seconds that the MIG should wait to suspend or
+        # stop a VM after that VM was created. The initial delay gives the
+        # initialization script the time to prepare your VM for a quick scale out.
+        # The value of initial delay must be between 0 and 3600 seconds. The
+        # default value is 0.
+    "mode": "A String", # Defines how a MIG resumes or starts VMs from a standby pool when the
+        # group scales out. The default mode is `MANUAL`.
+  },
+  "statefulPolicy": { # Stateful configuration for this Instanced Group Manager
+    "preservedState": { # Configuration of preserved resources.
+      "disks": { # Disks created on the instances that will be preserved on instance
+          # delete, update, etc. This map is keyed with the device names of
+          # the disks.
+        "a_key": {
+          "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the disk should be deleted after it
+              # is no longer used by the group, e.g. when the given instance or
+              # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
+        },
+      },
+      "externalIPs": { # External network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+      "internalIPs": { # Internal network IPs assigned to the instances that will be preserved on
+          # instance delete, update, etc. This map is keyed with the network
+          # interface name.
+        "a_key": {
+          "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+              # update or VM instance recreate operations.
+              # This flag is used to configure if the IP reservation should be deleted
+              # after it is no longer used by the group, e.g. when the given instance
+              # or the whole group is deleted.
+        },
+      },
+    },
+  },
+  "status": { # Output only. The status of this managed instance group.
+    "allInstancesConfig": { # Output only. Status of all-instances configuration on the group.
+      "currentRevision": "A String", # Output only. Current all-instances configuration revision.
+          # This value is in RFC3339 text format.
+      "effective": True or False, # Output only. A bit indicating whether this configuration has
+          # been applied to all managed instances in the group.
+    },
+    "appliedAcceleratorTopologies": [ # Output only. The accelerator topology applied to this MIG.
+        # Currently only one accelerator topology is supported.
+      {
+        "acceleratorTopology": "A String", # Output only. Topology in the format of: "16x16", "4x4x4", etc.
+            # The value is the same as configured in the WorkloadPolicy.
+        "state": "A String", # Output only. The state of the accelerator topology.
+        "stateDetails": { # Output only. The result of the latest accelerator topology state
+            # check.
+          "error": { # Output only. Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this
+                # operation.
+              { # Represents a single error encountered during the processing of an
+                  # 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.
+                  { # Container for structured error details providing additional context
+                      # specific to the encountered error code.
+                    "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                        #
+                        # 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. # Links and information to help the user resolve the error.
+                        #
+                        # 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 # A localized human-readable error message intended for end users.
+                        # 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. # Details about quota limits and metrics when a quota is exceeded.
+                      "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.
+              },
+            ],
+          },
+          "timestamp": "A String", # Output only. Timestamp is shown only if there is an error. The field
+              # has // RFC3339 //
+              # text format.
+        },
+      },
+    ],
+    "autoscaler": "A String", # Output only. The URL of theAutoscaler
+        # that targets this instance group manager.
+    "bulkInstanceOperation": { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
+        # targetSizePolicy.mode is set to BULK.
+      "inProgress": True or False, # Output only. Informs whether bulk instance operation is in progress.
+      "lastProgressCheck": { # Output only. Information from the last progress check of bulk instance
+          # operation.
+        "error": { # Output only. Errors encountered during bulk instance operation.
+          "errors": [ # [Output Only] The array of errors encountered while processing this
+              # operation.
+            { # Represents a single error encountered during the processing of an
+                # 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.
+                { # Container for structured error details providing additional context
+                    # specific to the encountered error code.
+                  "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                      #
+                      # 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. # Links and information to help the user resolve the error.
+                      #
+                      # 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 # A localized human-readable error message intended for end users.
+                      # 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. # Details about quota limits and metrics when a quota is exceeded.
+                    "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.
+            },
+          ],
+        },
+        "timestamp": "A String", # Output only. Timestamp of the last progress check of bulk instance
+            # operation. Timestamp is in RFC3339 text format.
+      },
+    },
+    "currentInstanceStatuses": { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
+        # in this managed instance group that have the status. Currently only shown
+        # for TPU MIGs
+        # instance group that have the status. For more information about how to
+        # interpret each status check the instance lifecycle documentation.
+        # Currently only shown for TPU MIGs.
+      "deprovisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have DEPROVISIONING status.
+      "nonExistent": 42, # Output only. The number of instances that have not been created yet or
+          # have been deleted. Includes only instances that would be shown in the
+          # listManagedInstances method and not all instances that have been
+          # deleted in the lifetime of the MIG.
+          # Does not include FlexStart instances that are waiting for the resources
+          # availability, they are considered as 'pending'.
+      "pending": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING status, that is FlexStart instances that are waiting
+          # for resources. Instances that do not exist because of the other reasons
+          # are counted as 'non_existent'.
+      "pendingStop": 42, # Output only. The number of instances in the managed instance group
+          # that have PENDING_STOP status.
+      "provisioning": 42, # Output only. The number of instances in the managed instance group
+          # that have PROVISIONING status.
+      "repairing": 42, # Output only. The number of instances in the managed instance group
+          # that have REPAIRING status.
+      "running": 42, # Output only. The number of instances in the managed instance group
+          # that have RUNNING status.
+      "staging": 42, # Output only. The number of instances in the managed instance group
+          # that have STAGING status.
+      "stopped": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPED status.
+      "stopping": 42, # Output only. The number of instances in the managed instance group
+          # that have STOPPING status.
+      "suspended": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDED status.
+      "suspending": 42, # Output only. The number of instances in the managed instance group
+          # that have SUSPENDING status.
+      "terminated": 42, # Output only. The number of instances in the managed instance group
+          # that have TERMINATED status.
+    },
+    "isStable": True or False, # Output only. A bit indicating whether the managed instance group is in a
+        # stable state. A stable state means that: none of the instances in the
+        # managed instance group is currently undergoing any type of change (for
+        # example, creation, restart, or deletion); no future changes are scheduled
+        # for instances in the managed instance group; and the managed instance
+        # group itself is not being modified.
+    "stateful": { # Output only. Stateful status of the given Instance Group Manager.
+      "hasStatefulConfig": True or False, # Output only. A bit indicating whether the managed instance group
+          # has stateful configuration, that is, if you have configured any items
+          # in a stateful policy or in per-instance configs.
+          # The group might report that it has no stateful configuration even when
+          # there is still some preserved state on a managed instance, for example,
+          # if you have deleted all PICs but not yet applied those deletions.
+      "perInstanceConfigs": { # Output only. Status of per-instance configurations on the instances.
+        "allEffective": True or False, # Output only. A bit indicating if all of the group's per-instance configurations
+            # (listed in the output of a listPerInstanceConfigs API call) have
+            # status EFFECTIVE or there are no per-instance-configs.
+      },
+    },
+    "versionTarget": { # Output only. A status of consistency of Instances' versions with their
+        # target version specified by version field on Instance Group
+        # Manager.
+      "isReached": True or False, # Output only. A bit indicating whether version target has been reached
+          # in this managed instance group, i.e. all instances are in their target
+          # version. Instances' target version are specified byversion field on Instance Group Manager.
+    },
+  },
+  "targetPools": [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "A String",
+  ],
+  "targetSize": 42, # The target number of running instances for this managed instance group.
+      # You can reduce this number by using the instanceGroupManager
+      # deleteInstances or abandonInstances methods. Resizing the group also
+      # changes this number.
+  "targetSizePolicy": { # The policy that specifies how the MIG creates its VMs to achieve the target
+      # size.
+    "mode": "A String", # The mode of target size policy based on which the MIG creates its VMs
+        # individually or all at once.
+  },
+  "targetStoppedSize": 42, # The target number of stopped instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Stop instance using the stopInstances
+      #    method or start instances using the startInstances
+      #    method.
+      #    - Manually change the targetStoppedSize using the update
+      #    method.
+  "targetSuspendedSize": 42, # The target number of suspended instances for this managed instance group.
+      # This number changes when you:
+      # 
+      #    - Suspend instance using the suspendInstances
+      #    method or resume instances using the resumeInstances
+      #    method.
+      #    - Manually change the targetSuspendedSize using the update
+      #    method.
+  "updatePolicy": { # The update policy for this managed instance group.
+    "instanceRedistributionType": "A String", # The
+        # instance redistribution policy for regional managed instance groups.
+        # Valid values are:
+        #
+        #    - PROACTIVE (default): The group attempts to maintain an
+        #    even distribution of VM instances across zones in the region.
+        #    - NONE: For non-autoscaled groups, proactive
+        #    redistribution is disabled.
+    "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
+        # either a fixed number or, if the group has 10 or more instances, a
+        # percentage. If you set a percentage, the number of instances is rounded
+        # if necessary.  The default value for maxSurge is a fixed
+        # value equal to the number of zones in which the managed instance group
+        # operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
+        # process. An instance is considered available if all of the following
+        # conditions are satisfied:
+        #
+        #
+        #
+        #      - The instance's status is
+        #      RUNNING.
+        #    - If there is a health
+        #      check on the instance group, the instance's health check status
+        #      must be HEALTHY at least once. If there is no health check
+        #      on the group, then the instance only needs to have a status of
+        #      RUNNING to be considered available.
+        #
+        #
+        # This value can be either a fixed number or, if the group has 10 or more
+        # instances, a percentage. If you set a percentage, the number of instances
+        # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
+        # in which the managed instance group operates.
+        #
+        # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
+      "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+          #
+          #
+          #
+          #     - If the value is fixed, then the calculated
+          #      value is equal to the fixed value.
+          #     - If the value is a percent, then the
+          #     calculated
+          #      value is percent/100 * targetSize. For example,
+          #      the calculated value of a 80% of a managed instance group
+          #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+          #      is a remainder, the number is rounded.
+      "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+      "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+          # example, specify 80 for 80%.
+    },
+    "minimalAction": "A String", # Minimal action to be taken on an instance. Use this option to minimize
+        # disruption as much as possible or to apply a more disruptive action than
+        # is necessary.
+        #
+        #    - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
+        #    Compute Engine performs the necessary action to execute the update.
+        #    - To apply a more disruptive action than is strictly necessary, set the
+        #    minimal action to RESTART or REPLACE. For
+        #    example, Compute Engine does not need to restart a VM to change its
+        #    metadata. But if your application reads instance metadata only when a VM
+        #    is restarted, you can set the minimal action to RESTART in
+        #    order to pick up metadata changes.
+    "mostDisruptiveAllowedAction": "A String", # Most disruptive action that is allowed to be taken on an instance.
+        # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
+        # as much as possible. RESTART to allow actions that can be
+        # applied without instance replacing or REPLACE to allow all
+        # possible actions. If the Updater determines that the minimal update
+        # action needed is more disruptive than most disruptive allowed action you
+        # specify it will not perform the update at all.
+    "replacementMethod": "A String", # What action should be used to replace instances.
+        # See minimal_action.REPLACE
+    "type": "A String", # The type
+        # of update process. You can specify either PROACTIVE so
+        # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
+        # to update.
+  },
+  "versions": [ # Specifies the instance templates used by this managed instance group to
+      # create instances.
+      # 
+      # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
+      # group. This field overrides the top-level instanceTemplate
+      # field. Read more about therelationships
+      # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
+      # remaining instances. For more information, read aboutcanary
+      # updates.
+    {
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed
+          # instance group. The group uses this template to create new instances in
+          # the managed instance group until the `targetSize` for this version is
+          # reached. The templates for existing instances in the group do not change
+          # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,
+          # existing instances are updated until the `targetSize` for this version is
+          # reached.
+      "name": "A String", # Name of the version. Unique among all versions in the scope of this
+          # managed instance group.
+      "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
+          # from the template will be equal to:
+          #
+          #
+          #      - If expressed as a fixed number, the minimum of either
+          #       targetSize.fixed or
+          #       instanceGroupManager.targetSize is used.
+          #      - if expressed as a percent, the targetSize
+          #      would be (targetSize.percent/100 *
+          #      InstanceGroupManager.targetSize) If there is a remainder, the
+          #      number is rounded.
+          #
+          #  If unset, this version will update any remaining instances not
+          # updated by another version. ReadStarting
+          # a canary update for more information.
+        "calculated": 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
+            #
+            #
+            #
+            #     - If the value is fixed, then the calculated
+            #      value is equal to the fixed value.
+            #     - If the value is a percent, then the
+            #     calculated
+            #      value is percent/100 * targetSize. For example,
+            #      the calculated value of a 80% of a managed instance group
+            #      with 150 instances would be (80/100 * 150) = 120 VM instances. If there
+            #      is a remainder, the number is rounded.
+        "fixed": 42, # Specifies a fixed number of VM instances. This must be a positive integer.
+        "percent": 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
+            # example, specify 80 for 80%.
+      },
+    },
+  ],
+  "zone": "A String", # Output only. The URL of azone
+      # where the managed instance group is located (for zonal resources).
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchPerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Inserts or patches per-instance configurations for the managed instance
+group. perInstanceConfig.name serves as a key used to
+distinguish whether to perform insert or patch.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request, 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:
+
+{ # RegionInstanceGroupManagers.patchPerInstanceConfigs
+  "perInstanceConfigs": [ # The list of per-instance configurations to insert or patch on this managed
+      # instance group.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ recreateInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified VM instances in the managed instance group to be
+immediately recreated. Each instance is recreated using the group's current
+configuration. This operation is marked as DONE when the flag
+is set even if the instances have not yet been recreated. You must
+separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
+the status of managed instances.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to recreate. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resize(project, region, instanceGroupManager, size, requestId=None, x__xgafv=None) + 
Changes the intended size of the managed instance group. If you increase
+the size, the group creates new instances using the current instance
+template. If you decrease the size, the group deletes one or more
+instances.
+
+The resize operation is marked DONE if theresize request is successful. The underlying actions take
+additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances
+method.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is removed or deleted.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  size: integer, Number of instances that should exist in this instance group
+manager. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resumeInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+resumed. This method increases thetargetSize and decreases the targetSuspendedSize
+of the managed instance group by the number of instances that you resume.
+The resumeInstances operation is marked DONE if
+the resumeInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
+method.
+
+In this request, you can only specify instances that are suspended. For
+example, if an instance was previously suspended using the suspendInstances
+method, it can be resumed using the resumeInstances method.
+
+If a health check is attached to the managed instance group, the specified
+instances will be verified as healthy after they are resumed.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to resume. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setInstanceTemplate(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Sets the instance template to use when creating new instances or recreating
+instances in this group. Existing instances are not affected.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instanceTemplate": "A String", # URL of the InstanceTemplate resource from which all new instances will be
+      # created.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setTargetPools(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Modifies the target pools to which all new instances in this group are
+assigned. Existing instances in the group are not affected.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "fingerprint": "A String", # Fingerprint of the target pools information, which is a hash of the
+      # contents. This field is used for optimistic locking when you update the
+      # target pool entries. This field is optional.
+  "targetPools": [ # The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
+      # apply to all of the instances in the managed instance group.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ startInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+started. This method increases thetargetSize and decreases the targetStoppedSize
+of the managed instance group by the number of instances that you start.
+The startInstances operation is marked DONE if
+the startInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
+method.
+
+In this request, you can only specify instances that are stopped. For
+example, if an instance was previously stopped using the stopInstances
+method, it can be started using the startInstances method.
+
+If a health check is attached to the managed instance group, the specified
+instances will be verified as healthy after they are started.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # The URLs of one or more instances to start. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ stopInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+immediately stopped. You can only specify instances that are running in
+this request. This method reduces thetargetSize and increases the targetStoppedSize
+of the managed instance group by the number of instances that you stop.
+The stopInstances operation is marked DONE if
+the stopInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
+method.
+
+If the standbyPolicy.initialDelaySec field is set, the group
+delays stopping the instances until initialDelaySec have
+passed from instance.creationTimestamp (that is, when the
+instance was created). This delay gives your application time to
+set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
+will be zero delay.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is stopped.
+
+Stopped instances can be started using the startInstances
+method.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "forceStop": True or False, # If this flag is set to true, the Instance Group Manager will proceed to
+      # stop the instances, skipping initialization on them.
+  "instances": [ # The URLs of one or more instances to stop. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "A String",
+  ],
+}
+
+  noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it's
+configured for the instances.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ suspendInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Flags the specified instances in the managed instance group to be
+immediately suspended. You can only specify instances that are running in
+this request. This method reduces thetargetSize and increases the targetSuspendedSize
+of the managed instance group by the number of instances that you suspend.
+The suspendInstances operation is marked DONE if
+the suspendInstances request is successful. The underlying
+actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
+method.
+
+If the standbyPolicy.initialDelaySec field is set, the group
+delays suspension of the instances until initialDelaySec have
+passed from instance.creationTimestamp (that is, when the
+instance was created). This delay gives your application time to
+set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
+will be zero delay.
+
+If the group is part of a backend
+service that has enabled
+connection draining, it can take up to 60 seconds after the connection
+draining duration has elapsed before the VM instance is suspended.
+
+Suspended instances can be resumed using the resumeInstances
+method.
+
+You can specify a maximum of 1000 instances with this method per request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "forceSuspend": True or False, # If this flag is set to true, the Instance Group Manager will proceed to
+      # suspend the instances, skipping initialization on them.
+  "instances": [ # The URLs of one or more instances to suspend. This can be a full URL or
+      # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updatePerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None) + 
Inserts or updates per-instance configurations for the managed instance
+group. perInstanceConfig.name serves as a key used to
+distinguish whether to perform insert or patch.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request, 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:
+
+{ # RegionInstanceGroupManagers.updatePerInstanceConfigs
+  "perInstanceConfigs": [ # The list of per-instance configurations to insert or patch on this managed
+      # instance group.
+    {
+      "fingerprint": "A String", # Fingerprint of this per-instance config. This field can be used in
+          # optimistic locking. It is ignored when inserting a per-instance
+          # config. An up-to-date fingerprint must be provided in order to update an
+          # existing per-instance configuration or the field needs to be unset.
+      "name": "A String", # The name of a per-instance configuration and its corresponding instance.
+          # Serves as a merge key during UpdatePerInstanceConfigs
+          # operations, that is, if a per-instance configuration with the same name
+          # exists then it will be updated, otherwise a new one will be created for the
+          # VM instance with the same name. An attempt to create a per-instance
+          # configuration for a VM instance that either doesn't exist or is not part
+          # of the group will result in an error.
+      "preservedState": { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
+          # preserved state generated from a stateful policy.
+        "disks": { # Preserved disks defined for this instance.
+            # This map is keyed with the device names of the disks.
+          "a_key": {
+            "autoDelete": "A String", # These stateful disks will never be deleted during autohealing,
+                # update, instance recreate operations. This flag is used to configure
+                # if the disk should be deleted after it is no longer used by the group,
+                # e.g. when the given instance or the whole MIG is deleted.
+                # Note: disks attached in READ_ONLY mode cannot be
+                # auto-deleted.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
+                # disk in READ_WRITE mode.
+            "source": "A String", # The URL of the disk resource that is stateful and should be attached
+                # to the VM instance.
+          },
+        },
+        "externalIPs": { # Preserved external IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "internalIPs": { # Preserved internal IPs defined for this instance.
+            # This map is keyed with the name of the network interface.
+          "a_key": {
+            "autoDelete": "A String", # These stateful IPs will never be released during autohealing,
+                # update or VM instance recreate operations.
+                # This flag is used to configure if the IP reservation should be deleted
+                # after it is no longer used by the group, e.g. when the given instance
+                # or the whole group is deleted.
+            "ipAddress": { # Ip address representation
+              "address": "A String", # The URL of the reservation for this IP address.
+              "literal": "A String", # An IPv4 internal network address to assign to the instance for this
+                  # network interface.
+            },
+          },
+        },
+        "metadata": { # Preserved metadata defined for this instance.
+          "a_key": "A String",
+        },
+      },
+      "status": "A String", # The status of applying this per-instance configuration on the corresponding
+          # managed instance.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionInstanceGroups.html b/docs/dyn/compute_preview.regionInstanceGroups.html new file mode 100644 index 0000000000..f0be48e007 --- /dev/null +++ b/docs/dyn/compute_preview.regionInstanceGroups.html @@ -0,0 +1,919 @@ + + + +

Compute Engine API . regionInstanceGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, instanceGroup, x__xgafv=None)

+

Returns the specified instance group resource.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of instance group resources contained within

+

+ listInstances(project, region, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the instances in the specified instance group and displays

+

+ listInstances_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ setNamedPorts(project, region, instanceGroup, body=None, requestId=None, x__xgafv=None)

+

Sets the named ports for the specified regional instance group.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, instanceGroup, x__xgafv=None) + 
Returns the specified instance group resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, Name of the instance group 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 an Instance Group resource.
+    #
+    # Instance Groups can be used to configure a target forload
+    # balancing.
+    #
+    # Instance groups can either be managed or unmanaged.
+    #
+    # To create
+    # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+    #
+    # Use zonal unmanaged instance groups if you need to applyload
+    # balancing to groups of heterogeneous instances or if you need to manage
+    # the instances yourself. You cannot create regional unmanaged instance groups.
+    #
+    # For more information, readInstance
+    # groups.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+      # uses this fingerprint to detect conflicts when multiple users change the
+      # named ports concurrently.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+      # by the server.
+  "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+  "name": "A String", # The name of the instance group. The name must be 1-63 characters
+      # long, and comply withRFC1035.
+  "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+      #
+      # This
+      # allows the system to reference ports by the assigned name instead of a
+      # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+      # "app1", port: 8081}, {name: "app2", port:
+      # 8082}]
+      #
+      # Named ports apply to all instances in this instance group.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+  "network": "A String", # [Output Only] The URL of the network to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the instance group is located (for regional resources).
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+      # this URL.
+  "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+  "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+      # instance group belong. If your instance has multiple network interfaces,
+      # then the network and subnetwork fields only refer to the
+      # network and subnet used by your primary interface (nic0).
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the instance group is located (for zonal resources).
+}
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of instance group resources contained within
+the specified 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.
+  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 InstanceGroup resources.
+  "id": "A String", # Output only. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceGroup resources.
+    { # Represents an Instance Group resource.
+        #
+        # Instance Groups can be used to configure a target forload
+        # balancing.
+        #
+        # Instance groups can either be managed or unmanaged.
+        #
+        # To create
+        # managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.
+        #
+        # Use zonal unmanaged instance groups if you need to applyload
+        # balancing to groups of heterogeneous instances or if you need to manage
+        # the instances yourself. You cannot create regional unmanaged instance groups.
+        #
+        # For more information, readInstance
+        # groups.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance group inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Output only. [Output Only] The fingerprint of the named ports. The system
+          # uses this fingerprint to detect conflicts when multiple users change the
+          # named ports concurrently.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this instance group, generated
+          # by the server.
+      "kind": "compute#instanceGroup", # Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.
+      "name": "A String", # The name of the instance group. The name must be 1-63 characters
+          # long, and comply withRFC1035.
+      "namedPorts": [ # Optional. Assigns a name to a port number. For example:{name: "http", port: 80}
+          #
+          # This
+          # allows the system to reference ports by the assigned name instead of a
+          # port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name:
+          # "app1", port: 8081}, {name: "app2", port:
+          # 8082}]
+          #
+          # Named ports apply to all instances in this instance group.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "network": "A String", # [Output Only] The URL of the network to which all instances in the
+          # instance group belong. If your instance has multiple network interfaces,
+          # then the network and subnetwork fields only refer to the
+          # network and subnet used by your primary interface (nic0).
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the instance group is located (for regional resources).
+      "selfLink": "A String", # Output only. [Output Only] The URL for this instance group. The server generates
+          # this URL.
+      "size": 42, # Output only. [Output Only] The total number of instances in the instance group.
+      "subnetwork": "A String", # Output only. [Output Only] The URL of the subnetwork to which all instances in the
+          # instance group belong. If your instance has multiple network interfaces,
+          # then the network and subnetwork fields only refer to the
+          # network and subnet used by your primary interface (nic0).
+      "zone": "A String", # Output only. [Output Only] The URL of thezone
+          # where the instance group is located (for zonal resources).
+    },
+  ],
+  "kind": "compute#regionInstanceGroupList", # Output only. The resource type.
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listInstances(project, region, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the instances in the specified instance group and displays
+information about the named ports. Depending on the specified options, this
+method can list all instances or only the instances that are running.
+The orderBy query parameter is not supported.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, Name of the regional instance group for which we want to list the
+instances. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instanceState": "A String", # Instances in which state should be returned. Valid options are:
+      # 'ALL', 'RUNNING'. By default, it lists all instances.
+  "portName": "A String", # Name of port user is interested in. It is optional. If it is set, only
+      # information about this ports will be returned. If it is not set, all the
+      # named ports will be returned.
+      # Always lists all instances.
+}
+
+  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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceWithNamedPorts resources.
+    {
+      "instance": "A String", # Output only. [Output Only] The URL of the instance.
+      "namedPorts": [ # Output only. [Output Only] The named ports that belong to this instance group.
+        { # The named port. For example: <"http", 80>.
+          "name": "A String", # The name for this named port.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "status": "A String", # Output only. [Output Only] The status of the instance.
+    },
+  ],
+  "kind": "compute#regionInstanceGroupsListInstances", # Output only. The resource type.
+  "nextPageToken": "A String", # Output only. [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.
+  "warning": { # Output only. [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.
+  },
+}
+
+ +
+ listInstances_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.
+
+
+ +
+ setNamedPorts(project, region, instanceGroup, body=None, requestId=None, x__xgafv=None) + 
Sets the named ports for the specified regional instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, The name of the regional instance group where the named ports are updated. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "fingerprint": "A String", # The fingerprint of the named ports information for this instance group.
+      # Use this optional property to prevent conflicts when multiple users change
+      # the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get
+      # method. Then, include the fingerprint in your request to ensure that you
+      # do not overwrite changes that were applied from another
+      # concurrent request.
+  "namedPorts": [ # The list of named ports to set for this instance group.
+    { # The named port. For example: <"http", 80>.
+      "name": "A String", # The name for this named port.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+      "port": 42, # The port number, which can be a value between 1 and 65535.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionInstanceTemplates.html b/docs/dyn/compute_preview.regionInstanceTemplates.html new file mode 100644 index 0000000000..901c1140ef --- /dev/null +++ b/docs/dyn/compute_preview.regionInstanceTemplates.html @@ -0,0 +1,3951 @@ + + + +

Compute Engine API . regionInstanceTemplates

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, instanceTemplate, requestId=None, x__xgafv=None)

+

Deletes the specified instance template. Deleting an instance template is

+

+ get(project, region, instanceTemplate, x__xgafv=None)

+

Returns the specified instance template.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates an instance template in the specified project and region using the

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of instance templates that are contained within the

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, instanceTemplate, requestId=None, x__xgafv=None) + 
Deletes the specified instance template. Deleting an instance template is
+permanent and cannot be undone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instanceTemplate: string, The name of the instance template 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instanceTemplate, x__xgafv=None) + 
Returns the specified instance template.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instanceTemplate: string, The name of the instance template. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Instance Template resource.
+    #
+    # Google Compute Engine has two Instance Template resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+    #
+    # You can reuse a global instance template in
+    # different regions whereas you can use a regional instance template in a
+    # specified region only. If you want to reduce cross-region dependency or
+    # achieve data residency, use a regional instance template.
+    #
+    # To create VMs, managed instance groups, and reservations, you can use either
+    # global or regional instance templates.
+    #
+    # For more information, readInstance Templates.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+      # defines this identifier.
+  "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+  "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.
+  "properties": { # The instance properties for this instance template.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+      # applicable for regional resources.
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+      # URL.
+  "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+      # from a source instance.
+    "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+        # For boot disk and any other R/W disks, the source images for each disk
+        # will be used. For read-only disks, they will be attached in read-only
+        # mode. Local SSD disks will be created as blank volumes.
+      { # A specification of the desired way to instantiate a disk in the instance
+          # template when its created from a source instance.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+            # this instance template.
+        "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+        "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+            # values are:
+            #
+            #
+            #      - source-image: to use the same image that was used to
+            #      create the source instance's corresponding disk. Applicable to the boot
+            #      disk and additional read-write disks.
+            #      - source-image-family: to use the same image family that
+            #      was used to create the source instance's corresponding disk. Applicable
+            #      to the boot disk and additional read-write disks.
+            #      - custom-image: to use a user-provided image url for disk
+            #      creation. Applicable to the boot disk and additional read-write
+            #      disks.
+            #    - attach-read-only: to attach a read-only
+            #      disk. Applicable to read-only disks.
+            #      - do-not-include: to exclude a disk from the template.
+            #      Applicable to additional read-write disks, local SSDs, and read-only
+            #      disks.
+      },
+    ],
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates an instance template in the specified project and region using the
+global instance template whose URL is included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an Instance Template resource.
+    # 
+    # Google Compute Engine has two Instance Template resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+    # 
+    # You can reuse a global instance template in
+    # different regions whereas you can use a regional instance template in a
+    # specified region only. If you want to reduce cross-region dependency or
+    # achieve data residency, use a regional instance template.
+    # 
+    # To create VMs, managed instance groups, and reservations, you can use either
+    # global or regional instance templates.
+    # 
+    # For more information, readInstance Templates.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+      # defines this identifier.
+  "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+  "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.
+  "properties": { # The instance properties for this instance template.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+      # applicable for regional resources.
+  "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+      # URL.
+  "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+  "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+      # from a source instance.
+    "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+        # For boot disk and any other R/W disks, the source images for each disk
+        # will be used. For read-only disks, they will be attached in read-only
+        # mode. Local SSD disks will be created as blank volumes.
+      { # A specification of the desired way to instantiate a disk in the instance
+          # template when its created from a source instance.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+            # this instance template.
+        "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+        "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+            # values are:
+            #
+            #
+            #      - source-image: to use the same image that was used to
+            #      create the source instance's corresponding disk. Applicable to the boot
+            #      disk and additional read-write disks.
+            #      - source-image-family: to use the same image family that
+            #      was used to create the source instance's corresponding disk. Applicable
+            #      to the boot disk and additional read-write disks.
+            #      - custom-image: to use a user-provided image url for disk
+            #      creation. Applicable to the boot disk and additional read-write
+            #      disks.
+            #    - attach-read-only: to attach a read-only
+            #      disk. Applicable to read-only disks.
+            #      - do-not-include: to exclude a disk from the template.
+            #      Applicable to additional read-write disks, local SSDs, and read-only
+            #      disks.
+      },
+    ],
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of instance templates that are contained within the
+specified project and region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the regions 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of instance templates.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstanceTemplate resources.
+    { # Represents an Instance Template resource.
+        #
+        # Google Compute Engine has two Instance Template resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
+        # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
+        #
+        # You can reuse a global instance template in
+        # different regions whereas you can use a regional instance template in a
+        # specified region only. If you want to reduce cross-region dependency or
+        # achieve data residency, use a regional instance template.
+        #
+        # To create VMs, managed instance groups, and reservations, you can use either
+        # global or regional instance templates.
+        #
+        # For more information, readInstance Templates.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "id": "A String", # Output only. [Output Only] A unique identifier for this instance template. The server
+          # defines this identifier.
+      "kind": "compute#instanceTemplate", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
+      "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.
+      "properties": { # The instance properties for this instance template.
+        "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+            # Note that for MachineImage, this is not supported yet.
+            # Options that would traditionally be configured in a BIOS belong
+            # here. Features that require operating system support may have
+            # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+            # disabled).
+          "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+          "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+          "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+          "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+              # multithreading (SMT) set this to 1. If unset, the maximum number
+              # of threads supported per core by the underlying processor is
+              # assumed.
+          "turboMode": "A String", # Turbo frequency mode to use for the instance.
+              # Supported modes include:
+              # * ALL_CORE_MAX
+              #
+              # Using empty string or not setting this field will use the platform-specific
+              # default turbo mode.
+          "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+              # the number of threads per core to compute the total number of virtual
+              # CPUs to expose to the instance. If unset, the number of cores is
+              # inferred from the instance's nominal CPU count and the underlying
+              # platform's SMT width.
+        },
+        "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+            # source IP addresses other than their own and receive packets with
+            # destination IP addresses other than their own. If these instances will be
+            # used as an IP gateway or it will be set as the next-hop in a Route
+            # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+            # documentation for more information.
+        "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+            # Note that for MachineImage, this is not supported yet.
+          "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+          "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+        },
+        "description": "A String", # An optional text description for the instances that are created from these
+            # properties.
+        "disks": [ # An array of disks that are associated with the instances that are created
+            # from these properties.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+            # created from these properties.
+          { # A specification of the type and number of accelerator cards attached to the
+              # instance.
+            "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+            "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                # If you are creating an instance template, specify only the
+                # accelerator name.
+                # See GPUs on Compute Engine
+                # for a full list of accelerator types.
+          },
+        ],
+        "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+            # "NONE". The default value is "NONE" if it is not specified.
+        "labels": { # Labels to apply to instances that are created from these properties.
+          "a_key": "A String",
+        },
+        "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+            # Local SSDs attached to the VM.
+        "machineType": "A String", # The machine type to use for instances that are created from these
+            # properties.
+            # This field only accepts a machine type name, for example `n2-standard-4`.
+            # If you use the machine type full or partial URL, for example
+            # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+            # the request will result in an `INTERNAL_ERROR`.
+        "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+            # these properties. These pairs can consist of custom metadata or predefined
+            # keys. SeeProject and
+            # instance metadata for more information.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve the resource.
+          "items": [ # Array of key/value pairs. The total size of all keys and values must be
+              # less than 512 KB.
+            { # Metadata
+              "key": "A String", # Key for the metadata entry. Keys must conform to the following
+                  # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+                  # This is reflected as part of a URL in the metadata server. Additionally, to
+                  # avoid ambiguity, keys must not conflict with any other metadata keys
+                  # for the project.
+              "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+                  # have meaning as interpreted by the image running in the instance. The
+                  # only restriction placed on values is that their size must be less than
+                  # or equal to 262144 bytes (256 KiB).
+            },
+          ],
+          "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+              # for metadata.
+        },
+        "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+            # scheduled on the specified or newer cpu/platform. Applicable values are the
+            # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+            # information, read Specifying a
+            # Minimum CPU Platform.
+        "networkInterfaces": [ # An array of network access configurations for this interface.
+          { # A network interface resource attached to an instance.
+            "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+                # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+                # no external internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+                # You can only specify this field for network interfaces in VPC networks.
+              { # An alias IP range attached to an instance's network interface.
+                "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                    # must belong to the specified subnetwork and cannot contain IP addresses
+                    # reserved by system or used by other network interfaces. This range may be
+                    # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+                "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                    # alias range. If not specified, the primary range of the subnetwork is used.
+              },
+            ],
+            "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+                # with network_attachment.
+            "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+                # This field will be ignored when inserting an Instance or
+                # adding a NetworkInterface. An up-to-date
+                # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+            "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+                # or not. If enabled, also indicates the version of IGMP supported.
+            "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+            "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+                # one IPv6 access config, DIRECT_IPV6, is supported. If there
+                # is no ipv6AccessConfig specified, then this instance will
+                # have no external IPv6 Internet access.
+              { # An access configuration attached to an instance's network interface.
+                  # Only one access config per instance is supported.
+                "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                    # The first IPv6 address of the external IPv6 range associated
+                    # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                    # use a static external IP address, it must be unused and in the same region
+                    # as the instance's zone. If not specified, Google Cloud will automatically
+                    # assign an external IPv6 address from the instance's subnetwork.
+                "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                    # external IPv6 range.
+                "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+                "name": "A String", # The name of this access configuration. In accessConfigs
+                    # (IPv4), the default and recommended name is External NAT, but
+                    # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                    # recommend name is External IPv6.
+                "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                    # address associated with this instance. Specify an unused static
+                    # external IP address available to the project or leave this field undefined
+                    # to use an IP from a shared ephemeral IP address pool. If you specify a
+                    # static external IP address, it must live in the same region as the zone of
+                    # the instance.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                    # configuration and can only take the following values: PREMIUM,STANDARD.
+                    #
+                    # If an AccessConfig is specified without a valid external IP address, an
+                    # ephemeral IP will be created with this networkTier.
+                    #
+                    # If an AccessConfig with a valid external IP address is specified, it must
+                    # match that of the networkTier associated with the Address resource owning
+                    # that IP.
+                "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                    #
+                    # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                    # first IP in associated external IPv6 range.
+                "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                    # config.
+                "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                    # external IP address of the instance to a DNS domain name.
+                    #
+                    # This field is not used in ipv6AccessConfig. A default PTR
+                    # record will be created if the VM has external IPv6 range associated.
+                "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                    # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+              },
+            ],
+            "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+                # accessed from the Internet. This field is always inherited from its
+                # subnetwork.
+                #
+                # Valid only if stackType is IPV4_IPV6.
+            "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+                # use a static internal IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an internal IPv6 address from the instance's subnetwork.
+            "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+            "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+                # server. For a VM, the network interface uses the nicN naming
+                # format. Where N is a value between 0 and7. The default interface value is nic0.
+            "network": "A String", # URL of the VPC network resource for this instance. When creating an
+                # instance, if neither the network nor the subnetwork is specified, the
+                # default network global/networks/default is used. If the
+                # selected project doesn't have the default network, you must specify a
+                # network or subnet. If the network is not specified but the subnetwork is
+                # specified, the network is inferred.
+                #
+                # If you specify this property, you can specify the network as
+                # a full or partial URL. For example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+                #       - projects/project/global/networks/network
+                #       - global/networks/default
+            "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+                # to in the following format:
+                # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+            "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+                # interface. If not specified by the user, an unused internal IP is
+                # assigned by the system.
+            "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+                # VirtioNet.
+            "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+            "queueCount": 42, # The networking queue count that's specified by users for the network
+                # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+                # if not specified by the users.
+            "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+                # interface. Can only be used with network_attachment. It is not possible to
+                # use on its own however, network_attachment can be used without
+                # service_class_id.
+            "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+                # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+                #
+                # This field can be both set at instance creation and update network
+                # interface operations.
+            "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+                # resource is inlegacy
+                # mode, do not specify this field. If the network is in auto subnet
+                # mode, specifying the subnetwork is optional. If the network is in custom
+                # subnet mode, specifying the subnetwork is required. If you specify this
+                # field, you can specify the subnetwork as a full or partial URL. For
+                # example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+                #    - regions/region/subnetworks/subnetwork
+            "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+                # from 2 to 255 inclusively.
+          },
+        ],
+        "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+          "totalEgressBandwidthTier": "A String",
+        },
+        "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+            # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+            # Note that for MachineImage, this is not supported yet.
+        "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+            # Note that for MachineImage, this is not supported yet.
+          "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+              # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+              # Consuming reserved instances for examples.
+          "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+              # the name of your reservation as its value.
+          "values": [ # Corresponds to the label values of a reservation resource. This can be
+              # either a name to a reservation in the same project or
+              # "projects/different-project/reservations/some-reservation-name" to target a
+              # shared reservation in the same zone but in a different project.
+            "A String",
+          ],
+        },
+        "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/{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",
+        },
+        "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+            # these properties.
+            # Note that for MachineImage, this is not supported yet.
+          "A String",
+        ],
+        "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+            # these properties.
+          "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+              # terminated by Compute Engine (not terminated by a user). You can only set
+              # the automatic restart option for standard instances.Preemptible instances
+              # cannot be automatically restarted.
+              #
+              # By default, this is set to true so an instance is
+              # automatically restarted if it is terminated by Compute Engine.
+          "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+              # must be a number between 1 and the number of availability domains
+              # specified in the spread placement policy attached to the instance.
+          "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+              # ResourceStatus resource of the VM.
+          "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+            "enabled": True or False, # Opts-in for graceful shutdown.
+            "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+                # graceful shutdown isn't complete after this time, then the instance
+                # transitions to the STOPPING state.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+              # within the range of [90, 330] with the increment of 30, if unset, the
+              # default behavior of host error recovery will be used.
+          "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+          "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+              # recovery of the Local Ssd state is attempted. Its value should be in
+              # between 0 and 168 hours with hour granularity and the default value being 1
+              # hour.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "locationHint": "A String", # An opaque location hint used to place the instance close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+              # the instance termination action will be performed at the end of the run
+              # duration.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+              # on a sole-tenant node.
+          "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+              # affinity for more information.
+              # Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which this Instance
+                #  could be scheduled.
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+              # the default behavior is MIGRATE. Forpreemptible instances,
+              # the default and only possible behavior is TERMINATE. For more
+              # information, see
+              #  Set
+              #  VM host maintenance policy.
+          "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+            "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+                # else, the Local SSD data will be preserved when the instance is stopped
+                # at the end of the run duration/termination time.
+          },
+          "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+              # instance creation or while the instance isstopped and
+              # therefore, in a `TERMINATED` state. SeeInstance Life
+              # Cycle for more information on the possible instance states.
+          "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+              # Soft Off signal is triggered for Spot VMs only. If not specified,
+              # there will be no wait before the G2 Soft Off signal is triggered.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+          "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+              # Off and ACPI G3 Mechanical
+              # Off for Standard VMs and 30 seconds for Spot VMs.
+          "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+              # termination action will be performed at the termination time.
+        },
+        "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+            # service accounts are available to the instances that are created from
+            # these properties. Use metadata queries to obtain the access tokens for
+            # these instances.
+          { # A service account.
+            "email": "A String", # Email address of the service account.
+            "scopes": [ # The list of scopes to be made available for this service account.
+              "A String",
+            ],
+          },
+        ],
+        "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+          "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+              # default.
+          "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+              # default.
+          "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+              # default.
+        },
+        "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+            # properties. The tags identify valid sources or targets for network
+            # firewalls. The setTags method can modify this list of tags. Each tag within
+            # the list must comply with RFC1035.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+              # the tags' contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update tags. You must always provide an
+              # up-to-date fingerprint hash in order to update or change tags.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # instance.
+          "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+              # with RFC1035.
+            "A String",
+          ],
+        },
+        "workloadIdentityConfig": {
+          "identity": "A String",
+          "identityCertificateEnabled": True or False,
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the instance template resides. Only
+          # applicable for regional resources.
+      "selfLink": "A String", # Output only. [Output Only] The URL for this instance template. The server defines this
+          # URL.
+      "sourceInstance": "A String", # The source instance used to create the template. 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/zones/zone/instances/instance
+          #    - projects/project/zones/zone/instances/instance
+      "sourceInstanceParams": { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
+          # from a source instance.
+        "diskConfigs": [ # Attached disks configuration. If not provided, defaults are applied:
+            # For boot disk and any other R/W disks, the source images for each disk
+            # will be used. For read-only disks, they will be attached in read-only
+            # mode. Local SSD disks will be created as blank volumes.
+          { # A specification of the desired way to instantiate a disk in the instance
+              # template when its created from a source instance.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "customImage": "A String", # The custom source image to be used to restore this disk when instantiating
+                # this instance template.
+            "deviceName": "A String", # Specifies the device name of the disk to which the configurations apply to.
+            "instantiateFrom": "A String", # Specifies whether to include the disk and what image to use. Possible
+                # values are:
+                #
+                #
+                #      - source-image: to use the same image that was used to
+                #      create the source instance's corresponding disk. Applicable to the boot
+                #      disk and additional read-write disks.
+                #      - source-image-family: to use the same image family that
+                #      was used to create the source instance's corresponding disk. Applicable
+                #      to the boot disk and additional read-write disks.
+                #      - custom-image: to use a user-provided image url for disk
+                #      creation. Applicable to the boot disk and additional read-write
+                #      disks.
+                #    - attach-read-only: to attach a read-only
+                #      disk. Applicable to read-only disks.
+                #      - do-not-include: to exclude a disk from the template.
+                #      Applicable to additional read-write disks, local SSDs, and read-only
+                #      disks.
+          },
+        ],
+      },
+    },
+  ],
+  "kind": "compute#instanceTemplateList", # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template
+      # lists.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionInstances.html b/docs/dyn/compute_preview.regionInstances.html new file mode 100644 index 0000000000..8c4b15cc7e --- /dev/null +++ b/docs/dyn/compute_preview.regionInstances.html @@ -0,0 +1,1919 @@ + + + +

Compute Engine API . regionInstances

+

Instance Methods

+

+ bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates multiple instances in a given region. Count specifies the number of

+

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ bulkInsert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates multiple instances in a given region. Count specifies the number of
+instances to create.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A transient resource used in compute.instances.bulkInsert and
+    # compute.regionInstances.bulkInsert . This resource is not persisted
+    # anywhere, it is used only for processing the requests.
+  "count": "A String", # The maximum number of instances to create.
+  "instanceFlexibilityPolicy": { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
+    "instanceSelections": { # Specification of alternative, flexible instance subsets.
+        # One of them will be selected to create the instances
+        # based on various criteria, like:
+        # - ranks,
+        # - location policy,
+        # - current capacity,
+        # - available reservations (you can specify affinity in
+        # InstanceProperties),
+        # - SWAN/GOOSE limitations.
+        # Key is an arbitrary, unique RFC1035 string that identifies the instance
+        # selection.
+      "a_key": { # Specification of machine type to use. Every position inside this message
+          # is an alternative.
+          # The count specified in the shape flexibility must not exceed the number
+          # of entries in per_instance_properties or the capacity of the
+          # name_pattern, if used.
+        "disks": [ # Disks to be attached to the instances created from in this selection.
+            # They override the disks specified in the instance properties.
+          { # An instance-attached disk resource.
+            "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+                # or X86_64.
+            "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+                # deleted (but not when the disk is detached from the instance).
+            "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+                # partition of the disk for its root filesystem.
+            "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+                # running within the instance. This name can be used to reference the device
+                # for mounting, resizing, and so on, from within the instance.
+                #
+                # If not specified, the server chooses a default device name to apply to this
+                # disk, in the form persistent-disk-x, where x is a number
+                # assigned by Google Compute Engine. This field is only applicable for
+                # persistent disks.
+            "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+                # encryption key.
+                #
+                # If you are creating a new disk, this field encrypts the new disk using
+                # an encryption key that you provide. If you are attaching an existing
+                # disk that is already encrypted, this field decrypts the disk using
+                # the customer-supplied encryption key.
+                #
+                # If you encrypt a disk using a customer-supplied key, you must provide the
+                # same key again when you attempt to use this resource at a later time. For
+                # example, you must provide the key when you create a snapshot or an image
+                # from the disk or when you attach the disk to a virtual machine instance.
+                #
+                # If you do not provide an encryption key, then the disk will be encrypted
+                # using an automatically generated key and you do not need to provide a key
+                # to use the disk later.
+                #
+                # Note:
+                #
+                # Instance templates do not storecustomer-supplied
+                # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+                #
+                # You cannot create VMs that have disks with customer-supplied keys using
+                # the bulk
+                # insert method.
+              "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                  # For example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  #
+                  # The fully-qualifed key name may be returned for resource GET requests. For
+                  # example:
+                  #
+                  # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                  # key_region/cryptoKeys/key
+                  # /cryptoKeyVersions/1
+              "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                  # key. If absent, the Compute Engine default service account is used.
+                  # For example:
+                  #
+                  # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+              "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies a 256-bit customer-supplied
+                  # encryption key, encoded in RFC
+                  # 4648 base64 to either encrypt or decrypt this resource. You can
+                  # provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rawKey":
+                  # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+              "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                  # customer-supplied encryption key to either encrypt or decrypt this
+                  # resource. You can provide either the rawKey or thersaEncryptedKey.
+                  # For example:
+                  #
+                  # "rsaEncryptedKey":
+                  # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                  # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                  # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                  #
+                  # The key must meet the following requirements before you can provide it to
+                  # Compute Engine:
+                  #
+                  #    1. The key is wrapped using a RSA public key certificate provided by
+                  #    Google.
+                  #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                  #    encoding.
+                  #
+                  # Gets the RSA public key certificate provided by Google at:
+                  #
+                  #
+                  # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+              "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                  # [Output only] TheRFC
+                  # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                  # encryption key that protects this resource.
+            },
+            "diskSizeGb": "A String", # The size of the disk in GB.
+            "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+                # currently attached to another instance. If you try to force attach a zonal
+                # disk to an instance, you will receive an error.
+            "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+                # only for bootable images. Read
+                # Enabling guest operating system features to see a list of available
+                # options.
+              { # Guest OS features.
+                "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                    # separate values. Set to one or more of the following values:
+                    #
+                    #    - VIRTIO_SCSI_MULTIQUEUE
+                    #    - WINDOWS
+                    #    - MULTI_IP_SUBNET
+                    #    - UEFI_COMPATIBLE
+                    #    - GVNIC
+                    #    - SEV_CAPABLE
+                    #    - SUSPEND_RESUME_COMPATIBLE
+                    #    - SEV_LIVE_MIGRATABLE_V2
+                    #    - SEV_SNP_CAPABLE
+                    #    - TDX_CAPABLE
+                    #    - IDPF
+                    #    - SNP_SVSM_CAPABLE
+                    #    - CCA_CAPABLE
+                    #    - SUSPEND_SAFE_FPR
+                    #
+                    #
+                    # For more information, see
+                    # Enabling guest operating system features.
+              },
+            ],
+            "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+                # boot disk. If you have many disks attached to an instance, each
+                # disk would have a unique index number.
+            "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+                # alongside the new instance. Use initialization parameters to create boot
+                # disks or local SSDs attached to the new instance.
+                #
+                # This field is persisted and returned for instanceTemplate and not returned
+                # in the context of instance.
+                #
+                # This property is mutually exclusive with the source property;
+                # you can only define one or the other, but not both.
+              "architecture": "A String", # The architecture of the attached disk. Valid values are
+                  # arm64 or x86_64.
+              "description": "A String", # An optional description. Provide this property when creating the disk.
+              "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+                  # of the instance. If a disk with the same name already exists in the given
+                  # region, the existing disk is attached to the new instance and the
+                  # new disk is not created.
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+                  # 10 GB. If you specify a sourceImage, which is required for
+                  # boot disks, the default size is the size of the sourceImage.
+                  # If you do not specify a sourceImage, the default disk size
+                  # is 500 GB.
+              "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+                  # disk. For valid disk type values, see
+                  # Supported types for Hyperdisk volumes and
+                  # Persistent Disk type variables.
+                  #
+                  # When creating a single instance, you must provide either the full or
+                  # partial URL of the disk type. For example, the following values are
+                  # valid:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+                  #      - projects/project/zones/zone/diskTypes/diskType
+                  #      - zones/zone/diskTypes/diskType
+                  #
+                  #
+                  #
+                  # When creating an instance template, instance flexibility policy, or when
+                  # creating or updating an all-instances configuration, you specify the
+                  # disk type without a URL, for example, hyperdisk-balanced.
+                  #
+                  # If you omit this field for a disk, the default disk type depends on
+                  # the instance's machine series, as follows.
+                  #
+                  #
+                  #     - For first- and second-generation machine series like N1, N2, T2, and
+                  #     M1, the
+                  #        default disk type is Standard Persistent Disk
+                  #        (pd-standard).
+                  #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+                  #     (pd-balanced).
+                  #    - For other third-generation machine
+                  #     series like A3, H3, Z3, all
+                  #         fourth-generation types like C4, N4, M4, and newer machine series,
+                  #         the default is Hyperdisk Balanced
+                  #         (hyperdisk-balanced).
+                  #
+                  #
+                  #
+                  # The disk type you specify must be compatible with the instance's machine
+                  # series. For a list of machine series that support Persistent Disk, see Machine
+                  # series support for Persistent Disk.
+                  #
+                  # For a list of machine series that support Hyperdisk, seeMachine
+                  # series support for Hyperdisk.
+              "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+              "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+                  # persistent disks.
+                "a_key": "A String",
+              },
+              "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+                "A String",
+              ],
+              "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+                  # is to use the existing disk.
+              "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+                  # of I/O operations per second that the disk can handle. Values must be
+                  # between 10,000 and 120,000. For more details, see theExtreme persistent
+                  # disk documentation.
+              "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+                  # number of throughput mb per second that the disk can handle. Values must
+                  # greater than or equal to 1.
+              "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+                  # the URLs of the zones where the disk should be replicated to.
+                  # You must provide exactly two replica zones, and one zone must be the same
+                  # as the instance zone.
+                "A String",
+              ],
+              "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/{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",
+              },
+              "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+                  # Specified using the full or partial URL. For instance template, specify
+                  # only the resource policy name.
+                "A String",
+              ],
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+                  # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                  # is required.
+                  #
+                  # To create a disk with one of the public operating system
+                  # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+                  #
+                  # projects/debian-cloud/global/images/family/debian-9
+                  #
+                  #
+                  # Alternatively, use a specific version of a public operating system image:
+                  #
+                  # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+                  #
+                  #
+                  # To create a disk with a custom image that you created, specify the
+                  # image name in the following format:
+                  #
+                  # global/images/my-custom-image
+                  #
+                  #
+                  # You can also specify a custom image by its image family, which returns
+                  # the latest version of the image in that family. Replace the image name
+                  # with family/family-name:
+                  #
+                  # global/images/family/my-image-family
+                  #
+                  #
+                  # If the source image is deleted later, this field will not be set.
+              "sourceImageEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source image. Required if the source image is
+                  # protected by a customer-supplied encryption key.
+                  #
+                  # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+                  # encryption keys, so you cannot create disks for instances in a managed instance group if the
+                  # source images are encrypted with your own keys.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+                  # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+                  # is required.
+                  #
+                  # To create a disk with a snapshot that you created, specify the
+                  # snapshot name in the following format:
+                  #
+                  # global/snapshots/my-backup
+                  #
+                  #
+                  # If the source snapshot is deleted later, this field will not be set.
+                  #
+                  # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+                  # an image instead when you create VMs using
+                  # the bulk
+                  # insert method.
+              "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+                  # encryption key of the source snapshot.
+                "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                    # For example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    #
+                    # The fully-qualifed key name may be returned for resource GET requests. For
+                    # example:
+                    #
+                    # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                    # key_region/cryptoKeys/key
+                    # /cryptoKeyVersions/1
+                "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                    # key. If absent, the Compute Engine default service account is used.
+                    # For example:
+                    #
+                    # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+                "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies a 256-bit customer-supplied
+                    # encryption key, encoded in RFC
+                    # 4648 base64 to either encrypt or decrypt this resource. You can
+                    # provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rawKey":
+                    # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+                "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                    # customer-supplied encryption key to either encrypt or decrypt this
+                    # resource. You can provide either the rawKey or thersaEncryptedKey.
+                    # For example:
+                    #
+                    # "rsaEncryptedKey":
+                    # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                    # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                    # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                    #
+                    # The key must meet the following requirements before you can provide it to
+                    # Compute Engine:
+                    #
+                    #    1. The key is wrapped using a RSA public key certificate provided by
+                    #    Google.
+                    #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                    #    encoding.
+                    #
+                    # Gets the RSA public key certificate provided by Google at:
+                    #
+                    #
+                    # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+                "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                    # [Output only] TheRFC
+                    # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                    # encryption key that protects this resource.
+              },
+              "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+                  #      - projects/project/zones/zone/storagePools/storagePool
+                  #    - zones/zone/storagePools/storagePool
+            },
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                # either SCSI or NVME. For most machine types, the
+                # default is SCSI. Local SSDs can use either NVME or SCSI.
+                # In certain configurations, persistent disks can use NVMe. For more
+                # information, seeAbout
+                # persistent disks.
+            "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+            "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+              "A String",
+            ],
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+                # in READ_WRITE mode.
+            "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+                # field is set to PRESERVED if the LocalSSD data has been saved
+                # to a persistent location by customer request.  (see the
+                # discard_local_ssd option on Stop/Suspend).
+                # Read-only in the api.
+            "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+                # these are public keys which are safe to store in public
+              "dbs": [ # The Key Database (db).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "dbxs": [ # The forbidden key database (dbx).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "keks": [ # The Key Exchange Key (KEK).
+                {
+                  "content": "A String", # The raw content in the secure keys file.
+                  "fileType": "A String", # The file type of source file.
+                },
+              ],
+              "pk": { # The Platform Key (PK).
+                "content": "A String", # The raw content in the secure keys file.
+                "fileType": "A String", # The file type of source file.
+              },
+            },
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+                # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+                # is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using
+                # this property. This field is only applicable for persistent disks.
+                #
+                # 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.
+          },
+        ],
+        "machineTypes": [ # Alternative machine types to use for instances that are created from
+            # these properties. This field only accepts a machine type names, for
+            # example `n2-standard-4` and not URLs or partial URLs.
+          "A String",
+        ],
+        "minCpuPlatform": "A String", # Name of the minimum CPU platform to be used by this instance selection.
+            # e.g. 'Intel Ice Lake'.
+        "rank": "A String", # Rank when prioritizing the shape flexibilities.
+            # The instance selections with rank are considered
+            # first, in the ascending order of the rank.
+            # If not set, defaults to 0.
+      },
+    },
+  },
+  "instanceProperties": { # The instance properties defining the VM instances to be created. Required
+      # if sourceInstanceTemplate is not provided.
+    "advancedMachineFeatures": { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
+        # Note that for MachineImage, this is not supported yet.
+        # Options that would traditionally be configured in a BIOS belong
+        # here. Features that require operating system support may have
+        # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
+        # disabled).
+      "enableNestedVirtualization": True or False, # Whether to enable nested virtualization or not (default is false).
+      "enableUefiNetworking": True or False, # Whether to enable UEFI networking for instance creation.
+      "performanceMonitoringUnit": "A String", # Type of Performance Monitoring Unit requested on instance.
+      "threadsPerCore": 42, # The number of threads per physical core. To disable simultaneous
+          # multithreading (SMT) set this to 1. If unset, the maximum number
+          # of threads supported per core by the underlying processor is
+          # assumed.
+      "turboMode": "A String", # Turbo frequency mode to use for the instance.
+          # Supported modes include:
+          # * ALL_CORE_MAX
+          #
+          # Using empty string or not setting this field will use the platform-specific
+          # default turbo mode.
+      "visibleCoreCount": 42, # The number of physical cores to expose to an instance. Multiply by
+          # the number of threads per core to compute the total number of virtual
+          # CPUs to expose to the instance. If unset, the number of cores is
+          # inferred from the instance's nominal CPU count and the underlying
+          # platform's SMT width.
+    },
+    "canIpForward": True or False, # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with
+        # destination IP addresses other than their own. If these instances will be
+        # used as an IP gateway or it will be set as the next-hop in a Route
+        # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
+        # documentation for more information.
+    "confidentialInstanceConfig": { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
+        # Note that for MachineImage, this is not supported yet.
+      "confidentialInstanceType": "A String", # Defines the type of technology used by the confidential instance.
+      "enableConfidentialCompute": True or False, # Defines whether the instance should have confidential compute enabled.
+    },
+    "description": "A String", # An optional text description for the instances that are created from these
+        # properties.
+    "disks": [ # An array of disks that are associated with the instances that are created
+        # from these properties.
+      { # An instance-attached disk resource.
+        "architecture": "A String", # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
+            # or X86_64.
+        "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is
+            # deleted (but not when the disk is detached from the instance).
+        "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first
+            # partition of the disk for its root filesystem.
+        "deviceName": "A String", # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
+            # running within the instance. This name can be used to reference the device
+            # for mounting, resizing, and so on, from within the instance.
+            #
+            # If not specified, the server chooses a default device name to apply to this
+            # disk, in the form persistent-disk-x, where x is a number
+            # assigned by Google Compute Engine. This field is only applicable for
+            # persistent disks.
+        "diskEncryptionKey": { # Encrypts or decrypts a disk using acustomer-supplied
+            # encryption key.
+            #
+            # If you are creating a new disk, this field encrypts the new disk using
+            # an encryption key that you provide. If you are attaching an existing
+            # disk that is already encrypted, this field decrypts the disk using
+            # the customer-supplied encryption key.
+            #
+            # If you encrypt a disk using a customer-supplied key, you must provide the
+            # same key again when you attempt to use this resource at a later time. For
+            # example, you must provide the key when you create a snapshot or an image
+            # from the disk or when you attach the disk to a virtual machine instance.
+            #
+            # If you do not provide an encryption key, then the disk will be encrypted
+            # using an automatically generated key and you do not need to provide a key
+            # to use the disk later.
+            #
+            # Note:
+            #
+            # Instance templates do not storecustomer-supplied
+            # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
+            #
+            # You cannot create VMs that have disks with customer-supplied keys using
+            # the bulk
+            # insert method.
+          "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+              # For example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              #
+              # The fully-qualifed key name may be returned for resource GET requests. For
+              # example:
+              #
+              # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+              # key_region/cryptoKeys/key
+              # /cryptoKeyVersions/1
+          "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+              # key. If absent, the Compute Engine default service account is used.
+              # For example:
+              #
+              # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+          "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies a 256-bit customer-supplied
+              # encryption key, encoded in RFC
+              # 4648 base64 to either encrypt or decrypt this resource. You can
+              # provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rawKey":
+              # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+          "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+              # customer-supplied encryption key to either encrypt or decrypt this
+              # resource. You can provide either the rawKey or thersaEncryptedKey.
+              # For example:
+              #
+              # "rsaEncryptedKey":
+              # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+              # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+              # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+              #
+              # The key must meet the following requirements before you can provide it to
+              # Compute Engine:
+              #
+              #    1. The key is wrapped using a RSA public key certificate provided by
+              #    Google.
+              #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+              #    encoding.
+              #
+              # Gets the RSA public key certificate provided by Google at:
+              #
+              #
+              # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+          "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+              # [Output only] TheRFC
+              # 4648 base64 encoded SHA-256 hash of the customer-supplied
+              # encryption key that protects this resource.
+        },
+        "diskSizeGb": "A String", # The size of the disk in GB.
+        "forceAttach": True or False, # [Input Only] Whether to force attach the regional disk even if it's
+            # currently attached to another instance. If you try to force attach a zonal
+            # disk to an instance, you will receive an error.
+        "guestOsFeatures": [ # A list of features to enable on the guest operating system. Applicable
+            # only for bootable images. Read
+            # Enabling guest operating system features to see a list of available
+            # options.
+          { # Guest OS features.
+            "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+                # separate values. Set to one or more of the following values:
+                #
+                #    - VIRTIO_SCSI_MULTIQUEUE
+                #    - WINDOWS
+                #    - MULTI_IP_SUBNET
+                #    - UEFI_COMPATIBLE
+                #    - GVNIC
+                #    - SEV_CAPABLE
+                #    - SUSPEND_RESUME_COMPATIBLE
+                #    - SEV_LIVE_MIGRATABLE_V2
+                #    - SEV_SNP_CAPABLE
+                #    - TDX_CAPABLE
+                #    - IDPF
+                #    - SNP_SVSM_CAPABLE
+                #    - CCA_CAPABLE
+                #    - SUSPEND_SAFE_FPR
+                #
+                #
+                # For more information, see
+                # Enabling guest operating system features.
+          },
+        ],
+        "index": 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
+            # boot disk. If you have many disks attached to an instance, each
+            # disk would have a unique index number.
+        "initializeParams": { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+            # alongside the new instance. Use initialization parameters to create boot
+            # disks or local SSDs attached to the new instance.
+            #
+            # This field is persisted and returned for instanceTemplate and not returned
+            # in the context of instance.
+            #
+            # This property is mutually exclusive with the source property;
+            # you can only define one or the other, but not both.
+          "architecture": "A String", # The architecture of the attached disk. Valid values are
+              # arm64 or x86_64.
+          "description": "A String", # An optional description. Provide this property when creating the disk.
+          "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name
+              # of the instance. If a disk with the same name already exists in the given
+              # region, the existing disk is attached to the new instance and the
+              # new disk is not created.
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. The size must be at least
+              # 10 GB. If you specify a sourceImage, which is required for
+              # boot disks, the default size is the size of the sourceImage.
+              # If you do not specify a sourceImage, the default disk size
+              # is 500 GB.
+          "diskType": "A String", # Specifies the disk type used for the boot disk or an additional data
+              # disk. For valid disk type values, see
+              # Supported types for Hyperdisk volumes and
+              # Persistent Disk type variables.
+              #
+              # When creating a single instance, you must provide either the full or
+              # partial URL of the disk type. For example, the following values are
+              # valid:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
+              #      - projects/project/zones/zone/diskTypes/diskType
+              #      - zones/zone/diskTypes/diskType
+              #
+              #
+              #
+              # When creating an instance template, instance flexibility policy, or when
+              # creating or updating an all-instances configuration, you specify the
+              # disk type without a URL, for example, hyperdisk-balanced.
+              #
+              # If you omit this field for a disk, the default disk type depends on
+              # the instance's machine series, as follows.
+              #
+              #
+              #     - For first- and second-generation machine series like N1, N2, T2, and
+              #     M1, the
+              #        default disk type is Standard Persistent Disk
+              #        (pd-standard).
+              #     - For C3, C3D, and M3 the default is Balanced Persistent Disk
+              #     (pd-balanced).
+              #    - For other third-generation machine
+              #     series like A3, H3, Z3, all
+              #         fourth-generation types like C4, N4, M4, and newer machine series,
+              #         the default is Hyperdisk Balanced
+              #         (hyperdisk-balanced).
+              #
+              #
+              #
+              # The disk type you specify must be compatible with the instance's machine
+              # series. For a list of machine series that support Persistent Disk, see Machine
+              # series support for Persistent Disk.
+              #
+              # For a list of machine series that support Hyperdisk, seeMachine
+              # series support for Hyperdisk.
+          "enableConfidentialCompute": True or False, # Whether this disk is using confidential compute mode.
+          "labels": { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
+              # persistent disks.
+            "a_key": "A String",
+          },
+          "licenses": [ # A list of publicly visible licenses. Reserved for Google's use.
+            "A String",
+          ],
+          "onUpdateAction": "A String", # Specifies which action to take on instance update with this disk. Default
+              # is to use the existing disk.
+          "provisionedIops": "A String", # Indicates how many IOPS to provision for the disk. This sets the number
+              # of I/O operations per second that the disk can handle. Values must be
+              # between 10,000 and 120,000. For more details, see theExtreme persistent
+              # disk documentation.
+          "provisionedThroughput": "A String", # Indicates how much throughput to provision for the disk. This sets the
+              # number of throughput mb per second that the disk can handle. Values must
+              # greater than or equal to 1.
+          "replicaZones": [ # Required for each regional disk associated with the instance. Specify
+              # the URLs of the zones where the disk should be replicated to.
+              # You must provide exactly two replica zones, and one zone must be the same
+              # as the instance zone.
+            "A String",
+          ],
+          "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/{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",
+          },
+          "resourcePolicies": [ # Resource policies applied to this disk for automatic snapshot creations.
+              # Specified using the full or partial URL. For instance template, specify
+              # only the resource policy name.
+            "A String",
+          ],
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance boot
+              # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+              # is required.
+              #
+              # To create a disk with one of the public operating system
+              # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
+              #
+              # projects/debian-cloud/global/images/family/debian-9
+              #
+              #
+              # Alternatively, use a specific version of a public operating system image:
+              #
+              # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
+              #
+              #
+              # To create a disk with a custom image that you created, specify the
+              # image name in the following format:
+              #
+              # global/images/my-custom-image
+              #
+              #
+              # You can also specify a custom image by its image family, which returns
+              # the latest version of the image in that family. Replace the image name
+              # with family/family-name:
+              #
+              # global/images/family/my-image-family
+              #
+              #
+              # If the source image is deleted later, this field will not be set.
+          "sourceImageEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source image. Required if the source image is
+              # protected by a customer-supplied encryption key.
+              #
+              # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
+              # encryption keys, so you cannot create disks for instances in a managed instance group if the
+              # source images are encrypted with your own keys.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "sourceSnapshot": "A String", # The source snapshot to create this disk. When creating a new instance
+              # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
+              # is required.
+              #
+              # To create a disk with a snapshot that you created, specify the
+              # snapshot name in the following format:
+              #
+              # global/snapshots/my-backup
+              #
+              #
+              # If the source snapshot is deleted later, this field will not be set.
+              #
+              # Note: You cannot create VMs in bulk using a snapshot as the source. Use
+              # an image instead when you create VMs using
+              # the bulk
+              # insert method.
+          "sourceSnapshotEncryptionKey": { # Thecustomer-supplied
+              # encryption key of the source snapshot.
+            "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+                # For example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                #
+                # The fully-qualifed key name may be returned for resource GET requests. For
+                # example:
+                #
+                # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+                # key_region/cryptoKeys/key
+                # /cryptoKeyVersions/1
+            "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+                # key. If absent, the Compute Engine default service account is used.
+                # For example:
+                #
+                # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+            "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies a 256-bit customer-supplied
+                # encryption key, encoded in RFC
+                # 4648 base64 to either encrypt or decrypt this resource. You can
+                # provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rawKey":
+                # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+            "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+                # customer-supplied encryption key to either encrypt or decrypt this
+                # resource. You can provide either the rawKey or thersaEncryptedKey.
+                # For example:
+                #
+                # "rsaEncryptedKey":
+                # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+                # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+                # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+                #
+                # The key must meet the following requirements before you can provide it to
+                # Compute Engine:
+                #
+                #    1. The key is wrapped using a RSA public key certificate provided by
+                #    Google.
+                #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+                #    encoding.
+                #
+                # Gets the RSA public key certificate provided by Google at:
+                #
+                #
+                # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+            "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+                # [Output only] TheRFC
+                # 4648 base64 encoded SHA-256 hash of the customer-supplied
+                # encryption key that protects this resource.
+          },
+          "storagePool": "A String", # The storage pool in which the new disk is created. 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/zones/zone/storagePools/storagePool
+              #      - projects/project/zones/zone/storagePools/storagePool
+              #    - zones/zone/storagePools/storagePool
+        },
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+            # either SCSI or NVME. For most machine types, the
+            # default is SCSI. Local SSDs can use either NVME or SCSI.
+            # In certain configurations, persistent disks can use NVMe. For more
+            # information, seeAbout
+            # persistent disks.
+        "kind": "compute#attachedDisk", # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
+        "licenses": [ # Output only. [Output Only] Any valid publicly visible licenses.
+          "A String",
+        ],
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
+            # in READ_WRITE mode.
+        "savedState": "A String", # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
+            # field is set to PRESERVED if the LocalSSD data has been saved
+            # to a persistent location by customer request.  (see the
+            # discard_local_ssd option on Stop/Suspend).
+            # Read-only in the api.
+        "shieldedInstanceInitialState": { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
+            # these are public keys which are safe to store in public
+          "dbs": [ # The Key Database (db).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "dbxs": [ # The forbidden key database (dbx).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "keks": [ # The Key Exchange Key (KEK).
+            {
+              "content": "A String", # The raw content in the secure keys file.
+              "fileType": "A String", # The file type of source file.
+            },
+          ],
+          "pk": { # The Platform Key (PK).
+            "content": "A String", # The raw content in the secure keys file.
+            "fileType": "A String", # The file type of source file.
+          },
+        },
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk
+            # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
+            # is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using
+            # this property. This field is only applicable for persistent disks.
+            #
+            # 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.
+      },
+    ],
+    "guestAccelerators": [ # A list of guest accelerator cards' type and count to use for instances
+        # created from these properties.
+      { # A specification of the type and number of accelerator cards attached to the
+          # instance.
+        "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+        "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+            # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+            # If you are creating an instance template, specify only the
+            # accelerator name.
+            # See GPUs on Compute Engine
+            # for a full list of accelerator types.
+      },
+    ],
+    "keyRevocationActionType": "A String", # KeyRevocationActionType of the instance. Supported options are "STOP" and
+        # "NONE". The default value is "NONE" if it is not specified.
+    "labels": { # Labels to apply to instances that are created from these properties.
+      "a_key": "A String",
+    },
+    "localSsdEncryptionMode": "A String", # Specifies which method should be used for encrypting the
+        # Local SSDs attached to the VM.
+    "machineType": "A String", # The machine type to use for instances that are created from these
+        # properties.
+        # This field only accepts a machine type name, for example `n2-standard-4`.
+        # If you use the machine type full or partial URL, for example
+        # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
+        # the request will result in an `INTERNAL_ERROR`.
+    "metadata": { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
+        # these properties. These pairs can consist of custom metadata or predefined
+        # keys. SeeProject and
+        # instance metadata for more information.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve the resource.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be
+          # less than 512 KB.
+        { # Metadata
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following
+              # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
+              # This is reflected as part of a URL in the metadata server. Additionally, to
+              # avoid ambiguity, keys must not conflict with any other metadata keys
+              # for the project.
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only
+              # have meaning as interpreted by the image running in the instance. The
+              # only restriction placed on values is that their size must be less than
+              # or equal to 262144 bytes (256 KiB).
+        },
+      ],
+      "kind": "compute#metadata", # Output only. [Output Only] Type of the resource. Always compute#metadata
+          # for metadata.
+    },
+    "minCpuPlatform": "A String", # Minimum cpu/platform to be used by instances. The instance may be
+        # scheduled on the specified or newer cpu/platform. Applicable values are the
+        # friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more
+        # information, read Specifying a
+        # Minimum CPU Platform.
+    "networkInterfaces": [ # An array of network access configurations for this interface.
+      { # A network interface resource attached to an instance.
+        "accessConfigs": [ # An array of configurations for this interface. Currently, only one access
+            # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
+            # no external internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "aliasIpRanges": [ # An array of alias IP ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "aliasIpv6Ranges": [ # An array of alias IPv6 ranges for this network interface.
+            # You can only specify this field for network interfaces in VPC networks.
+          { # An alias IP range attached to an instance's network interface.
+            "ipCidrRange": "A String", # The IP alias ranges to allocate for this interface. This IP CIDR range
+                # must belong to the specified subnetwork and cannot contain IP addresses
+                # reserved by system or used by other network interfaces. This range may be
+                # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
+            "subnetworkRangeName": "A String", # The name of a subnetwork secondary IP range from which to allocate an IP
+                # alias range. If not specified, the primary range of the subnetwork is used.
+          },
+        ],
+        "enableVpcScopedDns": True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
+            # with network_attachment.
+        "fingerprint": "A String", # Fingerprint hash of contents stored in this network interface.
+            # This field will be ignored when inserting an Instance or
+            # adding a NetworkInterface. An up-to-date
+            # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
+        "igmpQuery": "A String", # Indicate whether igmp query is enabled on the network interface
+            # or not. If enabled, also indicates the version of IGMP supported.
+        "internalIpv6PrefixLength": 42, # The prefix length of the primary internal IPv6 range.
+        "ipv6AccessConfigs": [ # An array of IPv6 access configurations for this interface. Currently, only
+            # one IPv6 access config, DIRECT_IPV6, is supported. If there
+            # is no ipv6AccessConfig specified, then this instance will
+            # have no external IPv6 Internet access.
+          { # An access configuration attached to an instance's network interface.
+              # Only one access config per instance is supported.
+            "externalIpv6": "A String", # Applies to ipv6AccessConfigs only.
+                # The first IPv6 address of the external IPv6 range associated
+                # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
+                # use a static external IP address, it must be unused and in the same region
+                # as the instance's zone. If not specified, Google Cloud will automatically
+                # assign an external IPv6 address from the instance's subnetwork.
+            "externalIpv6PrefixLength": 42, # Applies to ipv6AccessConfigs only. The prefix length of the
+                # external IPv6 range.
+            "kind": "compute#accessConfig", # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
+            "name": "A String", # The name of this access configuration. In accessConfigs
+                # (IPv4), the default and recommended name is External NAT, but
+                # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
+                # recommend name is External IPv6.
+            "natIP": "A String", # Applies to accessConfigs (IPv4) only. Anexternal IP
+                # address associated with this instance. Specify an unused static
+                # external IP address available to the project or leave this field undefined
+                # to use an IP from a shared ephemeral IP address pool. If you specify a
+                # static external IP address, it must live in the same region as the zone of
+                # the instance.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access
+                # configuration and can only take the following values: PREMIUM,STANDARD.
+                #
+                # If an AccessConfig is specified without a valid external IP address, an
+                # ephemeral IP will be created with this networkTier.
+                #
+                # If an AccessConfig with a valid external IP address is specified, it must
+                # match that of the networkTier associated with the Address resource owning
+                # that IP.
+            "publicPtrDomainName": "A String", # The DNS domain name for the public PTR record.
+                #
+                # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
+                # first IP in associated external IPv6 range.
+            "securityPolicy": "A String", # The resource URL for the security policy associated with this access
+                # config.
+            "setPublicPtr": True or False, # Specifies whether a public DNS 'PTR' record should be created to map the
+                # external IP address of the instance to a DNS domain name.
+                #
+                # This field is not used in ipv6AccessConfig. A default PTR
+                # record will be created if the VM has external IPv6 range associated.
+            "type": "A String", # The type of configuration. In accessConfigs (IPv4), the
+                # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
+          },
+        ],
+        "ipv6AccessType": "A String", # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
+            # accessed from the Internet. This field is always inherited from its
+            # subnetwork.
+            #
+            # Valid only if stackType is IPV4_IPV6.
+        "ipv6Address": "A String", # An IPv6 internal network address for this network interface. To
+            # use a static internal IP address, it must be unused and in the same region
+            # as the instance's zone. If not specified, Google Cloud will automatically
+            # assign an internal IPv6 address from the instance's subnetwork.
+        "kind": "compute#networkInterface", # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
+        "name": "A String", # [Output Only] The name of the network interface, which is generated by the
+            # server. For a VM, the network interface uses the nicN naming
+            # format. Where N is a value between 0 and7. The default interface value is nic0.
+        "network": "A String", # URL of the VPC network resource for this instance. When creating an
+            # instance, if neither the network nor the subnetwork is specified, the
+            # default network global/networks/default is used. If the
+            # selected project doesn't have the default network, you must specify a
+            # network or subnet. If the network is not specified but the subnetwork is
+            # specified, the network is inferred.
+            #
+            # If you specify this property, you can specify the network as
+            # a full or partial URL. For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
+            #       - projects/project/global/networks/network
+            #       - global/networks/default
+        "networkAttachment": "A String", # The URL of the network attachment that this interface should connect
+            # to in the following format:
+            # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
+        "networkIP": "A String", # An IPv4 internal IP address to assign to the instance for this network
+            # interface. If not specified by the user, an unused internal IP is
+            # assigned by the system.
+        "nicType": "A String", # The type of vNIC to be used on this interface. This may be gVNIC or
+            # VirtioNet.
+        "parentNicName": "A String", # Name of the parent network interface of a dynamic network interface.
+        "queueCount": 42, # The networking queue count that's specified by users for the network
+            # interface. Both Rx and Tx queues will be set to this number. It'll be empty
+            # if not specified by the users.
+        "serviceClassId": "A String", # Optional. Producer Service's Service class Id for the region of this network
+            # interface. Can only be used with network_attachment. It is not possible to
+            # use on its own however, network_attachment can be used without
+            # service_class_id.
+        "stackType": "A String", # The stack type for this network interface. To assign only IPv4 addresses,
+            # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
+            #
+            # This field can be both set at instance creation and update network
+            # interface operations.
+        "subnetwork": "A String", # The URL of the Subnetwork resource for this instance. If the network
+            # resource is inlegacy
+            # mode, do not specify this field. If the network is in auto subnet
+            # mode, specifying the subnetwork is optional. If the network is in custom
+            # subnet mode, specifying the subnetwork is required. If you specify this
+            # field, you can specify the subnetwork as a full or partial URL. For
+            # example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
+            #    - regions/region/subnetworks/subnetwork
+        "vlan": 42, # VLAN tag of a dynamic network interface, must be  an integer in the range
+            # from 2 to 255 inclusively.
+      },
+    ],
+    "networkPerformanceConfig": { # Note that for MachineImage, this is not supported yet.
+      "totalEgressBandwidthTier": "A String",
+    },
+    "privateIpv6GoogleAccess": "A String", # The private IPv6 google access type for VMs.
+        # If not specified, use  INHERIT_FROM_SUBNETWORK as default.
+        # Note that for MachineImage, this is not supported yet.
+    "reservationAffinity": { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
+        # Note that for MachineImage, this is not supported yet.
+      "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume
+          # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
+          # Consuming reserved instances for examples.
+      "key": "A String", # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
+          # the name of your reservation as its value.
+      "values": [ # Corresponds to the label values of a reservation resource. This can be
+          # either a name to a reservation in the same project or
+          # "projects/different-project/reservations/some-reservation-name" to target a
+          # shared reservation in the same zone but in a different project.
+        "A String",
+      ],
+    },
+    "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/{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",
+    },
+    "resourcePolicies": [ # Resource policies (names, not URLs) applied to instances created from
+        # these properties.
+        # Note that for MachineImage, this is not supported yet.
+      "A String",
+    ],
+    "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
+        # these properties.
+      "automaticRestart": True or False, # Specifies whether the instance should be automatically restarted if it is
+          # terminated by Compute Engine (not terminated by a user). You can only set
+          # the automatic restart option for standard instances.Preemptible instances
+          # cannot be automatically restarted.
+          #
+          # By default, this is set to true so an instance is
+          # automatically restarted if it is terminated by Compute Engine.
+      "availabilityDomain": 42, # Specifies the availability domain to place the instance in. The value
+          # must be a number between 1 and the number of availability domains
+          # specified in the spread placement policy attached to the instance.
+      "exposeHostTopology": True or False, # This optional flag exposes the hashed physical host ID in the
+          # ResourceStatus resource of the VM.
+      "gracefulShutdown": { # The configuration for gracefully shutting down the instance.
+        "enabled": True or False, # Opts-in for graceful shutdown.
+        "maxDuration": { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
+            # graceful shutdown isn't complete after this time, then the instance
+            # transitions to the STOPPING state.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "hostErrorTimeoutSeconds": 42, # Specify the time in seconds for host error detection, the value must be
+          # within the range of [90, 330] with the increment of 30, if unset, the
+          # default behavior of host error recovery will be used.
+      "instanceTerminationAction": "A String", # Specifies the termination action for the instance.
+      "localSsdRecoveryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
+          # recovery of the Local Ssd state is attempted. Its value should be in
+          # between 0 and 168 hours with hour granularity and the default value being 1
+          # hour.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "locationHint": "A String", # An opaque location hint used to place the instance close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "maxRunDuration": { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
+          # the instance termination action will be performed at the end of the run
+          # duration.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "minNodeCpus": 42, # The minimum number of virtual CPUs this instance will consume when running
+          # on a sole-tenant node.
+      "nodeAffinities": [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
+          # affinity for more information.
+          # Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which this Instance
+            #  could be scheduled.
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "onHostMaintenance": "A String", # Defines the maintenance behavior for this instance. For standard instances,
+          # the default behavior is MIGRATE. Forpreemptible instances,
+          # the default and only possible behavior is TERMINATE. For more
+          # information, see
+          #  Set
+          #  VM host maintenance policy.
+      "onInstanceStopAction": { # Defines the behaviour for instances with the instance_termination_actionSTOP.
+        "discardLocalSsd": True or False, # If true, the contents of any attached Local SSD disks will be discarded
+            # else, the Local SSD data will be preserved when the instance is stopped
+            # at the end of the run duration/termination time.
+      },
+      "preemptible": True or False, # Defines whether the instance is preemptible. This can only be set during
+          # instance creation or while the instance isstopped and
+          # therefore, in a `TERMINATED` state. SeeInstance Life
+          # Cycle for more information on the possible instance states.
+      "preemptionNoticeDuration": { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2
+          # Soft Off signal is triggered for Spot VMs only. If not specified,
+          # there will be no wait before the G2 Soft Off signal is triggered.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "provisioningModel": "A String", # Specifies the provisioning model of the instance.
+      "skipGuestOsShutdown": True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
+          # Off and ACPI G3 Mechanical
+          # Off for Standard VMs and 30 seconds for Spot VMs.
+      "terminationTime": "A String", # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
+          # termination action will be performed at the termination time.
+    },
+    "serviceAccounts": [ # A list of service accounts with specified scopes. Access tokens for these
+        # service accounts are available to the instances that are created from
+        # these properties. Use metadata queries to obtain the access tokens for
+        # these instances.
+      { # A service account.
+        "email": "A String", # Email address of the service account.
+        "scopes": [ # The list of scopes to be made available for this service account.
+          "A String",
+        ],
+      },
+    ],
+    "shieldedInstanceConfig": { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
+      "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
+          # default.
+      "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
+          # default.
+      "enableVtpm": True or False, # Defines whether the instance has the vTPM enabled.Enabled by
+          # default.
+    },
+    "tags": { # A set of instance tags. # A list of tags to apply to the instances that are created from these
+        # properties. The tags identify valid sources or targets for network
+        # firewalls. The setTags method can modify this list of tags. Each tag within
+        # the list must comply with RFC1035.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of
+          # the tags' contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update tags. You must always provide an
+          # up-to-date fingerprint hash in order to update or change tags.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # instance.
+      "items": [ # An array of tags. Each tag must be 1-63 characters long, and comply
+          # with RFC1035.
+        "A String",
+      ],
+    },
+    "workloadIdentityConfig": {
+      "identity": "A String",
+      "identityCertificateEnabled": True or False,
+    },
+  },
+  "locationPolicy": { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
+      # bulk.
+      # (e.g. preferences for zone selection among zones in a single region).
+    "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.
+          "maxCount": 42, # Maximum number of items that are allowed to be placed in this zone.
+              # The value must be non-negative.
+        },
+        "preference": "A String", # Preference for a given location. Set to either ALLOW orDENY.
+      },
+    },
+    "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
+      # be created and instances already created will be deleted.
+  "namePattern": "A String", # The string pattern used for the names of the VMs.
+      # Either name_pattern or per_instance_properties
+      # must be set. The pattern must contain one continuous sequence of
+      # placeholder hash characters (#) with each character corresponding to one
+      # digit of the generated instance name. Example: a name_pattern
+      # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
+      # in the same project and zone have names that match the name pattern
+      # then the generated instance numbers start after the biggest
+      # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
+      # placeholder #...# can contain up to 18 characters.
+  "perInstanceProperties": { # Per-instance properties to be set on individual instances.
+      # Keys of this map specify requested instance names.
+      # Can be empty if name_pattern is used.
+    "a_key": { # Per-instance properties to be set on individual instances.
+        # To be extended in the future.
+      "hostname": "A String", # Specifies the hostname of the instance. More details in:
+          # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
+      "name": "A String", # Output only. This field is only temporary. It will be removed. Do not use it.
+    },
+  },
+  "sourceInstanceTemplate": "A String", # Specifies the instance template from which to create instances. You may
+      # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
+      # existing instance template. Bulk API follows the semantics of JSON Merge
+      # Patch described by RFC
+      # 7396.
+      # 
+      # It can be a full or partial URL. For example, the following are
+      # all valid URLs to an instance template:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+      #       - projects/project/global/instanceTemplates/instanceTemplate
+      #       - global/instanceTemplates/instanceTemplate
+      # 
+      # 
+      # 
+      # This field is optional.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionInstantSnapshotGroups.html b/docs/dyn/compute_preview.regionInstantSnapshotGroups.html new file mode 100644 index 0000000000..01ace31c39 --- /dev/null +++ b/docs/dyn/compute_preview.regionInstantSnapshotGroups.html @@ -0,0 +1,2281 @@ + + + +

Compute Engine API . regionInstantSnapshotGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, instantSnapshotGroup, requestId=None, x__xgafv=None)

+

deletes a Regional InstantSnapshotGroup resource

+

+ get(project, region, instantSnapshotGroup, x__xgafv=None)

+

returns the specified InstantSnapshotGroup resource in the specified

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)

+

creates a Regional InstantSnapshotGroup resource

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

retrieves the list of InstantSnapshotGroup resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, instantSnapshotGroup, requestId=None, x__xgafv=None) + 
deletes a Regional InstantSnapshotGroup resource
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instantSnapshotGroup: string, Name of the InstantSnapshotGroup 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instantSnapshotGroup, x__xgafv=None) + 
returns the specified InstantSnapshotGroup resource in the specified
+region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instantSnapshotGroup: string, Name of the InstantSnapshotGroup 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 an InstantSnapshotGroup resource.
+    #
+    # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+      # 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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": {
+    "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+    "sourceInfo": { # Output only. [Output Only]
+      "consistencyGroup": "A String",
+      "consistencyGroupId": "A String",
+    },
+  },
+  "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.
+  "sourceConsistencyGroup": "A String",
+  "status": "A String", # Output only. [Output Only]
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None) + 
creates a Regional InstantSnapshotGroup resource
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an InstantSnapshotGroup resource.
+    # 
+    # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+      # 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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": {
+    "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+    "sourceInfo": { # Output only. [Output Only]
+      "consistencyGroup": "A String",
+      "consistencyGroupId": "A String",
+    },
+  },
+  "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.
+  "sourceConsistencyGroup": "A String",
+  "status": "A String", # Output only. [Output Only]
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  sourceConsistencyGroup: string, begin_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
retrieves the list of InstantSnapshotGroup resources contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region 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.
+  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 InstantSnapshotGroup resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstantSnapshotGroup resources.
+    { # Represents an InstantSnapshotGroup resource.
+        #
+        # An instant snapshot group is a set of instant 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#instantSnapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup
+          # 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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot group resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "resourceStatus": {
+        "consistencyMembershipResolutionTime": "A String", # Output only. [Output Only]
+        "sourceInfo": { # Output only. [Output Only]
+          "consistencyGroup": "A String",
+          "consistencyGroupId": "A String",
+        },
+      },
+      "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.
+      "sourceConsistencyGroup": "A String",
+      "status": "A String", # Output only. [Output Only]
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot group resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#instantSnapshotGroupsList", # 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, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.regionInstantSnapshots.html b/docs/dyn/compute_preview.regionInstantSnapshots.html new file mode 100644 index 0000000000..7f634f1bf3 --- /dev/null +++ b/docs/dyn/compute_preview.regionInstantSnapshots.html @@ -0,0 +1,2776 @@ + + + +

Compute Engine API . regionInstantSnapshots

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, instantSnapshot, requestId=None, x__xgafv=None)

+

Deletes the specified InstantSnapshot resource. Keep in mind that deleting

+

+ get(project, region, instantSnapshot, x__xgafv=None)

+

Returns the specified InstantSnapshot resource in the specified region.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates an instant snapshot in the specified region.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of InstantSnapshot resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a instantSnapshot in the given region. To learn more

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, instantSnapshot, requestId=None, x__xgafv=None) + 
Deletes the specified InstantSnapshot resource. Keep in mind that deleting
+a single instantSnapshot might not necessarily delete all the data on that
+instantSnapshot. If any data on the instantSnapshot that is marked for
+deletion is needed for subsequent instantSnapshots, the data will be moved
+to the next corresponding instantSnapshot.
+
+For more information, seeDeleting
+instantSnapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instantSnapshot: string, Name of the InstantSnapshot 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, instantSnapshot, x__xgafv=None) + 
Returns the specified InstantSnapshot resource in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  instantSnapshot: string, Name of the InstantSnapshot 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 InstantSnapshot resource.
+    #
+    # You can use instant snapshots to create disk rollback points quickly..
+  "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+      # ARM64 or X86_64.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a InstantSnapshot.
+  "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "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.
+  "params": { # Additional instant snapshot 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 instant 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+    "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "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.
+  "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+      # Note that the source disk must be in the same zone/region as the
+      # instant snapshot to be created. This can be a full or valid partial URL.
+      # For example, the following are valid values:
+      #
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      #
+      #      -
+      #        projects/project/regions/region/disks/disk
+      #
+      #      -
+      #        zones/zone/disks/disk
+      #
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+      # This value may be used to determine whether the InstantSnapshot
+      # was taken from the current or a previous instance of a given disk name.
+  "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+      # part of. Note that the source instant snapshot group must be in the same
+      # zone/region as the instant snapshot to be created. This can be a full or
+      # valid partial URL.
+  "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+      # InstantSnapshot is part of. This value may be used to determine whether the
+      # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+  "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates an instant snapshot in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a InstantSnapshot resource.
+    # 
+    # You can use instant snapshots to create disk rollback points quickly..
+  "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+      # ARM64 or X86_64.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a InstantSnapshot.
+  "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "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.
+  "params": { # Additional instant snapshot 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 instant 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+    "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+  },
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "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.
+  "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+      # Note that the source disk must be in the same zone/region as the
+      # instant snapshot to be created. This can be a full or valid partial URL.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        projects/project/zones/zone/disks/disk
+      # 
+      #      -
+      #        projects/project/regions/region/disks/disk
+      # 
+      #      -
+      #        zones/zone/disks/disk
+      # 
+      #      -
+      #        regions/region/disks/disk
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+      # This value may be used to determine whether the InstantSnapshot
+      # was taken from the current or a previous instance of a given disk name.
+  "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+      # part of. Note that the source instant snapshot group must be in the same
+      # zone/region as the instant snapshot to be created. This can be a full or
+      # valid partial URL.
+  "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+      # InstantSnapshot is part of. This value may be used to determine whether the
+      # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+  "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of InstantSnapshot resources contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region 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.
+  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 InstantSnapshot resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of InstantSnapshot resources.
+    { # Represents a InstantSnapshot resource.
+        #
+        # You can use instant snapshots to create disk rollback points quickly..
+      "architecture": "A String", # Output only. [Output Only] The architecture of the instant snapshot. Valid values are
+          # ARM64 or X86_64.
+      "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.
+      "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#instantSnapshot", # Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this InstantSnapshot, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a InstantSnapshot.
+      "labels": { # Labels to apply to this InstantSnapshot. These can be later modified by
+          # the setLabels method.
+          # Label values may be empty.
+        "a_key": "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.
+      "params": { # Additional instant snapshot 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 instant 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/{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",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the instant snapshot resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "resourceStatus": { # Output only. [Output Only] Status information for the instant snapshot resource.
+        "storageSizeBytes": "A String", # [Output Only] The storage size of this instant snapshot.
+      },
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "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.
+      "sourceDisk": "A String", # URL of the source disk used to create this instant snapshot.
+          # Note that the source disk must be in the same zone/region as the
+          # instant snapshot to be created. This can be a full or valid partial URL.
+          # For example, the following are valid values:
+          #
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        projects/project/zones/zone/disks/disk
+          #
+          #      -
+          #        projects/project/regions/region/disks/disk
+          #
+          #      -
+          #        zones/zone/disks/disk
+          #
+          #      -
+          #        regions/region/disks/disk
+      "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.
+          # This value may be used to determine whether the InstantSnapshot
+          # was taken from the current or a previous instance of a given disk name.
+      "sourceInstantSnapshotGroup": "A String", # Output only. [Output Only] URL of the source instant snapshot this instant snapshot is
+          # part of. Note that the source instant snapshot group must be in the same
+          # zone/region as the instant snapshot to be created. This can be a full or
+          # valid partial URL.
+      "sourceInstantSnapshotGroupId": "A String", # Output only. [Output Only] The ID value of the source instant snapshot group this
+          # InstantSnapshot is part of. This value may be used to determine whether the
+          # InstantSnapshot was created as part of an InstantSnapshotGroup creation.
+      "status": "A String", # Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the instant snapshot resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#instantSnapshotList", # 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.
+  "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, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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).
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a instantSnapshot in the given region. To learn more
+about labels, read the Labeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.regionNetworkEndpointGroups.html b/docs/dyn/compute_preview.regionNetworkEndpointGroups.html new file mode 100644 index 0000000000..6b39c7e37d --- /dev/null +++ b/docs/dyn/compute_preview.regionNetworkEndpointGroups.html @@ -0,0 +1,2314 @@ + + + +

Compute Engine API . regionNetworkEndpointGroups

+

Instance Methods

+

+ attachNetworkEndpoints(project, region, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Attach a list of network endpoints to the specified network endpoint group.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, networkEndpointGroup, requestId=None, x__xgafv=None)

+

Deletes the specified network endpoint group. Note that the NEG cannot be

+

+ detachNetworkEndpoints(project, region, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

+

Detach the network endpoint from the specified network endpoint group.

+

+ get(project, region, networkEndpointGroup, x__xgafv=None)

+

Returns the specified network endpoint group.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a network endpoint group in the specified project using the

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of regional network endpoint groups available to the

+

+ listNetworkEndpoints(project, region, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the network endpoints in the specified network endpoint group.

+

+ listNetworkEndpoints_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ attachNetworkEndpoints(project, region, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Attach a list of network endpoints to the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region where
+you want to create the network endpoint group. It should comply with
+RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group where you are attaching network
+endpoints to. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be attached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, networkEndpointGroup, requestId=None, x__xgafv=None) + 
Deletes the specified network endpoint group. Note that the NEG cannot be
+deleted if it is configured as a backend of a backend service.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group to delete. It should comply with
+RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ detachNetworkEndpoints(project, region, networkEndpointGroup, body=None, requestId=None, x__xgafv=None) + 
Detach the network endpoint from the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region where
+the network endpoint group is located. It should comply with
+RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group you are detaching network
+endpoints from. It should comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "networkEndpoints": [ # The list of network endpoints to be detached.
+    { # The network endpoint.
+      "annotations": { # Optional metadata defined as annotations on the network endpoint.
+        "a_key": "A String",
+      },
+      "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+          #
+          # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+      "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+          # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+      "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+          # Optional, the field presence depends on the network endpoint type. The
+          # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+          #
+          # The instance must be in the same zone of network endpoint group (for zonal
+          # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+          # If the ipAddress is specified, it must belongs to the VM
+          # instance.
+          #
+          # The name must be 1-63 characters long, and comply withRFC1035
+          # or be a valid URL pointing to an existing instance.
+      "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+          # VM in Compute Engine (either the primary IP or as part of an aliased IP
+          # range). If the IP address is not specified, then the primary IP address for
+          # the VM instance in the network that the network endpoint group belongs to
+          # will be used.
+          #
+          # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+          # address of the attached VM instance that matches the subnetwork of the NEG.
+          # The primary internal IP address from any NIC of a multi-NIC VM instance can
+          # be added to a NEG as long as it matches the NEG subnetwork.
+      "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+      "port": 42, # Optional port number of network endpoint. If not specified, the
+          # defaultPort for the network endpoint group will be used.
+          #
+          # This field can not be set for network endpoints of typeGCE_VM_IP.
+    },
+  ],
+}
+
+  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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, networkEndpointGroup, x__xgafv=None) + 
Returns the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region where
+the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group. It should comply with RFC1035. (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 collection of network endpoints.
+    #
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    #
+    # Note: Use the following APIs to manage network endpoint groups:
+    #
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      #
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      #
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a network endpoint group in the specified project using the
+parameters that are included in the request.
+
+Note: Use the following APIs to manage network endpoint groups:
+   
+   - 
+   To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+   NEGs): zonal
+   API
+   - 
+   To manage NEGs with regional scope (such as regional internet NEGs,
+   serverless NEGs, Private Service Connect NEGs): regional
+   API
+   - 
+   To manage NEGs with global scope (such as global internet NEGs):global
+   API
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region where
+you want to create the network endpoint group. It should comply with
+RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a collection of network endpoints.
+    # 
+    # A network endpoint group (NEG) defines how a set of endpoints should be
+    # reached, whether they are reachable, and where they are located.
+    # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+    # 
+    # Note: Use the following APIs to manage network endpoint groups:
+    # 
+    #    -
+    #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+    #    NEGs): zonal
+    #    API
+    #    -
+    #    To manage NEGs with regional scope (such as regional internet NEGs,
+    #    serverless NEGs, Private Service Connect NEGs): regional
+    #    API
+    #    -
+    #    To manage NEGs with global scope (such as global internet NEGs):global
+    #    API
+  "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+    "a_key": "A String",
+  },
+  "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service is optional, may be provided explicitly or in the
+      # URL mask. The version is optional and can only be provided
+      # explicitly or in the URL mask when service is present.
+      #
+      # Note: App Engine service must be in the same project and located in the
+      # same region as the Serverless NEG.
+    "service": "A String", # Optional serving service.
+        #
+        # The service name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: default, my-service.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse service and version fields
+        # from a request URL. URL mask allows for routing to multiple App Engine
+        # services without having to create multiple Network Endpoint Groups and
+        # backend services.
+        #
+        # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+        # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+        # The URL mask will parse them to { service = "foo1", version = "v1"
+        # } and { service = "foo1", version = "v2" }
+        # respectively.
+    "version": "A String", # Optional serving version.
+        #
+        # The version name is case-sensitive and must be 1-100
+        # characters long.
+        #
+        # Example value: v1, v2.
+  },
+  "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The function must be provided explicitly or in the URL mask.
+      #
+      # Note: Cloud Function must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "function": "A String", # A user-defined name of the Cloud Function.
+        #
+        # The function name is case-sensitive and must be 1-63
+        # characters long.
+        #
+        # Example value: func1.
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse function field from a request URL. URL
+        # mask allows for routing to multiple Cloud Functions without having to
+        # create multiple Network Endpoint Groups and backend services.
+        #
+        # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+        # Serverless NEG with URL mask /<function>. The URL
+        # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+  },
+  "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+      # The service must be provided explicitly or in the URL mask.
+      # The tag is optional, may be provided explicitly or in the URL
+      # mask.
+      #
+      # Note: Cloud Run service must be in the same project and located in the same
+      # region as the Serverless NEG.
+    "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+        #
+        # The service must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "run-service".
+    "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+        # fine-grained traffic routing information.
+        #
+        # The tag must be 1-63 characters long, and comply withRFC1035.
+        #
+        # Example value: "revision-0010".
+    "urlMask": "A String", # An URL
+        # mask is one of the main components of the Cloud Function.
+        #
+        # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+        # routing to multiple Run services without having to create multiple
+        # network endpoint groups and backend services.
+        #
+        # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+        # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+        # parse them to { service="bar1", tag="foo1" } and {
+        # service="bar2", tag="foo2" } respectively.
+  },
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultPort": 42, # The default port used if the port number is not specified in the network
+      # endpoint.
+      # 
+      # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+      # field must not be specified.
+  "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+  "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+      # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+      # if this field is not specified, a default network will be used.
+      # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+      # global NEGs.
+      # For all other network endpoint types, this field is required.
+  "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+  "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      # type PRIVATE_SERVICE_CONNECT.
+    "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+        # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+        # L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+        # the PSC Producer side; should only be used for the
+        # PRIVATE_SERVICE_CONNECT NEG type
+    "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+        # Consumer.
+    "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+  },
+  "pscTargetService": "A String", # The target service url used to set up private service connection to
+      # a Google API or a PSC Producer Service Attachment.
+      # An example value is: asia-northeast3-cloudkms.googleapis.com.
+      # 
+      # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+  "region": "A String", # Output only. [Output Only] The URL of theregion
+      # where the network endpoint group is located.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+  "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+      # belong.
+  "zone": "A String", # Output only. [Output Only] The URL of thezone
+      # where the network endpoint group is located.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of regional network endpoint groups available to the
+specified project in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of theregion
+where the network endpoint group is located. It should comply with 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.
+  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 NetworkEndpointGroup resources.
+    { # Represents a collection of network endpoints.
+        #
+        # A network endpoint group (NEG) defines how a set of endpoints should be
+        # reached, whether they are reachable, and where they are located.
+        # For more information about using NEGs for different use cases, seeNetwork endpoint groups overview.
+        #
+        # Note: Use the following APIs to manage network endpoint groups:
+        #
+        #    -
+        #    To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity
+        #    NEGs): zonal
+        #    API
+        #    -
+        #    To manage NEGs with regional scope (such as regional internet NEGs,
+        #    serverless NEGs, Private Service Connect NEGs): regional
+        #    API
+        #    -
+        #    To manage NEGs with global scope (such as global internet NEGs):global
+        #    API
+      "annotations": { # Optional. Metadata defined as annotations on the network endpoint group.
+        "a_key": "A String",
+      },
+      "appEngine": { # Configuration for an App Engine network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service is optional, may be provided explicitly or in the
+          # URL mask. The version is optional and can only be provided
+          # explicitly or in the URL mask when service is present.
+          #
+          # Note: App Engine service must be in the same project and located in the
+          # same region as the Serverless NEG.
+        "service": "A String", # Optional serving service.
+            #
+            # The service name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: default, my-service.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse service and version fields
+            # from a request URL. URL mask allows for routing to multiple App Engine
+            # services without having to create multiple Network Endpoint Groups and
+            # backend services.
+            #
+            # For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same
+            # Serverless NEG with URL mask<service>-dot-appname.appspot.com/<version>.
+            # The URL mask will parse them to { service = "foo1", version = "v1"
+            # } and { service = "foo1", version = "v2" }
+            # respectively.
+        "version": "A String", # Optional serving version.
+            #
+            # The version name is case-sensitive and must be 1-100
+            # characters long.
+            #
+            # Example value: v1, v2.
+      },
+      "cloudFunction": { # Configuration for a Cloud Function network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The function must be provided explicitly or in the URL mask.
+          #
+          # Note: Cloud Function must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "function": "A String", # A user-defined name of the Cloud Function.
+            #
+            # The function name is case-sensitive and must be 1-63
+            # characters long.
+            #
+            # Example value: func1.
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse function field from a request URL. URL
+            # mask allows for routing to multiple Cloud Functions without having to
+            # create multiple Network Endpoint Groups and backend services.
+            #
+            # For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same
+            # Serverless NEG with URL mask /<function>. The URL
+            # mask will parse them to { function = "function1" } and{ function = "function2" } respectively.
+      },
+      "cloudRun": { # Configuration for a Cloud Run network endpoint group (NEG). # Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set.
+          # The service must be provided explicitly or in the URL mask.
+          # The tag is optional, may be provided explicitly or in the URL
+          # mask.
+          #
+          # Note: Cloud Run service must be in the same project and located in the same
+          # region as the Serverless NEG.
+        "service": "A String", # Cloud Run service is the main resource of Cloud Run.
+            #
+            # The service must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "run-service".
+        "tag": "A String", # Optional Cloud Run tag represents the "named-revision" to provide additional
+            # fine-grained traffic routing information.
+            #
+            # The tag must be 1-63 characters long, and comply withRFC1035.
+            #
+            # Example value: "revision-0010".
+        "urlMask": "A String", # An URL
+            # mask is one of the main components of the Cloud Function.
+            #
+            # A template to parse <service> and<tag> fields from a request URL. URL mask allows for
+            # routing to multiple Run services without having to create multiple
+            # network endpoint groups and backend services.
+            #
+            # For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless
+            # Network Endpoint Group (NEG) with URL mask<tag>.domain.com/<service>. The URL mask will
+            # parse them to { service="bar1", tag="foo1" } and {
+            # service="bar2", tag="foo2" } respectively.
+      },
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultPort": 42, # The default port used if the port number is not specified in the network
+          # endpoint.
+          #
+          # Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this
+          # field must not be specified.
+      "description": "A String", # 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#networkEndpointGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint 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.
+      "network": "A String", # The URL of the network to which all network endpoints in the NEG belong.
+          # For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,
+          # if this field is not specified, a default network will be used.
+          # This field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for
+          # global NEGs.
+          # For all other network endpoint types, this field is required.
+      "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
+      "pscData": { # All data that is specifically relevant to only network endpoint groups of # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+          # type PRIVATE_SERVICE_CONNECT.
+        "consumerPscAddress": "A String", # Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP
+            # address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in
+            # L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on
+            # the PSC Producer side; should only be used for the
+            # PRIVATE_SERVICE_CONNECT NEG type
+        "pscConnectionId": "A String", # Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group
+            # Consumer.
+        "pscConnectionStatus": "A String", # Output only. [Output Only] The connection status of the PSC Forwarding Rule.
+      },
+      "pscTargetService": "A String", # The target service url used to set up private service connection to
+          # a Google API or a PSC Producer Service Attachment.
+          # An example value is: asia-northeast3-cloudkms.googleapis.com.
+          #
+          # Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.
+      "region": "A String", # Output only. [Output Only] The URL of theregion
+          # where the network endpoint group is located.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "size": 42, # Output only. [Output only] Number of network endpoints in the network endpoint group.
+      "subnetwork": "A String", # Optional URL of the subnetwork to which all network endpoints in the NEG
+          # belong.
+      "zone": "A String", # Output only. [Output Only] The URL of thezone
+          # where the network endpoint group is located.
+    },
+  ],
+  "kind": "compute#networkEndpointGroupList", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group
+      # lists.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints(project, region, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the network endpoints in the specified network endpoint group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of theregion
+where the network endpoint group is located. It should comply with RFC1035. (required)
+  networkEndpointGroup: string, The name of the network endpoint group from which you want to generate a
+list of included network endpoints. It should comply with 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.
+  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 NetworkEndpointWithHealthStatus resources.
+    {
+      "healths": [ # Output only. [Output only] The health status of network endpoint.
+          #
+          # Optional. Displayed only if the network endpoint has centralized health
+          # checking configured.
+        {
+          "backendService": { # URL of the backend service associated with the health state of the network
+              # endpoint.
+            "backendService": "A String",
+          },
+          "forwardingRule": { # URL of the forwarding rule associated with the health state of the network
+              # endpoint.
+            "forwardingRule": "A String",
+          },
+          "healthCheck": { # A full or valid partial URL to a health check. For example, the following are # URL of the health check associated with the health state of the network
+              # endpoint.
+              # valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+              #    - projects/project-id/global/httpHealthChecks/health-check
+              #    - global/httpHealthChecks/health-check
+            "healthCheck": "A String",
+          },
+          "healthCheckService": { # A full or valid partial URL to a health check service. For example, the # URL of the health check service associated with the health state of the
+              # network endpoint.
+              # following are valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - projects/project-id/regions/us-west1/healthCheckServices/health-check-service
+              #    - regions/us-west1/healthCheckServices/health-check-service
+            "healthCheckService": "A String",
+          },
+          "healthState": "A String", # Health state of the network endpoint determined based on the health checks
+              # configured.
+          "ipv6HealthState": "A String", # Health state of the ipv6 network endpoint determined based on the health
+              # checks configured.
+        },
+      ],
+      "networkEndpoint": { # The network endpoint. # Output only. [Output only] The network endpoint.
+        "annotations": { # Optional metadata defined as annotations on the network endpoint.
+          "a_key": "A String",
+        },
+        "clientDestinationPort": 42, # Represents the port number to which PSC consumer sends packets.
+            #
+            # Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.
+        "fqdn": "A String", # Optional fully qualified domain name of network endpoint. This can only be
+            # specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.
+        "instance": "A String", # The name or a URL of VM instance of this network endpoint.
+            # Optional, the field presence depends on the network endpoint type. The
+            # field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.
+            #
+            # The instance must be in the same zone of network endpoint group (for zonal
+            # NEGs) or in the zone within the region of the NEG (for regional NEGs).
+            # If the ipAddress is specified, it must belongs to the VM
+            # instance.
+            #
+            # The name must be 1-63 characters long, and comply withRFC1035
+            # or be a valid URL pointing to an existing instance.
+        "ipAddress": "A String", # Optional IPv4 address of network endpoint. The IP address must belong to a
+            # VM in Compute Engine (either the primary IP or as part of an aliased IP
+            # range). If the IP address is not specified, then the primary IP address for
+            # the VM instance in the network that the network endpoint group belongs to
+            # will be used.
+            #
+            # This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP
+            # address of the attached VM instance that matches the subnetwork of the NEG.
+            # The primary internal IP address from any NIC of a multi-NIC VM instance can
+            # be added to a NEG as long as it matches the NEG subnetwork.
+        "ipv6Address": "A String", # Optional IPv6 address of network endpoint.
+        "port": 42, # Optional port number of network endpoint. If not specified, the
+            # defaultPort for the network endpoint group will be used.
+            #
+            # This field can not be set for network endpoints of typeGCE_VM_IP.
+      },
+    },
+  ],
+  "kind": "compute#networkEndpointGroupsListNetworkEndpoints", # Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list
+      # of network endpoints in the specified network endpoint group.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listNetworkEndpoints_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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionNetworkFirewallPolicies.html b/docs/dyn/compute_preview.regionNetworkFirewallPolicies.html new file mode 100644 index 0000000000..5d96c7456a --- /dev/null +++ b/docs/dyn/compute_preview.regionNetworkFirewallPolicies.html @@ -0,0 +1,7678 @@ + + + +

Compute Engine API . regionNetworkFirewallPolicies

+

Instance Methods

+

+ addAssociation(project, region, firewallPolicy, associatedPolicyToBeReplaced=None, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None)

+

Inserts an association for the specified network firewall policy.

+

+ addRule(project, region, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None)

+

Inserts a rule into a network firewall policy.

+

+ cloneRules(project, region, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

+

Copies rules to the specified network firewall policy.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, firewallPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified network firewall policy.

+

+ get(project, region, firewallPolicy, x__xgafv=None)

+

Returns the specified network firewall policy.

+

+ getAssociation(project, region, firewallPolicy, name=None, x__xgafv=None)

+

Gets an association with the specified name.

+

+ getEffectiveFirewalls(project, region, network, x__xgafv=None)

+

Returns the effective firewalls on a given network.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getRule(project, region, firewallPolicy, priority=None, x__xgafv=None)

+

Gets a rule of the specified priority.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a new network firewall policy in the specified project and region.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all the network firewall policies that have been configured

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified network firewall policy.

+

+ patchAssociation(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None)

+

Updates an association for the specified network firewall policy.

+

+ patchRule(project, region, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None)

+

Patches a rule of the specified priority.

+

+ removeAssociation(project, region, firewallPolicy, name=None, requestId=None, x__xgafv=None)

+

Removes an association for the specified network firewall policy.

+

+ removeRule(project, region, firewallPolicy, priority=None, requestId=None, x__xgafv=None)

+

Deletes a rule of the specified priority.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ addAssociation(project, region, firewallPolicy, associatedPolicyToBeReplaced=None, body=None, replaceExistingAssociation=None, requestId=None, x__xgafv=None) + 
Inserts an association for the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+  associatedPolicyToBeReplaced: string, Name of the firewall policy associated with the target network to swap
+association with. This field is mutually exclusive with
+'replace_existing_association'.
+  replaceExistingAssociation: boolean, Indicates whether or not to replace it if an association already exists.
+This is false by default, in which case an error will be returned if an
+association already exists.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addRule(project, region, firewallPolicy, body=None, maxPriority=None, minPriority=None, requestId=None, x__xgafv=None) + 
Inserts a rule into a network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  maxPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  minPriority: integer, When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.
+This field is exclusive with rule.priority.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ cloneRules(project, region, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None) + 
Copies rules to the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (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).
+  sourceFirewallPolicy: string, The firewall policy from which to copy rules.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, firewallPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, firewallPolicy, x__xgafv=None) + 
Returns the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to get. (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 Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      #
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+ +
+ getAssociation(project, region, firewallPolicy, name=None, x__xgafv=None) + 
Gets an association with the specified name.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to which the queried association belongs. (required)
+  name: string, The name of the association to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+ +
+ getEffectiveFirewalls(project, region, network, x__xgafv=None) + 
Returns the effective firewalls on a given network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  network: string, Network reference (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "firewallPolicys": [ # Output only. [Output only] Effective firewalls from firewall policy. It applies to
+      # Regional Network Firewall Policies in the specified region, Global Network
+      # Firewall Policies and Hierachial Firewall Policies which are associated
+      # with the network.
+    {
+      "displayName": "A String", # Output only. [Output Only] The display name of the firewall policy.
+      "name": "A String", # Output only. [Output Only] The name of the firewall policy.
+      "packetMirroringRules": [ # Output only. [Output only] The packet mirroring rules that apply to the network.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "priority": 42, # Output only. [Output only] Priority of firewall policy association. Not applicable for
+          # type=HIERARCHY.
+      "rules": [ # Output only. [Output only] The rules that apply to the network.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "type": "A String", # Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,
+          # NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.
+    },
+  ],
+  "firewalls": [ # Effective firewalls on the network.
+    { # Represents a Firewall Rule resource.
+        #
+        # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+        # instances. For more information, readFirewall rules.
+      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a permitted connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a
+          # protocol and port-range tuple that describes a denied connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+              # required when creating a firewall rule. This value can either be one of the
+              # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies.
+              # This field is only applicable for the UDP or TCP protocol.
+              # Each entry must be either an integer or a range.
+              # If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"],
+              # and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "destinationRanges": [ # If destination ranges are specified, the firewall rule applies only to
+          # traffic that has destination IP address in these ranges. These ranges must
+          # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "direction": "A String", # Direction of traffic to which this firewall applies, either `INGRESS` or
+          # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
+          # specify the sourceTags fields.
+      "disabled": True or False, # Denotes whether the firewall rule is disabled. When set to true, the
+          # firewall rule is not enforced and the network behaves as if it did not
+          # exist. If this is unspecified, the firewall rule will be enabled.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewall", # Output only. [Output Only] Type of the resource. Always compute#firewall
+          # for firewall rules.
+      "logConfig": { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
+          # logging is enabled, logs will be exported to Cloud Logging.
+        "enable": True or False, # This field denotes whether to enable logging for a particular firewall
+            # rule.
+        "metadata": "A String", # This field can only be specified for a particular firewall rule if
+            # logging is enabled for that rule. This field denotes whether to include
+            # or exclude metadata for firewall logs.
+      },
+      "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])?`. The first character
+          # must be a lowercase letter, and all following characters (except for the
+          # last character) must be a dash, lowercase letter, or digit. The last
+          # character must be a lowercase letter or digit.
+      "network": "A String", # URL of the network resource for this firewall rule. If not
+          # specified when creating a firewall rule, the default network
+          # is used:
+          #
+          # global/networks/default
+          #
+          # If you choose to specify this field, you can specify the network as a full
+          # or partial URL. For example, the following are all valid URLs:
+          #
+          #    -
+          #    https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
+          #    - projects/myproject/global/networks/my-network
+          #    - global/networks/default
+      "params": { # Additional firewall 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "priority": 42, # Priority for this rule.
+          # This is an integer between `0` and `65535`, both inclusive.
+          # The default value is `1000`.
+          # Relative priorities determine which rule takes effect if multiple rules
+          # apply. Lower values indicate higher priority. For example, a rule with
+          # priority `0` has higher precedence than a rule with priority `1`.
+          # DENY rules take precedence over ALLOW rules if they have equal priority.
+          # Note that VPC networks have implied
+          # rules with a priority of `65535`. To avoid conflicts with the implied
+          # rules, use a priority number less than `65535`.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sourceRanges": [ # If source ranges are specified, the firewall rule applies only to traffic
+          # that has a source IP address in these ranges. These ranges must be
+          # expressed inCIDR format. One or both of sourceRanges
+          # and sourceTags may be set.
+          # If both fields are set, the rule applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP
+          # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
+          # both fields for the rule to
+          # apply. Both IPv4 and IPv6 are supported.
+        "A String",
+      ],
+      "sourceServiceAccounts": [ # If source service accounts are specified, the firewall rules apply only to
+          # traffic originating from an instance with a service account in this list.
+          # Source service accounts cannot be used to control traffic to an instance's
+          # external IP address because service accounts are associated with an
+          # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
+          # If both are set, the firewall applies to traffic that
+          # has a source IP address within the sourceRanges OR a source
+          # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
+          # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
+        "A String",
+      ],
+      "sourceTags": [ # If source tags are specified, the firewall rule applies only to traffic
+          # with source IPs that match the primary network interfaces of VM instances
+          # that have the tag and are in the same VPC network.
+          # Source tags cannot be used to control traffic to an instance's external IP
+          # address, it only applies to traffic between instances in the same virtual
+          # network. Because tags are associated with instances, not IP addresses.
+          # One or both of sourceRanges and sourceTags may be
+          # set. If both fields are set, the firewall applies to traffic that has a
+          # source IP address within sourceRanges OR a source IP from a
+          # resource with a matching tag listed in the sourceTags
+          # field. The connection does not need to match both fields for the
+          # firewall to apply.
+        "A String",
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating sets of instances located in the
+          # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
+          # If neither targetServiceAccounts nor targetTags
+          # are specified, the firewall rule applies to all instances on the specified
+          # network.
+        "A String",
+      ],
+      "targetTags": [ # A list of tags that controls which instances the firewall rule
+          # applies to. If targetTags are specified, then the firewall
+          # rule applies only to instances in the VPC network that have one of those
+          # tags. If no targetTags are specified, the firewall rule
+          # applies to all instances on the specified network.
+        "A String",
+      ],
+    },
+  ],
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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).
+}
+
+ +
+ getRule(project, region, firewallPolicy, priority=None, x__xgafv=None) + 
Gets a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the firewall policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      #
+      #
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a new network firewall policy in the specified project and region.
+
+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 Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all the network firewall policies that have been configured
+for the specified 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.
+  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 FirewallPolicy resources.
+    { # Represents a Firewall Policy resource.
+      "associations": [ # A list of associations that belong to this firewall policy.
+        {
+          "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+          "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+              # of the firewall policy of the association.
+          "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+          "name": "A String", # The name for an association.
+          "priority": 42, # An integer indicating the priority of an association. The priority
+              # must be a positive value between 1 and 2147483647.
+              # Firewall Policies are evaluated from highest to lowest priority where 1
+              # is the highest priority and 2147483647 is the lowest priority.
+              # The default value is `1000`. If two associations have the same priority
+              # then lexicographical order on association names is applied.
+          "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+        },
+      ],
+      "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.
+      "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+          # Organization firewall policy. The name should be unique in the organization
+          # in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed.
+          # The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # firewall policy.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+      "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+          # [Output Only] numeric ID allocated by Google Cloud which uniquely
+          # identifies the Organization Firewall Policy.
+      "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+          # This field is not applicable to network firewall policies.
+      "policyType": "A String", # The type of the firewall policy. This field can be one of
+          # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+          #
+          # Note: if not specified then VPC_POLICY will be used.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+          # This field is not applicable to global firewall policies.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+          # policy can not exceed a set number of tuples.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule (rule with priority 2147483647 and
+          # match "*"). If no rules are provided when creating a firewall policy, a
+          # default rule with action "allow" will be added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the client connection triggers the rule.
+              # Valid actions for firewall rules are: "allow", "deny",
+              # "apply_security_profile_group" and "goto_next" (
+              # "apply_security_profile_group" can be specified only for global
+              # network firewall policies or hierarchical firewall policies).
+              # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+              # and "goto_next".
+          "description": "A String", # An optional description for this resource.
+          "direction": "A String", # The direction in which this rule applies.
+          "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+              # the firewall policy rule is not enforced and traffic behaves as if it did
+              # not exist. If this is unspecified, the firewall policy rule will be
+              # enabled.
+          "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+              # enabled, logs will be exported to the configured export destination in
+              # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+              # cannot enable logging on "goto_next" rules.
+          "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+                # Maximum number of destination address groups is 10.
+              "A String",
+            ],
+            "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic destination.
+                # Maximum number of destination fqdn allowed is 100.
+              "A String",
+            ],
+            "destIpRanges": [ # CIDR IP address range.
+                # Maximum number of destination CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - NON_INTERNET
+            "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of dest region codes allowed is 5000.
+              "A String",
+            ],
+            "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic destination.
+              "A String",
+            ],
+            "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+              {
+                "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                    # required when creating a firewall rule. This value can either be
+                    # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                    # protocol number.
+                "ports": [ # An optional list of ports to which this rule applies. This field is
+                    # only applicable for UDP or TCP protocol. Each entry must be either
+                    # an integer or a range. If not specified, this rule applies to
+                    # connections through any port.
+                    #
+                    # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+                  "A String",
+                ],
+              },
+            ],
+            "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+                # Maximum number of source address groups is 10.
+              "A String",
+            ],
+            "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+                # traffic source.
+                # Maximum number of source fqdn allowed is 100.
+              "A String",
+            ],
+            "srcIpRanges": [ # CIDR IP address range.
+                # Maximum number of source CIDR IP ranges allowed is 5000.
+              "A String",
+            ],
+            "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+                #
+                #
+                #      - UNSPECIFIED
+                #      - INTERNET
+                #      - INTRA_VPC
+                #      - NON_INTERNET
+                #      - VPC_NETWORKS
+            "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+              "A String",
+            ],
+            "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+                # of traffic. Should be specified as 2 letter country code defined as per
+                # ISO 3166 alpha-2 country codes. ex."US"
+                # Maximum number of source region codes allowed is 5000.
+              "A String",
+            ],
+            "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+                # of the traffic.
+                # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+                # and there is no srcIpRange, this rule will be ignored.
+                # Maximum number of source tag values allowed is 256.
+              {
+                "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+                "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                    # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                    # or its network is deleted.
+              },
+            ],
+            "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+                # The IPs in these lists will be matched against traffic source.
+              "A String",
+            ],
+          },
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+              # and can be updated.
+          "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+              # rule.
+          "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+              # Example:
+              # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+              # Must be specified if action is one of 'apply_security_profile_group' or
+              # 'mirror'. Cannot be specified for other actions. Can be specified only
+              # for global network firewall policies or hierarchical firewall policies.
+          "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+              # This field allows you to control which load balancers get this rule.
+              # For example, the following are valid values:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+              #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+              #      - projects/project/global/
+              #      forwardingRules/forwardingRule
+              #      - projects/project/regions/region/forwardingRules/
+              #      forwardingRule
+            "A String",
+          ],
+          "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+              # allows you to control which network's VMs get this rule.  If this field
+              # is left blank, all VMs within the organization will receive the rule.
+            "A String",
+          ],
+          "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+              # applies to. If targetSecureTag are specified, then the
+              # firewall rule applies only to instances in the VPC network that have one
+              # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+              # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+              # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+              # to all instances on the specified network.
+              # Maximum number of target label tags allowed is 256.
+            {
+              "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+              "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                  # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                  # or its network is deleted.
+            },
+          ],
+          "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+              # applied with this rule.
+            "A String",
+          ],
+          "targetType": "A String", # Target types of the firewall policy rule.
+              # Default value is INSTANCES.
+          "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+              # Can be set only if action = 'apply_security_profile_group' and cannot
+              # be set for other actions.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+          # unique in the organization in which the firewall policy is created.
+          # This field is not applicable to network firewall policies.
+          # This name must be set on creation and cannot be changed. The name must be
+          # 1-63 characters long, and comply with RFC1035.
+          # 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.
+    },
+  ],
+  "kind": "compute#firewallPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies
+  "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.
+  "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, firewallPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Firewall Policy resource.
+  "associations": [ # A list of associations that belong to this firewall policy.
+    {
+      "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+      "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+          # of the firewall policy of the association.
+      "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+      "name": "A String", # The name for an association.
+      "priority": 42, # An integer indicating the priority of an association. The priority
+          # must be a positive value between 1 and 2147483647.
+          # Firewall Policies are evaluated from highest to lowest priority where 1
+          # is the highest priority and 2147483647 is the lowest priority.
+          # The default value is `1000`. If two associations have the same priority
+          # then lexicographical order on association names is applied.
+      "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+    },
+  ],
+  "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.
+  "displayName": "A String", # Deprecated, please use short name instead. User-provided name of the
+      # Organization firewall policy. The name should be unique in the organization
+      # in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed.
+      # The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # firewall policy.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#firewallPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies
+  "name": "A String", # Name of the resource. For Organization Firewall Policies it's a
+      # [Output Only] numeric ID allocated by Google Cloud which uniquely
+      # identifies the Organization Firewall Policy.
+  "packetMirroringRules": [ # A list of packet mirroring rules that belong to this policy.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "parent": "A String", # Output only. [Output Only] The parent of the firewall policy.
+      # This field is not applicable to network firewall policies.
+  "policyType": "A String", # The type of the firewall policy. This field can be one of
+      # VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.
+      # 
+      # Note: if not specified then VPC_POLICY will be used.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional firewall policy resides.
+      # This field is not applicable to global firewall policies.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "ruleTupleCount": 42, # Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall
+      # policy can not exceed a set number of tuples.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule (rule with priority 2147483647 and
+      # match "*"). If no rules are provided when creating a firewall policy, a
+      # default rule with action "allow" will be added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the client connection triggers the rule.
+          # Valid actions for firewall rules are: "allow", "deny",
+          # "apply_security_profile_group" and "goto_next" (
+          # "apply_security_profile_group" can be specified only for global
+          # network firewall policies or hierarchical firewall policies).
+          # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+          # and "goto_next".
+      "description": "A String", # An optional description for this resource.
+      "direction": "A String", # The direction in which this rule applies.
+      "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+          # the firewall policy rule is not enforced and traffic behaves as if it did
+          # not exist. If this is unspecified, the firewall policy rule will be
+          # enabled.
+      "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+          # enabled, logs will be exported to the configured export destination in
+          # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+          # cannot enable logging on "goto_next" rules.
+      "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+            # Maximum number of destination address groups is 10.
+          "A String",
+        ],
+        "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic destination.
+            # Maximum number of destination fqdn allowed is 100.
+          "A String",
+        ],
+        "destIpRanges": [ # CIDR IP address range.
+            # Maximum number of destination CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - NON_INTERNET
+        "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of dest region codes allowed is 5000.
+          "A String",
+        ],
+        "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic destination.
+          "A String",
+        ],
+        "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+          {
+            "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+                # required when creating a firewall rule. This value can either be
+                # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+                # protocol number.
+            "ports": [ # An optional list of ports to which this rule applies. This field is
+                # only applicable for UDP or TCP protocol. Each entry must be either
+                # an integer or a range. If not specified, this rule applies to
+                # connections through any port.
+                #
+                # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+              "A String",
+            ],
+          },
+        ],
+        "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+            # Maximum number of source address groups is 10.
+          "A String",
+        ],
+        "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+            # traffic source.
+            # Maximum number of source fqdn allowed is 100.
+          "A String",
+        ],
+        "srcIpRanges": [ # CIDR IP address range.
+            # Maximum number of source CIDR IP ranges allowed is 5000.
+          "A String",
+        ],
+        "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+            #
+            #
+            #      - UNSPECIFIED
+            #      - INTERNET
+            #      - INTRA_VPC
+            #      - NON_INTERNET
+            #      - VPC_NETWORKS
+        "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+          "A String",
+        ],
+        "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+            # of traffic. Should be specified as 2 letter country code defined as per
+            # ISO 3166 alpha-2 country codes. ex."US"
+            # Maximum number of source region codes allowed is 5000.
+          "A String",
+        ],
+        "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+            # of the traffic.
+            # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+            # and there is no srcIpRange, this rule will be ignored.
+            # Maximum number of source tag values allowed is 256.
+          {
+            "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+            "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+                # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+                # or its network is deleted.
+          },
+        ],
+        "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+            # The IPs in these lists will be matched against traffic source.
+          "A String",
+        ],
+      },
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+          # and can be updated.
+      "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+          # rule.
+      "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+          # Example:
+          # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+          # Must be specified if action is one of 'apply_security_profile_group' or
+          # 'mirror'. Cannot be specified for other actions. Can be specified only
+          # for global network firewall policies or hierarchical firewall policies.
+      "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+          # This field allows you to control which load balancers get this rule.
+          # For example, the following are valid values:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+          #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #      - projects/project/global/
+          #      forwardingRules/forwardingRule
+          #      - projects/project/regions/region/forwardingRules/
+          #      forwardingRule
+        "A String",
+      ],
+      "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+          # allows you to control which network's VMs get this rule.  If this field
+          # is left blank, all VMs within the organization will receive the rule.
+        "A String",
+      ],
+      "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+          # applies to. If targetSecureTag are specified, then the
+          # firewall rule applies only to instances in the VPC network that have one
+          # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+          # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+          # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+          # to all instances on the specified network.
+          # Maximum number of target label tags allowed is 256.
+        {
+          "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+          "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+              # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+              # or its network is deleted.
+        },
+      ],
+      "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+          # applied with this rule.
+        "A String",
+      ],
+      "targetType": "A String", # Target types of the firewall policy rule.
+          # Default value is INSTANCES.
+      "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+          # Can be set only if action = 'apply_security_profile_group' and cannot
+          # be set for other actions.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "shortName": "A String", # User-provided name of the Organization firewall policy. The name should be
+      # unique in the organization in which the firewall policy is created.
+      # This field is not applicable to network firewall policies.
+      # This name must be set on creation and cannot be changed. The name must be
+      # 1-63 characters long, and comply with RFC1035.
+      # 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchAssociation(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None) + 
Updates an association for the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "attachmentTarget": "A String", # The target that the firewall policy is attached to.
+  "displayName": "A String", # [Output Only] Deprecated, please use short name instead. The display name
+      # of the firewall policy of the association.
+  "firewallPolicyId": "A String", # Output only. [Output Only] The firewall policy ID of the association.
+  "name": "A String", # The name for an association.
+  "priority": 42, # An integer indicating the priority of an association. The priority
+      # must be a positive value between 1 and 2147483647.
+      # Firewall Policies are evaluated from highest to lowest priority where 1
+      # is the highest priority and 2147483647 is the lowest priority.
+      # The default value is `1000`. If two associations have the same priority
+      # then lexicographical order on association names is applied.
+  "shortName": "A String", # Output only. [Output Only] The short name of the firewall policy of the association.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(project, region, firewallPolicy, body=None, priority=None, requestId=None, x__xgafv=None) + 
Patches a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the client connection triggers the rule.
+      # Valid actions for firewall rules are: "allow", "deny",
+      # "apply_security_profile_group" and "goto_next" (
+      # "apply_security_profile_group" can be specified only for global
+      # network firewall policies or hierarchical firewall policies).
+      # Valid actions for packet mirroring rules are: "mirror", "do_not_mirror"
+      # and "goto_next".
+  "description": "A String", # An optional description for this resource.
+  "direction": "A String", # The direction in which this rule applies.
+  "disabled": True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
+      # the firewall policy rule is not enforced and traffic behaves as if it did
+      # not exist. If this is unspecified, the firewall policy rule will be
+      # enabled.
+  "enableLogging": True or False, # Denotes whether to enable logging for a particular rule. If logging is
+      # enabled, logs will be exported to the configured export destination in
+      # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
+      # cannot enable logging on "goto_next" rules.
+  "kind": "compute#firewallPolicyRule", # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "destAddressGroups": [ # Address groups which should be matched against the traffic destination.
+        # Maximum number of destination address groups is 10.
+      "A String",
+    ],
+    "destFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic destination.
+        # Maximum number of destination fqdn allowed is 100.
+      "A String",
+    ],
+    "destIpRanges": [ # CIDR IP address range.
+        # Maximum number of destination CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "destNetworkContext": "A String", # Network context of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destNetworkType": "A String", # Network type of the traffic destination. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - NON_INTERNET
+    "destRegionCodes": [ # Region codes whose IP addresses will be used to match for destination
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of dest region codes allowed is 5000.
+      "A String",
+    ],
+    "destThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic destination.
+      "A String",
+    ],
+    "layer4Configs": [ # Pairs of IP protocols and ports that the rule should match.
+      {
+        "ipProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is
+            # required when creating a firewall rule. This value can either be
+            # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
+            # protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is
+            # only applicable for UDP or TCP protocol. Each entry must be either
+            # an integer or a range. If not specified, this rule applies to
+            # connections through any port.
+            #
+            # Example inputs include: ["22"],["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "srcAddressGroups": [ # Address groups which should be matched against the traffic source.
+        # Maximum number of source address groups is 10.
+      "A String",
+    ],
+    "srcFqdns": [ # Fully Qualified Domain Name (FQDN) which should be matched against
+        # traffic source.
+        # Maximum number of source fqdn allowed is 100.
+      "A String",
+    ],
+    "srcIpRanges": [ # CIDR IP address range.
+        # Maximum number of source CIDR IP ranges allowed is 5000.
+      "A String",
+    ],
+    "srcNetworkContext": "A String", # Network context of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworkType": "A String", # Network type of the traffic source. Allowed values are:
+        #
+        #
+        #      - UNSPECIFIED
+        #      - INTERNET
+        #      - INTRA_VPC
+        #      - NON_INTERNET
+        #      - VPC_NETWORKS
+    "srcNetworks": [ # Networks of the traffic source. It can be either a full or partial url.
+      "A String",
+    ],
+    "srcRegionCodes": [ # Region codes whose IP addresses will be used to match for source
+        # of traffic. Should be specified as 2 letter country code defined as per
+        # ISO 3166 alpha-2 country codes. ex."US"
+        # Maximum number of source region codes allowed is 5000.
+      "A String",
+    ],
+    "srcSecureTags": [ # List of secure tag values, which should be matched at the source
+        # of the traffic.
+        # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
+        # and there is no srcIpRange, this rule will be ignored.
+        # Maximum number of source tag values allowed is 256.
+      {
+        "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+        "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+            # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+            # or its network is deleted.
+      },
+    ],
+    "srcThreatIntelligences": [ # Names of Network Threat Intelligence lists.
+        # The IPs in these lists will be matched against traffic source.
+      "A String",
+    ],
+  },
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "ruleName": "A String", # An optional name for the rule. This field is not a unique identifier
+      # and can be updated.
+  "ruleTupleCount": 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
+      # rule.
+  "securityProfileGroup": "A String", # A fully-qualified URL of a SecurityProfileGroup resource instance.
+      # Example:
+      # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
+      # Must be specified if action is one of 'apply_security_profile_group' or
+      # 'mirror'. Cannot be specified for other actions. Can be specified only
+      # for global network firewall policies or hierarchical firewall policies.
+  "targetForwardingRules": [ # A list of forwarding rules to which this rule applies.
+      # This field allows you to control which load balancers get this rule.
+      # For example, the following are valid values:
+      # 
+      # 
+      #      - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
+      #      - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #      - projects/project/global/
+      #      forwardingRules/forwardingRule
+      #      - projects/project/regions/region/forwardingRules/
+      #      forwardingRule
+    "A String",
+  ],
+  "targetResources": [ # A list of network resource URLs to which this rule applies.  This field
+      # allows you to control which network's VMs get this rule.  If this field
+      # is left blank, all VMs within the organization will receive the rule.
+    "A String",
+  ],
+  "targetSecureTags": [ # A list of secure tags that controls which instances the firewall rule
+      # applies to. If targetSecureTag are specified, then the
+      # firewall rule applies only to instances in the VPC network that have one
+      # of those EFFECTIVE secure tags, if all the target_secure_tag are in
+      # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
+      # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
+      # to all instances on the specified network.
+      # Maximum number of target label tags allowed is 256.
+    {
+      "name": "A String", # Name of the secure tag, created with TagManager's TagValue API.
+      "state": "A String", # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
+          # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
+          # or its network is deleted.
+    },
+  ],
+  "targetServiceAccounts": [ # A list of service accounts indicating the sets of instances that are
+      # applied with this rule.
+    "A String",
+  ],
+  "targetType": "A String", # Target types of the firewall policy rule.
+      # Default value is INSTANCES.
+  "tlsInspect": True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
+      # Can be set only if action = 'apply_security_profile_group' and cannot
+      # be set for other actions.
+}
+
+  priority: integer, The priority of the rule to patch.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeAssociation(project, region, firewallPolicy, name=None, requestId=None, x__xgafv=None) + 
Removes an association for the specified network firewall policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  name: string, Name for the association that will be removed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(project, region, firewallPolicy, priority=None, requestId=None, x__xgafv=None) + 
Deletes a rule of the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  firewallPolicy: string, Name of the firewall policy to update. (required)
+  priority: integer, The priority of the rule to remove from the firewall policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.regionNotificationEndpoints.html b/docs/dyn/compute_preview.regionNotificationEndpoints.html new file mode 100644 index 0000000000..f4bb70d03e --- /dev/null +++ b/docs/dyn/compute_preview.regionNotificationEndpoints.html @@ -0,0 +1,1338 @@ + + + +

Compute Engine API . regionNotificationEndpoints

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all NotificationEndpoint resources,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, notificationEndpoint, requestId=None, x__xgafv=None)

+

Deletes the specified NotificationEndpoint in the given region

+

+ get(project, region, notificationEndpoint, x__xgafv=None)

+

Returns the specified NotificationEndpoint resource in the given region.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Create a NotificationEndpoint in the specified project in the given region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the NotificationEndpoints for a project in the given region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all NotificationEndpoint resources,
+regional and global, available to the specified project.
+
+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.
+  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 NotificationEndpointsScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of NotificationEndpointsScopedList resources.
+    "a_key": { # Name of the scope containing this set of NotificationEndpoints.
+      "resources": [ # A list of NotificationEndpoints contained in this scope.
+        { # Represents a notification endpoint.
+            #
+            # A notification endpoint resource defines an endpoint to receive notifications
+            # when there are status changes detected by the associated health check
+            # service.
+            #
+            # 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.
+          "grpcSettings": { # Represents a gRPC setting that describes one gRPC notification endpoint and # Settings of the gRPC notification endpoint including the endpoint URL and
+              # the retry duration.
+              # the retry duration attempting to send notification to this endpoint.
+            "authority": "A String", # Optional. If specified, this field is used to set the authority header by
+                # the sender of notifications. See
+                # https://tools.ietf.org/html/rfc7540#section-8.1.2.3
+            "endpoint": "A String", # Endpoint to which gRPC notifications are sent. This must be a valid
+                # gRPCLB DNS name.
+            "payloadName": "A String", # Optional. If specified, this field is used to populate the "name" field
+                # in gRPC requests.
+            "resendInterval": { # A Duration represents a fixed-length span of time represented # Optional. This field is used to configure how often to send a full update
+                # of all non-healthy backends. If unspecified, full updates are not sent.
+                # If specified, must be in the range between 600 seconds to 3600 seconds.
+                # Nanos are disallowed. Can only be set for regional notification
+                # endpoints.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "retryDurationSec": 42, # How much time (in seconds) is spent attempting notification retries
+                # until a successful response is received. Default is 30s. Limit is 20m
+                # (1200s). Must be a positive number.
+          },
+          "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+              # generates this identifier.
+          "kind": "compute#notificationEndpoint", # Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.
+          "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.
+          "region": "A String", # Output only. [Output Only] URL of the region where the notification endpoint 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.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # notification endpoints 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#notificationEndpointAggregatedList", # 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, notificationEndpoint, requestId=None, x__xgafv=None) + 
Deletes the specified NotificationEndpoint in the given region
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  notificationEndpoint: string, Name of the NotificationEndpoint 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, notificationEndpoint, x__xgafv=None) + 
Returns the specified NotificationEndpoint resource in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  notificationEndpoint: string, Name of the NotificationEndpoint 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 notification endpoint.
+    #
+    # A notification endpoint resource defines an endpoint to receive notifications
+    # when there are status changes detected by the associated health check
+    # service.
+    #
+    # 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.
+  "grpcSettings": { # Represents a gRPC setting that describes one gRPC notification endpoint and # Settings of the gRPC notification endpoint including the endpoint URL and
+      # the retry duration.
+      # the retry duration attempting to send notification to this endpoint.
+    "authority": "A String", # Optional. If specified, this field is used to set the authority header by
+        # the sender of notifications. See
+        # https://tools.ietf.org/html/rfc7540#section-8.1.2.3
+    "endpoint": "A String", # Endpoint to which gRPC notifications are sent. This must be a valid
+        # gRPCLB DNS name.
+    "payloadName": "A String", # Optional. If specified, this field is used to populate the "name" field
+        # in gRPC requests.
+    "resendInterval": { # A Duration represents a fixed-length span of time represented # Optional. This field is used to configure how often to send a full update
+        # of all non-healthy backends. If unspecified, full updates are not sent.
+        # If specified, must be in the range between 600 seconds to 3600 seconds.
+        # Nanos are disallowed. Can only be set for regional notification
+        # endpoints.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "retryDurationSec": 42, # How much time (in seconds) is spent attempting notification retries
+        # until a successful response is received. Default is 30s. Limit is 20m
+        # (1200s). Must be a positive number.
+  },
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#notificationEndpoint", # Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the notification endpoint 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.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Create a NotificationEndpoint 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 notification endpoint.
+    # 
+    # A notification endpoint resource defines an endpoint to receive notifications
+    # when there are status changes detected by the associated health check
+    # service.
+    # 
+    # 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.
+  "grpcSettings": { # Represents a gRPC setting that describes one gRPC notification endpoint and # Settings of the gRPC notification endpoint including the endpoint URL and
+      # the retry duration.
+      # the retry duration attempting to send notification to this endpoint.
+    "authority": "A String", # Optional. If specified, this field is used to set the authority header by
+        # the sender of notifications. See
+        # https://tools.ietf.org/html/rfc7540#section-8.1.2.3
+    "endpoint": "A String", # Endpoint to which gRPC notifications are sent. This must be a valid
+        # gRPCLB DNS name.
+    "payloadName": "A String", # Optional. If specified, this field is used to populate the "name" field
+        # in gRPC requests.
+    "resendInterval": { # A Duration represents a fixed-length span of time represented # Optional. This field is used to configure how often to send a full update
+        # of all non-healthy backends. If unspecified, full updates are not sent.
+        # If specified, must be in the range between 600 seconds to 3600 seconds.
+        # Nanos are disallowed. Can only be set for regional notification
+        # endpoints.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "retryDurationSec": 42, # How much time (in seconds) is spent attempting notification retries
+        # until a successful response is received. Default is 30s. Limit is 20m
+        # (1200s). Must be a positive number.
+  },
+  "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+      # generates this identifier.
+  "kind": "compute#notificationEndpoint", # Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the notification endpoint 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.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the NotificationEndpoints 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.
+  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 NotificationEndpoint resources.
+    { # Represents a notification endpoint.
+        #
+        # A notification endpoint resource defines an endpoint to receive notifications
+        # when there are status changes detected by the associated health check
+        # service.
+        #
+        # 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.
+      "grpcSettings": { # Represents a gRPC setting that describes one gRPC notification endpoint and # Settings of the gRPC notification endpoint including the endpoint URL and
+          # the retry duration.
+          # the retry duration attempting to send notification to this endpoint.
+        "authority": "A String", # Optional. If specified, this field is used to set the authority header by
+            # the sender of notifications. See
+            # https://tools.ietf.org/html/rfc7540#section-8.1.2.3
+        "endpoint": "A String", # Endpoint to which gRPC notifications are sent. This must be a valid
+            # gRPCLB DNS name.
+        "payloadName": "A String", # Optional. If specified, this field is used to populate the "name" field
+            # in gRPC requests.
+        "resendInterval": { # A Duration represents a fixed-length span of time represented # Optional. This field is used to configure how often to send a full update
+            # of all non-healthy backends. If unspecified, full updates are not sent.
+            # If specified, must be in the range between 600 seconds to 3600 seconds.
+            # Nanos are disallowed. Can only be set for regional notification
+            # endpoints.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "retryDurationSec": 42, # How much time (in seconds) is spent attempting notification retries
+            # until a successful response is received. Default is 30s. Limit is 20m
+            # (1200s). Must be a positive number.
+      },
+      "id": "A String", # Output only. [Output Only] A unique identifier for this resource type. The server
+          # generates this identifier.
+      "kind": "compute#notificationEndpoint", # Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.
+      "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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the notification endpoint 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.
+    },
+  ],
+  "kind": "compute#notificationEndpointList", # Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.
+  "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.
+
+
+ +
+ 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_preview.regionOperations.html b/docs/dyn/compute_preview.regionOperations.html new file mode 100644 index 0000000000..5afdd2eef5 --- /dev/null +++ b/docs/dyn/compute_preview.regionOperations.html @@ -0,0 +1,1138 @@ + + + +

Compute Engine API . regionOperations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, operation, x__xgafv=None)

+

Deletes the specified region-specific Operations resource.

+

+ get(project, region, operation, x__xgafv=None)

+

Retrieves the specified region-specific Operations resource.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of Operation resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ wait(project, region, operation, x__xgafv=None)

+

Waits for the specified Operation resource to return as `DONE`

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, operation, x__xgafv=None) + 
Deletes the specified region-specific Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  operation: string, Name of the Operations resource to delete, or its unique numeric
+identifier. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ get(project, region, operation, x__xgafv=None) + 
Retrieves the specified region-specific Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of Operation resources contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 Operation resources.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of Operation resources.
+    { # 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.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+      "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+        "healthInfo": { # Health information. # Output only. The health information.
+          "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+          "healthStatus": "A String", # Output only. The health status.
+          "repairCategory": "A String", # Output only. The repair category.
+          "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+          "updateTime": "A String", # Output only. The time when health info was updated.
+        },
+      },
+      "getVersionOperationMetadata": {
+        "inlineSbomInfo": {
+          "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+              # appropriate identifiers.
+            "a_key": "A String",
+          },
+          "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+              # identifiers.
+            "a_key": "A String",
+          },
+        },
+      },
+      "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.
+    },
+  ],
+  "kind": "compute#operationList", # Output only. [Output Only] Type of resource. Always `compute#operations` for Operations
+      # 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 than
+      # `maxResults`, 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.
+
+
+ +
+ wait(project, region, operation, x__xgafv=None) + 
Waits for the specified Operation resource to return as `DONE`
+or for the request to approach the 2 minute deadline, and retrieves the
+specified Operation resource. This method differs from the
+`GET` method in that it waits for no more than the default
+deadline (2 minutes) and then returns the current state of the operation,
+which might be `DONE` or still in progress.
+
+This method is called on a best-effort basis. Specifically:
+   
+   
+    - In uncommon cases, when the server is overloaded, the request might
+    return before the default deadline is reached, or might return after zero
+    seconds.
+   - If the default deadline is reached, there is no guarantee that the
+    operation is actually done when the method returns. Be prepared to retry
+    if the operation is not `DONE`.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionSecurityPolicies.html b/docs/dyn/compute_preview.regionSecurityPolicies.html new file mode 100644 index 0000000000..1172fc9a73 --- /dev/null +++ b/docs/dyn/compute_preview.regionSecurityPolicies.html @@ -0,0 +1,6270 @@ + + + +

Compute Engine API . regionSecurityPolicies

+

Instance Methods

+

+ addRule(project, region, securityPolicy, body=None, validateOnly=None, x__xgafv=None)

+

Inserts a rule into a security policy.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, securityPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified policy.

+

+ get(project, region, securityPolicy, x__xgafv=None)

+

List all of the ordered rules present in a single specified policy.

+

+ getRule(project, region, securityPolicy, priority=None, x__xgafv=None)

+

Gets a rule at the specified priority.

+

+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates a new policy in the specified project using the data included in

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

List all the policies that have been configured for the specified project

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request. To

+

+ patchRule(project, region, securityPolicy, body=None, priority=None, updateMask=None, validateOnly=None, x__xgafv=None)

+

Patches a rule at the specified priority. To clear fields in the rule,

+

+ removeRule(project, region, securityPolicy, priority=None, x__xgafv=None)

+

Deletes a rule at the specified priority.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a security policy. To learn more about labels,

+

Method Details

+
+ addRule(project, region, securityPolicy, body=None, validateOnly=None, x__xgafv=None) + 
Inserts a rule into a security policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, securityPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, securityPolicy, x__xgafv=None) + 
List all of the ordered rules present in a single specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to get. (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 Google Cloud Armor security policy resource.
+    #
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      #
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      #
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      #
+      #
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      #
+      # Example:
+      #
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+ +
+ getRule(project, region, securityPolicy, priority=None, x__xgafv=None) + 
Gets a rule at the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the security policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      #
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      #
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      #
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      #
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      #
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      #
+      # Example:
+      #
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      #
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates a new policy in the specified project using the data 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 Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  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).
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
List all the policies that have been configured for the specified project
+and 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.
+  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 SecurityPolicy resources.
+    { # Represents a Google Cloud Armor security policy resource.
+        #
+        # Only external backend services that use load balancers can
+        # reference a security policy. For more information, see
+        # Google Cloud Armor security policy overview.
+      "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+        "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "ruleVisibility": "A String", # Rule visibility can be one of the following:
+              # STANDARD - opaque rules. (default)
+              # PREMIUM - transparent rules.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+              # customizable thresholds.
+            {
+              "autoDeployConfidenceThreshold": 3.14,
+              "autoDeployExpirationSec": 42,
+              "autoDeployImpactedBaselineThreshold": 3.14,
+              "autoDeployLoadThreshold": 3.14,
+              "detectionAbsoluteQps": 3.14,
+              "detectionLoadThreshold": 3.14,
+              "detectionRelativeToBaselineQps": 3.14,
+              "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+                  # The name must be unique within the security policy.
+              "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+                  # on specified granular traffic units.
+                { # Configurations to specifc granular traffic units processed by
+                    # Adaptive Protection.
+                  "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                      # type constitutes a separate traffic unit.
+                      # It can only be set to true if `value` is empty.
+                  "type": "A String", # Type of this configuration.
+                  "value": "A String", # Requests that match this value constitute a granular traffic unit.
+                },
+              ],
+            },
+          ],
+        },
+      },
+      "advancedOptionsConfig": {
+        "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+            # json_parsing is set to STANDARD.
+          "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+              #
+              # As per RFC 1341, a Content-Type header value has the following format:
+              #
+              # Content-Type := type "/" subtype *[";" parameter]
+              #
+              # When configuring a custom Content-Type header value, only the
+              # type/subtype needs to be specified, and the parameters should be
+              # excluded.
+            "A String",
+          ],
+        },
+        "jsonParsing": "A String",
+        "logLevel": "A String",
+        "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+            # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+            # Values are case insensitive.
+        "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+            # resolving the callers client IP address.
+          "A String",
+        ],
+      },
+      "associations": [ # A list of associations that belong to this policy.
+        {
+          "attachmentId": "A String", # The resource that the security policy is attached to.
+          "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+          "excludedFolders": [ # A list of folders to exclude from the security policy.
+            "A String",
+          ],
+          "excludedProjects": [ # A list of projects to exclude from the security policy.
+            "A String",
+          ],
+          "name": "A String", # The name for an association.
+          "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+          "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "ddosProtectionConfig": {
+        "ddosAdaptiveProtection": "A String",
+        "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+            # builds DDoS mitigations that minimize collateral damage. It quantifies
+            # this as the fraction of a non-abuse baseline that's inadvertently
+            # blocked.
+            #
+            # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+            # not be deployed. Using a lower value will prioritize keeping collateral
+            # damage low, possibly at the cost of its effectiveness in rate limiting
+            # some or all of the attack. It should typically be unset, so Advanced DDoS
+            # (and Adaptive Protection) uses the best mitigation it can find. Setting
+            # the threshold is advised if there are logs for false positive detections
+            # with high collateral damage, and will cause Advanced DDoS to attempt to
+            # find a less aggressive rule that satisfies the constraint. If a suitable
+            # rule cannot be found, the system falls back to either no mitigation for
+            # smaller attacks or broader network throttles for larger ones.
+        "ddosProtection": "A String",
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+      "recaptchaOptionsConfig": {
+        "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+            # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+            # the security policy. The specified site key needs to be created from the
+            # reCAPTCHA API. The user is responsible for the validity of the specified
+            # site key. If not specified, a Google-managed site key is used.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+          # resides. This field is not applicable to global security policies.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule which is a rule with priority
+          # 2147483647 and match all condition (for the match condition this means
+          # match  "*" for srcIpRanges and for the networkMatch condition every field
+          # must be either match "*" or not set). If no rules are provided when
+          # creating a security policy, a default rule with action "allow" will be
+          # added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the rule is matched.
+              # The following are the valid actions:
+              #
+              #    - allow: allow access to target.
+              #    - deny(STATUS): deny access to target, returns the
+              #    HTTP response code specified. Valid values for `STATUS`
+              #    are 403, 404, and 502.
+              #    - rate_based_ban: limit client traffic to the configured
+              #    threshold and ban the client if the traffic exceeds the threshold.
+              #    Configure parameters for this action in RateLimitOptions. Requires
+              #    rate_limit_options to be set.
+              #    - redirect: redirect to a different target. This can
+              #    either be an internal reCAPTCHA redirect, or an external URL-based
+              #    redirect via a 302 response. Parameters for this action can be configured
+              #    via redirectOptions. This action is only supported in Global Security
+              #    Policies of type CLOUD_ARMOR.
+              #    - throttle: limit
+              #    client traffic to the configured threshold. Configure parameters for this
+              #    action in rateLimitOptions. Requires rate_limit_options to be set for
+              #    this.
+              #    - fairshare (preview only): when traffic reaches the
+              #    threshold limit, requests from the clients matching this rule begin to be
+              #    rate-limited using the Fair Share algorithm. This action is only allowed
+              #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "headerAction": { # Optional, additional actions that are performed on headers.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+                # present.
+              {
+                "headerName": "A String", # The name of the header to set.
+                "headerValue": "A String", # The value to set the named header to.
+              },
+            ],
+          },
+          "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "config": { # The configuration options available when specifying versioned_expr.
+                # This field must be specified if versioned_expr is specified and cannot
+                # be specified if versioned_expr is not specified.
+              "srcIpRanges": [ # CIDR IP address range.
+                  # Maximum number of src_ip_ranges allowed is 10.
+                "A String",
+              ],
+            },
+            "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+                # A CEVAL expression is used to specify match criteria such as origin.ip,
+                # source.region_code and contents in the request header.
+                # Expressions containing `evaluateThreatIntelligence` require a Cloud
+                # Armor Enterprise subscription and are not supported in Edge Policies
+                # nor in Regional Policies. Expressions containing
+                # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+                # Enterprise subscription and are only supported in Global Security
+                # 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.
+            },
+            "exprOptions": { # The configuration options available when specifying a user defined
+                # CEVAL expression (i.e., 'expr').
+              "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+                  # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+                "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # action-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+                "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # session-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+              },
+            },
+            "versionedExpr": "A String", # Preconfigured versioned expression.
+                # If this field is specified, config must also be specified.
+                # Available preconfigured expressions along with their requirements are:
+                # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+                # config.
+          },
+          "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+              # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+              # 'action' is enforced.
+              #
+              # The match criteria for a rule consists of built-in match fields (like
+              # 'srcIpRanges') and potentially multiple user-defined match fields
+              # ('userDefinedFields').
+              #
+              # Field values may be extracted directly from the packet or derived from it
+              # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+              # (e.g. 'srcPorts'). A user-defined field is only present if the base
+              # header is found in the packet and the entire field is in bounds.
+              #
+              # Each match field may specify which values can match it, listing one or
+              # more ranges, prefixes, or exact values that are considered a match for
+              # the field. A field value must be present in order to match a specified
+              # match field. If no match values are specified for a match field, then any
+              # field value is considered to match it, and it's not required to be
+              # present. For strings specifying '*' is also equivalent to match all.
+              #
+              # For a packet to match a rule, all specified match fields must match the
+              # corresponding field values derived from the packet.
+              #
+              # Example:
+              #
+              # networkMatch:
+              #   srcIpRanges:
+              #   - "192.0.2.0/24"
+              #   - "198.51.100.0/24"
+              #   userDefinedFields:
+              #   - name: "ipv4_fragment_offset"
+              #     values:
+              #     - "1-0x1fff"
+              #
+              # The above match condition matches packets with a source IP in
+              # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+              # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+              # against.
+            "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+                # format.
+              "A String",
+            ],
+            "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+                # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+                # "253-254"), or one of the following protocol names: "tcp", "udp",
+                # "icmp", "esp", "ah", "ipip", or "sctp".
+              "A String",
+            ],
+            "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+              42,
+            ],
+            "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+              "A String",
+            ],
+            "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+                # IP address.
+              "A String",
+            ],
+            "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+                # matching values for that field.
+              {
+                "name": "A String", # Name of the user-defined field, as given in the definition.
+                "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                    # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                    # range (e.g.  "0x400-0x7ff").
+                  "A String",
+                ],
+              },
+            ],
+          },
+          "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+              # does not evaluate preconfigured WAF rules, i.e., if
+              # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+            "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+              {
+                "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                    # preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                    # from inspection during preconfigured WAF evaluation. Note that the
+                    # parameter can be in the query string or in the POST body.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                    # inspection during preconfigured WAF evaluation. When specifying this
+                    # field, the query or fragment part should be excluded.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                    # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                    # IDs under the WAF rule set.
+                  "A String",
+                ],
+                "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+              },
+            ],
+          },
+          "preview": True or False, # If set to true, the specified action is not enforced.
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+              # "fairshare". Cannot be specified for any other actions.
+            "banDurationSec": 42, # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, determines the time (in seconds)
+                # the traffic will continue to be banned by the rate limit after the
+                # rate falls below the threshold.
+            "banThreshold": { # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, the key will be banned for the
+                # configured 'ban_duration_sec' when the number of requests that exceed
+                # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+            "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+                # threshold. Valid option is "allow" only.
+            "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKey" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the value
+                #    is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of the
+                #    HTTPS request. The key value is truncated to the first 128 bytes. The
+                #    key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the request
+                #    originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration or
+                #    an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #
+                #
+                # For "fairshare" action, this value is limited to ALL i.e. a single rate
+                # limit threshold is enforced for all the requests matching the rule.
+            "enforceOnKeyConfigs": [ # If specified, any combination of values of
+                # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+                # ratelimit threshold/action is enforced. You can specify up to 3
+                # enforce_on_key_configs. If enforce_on_key_configs is specified,
+                # enforce_on_key must not be specified.
+              {
+                "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                    # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                    # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                    # taken as the key value.
+                "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                    # values are:
+                    #
+                    #    - ALL: A single rate limit threshold is applied to all
+                    #    the requests matching this rule. This is the default value if
+                    #    "enforceOnKeyConfigs" is not configured.
+                    #    - IP: The source IP address of
+                    #    the request is the key. Each IP has this limit enforced
+                    #    separately.
+                    #    - HTTP_HEADER: The value of the HTTP
+                    #    header whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the header value. If no
+                    #    such header is present in the request, the key type defaults toALL.
+                    #    - XFF_IP: The first IP address (i.e. the
+                    #    originating client IP address) specified in the list of IPs under
+                    #    X-Forwarded-For HTTP header. If no such header is present or the
+                    #    value is not a valid IP, the key defaults to the source IP address of
+                    #    the request i.e. key type IP.
+                    #    - HTTP_COOKIE: The value of the HTTP
+                    #    cookie whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the cookie value. If no
+                    #    such cookie is present in the request, the key type defaults toALL.
+                    #    - HTTP_PATH: The URL path of the HTTP request. The key
+                    #    value is truncated to the first 128 bytes.
+                    #    - SNI: Server name indication in the TLS session of
+                    #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                    #    The key type defaults to ALL on a HTTP session.
+                    #    - REGION_CODE: The country/region from which the
+                    #    request originates.
+                    #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+                    #    - USER_IP: The IP address of the originating client,
+                    #    which is resolved based on "userIpRequestHeaders" configured with the
+                    #    security policy. If there is no "userIpRequestHeaders" configuration
+                    #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                    #    - ASN: The autonomous system number of the originating
+                    #    client. If not available, the key type defaults toALL.
+                    #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+              },
+            ],
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+                # value.
+                # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+                # value.
+            "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+                # threshold, to either deny with a specified HTTP response code, or
+                # redirect to a different endpoint.
+                # Valid options are `deny(STATUS)`, where valid values for
+                # `STATUS` are 403, 404, 429, and 502, and
+                # `redirect`, where the redirect parameters come from
+                # `exceedRedirectOptions` below.
+                # The `redirect` action is only supported in Global Security Policies of
+                # type CLOUD_ARMOR.
+            "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+                # action. Cannot be specified if the exceed action is not redirect.
+                # This field is only supported in Global Security Policies of type
+                # CLOUD_ARMOR.
+              "target": "A String", # Target for the redirect action. This is required if the type is
+                  # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+              "type": "A String", # Type of the redirect action. Possible values are:
+                  #
+                  #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                  #    challenge assessment.
+                  #    - EXTERNAL_302: redirect to a different URL via a 302
+                  #    response.
+            },
+            "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+          },
+          "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+              # other actions.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "target": "A String", # Target for the redirect action. This is required if the type is
+                # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+            "type": "A String", # Type of the redirect action. Possible values are:
+                #
+                #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                #    challenge assessment.
+                #    - EXTERNAL_302: redirect to a different URL via a 302
+                #    response.
+          },
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "shortName": "A String", # User-provided name of the organization security policy. The name should be
+          # unique in the organization in which the security policy is created. This
+          # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+          # The name must be 1-63 characters long, and comply with
+          # https://www.ietf.org/rfc/rfc1035.txt. 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.
+      "type": "A String", # The type indicates the intended use of the security policy.
+          #
+          #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services.
+          #    They filter requests before they hit the origin servers.
+          #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services
+          #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+          #    They filter requests before the request is served from Google's cache.
+          #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+          #    internal service policies can be configured to filter HTTP requests
+          #    targeting services managed by Traffic Director in a service mesh. They
+          #    filter requests before the request is served from the application.
+          #
+          # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+          # can be configured to filter packets targeting network load balancing
+          # resources such as backend services, target pools, target instances, and
+          # instances with external IPs. They filter requests before the request is
+          # served from the application.
+          #
+          #
+          # This field can be set only at resource creation time.
+      "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+          # user-defined field consists of up to 4 bytes extracted from a fixed offset
+          # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+          # optional mask to select certain bits. Rules may then specify matching
+          # values for these fields.
+          #
+          # Example:
+          #
+          #  userDefinedFields:
+          #  - name: "ipv4_fragment_offset"
+          #    base: IPV4
+          #    offset: 6
+          #    size: 2
+          #    mask: "0x1fff"
+        {
+          "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+              #
+              #    - IPV4: Points to the beginning of the IPv4 header.
+              #    - IPV6: Points to the beginning of the IPv6 header.
+              #    - TCP: Points to the beginning of the TCP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #    - UDP: Points to the beginning of the UDP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #
+              #
+              # required
+          "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+              # before matching. Encoded as a hexadecimal number (starting with "0x").
+              # The last byte of the field (in network byte order) corresponds to the
+              # least significant byte of the mask.
+          "name": "A String", # The name of this field. Must be unique within the policy.
+          "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+              # 'base'.
+          "size": 42, # Size of the field in bytes. Valid values: 1-4.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#securityPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies
+  "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.
+  "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, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request. To
+clear fields in the policy, leave the fields empty and specify them in the
+updateMask. This cannot be used to be update the rules in the policy.
+Please use the per rule methods like addRule, patchRule, and removeRule
+instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  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).
+  updateMask: string, Indicates fields to be cleared as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(project, region, securityPolicy, body=None, priority=None, updateMask=None, validateOnly=None, x__xgafv=None) + 
Patches a rule at the specified priority. To clear fields in the rule,
+leave the fields empty and specify them in the updateMask.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  priority: integer, The priority of the rule to patch.
+  updateMask: string, Indicates fields to be cleared as part of this request.
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(project, region, securityPolicy, priority=None, x__xgafv=None) + 
Deletes a rule at the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  priority: integer, The priority of the rule to remove from the security policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a security policy. To learn more about labels,
+read the Labeling Resources
+documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionSnapshotSettings.html b/docs/dyn/compute_preview.regionSnapshotSettings.html new file mode 100644 index 0000000000..ac7df746b8 --- /dev/null +++ b/docs/dyn/compute_preview.regionSnapshotSettings.html @@ -0,0 +1,465 @@ + + + +

Compute Engine API . regionSnapshotSettings

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, x__xgafv=None)

+

Get region snapshot settings.

+

+ patch(project, region, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patch region snapshot settings.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, x__xgafv=None) + 
Get region snapshot settings.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "accessLocation": { # (Regional snapshots use only)Policy of which location is allowed to access
+      # snapshot.
+    "locations": { # List of regions that can restore a regional
+        #  snapshot from the current region
+      "a_key": { # A structure for specifying an allowed target region.
+        "region": "A String", # Accessible region name
+      },
+    },
+    "policy": "A String", # Policy of which location is allowed to access snapshot.
+  },
+  "storageLocation": { # Policy of which storage location is going to be resolved, and additional
+      # data that particularizes how the policy is going to be carried out.
+    "locations": { # When the policy is SPECIFIC_LOCATIONS, snapshots will be stored
+        # in the locations listed in this field. Keys are Cloud Storage bucket
+        # locations. Only one location can be specified.
+      "a_key": { # A structure for specifying storage locations.
+        "name": "A String", # Name of the location. It should be one of the Cloud Storage buckets.
+            # Only one location can be specified.
+      },
+    },
+    "policy": "A String", # The chosen location policy.
+  },
+}
+
+ +
+ patch(project, region, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patch region snapshot settings.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "accessLocation": { # (Regional snapshots use only)Policy of which location is allowed to access
+      # snapshot.
+    "locations": { # List of regions that can restore a regional
+        #  snapshot from the current region
+      "a_key": { # A structure for specifying an allowed target region.
+        "region": "A String", # Accessible region name
+      },
+    },
+    "policy": "A String", # Policy of which location is allowed to access snapshot.
+  },
+  "storageLocation": { # Policy of which storage location is going to be resolved, and additional
+      # data that particularizes how the policy is going to be carried out.
+    "locations": { # When the policy is SPECIFIC_LOCATIONS, snapshots will be stored
+        # in the locations listed in this field. Keys are Cloud Storage bucket
+        # locations. Only one location can be specified.
+      "a_key": { # A structure for specifying storage locations.
+        "name": "A String", # Name of the location. It should be one of the Cloud Storage buckets.
+            # Only one location can be specified.
+      },
+    },
+    "policy": "A String", # The chosen location policy.
+  },
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionSnapshots.html b/docs/dyn/compute_preview.regionSnapshots.html new file mode 100644 index 0000000000..d7b601d231 --- /dev/null +++ b/docs/dyn/compute_preview.regionSnapshots.html @@ -0,0 +1,3819 @@ + + + +

Compute Engine API . regionSnapshots

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, snapshot, requestId=None, x__xgafv=None)

+

Deletes the specified Snapshot resource. Keep in mind that deleting

+

+ get(project, region, snapshot, x__xgafv=None)

+

Returns the specified Snapshot resource.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a snapshot in the specified region using the data included

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Snapshot resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a regional snapshot. To learn more about labels, read

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ updateKmsKey(project, region, snapshot, body=None, requestId=None, x__xgafv=None)

+

Rotates the customer-managed

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, snapshot, requestId=None, x__xgafv=None) + 
Deletes the specified Snapshot resource. Keep in mind that deleting
+a single snapshot might not necessarily delete all the data on that
+snapshot. If any data on the snapshot that is marked for deletion is
+needed for subsequent snapshots, the data will be moved to the next
+corresponding snapshot.
+
+For more information, seeDeleting
+snapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  snapshot: string, Name of the snapshot 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, snapshot, x__xgafv=None) + 
Returns the specified Snapshot resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  snapshot: string, Name of the Snapshot 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 Persistent Disk Snapshot resource.
+    #
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      #
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      #
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      #
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a snapshot in the specified region using the data included
+in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk Snapshot resource.
+    # 
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      # 
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of Snapshot resources contained within
+the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 Snapshot resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Snapshot resources.
+    { # Represents a Persistent Disk Snapshot resource.
+        #
+        # You can use snapshots to back up data on a regular interval. For more
+        # information, read  Creating
+        # persistent disk snapshots.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+          # ARM64 or X86_64.
+      "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+          # applying resource policy on the target disk.
+      "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+          # specified name. The chain name must be 1-63 characters long and comply
+          # with RFC1035. This is an uncommon option only for advanced service
+          # owners who needs to create separate snapshot chains, for example,
+          # for chargeback tracking. When you describe your snapshot resource, this
+          # field is visible only if it has a non-empty value.
+      "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+      "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.
+      "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+      "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+      "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+          # [Output Only]: This field is not set by user, but from source disk.
+      "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+          # informing the OS to prepare for the snapshot process.
+      "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+          # Applicable only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+          # for Snapshot resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a snapshot.
+      "labels": { # Labels to apply to this snapshot. These can be later modified by
+          # the setLabels method.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+          # to this snapshot.
+        "A String",
+      ],
+      "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+          # snapshot. This can be because the original image had licenses attached
+          # (such as a Windows image).
+        "A String",
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "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.
+      "params": { # Additional snapshot params. # Input only. [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 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/{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",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+          # for regional snapshots.
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+          # encryption key.
+          #
+          # After you encrypt a snapshot using a customer-supplied key, you must
+          # provide the same key if you use the snapshot later. For example, you must
+          # provide the encryption key when you create a disk from the encrypted
+          # snapshot in a future request.
+          #
+          # Customer-supplied encryption keys do not protect access to metadata
+          # of the snapshot.
+          #
+          # If you do not provide an encryption key when creating the snapshot, then
+          # the snapshot will be encrypted using an automatically generated key and you
+          # do not need to provide a key to use the snapshot later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 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. The usage of snapshot group feature is restricted.
+      "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+          # of snapshot group feature is restricted.
+      "snapshotType": "A String", # Indicates the type of the snapshot.
+      "sourceDisk": "A String", # The source disk used to create this snapshot.
+      "sourceDiskEncryptionKey": { # The customer-supplied
+          # encryption key of the source disk. Required if the source disk is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+          # snapshot.
+      "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+          # value may be used to determine whether the snapshot was taken from the
+          # current or a previous instance of a given disk name.
+      "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+          #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+          #    - zones/zone/instantSnapshots/instantSnapshot
+      "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+          # Snapshot.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+          # snapshot. This value identifies the exact instant snapshot that was used to
+          # create this snapshot. For example, if you created the snapshot from an
+          # instant snapshot that was later deleted and recreated under the same name,
+          # the source instant snapshot ID would identify the exact instant snapshot
+          # that was used.
+      "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+          # scheduled snapshot.
+      "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+          # scheduled snapshot.
+      "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+      "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+          # share storage, this number is expected to change with snapshot
+          # creation/deletion.
+      "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+          # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+          # [Output Only] An indicator whether storageBytes is in a
+          # stable state or it is being adjusted as a result of shared storage
+          # reallocation. This status can either be unset, meaning the snapshot is
+          # being created, or UP_TO_DATE, meaning the size of the snapshot
+          # is up-to-date.
+      "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#snapshotList", # 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.
+  "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, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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).
+}
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a regional snapshot. To learn more about labels, read
+the Labeling Resources
+documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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",
+  ],
+}
+
+ +
+ updateKmsKey(project, region, snapshot, body=None, requestId=None, x__xgafv=None) + 
Rotates the customer-managed
+encryption key to the latest version for the specified snapshot.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  snapshot: string, Name of the snapshot resource to update. Should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "kmsKeyName": "A String", # Optional. The new KMS key to replace the current one on the snapshot. If empty, the
+      # snapshot will be re-encrypted using the primary version of the snapshot's
+      # current KMS key.
+      # 
+      # The KMS key can be provided in the following formats:
+      # 
+      # 
+      #      - projects/project_id/locations/region/keyRings/region/cryptoKeys/key
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionSslCertificates.html b/docs/dyn/compute_preview.regionSslCertificates.html new file mode 100644 index 0000000000..dddb9ba3e8 --- /dev/null +++ b/docs/dyn/compute_preview.regionSslCertificates.html @@ -0,0 +1,1131 @@ + + + +

Compute Engine API . regionSslCertificates

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, sslCertificate, requestId=None, x__xgafv=None)

+

Deletes the specified SslCertificate resource in the region.

+

+ get(project, region, sslCertificate, x__xgafv=None)

+

Returns the specified SslCertificate resource in the specified region. Get

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a SslCertificate resource in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of SslCertificate resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, sslCertificate, requestId=None, x__xgafv=None) + 
Deletes the specified SslCertificate resource in the region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  sslCertificate: string, Name of the SslCertificate 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, sslCertificate, x__xgafv=None) + 
Returns the specified SslCertificate resource in the specified region. Get
+a list of available SSL certificates by making a list()
+request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  sslCertificate: string, Name of the SslCertificate 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 an SSL certificate resource.
+    #
+    # Google Compute Engine has two SSL certificate resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+    #
+    #
+    # The global SSL certificates (sslCertificates) are used by:
+    #
+    #    - Global external Application Load Balancers
+    #    - Classic Application Load Balancers
+    #    - Proxy Network Load Balancers (with target SSL proxies)
+    #
+    #
+    #
+    # The regional SSL certificates (regionSslCertificates) are used
+    # by:
+    #
+    #    - Regional external Application Load Balancers
+    #    - Regional internal Application Load Balancers
+    #
+    #
+    #
+    # Optionally, certificate file contents that you upload can contain a set of up
+    # to five PEM-encoded certificates.
+    # The API call creates an object (sslCertificate) that holds this data.
+    # You can use SSL keys and certificates to secure connections to a load
+    # balancer.
+    # For more information, read
+    # Creating and using SSL certificates,SSL certificates
+    # quotas and limits, and
+    # Troubleshooting SSL certificates.
+  "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+      # be in PEM format. The certificate chain must be no greater than 5 certs
+      # long. The chain must include at least one intermediate cert.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+  "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+    "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+        # certificate resource.
+      "a_key": "A String",
+    },
+    "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+        # Google-managed SSL certificate supports up to the [maximum number of
+        # domains per Google-managed SSL
+        # certificate](/load-balancing/docs/quotas#ssl_certificates).
+      "A String",
+    ],
+    "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+  },
+  "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.
+  "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+      # key file must be in PEM format. For security, only insert
+      # requests include this field.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+      # resides. This field is not applicable to global SSL Certificate.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+    "certificate": "A String", # A local certificate file. The certificate must be in
+        # PEM format. The certificate chain must be no greater than 5 certs
+        # long. The chain must include at least one intermediate cert.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert
+        # requests will include this field.
+  },
+  "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+      # Alternative Name.
+    "A String",
+  ],
+  "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+      # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a SslCertificate resource in the specified project and region using
+the data 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 an SSL certificate resource.
+    # 
+    # Google Compute Engine has two SSL certificate resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+    # 
+    # 
+    # The global SSL certificates (sslCertificates) are used by:
+    # 
+    #    - Global external Application Load Balancers
+    #    - Classic Application Load Balancers
+    #    - Proxy Network Load Balancers (with target SSL proxies)
+    # 
+    # 
+    # 
+    # The regional SSL certificates (regionSslCertificates) are used
+    # by:
+    # 
+    #    - Regional external Application Load Balancers
+    #    - Regional internal Application Load Balancers
+    # 
+    # 
+    # 
+    # Optionally, certificate file contents that you upload can contain a set of up
+    # to five PEM-encoded certificates.
+    # The API call creates an object (sslCertificate) that holds this data.
+    # You can use SSL keys and certificates to secure connections to a load
+    # balancer.
+    # For more information, read
+    # Creating and using SSL certificates,SSL certificates
+    # quotas and limits, and
+    # Troubleshooting SSL certificates.
+  "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+      # be in PEM format. The certificate chain must be no greater than 5 certs
+      # long. The chain must include at least one intermediate cert.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+  "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+    "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+        # certificate resource.
+      "a_key": "A String",
+    },
+    "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+        # Google-managed SSL certificate supports up to the [maximum number of
+        # domains per Google-managed SSL
+        # certificate](/load-balancing/docs/quotas#ssl_certificates).
+      "A String",
+    ],
+    "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+  },
+  "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.
+  "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+      # key file must be in PEM format. For security, only insert
+      # requests include this field.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+      # resides. This field is not applicable to global SSL Certificate.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+    "certificate": "A String", # A local certificate file. The certificate must be in
+        # PEM format. The certificate chain must be no greater than 5 certs
+        # long. The chain must include at least one intermediate cert.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert
+        # requests will include this field.
+  },
+  "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+      # Alternative Name.
+    "A String",
+  ],
+  "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+      # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of SslCertificate resources available to the specified
+project in the specified 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.
+  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 SslCertificate resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of SslCertificate resources.
+    { # Represents an SSL certificate resource.
+        #
+        # Google Compute Engine has two SSL certificate resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+        # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+        #
+        #
+        # The global SSL certificates (sslCertificates) are used by:
+        #
+        #    - Global external Application Load Balancers
+        #    - Classic Application Load Balancers
+        #    - Proxy Network Load Balancers (with target SSL proxies)
+        #
+        #
+        #
+        # The regional SSL certificates (regionSslCertificates) are used
+        # by:
+        #
+        #    - Regional external Application Load Balancers
+        #    - Regional internal Application Load Balancers
+        #
+        #
+        #
+        # Optionally, certificate file contents that you upload can contain a set of up
+        # to five PEM-encoded certificates.
+        # The API call creates an object (sslCertificate) that holds this data.
+        # You can use SSL keys and certificates to secure connections to a load
+        # balancer.
+        # For more information, read
+        # Creating and using SSL certificates,SSL certificates
+        # quotas and limits, and
+        # Troubleshooting SSL certificates.
+      "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+          # be in PEM format. The certificate chain must be no greater than 5 certs
+          # long. The chain must include at least one intermediate cert.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+      "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+        "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+            # certificate resource.
+          "a_key": "A String",
+        },
+        "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+            # Google-managed SSL certificate supports up to the [maximum number of
+            # domains per Google-managed SSL
+            # certificate](/load-balancing/docs/quotas#ssl_certificates).
+          "A String",
+        ],
+        "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+      },
+      "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.
+      "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+          # key file must be in PEM format. For security, only insert
+          # requests include this field.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+          # resides. This field is not applicable to global SSL Certificate.
+      "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+      "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+        "certificate": "A String", # A local certificate file. The certificate must be in
+            # PEM format. The certificate chain must be no greater than 5 certs
+            # long. The chain must include at least one intermediate cert.
+        "privateKey": "A String", # A write-only private key in PEM format. Only insert
+            # requests will include this field.
+      },
+      "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+          # Alternative Name.
+        "A String",
+      ],
+      "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+          # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+    },
+  ],
+  "kind": "compute#sslCertificateList", # 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionSslPolicies.html b/docs/dyn/compute_preview.regionSslPolicies.html new file mode 100644 index 0000000000..e88b54a58b --- /dev/null +++ b/docs/dyn/compute_preview.regionSslPolicies.html @@ -0,0 +1,1624 @@ + + + +

Compute Engine API . regionSslPolicies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, sslPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified SSL policy. The SSL policy resource can be deleted

+

+ get(project, region, sslPolicy, x__xgafv=None)

+

Lists all of the ordered rules present in a single specified policy.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a new policy in the specified project and region using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all the SSL policies that have been configured for the specified

+

+ listAvailableFeatures(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all features that can be specified in the SSL policy when using

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, sslPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified SSL policy with the data included in the request.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, sslPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified SSL policy. The SSL policy resource can be deleted
+only if it is not in use by any TargetHttpsProxy or TargetSslProxy
+resources.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  sslPolicy: string, Name of the SSL policy to delete. The name must be 1-63 characters long,
+and comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, sslPolicy, x__xgafv=None) + 
Lists all of the ordered rules present in a single specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  sslPolicy: string, Name of the SSL policy to update. The name must be 1-63 characters long,
+and comply with RFC1035. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an SSL Policy resource.
+    #
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a new policy in the specified project and region using the data
+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 an SSL Policy resource.
+    # 
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all the SSL policies that have been configured for the specified
+project and 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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # Output only. A list of SslPolicy resources.
+    { # Represents an SSL Policy resource.
+        #
+        # Use SSL policies to control SSL features, such as versions and cipher
+        # suites, that are offered by Application Load Balancers and proxy Network Load
+        # Balancers. For more information, read
+        # SSL policies overview.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+          #  method returns the set of features that can be
+          # specified in this list. This field must be empty if the profile is notCUSTOM.
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+        "A String",
+      ],
+      "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 SslPolicy. An up-to-date fingerprint must be
+          # provided in order to update the SslPolicy, otherwise the
+          # request will fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an SslPolicy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+      "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+          # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+          # must be set to RESTRICTED.
+      "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+          # X25519MLKEM768 key exchange when clients advertise support for it. When set
+          # to DEFAULT, or if no SSL Policy is attached to the target
+          # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+          # October 2026, and allows it afterward. When set to ENABLED,
+          # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+          # exchange until October 2027, and allows it afterward.
+      "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+          # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+          # the customFeatures field. If using FIPS_202205,
+          # the min_tls_version field must be set to TLS_1_2.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+          # resides. This field is not applicable to global SSL policies.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+          # SSL policy, this field will be populated with warning messages.
+        {
+          "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#sslPoliciesList", # Output only. [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies.
+  "nextPageToken": "A String", # Output only. [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.
+  "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.
+  },
+}
+
+ +
+ listAvailableFeatures(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all features that can be specified in the SSL policy when using
+custom profile.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "features": [
+    "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.
+
+
+ +
+ patch(project, region, sslPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified SSL policy with the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  sslPolicy: string, Name of the SSL policy 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 an SSL Policy resource.
+    # 
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionTargetHttpProxies.html b/docs/dyn/compute_preview.regionTargetHttpProxies.html new file mode 100644 index 0000000000..62a43ec902 --- /dev/null +++ b/docs/dyn/compute_preview.regionTargetHttpProxies.html @@ -0,0 +1,1390 @@ + + + +

Compute Engine API . regionTargetHttpProxies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, targetHttpProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetHttpProxy resource.

+

+ get(project, region, targetHttpProxy, x__xgafv=None)

+

Returns the specified TargetHttpProxy resource in the specified region.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetHttpProxy resource in the specified project and region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetHttpProxy resources available

+

+ list_next()

+

Retrieves the next page of results.

+

+ setUrlMap(project, region, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the URL map for TargetHttpProxy.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, targetHttpProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetHttpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetHttpProxy, x__xgafv=None) + 
Returns the specified TargetHttpProxy resource in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy 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 Target HTTP Proxy resource.
+    #
+    # Google Compute Engine has two Target HTTP Proxy resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+    #
+    # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+    #
+    # * targetHttpProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    #
+    # Forwarding rules reference a target HTTP proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "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 TargetHttpProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetHttpProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      #
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      #
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+      # for target HTTP proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+      # resides. This field is not applicable to global Target HTTP Proxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+      # the BackendService.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetHttpProxy resource in the specified project and region
+using the data 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 Target HTTP Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTP Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+    # 
+    # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+    # 
+    # * targetHttpProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTP proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "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 TargetHttpProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetHttpProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+      # for target HTTP proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+      # resides. This field is not applicable to global Target HTTP Proxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+      # the BackendService.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetHttpProxy resources available
+to the specified project in the specified 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of TargetHttpProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetHttpProxy resources.
+    { # Represents a Target HTTP Proxy resource.
+        #
+        # Google Compute Engine has two Target HTTP Proxy resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+        # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+        #
+        # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+        #
+        # * targetHttpProxies are used by global external Application Load Balancers,
+        #   classic Application Load Balancers, cross-region internal Application Load
+        #   Balancers, and Traffic Director.
+        # * regionTargetHttpProxies are used by regional internal Application Load
+        #   Balancers and regional external Application Load Balancers.
+        #
+        # Forwarding rules reference a target HTTP proxy, and the target proxy
+        # then references a URL map. For more information, readUsing Target Proxies
+        # and
+        # Forwarding rule concepts.
+      "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 TargetHttpProxy. An up-to-date fingerprint must
+          # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+          # request will fail with error 412 conditionNotMet. To see the
+          # latest fingerprint, make a get() request to retrieve the
+          # TargetHttpProxy.
+      "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+          # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+          # not specified, a default value (610 seconds) will be used.
+          #
+          # For global external Application Load Balancers, the minimum allowed value
+          # is 5 seconds and the maximum allowed value is 1200 seconds.
+          #
+          # For classic Application Load Balancers, this option is not supported.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+          # for target HTTP proxies.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+          # resides. This field is not applicable to global Target HTTP Proxies.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+          # the BackendService.
+    },
+  ],
+  "kind": "compute#targetHttpProxyList", # Output only. Type of resource. Always compute#targetHttpProxyList for lists
+      # of target HTTP proxies.
+  "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.
+  "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.
+
+
+ +
+ setUrlMap(project, region, targetHttpProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the URL map for TargetHttpProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy to set a URL map for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "urlMap": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionTargetHttpsProxies.html b/docs/dyn/compute_preview.regionTargetHttpsProxies.html new file mode 100644 index 0000000000..22ceab9ae5 --- /dev/null +++ b/docs/dyn/compute_preview.regionTargetHttpsProxies.html @@ -0,0 +1,2472 @@ + + + +

Compute Engine API . regionTargetHttpsProxies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, targetHttpsProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetHttpsProxy resource.

+

+ get(project, region, targetHttpsProxy, x__xgafv=None)

+

Returns the specified TargetHttpsProxy resource in the specified region.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetHttpsProxy resource in the specified project and region

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetHttpsProxy resources available

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified regional TargetHttpsProxy resource with the data

+

+ setSslCertificates(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Replaces SslCertificates for TargetHttpsProxy.

+

+ setUrlMap(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the URL map for TargetHttpsProxy.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, targetHttpsProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetHttpsProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetHttpsProxy, x__xgafv=None) + 
Returns the specified TargetHttpsProxy resource in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy 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 Target HTTPS Proxy resource.
+    #
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    #
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    #
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    #
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      #
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      #
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      #
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      #
+      # If set, sslCertificates will be ignored.
+      #
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      #
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      #
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      #
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      #
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      #
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      #
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      #
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      #
+      # Certificate Manager Certificates accepted formats are:
+      #
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      #
+      #
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      #
+      #
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      #
+      #
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      #
+      #
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      #
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetHttpsProxy resource in the specified project and region
+using the data 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 Target HTTPS Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    # 
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    # 
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      # 
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      # 
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      # 
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      # 
+      # If set, sslCertificates will be ignored.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      # 
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      # 
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      # 
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      # 
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      # 
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      # 
+      # Certificate Manager Certificates accepted formats are:
+      # 
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      # 
+      # 
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      # 
+      # 
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      # 
+      # 
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      # 
+      # 
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      # 
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetHttpsProxy resources available
+to the specified project in the specified 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.
+  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 TargetHttpsProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetHttpsProxy resources.
+    { # Represents a Target HTTPS Proxy resource.
+        #
+        # Google Compute Engine has two Target HTTPS Proxy resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+        # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+        #
+        # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+        #
+        # * targetHttpsProxies are used by global external Application Load Balancers,
+        #   classic Application Load Balancers, cross-region internal Application Load
+        #   Balancers, and Traffic Director.
+        # * regionTargetHttpsProxies are used by regional internal Application Load
+        #   Balancers and regional external Application Load Balancers.
+        #
+        # Forwarding rules reference a target HTTPS proxy, and the target proxy
+        # then references a URL map. For more information, readUsing Target Proxies
+        # and
+        # Forwarding rule concepts.
+      "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+          # that describes how the proxy should authorize inbound traffic. If left
+          # blank, access will not be restricted by an authorization policy.
+          #
+          #  Refer to the AuthorizationPolicy resource for additional
+          # details.
+          #
+          #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+          #
+          #  Note: This field currently has no impact.
+      "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+          # the given target proxy.
+          # This field can only be set for Global external Application Load Balancer or
+          # Classic Application Load Balancer. For other products use Certificate
+          # Manager Certificates instead.
+          #
+          # If set, sslCertificates will be ignored.
+          #
+          #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+      "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 TargetHttpsProxy. An up-to-date fingerprint must
+          # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+          # will fail with error 412 conditionNotMet. To see the latest
+          # fingerprint, make a get() request to retrieve the
+          # TargetHttpsProxy.
+      "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+          # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+          # not specified, a default value (610 seconds) will be used.
+          #
+          # For global external Application Load Balancers, the minimum allowed value
+          # is 5 seconds and the maximum allowed value is 1200 seconds.
+          #
+          # For classic Application Load Balancers, this option is not supported.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+          # setting determines whether the load balancer attempts to negotiate QUIC
+          # with clients.
+          # You can specify NONE, ENABLE, orDISABLE.
+          #
+          #    - When quic-override is set to NONE,
+          #    Google manages whether QUIC is used.
+          #    - When quic-override is set to ENABLE, the
+          #    load balancer uses QUIC when possible.
+          #    - When quic-override is set to DISABLE, the
+          #    load balancer doesn't use QUIC.
+          #    - If the quic-override flag is not specified,NONE is implied.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+          # resides. This field is not applicable to global TargetHttpsProxies.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+          # that describes how the proxy should authenticate inbound traffic.
+          #
+          #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+          # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+          # It also applies to a regional TargetHttpsProxy attached to
+          # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+          # documentation.
+          #
+          #   If left blank, communications are not encrypted.
+      "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+          # connections between users and the load balancer. At least one SSL
+          # certificate must be specified. SslCertificates do not apply when the load
+          # balancing scheme is set to INTERNAL_SELF_MANAGED.
+          #
+          # The URLs should refer to a SSL Certificate resource or Certificate Manager
+          # Certificate resource. Mixing Classic Certificates and Certificate Manager
+          # Certificates is not allowed. Certificate Manager Certificates must include
+          # the certificatemanager API namespace. Using Certificate Manager
+          # Certificates in this field is not supported by Global external Application
+          # Load Balancer or Classic Application Load Balancer, use certificate_map
+          # instead.
+          #
+          # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+          # Certificate Manager Certificates.
+          #
+          # Certificate Manager Certificates accepted formats are:
+          #
+          #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+          #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+        "A String",
+      ],
+      "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+          # resource. If not set, the TargetHttpsProxy resource has no
+          # SSL policy configured.
+      "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+          # for this service. Early Data allows a TLS resumption handshake to include
+          # the initial application payload (a HTTP request) alongside the handshake,
+          # reducing the effective round trips to "zero". This applies to TLS 1.3
+          # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+          #
+          #
+          # This can improve application performance, especially on networks where
+          # interruptions may be common, such as on mobile.
+          #
+          #
+          # Requests with Early Data will have the "Early-Data" HTTP header set on
+          # the request, with a value of "1", to allow the backend to determine whether
+          # Early Data was included.
+          #
+          #
+          # Note: TLS Early Data may allow requests to be replayed, as the data is
+          # sent to the backend before the handshake has fully completed. Applications
+          # that allow idempotent HTTP methods to make non-idempotent changes, such as
+          # a GET request updating a database, should not accept Early Data on those
+          # requests, and reject requests with the "Early-Data: 1" HTTP header by
+          # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+          # compliant.
+          #
+          #
+          # The default value is DISABLED.
+      "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+          # the mapping from URL to the BackendService. For example, the following are
+          # all valid URLs for specifying a URL map:
+          #
+          #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+          #    - projects/project/global/urlMaps/url-map
+          #    - global/urlMaps/url-map
+    },
+  ],
+  "kind": "compute#targetHttpsProxyList", # Output only. Type of resource. Always compute#targetHttpsProxyList for
+      # lists of target HTTPS proxies.
+  "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.
+  "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, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified regional TargetHttpsProxy resource with the data
+included in the request. This method supports PATCH
+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)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target HTTPS Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    # 
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    # 
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      # 
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      # 
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      # 
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      # 
+      # If set, sslCertificates will be ignored.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      # 
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      # 
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      # 
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      # 
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      # 
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      # 
+      # Certificate Manager Certificates accepted formats are:
+      # 
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      # 
+      # 
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      # 
+      # 
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      # 
+      # 
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      # 
+      # 
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      # 
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSslCertificates(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Replaces SslCertificates for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource to set an
+SslCertificates resource for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sslCertificates": [ # New set of SslCertificate resources to associate
+      # with this TargetHttpsProxy resource.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setUrlMap(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the URL map for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy to set a URL map for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "urlMap": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionTargetTcpProxies.html b/docs/dyn/compute_preview.regionTargetTcpProxies.html new file mode 100644 index 0000000000..bc513bca91 --- /dev/null +++ b/docs/dyn/compute_preview.regionTargetTcpProxies.html @@ -0,0 +1,997 @@ + + + +

Compute Engine API . regionTargetTcpProxies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, targetTcpProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetTcpProxy resource.

+

+ get(project, region, targetTcpProxy, x__xgafv=None)

+

Returns the specified TargetTcpProxy resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetTcpProxy resource in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of TargetTcpProxy resources

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, targetTcpProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetTcpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetTcpProxy, x__xgafv=None) + 
Returns the specified TargetTcpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy 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 Target TCP Proxy resource.
+    #
+    # A target TCP proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target TCP proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer 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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+  "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+      # This field is not applicable to global TCP proxy.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService resource.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetTcpProxy resource in the specified project and region using
+the data 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 Target TCP Proxy resource.
+    # 
+    # A target TCP proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target TCP proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer 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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+  "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+      # This field is not applicable to global TCP proxy.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of TargetTcpProxy resources
+available to the specified project in a 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.
+  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 TargetTcpProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetTcpProxy resources.
+    { # Represents a Target TCP Proxy resource.
+        #
+        # A target TCP proxy is a component of a Proxy Network Load Balancer.
+        # The forwarding rule references the target TCP proxy, and the target proxy
+        # then references a backend service. For more information, readProxy Network
+        # Load Balancer 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.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+      "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+          # backend, either NONE or PROXY_V1. The default
+          # is NONE.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+          # This field is not applicable to global TCP proxy.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "service": "A String", # URL to the BackendService resource.
+    },
+  ],
+  "kind": "compute#targetTcpProxyList", # 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionUrlMaps.html b/docs/dyn/compute_preview.regionUrlMaps.html new file mode 100644 index 0000000000..399760a66a --- /dev/null +++ b/docs/dyn/compute_preview.regionUrlMaps.html @@ -0,0 +1,23477 @@ + + + +

Compute Engine API . regionUrlMaps

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, urlMap, requestId=None, x__xgafv=None)

+

Deletes the specified UrlMap resource.

+

+ get(project, region, urlMap, x__xgafv=None)

+

Returns the specified UrlMap resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a UrlMap resource in the specified project using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of UrlMap resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)

+

Patches the specified UrlMap resource with the data included in the

+

+ update(project, region, urlMap, body=None, requestId=None, x__xgafv=None)

+

Updates the specified UrlMap resource with the data included in the

+

+ validate(project, region, urlMap, body=None, x__xgafv=None)

+

Runs static validation for the UrlMap. In particular, the tests of the

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, region, urlMap, requestId=None, x__xgafv=None) + 
Deletes the specified UrlMap resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  urlMap: string, Name of the UrlMap resource to delete. (required)
+  requestId: string, begin_interface: MixerMutationRequestBuilder
+Request ID to support idempotency.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, urlMap, x__xgafv=None) + 
Returns the specified UrlMap resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  urlMap: string, Name of the UrlMap 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 URL Map resource.
+    #
+    # Compute Engine has two URL Map resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    #
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    #
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    #
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    #
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    #
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    #
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      #
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      #
+      # For example, consider a UrlMap with the
+      # following configuration:
+      #
+      #
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      #
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      #
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      #
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      #
+      #
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      #
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      #
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a UrlMap resource in the specified project using
+the data 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 URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  requestId: string, begin_interface: MixerMutationRequestBuilder
+Request ID to support idempotency.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of UrlMap resources available to the specified
+project in the specified 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.
+  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 UrlMap resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of UrlMap resources.
+    { # Represents a URL Map resource.
+        #
+        # Compute Engine has two URL Map resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+        # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+        #
+        # A URL map resource is a component of certain types of cloud load balancers
+        # and Traffic Director:
+        #
+        # * urlMaps are used by global external Application Load
+        # Balancers, classic Application Load Balancers, and cross-region internal
+        # Application Load Balancers.
+        # * regionUrlMaps are used by internal Application Load Balancers,
+        # regional external Application Load Balancers and regional internal
+        # Application Load Balancers.
+        #
+        # For a list of supported URL map features by the load balancer type, see the
+        # Load balancing features: Routing and traffic management table.
+        #
+        # For a list of supported URL map features for Traffic Director, see the
+        # Traffic Director features: Routing and traffic management table.
+        #
+        # This resource defines mappings from hostnames and URL paths to either a
+        # backend service or a backend bucket.
+        #
+        # To use the global urlMaps resource, the backend service must
+        # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+        # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+        # information, read URL
+        # Map Concepts.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the load balancer level and applies only when no policy has been
+          # defined for the error code at lower levels like PathMatcher, RouteRule and
+          # PathRule within this UrlMap.
+          #
+          # For example, consider a UrlMap with the
+          # following configuration:
+          #
+          #
+          #      - defaultCustomErrorResponsePolicy containing policies for
+          #      responding to 5xx and 4xx errors
+          #      - A PathMatcher configured for *.example.com has
+          #      defaultCustomErrorResponsePolicy for 4xx.
+          #
+          # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+          # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+          # a request that does not match any host in *.example.com such
+          # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+          # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # hostRules match. The load balancer performs advanced routing
+          # actions, such as URL rewrites and header transformations, before forwarding
+          # the request to the selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          #  URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within defaultRouteAction.
+          #
+          #
+          # defaultRouteAction has no effect when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL of the defaultService resource to
+          # which traffic is directed if none of the hostRules match.
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # defaultService has no effect when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+          # is redirected to a URL specified by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "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 is ignored when
+          # inserting a UrlMap. An up-to-date fingerprint must be provided
+          # in order to update the UrlMap, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a UrlMap.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backendService.
+          #
+          # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+          #
+          # headerAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "hostRules": [ # The list of host rules to use against the URL.
+        { # UrlMaps
+            # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+              # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+              # that case, * must be the first character, and if followed by
+              # anything, the immediate following character must be either -
+              # or ..
+              #
+              # * based matching is not supported when the URL map is bound
+              # to a target gRPC proxy that has the validateForProxyless field
+              # set to true.
+            "A String",
+          ],
+          "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+              # of the URL if the hostRule matches the URL's host portion.
+        },
+      ],
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+          # url maps.
+      "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.
+      "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+        { # A matcher for the path portion of the URL. The BackendService
+            # from the longest-matched rule will serve the URL. If no rule was matched, the
+            # default service is used.
+          "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # This policy takes
+              # effect at the PathMatcher level and applies only when no
+              # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+              # in defaultCustomErrorResponsePolicy, then a policy defined for
+              # the error code in UrlMap.defaultCustomErrorResponsePolicy
+              # takes effect.
+              #
+              # For example, consider a UrlMap with the following
+              # configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the defaultCustomErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # defaultCustomErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+              # pathRules or routeRules match. The load balancer
+              # performs advanced routing actions, such as URL rewrites and
+              # header transformations, before forwarding the request to the
+              # selected backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path matcher'sdefaultRouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+              # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+              # matched. For example, the
+              # following are all valid URLs to a BackendService resource:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+              #      - compute/v1/projects/project/global/backendServices/backendService
+              #      - global/backendServices/backendService
+              #
+              #
+              # If defaultRouteAction is also specified, advanced
+              # routing actions, such as URL rewrites, take effect before sending the
+              # request to the backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # Authorization requires one or more of the following Google IAM permissions on the
+              # specified resource default_service:
+              #
+              #
+              #       - compute.backendBuckets.use
+              #       - compute.backendServices.use
+          "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+              # by defaultUrlRedirect.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backend service.
+              #
+              # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+          "pathRules": [ # The list of path rules. Use this list instead of routeRules
+              # when routing based on simple path matching is all that's required. A path
+              # rule can only include a wildcard character (*) after a
+              # forward slash character ("/").
+              #
+              # The order by which path rules are specified does not matter.
+              # Matches are always done on the longest-path-first basis.
+              #
+              # For example: a pathRule with a path /a/b/c/* will match
+              # before /a/b/* irrespective of the order in which those paths appear in this
+              # list.
+              #
+              # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+            { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+              "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                  # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                  #
+                  # If a policy for an
+                  # error code is not configured for the PathRule, a policy for
+                  # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                  # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                  # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                  # effect.
+                  #
+                  # For example, consider a UrlMap with the following configuration:
+                  #
+                  #
+                  #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                  #      with policies for 5xx and 4xx errors
+                  #      - A PathRule for /coming_soon/ is configured for the error
+                  #      code 404.
+                  #
+                  # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                  # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                  # the policy in PathRule.customErrorResponsePolicy takes
+                  # effect. If any of the requests in this example encounter a 500
+                  # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                  #
+                  # customErrorResponsePolicy is supported only for
+                  # global external Application Load Balancers.
+                  # backend service or backend bucket responds with an error.
+                "errorResponseRules": [ # Specifies rules for returning error responses.
+                    #
+                    # In a given policy, if you specify rules for both a range of error codes
+                    # as well as rules for specific error codes then rules with specific error
+                    # codes have a higher priority. For example, assume that you configure a rule
+                    # for 401 (Un-authorized) code, and another for all 4 series
+                    # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                    # However if the backend service returns a 403, the rule for4xx takes effect.
+                  { # Specifies the mapping between the response code that will be returned along
+                      # with the custom error content and the response code returned by the backend
+                      # service.
+                    "matchResponseCodes": [ # Valid values include:
+                        #
+                        #
+                        #      - A number between 400 and 599: For example
+                        #      401 or 503, in which case the load balancer
+                        #      applies the policy if the error code exactly matches this value.
+                        #      - 5xx: Load Balancer will apply the policy if the
+                        #      backend service responds with any response code in the range of
+                        #      500 to 599.
+                        #    - 4xx: Load
+                        #      Balancer will apply the policy if the backend service responds with any
+                        #      response code in the range of 400 to
+                        #      499.
+                        #
+                        # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                      "A String",
+                    ],
+                    "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                        # error content. If overrideResponseCode is not supplied, the
+                        # same response code returned by the original backend bucket or backend
+                        # service is returned to the client.
+                    "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                        #
+                        # path must start
+                        # with a leading slash. path cannot have trailing slashes.
+                        #
+                        # If the file is not available in backendBucket  or the
+                        # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                        #
+                        # The value must
+                        # be from 1 to 1024 characters
+                  },
+                ],
+                "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                    # contains the custom error content. Examples are:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - global/backendBuckets/myBackendBucket
+                    #
+                    # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                    # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                    #
+                    # If load balancer cannot reach
+                    # the backendBucket, a simple Not Found Error will
+                    # be returned, with the original response code (oroverrideResponseCode if configured).
+                    #
+                    # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+              },
+              "paths": [ # The list of path patterns to match. Each must start with /
+                  # and the only place a * is allowed is at the end following
+                  # a /.  The string fed to the path matcher does not include
+                  # any text after the first ? or #, and
+                  # those chars are not allowed here.
+                "A String",
+              ],
+              "routeAction": { # In response to a matching path, the load balancer
+                  # performs advanced routing actions, such as URL rewrites and header
+                  # transformations, before forwarding the request to the selected
+                  # backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # URL maps for classic Application Load Balancers only support
+                  # the urlRewrite action within a path rule'srouteAction.
+                "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                    # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                    # property must be specified. This policy cannot be specified if any target
+                    # backend has Identity-Aware Proxy enabled.
+                  "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                      # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                      # header names can be specified. The cache is bypassed for all `cacheMode`
+                      # values.
+                    "A String",
+                  ],
+                  "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                      # on the backend type: for Backend Services, the complete request URI is
+                      # used; for Backend Buckets, the request URI is used without the protocol or
+                      # host, and only query parameters known to Cloud Storage are included.
+                      # Policy defined on Route Action.
+                    "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                        # parameters will be included. Either specify `excludedQueryParameters`
+                        # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                      "A String",
+                    ],
+                    "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # host is never included in a Backend Bucket's cache key. Attempting to set
+                        # it on a route that points exclusively to Backend Buckets will result in a
+                        # configuration error.
+                    "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # protocol is never included in a Backend Bucket's cache key. Attempting to
+                        # set on a route that points exclusively to Backend Buckets will result in
+                        # a configuration error.
+                    "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                        # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                        # is set, the entire query string will be included. If false, the query
+                        # string will be excluded from the cache key entirely.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                    "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                        # The name=value pair will be used in the cache key Cloud CDN generates.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket.
+                        # Attempting to set it on a route that points exclusively to Backend
+                        # Buckets will result in a configuration error. Up to 5 cookie names can be
+                        # specified.
+                      "A String",
+                    ],
+                    "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                      "A String",
+                    ],
+                    "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                        # parameters will be excluded. Either specify `includedQueryParameters`
+                        # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                      "A String",
+                    ],
+                  },
+                  "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                      # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                  "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                      # content. This is used to clamp the max-age (or Expires) value sent to the
+                      # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                      # is used for the response max-age directive, along with a "public"
+                      # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                      # clamps the max-age from the origin (if specified), or else sets the
+                      # response max-age directive to the lesser of the `clientTtl` and
+                      # `defaultTtl`, and also ensures a "public" cache-control directive is
+                      # present. The maximum allowed value is 31,622,400s (1 year). If not
+                      # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                      # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                      # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                      # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                      # greater than that of `maxTtl`. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                      # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                      # accessed objects may be evicted from the cache before the defined TTL. If
+                      # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                      # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                      # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                      # more than `maxTtl` seconds in the future will be capped at the value of
+                      # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                      # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                      # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                      # Infrequently accessed objects may be evicted from the cache before the
+                      # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                      # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                      # mode.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                      # to apply fine-grained caching for common errors or redirects.
+                      # This can reduce the load on your origin and improve end-user
+                      # experience by reducing response latency.
+                      # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                      # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                      # the specified response code that lack any Cache-Control, Expires, or
+                      # Pragma: no-cache directives. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                      # with the specified response code, and overrides any caching headers. By
+                      # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                      #
+                      # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                      # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                      # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                      #
+                      # These defaults can be overridden in `negativeCachingPolicy`.
+                      # If not specified, Cloud CDN applies negative caching by default.
+                  "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                      # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                      # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                      # CDN's default cache TTLs. Note that when specifying an explicit
+                      # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                      # all response codes that you wish to cache. Cloud CDN will not apply any
+                      # default negative caching when a policy exists.
+                    { # Specify CDN TTLs for response error codes.
+                      "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                          # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                          # specified as values, and you cannot specify a status code more than
+                          # once.
+                      "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                          # corresponding status code.
+                          # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                          # objects may be evicted from the cache before the defined TTL.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                  ],
+                  "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                      # requests into a small number of requests to the origin. If not specified,
+                      # Cloud CDN applies request coalescing by default.
+                  "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                      # content with the origin, or when an error is encountered when refreshing
+                      # the cache.
+                      # This setting defines the default "max-stale" duration for any cached
+                      # responses that do not specify a max-stale directive. Stale responses that
+                      # exceed the TTL configured here will not be served. The default limit
+                      # (max-stale) is 86400s (1 day), which will allow stale content to be
+                      # served up to this limit beyond the max-age (or s-maxage) of a cached
+                      # response.
+                      # The maximum allowed value is 604800 (1 week).
+                      # Set this to zero (0) to disable serve-while-stale.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+                "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                  "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                      # indicates that
+                      # the actual request can include user credentials. This field translates to
+                      # the Access-Control-Allow-Credentials header.
+                      #
+                      # Default is false.
+                  "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                      # header.
+                    "A String",
+                  ],
+                  "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                      # more information, see regular expression syntax.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED.
+                    "A String",
+                  ],
+                  "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    "A String",
+                  ],
+                  "disabled": True or False, # If true, disables the CORS policy.
+                      # The default value is false, which indicates that the CORS
+                      # policy is in effect.
+                  "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                      # seconds. This field translates to the Access-Control-Max-Age
+                      # header.
+                },
+                "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by a load balancer on a percentage of requests before sending
+                    # those requests to the backend service. Similarly requests from clients can
+                    # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                    # that are configured with a fault_injection_policy if:
+                    # 1. The traffic is generated by fault injection AND
+                    # 2. The fault injection is not a delay fault injection.
+                    # Fault injection is not supported with the classic Application Load Balancer
+                    # . To see which load balancers support fault injection,
+                    # see Load
+                    # balancing: Routing and traffic management features.
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by the load balancer on a percentage of requests before sending
+                    # those request to the backend service. Similarly requests from clients can be
+                    # aborted by the load balancer for a percentage of requests.
+                  "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                      # injection.
+                    "httpStatus": 42, # The HTTP status code used to abort the request.
+                        #
+                        # The value must be from 200 to 599 inclusive.
+                        #
+                        # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                        # according to this
+                        # mapping table. HTTP status 200 is mapped to gRPC status
+                        # UNKNOWN. Injecting an OK status is currently not supported by
+                        # Traffic Director.
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                        # that is aborted as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                  "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                      # injection, before being sent to a backend service.
+                      # request to the backend service as part of fault injection.
+                    "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                        # which a delay is introduced as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                },
+                "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                    # Unlike the timeout field where the timeout duration starts
+                    # from the time the request has been fully processed (known as*end-of-stream*),
+                    # the duration in this field is computed from the beginning of the stream
+                    # until the response has been processed, including all retries. A
+                    # stream that does not complete in this duration is closed.
+                    #
+                    # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                    # with the route.
+                    #
+                    # This field is only allowed if the Url map is used with backend services
+                    # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                    # are shadowed to a separate mirrored backend service. The load balancer does
+                    # not wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host / authority header is suffixed with-shadow.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # are shadowed to a separate mirrored backend service. The load balancer
+                    # doesn't wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host or authority header is suffixed with-shadow.
+                  "backendService": "A String", # The full or partial URL to the BackendService resource being
+                      # mirrored to.
+                      #
+                      # The backend service configured for a mirroring
+                      # policy must reference backends that are of the same type as the original
+                      # backend service matched in the URL map.
+                      #
+                      # Serverless NEG backends are not currently supported as a mirrored
+                      # backend service.
+                  "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                },
+                "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                  "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                      # If not specified, defaults to 1.
+                  "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                      #
+                      # If not specified, will use the timeout set in theHttpRouteAction field.
+                      # If timeout in the HttpRouteAction field is not set, this field
+                      # uses the largest timeout
+                      # among all backend services associated with the route.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has the validateForProxyless field set to true.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                      # values are:
+                      #
+                      #    - 5xx: retry is attempted if the instance or endpoint
+                      #    responds with any 5xx response code, or if the instance or
+                      #    endpoint does not respond at all. For example, disconnects, reset, read
+                      #    timeout, connection failure, and refused streams.
+                      #    - gateway-error: Similar to 5xx, but only
+                      #    applies to response codes 502, 503 or504.
+                      #    - connect-failure: a retry is attempted on failures
+                      #    connecting to the instance or endpoint. For example, connection
+                      #    timeouts.
+                      #    - retriable-4xx: a retry is attempted if the instance
+                      #    or endpoint responds with a 4xx response code.
+                      #    The only error that you can retry is error code 409.
+                      #    - refused-stream: a retry is attempted if the instance
+                      #    or endpoint resets the stream with a REFUSED_STREAM error
+                      #    code. This reset type indicates that it is safe to retry.
+                      #    - cancelled: a retry is attempted if the gRPC status
+                      #    code in the response header is set to cancelled.
+                      #    - deadline-exceeded: a retry is attempted if the gRPC
+                      #    status code in the response header is set todeadline-exceeded.
+                      #    - internal: a retry is attempted if the gRPC
+                      #    status code in the response header is set tointernal.
+                      #    - resource-exhausted: a retry is attempted if the gRPC
+                      #    status code in the response header is set toresource-exhausted.
+                      #    - unavailable: a retry is attempted if the gRPC
+                      #    status code in the response header is set tounavailable.
+                      #
+                      # Only the following codes are supported when the URL map is bound to
+                      # target gRPC proxy that has validateForProxyless field set to true.
+                      #
+                      #    - cancelled
+                      #    - deadline-exceeded
+                      #    - internal
+                      #    - resource-exhausted
+                      #    - unavailable
+                    "A String",
+                  ],
+                },
+                "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                    # time the request has been fully processed (known as *end-of-stream*)
+                    # up until the response has been processed. Timeout includes
+                    # all retries.
+                    #
+                    # If not specified, this field uses the largest timeout among all backend
+                    # services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                    # to the matched service.
+                    #
+                    #  urlRewrite is the only action supported in UrlMaps
+                    # for classic Application Load Balancers.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # backend service.
+                  "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                      # host header is replaced with contents of hostRewrite.
+                      #
+                      # The value must be from 1 to 255 characters.
+                  "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                      # matching portion of the request's path is replaced bypathPrefixRewrite.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                  "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                      # header) using the HTTP template syntax.
+                      #
+                      # A corresponding
+                      # path_template_match must be specified. Any template variables must exist in
+                      # the path_template_match field.
+                      #
+                      #
+                      #       - -At least one variable must be specified in the path_template_match
+                      #       field
+                      #    - You can omit variables from the rewritten URL
+                      #       - The * and ** operators cannot be matched
+                      #       unless they have a corresponding variable name - e.g.
+                      #       {format=*} or {var=**}.
+                      #
+                      # For example, a path_template_match of /static/{format=**}
+                      # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                      # rewrite, so that /{country}/{format}/{suffix=**} can be
+                      # rewritten as /content/{format}/{country}/{suffix}.
+                      #
+                      # At least
+                      # one non-empty routeRules[].matchRules[].path_template_match is
+                      # required.
+                      #
+                      # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                  "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                    "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                        # It uses RE2 syntax with the following constraints:
+                        #
+                        #
+                        #      - Any single character operators
+                        #      - Groups are allowed to have only submatch operator inside
+                        #      - Groups are allowed only without any char repetition, e.g.
+                        #      .*
+                        #      - Any char repetition, e.g. .*, is
+                        #      only allowed to be used in a single regex together with:
+                        #
+                        #
+                        #             - Empty string operators
+                        #             - Other repetitions
+                        #             - Ranges
+                        #             - Repetitions of ranges
+                        #
+                        #
+                        #      - Ranges are only allowed to have:
+                        #
+                        #
+                        #             - Character range
+                        #             - Digits range
+                        #             - Symbols listed in characters allowed for ranges
+                    "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                        # the path.
+                  },
+                },
+                "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                    # occurs. The weights determine the fraction of traffic that flows to
+                    # their corresponding backend service. If all traffic needs to
+                    # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                    #
+                    # After a backend service is identified and before forwarding
+                    # the request to
+                    # the backend service, advanced routing actions such as URL rewrites and
+                    # header transformations are applied depending on additional settings
+                    # specified in this HttpRouteAction.
+                  { # In contrast to a single BackendService in
+                      # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                      # multiple backend services. The volume of traffic for each
+                      # backend service is proportional to the weight specified
+                      # in each WeightedBackendService
+                    "backendService": "A String", # The full or partial URL to the default BackendService
+                        # resource. Before
+                        # forwarding the request to backendService, the load balancer
+                        # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                        # effect for the selected backendService.
+                        #
+                        # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                        #
+                        # headerAction is not supported for load balancers that have
+                        # their loadBalancingScheme set to EXTERNAL.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # the request is passed along to the selected backendService.
+                      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # request before forwarding the request to the backendService.
+                        "A String",
+                      ],
+                      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                          # client.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # response before sending the response back to the client.
+                        "A String",
+                      ],
+                    },
+                    "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                        # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                        #
+                        # The selection of a backend service is determined only for new traffic.
+                        # Once a user's request has been directed to a backend service,
+                        # subsequent requests are sent to the same backend service as
+                        # determined by the backend service's session affinity policy.
+                        # Don't configure session affinity if you're using weighted traffic
+                        # splitting. If you do, the weighted traffic splitting configuration takes
+                        # precedence.
+                        #
+                        # The value must be from 0 to 1000.
+                  },
+                ],
+              },
+              "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                  # is directed if this rule is matched. If routeAction is
+                  # also specified, advanced routing actions, such as URL rewrites,
+                  # take effect before sending the request to the backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+                  # specified by urlRedirect.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                    # was supplied in the request.
+                    #
+                    # The value must be from 1 to 255
+                    # characters.
+                "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                    # set to HTTPS.
+                    # If set to false, the URL scheme of the redirected request
+                    # remains the same as that of the request.
+                    #
+                    # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                    #
+                    # The default is set to false.
+                "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                    # that was supplied in the request.
+                    #
+                    # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                    # the HttpRouteRuleMatch, retaining the remaining portion
+                    # of the URL before redirecting the request.
+                    #
+                    # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                    #
+                    # Supported values are:
+                    #
+                    #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                    #    to 301.
+                    #    - FOUND, which corresponds to 302.
+                    #    - SEE_OTHER which corresponds to 303.
+                    #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                    #    method is retained.
+                    #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                    #    method is retained.
+                "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                    # URL is
+                    # removed before redirecting the request. If set to false, the
+                    # query portion of the original URL is retained.
+                    #
+                    # The default is set to false.
+              },
+            },
+          ],
+          "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+              # desired. routeRules are evaluated in order of priority, from
+              # the lowest to highest number.
+              #
+              # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+            { # The HttpRouteRule setting specifies how to match an HTTP request
+                # and the corresponding routing action that load balancing proxies perform.
+              "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                  # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                  #
+                  # If a policy for an
+                  # error code is not configured for the RouteRule, a policy for
+                  # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                  # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                  # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                  # effect.
+                  #
+                  # For example, consider a UrlMap with the following configuration:
+                  #
+                  #
+                  #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                  #      with policies for 5xx and 4xx errors
+                  #      - A RouteRule for /coming_soon/ is configured for the
+                  #      error code 404.
+                  #
+                  # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                  # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                  # the policy in RouteRule.customErrorResponsePolicy takes
+                  # effect. If any of the requests in this example encounter a 500
+                  # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                  #
+                  # When
+                  # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+                  # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+                  # a retry, if load balancer is successful in reaching the
+                  # service, the customErrorResponsePolicy is ignored and
+                  # the response from the service is returned to the client.
+                  #
+                  # customErrorResponsePolicy is supported only for
+                  # global external Application Load Balancers.
+                  # backend service or backend bucket responds with an error.
+                "errorResponseRules": [ # Specifies rules for returning error responses.
+                    #
+                    # In a given policy, if you specify rules for both a range of error codes
+                    # as well as rules for specific error codes then rules with specific error
+                    # codes have a higher priority. For example, assume that you configure a rule
+                    # for 401 (Un-authorized) code, and another for all 4 series
+                    # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                    # However if the backend service returns a 403, the rule for4xx takes effect.
+                  { # Specifies the mapping between the response code that will be returned along
+                      # with the custom error content and the response code returned by the backend
+                      # service.
+                    "matchResponseCodes": [ # Valid values include:
+                        #
+                        #
+                        #      - A number between 400 and 599: For example
+                        #      401 or 503, in which case the load balancer
+                        #      applies the policy if the error code exactly matches this value.
+                        #      - 5xx: Load Balancer will apply the policy if the
+                        #      backend service responds with any response code in the range of
+                        #      500 to 599.
+                        #    - 4xx: Load
+                        #      Balancer will apply the policy if the backend service responds with any
+                        #      response code in the range of 400 to
+                        #      499.
+                        #
+                        # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                      "A String",
+                    ],
+                    "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                        # error content. If overrideResponseCode is not supplied, the
+                        # same response code returned by the original backend bucket or backend
+                        # service is returned to the client.
+                    "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                        #
+                        # path must start
+                        # with a leading slash. path cannot have trailing slashes.
+                        #
+                        # If the file is not available in backendBucket  or the
+                        # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                        #
+                        # The value must
+                        # be from 1 to 1024 characters
+                  },
+                ],
+                "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                    # contains the custom error content. Examples are:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - global/backendBuckets/myBackendBucket
+                    #
+                    # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                    # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                    #
+                    # If load balancer cannot reach
+                    # the backendBucket, a simple Not Found Error will
+                    # be returned, with the original response code (oroverrideResponseCode if configured).
+                    #
+                    # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+              },
+              "description": "A String", # The short description conveying the intent of this routeRule.
+                  #
+                  #
+                  # The description can have a maximum length of 1024 characters.
+              "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                  # for the selected backendService.
+                  #
+                  # The headerAction value specified here is applied before the
+                  # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+                  #
+                  # HeaderAction is not supported for load balancers
+                  # that have
+                  # their loadBalancingScheme set to EXTERNAL.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # the request is passed along to the selected backendService.
+                "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # request before forwarding the request to the backendService.
+                  "A String",
+                ],
+                "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                    # client.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # response before sending the response back to the client.
+                  "A String",
+                ],
+              },
+              "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+                  # this routeRule when any of thematchRules are satisfied. However predicates within
+                  # a given matchRule have AND semantics. All predicates
+                  # within a matchRule must match for the request to
+                  # match the rule.
+                { # HttpRouteRuleMatch specifies a set of criteria for matching
+                    # requests to an HttpRouteRule. All specified criteria must
+                    # be satisfied for a match to occur.
+                  "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                      # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                      # that may be part of the original URL.
+                      #
+                      # fullPathMatch must be from 1 to 1024 characters.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                      # specified.
+                  "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                      # corresponding headers in the request.
+                    { # matchRule criteria for request header matches.
+                      "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "headerName": "A String", # The name of the HTTP header to match.
+                          #
+                          # For matching against the HTTP request's authority, use a headerMatch
+                          # with the header name ":authority".
+                          #
+                          # For matching a request's method, use the headerName ":method".
+                          #
+                          # When the URL map is bound to a target gRPC proxy that has
+                          # the validateForProxyless field set to true, only
+                          # non-binary
+                          # user-specified custom metadata and the `content-type` header are supported.
+                          # The following transport-level headers cannot be used in header matching
+                          # rules:
+                          # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                          # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                          # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                          # `grpc-timeout` and `grpc-trace-bin`.
+                      "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                          # match if the preceding match criteria are met. If set to true,
+                          # the headerMatch is considered a match if the preceding
+                          # match criteria are NOT met.
+                          #
+                          # The default setting is false.
+                      "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                          # match takes place whether or not the request's header has a value.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                          # specified in rangeMatch. If the header does not contain an
+                          # integer, number or is empty, the match fails.
+                          #
+                          # For example for a range [-5, 0]
+                          #
+                          #
+                          #       - -3 will match.
+                          #       - 0 will not match.
+                          #       - 0.25 will not match.
+                          #       - -3someString will not match.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          #
+                          # rangeMatch is not supported for load balancers
+                          # that have loadBalancingScheme set to EXTERNAL.
+                          # within the specified integer range.
+                        "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                        "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                      },
+                      "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                          # For more information about regular expression syntax, see Syntax.
+                          #
+                          # For matching against a port specified in the HTTP request, use a
+                          # headerMatch with headerName set to PORT and a regular expression that
+                          # satisfies the RFC2616 Host header's port specifier.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                          # (regional scope) or INTERNAL_MANAGED.
+                      "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    },
+                  ],
+                  "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                      # matches are case sensitive.
+                      #
+                      # The default value is false.
+                      #
+                      # ignoreCase must not be used with regexMatch.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                  "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                      # configuration to a limited set of xDS
+                      # compliant clients. In their xDS requests to the load balancer, xDS clients
+                      # present node
+                      # metadata. When there is a match, the relevant routing configuration
+                      # is made available to those proxies.
+                      #
+                      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                      # the metadata. If its filterMatchCriteria is set to
+                      # MATCH_ALL, then all of its filterLabels must match with
+                      # corresponding labels provided in the metadata. If multiple
+                      # metadata filters are specified, all of them need to be
+                      # satisfied in order to be considered a match.
+                      #
+                      # metadataFilters specified here is applied after those
+                      # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                      #
+                      # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                    { # Opaque filter criteria used by load balancers to restrict routing
+                        # configuration to a limited set of load balancing proxies. Proxies and
+                        # sidecars involved in load balancing would typically present metadata to the
+                        # load balancers that need to match criteria specified here. If a match takes
+                        # place, the relevant configuration is made available to those
+                        # proxies.
+                        #
+                        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                        # one of thefilterLabels must match the corresponding label provided in
+                        # the metadata. If its filterMatchCriteria is set to
+                        # MATCH_ALL, then all of its filterLabels must match with
+                        # corresponding labels provided in the metadata.
+                        #
+                        # An example for using metadataFilters would be: if
+                        # load balancing involves
+                        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                          # metadata based on filterMatchCriteria
+                          #
+                          # This list must not be empty and can have at the most 64 entries.
+                        { # MetadataFilter label name value pairs that are expected
+                            # to match corresponding labels presented as metadata to the load balancer.
+                          "name": "A String", # Name of metadata label.
+                              #
+                              #  The name can have a maximum length of 1024 characters and must be at
+                              # least 1 character long.
+                          "value": "A String", # The value of the label must match the specified value.
+                              #
+                              # value can have a maximum length of 1024 characters.
+                        },
+                      ],
+                      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                          # within the list of filterLabels and contributes toward the
+                          # overall metadataFilter match.
+                          #
+                          #  Supported values are:
+                          #
+                          #    - MATCH_ANY: at least one of the filterLabels
+                          #    must have a matching label in the provided metadata.
+                          #    - MATCH_ALL: all filterLabels must have
+                          #    matching labels in the provided metadata.
+                    },
+                  ],
+                  "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                      # the :path header after the query string is removed.
+                      #
+                      # A path template pattern can include variables and wildcards.
+                      # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                      # matches a single path segment, and ** that matches zero or
+                      # more path segments. The pattern must follow these rules:
+                      #
+                      #
+                      #       - The value must be between 1 and 1024 characters.
+                      #       - The pattern must start with a leading slash ("/").
+                      #       - No more than 5 operators (variables or wildcards) may appear in
+                      #       the pattern.
+                      #
+                      # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                      # set.
+                  "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                      # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                      #
+                      # The * character inside a prefix match is
+                      # treated as a literal character, not as a wildcard.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                      # used within a matchRule.
+                  "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                      # match corresponding query parameters in the request.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                    { # HttpRouteRuleMatch criteria for a request's query parameter.
+                      "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                          # parameter exactly matches the contents of exactMatch.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                          # the request, in the absence of which the request match fails.
+                      "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                          # request contains the query parameter, irrespective of whether the
+                          # parameter has a value or not.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                          # parameter matches the regular expression specified byregexMatch. For
+                          # more information about regular expression syntax, see Syntax.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                          # (regional scope) or INTERNAL_MANAGED.
+                    },
+                  ],
+                  "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                      # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                      # supplied with the original URL. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                      # specified.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "priority": 42, # For routeRules within a given pathMatcher,
+                  # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+                  # of priority, from the lowest to highest number. The priority of a
+                  # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+                  # that matches the request is applied.
+                  #
+                  #
+                  # You cannot configure two or more routeRules with the same priority.
+                  # Priority for each rule must be set to a number from 0 to 2147483647
+                  # inclusive.
+                  #
+                  #
+                  # Priority numbers can have gaps, which enable you to add or remove rules
+                  # in the future without affecting the rest of the rules. For example, 1, 2,
+                  # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+                  # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+                  # without any impact on existing rules.
+              "routeAction": { # In response to a matching matchRule, the load balancer
+                  # performs advanced routing actions, such as URL rewrites and header
+                  # transformations, before forwarding the request to the selected backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # URL maps for classic Application Load Balancers only support
+                  # the urlRewrite action within a route rule'srouteAction.
+                "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                    # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                    # property must be specified. This policy cannot be specified if any target
+                    # backend has Identity-Aware Proxy enabled.
+                  "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                      # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                      # header names can be specified. The cache is bypassed for all `cacheMode`
+                      # values.
+                    "A String",
+                  ],
+                  "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                      # on the backend type: for Backend Services, the complete request URI is
+                      # used; for Backend Buckets, the request URI is used without the protocol or
+                      # host, and only query parameters known to Cloud Storage are included.
+                      # Policy defined on Route Action.
+                    "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                        # parameters will be included. Either specify `excludedQueryParameters`
+                        # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                      "A String",
+                    ],
+                    "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # host is never included in a Backend Bucket's cache key. Attempting to set
+                        # it on a route that points exclusively to Backend Buckets will result in a
+                        # configuration error.
+                    "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # protocol is never included in a Backend Bucket's cache key. Attempting to
+                        # set on a route that points exclusively to Backend Buckets will result in
+                        # a configuration error.
+                    "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                        # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                        # is set, the entire query string will be included. If false, the query
+                        # string will be excluded from the cache key entirely.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                    "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                        # The name=value pair will be used in the cache key Cloud CDN generates.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket.
+                        # Attempting to set it on a route that points exclusively to Backend
+                        # Buckets will result in a configuration error. Up to 5 cookie names can be
+                        # specified.
+                      "A String",
+                    ],
+                    "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                      "A String",
+                    ],
+                    "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                        # parameters will be excluded. Either specify `includedQueryParameters`
+                        # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                      "A String",
+                    ],
+                  },
+                  "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                      # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                  "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                      # content. This is used to clamp the max-age (or Expires) value sent to the
+                      # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                      # is used for the response max-age directive, along with a "public"
+                      # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                      # clamps the max-age from the origin (if specified), or else sets the
+                      # response max-age directive to the lesser of the `clientTtl` and
+                      # `defaultTtl`, and also ensures a "public" cache-control directive is
+                      # present. The maximum allowed value is 31,622,400s (1 year). If not
+                      # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                      # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                      # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                      # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                      # greater than that of `maxTtl`. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                      # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                      # accessed objects may be evicted from the cache before the defined TTL. If
+                      # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                      # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                      # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                      # more than `maxTtl` seconds in the future will be capped at the value of
+                      # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                      # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                      # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                      # Infrequently accessed objects may be evicted from the cache before the
+                      # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                      # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                      # mode.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                      # to apply fine-grained caching for common errors or redirects.
+                      # This can reduce the load on your origin and improve end-user
+                      # experience by reducing response latency.
+                      # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                      # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                      # the specified response code that lack any Cache-Control, Expires, or
+                      # Pragma: no-cache directives. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                      # with the specified response code, and overrides any caching headers. By
+                      # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                      #
+                      # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                      # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                      # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                      #
+                      # These defaults can be overridden in `negativeCachingPolicy`.
+                      # If not specified, Cloud CDN applies negative caching by default.
+                  "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                      # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                      # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                      # CDN's default cache TTLs. Note that when specifying an explicit
+                      # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                      # all response codes that you wish to cache. Cloud CDN will not apply any
+                      # default negative caching when a policy exists.
+                    { # Specify CDN TTLs for response error codes.
+                      "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                          # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                          # specified as values, and you cannot specify a status code more than
+                          # once.
+                      "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                          # corresponding status code.
+                          # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                          # objects may be evicted from the cache before the defined TTL.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                  ],
+                  "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                      # requests into a small number of requests to the origin. If not specified,
+                      # Cloud CDN applies request coalescing by default.
+                  "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                      # content with the origin, or when an error is encountered when refreshing
+                      # the cache.
+                      # This setting defines the default "max-stale" duration for any cached
+                      # responses that do not specify a max-stale directive. Stale responses that
+                      # exceed the TTL configured here will not be served. The default limit
+                      # (max-stale) is 86400s (1 day), which will allow stale content to be
+                      # served up to this limit beyond the max-age (or s-maxage) of a cached
+                      # response.
+                      # The maximum allowed value is 604800 (1 week).
+                      # Set this to zero (0) to disable serve-while-stale.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+                "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                  "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                      # indicates that
+                      # the actual request can include user credentials. This field translates to
+                      # the Access-Control-Allow-Credentials header.
+                      #
+                      # Default is false.
+                  "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                      # header.
+                    "A String",
+                  ],
+                  "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                      # more information, see regular expression syntax.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED.
+                    "A String",
+                  ],
+                  "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    "A String",
+                  ],
+                  "disabled": True or False, # If true, disables the CORS policy.
+                      # The default value is false, which indicates that the CORS
+                      # policy is in effect.
+                  "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                      # seconds. This field translates to the Access-Control-Max-Age
+                      # header.
+                },
+                "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by a load balancer on a percentage of requests before sending
+                    # those requests to the backend service. Similarly requests from clients can
+                    # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                    # that are configured with a fault_injection_policy if:
+                    # 1. The traffic is generated by fault injection AND
+                    # 2. The fault injection is not a delay fault injection.
+                    # Fault injection is not supported with the classic Application Load Balancer
+                    # . To see which load balancers support fault injection,
+                    # see Load
+                    # balancing: Routing and traffic management features.
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by the load balancer on a percentage of requests before sending
+                    # those request to the backend service. Similarly requests from clients can be
+                    # aborted by the load balancer for a percentage of requests.
+                  "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                      # injection.
+                    "httpStatus": 42, # The HTTP status code used to abort the request.
+                        #
+                        # The value must be from 200 to 599 inclusive.
+                        #
+                        # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                        # according to this
+                        # mapping table. HTTP status 200 is mapped to gRPC status
+                        # UNKNOWN. Injecting an OK status is currently not supported by
+                        # Traffic Director.
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                        # that is aborted as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                  "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                      # injection, before being sent to a backend service.
+                      # request to the backend service as part of fault injection.
+                    "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                        # which a delay is introduced as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                },
+                "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                    # Unlike the timeout field where the timeout duration starts
+                    # from the time the request has been fully processed (known as*end-of-stream*),
+                    # the duration in this field is computed from the beginning of the stream
+                    # until the response has been processed, including all retries. A
+                    # stream that does not complete in this duration is closed.
+                    #
+                    # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                    # with the route.
+                    #
+                    # This field is only allowed if the Url map is used with backend services
+                    # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                    # are shadowed to a separate mirrored backend service. The load balancer does
+                    # not wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host / authority header is suffixed with-shadow.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # are shadowed to a separate mirrored backend service. The load balancer
+                    # doesn't wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host or authority header is suffixed with-shadow.
+                  "backendService": "A String", # The full or partial URL to the BackendService resource being
+                      # mirrored to.
+                      #
+                      # The backend service configured for a mirroring
+                      # policy must reference backends that are of the same type as the original
+                      # backend service matched in the URL map.
+                      #
+                      # Serverless NEG backends are not currently supported as a mirrored
+                      # backend service.
+                  "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                },
+                "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                  "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                      # If not specified, defaults to 1.
+                  "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                      #
+                      # If not specified, will use the timeout set in theHttpRouteAction field.
+                      # If timeout in the HttpRouteAction field is not set, this field
+                      # uses the largest timeout
+                      # among all backend services associated with the route.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has the validateForProxyless field set to true.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                      # values are:
+                      #
+                      #    - 5xx: retry is attempted if the instance or endpoint
+                      #    responds with any 5xx response code, or if the instance or
+                      #    endpoint does not respond at all. For example, disconnects, reset, read
+                      #    timeout, connection failure, and refused streams.
+                      #    - gateway-error: Similar to 5xx, but only
+                      #    applies to response codes 502, 503 or504.
+                      #    - connect-failure: a retry is attempted on failures
+                      #    connecting to the instance or endpoint. For example, connection
+                      #    timeouts.
+                      #    - retriable-4xx: a retry is attempted if the instance
+                      #    or endpoint responds with a 4xx response code.
+                      #    The only error that you can retry is error code 409.
+                      #    - refused-stream: a retry is attempted if the instance
+                      #    or endpoint resets the stream with a REFUSED_STREAM error
+                      #    code. This reset type indicates that it is safe to retry.
+                      #    - cancelled: a retry is attempted if the gRPC status
+                      #    code in the response header is set to cancelled.
+                      #    - deadline-exceeded: a retry is attempted if the gRPC
+                      #    status code in the response header is set todeadline-exceeded.
+                      #    - internal: a retry is attempted if the gRPC
+                      #    status code in the response header is set tointernal.
+                      #    - resource-exhausted: a retry is attempted if the gRPC
+                      #    status code in the response header is set toresource-exhausted.
+                      #    - unavailable: a retry is attempted if the gRPC
+                      #    status code in the response header is set tounavailable.
+                      #
+                      # Only the following codes are supported when the URL map is bound to
+                      # target gRPC proxy that has validateForProxyless field set to true.
+                      #
+                      #    - cancelled
+                      #    - deadline-exceeded
+                      #    - internal
+                      #    - resource-exhausted
+                      #    - unavailable
+                    "A String",
+                  ],
+                },
+                "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                    # time the request has been fully processed (known as *end-of-stream*)
+                    # up until the response has been processed. Timeout includes
+                    # all retries.
+                    #
+                    # If not specified, this field uses the largest timeout among all backend
+                    # services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                    # to the matched service.
+                    #
+                    #  urlRewrite is the only action supported in UrlMaps
+                    # for classic Application Load Balancers.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # backend service.
+                  "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                      # host header is replaced with contents of hostRewrite.
+                      #
+                      # The value must be from 1 to 255 characters.
+                  "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                      # matching portion of the request's path is replaced bypathPrefixRewrite.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                  "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                      # header) using the HTTP template syntax.
+                      #
+                      # A corresponding
+                      # path_template_match must be specified. Any template variables must exist in
+                      # the path_template_match field.
+                      #
+                      #
+                      #       - -At least one variable must be specified in the path_template_match
+                      #       field
+                      #    - You can omit variables from the rewritten URL
+                      #       - The * and ** operators cannot be matched
+                      #       unless they have a corresponding variable name - e.g.
+                      #       {format=*} or {var=**}.
+                      #
+                      # For example, a path_template_match of /static/{format=**}
+                      # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                      # rewrite, so that /{country}/{format}/{suffix=**} can be
+                      # rewritten as /content/{format}/{country}/{suffix}.
+                      #
+                      # At least
+                      # one non-empty routeRules[].matchRules[].path_template_match is
+                      # required.
+                      #
+                      # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                  "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                    "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                        # It uses RE2 syntax with the following constraints:
+                        #
+                        #
+                        #      - Any single character operators
+                        #      - Groups are allowed to have only submatch operator inside
+                        #      - Groups are allowed only without any char repetition, e.g.
+                        #      .*
+                        #      - Any char repetition, e.g. .*, is
+                        #      only allowed to be used in a single regex together with:
+                        #
+                        #
+                        #             - Empty string operators
+                        #             - Other repetitions
+                        #             - Ranges
+                        #             - Repetitions of ranges
+                        #
+                        #
+                        #      - Ranges are only allowed to have:
+                        #
+                        #
+                        #             - Character range
+                        #             - Digits range
+                        #             - Symbols listed in characters allowed for ranges
+                    "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                        # the path.
+                  },
+                },
+                "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                    # occurs. The weights determine the fraction of traffic that flows to
+                    # their corresponding backend service. If all traffic needs to
+                    # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                    #
+                    # After a backend service is identified and before forwarding
+                    # the request to
+                    # the backend service, advanced routing actions such as URL rewrites and
+                    # header transformations are applied depending on additional settings
+                    # specified in this HttpRouteAction.
+                  { # In contrast to a single BackendService in
+                      # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                      # multiple backend services. The volume of traffic for each
+                      # backend service is proportional to the weight specified
+                      # in each WeightedBackendService
+                    "backendService": "A String", # The full or partial URL to the default BackendService
+                        # resource. Before
+                        # forwarding the request to backendService, the load balancer
+                        # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                        # effect for the selected backendService.
+                        #
+                        # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                        #
+                        # headerAction is not supported for load balancers that have
+                        # their loadBalancingScheme set to EXTERNAL.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # the request is passed along to the selected backendService.
+                      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # request before forwarding the request to the backendService.
+                        "A String",
+                      ],
+                      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                          # client.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # response before sending the response back to the client.
+                        "A String",
+                      ],
+                    },
+                    "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                        # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                        #
+                        # The selection of a backend service is determined only for new traffic.
+                        # Once a user's request has been directed to a backend service,
+                        # subsequent requests are sent to the same backend service as
+                        # determined by the backend service's session affinity policy.
+                        # Don't configure session affinity if you're using weighted traffic
+                        # splitting. If you do, the weighted traffic splitting configuration takes
+                        # precedence.
+                        #
+                        # The value must be from 0 to 1000.
+                  },
+                ],
+              },
+              "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                  # is directed if this rule is matched. If routeAction is
+                  # also specified, advanced routing actions, such as URL rewrites,
+                  # take effect before sending the request to the backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+                  # specified by urlRedirect.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                    # was supplied in the request.
+                    #
+                    # The value must be from 1 to 255
+                    # characters.
+                "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                    # set to HTTPS.
+                    # If set to false, the URL scheme of the redirected request
+                    # remains the same as that of the request.
+                    #
+                    # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                    #
+                    # The default is set to false.
+                "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                    # that was supplied in the request.
+                    #
+                    # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                    # the HttpRouteRuleMatch, retaining the remaining portion
+                    # of the URL before redirecting the request.
+                    #
+                    # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                    #
+                    # Supported values are:
+                    #
+                    #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                    #    to 301.
+                    #    - FOUND, which corresponds to 302.
+                    #    - SEE_OTHER which corresponds to 303.
+                    #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                    #    method is retained.
+                    #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                    #    method is retained.
+                "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                    # URL is
+                    # removed before redirecting the request. If set to false, the
+                    # query portion of the original URL is retained.
+                    #
+                    # The default is set to false.
+              },
+            },
+          ],
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+          # This field is not applicable to global URL maps.
+          # 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.
+      "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+          # maximum of 100 tests per UrlMap.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+        { # Message for the expected URL mappings.
+          "description": "A String", # Description of this test case.
+          "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+              # containing the scheme, host, path and query parameters.
+              #
+              # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+              # the load balancer to backends. For rules with urlRewrite,
+              # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+              #
+              # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+              # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+              # If urlRedirect specifies strip_query, the test
+              # passes only if expectedOutputUrl does not contain any query
+              # parameters.
+              #
+              # expectedOutputUrl is optional whenservice is specified.
+          "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+              # load balancer's redirect response.
+              #
+              # expectedRedirectResponseCode cannot be set whenservice is set.
+          "headers": [ # HTTP headers for this request. If headers contains
+              # a host header, then host must also match the header value.
+            { # HTTP headers used in UrlMapTests.
+              "name": "A String", # Header name.
+              "value": "A String", # Header value.
+            },
+          ],
+          "host": "A String", # Host portion of the URL. If headers contains a host header,
+              # then host must also match the header value.
+          "path": "A String", # Path portion of the URL.
+          "service": "A String", # Expected BackendService or BackendBucket resource
+              # the given URL should be mapped to.
+              #
+              # The service field cannot
+              # be set if expectedRedirectResponseCode is set.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#urlMapList", # 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.
+  "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, urlMap, body=None, requestId=None, x__xgafv=None) + 
Patches the specified UrlMap 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 scoping this request. (required)
+  urlMap: string, Name of the UrlMap resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  requestId: string, begin_interface: MixerMutationRequestBuilder
+Request ID to support idempotency.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ update(project, region, urlMap, body=None, requestId=None, x__xgafv=None) + 
Updates the specified UrlMap resource with the data included in the
+request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  urlMap: string, Name of the UrlMap resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  requestId: string, begin_interface: MixerMutationRequestBuilder
+Request ID to support idempotency.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ validate(project, region, urlMap, body=None, x__xgafv=None) + 
Runs static validation for the UrlMap. In particular, the tests of the
+provided UrlMap will be run. Calling this method does NOT create the
+UrlMap.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  urlMap: string, Name of the UrlMap resource to be validated as. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "resource": { # Represents a URL Map resource. # Content of the UrlMap to be validated.
+      #
+      # Compute Engine has two URL Map resources:
+      #
+      # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+      # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+      #
+      # A URL map resource is a component of certain types of cloud load balancers
+      # and Traffic Director:
+      #
+      # * urlMaps are used by global external Application Load
+      # Balancers, classic Application Load Balancers, and cross-region internal
+      # Application Load Balancers.
+      # * regionUrlMaps are used by internal Application Load Balancers,
+      # regional external Application Load Balancers and regional internal
+      # Application Load Balancers.
+      #
+      # For a list of supported URL map features by the load balancer type, see the
+      # Load balancing features: Routing and traffic management table.
+      #
+      # For a list of supported URL map features for Traffic Director, see the
+      # Traffic Director features: Routing and traffic management table.
+      #
+      # This resource defines mappings from hostnames and URL paths to either a
+      # backend service or a backend bucket.
+      #
+      # To use the global urlMaps resource, the backend service must
+      # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+      # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+      # information, read URL
+      # Map Concepts.
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+        # text format.
+    "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+        # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+        #
+        # This policy takes
+        # effect at the load balancer level and applies only when no policy has been
+        # defined for the error code at lower levels like PathMatcher, RouteRule and
+        # PathRule within this UrlMap.
+        #
+        # For example, consider a UrlMap with the
+        # following configuration:
+        #
+        #
+        #      - defaultCustomErrorResponsePolicy containing policies for
+        #      responding to 5xx and 4xx errors
+        #      - A PathMatcher configured for *.example.com has
+        #      defaultCustomErrorResponsePolicy for 4xx.
+        #
+        # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+        # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+        # a request that does not match any host in *.example.com such
+        # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+        # takes effect.
+        #
+        # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+        # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+        # a retry, if load balancer is successful in reaching the
+        # service, the defaultCustomErrorResponsePolicy is ignored and
+        # the response from the service is returned to the client.
+        #
+        # defaultCustomErrorResponsePolicy is supported only for
+        # global external Application Load Balancers.
+        # backend service or backend bucket responds with an error.
+      "errorResponseRules": [ # Specifies rules for returning error responses.
+          #
+          # In a given policy, if you specify rules for both a range of error codes
+          # as well as rules for specific error codes then rules with specific error
+          # codes have a higher priority. For example, assume that you configure a rule
+          # for 401 (Un-authorized) code, and another for all 4 series
+          # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+          # However if the backend service returns a 403, the rule for4xx takes effect.
+        { # Specifies the mapping between the response code that will be returned along
+            # with the custom error content and the response code returned by the backend
+            # service.
+          "matchResponseCodes": [ # Valid values include:
+              #
+              #
+              #      - A number between 400 and 599: For example
+              #      401 or 503, in which case the load balancer
+              #      applies the policy if the error code exactly matches this value.
+              #      - 5xx: Load Balancer will apply the policy if the
+              #      backend service responds with any response code in the range of
+              #      500 to 599.
+              #    - 4xx: Load
+              #      Balancer will apply the policy if the backend service responds with any
+              #      response code in the range of 400 to
+              #      499.
+              #
+              # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+            "A String",
+          ],
+          "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+              # error content. If overrideResponseCode is not supplied, the
+              # same response code returned by the original backend bucket or backend
+              # service is returned to the client.
+          "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+              #
+              # path must start
+              # with a leading slash. path cannot have trailing slashes.
+              #
+              # If the file is not available in backendBucket  or the
+              # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+              #
+              # The value must
+              # be from 1 to 1024 characters
+        },
+      ],
+      "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+          # contains the custom error content. Examples are:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+          #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+          #      - global/backendBuckets/myBackendBucket
+          #
+          # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+          # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+          #
+          # If load balancer cannot reach
+          # the backendBucket, a simple Not Found Error will
+          # be returned, with the original response code (oroverrideResponseCode if configured).
+          #
+          # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+    },
+    "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+        # hostRules match. The load balancer performs advanced routing
+        # actions, such as URL rewrites and header transformations, before forwarding
+        # the request to the selected backend.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        #  URL maps for classic Application Load Balancers only support
+        # the urlRewrite action within defaultRouteAction.
+        #
+        #
+        # defaultRouteAction has no effect when the URL map is bound
+        # to a target gRPC proxy that has the validateForProxyless field
+        # set to true.
+      "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+          # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+          # property must be specified. This policy cannot be specified if any target
+          # backend has Identity-Aware Proxy enabled.
+        "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+            # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+            # header names can be specified. The cache is bypassed for all `cacheMode`
+            # values.
+          "A String",
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+            # on the backend type: for Backend Services, the complete request URI is
+            # used; for Backend Buckets, the request URI is used without the protocol or
+            # host, and only query parameters known to Cloud Storage are included.
+            # Policy defined on Route Action.
+          "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify `excludedQueryParameters`
+              # or `includedQueryParameters`, not both. '&' and '=' will be percent
+              # encoded and not treated as delimiters.
+              #
+              # Note: This field applies to routes that use backend services. Attempting
+              # to set it on a route that points exclusively to Backend Buckets will
+              # result in a configuration error. For routes that point to a Backend
+              # Bucket, use `includedQueryParameters` to define which parameters should
+              # be part of the cache key.
+            "A String",
+          ],
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket, as the
+              # host is never included in a Backend Bucket's cache key. Attempting to set
+              # it on a route that points exclusively to Backend Buckets will result in a
+              # configuration error.
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket, as the
+              # protocol is never included in a Backend Bucket's cache key. Attempting to
+              # set on a route that points exclusively to Backend Buckets will result in
+              # a configuration error.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # `includedQueryParameters` and `excludedQueryParameters`. If neither
+              # is set, the entire query string will be included. If false, the query
+              # string will be excluded from the cache key entirely.
+              #
+              # Note: This field applies to routes that use backend services. Attempting
+              # to set it on a route that points exclusively to Backend Buckets will
+              # result in a configuration error. For routes that point to a Backend
+              # Bucket, use `includedQueryParameters` to define which parameters should
+              # be part of the cache key.
+          "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket.
+              # Attempting to set it on a route that points exclusively to Backend
+              # Buckets will result in a configuration error. Up to 5 cookie names can be
+              # specified.
+            "A String",
+          ],
+          "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify `includedQueryParameters`
+              # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+              # encoded and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+            # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+        "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+            # content. This is used to clamp the max-age (or Expires) value sent to the
+            # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+            # is used for the response max-age directive, along with a "public"
+            # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+            # clamps the max-age from the origin (if specified), or else sets the
+            # response max-age directive to the lesser of the `clientTtl` and
+            # `defaultTtl`, and also ensures a "public" cache-control directive is
+            # present. The maximum allowed value is 31,622,400s (1 year). If not
+            # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+            # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+            # `USE_ORIGIN_HEADERS`.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+            # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+            # "always revalidate". The value of `defaultTtl` cannot be set to a value
+            # greater than that of `maxTtl`. When the `cacheMode` is set to
+            # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+            # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+            # accessed objects may be evicted from the cache before the defined TTL. If
+            # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+            # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+            # `USE_ORIGIN_HEADERS`.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+            # attempt to set a max-age or s-maxage higher than this, or an Expires header
+            # more than `maxTtl` seconds in the future will be capped at the value of
+            # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified. Setting a TTL of "0" means
+            # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+            # Infrequently accessed objects may be evicted from the cache before the
+            # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+            # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+            # mode.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+            # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+            # the specified response code that lack any Cache-Control, Expires, or
+            # Pragma: no-cache directives. When the `cacheMode` is set to
+            # `FORCE_CACHE_ALL`, negative caching applies to all responses
+            # with the specified response code, and overrides any caching headers. By
+            # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+            #
+            # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+            # * 405 (Method Not Found), 501 (Not Implemented): 60s
+            #
+            # These defaults can be overridden in `negativeCachingPolicy`.
+            # If not specified, Cloud CDN applies negative caching by default.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+            # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+            # CDN's default cache TTLs. Note that when specifying an explicit
+            # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+            # all response codes that you wish to cache. Cloud CDN will not apply any
+            # default negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                # objects may be evicted from the cache before the defined TTL.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin. If not specified,
+            # Cloud CDN applies request coalescing by default.
+        "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+          # information about the W3C recommendation for cross-origin resource sharing
+          # (CORS), see Fetch API Living
+          # Standard.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+          # information about the W3C recommendation for cross-origin resource sharing
+          # (CORS), see Fetch API Living
+          # Standard.
+        "allowCredentials": True or False, # In response to a preflight request, setting this to true
+            # indicates that
+            # the actual request can include user credentials. This field translates to
+            # the Access-Control-Allow-Credentials header.
+            #
+            # Default is false.
+        "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+            # header.
+          "A String",
+        ],
+        "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+            # header.
+          "A String",
+        ],
+        "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+            # more information, see regular expression syntax.
+            #
+            # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            #
+            # Regular expressions can only be used when the loadBalancingScheme is
+            # set to INTERNAL_SELF_MANAGED.
+          "A String",
+        ],
+        "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+            #
+            # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          "A String",
+        ],
+        "disabled": True or False, # If true, disables the CORS policy.
+            # The default value is false, which indicates that the CORS
+            # policy is in effect.
+        "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+            # header.
+          "A String",
+        ],
+        "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+            # seconds. This field translates to the Access-Control-Max-Age
+            # header.
+      },
+      "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+          # the resiliency of clients to backend service failure. As part of fault
+          # injection, when clients send requests to a backend service, delays can be
+          # introduced by a load balancer on a percentage of requests before sending
+          # those requests to the backend service. Similarly requests from clients can
+          # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+          # that are configured with a fault_injection_policy if:
+          # 1. The traffic is generated by fault injection AND
+          # 2. The fault injection is not a delay fault injection.
+          # Fault injection is not supported with the classic Application Load Balancer
+          # . To see which load balancers support fault injection,
+          # see Load
+          # balancing: Routing and traffic management features.
+          # the resiliency of clients to backend service failure. As part of fault
+          # injection, when clients send requests to a backend service, delays can be
+          # introduced by the load balancer on a percentage of requests before sending
+          # those request to the backend service. Similarly requests from clients can be
+          # aborted by the load balancer for a percentage of requests.
+        "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+            # injection.
+          "httpStatus": 42, # The HTTP status code used to abort the request.
+              #
+              # The value must be from 200 to 599 inclusive.
+              #
+              # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+              # according to this
+              # mapping table. HTTP status 200 is mapped to gRPC status
+              # UNKNOWN. Injecting an OK status is currently not supported by
+              # Traffic Director.
+          "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+              # that is aborted as part of fault injection.
+              #
+              # The value must be from 0.0 to 100.0 inclusive.
+        },
+        "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+            # injection, before being sent to a backend service.
+            # request to the backend service as part of fault injection.
+          "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+              # which a delay is introduced as part of fault injection.
+              #
+              # The value must be from 0.0 to 100.0 inclusive.
+        },
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+          # Unlike the timeout field where the timeout duration starts
+          # from the time the request has been fully processed (known as*end-of-stream*),
+          # the duration in this field is computed from the beginning of the stream
+          # until the response has been processed, including all retries. A
+          # stream that does not complete in this duration is closed.
+          #
+          # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+          # with the route.
+          #
+          # This field is only allowed if the Url map is used with backend services
+          # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+          # are shadowed to a separate mirrored backend service. The load balancer does
+          # not wait for responses from the shadow service. Before sending traffic
+          # to the shadow service, the host / authority header is suffixed with-shadow.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # are shadowed to a separate mirrored backend service. The load balancer
+          # doesn't wait for responses from the shadow service. Before sending traffic
+          # to the shadow service, the host or authority header is suffixed with-shadow.
+        "backendService": "A String", # The full or partial URL to the BackendService resource being
+            # mirrored to.
+            #
+            # The backend service configured for a mirroring
+            # policy must reference backends that are of the same type as the original
+            # backend service matched in the URL map.
+            #
+            # Serverless NEG backends are not currently supported as a mirrored
+            # backend service.
+        "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+      },
+      "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+        "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+            # If not specified, defaults to 1.
+        "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+            #
+            # If not specified, will use the timeout set in theHttpRouteAction field.
+            # If timeout in the HttpRouteAction field is not set, this field
+            # uses the largest timeout
+            # among all backend services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+            # values are:
+            #
+            #    - 5xx: retry is attempted if the instance or endpoint
+            #    responds with any 5xx response code, or if the instance or
+            #    endpoint does not respond at all. For example, disconnects, reset, read
+            #    timeout, connection failure, and refused streams.
+            #    - gateway-error: Similar to 5xx, but only
+            #    applies to response codes 502, 503 or504.
+            #    - connect-failure: a retry is attempted on failures
+            #    connecting to the instance or endpoint. For example, connection
+            #    timeouts.
+            #    - retriable-4xx: a retry is attempted if the instance
+            #    or endpoint responds with a 4xx response code.
+            #    The only error that you can retry is error code 409.
+            #    - refused-stream: a retry is attempted if the instance
+            #    or endpoint resets the stream with a REFUSED_STREAM error
+            #    code. This reset type indicates that it is safe to retry.
+            #    - cancelled: a retry is attempted if the gRPC status
+            #    code in the response header is set to cancelled.
+            #    - deadline-exceeded: a retry is attempted if the gRPC
+            #    status code in the response header is set todeadline-exceeded.
+            #    - internal: a retry is attempted if the gRPC
+            #    status code in the response header is set tointernal.
+            #    - resource-exhausted: a retry is attempted if the gRPC
+            #    status code in the response header is set toresource-exhausted.
+            #    - unavailable: a retry is attempted if the gRPC
+            #    status code in the response header is set tounavailable.
+            #
+            # Only the following codes are supported when the URL map is bound to
+            # target gRPC proxy that has validateForProxyless field set to true.
+            #
+            #    - cancelled
+            #    - deadline-exceeded
+            #    - internal
+            #    - resource-exhausted
+            #    - unavailable
+          "A String",
+        ],
+      },
+      "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+          # time the request has been fully processed (known as *end-of-stream*)
+          # up until the response has been processed. Timeout includes
+          # all retries.
+          #
+          # If not specified, this field uses the largest timeout among all backend
+          # services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+          # to the matched service.
+          #
+          #  urlRewrite is the only action supported in UrlMaps
+          # for classic Application Load Balancers.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # backend service.
+        "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+            # host header is replaced with contents of hostRewrite.
+            #
+            # The value must be from 1 to 255 characters.
+        "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+            # matching portion of the request's path is replaced bypathPrefixRewrite.
+            #
+            # The value must be from 1 to 1024 characters.
+        "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+            # header) using the HTTP template syntax.
+            #
+            # A corresponding
+            # path_template_match must be specified. Any template variables must exist in
+            # the path_template_match field.
+            #
+            #
+            #       - -At least one variable must be specified in the path_template_match
+            #       field
+            #    - You can omit variables from the rewritten URL
+            #       - The * and ** operators cannot be matched
+            #       unless they have a corresponding variable name - e.g.
+            #       {format=*} or {var=**}.
+            #
+            # For example, a path_template_match of /static/{format=**}
+            # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+            # rewrite, so that /{country}/{format}/{suffix=**} can be
+            # rewritten as /content/{format}/{country}/{suffix}.
+            #
+            # At least
+            # one non-empty routeRules[].matchRules[].path_template_match is
+            # required.
+            #
+            # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+        "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+          "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+              # It uses RE2 syntax with the following constraints:
+              #
+              #
+              #      - Any single character operators
+              #      - Groups are allowed to have only submatch operator inside
+              #      - Groups are allowed only without any char repetition, e.g.
+              #      .*
+              #      - Any char repetition, e.g. .*, is
+              #      only allowed to be used in a single regex together with:
+              #
+              #
+              #             - Empty string operators
+              #             - Other repetitions
+              #             - Ranges
+              #             - Repetitions of ranges
+              #
+              #
+              #      - Ranges are only allowed to have:
+              #
+              #
+              #             - Character range
+              #             - Digits range
+              #             - Symbols listed in characters allowed for ranges
+          "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+              # the path.
+        },
+      },
+      "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+          # occurs. The weights determine the fraction of traffic that flows to
+          # their corresponding backend service. If all traffic needs to
+          # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+          #
+          # After a backend service is identified and before forwarding
+          # the request to
+          # the backend service, advanced routing actions such as URL rewrites and
+          # header transformations are applied depending on additional settings
+          # specified in this HttpRouteAction.
+        { # In contrast to a single BackendService in
+            # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+            # multiple backend services. The volume of traffic for each
+            # backend service is proportional to the weight specified
+            # in each WeightedBackendService
+          "backendService": "A String", # The full or partial URL to the default BackendService
+              # resource. Before
+              # forwarding the request to backendService, the load balancer
+              # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+              # effect for the selected backendService.
+              #
+              # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+              #
+              # headerAction is not supported for load balancers that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+              # computed asweight / (sum of all weightedBackendService weights in routeAction).
+              #
+              # The selection of a backend service is determined only for new traffic.
+              # Once a user's request has been directed to a backend service,
+              # subsequent requests are sent to the same backend service as
+              # determined by the backend service's session affinity policy.
+              # Don't configure session affinity if you're using weighted traffic
+              # splitting. If you do, the weighted traffic splitting configuration takes
+              # precedence.
+              #
+              # The value must be from 0 to 1000.
+        },
+      ],
+    },
+    "defaultService": "A String", # The full or partial URL of the defaultService resource to
+        # which traffic is directed if none of the hostRules match.
+        # If defaultRouteAction is also specified, advanced
+        # routing actions, such as URL rewrites, take effect before sending the
+        # request to the backend.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        # defaultService has no effect when the URL map is bound
+        # to a target gRPC proxy that has the validateForProxyless field
+        # set to true.
+    "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+        # is redirected to a URL specified by defaultUrlRedirect.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+      "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+          # was supplied in the request.
+          #
+          # The value must be from 1 to 255
+          # characters.
+      "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+          # set to HTTPS.
+          # If set to false, the URL scheme of the redirected request
+          # remains the same as that of the request.
+          #
+          # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+          #
+          # The default is set to false.
+      "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+          # that was supplied in the request.
+          #
+          # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+          # supplied, the path of the original request is used for the redirect.
+          #
+          # The value must be from 1 to 1024 characters.
+      "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+          # the HttpRouteRuleMatch, retaining the remaining portion
+          # of the URL before redirecting the request.
+          #
+          # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+          # supplied, the path of the original request is used for the redirect.
+          #
+          # The value must be from 1 to 1024 characters.
+      "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+          #
+          # Supported values are:
+          #
+          #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+          #    to 301.
+          #    - FOUND, which corresponds to 302.
+          #    - SEE_OTHER which corresponds to 303.
+          #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+          #    method is retained.
+          #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+          #    method is retained.
+      "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+          # URL is
+          # removed before redirecting the request. If set to false, the
+          # query portion of the original URL is retained.
+          #
+          # The default is set to false.
+    },
+    "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 is ignored when
+        # inserting a UrlMap. An up-to-date fingerprint must be provided
+        # in order to update the UrlMap, otherwise the request will
+        # fail with error 412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve a UrlMap.
+    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+        # for the selected backendService.
+        #
+        # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+        #
+        # headerAction is not supported for load balancers
+        # that have
+        # their loadBalancingScheme set to EXTERNAL.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # the request is passed along to the selected backendService.
+      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+        { # Specification determining how headers are added to requests or responses.
+          "headerName": "A String", # The name of the header.
+          "headerValue": "A String", # The value of the header to add.
+          "replace": True or False, # If false, headerValue is appended to any values
+              # that already
+              # exist for the header. If true, headerValue is set for the
+              # header, discarding any values that were set for that header.
+              #
+              # The default value is true,
+              # unless a variable is present in headerValue,
+              # in which case the default value is false.
+              # .
+        },
+      ],
+      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+          # request before forwarding the request to the backendService.
+        "A String",
+      ],
+      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+          # client.
+        { # Specification determining how headers are added to requests or responses.
+          "headerName": "A String", # The name of the header.
+          "headerValue": "A String", # The value of the header to add.
+          "replace": True or False, # If false, headerValue is appended to any values
+              # that already
+              # exist for the header. If true, headerValue is set for the
+              # header, discarding any values that were set for that header.
+              #
+              # The default value is true,
+              # unless a variable is present in headerValue,
+              # in which case the default value is false.
+              # .
+        },
+      ],
+      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+          # response before sending the response back to the client.
+        "A String",
+      ],
+    },
+    "hostRules": [ # The list of host rules to use against the URL.
+      { # UrlMaps
+          # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+            # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+            # that case, * must be the first character, and if followed by
+            # anything, the immediate following character must be either -
+            # or ..
+            #
+            # * based matching is not supported when the URL map is bound
+            # to a target gRPC proxy that has the validateForProxyless field
+            # set to true.
+          "A String",
+        ],
+        "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+            # of the URL if the hostRule matches the URL's host portion.
+      },
+    ],
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+        # url maps.
+    "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.
+    "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+      { # A matcher for the path portion of the URL. The BackendService
+          # from the longest-matched rule will serve the URL. If no rule was matched, the
+          # default service is used.
+        "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+            # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+            #
+            # This policy takes
+            # effect at the PathMatcher level and applies only when no
+            # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+            # in defaultCustomErrorResponsePolicy, then a policy defined for
+            # the error code in UrlMap.defaultCustomErrorResponsePolicy
+            # takes effect.
+            #
+            # For example, consider a UrlMap with the following
+            # configuration:
+            #
+            #
+            #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+            #      with policies for 5xx and 4xx errors
+            #      - A RouteRule for /coming_soon/ is configured for the
+            #      error code 404.
+            #
+            # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+            # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+            # the policy in RouteRule.customErrorResponsePolicy takes
+            # effect. If any of the requests in this example encounter a 500
+            # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+            #
+            # When
+            # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+            # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+            # a retry, if load balancer is successful in reaching the
+            # service, the defaultCustomErrorResponsePolicy is ignored and
+            # the response from the service is returned to the client.
+            #
+            # defaultCustomErrorResponsePolicy is supported only for
+            # global external Application Load Balancers.
+            # backend service or backend bucket responds with an error.
+          "errorResponseRules": [ # Specifies rules for returning error responses.
+              #
+              # In a given policy, if you specify rules for both a range of error codes
+              # as well as rules for specific error codes then rules with specific error
+              # codes have a higher priority. For example, assume that you configure a rule
+              # for 401 (Un-authorized) code, and another for all 4 series
+              # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+              # However if the backend service returns a 403, the rule for4xx takes effect.
+            { # Specifies the mapping between the response code that will be returned along
+                # with the custom error content and the response code returned by the backend
+                # service.
+              "matchResponseCodes": [ # Valid values include:
+                  #
+                  #
+                  #      - A number between 400 and 599: For example
+                  #      401 or 503, in which case the load balancer
+                  #      applies the policy if the error code exactly matches this value.
+                  #      - 5xx: Load Balancer will apply the policy if the
+                  #      backend service responds with any response code in the range of
+                  #      500 to 599.
+                  #    - 4xx: Load
+                  #      Balancer will apply the policy if the backend service responds with any
+                  #      response code in the range of 400 to
+                  #      499.
+                  #
+                  # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                "A String",
+              ],
+              "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                  # error content. If overrideResponseCode is not supplied, the
+                  # same response code returned by the original backend bucket or backend
+                  # service is returned to the client.
+              "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                  #
+                  # path must start
+                  # with a leading slash. path cannot have trailing slashes.
+                  #
+                  # If the file is not available in backendBucket  or the
+                  # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                  #
+                  # The value must
+                  # be from 1 to 1024 characters
+            },
+          ],
+          "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+              # contains the custom error content. Examples are:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+              #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+              #      - global/backendBuckets/myBackendBucket
+              #
+              # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+              # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+              #
+              # If load balancer cannot reach
+              # the backendBucket, a simple Not Found Error will
+              # be returned, with the original response code (oroverrideResponseCode if configured).
+              #
+              # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+        },
+        "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+            # pathRules or routeRules match. The load balancer
+            # performs advanced routing actions, such as URL rewrites and
+            # header transformations, before forwarding the request to the
+            # selected backend.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # URL maps for classic Application Load Balancers only support
+            # the urlRewrite action within a path matcher'sdefaultRouteAction.
+          "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+              # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+              # property must be specified. This policy cannot be specified if any target
+              # backend has Identity-Aware Proxy enabled.
+            "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                # header names can be specified. The cache is bypassed for all `cacheMode`
+                # values.
+              "A String",
+            ],
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                # on the backend type: for Backend Services, the complete request URI is
+                # used; for Backend Buckets, the request URI is used without the protocol or
+                # host, and only query parameters known to Cloud Storage are included.
+                # Policy defined on Route Action.
+              "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                  # parameters will be included. Either specify `excludedQueryParameters`
+                  # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                  # encoded and not treated as delimiters.
+                  #
+                  # Note: This field applies to routes that use backend services. Attempting
+                  # to set it on a route that points exclusively to Backend Buckets will
+                  # result in a configuration error. For routes that point to a Backend
+                  # Bucket, use `includedQueryParameters` to define which parameters should
+                  # be part of the cache key.
+                "A String",
+              ],
+              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket, as the
+                  # host is never included in a Backend Bucket's cache key. Attempting to set
+                  # it on a route that points exclusively to Backend Buckets will result in a
+                  # configuration error.
+              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket, as the
+                  # protocol is never included in a Backend Bucket's cache key. Attempting to
+                  # set on a route that points exclusively to Backend Buckets will result in
+                  # a configuration error.
+              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                  # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                  # is set, the entire query string will be included. If false, the query
+                  # string will be excluded from the cache key entirely.
+                  #
+                  # Note: This field applies to routes that use backend services. Attempting
+                  # to set it on a route that points exclusively to Backend Buckets will
+                  # result in a configuration error. For routes that point to a Backend
+                  # Bucket, use `includedQueryParameters` to define which parameters should
+                  # be part of the cache key.
+              "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                  # The name=value pair will be used in the cache key Cloud CDN generates.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket.
+                  # Attempting to set it on a route that points exclusively to Backend
+                  # Buckets will result in a configuration error. Up to 5 cookie names can be
+                  # specified.
+                "A String",
+              ],
+              "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                "A String",
+              ],
+              "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                  # parameters will be excluded. Either specify `includedQueryParameters`
+                  # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                  # encoded and not treated as delimiters.
+                "A String",
+              ],
+            },
+            "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+            "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                # content. This is used to clamp the max-age (or Expires) value sent to the
+                # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                # is used for the response max-age directive, along with a "public"
+                # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                # clamps the max-age from the origin (if specified), or else sets the
+                # response max-age directive to the lesser of the `clientTtl` and
+                # `defaultTtl`, and also ensures a "public" cache-control directive is
+                # present. The maximum allowed value is 31,622,400s (1 year). If not
+                # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                # `USE_ORIGIN_HEADERS`.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                # greater than that of `maxTtl`. When the `cacheMode` is set to
+                # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                # accessed objects may be evicted from the cache before the defined TTL. If
+                # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                # `USE_ORIGIN_HEADERS`.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                # more than `maxTtl` seconds in the future will be capped at the value of
+                # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                # Infrequently accessed objects may be evicted from the cache before the
+                # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                # mode.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                # to apply fine-grained caching for common errors or redirects.
+                # This can reduce the load on your origin and improve end-user
+                # experience by reducing response latency.
+                # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                # the specified response code that lack any Cache-Control, Expires, or
+                # Pragma: no-cache directives. When the `cacheMode` is set to
+                # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                # with the specified response code, and overrides any caching headers. By
+                # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                #
+                # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                #
+                # These defaults can be overridden in `negativeCachingPolicy`.
+                # If not specified, Cloud CDN applies negative caching by default.
+            "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                # CDN's default cache TTLs. Note that when specifying an explicit
+                # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                # all response codes that you wish to cache. Cloud CDN will not apply any
+                # default negative caching when a policy exists.
+              { # Specify CDN TTLs for response error codes.
+                "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                    # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                    # specified as values, and you cannot specify a status code more than
+                    # once.
+                "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                    # corresponding status code.
+                    # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                    # objects may be evicted from the cache before the defined TTL.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+            ],
+            "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                # requests into a small number of requests to the origin. If not specified,
+                # Cloud CDN applies request coalescing by default.
+            "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                # content with the origin, or when an error is encountered when refreshing
+                # the cache.
+                # This setting defines the default "max-stale" duration for any cached
+                # responses that do not specify a max-stale directive. Stale responses that
+                # exceed the TTL configured here will not be served. The default limit
+                # (max-stale) is 86400s (1 day), which will allow stale content to be
+                # served up to this limit beyond the max-age (or s-maxage) of a cached
+                # response.
+                # The maximum allowed value is 604800 (1 week).
+                # Set this to zero (0) to disable serve-while-stale.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+              # information about the W3C recommendation for cross-origin resource sharing
+              # (CORS), see Fetch API Living
+              # Standard.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+              # information about the W3C recommendation for cross-origin resource sharing
+              # (CORS), see Fetch API Living
+              # Standard.
+            "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                # indicates that
+                # the actual request can include user credentials. This field translates to
+                # the Access-Control-Allow-Credentials header.
+                #
+                # Default is false.
+            "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                # header.
+              "A String",
+            ],
+            "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                # header.
+              "A String",
+            ],
+            "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                # more information, see regular expression syntax.
+                #
+                # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                #
+                # Regular expressions can only be used when the loadBalancingScheme is
+                # set to INTERNAL_SELF_MANAGED.
+              "A String",
+            ],
+            "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                #
+                # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              "A String",
+            ],
+            "disabled": True or False, # If true, disables the CORS policy.
+                # The default value is false, which indicates that the CORS
+                # policy is in effect.
+            "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                # header.
+              "A String",
+            ],
+            "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                # seconds. This field translates to the Access-Control-Max-Age
+                # header.
+          },
+          "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+              # the resiliency of clients to backend service failure. As part of fault
+              # injection, when clients send requests to a backend service, delays can be
+              # introduced by a load balancer on a percentage of requests before sending
+              # those requests to the backend service. Similarly requests from clients can
+              # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+              # that are configured with a fault_injection_policy if:
+              # 1. The traffic is generated by fault injection AND
+              # 2. The fault injection is not a delay fault injection.
+              # Fault injection is not supported with the classic Application Load Balancer
+              # . To see which load balancers support fault injection,
+              # see Load
+              # balancing: Routing and traffic management features.
+              # the resiliency of clients to backend service failure. As part of fault
+              # injection, when clients send requests to a backend service, delays can be
+              # introduced by the load balancer on a percentage of requests before sending
+              # those request to the backend service. Similarly requests from clients can be
+              # aborted by the load balancer for a percentage of requests.
+            "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                # injection.
+              "httpStatus": 42, # The HTTP status code used to abort the request.
+                  #
+                  # The value must be from 200 to 599 inclusive.
+                  #
+                  # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                  # according to this
+                  # mapping table. HTTP status 200 is mapped to gRPC status
+                  # UNKNOWN. Injecting an OK status is currently not supported by
+                  # Traffic Director.
+              "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                  # that is aborted as part of fault injection.
+                  #
+                  # The value must be from 0.0 to 100.0 inclusive.
+            },
+            "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                # injection, before being sent to a backend service.
+                # request to the backend service as part of fault injection.
+              "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                  # which a delay is introduced as part of fault injection.
+                  #
+                  # The value must be from 0.0 to 100.0 inclusive.
+            },
+          },
+          "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+              # Unlike the timeout field where the timeout duration starts
+              # from the time the request has been fully processed (known as*end-of-stream*),
+              # the duration in this field is computed from the beginning of the stream
+              # until the response has been processed, including all retries. A
+              # stream that does not complete in this duration is closed.
+              #
+              # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+              # with the route.
+              #
+              # This field is only allowed if the Url map is used with backend services
+              # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+              # are shadowed to a separate mirrored backend service. The load balancer does
+              # not wait for responses from the shadow service. Before sending traffic
+              # to the shadow service, the host / authority header is suffixed with-shadow.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # are shadowed to a separate mirrored backend service. The load balancer
+              # doesn't wait for responses from the shadow service. Before sending traffic
+              # to the shadow service, the host or authority header is suffixed with-shadow.
+            "backendService": "A String", # The full or partial URL to the BackendService resource being
+                # mirrored to.
+                #
+                # The backend service configured for a mirroring
+                # policy must reference backends that are of the same type as the original
+                # backend service matched in the URL map.
+                #
+                # Serverless NEG backends are not currently supported as a mirrored
+                # backend service.
+            "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+          },
+          "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+            "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                # If not specified, defaults to 1.
+            "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                #
+                # If not specified, will use the timeout set in theHttpRouteAction field.
+                # If timeout in the HttpRouteAction field is not set, this field
+                # uses the largest timeout
+                # among all backend services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                # values are:
+                #
+                #    - 5xx: retry is attempted if the instance or endpoint
+                #    responds with any 5xx response code, or if the instance or
+                #    endpoint does not respond at all. For example, disconnects, reset, read
+                #    timeout, connection failure, and refused streams.
+                #    - gateway-error: Similar to 5xx, but only
+                #    applies to response codes 502, 503 or504.
+                #    - connect-failure: a retry is attempted on failures
+                #    connecting to the instance or endpoint. For example, connection
+                #    timeouts.
+                #    - retriable-4xx: a retry is attempted if the instance
+                #    or endpoint responds with a 4xx response code.
+                #    The only error that you can retry is error code 409.
+                #    - refused-stream: a retry is attempted if the instance
+                #    or endpoint resets the stream with a REFUSED_STREAM error
+                #    code. This reset type indicates that it is safe to retry.
+                #    - cancelled: a retry is attempted if the gRPC status
+                #    code in the response header is set to cancelled.
+                #    - deadline-exceeded: a retry is attempted if the gRPC
+                #    status code in the response header is set todeadline-exceeded.
+                #    - internal: a retry is attempted if the gRPC
+                #    status code in the response header is set tointernal.
+                #    - resource-exhausted: a retry is attempted if the gRPC
+                #    status code in the response header is set toresource-exhausted.
+                #    - unavailable: a retry is attempted if the gRPC
+                #    status code in the response header is set tounavailable.
+                #
+                # Only the following codes are supported when the URL map is bound to
+                # target gRPC proxy that has validateForProxyless field set to true.
+                #
+                #    - cancelled
+                #    - deadline-exceeded
+                #    - internal
+                #    - resource-exhausted
+                #    - unavailable
+              "A String",
+            ],
+          },
+          "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+              # time the request has been fully processed (known as *end-of-stream*)
+              # up until the response has been processed. Timeout includes
+              # all retries.
+              #
+              # If not specified, this field uses the largest timeout among all backend
+              # services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+              # to the matched service.
+              #
+              #  urlRewrite is the only action supported in UrlMaps
+              # for classic Application Load Balancers.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # backend service.
+            "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                # host header is replaced with contents of hostRewrite.
+                #
+                # The value must be from 1 to 255 characters.
+            "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                # matching portion of the request's path is replaced bypathPrefixRewrite.
+                #
+                # The value must be from 1 to 1024 characters.
+            "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                # header) using the HTTP template syntax.
+                #
+                # A corresponding
+                # path_template_match must be specified. Any template variables must exist in
+                # the path_template_match field.
+                #
+                #
+                #       - -At least one variable must be specified in the path_template_match
+                #       field
+                #    - You can omit variables from the rewritten URL
+                #       - The * and ** operators cannot be matched
+                #       unless they have a corresponding variable name - e.g.
+                #       {format=*} or {var=**}.
+                #
+                # For example, a path_template_match of /static/{format=**}
+                # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                # rewrite, so that /{country}/{format}/{suffix=**} can be
+                # rewritten as /content/{format}/{country}/{suffix}.
+                #
+                # At least
+                # one non-empty routeRules[].matchRules[].path_template_match is
+                # required.
+                #
+                # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+            "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+              "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                  # It uses RE2 syntax with the following constraints:
+                  #
+                  #
+                  #      - Any single character operators
+                  #      - Groups are allowed to have only submatch operator inside
+                  #      - Groups are allowed only without any char repetition, e.g.
+                  #      .*
+                  #      - Any char repetition, e.g. .*, is
+                  #      only allowed to be used in a single regex together with:
+                  #
+                  #
+                  #             - Empty string operators
+                  #             - Other repetitions
+                  #             - Ranges
+                  #             - Repetitions of ranges
+                  #
+                  #
+                  #      - Ranges are only allowed to have:
+                  #
+                  #
+                  #             - Character range
+                  #             - Digits range
+                  #             - Symbols listed in characters allowed for ranges
+              "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                  # the path.
+            },
+          },
+          "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+              # occurs. The weights determine the fraction of traffic that flows to
+              # their corresponding backend service. If all traffic needs to
+              # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+              #
+              # After a backend service is identified and before forwarding
+              # the request to
+              # the backend service, advanced routing actions such as URL rewrites and
+              # header transformations are applied depending on additional settings
+              # specified in this HttpRouteAction.
+            { # In contrast to a single BackendService in
+                # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                # multiple backend services. The volume of traffic for each
+                # backend service is proportional to the weight specified
+                # in each WeightedBackendService
+              "backendService": "A String", # The full or partial URL to the default BackendService
+                  # resource. Before
+                  # forwarding the request to backendService, the load balancer
+                  # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+              "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                  # effect for the selected backendService.
+                  #
+                  # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                  #
+                  # headerAction is not supported for load balancers that have
+                  # their loadBalancingScheme set to EXTERNAL.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # the request is passed along to the selected backendService.
+                "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # request before forwarding the request to the backendService.
+                  "A String",
+                ],
+                "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                    # client.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # response before sending the response back to the client.
+                  "A String",
+                ],
+              },
+              "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                  # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                  #
+                  # The selection of a backend service is determined only for new traffic.
+                  # Once a user's request has been directed to a backend service,
+                  # subsequent requests are sent to the same backend service as
+                  # determined by the backend service's session affinity policy.
+                  # Don't configure session affinity if you're using weighted traffic
+                  # splitting. If you do, the weighted traffic splitting configuration takes
+                  # precedence.
+                  #
+                  # The value must be from 0 to 1000.
+            },
+          ],
+        },
+        "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+            # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+            # matched. For example, the
+            # following are all valid URLs to a BackendService resource:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+            #      - compute/v1/projects/project/global/backendServices/backendService
+            #      - global/backendServices/backendService
+            #
+            #
+            # If defaultRouteAction is also specified, advanced
+            # routing actions, such as URL rewrites, take effect before sending the
+            # request to the backend.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # Authorization requires one or more of the following Google IAM permissions on the
+            # specified resource default_service:
+            #
+            #
+            #       - compute.backendBuckets.use
+            #       - compute.backendServices.use
+        "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+            # by defaultUrlRedirect.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+          "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+              # was supplied in the request.
+              #
+              # The value must be from 1 to 255
+              # characters.
+          "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+              # set to HTTPS.
+              # If set to false, the URL scheme of the redirected request
+              # remains the same as that of the request.
+              #
+              # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+              #
+              # The default is set to false.
+          "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+              # that was supplied in the request.
+              #
+              # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+              # supplied, the path of the original request is used for the redirect.
+              #
+              # The value must be from 1 to 1024 characters.
+          "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+              # the HttpRouteRuleMatch, retaining the remaining portion
+              # of the URL before redirecting the request.
+              #
+              # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+              # supplied, the path of the original request is used for the redirect.
+              #
+              # The value must be from 1 to 1024 characters.
+          "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+              #
+              # Supported values are:
+              #
+              #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+              #    to 301.
+              #    - FOUND, which corresponds to 302.
+              #    - SEE_OTHER which corresponds to 303.
+              #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+              #    method is retained.
+              #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+              #    method is retained.
+          "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+              # URL is
+              # removed before redirecting the request. If set to false, the
+              # query portion of the original URL is retained.
+              #
+              # The default is set to false.
+        },
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+            # for the selected backend service.
+            #
+            # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+            #
+            # HeaderAction is not supported for load balancers
+            # that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+        "pathRules": [ # The list of path rules. Use this list instead of routeRules
+            # when routing based on simple path matching is all that's required. A path
+            # rule can only include a wildcard character (*) after a
+            # forward slash character ("/").
+            #
+            # The order by which path rules are specified does not matter.
+            # Matches are always done on the longest-path-first basis.
+            #
+            # For example: a pathRule with a path /a/b/c/* will match
+            # before /a/b/* irrespective of the order in which those paths appear in this
+            # list.
+            #
+            # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+          { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+            "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                #
+                # If a policy for an
+                # error code is not configured for the PathRule, a policy for
+                # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                # effect.
+                #
+                # For example, consider a UrlMap with the following configuration:
+                #
+                #
+                #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                #      with policies for 5xx and 4xx errors
+                #      - A PathRule for /coming_soon/ is configured for the error
+                #      code 404.
+                #
+                # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                # the policy in PathRule.customErrorResponsePolicy takes
+                # effect. If any of the requests in this example encounter a 500
+                # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                #
+                # customErrorResponsePolicy is supported only for
+                # global external Application Load Balancers.
+                # backend service or backend bucket responds with an error.
+              "errorResponseRules": [ # Specifies rules for returning error responses.
+                  #
+                  # In a given policy, if you specify rules for both a range of error codes
+                  # as well as rules for specific error codes then rules with specific error
+                  # codes have a higher priority. For example, assume that you configure a rule
+                  # for 401 (Un-authorized) code, and another for all 4 series
+                  # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                  # However if the backend service returns a 403, the rule for4xx takes effect.
+                { # Specifies the mapping between the response code that will be returned along
+                    # with the custom error content and the response code returned by the backend
+                    # service.
+                  "matchResponseCodes": [ # Valid values include:
+                      #
+                      #
+                      #      - A number between 400 and 599: For example
+                      #      401 or 503, in which case the load balancer
+                      #      applies the policy if the error code exactly matches this value.
+                      #      - 5xx: Load Balancer will apply the policy if the
+                      #      backend service responds with any response code in the range of
+                      #      500 to 599.
+                      #    - 4xx: Load
+                      #      Balancer will apply the policy if the backend service responds with any
+                      #      response code in the range of 400 to
+                      #      499.
+                      #
+                      # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                    "A String",
+                  ],
+                  "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                      # error content. If overrideResponseCode is not supplied, the
+                      # same response code returned by the original backend bucket or backend
+                      # service is returned to the client.
+                  "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                      #
+                      # path must start
+                      # with a leading slash. path cannot have trailing slashes.
+                      #
+                      # If the file is not available in backendBucket  or the
+                      # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                      #
+                      # The value must
+                      # be from 1 to 1024 characters
+                },
+              ],
+              "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                  # contains the custom error content. Examples are:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - global/backendBuckets/myBackendBucket
+                  #
+                  # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                  # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                  #
+                  # If load balancer cannot reach
+                  # the backendBucket, a simple Not Found Error will
+                  # be returned, with the original response code (oroverrideResponseCode if configured).
+                  #
+                  # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+            },
+            "paths": [ # The list of path patterns to match. Each must start with /
+                # and the only place a * is allowed is at the end following
+                # a /.  The string fed to the path matcher does not include
+                # any text after the first ? or #, and
+                # those chars are not allowed here.
+              "A String",
+            ],
+            "routeAction": { # In response to a matching path, the load balancer
+                # performs advanced routing actions, such as URL rewrites and header
+                # transformations, before forwarding the request to the selected
+                # backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # URL maps for classic Application Load Balancers only support
+                # the urlRewrite action within a path rule'srouteAction.
+              "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                  # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                  # property must be specified. This policy cannot be specified if any target
+                  # backend has Identity-Aware Proxy enabled.
+                "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                    # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                    # header names can be specified. The cache is bypassed for all `cacheMode`
+                    # values.
+                  "A String",
+                ],
+                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                    # on the backend type: for Backend Services, the complete request URI is
+                    # used; for Backend Buckets, the request URI is used without the protocol or
+                    # host, and only query parameters known to Cloud Storage are included.
+                    # Policy defined on Route Action.
+                  "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                      # parameters will be included. Either specify `excludedQueryParameters`
+                      # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                    "A String",
+                  ],
+                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # host is never included in a Backend Bucket's cache key. Attempting to set
+                      # it on a route that points exclusively to Backend Buckets will result in a
+                      # configuration error.
+                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # protocol is never included in a Backend Bucket's cache key. Attempting to
+                      # set on a route that points exclusively to Backend Buckets will result in
+                      # a configuration error.
+                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                      # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                      # is set, the entire query string will be included. If false, the query
+                      # string will be excluded from the cache key entirely.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                  "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                      # The name=value pair will be used in the cache key Cloud CDN generates.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket.
+                      # Attempting to set it on a route that points exclusively to Backend
+                      # Buckets will result in a configuration error. Up to 5 cookie names can be
+                      # specified.
+                    "A String",
+                  ],
+                  "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                    "A String",
+                  ],
+                  "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                      # parameters will be excluded. Either specify `includedQueryParameters`
+                      # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                },
+                "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                    # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                    # content. This is used to clamp the max-age (or Expires) value sent to the
+                    # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                    # is used for the response max-age directive, along with a "public"
+                    # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                    # clamps the max-age from the origin (if specified), or else sets the
+                    # response max-age directive to the lesser of the `clientTtl` and
+                    # `defaultTtl`, and also ensures a "public" cache-control directive is
+                    # present. The maximum allowed value is 31,622,400s (1 year). If not
+                    # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                    # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                    # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                    # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                    # greater than that of `maxTtl`. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                    # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                    # accessed objects may be evicted from the cache before the defined TTL. If
+                    # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                    # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                    # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                    # more than `maxTtl` seconds in the future will be capped at the value of
+                    # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                    # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                    # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                    # Infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                    # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                    # mode.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                    # to apply fine-grained caching for common errors or redirects.
+                    # This can reduce the load on your origin and improve end-user
+                    # experience by reducing response latency.
+                    # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                    # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                    # the specified response code that lack any Cache-Control, Expires, or
+                    # Pragma: no-cache directives. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                    # with the specified response code, and overrides any caching headers. By
+                    # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                    #
+                    # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                    # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                    # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                    #
+                    # These defaults can be overridden in `negativeCachingPolicy`.
+                    # If not specified, Cloud CDN applies negative caching by default.
+                "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                    # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                    # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                    # CDN's default cache TTLs. Note that when specifying an explicit
+                    # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                    # all response codes that you wish to cache. Cloud CDN will not apply any
+                    # default negative caching when a policy exists.
+                  { # Specify CDN TTLs for response error codes.
+                    "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                        # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                        # specified as values, and you cannot specify a status code more than
+                        # once.
+                    "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                        # corresponding status code.
+                        # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                        # objects may be evicted from the cache before the defined TTL.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                  },
+                ],
+                "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                    # requests into a small number of requests to the origin. If not specified,
+                    # Cloud CDN applies request coalescing by default.
+                "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                    # content with the origin, or when an error is encountered when refreshing
+                    # the cache.
+                    # This setting defines the default "max-stale" duration for any cached
+                    # responses that do not specify a max-stale directive. Stale responses that
+                    # exceed the TTL configured here will not be served. The default limit
+                    # (max-stale) is 86400s (1 day), which will allow stale content to be
+                    # served up to this limit beyond the max-age (or s-maxage) of a cached
+                    # response.
+                    # The maximum allowed value is 604800 (1 week).
+                    # Set this to zero (0) to disable serve-while-stale.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+              "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                    # indicates that
+                    # the actual request can include user credentials. This field translates to
+                    # the Access-Control-Allow-Credentials header.
+                    #
+                    # Default is false.
+                "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                    # header.
+                  "A String",
+                ],
+                "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                    # header.
+                  "A String",
+                ],
+                "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                    # more information, see regular expression syntax.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED.
+                  "A String",
+                ],
+                "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  "A String",
+                ],
+                "disabled": True or False, # If true, disables the CORS policy.
+                    # The default value is false, which indicates that the CORS
+                    # policy is in effect.
+                "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                    # header.
+                  "A String",
+                ],
+                "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                    # seconds. This field translates to the Access-Control-Max-Age
+                    # header.
+              },
+              "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by a load balancer on a percentage of requests before sending
+                  # those requests to the backend service. Similarly requests from clients can
+                  # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                  # that are configured with a fault_injection_policy if:
+                  # 1. The traffic is generated by fault injection AND
+                  # 2. The fault injection is not a delay fault injection.
+                  # Fault injection is not supported with the classic Application Load Balancer
+                  # . To see which load balancers support fault injection,
+                  # see Load
+                  # balancing: Routing and traffic management features.
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by the load balancer on a percentage of requests before sending
+                  # those request to the backend service. Similarly requests from clients can be
+                  # aborted by the load balancer for a percentage of requests.
+                "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                    # injection.
+                  "httpStatus": 42, # The HTTP status code used to abort the request.
+                      #
+                      # The value must be from 200 to 599 inclusive.
+                      #
+                      # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                      # according to this
+                      # mapping table. HTTP status 200 is mapped to gRPC status
+                      # UNKNOWN. Injecting an OK status is currently not supported by
+                      # Traffic Director.
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                      # that is aborted as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+                "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                    # injection, before being sent to a backend service.
+                    # request to the backend service as part of fault injection.
+                  "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                      # which a delay is introduced as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+              },
+              "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                  # Unlike the timeout field where the timeout duration starts
+                  # from the time the request has been fully processed (known as*end-of-stream*),
+                  # the duration in this field is computed from the beginning of the stream
+                  # until the response has been processed, including all retries. A
+                  # stream that does not complete in this duration is closed.
+                  #
+                  # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                  # with the route.
+                  #
+                  # This field is only allowed if the Url map is used with backend services
+                  # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                  # are shadowed to a separate mirrored backend service. The load balancer does
+                  # not wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host / authority header is suffixed with-shadow.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # are shadowed to a separate mirrored backend service. The load balancer
+                  # doesn't wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host or authority header is suffixed with-shadow.
+                "backendService": "A String", # The full or partial URL to the BackendService resource being
+                    # mirrored to.
+                    #
+                    # The backend service configured for a mirroring
+                    # policy must reference backends that are of the same type as the original
+                    # backend service matched in the URL map.
+                    #
+                    # Serverless NEG backends are not currently supported as a mirrored
+                    # backend service.
+                "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+              },
+              "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                    # If not specified, defaults to 1.
+                "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                    #
+                    # If not specified, will use the timeout set in theHttpRouteAction field.
+                    # If timeout in the HttpRouteAction field is not set, this field
+                    # uses the largest timeout
+                    # among all backend services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                    # values are:
+                    #
+                    #    - 5xx: retry is attempted if the instance or endpoint
+                    #    responds with any 5xx response code, or if the instance or
+                    #    endpoint does not respond at all. For example, disconnects, reset, read
+                    #    timeout, connection failure, and refused streams.
+                    #    - gateway-error: Similar to 5xx, but only
+                    #    applies to response codes 502, 503 or504.
+                    #    - connect-failure: a retry is attempted on failures
+                    #    connecting to the instance or endpoint. For example, connection
+                    #    timeouts.
+                    #    - retriable-4xx: a retry is attempted if the instance
+                    #    or endpoint responds with a 4xx response code.
+                    #    The only error that you can retry is error code 409.
+                    #    - refused-stream: a retry is attempted if the instance
+                    #    or endpoint resets the stream with a REFUSED_STREAM error
+                    #    code. This reset type indicates that it is safe to retry.
+                    #    - cancelled: a retry is attempted if the gRPC status
+                    #    code in the response header is set to cancelled.
+                    #    - deadline-exceeded: a retry is attempted if the gRPC
+                    #    status code in the response header is set todeadline-exceeded.
+                    #    - internal: a retry is attempted if the gRPC
+                    #    status code in the response header is set tointernal.
+                    #    - resource-exhausted: a retry is attempted if the gRPC
+                    #    status code in the response header is set toresource-exhausted.
+                    #    - unavailable: a retry is attempted if the gRPC
+                    #    status code in the response header is set tounavailable.
+                    #
+                    # Only the following codes are supported when the URL map is bound to
+                    # target gRPC proxy that has validateForProxyless field set to true.
+                    #
+                    #    - cancelled
+                    #    - deadline-exceeded
+                    #    - internal
+                    #    - resource-exhausted
+                    #    - unavailable
+                  "A String",
+                ],
+              },
+              "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                  # time the request has been fully processed (known as *end-of-stream*)
+                  # up until the response has been processed. Timeout includes
+                  # all retries.
+                  #
+                  # If not specified, this field uses the largest timeout among all backend
+                  # services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                  # to the matched service.
+                  #
+                  #  urlRewrite is the only action supported in UrlMaps
+                  # for classic Application Load Balancers.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # backend service.
+                "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                    # host header is replaced with contents of hostRewrite.
+                    #
+                    # The value must be from 1 to 255 characters.
+                "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                    # matching portion of the request's path is replaced bypathPrefixRewrite.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                    # header) using the HTTP template syntax.
+                    #
+                    # A corresponding
+                    # path_template_match must be specified. Any template variables must exist in
+                    # the path_template_match field.
+                    #
+                    #
+                    #       - -At least one variable must be specified in the path_template_match
+                    #       field
+                    #    - You can omit variables from the rewritten URL
+                    #       - The * and ** operators cannot be matched
+                    #       unless they have a corresponding variable name - e.g.
+                    #       {format=*} or {var=**}.
+                    #
+                    # For example, a path_template_match of /static/{format=**}
+                    # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                    # rewrite, so that /{country}/{format}/{suffix=**} can be
+                    # rewritten as /content/{format}/{country}/{suffix}.
+                    #
+                    # At least
+                    # one non-empty routeRules[].matchRules[].path_template_match is
+                    # required.
+                    #
+                    # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                  "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                      # It uses RE2 syntax with the following constraints:
+                      #
+                      #
+                      #      - Any single character operators
+                      #      - Groups are allowed to have only submatch operator inside
+                      #      - Groups are allowed only without any char repetition, e.g.
+                      #      .*
+                      #      - Any char repetition, e.g. .*, is
+                      #      only allowed to be used in a single regex together with:
+                      #
+                      #
+                      #             - Empty string operators
+                      #             - Other repetitions
+                      #             - Ranges
+                      #             - Repetitions of ranges
+                      #
+                      #
+                      #      - Ranges are only allowed to have:
+                      #
+                      #
+                      #             - Character range
+                      #             - Digits range
+                      #             - Symbols listed in characters allowed for ranges
+                  "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                      # the path.
+                },
+              },
+              "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                  # occurs. The weights determine the fraction of traffic that flows to
+                  # their corresponding backend service. If all traffic needs to
+                  # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                  #
+                  # After a backend service is identified and before forwarding
+                  # the request to
+                  # the backend service, advanced routing actions such as URL rewrites and
+                  # header transformations are applied depending on additional settings
+                  # specified in this HttpRouteAction.
+                { # In contrast to a single BackendService in
+                    # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                    # multiple backend services. The volume of traffic for each
+                    # backend service is proportional to the weight specified
+                    # in each WeightedBackendService
+                  "backendService": "A String", # The full or partial URL to the default BackendService
+                      # resource. Before
+                      # forwarding the request to backendService, the load balancer
+                      # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                      # effect for the selected backendService.
+                      #
+                      # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                      #
+                      # headerAction is not supported for load balancers that have
+                      # their loadBalancingScheme set to EXTERNAL.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                      # the request is passed along to the selected backendService.
+                    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # request before forwarding the request to the backendService.
+                      "A String",
+                    ],
+                    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                        # client.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # response before sending the response back to the client.
+                      "A String",
+                    ],
+                  },
+                  "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                      # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                      #
+                      # The selection of a backend service is determined only for new traffic.
+                      # Once a user's request has been directed to a backend service,
+                      # subsequent requests are sent to the same backend service as
+                      # determined by the backend service's session affinity policy.
+                      # Don't configure session affinity if you're using weighted traffic
+                      # splitting. If you do, the weighted traffic splitting configuration takes
+                      # precedence.
+                      #
+                      # The value must be from 0 to 1000.
+                },
+              ],
+            },
+            "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                # is directed if this rule is matched. If routeAction is
+                # also specified, advanced routing actions, such as URL rewrites,
+                # take effect before sending the request to the backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+            "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+                # specified by urlRedirect.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+              "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                  # was supplied in the request.
+                  #
+                  # The value must be from 1 to 255
+                  # characters.
+              "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                  # set to HTTPS.
+                  # If set to false, the URL scheme of the redirected request
+                  # remains the same as that of the request.
+                  #
+                  # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                  #
+                  # The default is set to false.
+              "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                  # that was supplied in the request.
+                  #
+                  # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                  # the HttpRouteRuleMatch, retaining the remaining portion
+                  # of the URL before redirecting the request.
+                  #
+                  # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                  #
+                  # Supported values are:
+                  #
+                  #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                  #    to 301.
+                  #    - FOUND, which corresponds to 302.
+                  #    - SEE_OTHER which corresponds to 303.
+                  #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                  #    method is retained.
+                  #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                  #    method is retained.
+              "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                  # URL is
+                  # removed before redirecting the request. If set to false, the
+                  # query portion of the original URL is retained.
+                  #
+                  # The default is set to false.
+            },
+          },
+        ],
+        "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+            # desired. routeRules are evaluated in order of priority, from
+            # the lowest to highest number.
+            #
+            # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+          { # The HttpRouteRule setting specifies how to match an HTTP request
+              # and the corresponding routing action that load balancing proxies perform.
+            "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                #
+                # If a policy for an
+                # error code is not configured for the RouteRule, a policy for
+                # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                # effect.
+                #
+                # For example, consider a UrlMap with the following configuration:
+                #
+                #
+                #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                #      with policies for 5xx and 4xx errors
+                #      - A RouteRule for /coming_soon/ is configured for the
+                #      error code 404.
+                #
+                # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                # the policy in RouteRule.customErrorResponsePolicy takes
+                # effect. If any of the requests in this example encounter a 500
+                # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                #
+                # When
+                # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+                # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+                # a retry, if load balancer is successful in reaching the
+                # service, the customErrorResponsePolicy is ignored and
+                # the response from the service is returned to the client.
+                #
+                # customErrorResponsePolicy is supported only for
+                # global external Application Load Balancers.
+                # backend service or backend bucket responds with an error.
+              "errorResponseRules": [ # Specifies rules for returning error responses.
+                  #
+                  # In a given policy, if you specify rules for both a range of error codes
+                  # as well as rules for specific error codes then rules with specific error
+                  # codes have a higher priority. For example, assume that you configure a rule
+                  # for 401 (Un-authorized) code, and another for all 4 series
+                  # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                  # However if the backend service returns a 403, the rule for4xx takes effect.
+                { # Specifies the mapping between the response code that will be returned along
+                    # with the custom error content and the response code returned by the backend
+                    # service.
+                  "matchResponseCodes": [ # Valid values include:
+                      #
+                      #
+                      #      - A number between 400 and 599: For example
+                      #      401 or 503, in which case the load balancer
+                      #      applies the policy if the error code exactly matches this value.
+                      #      - 5xx: Load Balancer will apply the policy if the
+                      #      backend service responds with any response code in the range of
+                      #      500 to 599.
+                      #    - 4xx: Load
+                      #      Balancer will apply the policy if the backend service responds with any
+                      #      response code in the range of 400 to
+                      #      499.
+                      #
+                      # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                    "A String",
+                  ],
+                  "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                      # error content. If overrideResponseCode is not supplied, the
+                      # same response code returned by the original backend bucket or backend
+                      # service is returned to the client.
+                  "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                      #
+                      # path must start
+                      # with a leading slash. path cannot have trailing slashes.
+                      #
+                      # If the file is not available in backendBucket  or the
+                      # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                      #
+                      # The value must
+                      # be from 1 to 1024 characters
+                },
+              ],
+              "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                  # contains the custom error content. Examples are:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - global/backendBuckets/myBackendBucket
+                  #
+                  # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                  # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                  #
+                  # If load balancer cannot reach
+                  # the backendBucket, a simple Not Found Error will
+                  # be returned, with the original response code (oroverrideResponseCode if configured).
+                  #
+                  # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+            },
+            "description": "A String", # The short description conveying the intent of this routeRule.
+                #
+                #
+                # The description can have a maximum length of 1024 characters.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                # for the selected backendService.
+                #
+                # The headerAction value specified here is applied before the
+                # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+                #
+                # HeaderAction is not supported for load balancers
+                # that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+                # this routeRule when any of thematchRules are satisfied. However predicates within
+                # a given matchRule have AND semantics. All predicates
+                # within a matchRule must match for the request to
+                # match the rule.
+              { # HttpRouteRuleMatch specifies a set of criteria for matching
+                  # requests to an HttpRouteRule. All specified criteria must
+                  # be satisfied for a match to occur.
+                "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                    # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                    # that may be part of the original URL.
+                    #
+                    # fullPathMatch must be from 1 to 1024 characters.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                    # specified.
+                "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                    # corresponding headers in the request.
+                  { # matchRule criteria for request header matches.
+                    "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "headerName": "A String", # The name of the HTTP header to match.
+                        #
+                        # For matching against the HTTP request's authority, use a headerMatch
+                        # with the header name ":authority".
+                        #
+                        # For matching a request's method, use the headerName ":method".
+                        #
+                        # When the URL map is bound to a target gRPC proxy that has
+                        # the validateForProxyless field set to true, only
+                        # non-binary
+                        # user-specified custom metadata and the `content-type` header are supported.
+                        # The following transport-level headers cannot be used in header matching
+                        # rules:
+                        # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                        # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                        # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                        # `grpc-timeout` and `grpc-trace-bin`.
+                    "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                        # match if the preceding match criteria are met. If set to true,
+                        # the headerMatch is considered a match if the preceding
+                        # match criteria are NOT met.
+                        #
+                        # The default setting is false.
+                    "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                        # match takes place whether or not the request's header has a value.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                        # specified in rangeMatch. If the header does not contain an
+                        # integer, number or is empty, the match fails.
+                        #
+                        # For example for a range [-5, 0]
+                        #
+                        #
+                        #       - -3 will match.
+                        #       - 0 will not match.
+                        #       - 0.25 will not match.
+                        #       - -3someString will not match.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                        #
+                        # rangeMatch is not supported for load balancers
+                        # that have loadBalancingScheme set to EXTERNAL.
+                        # within the specified integer range.
+                      "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                      "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                    },
+                    "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                        # For more information about regular expression syntax, see Syntax.
+                        #
+                        # For matching against a port specified in the HTTP request, use a
+                        # headerMatch with headerName set to PORT and a regular expression that
+                        # satisfies the RFC2616 Host header's port specifier.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                        #
+                        # Regular expressions can only be used when the loadBalancingScheme is
+                        # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                        # (regional scope) or INTERNAL_MANAGED.
+                    "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  },
+                ],
+                "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                    # matches are case sensitive.
+                    #
+                    # The default value is false.
+                    #
+                    # ignoreCase must not be used with regexMatch.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                    # configuration to a limited set of xDS
+                    # compliant clients. In their xDS requests to the load balancer, xDS clients
+                    # present node
+                    # metadata. When there is a match, the relevant routing configuration
+                    # is made available to those proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata. If multiple
+                    # metadata filters are specified, all of them need to be
+                    # satisfied in order to be considered a match.
+                    #
+                    # metadataFilters specified here is applied after those
+                    # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                    #
+                    # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                  { # Opaque filter criteria used by load balancers to restrict routing
+                      # configuration to a limited set of load balancing proxies. Proxies and
+                      # sidecars involved in load balancing would typically present metadata to the
+                      # load balancers that need to match criteria specified here. If a match takes
+                      # place, the relevant configuration is made available to those
+                      # proxies.
+                      #
+                      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                      # one of thefilterLabels must match the corresponding label provided in
+                      # the metadata. If its filterMatchCriteria is set to
+                      # MATCH_ALL, then all of its filterLabels must match with
+                      # corresponding labels provided in the metadata.
+                      #
+                      # An example for using metadataFilters would be: if
+                      # load balancing involves
+                      # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                    "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                        # metadata based on filterMatchCriteria
+                        #
+                        # This list must not be empty and can have at the most 64 entries.
+                      { # MetadataFilter label name value pairs that are expected
+                          # to match corresponding labels presented as metadata to the load balancer.
+                        "name": "A String", # Name of metadata label.
+                            #
+                            #  The name can have a maximum length of 1024 characters and must be at
+                            # least 1 character long.
+                        "value": "A String", # The value of the label must match the specified value.
+                            #
+                            # value can have a maximum length of 1024 characters.
+                      },
+                    ],
+                    "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                        # within the list of filterLabels and contributes toward the
+                        # overall metadataFilter match.
+                        #
+                        #  Supported values are:
+                        #
+                        #    - MATCH_ANY: at least one of the filterLabels
+                        #    must have a matching label in the provided metadata.
+                        #    - MATCH_ALL: all filterLabels must have
+                        #    matching labels in the provided metadata.
+                  },
+                ],
+                "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                    # the :path header after the query string is removed.
+                    #
+                    # A path template pattern can include variables and wildcards.
+                    # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                    # matches a single path segment, and ** that matches zero or
+                    # more path segments. The pattern must follow these rules:
+                    #
+                    #
+                    #       - The value must be between 1 and 1024 characters.
+                    #       - The pattern must start with a leading slash ("/").
+                    #       - No more than 5 operators (variables or wildcards) may appear in
+                    #       the pattern.
+                    #
+                    # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                    # set.
+                "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                    # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                    #
+                    # The * character inside a prefix match is
+                    # treated as a literal character, not as a wildcard.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                    # used within a matchRule.
+                "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                    # match corresponding query parameters in the request.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                  { # HttpRouteRuleMatch criteria for a request's query parameter.
+                    "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                        # parameter exactly matches the contents of exactMatch.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                    "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                        # the request, in the absence of which the request match fails.
+                    "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                        # request contains the query parameter, irrespective of whether the
+                        # parameter has a value or not.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                    "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                        # parameter matches the regular expression specified byregexMatch. For
+                        # more information about regular expression syntax, see Syntax.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                        #
+                        # Regular expressions can only be used when the loadBalancingScheme is
+                        # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                        # (regional scope) or INTERNAL_MANAGED.
+                  },
+                ],
+                "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                    # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                    # supplied with the original URL. For
+                    # more information about regular expression syntax, see Syntax.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                    # specified.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                    # (regional scope) or INTERNAL_MANAGED.
+              },
+            ],
+            "priority": 42, # For routeRules within a given pathMatcher,
+                # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+                # of priority, from the lowest to highest number. The priority of a
+                # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+                # that matches the request is applied.
+                #
+                #
+                # You cannot configure two or more routeRules with the same priority.
+                # Priority for each rule must be set to a number from 0 to 2147483647
+                # inclusive.
+                #
+                #
+                # Priority numbers can have gaps, which enable you to add or remove rules
+                # in the future without affecting the rest of the rules. For example, 1, 2,
+                # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+                # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+                # without any impact on existing rules.
+            "routeAction": { # In response to a matching matchRule, the load balancer
+                # performs advanced routing actions, such as URL rewrites and header
+                # transformations, before forwarding the request to the selected backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # URL maps for classic Application Load Balancers only support
+                # the urlRewrite action within a route rule'srouteAction.
+              "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                  # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                  # property must be specified. This policy cannot be specified if any target
+                  # backend has Identity-Aware Proxy enabled.
+                "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                    # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                    # header names can be specified. The cache is bypassed for all `cacheMode`
+                    # values.
+                  "A String",
+                ],
+                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                    # on the backend type: for Backend Services, the complete request URI is
+                    # used; for Backend Buckets, the request URI is used without the protocol or
+                    # host, and only query parameters known to Cloud Storage are included.
+                    # Policy defined on Route Action.
+                  "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                      # parameters will be included. Either specify `excludedQueryParameters`
+                      # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                    "A String",
+                  ],
+                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # host is never included in a Backend Bucket's cache key. Attempting to set
+                      # it on a route that points exclusively to Backend Buckets will result in a
+                      # configuration error.
+                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # protocol is never included in a Backend Bucket's cache key. Attempting to
+                      # set on a route that points exclusively to Backend Buckets will result in
+                      # a configuration error.
+                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                      # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                      # is set, the entire query string will be included. If false, the query
+                      # string will be excluded from the cache key entirely.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                  "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                      # The name=value pair will be used in the cache key Cloud CDN generates.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket.
+                      # Attempting to set it on a route that points exclusively to Backend
+                      # Buckets will result in a configuration error. Up to 5 cookie names can be
+                      # specified.
+                    "A String",
+                  ],
+                  "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                    "A String",
+                  ],
+                  "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                      # parameters will be excluded. Either specify `includedQueryParameters`
+                      # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                },
+                "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                    # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                    # content. This is used to clamp the max-age (or Expires) value sent to the
+                    # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                    # is used for the response max-age directive, along with a "public"
+                    # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                    # clamps the max-age from the origin (if specified), or else sets the
+                    # response max-age directive to the lesser of the `clientTtl` and
+                    # `defaultTtl`, and also ensures a "public" cache-control directive is
+                    # present. The maximum allowed value is 31,622,400s (1 year). If not
+                    # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                    # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                    # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                    # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                    # greater than that of `maxTtl`. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                    # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                    # accessed objects may be evicted from the cache before the defined TTL. If
+                    # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                    # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                    # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                    # more than `maxTtl` seconds in the future will be capped at the value of
+                    # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                    # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                    # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                    # Infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                    # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                    # mode.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                    # to apply fine-grained caching for common errors or redirects.
+                    # This can reduce the load on your origin and improve end-user
+                    # experience by reducing response latency.
+                    # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                    # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                    # the specified response code that lack any Cache-Control, Expires, or
+                    # Pragma: no-cache directives. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                    # with the specified response code, and overrides any caching headers. By
+                    # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                    #
+                    # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                    # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                    # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                    #
+                    # These defaults can be overridden in `negativeCachingPolicy`.
+                    # If not specified, Cloud CDN applies negative caching by default.
+                "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                    # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                    # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                    # CDN's default cache TTLs. Note that when specifying an explicit
+                    # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                    # all response codes that you wish to cache. Cloud CDN will not apply any
+                    # default negative caching when a policy exists.
+                  { # Specify CDN TTLs for response error codes.
+                    "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                        # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                        # specified as values, and you cannot specify a status code more than
+                        # once.
+                    "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                        # corresponding status code.
+                        # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                        # objects may be evicted from the cache before the defined TTL.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                  },
+                ],
+                "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                    # requests into a small number of requests to the origin. If not specified,
+                    # Cloud CDN applies request coalescing by default.
+                "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                    # content with the origin, or when an error is encountered when refreshing
+                    # the cache.
+                    # This setting defines the default "max-stale" duration for any cached
+                    # responses that do not specify a max-stale directive. Stale responses that
+                    # exceed the TTL configured here will not be served. The default limit
+                    # (max-stale) is 86400s (1 day), which will allow stale content to be
+                    # served up to this limit beyond the max-age (or s-maxage) of a cached
+                    # response.
+                    # The maximum allowed value is 604800 (1 week).
+                    # Set this to zero (0) to disable serve-while-stale.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+              "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                    # indicates that
+                    # the actual request can include user credentials. This field translates to
+                    # the Access-Control-Allow-Credentials header.
+                    #
+                    # Default is false.
+                "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                    # header.
+                  "A String",
+                ],
+                "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                    # header.
+                  "A String",
+                ],
+                "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                    # more information, see regular expression syntax.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED.
+                  "A String",
+                ],
+                "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  "A String",
+                ],
+                "disabled": True or False, # If true, disables the CORS policy.
+                    # The default value is false, which indicates that the CORS
+                    # policy is in effect.
+                "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                    # header.
+                  "A String",
+                ],
+                "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                    # seconds. This field translates to the Access-Control-Max-Age
+                    # header.
+              },
+              "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by a load balancer on a percentage of requests before sending
+                  # those requests to the backend service. Similarly requests from clients can
+                  # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                  # that are configured with a fault_injection_policy if:
+                  # 1. The traffic is generated by fault injection AND
+                  # 2. The fault injection is not a delay fault injection.
+                  # Fault injection is not supported with the classic Application Load Balancer
+                  # . To see which load balancers support fault injection,
+                  # see Load
+                  # balancing: Routing and traffic management features.
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by the load balancer on a percentage of requests before sending
+                  # those request to the backend service. Similarly requests from clients can be
+                  # aborted by the load balancer for a percentage of requests.
+                "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                    # injection.
+                  "httpStatus": 42, # The HTTP status code used to abort the request.
+                      #
+                      # The value must be from 200 to 599 inclusive.
+                      #
+                      # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                      # according to this
+                      # mapping table. HTTP status 200 is mapped to gRPC status
+                      # UNKNOWN. Injecting an OK status is currently not supported by
+                      # Traffic Director.
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                      # that is aborted as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+                "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                    # injection, before being sent to a backend service.
+                    # request to the backend service as part of fault injection.
+                  "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                      # which a delay is introduced as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+              },
+              "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                  # Unlike the timeout field where the timeout duration starts
+                  # from the time the request has been fully processed (known as*end-of-stream*),
+                  # the duration in this field is computed from the beginning of the stream
+                  # until the response has been processed, including all retries. A
+                  # stream that does not complete in this duration is closed.
+                  #
+                  # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                  # with the route.
+                  #
+                  # This field is only allowed if the Url map is used with backend services
+                  # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                  # are shadowed to a separate mirrored backend service. The load balancer does
+                  # not wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host / authority header is suffixed with-shadow.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # are shadowed to a separate mirrored backend service. The load balancer
+                  # doesn't wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host or authority header is suffixed with-shadow.
+                "backendService": "A String", # The full or partial URL to the BackendService resource being
+                    # mirrored to.
+                    #
+                    # The backend service configured for a mirroring
+                    # policy must reference backends that are of the same type as the original
+                    # backend service matched in the URL map.
+                    #
+                    # Serverless NEG backends are not currently supported as a mirrored
+                    # backend service.
+                "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+              },
+              "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                    # If not specified, defaults to 1.
+                "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                    #
+                    # If not specified, will use the timeout set in theHttpRouteAction field.
+                    # If timeout in the HttpRouteAction field is not set, this field
+                    # uses the largest timeout
+                    # among all backend services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                    # values are:
+                    #
+                    #    - 5xx: retry is attempted if the instance or endpoint
+                    #    responds with any 5xx response code, or if the instance or
+                    #    endpoint does not respond at all. For example, disconnects, reset, read
+                    #    timeout, connection failure, and refused streams.
+                    #    - gateway-error: Similar to 5xx, but only
+                    #    applies to response codes 502, 503 or504.
+                    #    - connect-failure: a retry is attempted on failures
+                    #    connecting to the instance or endpoint. For example, connection
+                    #    timeouts.
+                    #    - retriable-4xx: a retry is attempted if the instance
+                    #    or endpoint responds with a 4xx response code.
+                    #    The only error that you can retry is error code 409.
+                    #    - refused-stream: a retry is attempted if the instance
+                    #    or endpoint resets the stream with a REFUSED_STREAM error
+                    #    code. This reset type indicates that it is safe to retry.
+                    #    - cancelled: a retry is attempted if the gRPC status
+                    #    code in the response header is set to cancelled.
+                    #    - deadline-exceeded: a retry is attempted if the gRPC
+                    #    status code in the response header is set todeadline-exceeded.
+                    #    - internal: a retry is attempted if the gRPC
+                    #    status code in the response header is set tointernal.
+                    #    - resource-exhausted: a retry is attempted if the gRPC
+                    #    status code in the response header is set toresource-exhausted.
+                    #    - unavailable: a retry is attempted if the gRPC
+                    #    status code in the response header is set tounavailable.
+                    #
+                    # Only the following codes are supported when the URL map is bound to
+                    # target gRPC proxy that has validateForProxyless field set to true.
+                    #
+                    #    - cancelled
+                    #    - deadline-exceeded
+                    #    - internal
+                    #    - resource-exhausted
+                    #    - unavailable
+                  "A String",
+                ],
+              },
+              "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                  # time the request has been fully processed (known as *end-of-stream*)
+                  # up until the response has been processed. Timeout includes
+                  # all retries.
+                  #
+                  # If not specified, this field uses the largest timeout among all backend
+                  # services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                  # to the matched service.
+                  #
+                  #  urlRewrite is the only action supported in UrlMaps
+                  # for classic Application Load Balancers.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # backend service.
+                "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                    # host header is replaced with contents of hostRewrite.
+                    #
+                    # The value must be from 1 to 255 characters.
+                "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                    # matching portion of the request's path is replaced bypathPrefixRewrite.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                    # header) using the HTTP template syntax.
+                    #
+                    # A corresponding
+                    # path_template_match must be specified. Any template variables must exist in
+                    # the path_template_match field.
+                    #
+                    #
+                    #       - -At least one variable must be specified in the path_template_match
+                    #       field
+                    #    - You can omit variables from the rewritten URL
+                    #       - The * and ** operators cannot be matched
+                    #       unless they have a corresponding variable name - e.g.
+                    #       {format=*} or {var=**}.
+                    #
+                    # For example, a path_template_match of /static/{format=**}
+                    # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                    # rewrite, so that /{country}/{format}/{suffix=**} can be
+                    # rewritten as /content/{format}/{country}/{suffix}.
+                    #
+                    # At least
+                    # one non-empty routeRules[].matchRules[].path_template_match is
+                    # required.
+                    #
+                    # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                  "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                      # It uses RE2 syntax with the following constraints:
+                      #
+                      #
+                      #      - Any single character operators
+                      #      - Groups are allowed to have only submatch operator inside
+                      #      - Groups are allowed only without any char repetition, e.g.
+                      #      .*
+                      #      - Any char repetition, e.g. .*, is
+                      #      only allowed to be used in a single regex together with:
+                      #
+                      #
+                      #             - Empty string operators
+                      #             - Other repetitions
+                      #             - Ranges
+                      #             - Repetitions of ranges
+                      #
+                      #
+                      #      - Ranges are only allowed to have:
+                      #
+                      #
+                      #             - Character range
+                      #             - Digits range
+                      #             - Symbols listed in characters allowed for ranges
+                  "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                      # the path.
+                },
+              },
+              "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                  # occurs. The weights determine the fraction of traffic that flows to
+                  # their corresponding backend service. If all traffic needs to
+                  # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                  #
+                  # After a backend service is identified and before forwarding
+                  # the request to
+                  # the backend service, advanced routing actions such as URL rewrites and
+                  # header transformations are applied depending on additional settings
+                  # specified in this HttpRouteAction.
+                { # In contrast to a single BackendService in
+                    # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                    # multiple backend services. The volume of traffic for each
+                    # backend service is proportional to the weight specified
+                    # in each WeightedBackendService
+                  "backendService": "A String", # The full or partial URL to the default BackendService
+                      # resource. Before
+                      # forwarding the request to backendService, the load balancer
+                      # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                      # effect for the selected backendService.
+                      #
+                      # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                      #
+                      # headerAction is not supported for load balancers that have
+                      # their loadBalancingScheme set to EXTERNAL.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                      # the request is passed along to the selected backendService.
+                    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # request before forwarding the request to the backendService.
+                      "A String",
+                    ],
+                    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                        # client.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # response before sending the response back to the client.
+                      "A String",
+                    ],
+                  },
+                  "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                      # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                      #
+                      # The selection of a backend service is determined only for new traffic.
+                      # Once a user's request has been directed to a backend service,
+                      # subsequent requests are sent to the same backend service as
+                      # determined by the backend service's session affinity policy.
+                      # Don't configure session affinity if you're using weighted traffic
+                      # splitting. If you do, the weighted traffic splitting configuration takes
+                      # precedence.
+                      #
+                      # The value must be from 0 to 1000.
+                },
+              ],
+            },
+            "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                # is directed if this rule is matched. If routeAction is
+                # also specified, advanced routing actions, such as URL rewrites,
+                # take effect before sending the request to the backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+            "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+                # specified by urlRedirect.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+              "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                  # was supplied in the request.
+                  #
+                  # The value must be from 1 to 255
+                  # characters.
+              "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                  # set to HTTPS.
+                  # If set to false, the URL scheme of the redirected request
+                  # remains the same as that of the request.
+                  #
+                  # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                  #
+                  # The default is set to false.
+              "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                  # that was supplied in the request.
+                  #
+                  # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                  # the HttpRouteRuleMatch, retaining the remaining portion
+                  # of the URL before redirecting the request.
+                  #
+                  # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                  #
+                  # Supported values are:
+                  #
+                  #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                  #    to 301.
+                  #    - FOUND, which corresponds to 302.
+                  #    - SEE_OTHER which corresponds to 303.
+                  #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                  #    method is retained.
+                  #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                  #    method is retained.
+              "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                  # URL is
+                  # removed before redirecting the request. If set to false, the
+                  # query portion of the original URL is retained.
+                  #
+                  # The default is set to false.
+            },
+          },
+        ],
+      },
+    ],
+    "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+        # This field is not applicable to global URL maps.
+        # 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.
+    "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+        # maximum of 100 tests per UrlMap.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+      { # Message for the expected URL mappings.
+        "description": "A String", # Description of this test case.
+        "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+            # containing the scheme, host, path and query parameters.
+            #
+            # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+            # the load balancer to backends. For rules with urlRewrite,
+            # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+            #
+            # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+            # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+            # If urlRedirect specifies strip_query, the test
+            # passes only if expectedOutputUrl does not contain any query
+            # parameters.
+            #
+            # expectedOutputUrl is optional whenservice is specified.
+        "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+            # load balancer's redirect response.
+            #
+            # expectedRedirectResponseCode cannot be set whenservice is set.
+        "headers": [ # HTTP headers for this request. If headers contains
+            # a host header, then host must also match the header value.
+          { # HTTP headers used in UrlMapTests.
+            "name": "A String", # Header name.
+            "value": "A String", # Header value.
+          },
+        ],
+        "host": "A String", # Host portion of the URL. If headers contains a host header,
+            # then host must also match the header value.
+        "path": "A String", # Path portion of the URL.
+        "service": "A String", # Expected BackendService or BackendBucket resource
+            # the given URL should be mapped to.
+            #
+            # The service field cannot
+            # be set if expectedRedirectResponseCode is set.
+      },
+    ],
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "result": { # Message representing the validation result for a UrlMap.
+    "loadErrors": [
+      "A String",
+    ],
+    "loadSucceeded": True or False, # Whether the given UrlMap can be successfully loaded.
+        # If false, 'loadErrors' indicates the reasons.
+    "testFailures": [
+      {
+        "actualOutputUrl": "A String", # The actual output URL evaluated by a load balancer containing the scheme,
+            # host, path and query parameters.
+        "actualRedirectResponseCode": 42, # Actual HTTP status code for rule with `urlRedirect`
+            # calculated by load balancer
+        "actualService": "A String", # BackendService or BackendBucket returned by load
+            # balancer.
+        "expectedOutputUrl": "A String", # The expected output URL evaluated by a load balancer containing the scheme,
+            # host, path and query parameters.
+        "expectedRedirectResponseCode": 42, # Expected HTTP status code for rule with `urlRedirect`
+            # calculated by load balancer
+        "expectedService": "A String", # Expected BackendService or BackendBucket resource
+            # the given URL should be mapped to.
+        "headers": [ # HTTP headers of the request.
+          { # HTTP headers used in UrlMapTests.
+            "name": "A String", # Header name.
+            "value": "A String", # Header value.
+          },
+        ],
+        "host": "A String", # Host portion of the URL.
+        "path": "A String", # Path portion including query parameters in the URL.
+      },
+    ],
+    "testPassed": True or False, # If successfully loaded, this field indicates whether the test passed.
+        # If false, 'testFailures's indicate the reason of failure.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regionZones.html b/docs/dyn/compute_preview.regionZones.html new file mode 100644 index 0000000000..cdff0eb48c --- /dev/null +++ b/docs/dyn/compute_preview.regionZones.html @@ -0,0 +1,388 @@ + + + +

Compute Engine API . regionZones

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Zone resources under the specific region available to

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of Zone resources under the specific region available to
+the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Region 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.
+  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 zone resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Zone resources.
+    { # Represents a Zone resource.
+        #
+        # A zone is a deployment area. These deployment areas are subsets of a region.
+        # For example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and
+        # Zones.
+      "availableCpuPlatforms": [ # [Output Only] Available cpu/platform selections for the zone.
+        "A String",
+      ],
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] Textual description of the resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#zone", # Output only. [Output Only] Type of the resource. Always compute#zone for
+          # zones.
+      "name": "A String", # [Output Only] Name of the resource.
+      "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
+      "resourceStatus": {
+        "upcomingMaintenances": [ # Output only. [Output Only] The upcoming maintenance schedule.
+          { # The periodic partial maintenance schedule includes 52 weeks worth of
+              # maintenance windows.
+              # LINT.IfChange(PeriodicPartialMaintenanceSchedule)
+            "subType": "A String", # The maintenance type in which the zone is during the given window.
+            "targetResource": "A String", # The target resource that the maintenance window is for.
+                # For example, "projects/my-project/zones/us-central1-a".
+            "type": "A String",
+            "windowEndTime": { # Represents civil time (or occasionally physical time). # The end civil timestamp of the window (not inclusive).
+                # This contains a time zone.
+                #
+                # This type can represent a civil time in one of a few possible ways:
+                #
+                #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+                #    day with a particular offset from UTC.
+                #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+                #    day in a particular time zone.
+                #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+                #    day in local time.
+                #
+                # The date is relative to the Proleptic Gregorian Calendar.
+                #
+                # If year, month, or day are 0, the DateTime is considered not to have a
+                # specific year, month, or day respectively.
+                #
+                # This type may also be used to represent a physical time if all the date and
+                # time fields are set and either case of the `time_offset` oneof is set.
+                # Consider using `Timestamp` message for physical time instead. If your use
+                # case also would like to store the user's timezone, that can be done in
+                # another field.
+                #
+                # This type is more flexible than some applications may want. Make sure to
+                # document and validate your application's limitations.
+              "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+                  # month, or 0 if specifying a datetime without a day.
+              "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+                  # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+                  # scenarios like business closing time.
+              "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+              "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+                  # datetime without a month.
+              "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+                  # 999,999,999, defaults to 0.
+              "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+                  # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+              "timeZone": { # Represents a time zone from the # Time zone.
+                  # [IANA Time Zone Database](https://www.iana.org/time-zones).
+                "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+                "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+              },
+              "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+                  # For example, a UTC offset of -4:00 would be represented as
+                  # { seconds: -14400 }.
+              "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+                  # datetime without a year.
+            },
+            "windowStartTime": { # Represents civil time (or occasionally physical time). # The start civil timestamp of the window.
+                # This contains a time zone.
+                #
+                # This type can represent a civil time in one of a few possible ways:
+                #
+                #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+                #    day with a particular offset from UTC.
+                #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+                #    day in a particular time zone.
+                #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+                #    day in local time.
+                #
+                # The date is relative to the Proleptic Gregorian Calendar.
+                #
+                # If year, month, or day are 0, the DateTime is considered not to have a
+                # specific year, month, or day respectively.
+                #
+                # This type may also be used to represent a physical time if all the date and
+                # time fields are set and either case of the `time_offset` oneof is set.
+                # Consider using `Timestamp` message for physical time instead. If your use
+                # case also would like to store the user's timezone, that can be done in
+                # another field.
+                #
+                # This type is more flexible than some applications may want. Make sure to
+                # document and validate your application's limitations.
+              "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+                  # month, or 0 if specifying a datetime without a day.
+              "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+                  # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+                  # scenarios like business closing time.
+              "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+              "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+                  # datetime without a month.
+              "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+                  # 999,999,999, defaults to 0.
+              "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+                  # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+              "timeZone": { # Represents a time zone from the # Time zone.
+                  # [IANA Time Zone Database](https://www.iana.org/time-zones).
+                "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+                "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+              },
+              "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+                  # For example, a UTC offset of -4:00 would be represented as
+                  # { seconds: -14400 }.
+              "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+                  # datetime without a year.
+            },
+          },
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] Status of the zone, either UP orDOWN.
+      "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+    },
+  ],
+  "kind": "compute#zoneList", # 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.regions.html b/docs/dyn/compute_preview.regions.html new file mode 100644 index 0000000000..4c1813b51f --- /dev/null +++ b/docs/dyn/compute_preview.regions.html @@ -0,0 +1,446 @@ + + + +

Compute Engine API . regions

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, region, x__xgafv=None)

+

Returns the specified Region resource.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of region resources available to the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, region, x__xgafv=None) + 
Returns the specified Region resource.
+
+To decrease latency for this method, you can optionally omit any unneeded
+information from the response by using a field mask. This practice is
+especially recommended for unused quota information (the `quotas` field).
+To exclude one or more fields, set your request's `fields` query parameter
+to only include the fields you need. For example, to only include the `id`
+and `selfLink` fields, add the query parameter `?fields=id,selfLink` to
+your request.
+
+This method fails if the quota information is unavailable for the region
+and if the organization policy constraint
+compute.requireBasicQuotaInResponse is enforced. This
+constraint, when enforced, disables the fail-open behaviour when quota
+information (the `items.quotas` field) is unavailable for the region.
+It is recommended to use the default setting
+for the constraint unless your application requires the fail-closed
+behaviour for this method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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 Region resource.
+    #
+    # A region is a geographical area where a resource is located. For more
+    # information, readRegions
+    # and Zones.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] Textual description of the resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#region", # Output only. [Output Only] Type of the resource. Always compute#region for
+      # regions.
+  "name": "A String", # [Output Only] Name of the resource.
+  "quotaStatusWarning": { # Output only. [Output Only] Warning of fetching the `quotas` field for this region. This
+      # field is populated only if fetching of the `quotas` field fails.
+    "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.
+  },
+  "quotas": [ # [Output Only] Quotas assigned to this region.
+    { # A quotas entry.
+      "limit": 3.14, # [Output Only] Quota limit for this metric.
+      "metric": "A String", # [Output Only] Name of the quota metric.
+      "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+          # is applied.
+      "usage": 3.14, # [Output Only] Current usage of this metric.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] Status of the region, either UP orDOWN.
+  "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "zones": [ # [Output Only] A list of zones available in this region, in the form of
+      # resource URLs.
+    "A String",
+  ],
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of region resources available to the specified project.
+
+To decrease latency for this method, you can optionally omit any unneeded
+information from the response by using a field mask. This practice is
+especially recommended for unused quota information
+(the `items.quotas` field).
+To exclude one or more fields, set your request's `fields` query parameter
+to only include the fields you need. For example, to only include the `id`
+and `selfLink` fields, add the query parameter `?fields=id,selfLink` to
+your request.
+
+This method fails if the quota information is unavailable for the region
+and if the organization policy constraint
+compute.requireBasicQuotaInResponse is enforced. This
+constraint, when enforced, disables the fail-open behaviour when quota
+information (the `items.quotas` field) is unavailable for the region.
+It is recommended to use the default setting
+for the constraint unless your application requires the fail-closed
+behaviour for this method.
+
+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.
+  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 region resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Region resources.
+    { # Represents a Region resource.
+        #
+        # A region is a geographical area where a resource is located. For more
+        # information, readRegions
+        # and Zones.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] Textual description of the resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#region", # Output only. [Output Only] Type of the resource. Always compute#region for
+          # regions.
+      "name": "A String", # [Output Only] Name of the resource.
+      "quotaStatusWarning": { # Output only. [Output Only] Warning of fetching the `quotas` field for this region. This
+          # field is populated only if fetching of the `quotas` field fails.
+        "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.
+      },
+      "quotas": [ # [Output Only] Quotas assigned to this region.
+        { # A quotas entry.
+          "limit": 3.14, # [Output Only] Quota limit for this metric.
+          "metric": "A String", # [Output Only] Name of the quota metric.
+          "owner": "A String", # [Output Only] Owning resource. This is the resource on which this quota
+              # is applied.
+          "usage": 3.14, # [Output Only] Current usage of this metric.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] Status of the region, either UP orDOWN.
+      "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "zones": [ # [Output Only] A list of zones available in this region, in the form of
+          # resource URLs.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#regionList", # Output only. [Output Only] Type of resource. Always compute#regionList for
+      # lists of regions.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.reliabilityRisks.html b/docs/dyn/compute_preview.reliabilityRisks.html new file mode 100644 index 0000000000..4c62ce2e20 --- /dev/null +++ b/docs/dyn/compute_preview.reliabilityRisks.html @@ -0,0 +1,322 @@ + + + +

Compute Engine API . reliabilityRisks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, reliabilityRisk, x__xgafv=None)

+

Returns the specified ReliabilityRisk resource.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of reliabilityRisks available in the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, reliabilityRisk, x__xgafv=None) + 
Returns the specified ReliabilityRisk resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  reliabilityRisk: string, Name of the ReliabilityRisk 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 ReliabilityRisk resource.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+      # text format.
+  "description": "A String", # An optional textual description of the resource; provided when the
+      # resource is created.
+  "details": { # Detailed insights and metrics about a detected reliability risk. # [Output Only] Details of the reliability risk resource
+    "duration": "A String", # The duration of the risk since it was detected.
+    "globalDnsInsight": { # Detailed insights for a global DNS reliability risk. # Insight details for global DNS risk.
+      "projectDefaultIsGlobalDns": True or False, # Indicates whether the project's default DNS setting is global DNS.
+      "queryObservationWindow": "A String", # The observation window for the query counts.
+      "riskyQueryCount": "A String", # The number of queries that are risky. This is always less than or
+          # equal to total_query_count.
+      "totalQueryCount": "A String", # The total number of queries in the observation window.
+    },
+    "lastUpdateTimestamp": "A String", # The last time the risk was updated.
+    "severity": "A String", # The severity of the risk.
+    "type": "A String", # The type of risk.
+  },
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#reliabilityRisk", # Output only. [Output Only] Type of resource. Always compute#reliabilityRisk
+      # for reliability risks.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+      # comply with RFC1035.
+  "recommendation": { # Recommendation for mitigating a reliability risk, including a reference URL. # The recommendation to mitigate the risk.
+    "content": "A String", # Mitigation guide for the risk.
+    "referenceUrl": "A String", # URL referencing a more detailed mitigation guide.
+  },
+  "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 with the resource id.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of reliabilityRisks available in 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.
+  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 the List method of ReliabilityRisksService.
+  "etag": "A String", # [Output Only] An ETag of the resource.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of ReliabilityRisk resources.
+    { # Represents a ReliabilityRisk resource.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp in RFC3339
+          # text format.
+      "description": "A String", # An optional textual description of the resource; provided when the
+          # resource is created.
+      "details": { # Detailed insights and metrics about a detected reliability risk. # [Output Only] Details of the reliability risk resource
+        "duration": "A String", # The duration of the risk since it was detected.
+        "globalDnsInsight": { # Detailed insights for a global DNS reliability risk. # Insight details for global DNS risk.
+          "projectDefaultIsGlobalDns": True or False, # Indicates whether the project's default DNS setting is global DNS.
+          "queryObservationWindow": "A String", # The observation window for the query counts.
+          "riskyQueryCount": "A String", # The number of queries that are risky. This is always less than or
+              # equal to total_query_count.
+          "totalQueryCount": "A String", # The total number of queries in the observation window.
+        },
+        "lastUpdateTimestamp": "A String", # The last time the risk was updated.
+        "severity": "A String", # The severity of the risk.
+        "type": "A String", # The type of risk.
+      },
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reliabilityRisk", # Output only. [Output Only] Type of resource. Always compute#reliabilityRisk
+          # for reliability risks.
+      "name": "A String", # Name of the resource. The name must be 1-63 characters long and
+          # comply with RFC1035.
+      "recommendation": { # Recommendation for mitigating a reliability risk, including a reference URL. # The recommendation to mitigate the risk.
+        "content": "A String", # Mitigation guide for the risk.
+        "referenceUrl": "A String", # URL referencing a more detailed mitigation guide.
+      },
+      "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 with the resource id.
+    },
+  ],
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.reservationBlocks.html b/docs/dyn/compute_preview.reservationBlocks.html new file mode 100644 index 0000000000..2908210833 --- /dev/null +++ b/docs/dyn/compute_preview.reservationBlocks.html @@ -0,0 +1,2027 @@ + + + +

Compute Engine API . reservationBlocks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, reservation, reservationBlock, view=None, x__xgafv=None)

+

Retrieves information about the specified reservation block.

+

+ getIamPolicy(project, zone, parentResource, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of reservation blocks under a single reservation.

+

+ list_next()

+

Retrieves the next page of results.

+

+ performMaintenance(project, zone, reservation, reservationBlock, body=None, requestId=None, x__xgafv=None)

+

Allows customers to perform maintenance on a reservation block

+

+ setIamPolicy(project, zone, parentResource, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, zone, parentResource, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, reservation, reservationBlock, view=None, x__xgafv=None) + 
Retrieves information about the specified reservation block.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  reservation: string, The name of the reservation.
+Name should conform to RFC1035 or be a resource ID. (required)
+  reservationBlock: string, The name of the reservation block.
+Name should conform to RFC1035 or be a resource ID. (required)
+  view: string, View of the Block.
+    Allowed values
+      BASIC - This view includes basic information about the reservation block
+      BLOCK_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
+      FULL - Includes detailed topology view.
+  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 reservation block resource.
+    "count": 42, # Output only. [Output Only] The number of resources that are allocated in this
+        # reservation block.
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+    "healthInfo": { # Health information for the reservation block. # Output only. [Output Only] Health information for the reservation block.
+      "degradedSubBlockCount": 42, # The number of subBlocks that are degraded.
+      "healthStatus": "A String", # The health status of the reservation block.
+      "healthySubBlockCount": 42, # The number of subBlocks that are healthy.
+    },
+    "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "inUseCount": 42, # Output only. [Output Only] The number of instances that are currently in use on this
+        # reservation block.
+    "inUseHostCount": 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
+        # on the host, it is considered in use.
+    "kind": "compute#reservationBlock", # Output only. [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks.
+    "name": "A String", # Output only. [Output Only] The name of this reservation block generated by Google
+        # Compute Engine. The name must be 1-63 characters long, and comply with
+        # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
+    "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation block.
+      "block": "A String", # The hash of the capacity block within the cluster.
+      "cluster": "A String", # The cluster name of the reservation block.
+      "instances": [ # Output only. The detailed instances information for a given Block
+        { # The instances information for a given Block
+          "instanceId": "A String", # The InstanceId of the instance
+          "physicalHostTopology": { # The PhysicalHostTopology of the instance within a Block resource. # Output only. The PhysicalHostTopology of instances within a Block resource.
+            "host": "A String", # Host hash for a given instance
+            "subBlock": "A String", # Sub block hash for a given instance
+          },
+          "projectId": "A String", # Project where the instance lives
+        },
+      ],
+    },
+    "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Output only. [Output Only] Maintenance information for this reservation block.
+      "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+      "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+      "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have ongoing maintenance.
+      "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have pending maintenance.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+          # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+          # Domains). Not all VM Families will support this field.
+      "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+          #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+          #  Domains). Not all VM Families will support this field.
+      "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+    "reservationSubBlockCount": 42, # Output only. [Output Only] The number of reservation subBlocks associated with this
+        # reservation block.
+    "reservationSubBlockInUseCount": 42, # Output only. [Output Only] The number of in-use reservation subBlocks associated with
+        # this reservation block. If at least one VM is running on a subBlock, it is
+        # considered in-use.
+    "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 with the resource id.
+    "status": "A String", # Output only. [Output Only] Status of the reservation block.
+    "zone": "A String", # Output only. [Output Only] Zone in which the reservation block resides.
+  },
+}
+
+ +
+ getIamPolicy(project, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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).
+}
+
+ +
+ list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of reservation blocks under a single reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  reservation: string, The name of the reservation.
+Name should conform to RFC1035 or be a resource ID. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of reservation blocks under a single reservation.
+  "id": "A String", # Unique identifier for the resource; defined by the server.
+  "items": [ # A list of reservation block resources.
+    { # Represents a reservation block resource.
+      "count": 42, # Output only. [Output Only] The number of resources that are allocated in this
+          # reservation block.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+      "healthInfo": { # Health information for the reservation block. # Output only. [Output Only] Health information for the reservation block.
+        "degradedSubBlockCount": 42, # The number of subBlocks that are degraded.
+        "healthStatus": "A String", # The health status of the reservation block.
+        "healthySubBlockCount": 42, # The number of subBlocks that are healthy.
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "inUseCount": 42, # Output only. [Output Only] The number of instances that are currently in use on this
+          # reservation block.
+      "inUseHostCount": 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
+          # on the host, it is considered in use.
+      "kind": "compute#reservationBlock", # Output only. [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks.
+      "name": "A String", # Output only. [Output Only] The name of this reservation block generated by Google
+          # Compute Engine. The name must be 1-63 characters long, and comply with
+          # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
+      "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation block.
+        "block": "A String", # The hash of the capacity block within the cluster.
+        "cluster": "A String", # The cluster name of the reservation block.
+        "instances": [ # Output only. The detailed instances information for a given Block
+          { # The instances information for a given Block
+            "instanceId": "A String", # The InstanceId of the instance
+            "physicalHostTopology": { # The PhysicalHostTopology of the instance within a Block resource. # Output only. The PhysicalHostTopology of instances within a Block resource.
+              "host": "A String", # Host hash for a given instance
+              "subBlock": "A String", # Sub block hash for a given instance
+            },
+            "projectId": "A String", # Project where the instance lives
+          },
+        ],
+      },
+      "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Output only. [Output Only] Maintenance information for this reservation block.
+        "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+        "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+        "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+            # Describes number of hosts in the block that have ongoing maintenance.
+        "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+            # Describes number of hosts in the block that have pending maintenance.
+        "schedulingType": "A String", # The type of maintenance for the reservation.
+        "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+            # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+            # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+            # Domains). Not all VM Families will support this field.
+        "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+            #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+            #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+            #  Domains). Not all VM Families will support this field.
+        "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+          "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+          "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+              # This timestamp value is in RFC3339 text format.
+          "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+          "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+            "A String",
+          ],
+          "maintenanceStatus": "A String",
+          "type": "A String", # Defines the type of maintenance.
+          "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+              # This timestamp value is in RFC3339 text format.
+          "windowStartTime": "A String", # The current start time of the maintenance window.
+              # This timestamp value is in RFC3339 text format.
+        },
+      },
+      "reservationSubBlockCount": 42, # Output only. [Output Only] The number of reservation subBlocks associated with this
+          # reservation block.
+      "reservationSubBlockInUseCount": 42, # Output only. [Output Only] The number of in-use reservation subBlocks associated with
+          # this reservation block. If at least one VM is running on a subBlock, it is
+          # considered in-use.
+      "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 with the resource id.
+      "status": "A String", # Output only. [Output Only] Status of the reservation block.
+      "zone": "A String", # Output only. [Output Only] Zone in which the reservation block resides.
+    },
+  ],
+  "kind": "compute#reservationBlock", # Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks.
+  "nextPageToken": "A String", # 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", # Server-defined URL for this resource.
+  "warning": { # 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.
+
+
+ +
+ performMaintenance(project, zone, reservation, reservationBlock, body=None, requestId=None, x__xgafv=None) + 
Allows customers to perform maintenance on a reservation block
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  reservation: string, The name of the reservation.
+Name should conform to RFC1035 or be a resource ID. (required)
+  reservationBlock: string, The name of the reservation block.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "maintenanceScope": "A String", # Specifies if all, running or unused hosts are in scope for this request.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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 backwacd 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, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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_preview.reservationSlots.html b/docs/dyn/compute_preview.reservationSlots.html new file mode 100644 index 0000000000..d4de59b689 --- /dev/null +++ b/docs/dyn/compute_preview.reservationSlots.html @@ -0,0 +1,1316 @@ + + + +

Compute Engine API . reservationSlots

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, parentName, reservationSlot, x__xgafv=None)

+

Retrieves information about the specified reservation slot.

+

+ getHealth(project, zone, parentName, reservationSlot, requestId=None, x__xgafv=None)

+

Get health info on a reservation slot.

+

+ getVersion(project, zone, parentName, reservationSlot, body=None, requestId=None, x__xgafv=None)

+

Allows customers to get SBOM versions of a reservation slot.

+

+ list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of reservation slots under a single reservation.

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, zone, parentName, reservationSlot, body=None, updateMask=None, x__xgafv=None)

+

Update a reservation slot in the specified sub-block.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, parentName, reservationSlot, x__xgafv=None) + 
Retrieves information about the specified reservation slot.
+
+Args:
+  project: string, The project ID for this request. (required)
+  zone: string, The name of the zone for this request, formatted as RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block, formatted as
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} (required)
+  reservationSlot: string, The name of the reservation slot, formatted as RFC1035 or a resource ID
+number. (required)
+  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 reservation slot resource.
+    "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp, formatted asRFC3339 text.
+    "id": "A String", # Output only. [Output Only] The unique identifier for this resource. This identifier is
+        # defined by the server.
+    "kind": "compute#reservationSlot", # Output only. [Output Only] The type of resource. Alwayscompute#reservationSlot for reservation slots.
+    "name": "A String", # Output only. [Output Only] The name of the reservation slot.
+    "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation slot.
+      "block": "A String", # The unique identifier of the capacity block within the cluster.
+      "cluster": "A String", # The cluster name of the reservation sub-block.
+      "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+      "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+          # block.
+    },
+    "selfLink": "A String", # Output only. [Output Only] A server-defined fully-qualified URL for this resource.
+    "selfLinkWithId": "A String", # Output only. [Output Only] A server-defined URL for this resource with the resource ID.
+    "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share settings to create a shared slot. Set to empty
+        # to inherit the share settings from a parent resource.
+      "projectMap": { # A map of project id and project config. This is only valid when
+          # share_type's value is SPECIFIC_PROJECTS.
+        "a_key": { # Config for each project in the share settings.
+          "projectId": "A String", # The project ID, should be same as the key of this project config in the
+              # parent map.
+        },
+      },
+      "shareType": "A String", # Type of sharing for this shared-reservation
+    },
+    "state": "A String", # Output only. [Output Only] The state of the reservation slot.
+    "status": { # Output only. [Output Only] The status of the reservation slot.
+      "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation sub-block.
+        "block": "A String", # The unique identifier of the capacity block within the cluster.
+        "cluster": "A String", # The cluster name of the reservation sub-block.
+        "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+        "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+            # block.
+      },
+      "rdmaIpAddresses": [ # Output only. The RDMA IP address of the physical host.
+        "A String",
+      ],
+      "runningInstances": [ # Output only. The URIs of the instances currently running on this slot.
+        "A String",
+      ],
+    },
+    "zone": "A String", # Output only. [Output Only] The zone in which the reservation slot resides.
+  },
+}
+
+ +
+ getHealth(project, zone, parentName, reservationSlot, requestId=None, x__xgafv=None) + 
Get health info on a reservation slot.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation, parent block and parent sub-block. In
+the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} (required)
+  reservationSlot: string, The name of the reservation slot.
+Name should conform to RFC1035 or be a resource ID. (required)
+  requestId: string, An optional request ID to identify requests.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ getVersion(project, zone, parentName, reservationSlot, body=None, requestId=None, x__xgafv=None) + 
Allows customers to get SBOM versions of a reservation slot.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} (required)
+  reservationSlot: string, The name of the reservation slot.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sbomSelections": [ # The SBOM selection to return. Duplicate values in the list will be ignored.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of reservation slots under a single reservation.
+
+Args:
+  project: string, The project ID for this request. (required)
+  zone: string, The name of the zone for this request, formatted as RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block, formatted as
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of reservation slots within a single reservation.
+  "id": "A String", # The unique identifier for the resource; defined by the server.
+  "items": [ # A list of reservation slot resources.
+    { # Represents a reservation slot resource.
+      "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp, formatted asRFC3339 text.
+      "id": "A String", # Output only. [Output Only] The unique identifier for this resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reservationSlot", # Output only. [Output Only] The type of resource. Alwayscompute#reservationSlot for reservation slots.
+      "name": "A String", # Output only. [Output Only] The name of the reservation slot.
+      "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation slot.
+        "block": "A String", # The unique identifier of the capacity block within the cluster.
+        "cluster": "A String", # The cluster name of the reservation sub-block.
+        "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+        "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+            # block.
+      },
+      "selfLink": "A String", # Output only. [Output Only] A server-defined fully-qualified URL for this resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] A server-defined URL for this resource with the resource ID.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share settings to create a shared slot. Set to empty
+          # to inherit the share settings from a parent resource.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "state": "A String", # Output only. [Output Only] The state of the reservation slot.
+      "status": { # Output only. [Output Only] The status of the reservation slot.
+        "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation sub-block.
+          "block": "A String", # The unique identifier of the capacity block within the cluster.
+          "cluster": "A String", # The cluster name of the reservation sub-block.
+          "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+          "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+              # block.
+        },
+        "rdmaIpAddresses": [ # Output only. The RDMA IP address of the physical host.
+          "A String",
+        ],
+        "runningInstances": [ # Output only. The URIs of the instances currently running on this slot.
+          "A String",
+        ],
+      },
+      "zone": "A String", # Output only. [Output Only] The zone in which the reservation slot resides.
+    },
+  ],
+  "kind": "compute#reservationSlot", # The type of resource. Alwayscompute#reservationSlot for a list of reservation
+      # slots.
+  "nextPageToken": "A String", # 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", # The server-defined URL for this resource.
+  "warning": { # An 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.
+
+
+ +
+ update(project, zone, parentName, reservationSlot, body=None, updateMask=None, x__xgafv=None) + 
Update a reservation slot in the specified sub-block.
+
+Args:
+  project: string, The project ID for this request. (required)
+  zone: string, The name of the zone for this request, formatted as RFC1035. (required)
+  parentName: string, The name of the sub-block resource. (required)
+  reservationSlot: string, The name of the slot resource. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a reservation slot resource.
+  "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp, formatted asRFC3339 text.
+  "id": "A String", # Output only. [Output Only] The unique identifier for this resource. This identifier is
+      # defined by the server.
+  "kind": "compute#reservationSlot", # Output only. [Output Only] The type of resource. Alwayscompute#reservationSlot for reservation slots.
+  "name": "A String", # Output only. [Output Only] The name of the reservation slot.
+  "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation slot.
+    "block": "A String", # The unique identifier of the capacity block within the cluster.
+    "cluster": "A String", # The cluster name of the reservation sub-block.
+    "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+    "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+        # block.
+  },
+  "selfLink": "A String", # Output only. [Output Only] A server-defined fully-qualified URL for this resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] A server-defined URL for this resource with the resource ID.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share settings to create a shared slot. Set to empty
+      # to inherit the share settings from a parent resource.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "state": "A String", # Output only. [Output Only] The state of the reservation slot.
+  "status": { # Output only. [Output Only] The status of the reservation slot.
+    "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation sub-block.
+      "block": "A String", # The unique identifier of the capacity block within the cluster.
+      "cluster": "A String", # The cluster name of the reservation sub-block.
+      "host": "A String", # The unique identifier of the capacity host within the capacity sub-block.
+      "subBlock": "A String", # The unique identifier of the capacity sub-block within the capacity
+          # block.
+    },
+    "rdmaIpAddresses": [ # Output only. The RDMA IP address of the physical host.
+      "A String",
+    ],
+    "runningInstances": [ # Output only. The URIs of the instances currently running on this slot.
+      "A String",
+    ],
+  },
+  "zone": "A String", # Output only. [Output Only] The zone in which the reservation slot resides.
+}
+
+  updateMask: string, The fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.reservationSubBlocks.html b/docs/dyn/compute_preview.reservationSubBlocks.html new file mode 100644 index 0000000000..bae12ace51 --- /dev/null +++ b/docs/dyn/compute_preview.reservationSubBlocks.html @@ -0,0 +1,2670 @@ + + + +

Compute Engine API . reservationSubBlocks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, parentName, reservationSubBlock, view=None, x__xgafv=None)

+

Retrieves information about the specified reservation subBlock.

+

+ getIamPolicy(project, zone, parentResource, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ getVersion(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)

+

Allows customers to get SBOM versions of a reservation subBlock.

+

+ list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of reservation subBlocks under a single reservation.

+

+ list_next()

+

Retrieves the next page of results.

+

+ performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)

+

Allows customers to perform maintenance on a reservation subBlock

+

+ reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)

+

Allows customers to report a faulty subBlock.

+

+ setIamPolicy(project, zone, parentResource, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, zone, parentResource, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, parentName, reservationSubBlock, view=None, x__xgafv=None) + 
Retrieves information about the specified reservation subBlock.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
+  reservationSubBlock: string, The name of the reservation subBlock.
+Name should conform to RFC1035 or be a resource ID. (required)
+  view: string, View of the subBlock.
+    Allowed values
+      SUB_BLOCK_VIEW_BASIC - This view includes basic information about the reservation sub block
+      SUB_BLOCK_VIEW_FULL - Includes detailed topology view.
+      SUB_BLOCK_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
+  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 reservation subBlock resource.
+    "acceleratorTopologiesInfo": { # Info for accelerator topologies within a densely packed reservation. # Output only. [Output Only] Slice info for the reservation subBlock.
+      "acceleratorTopologyInfos": [ # Info for each accelerator topology.
+        { # Info for a slice of a given topology.
+          "acceleratorTopology": "A String", # The accelerator topology.
+          "infoPerTopologyStates": [ # Info for each topology state.
+            { # Info for each topology state.
+              "count": 42, # The number of accelerator topologies in this state.
+              "state": "A String", # The state of the accelerator topology.
+            },
+          ],
+        },
+      ],
+    },
+    "count": 42, # Output only. [Output Only] The number of hosts that are allocated in this
+        # reservation subBlock.
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+    "healthInfo": { # Health information for the reservation subBlock. # Output only. [Output Only] Health information for the reservation subBlock.
+      "degradedHostCount": 42, # The number of degraded hosts in the reservation subBlock.
+      "degradedInfraCount": 42, # The number of degraded infrastructure (e.g NV link domain) in the
+          # reservation subblock.
+      "healthStatus": "A String", # The health status of the reservation subBlock.
+      "healthyHostCount": 42, # The number of healthy hosts in the reservation subBlock.
+      "healthyInfraCount": 42, # The number of healthy infrastructure (e.g NV link domain) in the
+          # reservation subblock.
+    },
+    "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "inUseCount": 42, # Output only. [Output Only] The number of instances that are currently in use on this
+        # reservation subBlock.
+    "inUseHostCount": 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
+        # on the host, it is considered in use.
+    "kind": "compute#reservationSubBlock", # Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.
+    "name": "A String", # Output only. [Output Only] The name of this reservation subBlock generated by Google
+        # Compute Engine. The name must be 1-63 characters long, and comply with
+        # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
+    "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation subBlock.
+      "block": "A String", # The hash of the capacity block within the cluster.
+      "cluster": "A String", # The cluster name of the reservation subBlock.
+      "subBlock": "A String", # The hash of the capacity sub-block within the capacity block.
+    },
+    "reservationSubBlockMaintenance": { # Maintenance Info for ReservationBlocks. # Output only. Maintenance information for this reservation subBlock.
+      "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+      "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+      "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have ongoing maintenance.
+      "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have pending maintenance.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+          # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+          # Domains). Not all VM Families will support this field.
+      "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+          #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+          #  Domains). Not all VM Families will support this field.
+      "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+    "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 with the resource id.
+    "status": "A String", # Output only. [Output Only] Status of the reservation subBlock.
+    "zone": "A String", # Output only. [Output Only] Zone in which the reservation subBlock resides.
+  },
+}
+
+ +
+ getIamPolicy(project, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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).
+}
+
+ +
+ getVersion(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None) + 
Allows customers to get SBOM versions of a reservation subBlock.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
+  reservationSubBlock: string, The name of the reservation subBlock.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sbomSelections": [ # The SBOM selection to return.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of reservation subBlocks under a single reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of reservation subBlocks under a single reservation.
+  "id": "A String", # Unique identifier for the resource; defined by the server.
+  "items": [ # A list of reservation subBlock resources.
+    { # Represents a reservation subBlock resource.
+      "acceleratorTopologiesInfo": { # Info for accelerator topologies within a densely packed reservation. # Output only. [Output Only] Slice info for the reservation subBlock.
+        "acceleratorTopologyInfos": [ # Info for each accelerator topology.
+          { # Info for a slice of a given topology.
+            "acceleratorTopology": "A String", # The accelerator topology.
+            "infoPerTopologyStates": [ # Info for each topology state.
+              { # Info for each topology state.
+                "count": 42, # The number of accelerator topologies in this state.
+                "state": "A String", # The state of the accelerator topology.
+              },
+            ],
+          },
+        ],
+      },
+      "count": 42, # Output only. [Output Only] The number of hosts that are allocated in this
+          # reservation subBlock.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 text format.
+      "healthInfo": { # Health information for the reservation subBlock. # Output only. [Output Only] Health information for the reservation subBlock.
+        "degradedHostCount": 42, # The number of degraded hosts in the reservation subBlock.
+        "degradedInfraCount": 42, # The number of degraded infrastructure (e.g NV link domain) in the
+            # reservation subblock.
+        "healthStatus": "A String", # The health status of the reservation subBlock.
+        "healthyHostCount": 42, # The number of healthy hosts in the reservation subBlock.
+        "healthyInfraCount": 42, # The number of healthy infrastructure (e.g NV link domain) in the
+            # reservation subblock.
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "inUseCount": 42, # Output only. [Output Only] The number of instances that are currently in use on this
+          # reservation subBlock.
+      "inUseHostCount": 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
+          # on the host, it is considered in use.
+      "kind": "compute#reservationSubBlock", # Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.
+      "name": "A String", # Output only. [Output Only] The name of this reservation subBlock generated by Google
+          # Compute Engine. The name must be 1-63 characters long, and comply with
+          # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
+      "physicalTopology": { # Output only. [Output Only] The physical topology of the reservation subBlock.
+        "block": "A String", # The hash of the capacity block within the cluster.
+        "cluster": "A String", # The cluster name of the reservation subBlock.
+        "subBlock": "A String", # The hash of the capacity sub-block within the capacity block.
+      },
+      "reservationSubBlockMaintenance": { # Maintenance Info for ReservationBlocks. # Output only. Maintenance information for this reservation subBlock.
+        "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+        "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+        "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+            # Describes number of hosts in the block that have ongoing maintenance.
+        "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+            # Describes number of hosts in the block that have pending maintenance.
+        "schedulingType": "A String", # The type of maintenance for the reservation.
+        "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+            # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+            # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+            # Domains). Not all VM Families will support this field.
+        "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+            #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+            #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+            #  Domains). Not all VM Families will support this field.
+        "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+          "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+          "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+              # This timestamp value is in RFC3339 text format.
+          "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+          "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+            "A String",
+          ],
+          "maintenanceStatus": "A String",
+          "type": "A String", # Defines the type of maintenance.
+          "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+              # This timestamp value is in RFC3339 text format.
+          "windowStartTime": "A String", # The current start time of the maintenance window.
+              # This timestamp value is in RFC3339 text format.
+        },
+      },
+      "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 with the resource id.
+      "status": "A String", # Output only. [Output Only] Status of the reservation subBlock.
+      "zone": "A String", # Output only. [Output Only] Zone in which the reservation subBlock resides.
+    },
+  ],
+  "kind": "compute#reservationSubBlock", # Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation
+      # subBlocks.
+  "nextPageToken": "A String", # 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", # Server-defined URL for this resource.
+  "warning": { # 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.
+
+
+ +
+ performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None) + 
Allows customers to perform maintenance on a reservation subBlock
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
+  reservationSubBlock: string, The name of the reservation subBlock.
+Name should conform to RFC1035 or be a resource ID. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None) + 
Allows customers to report a faulty subBlock.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of
+reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
+  reservationSubBlock: string, The name of the reservation subBlock.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "disruptionSchedule": "A String", # The disruption schedule for the subBlock.
+  "failureComponent": "A String", # The component that experienced the fault.
+  "faultReasons": [ # The reasons for the fault experienced with the subBlock.
+    { # The reason for the fault experienced with the subBlock.
+      "behavior": "A String", # The behavior of the fault experienced with the subBlock.
+      "description": "A String", # The description of the fault experienced with the subBlock.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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 backwacd 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, zone, parentResource, 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)
+  zone: string, The name of the zone for this request. (required)
+  parentResource: string, Name or id of parent resource of the resource 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_preview.reservations.html b/docs/dyn/compute_preview.reservations.html new file mode 100644 index 0000000000..1097fae1d6 --- /dev/null +++ b/docs/dyn/compute_preview.reservations.html @@ -0,0 +1,4491 @@ + + + +

Compute Engine API . reservations

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of reservations.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, reservation, requestId=None, x__xgafv=None)

+

Deletes the specified reservation.

+

+ get(project, zone, reservation, x__xgafv=None)

+

Retrieves information about the specified reservation.

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a new reservation. For more information, readReserving zonal

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

A list of all the reservations that have been configured for the

+

+ list_next()

+

Retrieves the next page of results.

+

+ performMaintenance(project, zone, reservation, body=None, requestId=None, x__xgafv=None)

+

Perform maintenance on an extended reservation

+

+ resize(project, zone, reservation, body=None, requestId=None, x__xgafv=None)

+

Resizes the reservation (applicable to standalone reservations only). For

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, zone, reservation, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

+

Update share settings of the reservation.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of reservations.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 reservations.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of Allocation resources.
+    "a_key": { # Name of the scope containing this set of reservations.
+      "reservations": [ # A list of reservations contained in this scope.
+        { # Represents a reservation resource.  A reservation ensures that capacity is
+            # held in a specific zone even if the reserved VMs are not running. For more
+            # information, read  Reserving zonal
+            # resources.
+          "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+              # deployment type reservations.
+              # type reservations.
+            "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+          },
+          "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+              # count of CPUs) and can account for multiple instance SKUs. In other words,
+              # one can create instances of varying shapes against this reservation.
+            "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+              {
+                "accelerator": { # Properties of accelerator resources in this reservation.
+                  "acceleratorCount": 42, # Number of accelerators of specified type.
+                  "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                      # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+                },
+              },
+            ],
+            "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+                # belong to.
+            "workloadType": "A String", # The workload type of the instances that will target this reservation.
+          },
+          "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+              # displays for reservations that are tied to a commitment.
+          "confidentialComputeType": "A String",
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+              # automatically delete this resource.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+              #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+          "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+              # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+              # enrolled in early access maintenance and the standard notice applies.
+          "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+              # for example, to fix hardware errors.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+          "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+              # displays for reservations that are tied to multiple commitments.
+            "A String",
+          ],
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "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).
+          "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+              # will not be shared with Google Cloud managed services.
+            "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+          },
+          "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+              # resource. It is populated for each instance of the Allocation
+              # resource, and includes the api_version the
+              # instance was retrieved through, and its canonical
+              # resource_type name.
+            "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+                # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+            "resourceType": "A String", # The canonical resource type name in the format of a resource type
+                # as defined by [AIP-123](https://google.aip.dev/123).
+                # For example, `"compute.googleapis.com/Instance"`.
+          },
+          "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+              # user, and the value is resource policy url. This is to define placement
+              # policy with reservation.
+            "a_key": "A String",
+          },
+          "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+            "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+              "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+              "healthStatus": "A String", # The health status of the reservation.
+              "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+            },
+            "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+            "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+              "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+              "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+              "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                  # Describes number of hosts in the block that have ongoing maintenance.
+              "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+                  # Describes number of hosts in the block that have pending maintenance.
+              "schedulingType": "A String", # The type of maintenance for the reservation.
+              "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+                  # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                  # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+                  # Domains). Not all VM Families will support this field.
+              "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+                  #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+                  #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+                  #  Domains). Not all VM Families will support this field.
+              "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+                "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+                "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                    # This timestamp value is in RFC3339 text format.
+                "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+                "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+                  "A String",
+                ],
+                "maintenanceStatus": "A String",
+                "type": "A String", # Defines the type of maintenance.
+                "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                    # This timestamp value is in RFC3339 text format.
+                "windowStartTime": "A String", # The current start time of the maintenance window.
+                    # This timestamp value is in RFC3339 text format.
+              },
+            },
+            "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+              "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+              "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+                  # service name.
+                "a_key": "A String",
+              },
+            },
+          },
+          "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+          "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+              # optional. For more information about the syntax and options for this
+              # field and its subfields, see the guide for creating
+              # a shared reservation.
+            "projectMap": { # A map of project id and project config. This is only valid when
+                # share_type's value is SPECIFIC_PROJECTS.
+              "a_key": { # Config for each project in the share settings.
+                "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                    # parent map.
+              },
+            },
+            "shareType": "A String", # Type of sharing for this shared-reservation
+          },
+          "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+              #  configuration.
+            "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+            "count": "A String", # Specifies the number of resources that are allocated.
+            "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+            "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+                # Next ID: 10
+              "guestAccelerators": [ # Specifies accelerator type and count.
+                { # A specification of the type and number of accelerator cards attached to the
+                    # instance.
+                  "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+                  "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                      # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                      # If you are creating an instance template, specify only the
+                      # accelerator name.
+                      # See GPUs on Compute Engine
+                      # for a full list of accelerator types.
+                },
+              ],
+              "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+                  # of disk is local-ssd.
+                {
+                  "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+                  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                      # either SCSI or NVME. The default isSCSI.
+                      # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+                },
+              ],
+              "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+                  # resources.
+                  # This field is for use by internal tools that use the public API.
+              "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+                  # and fixed amount of memory. This also includes specifying custom
+                  # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+              "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+            },
+            "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+                # this field, you must exclude the instanceProperties field.
+                #
+                # This field is optional, and it can be a full or partial URL. For example,
+                # the following are all valid URLs to an instance template:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+                #       - projects/project/global/instanceTemplates/instanceTemplate
+                #       - global/instanceTemplates/instanceTemplate
+          },
+          "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+              # for "any" reservation. If the field is set, then only VMs that target
+              # the reservation by name can consume from this reservation.
+          "status": "A String", # Output only. [Output Only] The status of the reservation.
+              #
+              #
+              #      - CREATING: Reservation resources are being
+              #        allocated.
+              #      - READY: Reservation resources have been allocated,
+              #        and the reservation is ready for use.
+              #      - DELETING: Reservation deletion is in progress.
+              #      - UPDATING: Reservation update is in progress.
+          "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+              # reservation is created within a commitment.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of reservations 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#reservationAggregatedList", # 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, zone, reservation, requestId=None, x__xgafv=None) + 
Deletes the specified reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  reservation: string, Name of the reservation 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, reservation, x__xgafv=None) + 
Retrieves information about the specified reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  reservation: string, Name of the reservation to retrieve. (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 reservation resource.  A reservation ensures that capacity is
+    # held in a specific zone even if the reserved VMs are not running. For more
+    # information, read  Reserving zonal
+    # resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+      # deployment type reservations.
+      # type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+      # displays for reservations that are tied to a commitment.
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+      # automatically delete this resource.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+      #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+  "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+      # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+      # enrolled in early access maintenance and the standard notice applies.
+  "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+      # for example, to fix hardware errors.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+  "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+      # displays for reservations that are tied to multiple commitments.
+    "A String",
+  ],
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "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).
+  "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+      # will not be shared with Google Cloud managed services.
+    "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+  },
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+      # resource. It is populated for each instance of the Allocation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+      # user, and the value is resource policy url. This is to define placement
+      # policy with reservation.
+    "a_key": "A String",
+  },
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+    "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+      "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+      "healthStatus": "A String", # The health status of the reservation.
+      "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+    },
+    "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+    "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+      "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+      "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+      "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have ongoing maintenance.
+      "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have pending maintenance.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+          # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+          # Domains). Not all VM Families will support this field.
+      "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+          #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+          #  Domains). Not all VM Families will support this field.
+      "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+    "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+      "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+          # service name.
+        "a_key": "A String",
+      },
+    },
+  },
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "schedulingType": "A String", # The type of maintenance for the reservation.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+      # optional. For more information about the syntax and options for this
+      # field and its subfields, see the guide for creating
+      # a shared reservation.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+      #  configuration.
+    "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+    "count": "A String", # Specifies the number of resources that are allocated.
+    "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+        # this field, you must exclude the instanceProperties field.
+        #
+        # This field is optional, and it can be a full or partial URL. For example,
+        # the following are all valid URLs to an instance template:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+        #       - projects/project/global/instanceTemplates/instanceTemplate
+        #       - global/instanceTemplates/instanceTemplate
+  },
+  "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+      # for "any" reservation. If the field is set, then only VMs that target
+      # the reservation by name can consume from this reservation.
+  "status": "A String", # Output only. [Output Only] The status of the reservation.
+      #
+      #
+      #      - CREATING: Reservation resources are being
+      #        allocated.
+      #      - READY: Reservation resources have been allocated,
+      #        and the reservation is ready for use.
+      #      - DELETING: Reservation deletion is in progress.
+      #      - UPDATING: Reservation update is in progress.
+  "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+      # reservation is created within a commitment.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a new reservation. For more information, readReserving zonal
+resources.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a reservation resource.  A reservation ensures that capacity is
+    # held in a specific zone even if the reserved VMs are not running. For more
+    # information, read  Reserving zonal
+    # resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+      # deployment type reservations.
+      # type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+      # displays for reservations that are tied to a commitment.
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+      # automatically delete this resource.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+      #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+  "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+      # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+      # enrolled in early access maintenance and the standard notice applies.
+  "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+      # for example, to fix hardware errors.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+  "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+      # displays for reservations that are tied to multiple commitments.
+    "A String",
+  ],
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "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).
+  "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+      # will not be shared with Google Cloud managed services.
+    "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+  },
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+      # resource. It is populated for each instance of the Allocation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+      # user, and the value is resource policy url. This is to define placement
+      # policy with reservation.
+    "a_key": "A String",
+  },
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+    "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+      "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+      "healthStatus": "A String", # The health status of the reservation.
+      "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+    },
+    "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+    "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+      "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+      "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+      "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have ongoing maintenance.
+      "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have pending maintenance.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+          # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+          # Domains). Not all VM Families will support this field.
+      "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+          #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+          #  Domains). Not all VM Families will support this field.
+      "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+    "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+      "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+          # service name.
+        "a_key": "A String",
+      },
+    },
+  },
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "schedulingType": "A String", # The type of maintenance for the reservation.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+      # optional. For more information about the syntax and options for this
+      # field and its subfields, see the guide for creating
+      # a shared reservation.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+      #  configuration.
+    "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+    "count": "A String", # Specifies the number of resources that are allocated.
+    "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+        # this field, you must exclude the instanceProperties field.
+        #
+        # This field is optional, and it can be a full or partial URL. For example,
+        # the following are all valid URLs to an instance template:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+        #       - projects/project/global/instanceTemplates/instanceTemplate
+        #       - global/instanceTemplates/instanceTemplate
+  },
+  "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+      # for "any" reservation. If the field is set, then only VMs that target
+      # the reservation by name can consume from this reservation.
+  "status": "A String", # Output only. [Output Only] The status of the reservation.
+      # 
+      # 
+      #      - CREATING: Reservation resources are being
+      #        allocated.
+      #      - READY: Reservation resources have been allocated,
+      #        and the reservation is ready for use.
+      #      - DELETING: Reservation deletion is in progress.
+      #      - UPDATING: Reservation update is in progress.
+  "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+      # reservation is created within a commitment.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
A list of all the reservations that have been configured for the
+specified project in specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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.
+  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] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of Allocation resources.
+    { # Represents a reservation resource.  A reservation ensures that capacity is
+        # held in a specific zone even if the reserved VMs are not running. For more
+        # information, read  Reserving zonal
+        # resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+          # deployment type reservations.
+          # type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
+      "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+          # count of CPUs) and can account for multiple instance SKUs. In other words,
+          # one can create instances of varying shapes against this reservation.
+        "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+          {
+            "accelerator": { # Properties of accelerator resources in this reservation.
+              "acceleratorCount": 42, # Number of accelerators of specified type.
+              "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+                  # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+            },
+          },
+        ],
+        "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+            # belong to.
+        "workloadType": "A String", # The workload type of the instances that will target this reservation.
+      },
+      "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+          # displays for reservations that are tied to a commitment.
+      "confidentialComputeType": "A String",
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+          # automatically delete this resource.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+          #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+      "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+          # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+          # enrolled in early access maintenance and the standard notice applies.
+      "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+          # for example, to fix hardware errors.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+      "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+          # displays for reservations that are tied to multiple commitments.
+        "A String",
+      ],
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "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).
+      "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+          # will not be shared with Google Cloud managed services.
+        "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+      },
+      "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+          # resource. It is populated for each instance of the Allocation
+          # resource, and includes the api_version the
+          # instance was retrieved through, and its canonical
+          # resource_type name.
+        "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+            # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+        "resourceType": "A String", # The canonical resource type name in the format of a resource type
+            # as defined by [AIP-123](https://google.aip.dev/123).
+            # For example, `"compute.googleapis.com/Instance"`.
+      },
+      "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+          # user, and the value is resource policy url. This is to define placement
+          # policy with reservation.
+        "a_key": "A String",
+      },
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+        "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+          "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+          "healthStatus": "A String", # The health status of the reservation.
+          "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+        },
+        "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+        "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+          "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+          "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+          "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have ongoing maintenance.
+          "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+              # Describes number of hosts in the block that have pending maintenance.
+          "schedulingType": "A String", # The type of maintenance for the reservation.
+          "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+              # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+              # Domains). Not all VM Families will support this field.
+          "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+              #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+              #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+              #  Domains). Not all VM Families will support this field.
+          "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+            "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+            "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+                # This timestamp value is in RFC3339 text format.
+            "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+            "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+              "A String",
+            ],
+            "maintenanceStatus": "A String",
+            "type": "A String", # Defines the type of maintenance.
+            "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+                # This timestamp value is in RFC3339 text format.
+            "windowStartTime": "A String", # The current start time of the maintenance window.
+                # This timestamp value is in RFC3339 text format.
+          },
+        },
+        "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+          "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+          "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+              # service name.
+            "a_key": "A String",
+          },
+        },
+      },
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+          # optional. For more information about the syntax and options for this
+          # field and its subfields, see the guide for creating
+          # a shared reservation.
+        "projectMap": { # A map of project id and project config. This is only valid when
+            # share_type's value is SPECIFIC_PROJECTS.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+        "shareType": "A String", # Type of sharing for this shared-reservation
+      },
+      "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+          #  configuration.
+        "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+        "count": "A String", # Specifies the number of resources that are allocated.
+        "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+        "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+            # Next ID: 10
+          "guestAccelerators": [ # Specifies accelerator type and count.
+            { # A specification of the type and number of accelerator cards attached to the
+                # instance.
+              "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+              "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+                  # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+                  # If you are creating an instance template, specify only the
+                  # accelerator name.
+                  # See GPUs on Compute Engine
+                  # for a full list of accelerator types.
+            },
+          ],
+          "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+              # of disk is local-ssd.
+            {
+              "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+              "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+                  # either SCSI or NVME. The default isSCSI.
+                  # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+            },
+          ],
+          "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+              # resources.
+              # This field is for use by internal tools that use the public API.
+          "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+              # and fixed amount of memory. This also includes specifying custom
+              # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+          "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+        },
+        "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+            # this field, you must exclude the instanceProperties field.
+            #
+            # This field is optional, and it can be a full or partial URL. For example,
+            # the following are all valid URLs to an instance template:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+            #       - projects/project/global/instanceTemplates/instanceTemplate
+            #       - global/instanceTemplates/instanceTemplate
+      },
+      "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+          # for "any" reservation. If the field is set, then only VMs that target
+          # the reservation by name can consume from this reservation.
+      "status": "A String", # Output only. [Output Only] The status of the reservation.
+          #
+          #
+          #      - CREATING: Reservation resources are being
+          #        allocated.
+          #      - READY: Reservation resources have been allocated,
+          #        and the reservation is ready for use.
+          #      - DELETING: Reservation deletion is in progress.
+          #      - UPDATING: Reservation update is in progress.
+      "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+          # reservation is created within a commitment.
+    },
+  ],
+  "kind": "compute#reservationList", # Output only. [Output Only] Type of resource.Always compute#reservationsList
+      # for listsof reservations
+  "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.
+  "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.
+
+
+ +
+ performMaintenance(project, zone, reservation, body=None, requestId=None, x__xgafv=None) + 
Perform maintenance on an extended reservation
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  reservation: string, The name of the reservation.
+Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "maintenanceScope": "A String", # Specifies if all, running or unused hosts are in scope for this request.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resize(project, zone, reservation, body=None, requestId=None, x__xgafv=None) + 
Resizes the reservation (applicable to standalone reservations only). For
+more information, readModifying
+reservations.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  reservation: string, Name of the reservation to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "specificSkuCount": "A String", # Number of allocated resources can be resized with minimum = 1 and
+      # maximum = 1000.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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, zone, 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)
+  zone: string, The name of the zone 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, zone, reservation, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None) + 
Update share settings of the reservation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  reservation: string, Name of the reservation to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a reservation resource.  A reservation ensures that capacity is
+    # held in a specific zone even if the reserved VMs are not running. For more
+    # information, read  Reserving zonal
+    # resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment # Advanced control for cluster management, applicable only to DENSE
+      # deployment type reservations.
+      # type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
+  "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Reservation for aggregated resources, providing shape flexibility.
+      # count of CPUs) and can account for multiple instance SKUs. In other words,
+      # one can create instances of varying shapes against this reservation.
+    "inUseResources": [ # Output only. [Output only] List of resources currently in use.
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators).
+      {
+        "accelerator": { # Properties of accelerator resources in this reservation.
+          "acceleratorCount": 42, # Number of accelerators of specified type.
+          "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g.
+              # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"
+        },
+      },
+    ],
+    "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must
+        # belong to.
+    "workloadType": "A String", # The workload type of the instances that will target this reservation.
+  },
+  "commitment": "A String", # Output only. [Output Only] Full or partial URL to a parent commitment. This field
+      # displays for reservations that are tied to a commitment.
+  "confidentialComputeType": "A String",
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deleteAfterDuration": { # A Duration represents a fixed-length span of time represented # Duration time relative to reservation creation when Compute Engine will
+      # automatically delete this resource.
+      # as a count of seconds and fractions of seconds at nanosecond
+      # resolution. It is independent of any calendar and concepts like "day"
+      # or "month". Range is approximately 10,000 years.
+    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+        # Durations less than one second are represented with a 0
+        # `seconds` field and a positive `nanos` field. Must be from 0
+        # to 999,999,999 inclusive.
+    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+        # 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
+  },
+  "deleteAtTime": "A String", # Absolute time in future when the reservation will be
+      #  auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.
+  "deploymentType": "A String", # Specifies the deployment strategy for this reservation.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "earlyAccessMaintenance": "A String", # Indicates the early access maintenance for the reservation.
+      # If this field is absent or set to NO_EARLY_ACCESS, the reservation is not
+      # enrolled in early access maintenance and the standard notice applies.
+  "enableEmergentMaintenance": True or False, # Indicates whether Compute Engine allows unplanned maintenance for your VMs;
+      # for example, to fix hardware errors.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#reservation", # Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.
+  "linkedCommitments": [ # Output only. [Output Only] Full or partial URL to parent commitments. This field
+      # displays for reservations that are tied to multiple commitments.
+    "A String",
+  ],
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "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).
+  "reservationSharingPolicy": { # Specify the reservation sharing policy. If unspecified, the reservation
+      # will not be shared with Google Cloud managed services.
+    "serviceShareType": "A String", # Sharing config for all Google Cloud services.
+  },
+  "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. [Output Only] Contains standard resource metadata for an Allocation
+      # resource. It is populated for each instance of the Allocation
+      # resource, and includes the api_version the
+      # instance was retrieved through, and its canonical
+      # resource_type name.
+    "apiVersion": "A String", # The version of the API interface that this resource was retrieved through.
+        # For example, `"2025-01-01"` or `"2025-01-01-preview"`.
+    "resourceType": "A String", # The canonical resource type name in the format of a resource type
+        # as defined by [AIP-123](https://google.aip.dev/123).
+        # For example, `"compute.googleapis.com/Instance"`.
+  },
+  "resourcePolicies": { # Resource policies to be added to this reservation. The key is defined by
+      # user, and the value is resource policy url. This is to define placement
+      # policy with reservation.
+    "a_key": "A String",
+  },
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for Reservation resource.
+    "healthInfo": { # Health information for the reservation. # [Output only] Health information for the reservation.
+      "degradedBlockCount": 42, # The number of reservation blocks that are degraded.
+      "healthStatus": "A String", # The health status of the reservation.
+      "healthyBlockCount": 42, # The number of reservation blocks that are healthy.
+    },
+    "reservationBlockCount": 42, # The number of reservation blocks associated with this reservation.
+    "reservationMaintenance": { # Maintenance Info for ReservationBlocks. # Maintenance information for this reservation
+      "instanceMaintenanceOngoingCount": 42, # Describes number of instances that have ongoing maintenance.
+      "instanceMaintenancePendingCount": 42, # Describes number of instances that have pending maintenance.
+      "maintenanceOngoingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have ongoing maintenance.
+      "maintenancePendingCount": 42, # Progress for ongoing maintenance for this group of VMs/hosts.
+          # Describes number of hosts in the block that have pending maintenance.
+      "schedulingType": "A String", # The type of maintenance for the reservation.
+      "subblockInfraMaintenanceOngoingCount": 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
+          # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
+          # Domains). Not all VM Families will support this field.
+      "subblockInfraMaintenancePendingCount": 42, # Describes number of subblock Infrastructure that has pending maintenance.
+          #  Here, Subblock Infrastructure Maintenance pertains to upstream hardware
+          #  contained in the Subblock that is necessary for a VM Family (e.g. NVLink
+          #  Domains). Not all VM Families will support this field.
+      "upcomingGroupMaintenance": { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
+        "canReschedule": True or False, # Indicates if the maintenance can be customer triggered.
+        "latestWindowStartTime": "A String", # The latest time for the planned maintenance window to start.
+            # This timestamp value is in RFC3339 text format.
+        "maintenanceOnShutdown": True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
+        "maintenanceReasons": [ # The reasons for the maintenance. Only valid for vms.
+          "A String",
+        ],
+        "maintenanceStatus": "A String",
+        "type": "A String", # Defines the type of maintenance.
+        "windowEndTime": "A String", # The time by which the maintenance disruption will be completed.
+            # This timestamp value is in RFC3339 text format.
+        "windowStartTime": "A String", # The current start time of the maintenance window.
+            # This timestamp value is in RFC3339 text format.
+      },
+    },
+    "specificSkuAllocation": { # Contains Properties set for the reservation. # Allocation Properties of this reservation.
+      "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate reservation properties.
+      "utilizations": { # Per service utilization breakdown. The Key is the Google Cloud managed
+          # service name.
+        "a_key": "A String",
+      },
+    },
+  },
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "schedulingType": "A String", # The type of maintenance for the reservation.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Specify share-settings to create a shared reservation. This property is
+      # optional. For more information about the syntax and options for this
+      # field and its subfields, see the guide for creating
+      # a shared reservation.
+    "projectMap": { # A map of project id and project config. This is only valid when
+        # share_type's value is SPECIFIC_PROJECTS.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+    "shareType": "A String", # Type of sharing for this shared-reservation
+  },
+  "specificReservation": { # This reservation type allows to pre allocate specific instance # Reservation for instances with specific machine shapes.
+      #  configuration.
+    "assuredCount": "A String", # Output only. [Output Only] Indicates how many instances are actually usable currently.
+    "count": "A String", # Specifies the number of resources that are allocated.
+    "inUseCount": "A String", # Output only. [Output Only] Indicates how many instances are in use.
+    "instanceProperties": { # Properties of the SKU instances being reserved. # The instance properties for the reservation.
+        # Next ID: 10
+      "guestAccelerators": [ # Specifies accelerator type and count.
+        { # A specification of the type and number of accelerator cards attached to the
+            # instance.
+          "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance.
+          "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this
+              # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
+              # If you are creating an instance template, specify only the
+              # accelerator name.
+              # See GPUs on Compute Engine
+              # for a full list of accelerator types.
+        },
+      ],
+      "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type
+          # of disk is local-ssd.
+        {
+          "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is
+              # either SCSI or NVME. The default isSCSI.
+              # For performance characteristics of SCSI over NVMe, seeLocal SSD performance.
+        },
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the allocation close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs
+          # and fixed amount of memory. This also includes specifying custom
+          # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
+      "minCpuPlatform": "A String", # Minimum cpu platform the reservation.
+    },
+    "sourceInstanceTemplate": "A String", # Specifies the instance template to create the reservation. If you use
+        # this field, you must exclude the instanceProperties field.
+        #
+        # This field is optional, and it can be a full or partial URL. For example,
+        # the following are all valid URLs to an instance template:
+        #
+        #
+        #       - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
+        #       - projects/project/global/instanceTemplates/instanceTemplate
+        #       - global/instanceTemplates/instanceTemplate
+  },
+  "specificReservationRequired": True or False, # Indicates whether the reservation can be consumed by VMs with affinity
+      # for "any" reservation. If the field is set, then only VMs that target
+      # the reservation by name can consume from this reservation.
+  "status": "A String", # Output only. [Output Only] The status of the reservation.
+      # 
+      # 
+      #      - CREATING: Reservation resources are being
+      #        allocated.
+      #      - READY: Reservation resources have been allocated,
+      #        and the reservation is ready for use.
+      #      - DELETING: Reservation deletion is in progress.
+      #      - UPDATING: Reservation update is in progress.
+  "zone": "A String", # Zone in which the reservation resides. A zone must be provided if the
+      # reservation is created within a commitment.
+}
+
+  paths: string, A parameter (repeated)
+  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).
+  updateMask: string, Update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.resourcePolicies.html b/docs/dyn/compute_preview.resourcePolicies.html new file mode 100644 index 0000000000..97529bb8a9 --- /dev/null +++ b/docs/dyn/compute_preview.resourcePolicies.html @@ -0,0 +1,3328 @@ + + + +

Compute Engine API . resourcePolicies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of resource policies.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, resourcePolicy, requestId=None, x__xgafv=None)

+

Deletes the specified resource policy.

+

+ get(project, region, resourcePolicy, x__xgafv=None)

+

Retrieves all information of the specified resource policy.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a new resource policy.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

A list all the resource policies that have been configured for the

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, resourcePolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Modify the specified resource policy.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of resource policies.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 resourcePolicies.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of ResourcePolicy resources.
+    "a_key": { # Name of the scope containing this set of resourcePolicies.
+      "resourcePolicies": [ # A list of resourcePolicies contained in this scope.
+        { # Represents a Resource Policy resource. You can use resource policies to
+            # schedule actions for some Compute Engine resources. For example, you can
+            # use them toschedule persistent disk
+            # snapshots.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "description": "A String",
+          "diskConsistencyGroupPolicy": { # Resource policy for disk consistency groups. # Resource policy for disk consistency groups.
+          },
+          "groupPlacementPolicy": { # A GroupPlacementPolicy specifies resource placement configuration. # Resource policy for instances for placement configuration.
+              # It specifies the failure bucket separation
+            "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+                # specified, the default is AUTO_CONNECT.
+            "availabilityDomainCount": 42, # The number of availability domains to spread instances across. If two
+                # instances are in different availability domain, they are not in the same
+                # low latency network.
+            "collocation": "A String", # Specifies network collocation
+            "gpuTopology": "A String", # Specifies the shape of the GPU slice, in slice based GPU families eg.
+                # A4X.
+            "vmCount": 42, # Number of VMs in this placement group. Google does not recommend that you
+                # use this field unless you use a compact policy and you want your policy
+                # to work only if it contains this exact number of VMs.
+          },
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instanceSchedulePolicy": { # An InstanceSchedulePolicy specifies when and how frequent certain # Resource policy for scheduling instance operations.
+              # operations are performed on the instance.
+            "expirationTime": "A String", # The expiration time of the schedule. The timestamp is an RFC3339 string.
+            "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 string.
+            "timeZone": "A String", # Specifies the time zone to be used in interpreting Schedule.schedule.
+                # The value of this field must be a time zone name from the tz database:
+                # https://wikipedia.org/wiki/Tz_database.
+            "vmStartSchedule": { # Schedule for an instance operation. # Specifies the schedule for starting instances.
+              "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+            },
+            "vmStopSchedule": { # Schedule for an instance operation. # Specifies the schedule for stopping instances.
+              "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+            },
+          },
+          "kind": "compute#resourcePolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. The resource 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.
+          "region": "A String",
+          "resourceStatus": { # Contains output only fields. # Output only. [Output Only] The system status of the resource policy.
+              # Use this sub-message for all output fields set on ResourcePolicy.
+              # The internal structure of this "status" field should mimic the structure
+              # of ResourcePolicy proto specification.
+            "instanceSchedulePolicy": { # Output only. [Output Only] Specifies a set of output values reffering to
+                # the instance_schedule_policy system status.
+                # This field should have the same name as corresponding policy field.
+              "lastRunStartTime": "A String", # Output only. [Output Only] The last time the schedule successfully ran.
+                  # The timestamp is an RFC3339 string.
+              "nextRunStartTime": "A String", # Output only. [Output Only] The next time the schedule is planned to run.
+                  # The actual time might be slightly different.
+                  # The timestamp is an RFC3339 string.
+            },
+          },
+          "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+          "snapshotSchedulePolicy": { # A snapshot schedule policy specifies when and how frequently snapshots are # Resource policy for persistent disks for creating snapshots.
+              # to be created for the target disk. Also specifies how many and how long
+              # these scheduled snapshots should be retained.
+            "retentionPolicy": { # Policy for retention of scheduled snapshots. # Retention policy applied to snapshots created by this resource policy.
+              "maxRetentionDays": 42, # Maximum age of the snapshot that is allowed to be kept.
+              "onSourceDiskDelete": "A String", # Specifies the behavior to apply to scheduled snapshots when
+                  # the source disk is deleted.
+            },
+            "schedule": { # A schedule for disks where the schedueled operations are performed. # A Vm Maintenance Policy specifies what kind of infrastructure
+                # maintenance we are allowed to perform on this VM and when. Schedule
+                # that is applied to disks covered by this policy.
+              "dailySchedule": { # Time window specified for daily operations.
+                "daysInCycle": 42, # Defines a schedule with units measured in days. The value determines
+                    # how many days pass between the start of each cycle.
+                "duration": "A String", # Output only. [Output only] A predetermined duration for the window, automatically
+                    # chosen to be the smallest possible in the given scenario.
+                "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+                    # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+                    # example, both 13:00-5 and 08:00 are valid.
+              },
+              "hourlySchedule": { # Time window specified for hourly operations.
+                "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                    # smallest possible in the given scenario.
+                "hoursInCycle": 42, # Defines a schedule with units measured in hours. The value determines
+                    # how many hours pass between the start of each cycle.
+                "startTime": "A String", # Time within the window to start the operations.
+                    # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+              },
+              "weeklySchedule": { # Time window specified for weekly operations.
+                "dayOfWeeks": [ # Up to 7 intervals/windows, one for each day of the week.
+                  {
+                    "day": "A String", # Defines a schedule that runs on specific days of the week. Specify
+                        # one or more days. The following options are available:
+                        # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
+                    "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                        # smallest possible in the given scenario.
+                    "startTime": "A String", # Time within the window to start the operations.
+                        # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+                  },
+                ],
+              },
+            },
+            "snapshotProperties": { # Specified snapshot properties for scheduled snapshots created by this # Properties with which snapshots are created such as labels, encryption
+                # keys.
+                # policy.
+              "chainName": "A String", # Chain name that the snapshot is created in.
+              "guestFlush": True or False, # Indication to perform a 'guest aware' snapshot.
+              "labels": { # Labels to apply to scheduled snapshots. These can be later modified
+                  # by the setLabels method. Label values may be empty.
+                "a_key": "A String",
+              },
+              "storageLocations": [ # Cloud Storage bucket storage location of the auto snapshot (regional or
+                  # multi-regional).
+                "A String",
+              ],
+            },
+          },
+          "status": "A String", # Output only. [Output Only] The status of resource policy creation.
+          "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+            "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have
+                # interconnected GPUs.
+            "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+                # specified, the default is AUTO_CONNECT.
+            "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+            "type": "A String", # Specifies the intent of the instance placement in the MIG.
+          },
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of resourcePolicies 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#resourcePolicyAggregatedList", # 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, resourcePolicy, requestId=None, x__xgafv=None) + 
Deletes the specified resource policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  resourcePolicy: string, Name of the resource policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, resourcePolicy, x__xgafv=None) + 
Retrieves all information of the specified resource policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  resourcePolicy: string, Name of the resource policy to retrieve. (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 Resource Policy resource. You can use resource policies to
+    # schedule actions for some Compute Engine resources. For example, you can
+    # use them toschedule persistent disk
+    # snapshots.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String",
+  "diskConsistencyGroupPolicy": { # Resource policy for disk consistency groups. # Resource policy for disk consistency groups.
+  },
+  "groupPlacementPolicy": { # A GroupPlacementPolicy specifies resource placement configuration. # Resource policy for instances for placement configuration.
+      # It specifies the failure bucket separation
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "availabilityDomainCount": 42, # The number of availability domains to spread instances across. If two
+        # instances are in different availability domain, they are not in the same
+        # low latency network.
+    "collocation": "A String", # Specifies network collocation
+    "gpuTopology": "A String", # Specifies the shape of the GPU slice, in slice based GPU families eg.
+        # A4X.
+    "vmCount": 42, # Number of VMs in this placement group. Google does not recommend that you
+        # use this field unless you use a compact policy and you want your policy
+        # to work only if it contains this exact number of VMs.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSchedulePolicy": { # An InstanceSchedulePolicy specifies when and how frequent certain # Resource policy for scheduling instance operations.
+      # operations are performed on the instance.
+    "expirationTime": "A String", # The expiration time of the schedule. The timestamp is an RFC3339 string.
+    "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 string.
+    "timeZone": "A String", # Specifies the time zone to be used in interpreting Schedule.schedule.
+        # The value of this field must be a time zone name from the tz database:
+        # https://wikipedia.org/wiki/Tz_database.
+    "vmStartSchedule": { # Schedule for an instance operation. # Specifies the schedule for starting instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+    "vmStopSchedule": { # Schedule for an instance operation. # Specifies the schedule for stopping instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+  },
+  "kind": "compute#resourcePolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "region": "A String",
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] The system status of the resource policy.
+      # Use this sub-message for all output fields set on ResourcePolicy.
+      # The internal structure of this "status" field should mimic the structure
+      # of ResourcePolicy proto specification.
+    "instanceSchedulePolicy": { # Output only. [Output Only] Specifies a set of output values reffering to
+        # the instance_schedule_policy system status.
+        # This field should have the same name as corresponding policy field.
+      "lastRunStartTime": "A String", # Output only. [Output Only] The last time the schedule successfully ran.
+          # The timestamp is an RFC3339 string.
+      "nextRunStartTime": "A String", # Output only. [Output Only] The next time the schedule is planned to run.
+          # The actual time might be slightly different.
+          # The timestamp is an RFC3339 string.
+    },
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "snapshotSchedulePolicy": { # A snapshot schedule policy specifies when and how frequently snapshots are # Resource policy for persistent disks for creating snapshots.
+      # to be created for the target disk. Also specifies how many and how long
+      # these scheduled snapshots should be retained.
+    "retentionPolicy": { # Policy for retention of scheduled snapshots. # Retention policy applied to snapshots created by this resource policy.
+      "maxRetentionDays": 42, # Maximum age of the snapshot that is allowed to be kept.
+      "onSourceDiskDelete": "A String", # Specifies the behavior to apply to scheduled snapshots when
+          # the source disk is deleted.
+    },
+    "schedule": { # A schedule for disks where the schedueled operations are performed. # A Vm Maintenance Policy specifies what kind of infrastructure
+        # maintenance we are allowed to perform on this VM and when. Schedule
+        # that is applied to disks covered by this policy.
+      "dailySchedule": { # Time window specified for daily operations.
+        "daysInCycle": 42, # Defines a schedule with units measured in days. The value determines
+            # how many days pass between the start of each cycle.
+        "duration": "A String", # Output only. [Output only] A predetermined duration for the window, automatically
+            # chosen to be the smallest possible in the given scenario.
+        "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+            # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+            # example, both 13:00-5 and 08:00 are valid.
+      },
+      "hourlySchedule": { # Time window specified for hourly operations.
+        "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+            # smallest possible in the given scenario.
+        "hoursInCycle": 42, # Defines a schedule with units measured in hours. The value determines
+            # how many hours pass between the start of each cycle.
+        "startTime": "A String", # Time within the window to start the operations.
+            # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+      },
+      "weeklySchedule": { # Time window specified for weekly operations.
+        "dayOfWeeks": [ # Up to 7 intervals/windows, one for each day of the week.
+          {
+            "day": "A String", # Defines a schedule that runs on specific days of the week. Specify
+                # one or more days. The following options are available:
+                # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
+            "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                # smallest possible in the given scenario.
+            "startTime": "A String", # Time within the window to start the operations.
+                # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+          },
+        ],
+      },
+    },
+    "snapshotProperties": { # Specified snapshot properties for scheduled snapshots created by this # Properties with which snapshots are created such as labels, encryption
+        # keys.
+        # policy.
+      "chainName": "A String", # Chain name that the snapshot is created in.
+      "guestFlush": True or False, # Indication to perform a 'guest aware' snapshot.
+      "labels": { # Labels to apply to scheduled snapshots. These can be later modified
+          # by the setLabels method. Label values may be empty.
+        "a_key": "A String",
+      },
+      "storageLocations": [ # Cloud Storage bucket storage location of the auto snapshot (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  },
+  "status": "A String", # Output only. [Output Only] The status of resource policy creation.
+  "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+    "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have
+        # interconnected GPUs.
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+    "type": "A String", # Specifies the intent of the instance placement in the MIG.
+  },
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a new resource policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Resource Policy resource. You can use resource policies to
+    # schedule actions for some Compute Engine resources. For example, you can
+    # use them toschedule persistent disk
+    # snapshots.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String",
+  "diskConsistencyGroupPolicy": { # Resource policy for disk consistency groups. # Resource policy for disk consistency groups.
+  },
+  "groupPlacementPolicy": { # A GroupPlacementPolicy specifies resource placement configuration. # Resource policy for instances for placement configuration.
+      # It specifies the failure bucket separation
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "availabilityDomainCount": 42, # The number of availability domains to spread instances across. If two
+        # instances are in different availability domain, they are not in the same
+        # low latency network.
+    "collocation": "A String", # Specifies network collocation
+    "gpuTopology": "A String", # Specifies the shape of the GPU slice, in slice based GPU families eg.
+        # A4X.
+    "vmCount": 42, # Number of VMs in this placement group. Google does not recommend that you
+        # use this field unless you use a compact policy and you want your policy
+        # to work only if it contains this exact number of VMs.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSchedulePolicy": { # An InstanceSchedulePolicy specifies when and how frequent certain # Resource policy for scheduling instance operations.
+      # operations are performed on the instance.
+    "expirationTime": "A String", # The expiration time of the schedule. The timestamp is an RFC3339 string.
+    "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 string.
+    "timeZone": "A String", # Specifies the time zone to be used in interpreting Schedule.schedule.
+        # The value of this field must be a time zone name from the tz database:
+        # https://wikipedia.org/wiki/Tz_database.
+    "vmStartSchedule": { # Schedule for an instance operation. # Specifies the schedule for starting instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+    "vmStopSchedule": { # Schedule for an instance operation. # Specifies the schedule for stopping instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+  },
+  "kind": "compute#resourcePolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "region": "A String",
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] The system status of the resource policy.
+      # Use this sub-message for all output fields set on ResourcePolicy.
+      # The internal structure of this "status" field should mimic the structure
+      # of ResourcePolicy proto specification.
+    "instanceSchedulePolicy": { # Output only. [Output Only] Specifies a set of output values reffering to
+        # the instance_schedule_policy system status.
+        # This field should have the same name as corresponding policy field.
+      "lastRunStartTime": "A String", # Output only. [Output Only] The last time the schedule successfully ran.
+          # The timestamp is an RFC3339 string.
+      "nextRunStartTime": "A String", # Output only. [Output Only] The next time the schedule is planned to run.
+          # The actual time might be slightly different.
+          # The timestamp is an RFC3339 string.
+    },
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "snapshotSchedulePolicy": { # A snapshot schedule policy specifies when and how frequently snapshots are # Resource policy for persistent disks for creating snapshots.
+      # to be created for the target disk. Also specifies how many and how long
+      # these scheduled snapshots should be retained.
+    "retentionPolicy": { # Policy for retention of scheduled snapshots. # Retention policy applied to snapshots created by this resource policy.
+      "maxRetentionDays": 42, # Maximum age of the snapshot that is allowed to be kept.
+      "onSourceDiskDelete": "A String", # Specifies the behavior to apply to scheduled snapshots when
+          # the source disk is deleted.
+    },
+    "schedule": { # A schedule for disks where the schedueled operations are performed. # A Vm Maintenance Policy specifies what kind of infrastructure
+        # maintenance we are allowed to perform on this VM and when. Schedule
+        # that is applied to disks covered by this policy.
+      "dailySchedule": { # Time window specified for daily operations.
+        "daysInCycle": 42, # Defines a schedule with units measured in days. The value determines
+            # how many days pass between the start of each cycle.
+        "duration": "A String", # Output only. [Output only] A predetermined duration for the window, automatically
+            # chosen to be the smallest possible in the given scenario.
+        "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+            # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+            # example, both 13:00-5 and 08:00 are valid.
+      },
+      "hourlySchedule": { # Time window specified for hourly operations.
+        "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+            # smallest possible in the given scenario.
+        "hoursInCycle": 42, # Defines a schedule with units measured in hours. The value determines
+            # how many hours pass between the start of each cycle.
+        "startTime": "A String", # Time within the window to start the operations.
+            # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+      },
+      "weeklySchedule": { # Time window specified for weekly operations.
+        "dayOfWeeks": [ # Up to 7 intervals/windows, one for each day of the week.
+          {
+            "day": "A String", # Defines a schedule that runs on specific days of the week. Specify
+                # one or more days. The following options are available:
+                # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
+            "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                # smallest possible in the given scenario.
+            "startTime": "A String", # Time within the window to start the operations.
+                # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+          },
+        ],
+      },
+    },
+    "snapshotProperties": { # Specified snapshot properties for scheduled snapshots created by this # Properties with which snapshots are created such as labels, encryption
+        # keys.
+        # policy.
+      "chainName": "A String", # Chain name that the snapshot is created in.
+      "guestFlush": True or False, # Indication to perform a 'guest aware' snapshot.
+      "labels": { # Labels to apply to scheduled snapshots. These can be later modified
+          # by the setLabels method. Label values may be empty.
+        "a_key": "A String",
+      },
+      "storageLocations": [ # Cloud Storage bucket storage location of the auto snapshot (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  },
+  "status": "A String", # Output only. [Output Only] The status of resource policy creation.
+  "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+    "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have
+        # interconnected GPUs.
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+    "type": "A String", # Specifies the intent of the instance placement in the MIG.
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
A list all the resource policies that have been configured for the
+specified project in specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of ResourcePolicy resources.
+    { # Represents a Resource Policy resource. You can use resource policies to
+        # schedule actions for some Compute Engine resources. For example, you can
+        # use them toschedule persistent disk
+        # snapshots.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String",
+      "diskConsistencyGroupPolicy": { # Resource policy for disk consistency groups. # Resource policy for disk consistency groups.
+      },
+      "groupPlacementPolicy": { # A GroupPlacementPolicy specifies resource placement configuration. # Resource policy for instances for placement configuration.
+          # It specifies the failure bucket separation
+        "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+            # specified, the default is AUTO_CONNECT.
+        "availabilityDomainCount": 42, # The number of availability domains to spread instances across. If two
+            # instances are in different availability domain, they are not in the same
+            # low latency network.
+        "collocation": "A String", # Specifies network collocation
+        "gpuTopology": "A String", # Specifies the shape of the GPU slice, in slice based GPU families eg.
+            # A4X.
+        "vmCount": 42, # Number of VMs in this placement group. Google does not recommend that you
+            # use this field unless you use a compact policy and you want your policy
+            # to work only if it contains this exact number of VMs.
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instanceSchedulePolicy": { # An InstanceSchedulePolicy specifies when and how frequent certain # Resource policy for scheduling instance operations.
+          # operations are performed on the instance.
+        "expirationTime": "A String", # The expiration time of the schedule. The timestamp is an RFC3339 string.
+        "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 string.
+        "timeZone": "A String", # Specifies the time zone to be used in interpreting Schedule.schedule.
+            # The value of this field must be a time zone name from the tz database:
+            # https://wikipedia.org/wiki/Tz_database.
+        "vmStartSchedule": { # Schedule for an instance operation. # Specifies the schedule for starting instances.
+          "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+        },
+        "vmStopSchedule": { # Schedule for an instance operation. # Specifies the schedule for stopping instances.
+          "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+        },
+      },
+      "kind": "compute#resourcePolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. The resource 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.
+      "region": "A String",
+      "resourceStatus": { # Contains output only fields. # Output only. [Output Only] The system status of the resource policy.
+          # Use this sub-message for all output fields set on ResourcePolicy.
+          # The internal structure of this "status" field should mimic the structure
+          # of ResourcePolicy proto specification.
+        "instanceSchedulePolicy": { # Output only. [Output Only] Specifies a set of output values reffering to
+            # the instance_schedule_policy system status.
+            # This field should have the same name as corresponding policy field.
+          "lastRunStartTime": "A String", # Output only. [Output Only] The last time the schedule successfully ran.
+              # The timestamp is an RFC3339 string.
+          "nextRunStartTime": "A String", # Output only. [Output Only] The next time the schedule is planned to run.
+              # The actual time might be slightly different.
+              # The timestamp is an RFC3339 string.
+        },
+      },
+      "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+      "snapshotSchedulePolicy": { # A snapshot schedule policy specifies when and how frequently snapshots are # Resource policy for persistent disks for creating snapshots.
+          # to be created for the target disk. Also specifies how many and how long
+          # these scheduled snapshots should be retained.
+        "retentionPolicy": { # Policy for retention of scheduled snapshots. # Retention policy applied to snapshots created by this resource policy.
+          "maxRetentionDays": 42, # Maximum age of the snapshot that is allowed to be kept.
+          "onSourceDiskDelete": "A String", # Specifies the behavior to apply to scheduled snapshots when
+              # the source disk is deleted.
+        },
+        "schedule": { # A schedule for disks where the schedueled operations are performed. # A Vm Maintenance Policy specifies what kind of infrastructure
+            # maintenance we are allowed to perform on this VM and when. Schedule
+            # that is applied to disks covered by this policy.
+          "dailySchedule": { # Time window specified for daily operations.
+            "daysInCycle": 42, # Defines a schedule with units measured in days. The value determines
+                # how many days pass between the start of each cycle.
+            "duration": "A String", # Output only. [Output only] A predetermined duration for the window, automatically
+                # chosen to be the smallest possible in the given scenario.
+            "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+                # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+                # example, both 13:00-5 and 08:00 are valid.
+          },
+          "hourlySchedule": { # Time window specified for hourly operations.
+            "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                # smallest possible in the given scenario.
+            "hoursInCycle": 42, # Defines a schedule with units measured in hours. The value determines
+                # how many hours pass between the start of each cycle.
+            "startTime": "A String", # Time within the window to start the operations.
+                # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+          },
+          "weeklySchedule": { # Time window specified for weekly operations.
+            "dayOfWeeks": [ # Up to 7 intervals/windows, one for each day of the week.
+              {
+                "day": "A String", # Defines a schedule that runs on specific days of the week. Specify
+                    # one or more days. The following options are available:
+                    # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
+                "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                    # smallest possible in the given scenario.
+                "startTime": "A String", # Time within the window to start the operations.
+                    # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+              },
+            ],
+          },
+        },
+        "snapshotProperties": { # Specified snapshot properties for scheduled snapshots created by this # Properties with which snapshots are created such as labels, encryption
+            # keys.
+            # policy.
+          "chainName": "A String", # Chain name that the snapshot is created in.
+          "guestFlush": True or False, # Indication to perform a 'guest aware' snapshot.
+          "labels": { # Labels to apply to scheduled snapshots. These can be later modified
+              # by the setLabels method. Label values may be empty.
+            "a_key": "A String",
+          },
+          "storageLocations": [ # Cloud Storage bucket storage location of the auto snapshot (regional or
+              # multi-regional).
+            "A String",
+          ],
+        },
+      },
+      "status": "A String", # Output only. [Output Only] The status of resource policy creation.
+      "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+        "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have
+            # interconnected GPUs.
+        "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+            # specified, the default is AUTO_CONNECT.
+        "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+        "type": "A String", # Specifies the intent of the instance placement in the MIG.
+      },
+    },
+  ],
+  "kind": "compute#resourcePolicyList", # Output only. [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies
+  "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.
+  "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, resourcePolicy, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Modify the specified resource policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  resourcePolicy: string, Id of the resource policy to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Resource Policy resource. You can use resource policies to
+    # schedule actions for some Compute Engine resources. For example, you can
+    # use them toschedule persistent disk
+    # snapshots.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String",
+  "diskConsistencyGroupPolicy": { # Resource policy for disk consistency groups. # Resource policy for disk consistency groups.
+  },
+  "groupPlacementPolicy": { # A GroupPlacementPolicy specifies resource placement configuration. # Resource policy for instances for placement configuration.
+      # It specifies the failure bucket separation
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "availabilityDomainCount": 42, # The number of availability domains to spread instances across. If two
+        # instances are in different availability domain, they are not in the same
+        # low latency network.
+    "collocation": "A String", # Specifies network collocation
+    "gpuTopology": "A String", # Specifies the shape of the GPU slice, in slice based GPU families eg.
+        # A4X.
+    "vmCount": 42, # Number of VMs in this placement group. Google does not recommend that you
+        # use this field unless you use a compact policy and you want your policy
+        # to work only if it contains this exact number of VMs.
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSchedulePolicy": { # An InstanceSchedulePolicy specifies when and how frequent certain # Resource policy for scheduling instance operations.
+      # operations are performed on the instance.
+    "expirationTime": "A String", # The expiration time of the schedule. The timestamp is an RFC3339 string.
+    "startTime": "A String", # The start time of the schedule. The timestamp is an RFC3339 string.
+    "timeZone": "A String", # Specifies the time zone to be used in interpreting Schedule.schedule.
+        # The value of this field must be a time zone name from the tz database:
+        # https://wikipedia.org/wiki/Tz_database.
+    "vmStartSchedule": { # Schedule for an instance operation. # Specifies the schedule for starting instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+    "vmStopSchedule": { # Schedule for an instance operation. # Specifies the schedule for stopping instances.
+      "schedule": "A String", # Specifies the frequency for the operation, using the unix-cron format.
+    },
+  },
+  "kind": "compute#resourcePolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. The resource 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.
+  "region": "A String",
+  "resourceStatus": { # Contains output only fields. # Output only. [Output Only] The system status of the resource policy.
+      # Use this sub-message for all output fields set on ResourcePolicy.
+      # The internal structure of this "status" field should mimic the structure
+      # of ResourcePolicy proto specification.
+    "instanceSchedulePolicy": { # Output only. [Output Only] Specifies a set of output values reffering to
+        # the instance_schedule_policy system status.
+        # This field should have the same name as corresponding policy field.
+      "lastRunStartTime": "A String", # Output only. [Output Only] The last time the schedule successfully ran.
+          # The timestamp is an RFC3339 string.
+      "nextRunStartTime": "A String", # Output only. [Output Only] The next time the schedule is planned to run.
+          # The actual time might be slightly different.
+          # The timestamp is an RFC3339 string.
+    },
+  },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
+  "snapshotSchedulePolicy": { # A snapshot schedule policy specifies when and how frequently snapshots are # Resource policy for persistent disks for creating snapshots.
+      # to be created for the target disk. Also specifies how many and how long
+      # these scheduled snapshots should be retained.
+    "retentionPolicy": { # Policy for retention of scheduled snapshots. # Retention policy applied to snapshots created by this resource policy.
+      "maxRetentionDays": 42, # Maximum age of the snapshot that is allowed to be kept.
+      "onSourceDiskDelete": "A String", # Specifies the behavior to apply to scheduled snapshots when
+          # the source disk is deleted.
+    },
+    "schedule": { # A schedule for disks where the schedueled operations are performed. # A Vm Maintenance Policy specifies what kind of infrastructure
+        # maintenance we are allowed to perform on this VM and when. Schedule
+        # that is applied to disks covered by this policy.
+      "dailySchedule": { # Time window specified for daily operations.
+        "daysInCycle": 42, # Defines a schedule with units measured in days. The value determines
+            # how many days pass between the start of each cycle.
+        "duration": "A String", # Output only. [Output only] A predetermined duration for the window, automatically
+            # chosen to be the smallest possible in the given scenario.
+        "startTime": "A String", # Start time of the window. This must be in UTC format that resolves to one
+            # of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For
+            # example, both 13:00-5 and 08:00 are valid.
+      },
+      "hourlySchedule": { # Time window specified for hourly operations.
+        "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+            # smallest possible in the given scenario.
+        "hoursInCycle": 42, # Defines a schedule with units measured in hours. The value determines
+            # how many hours pass between the start of each cycle.
+        "startTime": "A String", # Time within the window to start the operations.
+            # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+      },
+      "weeklySchedule": { # Time window specified for weekly operations.
+        "dayOfWeeks": [ # Up to 7 intervals/windows, one for each day of the week.
+          {
+            "day": "A String", # Defines a schedule that runs on specific days of the week. Specify
+                # one or more days. The following options are available:
+                # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
+            "duration": "A String", # Output only. [Output only] Duration of the time window, automatically chosen to be
+                # smallest possible in the given scenario.
+            "startTime": "A String", # Time within the window to start the operations.
+                # It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT.
+          },
+        ],
+      },
+    },
+    "snapshotProperties": { # Specified snapshot properties for scheduled snapshots created by this # Properties with which snapshots are created such as labels, encryption
+        # keys.
+        # policy.
+      "chainName": "A String", # Chain name that the snapshot is created in.
+      "guestFlush": True or False, # Indication to perform a 'guest aware' snapshot.
+      "labels": { # Labels to apply to scheduled snapshots. These can be later modified
+          # by the setLabels method. Label values may be empty.
+        "a_key": "A String",
+      },
+      "storageLocations": [ # Cloud Storage bucket storage location of the auto snapshot (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  },
+  "status": "A String", # Output only. [Output Only] The status of resource policy creation.
+  "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+    "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have
+        # interconnected GPUs.
+    "acceleratorTopologyMode": "A String", # Specifies the connection mode for the accelerator topology. If not
+        # specified, the default is AUTO_CONNECT.
+    "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+    "type": "A String", # Specifies the intent of the instance placement in the MIG.
+  },
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.rolloutPlans.html b/docs/dyn/compute_preview.rolloutPlans.html new file mode 100644 index 0000000000..a34ce382c3 --- /dev/null +++ b/docs/dyn/compute_preview.rolloutPlans.html @@ -0,0 +1,1160 @@ + + + +

Compute Engine API . rolloutPlans

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, rolloutPlan, requestId=None, x__xgafv=None)

+

Deletes a RolloutPlan.

+

+ get(project, rolloutPlan, x__xgafv=None)

+

Gets details of a single project-scoped RolloutPlan.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a new RolloutPlan in a given project and location.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists RolloutPlans in a given project and location.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, rolloutPlan, requestId=None, x__xgafv=None) + 
Deletes a RolloutPlan.
+
+Args:
+  project: string, Project ID for this request. (required)
+  rolloutPlan: string, Name of the RolloutPlan 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, rolloutPlan, x__xgafv=None) + 
Gets details of a single project-scoped RolloutPlan.
+
+Args:
+  project: string, Project ID for this request. (required)
+  rolloutPlan: string, Name of the persistent rollout plan 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:
+
+    { # RolloutPlan resource.
+    #
+    # A RolloutPlan is the customer-defined strategy to divide a large-scale change
+    # into smaller increments, referred to as "waves". Each wave targets a specific
+    # portion of the overall affected area and defines criteria that must be met
+    # before progressing to the subsequent wave.
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#rolloutPlan", # Output only. [Output Only] Type of the resource. Always compute#rolloutPlan
+      # for rolloutPlans.
+  "locationScope": "A String", # The location scope of the rollout plan. If not specified, the location
+      # scope is considered as ZONAL.
+  "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.
+  "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.
+  "waves": [ # Required. The waves included in this rollout plan.
+    { # A single wave in a rollout plan.
+      "displayName": "A String", # Optional. The display name of this wave of the rollout plan.
+      "number": "A String", # Output only. The wave number.
+      "orchestrationOptions": { # Options to control the pace of orchestration of a wave. These options are # Optional. The orchestration options for this wave.
+          # required only if the resource being rolled out follows the Orchestrated
+          # pattern.
+        "delays": [ # Optional. Delays, if any, to be added between batches of projects. We allow
+            # multiple Delays to be specified, letting users set separate delays
+            # between batches of projects corresponding to different locations and
+            # batches of projects corresponding to the same location.
+          { # Options to control the delay, if any, between batches of projects.
+            "delimiter": "A String", # Optional. Controls whether the delay should only be added between batches of
+                # projects corresponding to different locations, or also between
+                # batches of projects corresponding to the same location.
+                #
+                # Must be set to DELIMITER_UNSPECIFIED if no delay is to be added.
+            "duration": "A String", # Optional. The duration of the delay, if any, to be added between batches of
+                # projects. A zero duration corresponds to no delay.
+            "type": "A String", # Optional. Controls whether the specified duration is to be added at the end of
+                # each batch, or if the total processing time for each batch will be
+                # padded if needed to meet the specified duration.
+                #
+                # Must be set to TYPE_UNSPECIFIED if no delay is to be added.
+          },
+        ],
+        "maxConcurrentLocations": "A String", # Optional. Maximum number of locations to be orchestrated in parallel.
+        "maxConcurrentResourcesPerLocation": "A String", # Optional. Maximum number of resources to be orchestrated per location in
+            # parallel.
+      },
+      "selectors": [ # Required. The selectors for this wave. There is a logical AND between each selector
+          # defined in a wave, so a resource must satisfy the criteria of *all* the
+          # specified selectors to be in scope for the wave.
+        { # A selector which specifies what resource(s) are included in a given wave.
+          "locationSelector": { # Roll out to resources by location. # Optional. Roll out to resources by Cloud locations.
+            "includedLocations": [ # Optional. Example: "us-central1-a"
+              "A String",
+            ],
+          },
+          "resourceHierarchySelector": { # Roll out to resources by Cloud Resource Manager resource hierarchy # Optional. Roll out to resources by Cloud Resource Manager resource hierarchy.
+              # nodes such as projects, folders, orgs.
+            "includedFolders": [ # Optional. Format: "folders/{folder_id}"
+              "A String",
+            ],
+            "includedOrganizations": [ # Optional. Format: "organizations/{organization_id}"
+              "A String",
+            ],
+            "includedProjects": [ # Optional. Format: "projects/{project_id}"
+              "A String",
+            ],
+          },
+        },
+      ],
+      "validation": { # The validation to be performed before progressing to the next wave. # Required. The validation to be performed at the end of this wave.
+        "timeBasedValidationMetadata": { # Metadata required if type = "time". # Optional. Metadata required if type = "time".
+          "waitDuration": "A String", # Optional. The duration that the system waits in between waves. This wait starts
+              # after all changes in the wave are rolled out.
+        },
+        "type": "A String", # Required. The type of the validation. If a type of validation is associated with
+            # a metadata object, the appropriate metadata field mapping to the
+            # validation type must be provided in the validation message. Possible
+            # values are in quotes below alongside an explanation:
+            #   "manual": The system waits for an end-user approval API before
+            #     progressing to the next wave.
+            #   "time": The system waits for a user specified duration before
+            #     progressing to the next wave. TimeBasedValidation must be provided.
+      },
+    },
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a new RolloutPlan in a given project and location.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # RolloutPlan resource.
+    # 
+    # A RolloutPlan is the customer-defined strategy to divide a large-scale change
+    # into smaller increments, referred to as "waves". Each wave targets a specific
+    # portion of the overall affected area and defines criteria that must be met
+    # before progressing to the subsequent wave.
+  "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.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#rolloutPlan", # Output only. [Output Only] Type of the resource. Always compute#rolloutPlan
+      # for rolloutPlans.
+  "locationScope": "A String", # The location scope of the rollout plan. If not specified, the location
+      # scope is considered as ZONAL.
+  "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.
+  "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.
+  "waves": [ # Required. The waves included in this rollout plan.
+    { # A single wave in a rollout plan.
+      "displayName": "A String", # Optional. The display name of this wave of the rollout plan.
+      "number": "A String", # Output only. The wave number.
+      "orchestrationOptions": { # Options to control the pace of orchestration of a wave. These options are # Optional. The orchestration options for this wave.
+          # required only if the resource being rolled out follows the Orchestrated
+          # pattern.
+        "delays": [ # Optional. Delays, if any, to be added between batches of projects. We allow
+            # multiple Delays to be specified, letting users set separate delays
+            # between batches of projects corresponding to different locations and
+            # batches of projects corresponding to the same location.
+          { # Options to control the delay, if any, between batches of projects.
+            "delimiter": "A String", # Optional. Controls whether the delay should only be added between batches of
+                # projects corresponding to different locations, or also between
+                # batches of projects corresponding to the same location.
+                #
+                # Must be set to DELIMITER_UNSPECIFIED if no delay is to be added.
+            "duration": "A String", # Optional. The duration of the delay, if any, to be added between batches of
+                # projects. A zero duration corresponds to no delay.
+            "type": "A String", # Optional. Controls whether the specified duration is to be added at the end of
+                # each batch, or if the total processing time for each batch will be
+                # padded if needed to meet the specified duration.
+                #
+                # Must be set to TYPE_UNSPECIFIED if no delay is to be added.
+          },
+        ],
+        "maxConcurrentLocations": "A String", # Optional. Maximum number of locations to be orchestrated in parallel.
+        "maxConcurrentResourcesPerLocation": "A String", # Optional. Maximum number of resources to be orchestrated per location in
+            # parallel.
+      },
+      "selectors": [ # Required. The selectors for this wave. There is a logical AND between each selector
+          # defined in a wave, so a resource must satisfy the criteria of *all* the
+          # specified selectors to be in scope for the wave.
+        { # A selector which specifies what resource(s) are included in a given wave.
+          "locationSelector": { # Roll out to resources by location. # Optional. Roll out to resources by Cloud locations.
+            "includedLocations": [ # Optional. Example: "us-central1-a"
+              "A String",
+            ],
+          },
+          "resourceHierarchySelector": { # Roll out to resources by Cloud Resource Manager resource hierarchy # Optional. Roll out to resources by Cloud Resource Manager resource hierarchy.
+              # nodes such as projects, folders, orgs.
+            "includedFolders": [ # Optional. Format: "folders/{folder_id}"
+              "A String",
+            ],
+            "includedOrganizations": [ # Optional. Format: "organizations/{organization_id}"
+              "A String",
+            ],
+            "includedProjects": [ # Optional. Format: "projects/{project_id}"
+              "A String",
+            ],
+          },
+        },
+      ],
+      "validation": { # The validation to be performed before progressing to the next wave. # Required. The validation to be performed at the end of this wave.
+        "timeBasedValidationMetadata": { # Metadata required if type = "time". # Optional. Metadata required if type = "time".
+          "waitDuration": "A String", # Optional. The duration that the system waits in between waves. This wait starts
+              # after all changes in the wave are rolled out.
+        },
+        "type": "A String", # Required. The type of the validation. If a type of validation is associated with
+            # a metadata object, the appropriate metadata field mapping to the
+            # validation type must be provided in the validation message. Possible
+            # values are in quotes below alongside an explanation:
+            #   "manual": The system waits for an end-user approval API before
+            #     progressing to the next wave.
+            #   "time": The system waits for a user specified duration before
+            #     progressing to the next wave. TimeBasedValidation must be provided.
+      },
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists RolloutPlans in a given project and location.
+
+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.
+  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 RolloutPlan resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of RolloutPlan resources.
+    { # RolloutPlan resource.
+        #
+        # A RolloutPlan is the customer-defined strategy to divide a large-scale change
+        # into smaller increments, referred to as "waves". Each wave targets a specific
+        # portion of the overall affected area and defines criteria that must be met
+        # before progressing to the subsequent wave.
+      "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.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#rolloutPlan", # Output only. [Output Only] Type of the resource. Always compute#rolloutPlan
+          # for rolloutPlans.
+      "locationScope": "A String", # The location scope of the rollout plan. If not specified, the location
+          # scope is considered as ZONAL.
+      "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.
+      "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.
+      "waves": [ # Required. The waves included in this rollout plan.
+        { # A single wave in a rollout plan.
+          "displayName": "A String", # Optional. The display name of this wave of the rollout plan.
+          "number": "A String", # Output only. The wave number.
+          "orchestrationOptions": { # Options to control the pace of orchestration of a wave. These options are # Optional. The orchestration options for this wave.
+              # required only if the resource being rolled out follows the Orchestrated
+              # pattern.
+            "delays": [ # Optional. Delays, if any, to be added between batches of projects. We allow
+                # multiple Delays to be specified, letting users set separate delays
+                # between batches of projects corresponding to different locations and
+                # batches of projects corresponding to the same location.
+              { # Options to control the delay, if any, between batches of projects.
+                "delimiter": "A String", # Optional. Controls whether the delay should only be added between batches of
+                    # projects corresponding to different locations, or also between
+                    # batches of projects corresponding to the same location.
+                    #
+                    # Must be set to DELIMITER_UNSPECIFIED if no delay is to be added.
+                "duration": "A String", # Optional. The duration of the delay, if any, to be added between batches of
+                    # projects. A zero duration corresponds to no delay.
+                "type": "A String", # Optional. Controls whether the specified duration is to be added at the end of
+                    # each batch, or if the total processing time for each batch will be
+                    # padded if needed to meet the specified duration.
+                    #
+                    # Must be set to TYPE_UNSPECIFIED if no delay is to be added.
+              },
+            ],
+            "maxConcurrentLocations": "A String", # Optional. Maximum number of locations to be orchestrated in parallel.
+            "maxConcurrentResourcesPerLocation": "A String", # Optional. Maximum number of resources to be orchestrated per location in
+                # parallel.
+          },
+          "selectors": [ # Required. The selectors for this wave. There is a logical AND between each selector
+              # defined in a wave, so a resource must satisfy the criteria of *all* the
+              # specified selectors to be in scope for the wave.
+            { # A selector which specifies what resource(s) are included in a given wave.
+              "locationSelector": { # Roll out to resources by location. # Optional. Roll out to resources by Cloud locations.
+                "includedLocations": [ # Optional. Example: "us-central1-a"
+                  "A String",
+                ],
+              },
+              "resourceHierarchySelector": { # Roll out to resources by Cloud Resource Manager resource hierarchy # Optional. Roll out to resources by Cloud Resource Manager resource hierarchy.
+                  # nodes such as projects, folders, orgs.
+                "includedFolders": [ # Optional. Format: "folders/{folder_id}"
+                  "A String",
+                ],
+                "includedOrganizations": [ # Optional. Format: "organizations/{organization_id}"
+                  "A String",
+                ],
+                "includedProjects": [ # Optional. Format: "projects/{project_id}"
+                  "A String",
+                ],
+              },
+            },
+          ],
+          "validation": { # The validation to be performed before progressing to the next wave. # Required. The validation to be performed at the end of this wave.
+            "timeBasedValidationMetadata": { # Metadata required if type = "time". # Optional. Metadata required if type = "time".
+              "waitDuration": "A String", # Optional. The duration that the system waits in between waves. This wait starts
+                  # after all changes in the wave are rolled out.
+            },
+            "type": "A String", # Required. The type of the validation. If a type of validation is associated with
+                # a metadata object, the appropriate metadata field mapping to the
+                # validation type must be provided in the validation message. Possible
+                # values are in quotes below alongside an explanation:
+                #   "manual": The system waits for an end-user approval API before
+                #     progressing to the next wave.
+                #   "time": The system waits for a user specified duration before
+                #     progressing to the next wave. TimeBasedValidation must be provided.
+          },
+        },
+      ],
+    },
+  ],
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.rollouts.html b/docs/dyn/compute_preview.rollouts.html new file mode 100644 index 0000000000..f655cda072 --- /dev/null +++ b/docs/dyn/compute_preview.rollouts.html @@ -0,0 +1,1971 @@ + + + +

Compute Engine API . rollouts

+

Instance Methods

+

+ advance(project, rollout, currentWaveNumber=None, requestId=None, x__xgafv=None)

+

Advances a Rollout to the next wave, or completes it if no waves remain.

+

+ cancel(project, rollout, requestId=None, rollback=None, x__xgafv=None)

+

Cancels a Rollout.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, rollout, requestId=None, x__xgafv=None)

+

Deletes a Rollout.

+

+ get(project, rollout, x__xgafv=None)

+

Gets details of a single project-scoped Rollout.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists Rollouts in a given project and location.

+

+ list_next()

+

Retrieves the next page of results.

+

+ pause(project, rollout, etag=None, requestId=None, x__xgafv=None)

+

Pauses a Rollout.

+

+ resume(project, rollout, etag=None, requestId=None, x__xgafv=None)

+

Resumes a Rollout.

+

Method Details

+
+ advance(project, rollout, currentWaveNumber=None, requestId=None, x__xgafv=None) + 
Advances a Rollout to the next wave, or completes it if no waves remain.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  rollout: string, Required. Name of the Rollout resource to advance. (required)
+  currentWaveNumber: string, Required. Wave number of the current wave.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ cancel(project, rollout, requestId=None, rollback=None, x__xgafv=None) + 
Cancels a Rollout.
+
+Args:
+  project: string, Project ID for this request. (required)
+  rollout: string, Name of the Rollout resource to cancel. (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).
+  rollback: boolean, Optional. If true, then the ongoing rollout must be rolled back. Else, just cancel
+the rollout without taking any further actions. Note that products must
+support at least one of these options, however, it does not need to support
+both.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, rollout, requestId=None, x__xgafv=None) + 
Deletes a Rollout.
+
+Args:
+  project: string, Project ID for this request. (required)
+  rollout: string, Name of the Rollout 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, rollout, x__xgafv=None) + 
Gets details of a single project-scoped Rollout.
+
+Args:
+  project: string, Project ID for this request. (required)
+  rollout: string, Name of the persistent rollout 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:
+
+    { # Rollout resource.
+    #
+    # A Rollout is a specific instance of a RolloutPlan. It represents a single
+    # execution of a strategy to roll out a specific resource. It also provides
+    # APIs to interact with the rollout.
+  "cancellationTime": "A String", # Output only. The timestamp at which the Rollout was cancelled.
+  "completionTime": "A String", # Output only. The timestamp at which the Rollout was completed.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "currentWaveNumber": "A String", # Output only. The number of the currently running wave.
+      # Ex. 1
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "etag": "A String", # Output only. etag of the Rollout
+      # Ex. abc1234
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#rollout", # Output only. [Output Only] Type of the resource. Always compute#rollout
+      # for rollouts.
+  "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.
+  "pauseTime": "A String", # Output only. The timestamp at which the Rollout was paused.
+  "resumeTime": "A String", # Output only. The timestamp at which the Rollout was resumed.
+  "rolloutEntity": { # Specifications of the resource to roll out. # Required. The resource being rolled out.
+    "orchestratedEntity": { # This message is used if the resource type follows the Orchestrated # Optional. Entity details for products using the Orchestrated Integration model.
+        # integration model with ProgressiveRollout.
+      "conflictBehavior": "A String", # Required. Specifies the behavior of the Rollout if an out of band update is
+          # detected in a project during a Rollout. It can be one of the following
+          # values:
+          # 1) overwrite : Overwrite the local value with the rollout value.
+          # 2) no_overwrite : Do not overwrite the local value with the rollout
+          # value.
+      "orchestrationAction": "A String", # Required. Orchestration action during the Rollout. It can be one of the following
+          # values:
+          # 1) "update": Resources will be updated by the rollout.
+          # 2) "delete": Resources will be deleted by the rollout.
+      "orchestrationSource": "A String", # Required. Fully qualified resource name of the resource which contains the source
+          # of truth of the configuration being rolled out across
+          # locations/projects. For example, in the case of a global Rollout which
+          # is applied across regions, this contains the name of the global
+          # resource created by the user which contains a payload for a resource
+          # that is orchestrated across regions. This follows the following format:
+          # //.googleapis.com/projects//locations/global//
+          # e.g.
+          # //osconfig.googleapis.com/projects/1/locations/global/policyOrchestrators/po1
+    },
+  },
+  "rolloutPlan": "A String", # Required. Rollout Plan used to model the Rollout.
+      # Ex. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1
+  "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", # Output only. The current state of the Rollout.
+  "waveDetails": [ # Output only. Details about each wave of the rollout.
+    { # Additional metadata about the status of each wave provided by the server.
+      "orchestratedWaveDetails": { # Details of the wave for products using the Orchestrated integration # Output only. Additional details of the wave for products using the Orchestrated
+          # Integration model.
+          # model.
+        "completedResourcesCount": "A String", # Output only. Resource completed so far.
+        "estimatedCompletionTime": "A String", # Output only. Estimated timestamp at which the wave will complete. Extrapolated from
+            # current progress.
+        "estimatedTotalResourcesCount": "A String", # Output only. Estimated total count of resources.
+        "failedLocations": [ # Output only. Locations that failed during orchestration, and ProgressiveRollout
+            # stopped retrying. There may be some successful resources rolled out in
+            # the wave as the location may have failed later in the Rollout.
+          "A String",
+        ],
+        "failedResourcesCount": "A String", # Output only. Resources failed.
+        "locationStatus": { # Output only. Status of each location in the wave. Map keys (locations) must be
+            # specified like "us-east1" or "asia-west1-a".
+          "a_key": { # Represents the status of a location in a wave.
+            "state": "A String", # Output only. Location state of the wave.
+          },
+        },
+      },
+      "waveDisplayName": "A String", # Output only. Wave name.
+          # Ex. wave1
+      "waveNumber": "A String", # Output only. System generated number for the wave.
+    },
+  ],
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists Rollouts in a given project and location.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Rollout resources.
+    { # Rollout resource.
+        #
+        # A Rollout is a specific instance of a RolloutPlan. It represents a single
+        # execution of a strategy to roll out a specific resource. It also provides
+        # APIs to interact with the rollout.
+      "cancellationTime": "A String", # Output only. The timestamp at which the Rollout was cancelled.
+      "completionTime": "A String", # Output only. The timestamp at which the Rollout was completed.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "currentWaveNumber": "A String", # Output only. The number of the currently running wave.
+          # Ex. 1
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "etag": "A String", # Output only. etag of the Rollout
+          # Ex. abc1234
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#rollout", # Output only. [Output Only] Type of the resource. Always compute#rollout
+          # for rollouts.
+      "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.
+      "pauseTime": "A String", # Output only. The timestamp at which the Rollout was paused.
+      "resumeTime": "A String", # Output only. The timestamp at which the Rollout was resumed.
+      "rolloutEntity": { # Specifications of the resource to roll out. # Required. The resource being rolled out.
+        "orchestratedEntity": { # This message is used if the resource type follows the Orchestrated # Optional. Entity details for products using the Orchestrated Integration model.
+            # integration model with ProgressiveRollout.
+          "conflictBehavior": "A String", # Required. Specifies the behavior of the Rollout if an out of band update is
+              # detected in a project during a Rollout. It can be one of the following
+              # values:
+              # 1) overwrite : Overwrite the local value with the rollout value.
+              # 2) no_overwrite : Do not overwrite the local value with the rollout
+              # value.
+          "orchestrationAction": "A String", # Required. Orchestration action during the Rollout. It can be one of the following
+              # values:
+              # 1) "update": Resources will be updated by the rollout.
+              # 2) "delete": Resources will be deleted by the rollout.
+          "orchestrationSource": "A String", # Required. Fully qualified resource name of the resource which contains the source
+              # of truth of the configuration being rolled out across
+              # locations/projects. For example, in the case of a global Rollout which
+              # is applied across regions, this contains the name of the global
+              # resource created by the user which contains a payload for a resource
+              # that is orchestrated across regions. This follows the following format:
+              # //.googleapis.com/projects//locations/global//
+              # e.g.
+              # //osconfig.googleapis.com/projects/1/locations/global/policyOrchestrators/po1
+        },
+      },
+      "rolloutPlan": "A String", # Required. Rollout Plan used to model the Rollout.
+          # Ex. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1
+      "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", # Output only. The current state of the Rollout.
+      "waveDetails": [ # Output only. Details about each wave of the rollout.
+        { # Additional metadata about the status of each wave provided by the server.
+          "orchestratedWaveDetails": { # Details of the wave for products using the Orchestrated integration # Output only. Additional details of the wave for products using the Orchestrated
+              # Integration model.
+              # model.
+            "completedResourcesCount": "A String", # Output only. Resource completed so far.
+            "estimatedCompletionTime": "A String", # Output only. Estimated timestamp at which the wave will complete. Extrapolated from
+                # current progress.
+            "estimatedTotalResourcesCount": "A String", # Output only. Estimated total count of resources.
+            "failedLocations": [ # Output only. Locations that failed during orchestration, and ProgressiveRollout
+                # stopped retrying. There may be some successful resources rolled out in
+                # the wave as the location may have failed later in the Rollout.
+              "A String",
+            ],
+            "failedResourcesCount": "A String", # Output only. Resources failed.
+            "locationStatus": { # Output only. Status of each location in the wave. Map keys (locations) must be
+                # specified like "us-east1" or "asia-west1-a".
+              "a_key": { # Represents the status of a location in a wave.
+                "state": "A String", # Output only. Location state of the wave.
+              },
+            },
+          },
+          "waveDisplayName": "A String", # Output only. Wave name.
+              # Ex. wave1
+          "waveNumber": "A String", # Output only. System generated number for the wave.
+        },
+      ],
+    },
+  ],
+  "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.
+
+
+ +
+ pause(project, rollout, etag=None, requestId=None, x__xgafv=None) + 
Pauses a Rollout.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  rollout: string, Required. Name of the Rollout resource to pause. (required)
+  etag: string, The etag of the Rollout.
+If this is provided, the request will only succeed if the etag matches
+the current etag of the Rollout.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ resume(project, rollout, etag=None, requestId=None, x__xgafv=None) + 
Resumes a Rollout.
+
+Args:
+  project: string, Required. Project ID for this request. (required)
+  rollout: string, Required. Name of the Rollout resource to resume. (required)
+  etag: string, The etag of the Rollout.
+If this is provided, the request will only succeed if the etag matches
+the current etag of the Rollout.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.routers.html b/docs/dyn/compute_preview.routers.html new file mode 100644 index 0000000000..50ee0c0168 --- /dev/null +++ b/docs/dyn/compute_preview.routers.html @@ -0,0 +1,9908 @@ + + + +

Compute Engine API . routers

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of routers.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ 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.

+

+ getNatMappingInfo(project, region, router, filter=None, maxResults=None, natName=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves runtime Nat mapping information of VM endpoints.

+

+ getNatMappingInfo_next()

+

Retrieves the next page of results.

+

+ getRoutePolicy(project, region, router, policy=None, x__xgafv=None)

+

Returns specified Route Policy

+

+ getRouterStatus(project, region, router, x__xgafv=None)

+

Retrieves runtime information of the specified router.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a Router resource in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of Router resources available to the specified project.

+

+ listBgpRoutes(project, region, router, addressFamily=None, destinationPrefix=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peer=None, policyApplied=None, routeType=None, x__xgafv=None)

+

Retrieves a list of router bgp routes available to the specified project.

+

+ listBgpRoutes_next()

+

Retrieves the next page of results.

+

+ listNamedSets(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=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, x__xgafv=None)

+

Retrieves a list of router route policy subresources available to the

+

+ listRoutePolicies_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ 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

+

+ preview(project, region, router, body=None, x__xgafv=None)

+

Preview fields auto-generated during router create andupdate operations.

+

+ 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

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of routers.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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 routers.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of Router resources.
+    "a_key": { # Name of the scope containing this set of routers.
+      "routers": [ # A list of routers contained in this scope.
+        { # 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",
+              ],
+              "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+                  # state. This value is equal to tcp_time_wait_timeout_sec.
+                  # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+                  # 120s. The field is output only.
+              "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.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of routers 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#routerAggregatedList", # 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, router, requestId=None, x__xgafv=None) + 
Deletes 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 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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 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.
+
+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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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 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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+            #
+            #
+            # 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",
+      ],
+      "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+          # state. This value is equal to tcp_time_wait_timeout_sec.
+          # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+          # 120s. The field is output only.
+      "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.
+}
+
+ +
+ 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 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
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "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.
+    },
+  ],
+}
+
+ +
+ getNatMappingInfo(project, region, router, filter=None, maxResults=None, natName=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves runtime Nat mapping information of VM endpoints.
+
+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 Mapping information of
+VM endpoints. (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`)
+  natName: string, Name of the nat service to filter the Nat Mapping information.
+If it is omitted, all nats for this router will be returned.
+Name should conform to RFC1035.
+  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.
+  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 VmEndpointNatMappings.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#vmEndpointNatMappingsList", # Output only. [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of
+      # VM endpoints.
+  "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 Nat mapping information of VM endpoints.
+    { # Contain information of Nat mapping for a VM endpoint (i.e., NIC).
+      "instanceName": "A String", # Output only. Name of the VM instance which the endpoint belongs to
+      "interfaceNatMappings": [
+        { # Contain information of Nat mapping for an interface of this endpoint.
+          "drainNatIpPortRanges": [ # Output only. List of all drain IP:port-range mappings assigned to this interface.
+              # These ranges are inclusive, that is, both the first and the last
+              # ports can be used for NAT. Example: ["2.2.2.2:12345-12355",
+              # "1.1.1.1:2234-2234"].
+            "A String",
+          ],
+          "natIpPortRanges": [ # Output only. A list of all IP:port-range mappings assigned to this interface.
+              # These ranges are inclusive, that is, both the first and the last
+              # ports can be used for NAT. Example: ["2.2.2.2:12345-12355",
+              # "1.1.1.1:2234-2234"].
+            "A String",
+          ],
+          "numTotalDrainNatPorts": 42, # Output only. Total number of drain ports across all NAT IPs allocated to this
+              # interface. It equals to the aggregated port number in the field
+              # drain_nat_ip_port_ranges.
+          "numTotalNatPorts": 42, # Output only. Total number of ports across all NAT IPs allocated to this interface.
+              # It equals to the aggregated port number in the field nat_ip_port_ranges.
+          "ruleMappings": [ # Output only. Information about mappings provided by rules in this NAT.
+            { # Contains information of NAT Mappings provided by a NAT Rule.
+              "drainNatIpPortRanges": [ # Output only. List of all drain IP:port-range mappings assigned to this interface
+                  # by this rule.
+                  # These ranges are inclusive, that is, both the first and the last
+                  # ports can be used for NAT. Example: ["2.2.2.2:12345-12355",
+                  # "1.1.1.1:2234-2234"].
+                "A String",
+              ],
+              "natIpPortRanges": [ # Output only. A list of all IP:port-range mappings assigned to this interface by this
+                  # rule.
+                  # These ranges are inclusive, that is, both the first and the last
+                  # ports can be used for NAT. Example: ["2.2.2.2:12345-12355",
+                  # "1.1.1.1:2234-2234"].
+                "A String",
+              ],
+              "numTotalDrainNatPorts": 42, # Output only. Total number of drain ports across all NAT IPs allocated to this
+                  # interface by this rule.
+                  # It equals the aggregated port number in the field
+                  # drain_nat_ip_port_ranges.
+              "numTotalNatPorts": 42, # Output only. Total number of ports across all NAT IPs allocated to this interface
+                  # by this rule.
+                  # It equals the aggregated port number in the field nat_ip_port_ranges.
+              "ruleNumber": 42, # Output only. Rule number of the NAT Rule.
+            },
+          ],
+          "sourceAliasIpRange": "A String", # Output only. Alias IP range for this interface endpoint.
+              # It will be a private (RFC 1918) IP range.
+              # Examples: "10.33.4.55/32", or "192.168.5.0/24".
+          "sourceVirtualIp": "A String", # Output only. Primary IP of the VM for this NIC.
+        },
+      ],
+    },
+  ],
+  "selfLink": "A String", # Output only. [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.
+  },
+}
+
+ +
+ getNatMappingInfo_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.
+
+
+ +
+ getRoutePolicy(project, region, router, policy=None, x__xgafv=None) + 
Returns specified 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 for the route policy. The name should
+conform to RFC1035. (required)
+  policy: string, The Policy name for this request. Name must 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:
+
+    {
+  "resource": {
+    "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.
+      },
+    ],
+    "type": "A String",
+  },
+}
+
+ +
+ getRouterStatus(project, region, router, x__xgafv=None) + 
Retrieves runtime information of the specified 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)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "kind": "compute#routerStatusResponse", # Output only. Type of resource.
+  "result": {
+    "bestRoutes": [ # A list of the best dynamic routes for this Cloud Router's Virtual Private
+        # Cloud (VPC) network in the same region as this Cloud Router.
+        #
+        # Lists all of the best routes per prefix that are programmed into this
+        # region's VPC data plane.
+        #
+        # When global dynamic routing mode is turned on in the VPC network, this list
+        # can include cross-region dynamic routes from Cloud Routers in other
+        # regions.
+      { # Represents a Route resource.
+          #
+          # A route defines a path from VM instances in the VPC network to a specific
+          # destination. This destination can be inside or outside the VPC network.
+          # For more information, read theRoutes overview.
+        "asPaths": [ # Output only. [Output Only] AS path.
+          {
+            "asLists": [ # [Output Only] The AS numbers of the AS Path.
+              42,
+            ],
+            "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+                # values:
+                # - 'AS_SET': unordered set of autonomous systems that the route
+                # in has traversed
+                # - 'AS_SEQUENCE': ordered set of autonomous
+                # systems that the route has traversed
+                # - 'AS_CONFED_SEQUENCE':
+                # ordered set of Member Autonomous Systems in the local confederation that
+                # the route has traversed
+                # - 'AS_CONFED_SET': unordered set of
+                # Member Autonomous Systems in the local confederation that the route has
+                # traversed
+          },
+        ],
+        "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+            # text format.
+        "description": "A String", # An optional description of this resource. Provide this field when you
+            # create the resource.
+        "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+            # IPv4 and IPv6 are supported.
+            # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+            # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+            # compressed format.
+        "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+            # defined by the server.
+        "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+            # Route resources.
+        "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])?`. The first character must be a
+            # lowercase letter, and all following characters (except for the last
+            # character) must be a dash, lowercase letter, or digit. The last character
+            # must be a lowercase letter or digit.
+        "network": "A String", # Fully-qualified URL of the network that this route applies to.
+        "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+            # You can only specify the internet gateway using a full or
+            # partial valid URL: projects/project/global/gateways/default-internet-gateway
+        "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+            # that will handle matching packets.
+        "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+            # packets or the IP address of the forwarding Rule.
+            # For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+            #    - regions/region/forwardingRules/forwardingRule
+            #
+            #
+            # If an IP address is provided, must specify an IPv4 address in dot-decimal
+            # notation or an IPv6 address in RFC 4291 format. For example, the following
+            # are all valid IP addresses:
+            #
+            #
+            #       - 10.128.0.56
+            #       - 2001:db8::2d9:51:0:0
+            #       - 2001:db8:0:0:2d9:51:0:0
+            #
+            #
+            # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+            # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+        "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+            # this as a full or partial URL.
+            # For example:
+            # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+        "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+            # calculates based on factors such as network performance, distance, and
+            # available bandwidth between regions.
+        "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+            # for the route.
+            # This field will only be populated for dynamic routes generated by
+            # Cloud Router with a linked interconnectAttachment or the static route
+            # generated by each L2 Interconnect Attachment.
+        "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+            # Both IPv6 address and IPv4 addresses are supported.
+            # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+            # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+            # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+            # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+            # IPv4-mapped IPv6 address.
+        "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+            # the desirability of a particular route in a network.
+        "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+        "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+            # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+            # or INCOMPLETE.
+        "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+            # which should conform to RFC1035.
+        "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+        "params": { # Additional route 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.
+              # 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.
+            "a_key": "A String",
+          },
+        },
+        "priority": 42, # The priority of this route. Priority is used to break ties in cases
+            # where there is more than one matching route of equal prefix length. In
+            # cases where multiple routes have equal prefix length, the one with the
+            # lowest-numbered priority value wins. The default value is `1000`. The
+            # priority value must be from `0` to `65535`, inclusive.
+        "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+            # dynamic routes learned by Cloud Routers. It is also applicable to routes
+            # undergoing migration.
+        "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+            # values:
+            # - 'TRANSIT' for a transit route that this router learned from
+            # another Cloud Router and will readvertise to one of its BGP peers
+            # - 'SUBNET' for a route from a subnet of the VPC
+            # - 'BGP' for a route learned from a BGP peer of this router
+            # - 'STATIC' for a static route
+        "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+        "tags": [ # A list of instance tags to which this route applies.
+          "A String",
+        ],
+        "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+            # route, this field will be populated with warning messages.
+          {
+            "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.
+          },
+        ],
+      },
+    ],
+    "bestRoutesForRouter": [ # A list of the best BGP routes learned by this Cloud Router.
+        #
+        # It is possible that routes listed might not be programmed into the data
+        # plane, if the Google Cloud control plane finds a more optimal route for a
+        # prefix than a route learned by this Cloud Router.
+      { # Represents a Route resource.
+          #
+          # A route defines a path from VM instances in the VPC network to a specific
+          # destination. This destination can be inside or outside the VPC network.
+          # For more information, read theRoutes overview.
+        "asPaths": [ # Output only. [Output Only] AS path.
+          {
+            "asLists": [ # [Output Only] The AS numbers of the AS Path.
+              42,
+            ],
+            "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+                # values:
+                # - 'AS_SET': unordered set of autonomous systems that the route
+                # in has traversed
+                # - 'AS_SEQUENCE': ordered set of autonomous
+                # systems that the route has traversed
+                # - 'AS_CONFED_SEQUENCE':
+                # ordered set of Member Autonomous Systems in the local confederation that
+                # the route has traversed
+                # - 'AS_CONFED_SET': unordered set of
+                # Member Autonomous Systems in the local confederation that the route has
+                # traversed
+          },
+        ],
+        "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+            # text format.
+        "description": "A String", # An optional description of this resource. Provide this field when you
+            # create the resource.
+        "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+            # IPv4 and IPv6 are supported.
+            # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+            # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+            # compressed format.
+        "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+            # defined by the server.
+        "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+            # Route resources.
+        "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])?`. The first character must be a
+            # lowercase letter, and all following characters (except for the last
+            # character) must be a dash, lowercase letter, or digit. The last character
+            # must be a lowercase letter or digit.
+        "network": "A String", # Fully-qualified URL of the network that this route applies to.
+        "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+            # You can only specify the internet gateway using a full or
+            # partial valid URL: projects/project/global/gateways/default-internet-gateway
+        "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+            # that will handle matching packets.
+        "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+            # packets or the IP address of the forwarding Rule.
+            # For example, the following are all valid URLs:
+            #
+            #
+            #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+            #    - regions/region/forwardingRules/forwardingRule
+            #
+            #
+            # If an IP address is provided, must specify an IPv4 address in dot-decimal
+            # notation or an IPv6 address in RFC 4291 format. For example, the following
+            # are all valid IP addresses:
+            #
+            #
+            #       - 10.128.0.56
+            #       - 2001:db8::2d9:51:0:0
+            #       - 2001:db8:0:0:2d9:51:0:0
+            #
+            #
+            # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+            # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+        "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+            # this as a full or partial URL.
+            # For example:
+            # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+        "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+            # calculates based on factors such as network performance, distance, and
+            # available bandwidth between regions.
+        "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+            # for the route.
+            # This field will only be populated for dynamic routes generated by
+            # Cloud Router with a linked interconnectAttachment or the static route
+            # generated by each L2 Interconnect Attachment.
+        "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+            # Both IPv6 address and IPv4 addresses are supported.
+            # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+            # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+            # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+            # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+            # IPv4-mapped IPv6 address.
+        "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+            # the desirability of a particular route in a network.
+        "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+        "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+            # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+            # or INCOMPLETE.
+        "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+            # which should conform to RFC1035.
+        "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+        "params": { # Additional route 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.
+              # 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.
+            "a_key": "A String",
+          },
+        },
+        "priority": 42, # The priority of this route. Priority is used to break ties in cases
+            # where there is more than one matching route of equal prefix length. In
+            # cases where multiple routes have equal prefix length, the one with the
+            # lowest-numbered priority value wins. The default value is `1000`. The
+            # priority value must be from `0` to `65535`, inclusive.
+        "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+            # dynamic routes learned by Cloud Routers. It is also applicable to routes
+            # undergoing migration.
+        "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+            # values:
+            # - 'TRANSIT' for a transit route that this router learned from
+            # another Cloud Router and will readvertise to one of its BGP peers
+            # - 'SUBNET' for a route from a subnet of the VPC
+            # - 'BGP' for a route learned from a BGP peer of this router
+            # - 'STATIC' for a static route
+        "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+        "tags": [ # A list of instance tags to which this route applies.
+          "A String",
+        ],
+        "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+            # route, this field will be populated with warning messages.
+          {
+            "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.
+          },
+        ],
+      },
+    ],
+    "bgpPeerStatus": [
+      {
+        "advertisedRoutes": [ # Routes that were advertised to the remote BGP peer
+          { # Represents a Route resource.
+              #
+              # A route defines a path from VM instances in the VPC network to a specific
+              # destination. This destination can be inside or outside the VPC network.
+              # For more information, read theRoutes overview.
+            "asPaths": [ # Output only. [Output Only] AS path.
+              {
+                "asLists": [ # [Output Only] The AS numbers of the AS Path.
+                  42,
+                ],
+                "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+                    # values:
+                    # - 'AS_SET': unordered set of autonomous systems that the route
+                    # in has traversed
+                    # - 'AS_SEQUENCE': ordered set of autonomous
+                    # systems that the route has traversed
+                    # - 'AS_CONFED_SEQUENCE':
+                    # ordered set of Member Autonomous Systems in the local confederation that
+                    # the route has traversed
+                    # - 'AS_CONFED_SET': unordered set of
+                    # Member Autonomous Systems in the local confederation that the route has
+                    # traversed
+              },
+            ],
+            "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+                # text format.
+            "description": "A String", # An optional description of this resource. Provide this field when you
+                # create the resource.
+            "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+                # IPv4 and IPv6 are supported.
+                # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+                # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+                # compressed format.
+            "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+                # defined by the server.
+            "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+                # Route resources.
+            "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])?`. The first character must be a
+                # lowercase letter, and all following characters (except for the last
+                # character) must be a dash, lowercase letter, or digit. The last character
+                # must be a lowercase letter or digit.
+            "network": "A String", # Fully-qualified URL of the network that this route applies to.
+            "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+                # You can only specify the internet gateway using a full or
+                # partial valid URL: projects/project/global/gateways/default-internet-gateway
+            "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+                # that will handle matching packets.
+            "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+                # packets or the IP address of the forwarding Rule.
+                # For example, the following are all valid URLs:
+                #
+                #
+                #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+                #    - regions/region/forwardingRules/forwardingRule
+                #
+                #
+                # If an IP address is provided, must specify an IPv4 address in dot-decimal
+                # notation or an IPv6 address in RFC 4291 format. For example, the following
+                # are all valid IP addresses:
+                #
+                #
+                #       - 10.128.0.56
+                #       - 2001:db8::2d9:51:0:0
+                #       - 2001:db8:0:0:2d9:51:0:0
+                #
+                #
+                # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+                # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+            "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+                # this as a full or partial URL.
+                # For example:
+                # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+            "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+                # calculates based on factors such as network performance, distance, and
+                # available bandwidth between regions.
+            "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+                # for the route.
+                # This field will only be populated for dynamic routes generated by
+                # Cloud Router with a linked interconnectAttachment or the static route
+                # generated by each L2 Interconnect Attachment.
+            "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+                # Both IPv6 address and IPv4 addresses are supported.
+                # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+                # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+                # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+                # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+                # IPv4-mapped IPv6 address.
+            "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+                # the desirability of a particular route in a network.
+            "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+            "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+                # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+                # or INCOMPLETE.
+            "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+                # which should conform to RFC1035.
+            "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+            "params": { # Additional route 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.
+                  # 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.
+                "a_key": "A String",
+              },
+            },
+            "priority": 42, # The priority of this route. Priority is used to break ties in cases
+                # where there is more than one matching route of equal prefix length. In
+                # cases where multiple routes have equal prefix length, the one with the
+                # lowest-numbered priority value wins. The default value is `1000`. The
+                # priority value must be from `0` to `65535`, inclusive.
+            "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+                # dynamic routes learned by Cloud Routers. It is also applicable to routes
+                # undergoing migration.
+            "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+                # values:
+                # - 'TRANSIT' for a transit route that this router learned from
+                # another Cloud Router and will readvertise to one of its BGP peers
+                # - 'SUBNET' for a route from a subnet of the VPC
+                # - 'BGP' for a route learned from a BGP peer of this router
+                # - 'STATIC' for a static route
+            "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+            "tags": [ # A list of instance tags to which this route applies.
+              "A String",
+            ],
+            "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+                # route, this field will be populated with warning messages.
+              {
+                "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.
+              },
+            ],
+          },
+        ],
+        "bfdStatus": { # Next free: 15
+          "bfdSessionInitializationMode": "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.
+          "configUpdateTimestampMicros": "A String", # Unix timestamp of the most recent config update.
+          "controlPacketCounts": { # Control packet counts for the current BFD session.
+            "numRx": 42, # Number of packets received since the beginning of the current BFD
+                # session.
+            "numRxRejected": 42, # Number of packets received that were rejected because of errors since the
+                # beginning of the current BFD session.
+            "numRxSuccessful": 42, # Number of packets received that were successfully processed since the
+                # beginning of the current BFD session.
+            "numTx": 42, # Number of packets transmitted since the beginning of the current BFD
+                # session.
+          },
+          "controlPacketIntervals": [ # Inter-packet time interval statistics for control packets.
+            { # Next free: 7
+              "avgMs": "A String", # Average observed inter-packet interval in milliseconds.
+              "duration": "A String", # From how long ago in the past these intervals were observed.
+              "maxMs": "A String", # Maximum observed inter-packet interval in milliseconds.
+              "minMs": "A String", # Minimum observed inter-packet interval in milliseconds.
+              "numIntervals": "A String", # Number of inter-packet intervals from which these statistics were derived.
+              "type": "A String", # The type of packets for which inter-packet intervals were computed.
+            },
+          ],
+          "localDiagnostic": "A String", # The diagnostic code specifies the local system's reason for the last change
+              # in session state. This allows remote systems to determine the reason that
+              # the previous session failed, for example. These diagnostic codes are
+              # specified in section 4.1 ofRFC5880
+          "localState": "A String", # The current BFD session state as seen by the transmitting system. These
+              # states are specified in section 4.1 ofRFC5880
+          "negotiatedLocalControlTxIntervalMs": 42, # Negotiated transmit interval for control packets.
+          "rxPacket": { # The most recent Rx control packet for this BFD session.
+            "authenticationPresent": True or False, # The Authentication Present bit of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "controlPlaneIndependent": True or False, # The Control Plane Independent bit of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "demand": True or False, # The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "diagnostic": "A String", # The diagnostic code specifies the local system's reason for the last change
+                # in session state. This allows remote systems to determine the reason that
+                # the previous session failed, for example. These diagnostic codes are
+                # specified in section 4.1 ofRFC5880
+            "final": True or False, # The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "length": 42, # The length of the BFD Control packet in bytes. This is specified in section
+                # 4.1 ofRFC5880
+            "minEchoRxIntervalMs": 42, # The Required Min Echo RX Interval value in the BFD packet. This is
+                # specified in section 4.1 ofRFC5880
+            "minRxIntervalMs": 42, # The Required Min RX Interval value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "minTxIntervalMs": 42, # The Desired Min TX Interval value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "multiplier": 42, # The detection time multiplier of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "multipoint": True or False, # The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "myDiscriminator": 42, # The My Discriminator value in the BFD packet. This is specified in section
+                # 4.1 ofRFC5880
+            "poll": True or False, # The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "state": "A String", # The current BFD session state as seen by the transmitting system. These
+                # states are specified in section 4.1 ofRFC5880
+            "version": 42, # The version number of the BFD protocol, as specified in section 4.1 ofRFC5880.
+            "yourDiscriminator": 42, # The Your Discriminator value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+          },
+          "txPacket": { # The most recent Tx control packet for this BFD session.
+            "authenticationPresent": True or False, # The Authentication Present bit of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "controlPlaneIndependent": True or False, # The Control Plane Independent bit of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "demand": True or False, # The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "diagnostic": "A String", # The diagnostic code specifies the local system's reason for the last change
+                # in session state. This allows remote systems to determine the reason that
+                # the previous session failed, for example. These diagnostic codes are
+                # specified in section 4.1 ofRFC5880
+            "final": True or False, # The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "length": 42, # The length of the BFD Control packet in bytes. This is specified in section
+                # 4.1 ofRFC5880
+            "minEchoRxIntervalMs": 42, # The Required Min Echo RX Interval value in the BFD packet. This is
+                # specified in section 4.1 ofRFC5880
+            "minRxIntervalMs": 42, # The Required Min RX Interval value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "minTxIntervalMs": 42, # The Desired Min TX Interval value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "multiplier": 42, # The detection time multiplier of the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+            "multipoint": True or False, # The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "myDiscriminator": 42, # The My Discriminator value in the BFD packet. This is specified in section
+                # 4.1 ofRFC5880
+            "poll": True or False, # The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880
+            "state": "A String", # The current BFD session state as seen by the transmitting system. These
+                # states are specified in section 4.1 ofRFC5880
+            "version": 42, # The version number of the BFD protocol, as specified in section 4.1 ofRFC5880.
+            "yourDiscriminator": 42, # The Your Discriminator value in the BFD packet. This is specified in
+                # section 4.1 ofRFC5880
+          },
+          "uptimeMs": "A String", # Session uptime in milliseconds. Value will be 0 if session is not up.
+        },
+        "enableIpv4": True or False, # Output only. Enable IPv4 traffic over BGP Peer.
+            # It is enabled by default if the peerIpAddress is version 4.
+        "enableIpv6": True or False, # Output only. Enable IPv6 traffic over BGP Peer.
+            # It is enabled by default if the peerIpAddress is version 6.
+        "ipAddress": "A String", # Output only. IP address of the local BGP interface.
+        "ipv4NexthopAddress": "A String", # Output only. IPv4 address of the local BGP interface.
+        "ipv6NexthopAddress": "A String", # Output only. IPv6 address of the local BGP interface.
+        "linkedVpnTunnel": "A String", # Output only. URL of the VPN tunnel that this BGP peer controls.
+        "md5AuthEnabled": True or False, # Informs whether MD5 authentication is enabled on this BGP peer.
+        "name": "A String", # Output only. Name of this BGP peer. Unique within the Routers resource.
+        "numLearnedRoutes": 42, # Output only. Number of routes learned from the remote BGP Peer.
+        "peerIpAddress": "A String", # Output only. IP address of the remote BGP interface.
+        "peerIpv4NexthopAddress": "A String", # Output only. IPv4 address of the remote BGP interface.
+        "peerIpv6NexthopAddress": "A String", # Output only. IPv6 address of the remote BGP interface.
+        "routerApplianceInstance": "A String", # Output only. [Output only] 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 is the peer side of the BGP session.
+        "state": "A String", # Output only. The state of the BGP session. For a list of possible values for this
+            # field, seeBGP session states.
+        "status": "A String", # Output only. Status of the BGP peer: {UP, DOWN}
+        "statusReason": "A String", # Indicates why particular status was returned.
+        "uptime": "A String", # Output only. Time this session has been up.
+            # Format:
+            #  14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds
+        "uptimeSeconds": "A String", # Output only. Time this session has been up, in seconds.
+            # Format:
+            #  145
+      },
+    ],
+    "natStatus": [
+      { # Status of a NAT contained in this router.
+        "autoAllocatedNatIps": [ # Output only. A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", "129.2.16.89"]
+          "A String",
+        ],
+        "drainAutoAllocatedNatIps": [ # Output only. A list of IPs auto-allocated for NAT that are in drain mode.
+            # Example: ["1.1.1.1", "179.12.26.133"].
+          "A String",
+        ],
+        "drainUserAllocatedNatIps": [ # Output only. A list of IPs user-allocated for NAT that are in drain mode.
+            # Example: ["1.1.1.1", "179.12.26.133"].
+          "A String",
+        ],
+        "minExtraNatIpsNeeded": 42, # Output only. The number of extra IPs to allocate. This will be greater than 0 only if
+            # user-specified IPs are NOT enough to allow all configured VMs to use NAT.
+            # This value is meaningful only when auto-allocation of NAT IPs is *not*
+            # used.
+        "name": "A String", # Output only. Unique name of this NAT.
+        "numVmEndpointsWithNatMappings": 42, # Output only. Number of VM endpoints (i.e., Nics) that can use NAT.
+        "ruleStatus": [ # Status of rules in this NAT.
+          { # Status of a NAT Rule contained in this NAT.
+            "activeNatIps": [ # Output only. A list of active IPs for NAT.
+                # Example: ["1.1.1.1", "179.12.26.133"].
+              "A String",
+            ],
+            "drainNatIps": [ # Output only. A list of IPs for NAT that are in drain mode.
+                # Example: ["1.1.1.1", "179.12.26.133"].
+              "A String",
+            ],
+            "minExtraIpsNeeded": 42, # Output only. The number of extra IPs to allocate. This will be greater than 0 only
+                # if the existing IPs in this NAT Rule are NOT enough to allow all
+                # configured VMs to use NAT.
+            "numVmEndpointsWithNatMappings": 42, # Output only. Number of VM endpoints (i.e., NICs) that have NAT Mappings from this
+                # NAT Rule.
+            "ruleNumber": 42, # Output only. Rule number of the rule.
+          },
+        ],
+        "userAllocatedNatIpResources": [ # Output only. A list of fully qualified URLs of reserved IP address resources.
+          "A String",
+        ],
+        "userAllocatedNatIps": [ # Output only. A list of IPs user-allocated for NAT.
+            # They will be raw IP strings like "179.12.26.133".
+          "A String",
+        ],
+      },
+    ],
+    "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.
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a Router resource in the specified project and region using
+the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (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",
+      ],
+      "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+          # state. This value is equal to tcp_time_wait_timeout_sec.
+          # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+          # 120s. The field is output only.
+      "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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of Router resources available to the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 Router resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Router resources.
+    { # 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",
+          ],
+          "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+              # state. This value is equal to tcp_time_wait_timeout_sec.
+              # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+              # 120s. The field is output only.
+          "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.
+    },
+  ],
+  "kind": "compute#routerList", # Output only. [Output Only] Type of resource. Always compute#router for
+      # routers.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listBgpRoutes(project, region, router, addressFamily=None, destinationPrefix=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peer=None, policyApplied=None, routeType=None, x__xgafv=None) + 
Retrieves a list of router bgp routes 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 or id of the resource for this request.
+Name should conform to RFC1035. (required)
+  addressFamily: string, (Required) limit results to this address family (either IPv4 or IPv6)
+    Allowed values
+      IPV4 - 
+      IPV6 - 
+      UNSPECIFIED_IP_VERSION - 
+  destinationPrefix: string, Limit results to destinations that are subnets of this CIDR range
+  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.
+  peer: string, (Required) limit results to the BGP peer with the given name.
+Name should conform to RFC1035.
+  policyApplied: boolean, When true, the method returns post-policy routes. Otherwise, it returns
+pre-policy routes.
+  routeType: string, (Required) limit results to this type of route (either LEARNED or
+ADVERTISED)
+    Allowed values
+      ADVERTISED - 
+      LEARNED - 
+      UNSPECIFIED_ROUTE_TYPE - 
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#routersListBgpRoutes", # Output only. [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes.
+  "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 bgp routes.
+    {
+      "asPaths": [ # Output only. [Output only] AS-PATH for the route
+        {
+          "asns": [ # Output only. [Output only] ASNs in the path segment. When type is SEQUENCE, these are
+              # ordered.
+            42,
+          ],
+          "asns32": [ # Output only. [Output only] ASNs in the path segment. This field is for better
+              # support of 32 bit ASNs as the other asns field suffers from overflow when
+              # the ASN is larger. When type is SEQUENCE, these are ordered.
+            42,
+          ],
+          "type": "A String", # Output only. [Output only] Type of AS-PATH segment (SEQUENCE or SET)
+        },
+      ],
+      "communities": [ # Output only. [Output only] BGP communities in human-readable A:B format.
+        "A String",
+      ],
+      "destination": { # Network Layer Reachability Information (NLRI) for a route. # Output only. [Output only] Destination IP range for the route, in human-readable CIDR
+          # format
+        "pathId": 42, # If the BGP session supports multiple paths (RFC 7911), the path
+            # identifier for this route.
+        "prefix": "A String", # Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16.
+      },
+      "med": 42, # Output only. [Output only] BGP multi-exit discriminator
+      "origin": "A String", # Output only. [Output only] BGP origin (EGP, IGP or INCOMPLETE)
+    },
+  ],
+  "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.
+  },
+}
+
+ +
+ listBgpRoutes_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.
+
+
+ +
+ listNamedSets(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of router named set 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 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "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 named sets.
+    {
+      "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
+    },
+  ],
+  "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.
+  },
+}
+
+ +
+ listNamedSets_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.
+
+
+ +
+ listRoutePolicies(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=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 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "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.
+          #
+          # 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",
+    },
+  ],
+  "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.
+  },
+}
+
+ +
+ 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.
+          #
+          #
+          # 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",
+      ],
+      "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+          # state. This value is equal to tcp_time_wait_timeout_sec.
+          # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+          # 120s. The field is output only.
+      "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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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 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.
+    },
+  ],
+  "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
+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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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 where Route Policy 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.
+    },
+  ],
+  "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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",
+    ],
+    "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",
+      ],
+      "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+          # state. This value is equal to tcp_time_wait_timeout_sec.
+          # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+          # 120s. The field is output only.
+      "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.
+}
+
+  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",
+        ],
+        "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+            # state. This value is equal to tcp_time_wait_timeout_sec.
+            # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+            # 120s. The field is output only.
+        "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.
+  },
+}
+
+ +
+ 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",
+      ],
+      "effectiveTcpTimeWaitTimeoutSec": 42, # Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT
+          # state. This value is equal to tcp_time_wait_timeout_sec.
+          # If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or
+          # 120s. The field is output only.
+      "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/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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ 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.
+    },
+  ],
+  "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
+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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ updateRoutePolicy(project, region, router, body=None, requestId=None, x__xgafv=None) + 
Updates or creates new 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 where Route Policy 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.
+    },
+  ],
+  "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.routes.html b/docs/dyn/compute_preview.routes.html new file mode 100644 index 0000000000..fe92316669 --- /dev/null +++ b/docs/dyn/compute_preview.routes.html @@ -0,0 +1,1400 @@ + + + +

Compute Engine API . routes

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, route, requestId=None, x__xgafv=None)

+

Deletes the specified Route resource.

+

+ get(project, route, x__xgafv=None)

+

Returns the specified Route resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a Route resource in the specified project using the data included

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Route resources available to the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ 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, route, requestId=None, x__xgafv=None) + 
Deletes the specified Route resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  route: string, Name of the Route 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, route, x__xgafv=None) + 
Returns the specified Route resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  route: string, Name of the Route 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 Route resource.
+    #
+    # A route defines a path from VM instances in the VPC network to a specific
+    # destination. This destination can be inside or outside the VPC network.
+    # For more information, read theRoutes overview.
+  "asPaths": [ # Output only. [Output Only] AS path.
+    {
+      "asLists": [ # [Output Only] The AS numbers of the AS Path.
+        42,
+      ],
+      "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+          # values:
+          # - 'AS_SET': unordered set of autonomous systems that the route
+          # in has traversed
+          # - 'AS_SEQUENCE': ordered set of autonomous
+          # systems that the route has traversed
+          # - 'AS_CONFED_SEQUENCE':
+          # ordered set of Member Autonomous Systems in the local confederation that
+          # the route has traversed
+          # - 'AS_CONFED_SET': unordered set of
+          # Member Autonomous Systems in the local confederation that the route has
+          # traversed
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+      # IPv4 and IPv6 are supported.
+      # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+      # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+      # compressed format.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+      # Route resources.
+  "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])?`. The first character must be a
+      # lowercase letter, and all following characters (except for the last
+      # character) must be a dash, lowercase letter, or digit. The last character
+      # must be a lowercase letter or digit.
+  "network": "A String", # Fully-qualified URL of the network that this route applies to.
+  "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+      # You can only specify the internet gateway using a full or
+      # partial valid URL: projects/project/global/gateways/default-internet-gateway
+  "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+      # that will handle matching packets.
+  "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+      # packets or the IP address of the forwarding Rule.
+      # For example, the following are all valid URLs:
+      #
+      #
+      #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #    - regions/region/forwardingRules/forwardingRule
+      #
+      #
+      # If an IP address is provided, must specify an IPv4 address in dot-decimal
+      # notation or an IPv6 address in RFC 4291 format. For example, the following
+      # are all valid IP addresses:
+      #
+      #
+      #       - 10.128.0.56
+      #       - 2001:db8::2d9:51:0:0
+      #       - 2001:db8:0:0:2d9:51:0:0
+      #
+      #
+      # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+      # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+  "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+      # this as a full or partial URL.
+      # For example:
+      # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+  "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+      # calculates based on factors such as network performance, distance, and
+      # available bandwidth between regions.
+  "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+      # for the route.
+      # This field will only be populated for dynamic routes generated by
+      # Cloud Router with a linked interconnectAttachment or the static route
+      # generated by each L2 Interconnect Attachment.
+  "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+      # Both IPv6 address and IPv4 addresses are supported.
+      # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+      # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+      # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+      # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+      # IPv4-mapped IPv6 address.
+  "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+      # the desirability of a particular route in a network.
+  "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+  "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+      # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+      # or INCOMPLETE.
+  "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+      # which should conform to RFC1035.
+  "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+  "params": { # Additional route 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # The priority of this route. Priority is used to break ties in cases
+      # where there is more than one matching route of equal prefix length. In
+      # cases where multiple routes have equal prefix length, the one with the
+      # lowest-numbered priority value wins. The default value is `1000`. The
+      # priority value must be from `0` to `65535`, inclusive.
+  "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+      # dynamic routes learned by Cloud Routers. It is also applicable to routes
+      # undergoing migration.
+  "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+      # values:
+      # - 'TRANSIT' for a transit route that this router learned from
+      # another Cloud Router and will readvertise to one of its BGP peers
+      # - 'SUBNET' for a route from a subnet of the VPC
+      # - 'BGP' for a route learned from a BGP peer of this router
+      # - 'STATIC' for a static route
+  "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+  "tags": [ # A list of instance tags to which this route applies.
+    "A String",
+  ],
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # route, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a Route resource 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 Route resource.
+    # 
+    # A route defines a path from VM instances in the VPC network to a specific
+    # destination. This destination can be inside or outside the VPC network.
+    # For more information, read theRoutes overview.
+  "asPaths": [ # Output only. [Output Only] AS path.
+    {
+      "asLists": [ # [Output Only] The AS numbers of the AS Path.
+        42,
+      ],
+      "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+          # values:
+          # - 'AS_SET': unordered set of autonomous systems that the route
+          # in has traversed
+          # - 'AS_SEQUENCE': ordered set of autonomous
+          # systems that the route has traversed
+          # - 'AS_CONFED_SEQUENCE':
+          # ordered set of Member Autonomous Systems in the local confederation that
+          # the route has traversed
+          # - 'AS_CONFED_SET': unordered set of
+          # Member Autonomous Systems in the local confederation that the route has
+          # traversed
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this field when you
+      # create the resource.
+  "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+      # IPv4 and IPv6 are supported.
+      # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+      # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+      # compressed format.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+      # Route resources.
+  "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])?`. The first character must be a
+      # lowercase letter, and all following characters (except for the last
+      # character) must be a dash, lowercase letter, or digit. The last character
+      # must be a lowercase letter or digit.
+  "network": "A String", # Fully-qualified URL of the network that this route applies to.
+  "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+      # You can only specify the internet gateway using a full or
+      # partial valid URL: projects/project/global/gateways/default-internet-gateway
+  "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+      # that will handle matching packets.
+  "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+      # packets or the IP address of the forwarding Rule.
+      # For example, the following are all valid URLs:
+      # 
+      # 
+      #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+      #    - regions/region/forwardingRules/forwardingRule
+      # 
+      # 
+      # If an IP address is provided, must specify an IPv4 address in dot-decimal
+      # notation or an IPv6 address in RFC 4291 format. For example, the following
+      # are all valid IP addresses:
+      # 
+      # 
+      #       - 10.128.0.56
+      #       - 2001:db8::2d9:51:0:0
+      #       - 2001:db8:0:0:2d9:51:0:0
+      # 
+      # 
+      # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+      # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+  "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+      # this as a full or partial URL.
+      # For example:
+      # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+  "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+      # calculates based on factors such as network performance, distance, and
+      # available bandwidth between regions.
+  "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+      # for the route.
+      # This field will only be populated for dynamic routes generated by
+      # Cloud Router with a linked interconnectAttachment or the static route
+      # generated by each L2 Interconnect Attachment.
+  "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+      # Both IPv6 address and IPv4 addresses are supported.
+      # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+      # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+      # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+      # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+      # IPv4-mapped IPv6 address.
+  "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+      # the desirability of a particular route in a network.
+  "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+  "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+      # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+      # or INCOMPLETE.
+  "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+      # which should conform to RFC1035.
+  "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+  "params": { # Additional route 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "priority": 42, # The priority of this route. Priority is used to break ties in cases
+      # where there is more than one matching route of equal prefix length. In
+      # cases where multiple routes have equal prefix length, the one with the
+      # lowest-numbered priority value wins. The default value is `1000`. The
+      # priority value must be from `0` to `65535`, inclusive.
+  "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+      # dynamic routes learned by Cloud Routers. It is also applicable to routes
+      # undergoing migration.
+  "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+      # values:
+      # - 'TRANSIT' for a transit route that this router learned from
+      # another Cloud Router and will readvertise to one of its BGP peers
+      # - 'SUBNET' for a route from a subnet of the VPC
+      # - 'BGP' for a route learned from a BGP peer of this router
+      # - 'STATIC' for a static route
+  "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+  "tags": [ # A list of instance tags to which this route applies.
+    "A String",
+  ],
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # route, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of Route resources available to 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.
+  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 Route resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Route resources.
+    { # Represents a Route resource.
+        #
+        # A route defines a path from VM instances in the VPC network to a specific
+        # destination. This destination can be inside or outside the VPC network.
+        # For more information, read theRoutes overview.
+      "asPaths": [ # Output only. [Output Only] AS path.
+        {
+          "asLists": [ # [Output Only] The AS numbers of the AS Path.
+            42,
+          ],
+          "pathSegmentType": "A String", # [Output Only] The type of the AS Path, which can be one of the following
+              # values:
+              # - 'AS_SET': unordered set of autonomous systems that the route
+              # in has traversed
+              # - 'AS_SEQUENCE': ordered set of autonomous
+              # systems that the route has traversed
+              # - 'AS_CONFED_SEQUENCE':
+              # ordered set of Member Autonomous Systems in the local confederation that
+              # the route has traversed
+              # - 'AS_CONFED_SET': unordered set of
+              # Member Autonomous Systems in the local confederation that the route has
+              # traversed
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this field when you
+          # create the resource.
+      "destRange": "A String", # The destination range of outgoing packets that this route applies to. Both
+          # IPv4 and IPv6 are supported.
+          # Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291
+          # format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952
+          # compressed format.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#route", # Output only. [Output Only] Type of this resource. Always compute#routes for
+          # Route resources.
+      "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])?`. The first character must be a
+          # lowercase letter, and all following characters (except for the last
+          # character) must be a dash, lowercase letter, or digit. The last character
+          # must be a lowercase letter or digit.
+      "network": "A String", # Fully-qualified URL of the network that this route applies to.
+      "nextHopGateway": "A String", # The URL to a gateway that should handle matching packets.
+          # You can only specify the internet gateway using a full or
+          # partial valid URL: projects/project/global/gateways/default-internet-gateway
+      "nextHopHub": "A String", # Output only. [Output Only] The full resource name of the Network Connectivity Center hub
+          # that will handle matching packets.
+      "nextHopIlb": "A String", # The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching
+          # packets or the IP address of the forwarding Rule.
+          # For example, the following are all valid URLs:
+          #
+          #
+          #       - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
+          #    - regions/region/forwardingRules/forwardingRule
+          #
+          #
+          # If an IP address is provided, must specify an IPv4 address in dot-decimal
+          # notation or an IPv6 address in RFC 4291 format. For example, the following
+          # are all valid IP addresses:
+          #
+          #
+          #       - 10.128.0.56
+          #       - 2001:db8::2d9:51:0:0
+          #       - 2001:db8:0:0:2d9:51:0:0
+          #
+          #
+          # IPv6 addresses will be displayed using RFC 5952 compressed format (e.g.
+          # 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.
+      "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify
+          # this as a full or partial URL.
+          # For example:
+          # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
+      "nextHopInterRegionCost": 42, # Output only. [Output only] Internal fixed region-to-region cost that Google Cloud
+          # calculates based on factors such as network performance, distance, and
+          # available bandwidth between regions.
+      "nextHopInterconnectAttachment": "A String", # Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop
+          # for the route.
+          # This field will only be populated for dynamic routes generated by
+          # Cloud Router with a linked interconnectAttachment or the static route
+          # generated by each L2 Interconnect Attachment.
+      "nextHopIp": "A String", # The network IP address of an instance that should handle matching packets.
+          # Both IPv6 address and IPv4 addresses are supported.
+          # Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or
+          # an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or
+          # 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952
+          # compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an
+          # IPv4-mapped IPv6 address.
+      "nextHopMed": 42, # Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates
+          # the desirability of a particular route in a network.
+      "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
+      "nextHopOrigin": "A String", # Output only. [Output Only] Indicates the origin of the route. Can be IGP
+          # (Interior Gateway Protocol), EGP (Exterior Gateway Protocol),
+          # or INCOMPLETE.
+      "nextHopPeering": "A String", # Output only. [Output Only] The network peering name that should handle matching packets,
+          # which should conform to RFC1035.
+      "nextHopVpnTunnel": "A String", # The URL to a VpnTunnel that should handle matching packets.
+      "params": { # Additional route 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "priority": 42, # The priority of this route. Priority is used to break ties in cases
+          # where there is more than one matching route of equal prefix length. In
+          # cases where multiple routes have equal prefix length, the one with the
+          # lowest-numbered priority value wins. The default value is `1000`. The
+          # priority value must be from `0` to `65535`, inclusive.
+      "routeStatus": "A String", # [Output only] The status of the route. This status applies to
+          # dynamic routes learned by Cloud Routers. It is also applicable to routes
+          # undergoing migration.
+      "routeType": "A String", # Output only. [Output Only] The type of this route, which can be one of the following
+          # values:
+          # - 'TRANSIT' for a transit route that this router learned from
+          # another Cloud Router and will readvertise to one of its BGP peers
+          # - 'SUBNET' for a route from a subnet of the VPC
+          # - 'BGP' for a route learned from a BGP peer of this router
+          # - 'STATIC' for a static route
+      "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
+      "tags": [ # A list of instance tags to which this route applies.
+        "A String",
+      ],
+      "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+          # route, this field will be populated with warning messages.
+        {
+          "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#routeList", # 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.
+  "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.
+
+
+ +
+ 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_preview.securityPolicies.html b/docs/dyn/compute_preview.securityPolicies.html new file mode 100644 index 0000000000..f8daee4061 --- /dev/null +++ b/docs/dyn/compute_preview.securityPolicies.html @@ -0,0 +1,7225 @@ + + + +

Compute Engine API . securityPolicies

+

Instance Methods

+

+ addRule(project, securityPolicy, body=None, validateOnly=None, x__xgafv=None)

+

Inserts a rule into a security policy.

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all SecurityPolicy resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, securityPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified policy.

+

+ get(project, securityPolicy, x__xgafv=None)

+

List all of the ordered rules present in a single specified policy.

+

+ getRule(project, securityPolicy, priority=None, x__xgafv=None)

+

Gets a rule at the specified priority.

+

+ insert(project, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates a new policy in the specified project using the data included in

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

List all the policies that have been configured for the specified project.

+

+ listPreconfiguredExpressionSets(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Gets the current list of preconfigured Web Application Firewall (WAF)

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patches the specified policy with the data included in the request. To

+

+ patchRule(project, securityPolicy, body=None, priority=None, updateMask=None, validateOnly=None, x__xgafv=None)

+

Patches a rule at the specified priority. To clear fields in the rule,

+

+ removeRule(project, securityPolicy, priority=None, x__xgafv=None)

+

Deletes a rule at the specified priority.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on a security policy. To learn more about labels,

+

Method Details

+
+ addRule(project, securityPolicy, body=None, validateOnly=None, x__xgafv=None) + 
Inserts a rule into a security policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all SecurityPolicy resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of SecurityPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of security policies.
+      "securityPolicies": [ # A list of SecurityPolicies contained in this scope.
+        { # Represents a Google Cloud Armor security policy resource.
+            #
+            # Only external backend services that use load balancers can
+            # reference a security policy. For more information, see
+            # Google Cloud Armor security policy overview.
+          "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+            "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+                # This field is only supported in Global Security Policies of type
+                # CLOUD_ARMOR.
+              "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+                  # This field is only supported in Global Security Policies of type
+                  # CLOUD_ARMOR.
+              "ruleVisibility": "A String", # Rule visibility can be one of the following:
+                  # STANDARD - opaque rules. (default)
+                  # PREMIUM - transparent rules.
+                  # This field is only supported in Global Security Policies of type
+                  # CLOUD_ARMOR.
+              "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+                  # customizable thresholds.
+                {
+                  "autoDeployConfidenceThreshold": 3.14,
+                  "autoDeployExpirationSec": 42,
+                  "autoDeployImpactedBaselineThreshold": 3.14,
+                  "autoDeployLoadThreshold": 3.14,
+                  "detectionAbsoluteQps": 3.14,
+                  "detectionLoadThreshold": 3.14,
+                  "detectionRelativeToBaselineQps": 3.14,
+                  "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+                      # The name must be unique within the security policy.
+                  "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+                      # on specified granular traffic units.
+                    { # Configurations to specifc granular traffic units processed by
+                        # Adaptive Protection.
+                      "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                          # type constitutes a separate traffic unit.
+                          # It can only be set to true if `value` is empty.
+                      "type": "A String", # Type of this configuration.
+                      "value": "A String", # Requests that match this value constitute a granular traffic unit.
+                    },
+                  ],
+                },
+              ],
+            },
+          },
+          "advancedOptionsConfig": {
+            "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+                # json_parsing is set to STANDARD.
+              "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+                  #
+                  # As per RFC 1341, a Content-Type header value has the following format:
+                  #
+                  # Content-Type := type "/" subtype *[";" parameter]
+                  #
+                  # When configuring a custom Content-Type header value, only the
+                  # type/subtype needs to be specified, and the parameters should be
+                  # excluded.
+                "A String",
+              ],
+            },
+            "jsonParsing": "A String",
+            "logLevel": "A String",
+            "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+                # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+                # Values are case insensitive.
+            "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+                # resolving the callers client IP address.
+              "A String",
+            ],
+          },
+          "associations": [ # A list of associations that belong to this policy.
+            {
+              "attachmentId": "A String", # The resource that the security policy is attached to.
+              "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+              "excludedFolders": [ # A list of folders to exclude from the security policy.
+                "A String",
+              ],
+              "excludedProjects": [ # A list of projects to exclude from the security policy.
+                "A String",
+              ],
+              "name": "A String", # The name for an association.
+              "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+              "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+            },
+          ],
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "ddosProtectionConfig": {
+            "ddosAdaptiveProtection": "A String",
+            "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+                # builds DDoS mitigations that minimize collateral damage. It quantifies
+                # this as the fraction of a non-abuse baseline that's inadvertently
+                # blocked.
+                #
+                # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+                # not be deployed. Using a lower value will prioritize keeping collateral
+                # damage low, possibly at the cost of its effectiveness in rate limiting
+                # some or all of the attack. It should typically be unset, so Advanced DDoS
+                # (and Adaptive Protection) uses the best mitigation it can find. Setting
+                # the threshold is advised if there are logs for false positive detections
+                # with high collateral damage, and will cause Advanced DDoS to attempt to
+                # find a less aggressive rule that satisfies the constraint. If a suitable
+                # rule cannot be found, the system falls back to either no mitigation for
+                # smaller attacks or broader network throttles for larger ones.
+            "ddosProtection": "A String",
+          },
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+              # the metadata's contents and used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update metadata. You must always provide an
+              # up-to-date fingerprint hash in order to update or change metadata,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # security policy.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+              # is essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels.
+              #
+              # To see the latest fingerprint, make get() request to the
+              # security policy.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "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.
+          "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+          "recaptchaOptionsConfig": {
+            "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+                # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+                # the security policy. The specified site key needs to be created from the
+                # reCAPTCHA API. The user is responsible for the validity of the specified
+                # site key. If not specified, a Google-managed site key is used.
+                # This field is only supported in Global Security Policies of type
+                # CLOUD_ARMOR.
+          },
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+              # resides. This field is not applicable to global security policies.
+          "rules": [ # A list of rules that belong to this policy.
+              # There must always be a default rule which is a rule with priority
+              # 2147483647 and match all condition (for the match condition this means
+              # match  "*" for srcIpRanges and for the networkMatch condition every field
+              # must be either match "*" or not set). If no rules are provided when
+              # creating a security policy, a default rule with action "allow" will be
+              # added.
+            { # Represents a rule that describes one or more match conditions along with
+                # the action to be taken when traffic matches this condition (allow or deny).
+              "action": "A String", # The Action to perform when the rule is matched.
+                  # The following are the valid actions:
+                  #
+                  #    - allow: allow access to target.
+                  #    - deny(STATUS): deny access to target, returns the
+                  #    HTTP response code specified. Valid values for `STATUS`
+                  #    are 403, 404, and 502.
+                  #    - rate_based_ban: limit client traffic to the configured
+                  #    threshold and ban the client if the traffic exceeds the threshold.
+                  #    Configure parameters for this action in RateLimitOptions. Requires
+                  #    rate_limit_options to be set.
+                  #    - redirect: redirect to a different target. This can
+                  #    either be an internal reCAPTCHA redirect, or an external URL-based
+                  #    redirect via a 302 response. Parameters for this action can be configured
+                  #    via redirectOptions. This action is only supported in Global Security
+                  #    Policies of type CLOUD_ARMOR.
+                  #    - throttle: limit
+                  #    client traffic to the configured threshold. Configure parameters for this
+                  #    action in rateLimitOptions. Requires rate_limit_options to be set for
+                  #    this.
+                  #    - fairshare (preview only): when traffic reaches the
+                  #    threshold limit, requests from the clients matching this rule begin to be
+                  #    rate-limited using the Fair Share algorithm. This action is only allowed
+                  #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "headerAction": { # Optional, additional actions that are performed on headers.
+                  # This field is only supported in Global Security Policies of type
+                  # CLOUD_ARMOR.
+                "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+                    # present.
+                  {
+                    "headerName": "A String", # The name of the header to set.
+                    "headerValue": "A String", # The value to set the named header to.
+                  },
+                ],
+              },
+              "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+              "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+                  # If it evaluates to true, the corresponding 'action' is enforced.
+                  # Exactly one field must be specified.
+                "config": { # The configuration options available when specifying versioned_expr.
+                    # This field must be specified if versioned_expr is specified and cannot
+                    # be specified if versioned_expr is not specified.
+                  "srcIpRanges": [ # CIDR IP address range.
+                      # Maximum number of src_ip_ranges allowed is 10.
+                    "A String",
+                  ],
+                },
+                "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+                    # A CEVAL expression is used to specify match criteria such as origin.ip,
+                    # source.region_code and contents in the request header.
+                    # Expressions containing `evaluateThreatIntelligence` require a Cloud
+                    # Armor Enterprise subscription and are not supported in Edge Policies
+                    # nor in Regional Policies. Expressions containing
+                    # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+                    # Enterprise subscription and are only supported in Global Security
+                    # 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.
+                },
+                "exprOptions": { # The configuration options available when specifying a user defined
+                    # CEVAL expression (i.e., 'expr').
+                  "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+                      # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+                    "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                        # action-tokens. The provided site keys need to be created from
+                        # reCAPTCHA API under the same project where the security policy is
+                        # created.
+                      "A String",
+                    ],
+                    "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                        # session-tokens. The provided site keys need to be created from
+                        # reCAPTCHA API under the same project where the security policy is
+                        # created.
+                      "A String",
+                    ],
+                  },
+                },
+                "versionedExpr": "A String", # Preconfigured versioned expression.
+                    # If this field is specified, config must also be specified.
+                    # Available preconfigured expressions along with their requirements are:
+                    # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+                    # config.
+              },
+              "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+                  # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+                  # 'action' is enforced.
+                  #
+                  # The match criteria for a rule consists of built-in match fields (like
+                  # 'srcIpRanges') and potentially multiple user-defined match fields
+                  # ('userDefinedFields').
+                  #
+                  # Field values may be extracted directly from the packet or derived from it
+                  # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+                  # (e.g. 'srcPorts'). A user-defined field is only present if the base
+                  # header is found in the packet and the entire field is in bounds.
+                  #
+                  # Each match field may specify which values can match it, listing one or
+                  # more ranges, prefixes, or exact values that are considered a match for
+                  # the field. A field value must be present in order to match a specified
+                  # match field. If no match values are specified for a match field, then any
+                  # field value is considered to match it, and it's not required to be
+                  # present. For strings specifying '*' is also equivalent to match all.
+                  #
+                  # For a packet to match a rule, all specified match fields must match the
+                  # corresponding field values derived from the packet.
+                  #
+                  # Example:
+                  #
+                  # networkMatch:
+                  #   srcIpRanges:
+                  #   - "192.0.2.0/24"
+                  #   - "198.51.100.0/24"
+                  #   userDefinedFields:
+                  #   - name: "ipv4_fragment_offset"
+                  #     values:
+                  #     - "1-0x1fff"
+                  #
+                  # The above match condition matches packets with a source IP in
+                  # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+                  # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+                  # against.
+                "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+                    # format.
+                  "A String",
+                ],
+                "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                    # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+                  "A String",
+                ],
+                "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+                    # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+                    # "253-254"), or one of the following protocol names: "tcp", "udp",
+                    # "icmp", "esp", "ah", "ipip", or "sctp".
+                  "A String",
+                ],
+                "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+                  42,
+                ],
+                "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+                  "A String",
+                ],
+                "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                    # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+                  "A String",
+                ],
+                "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+                    # IP address.
+                  "A String",
+                ],
+                "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+                    # matching values for that field.
+                  {
+                    "name": "A String", # Name of the user-defined field, as given in the definition.
+                    "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                        # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                        # range (e.g.  "0x400-0x7ff").
+                      "A String",
+                    ],
+                  },
+                ],
+              },
+              "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+                  # does not evaluate preconfigured WAF rules, i.e., if
+                  # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+                "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+                  {
+                    "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                        # preconfigured WAF evaluation.
+                      {
+                        "op": "A String", # The match operator for the field.
+                        "val": "A String", # The value of the field.
+                      },
+                    ],
+                    "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                        # inspection during preconfigured WAF evaluation.
+                      {
+                        "op": "A String", # The match operator for the field.
+                        "val": "A String", # The value of the field.
+                      },
+                    ],
+                    "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                        # inspection during preconfigured WAF evaluation.
+                      {
+                        "op": "A String", # The match operator for the field.
+                        "val": "A String", # The value of the field.
+                      },
+                    ],
+                    "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                        # from inspection during preconfigured WAF evaluation. Note that the
+                        # parameter can be in the query string or in the POST body.
+                      {
+                        "op": "A String", # The match operator for the field.
+                        "val": "A String", # The value of the field.
+                      },
+                    ],
+                    "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                        # inspection during preconfigured WAF evaluation. When specifying this
+                        # field, the query or fragment part should be excluded.
+                      {
+                        "op": "A String", # The match operator for the field.
+                        "val": "A String", # The value of the field.
+                      },
+                    ],
+                    "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                        # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                        # IDs under the WAF rule set.
+                      "A String",
+                    ],
+                    "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+                  },
+                ],
+              },
+              "preview": True or False, # If set to true, the specified action is not enforced.
+              "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+                  # must be a positive value between 0 and 2147483647.
+                  # Rules are evaluated from highest to lowest priority where 0 is the
+                  # highest priority and 2147483647 is the lowest priority.
+              "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+                  # "fairshare". Cannot be specified for any other actions.
+                "banDurationSec": 42, # Can only be specified if the action for the rule is
+                    # "rate_based_ban". If specified, determines the time (in seconds)
+                    # the traffic will continue to be banned by the rate limit after the
+                    # rate falls below the threshold.
+                "banThreshold": { # Can only be specified if the action for the rule is
+                    # "rate_based_ban". If specified, the key will be banned for the
+                    # configured 'ban_duration_sec' when the number of requests that exceed
+                    # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+                  "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+                  "intervalSec": 42, # Interval over which the threshold is computed.
+                },
+                "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+                    # threshold. Valid option is "allow" only.
+                "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                    # values are:
+                    #
+                    #    - ALL: A single rate limit threshold is applied to all
+                    #    the requests matching this rule. This is the default value if
+                    #    "enforceOnKey" is not configured.
+                    #    - IP: The source IP address of
+                    #    the request is the key. Each IP has this limit enforced
+                    #    separately.
+                    #    - HTTP_HEADER: The value of the HTTP
+                    #    header whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the header value. If no
+                    #    such header is present in the request, the key type defaults toALL.
+                    #    - XFF_IP: The first IP address (i.e. the
+                    #    originating client IP address) specified in the list of IPs under
+                    #    X-Forwarded-For HTTP header. If no such header is present or the value
+                    #    is not a valid IP, the key defaults to the source IP address of
+                    #    the request i.e. key type IP.
+                    #    - HTTP_COOKIE: The value of the HTTP
+                    #    cookie whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the cookie value. If no
+                    #    such cookie is present in the request, the key type defaults toALL.
+                    #    - HTTP_PATH: The URL path of the HTTP request. The key
+                    #    value is truncated to the first 128 bytes.
+                    #    - SNI: Server name indication in the TLS session of the
+                    #    HTTPS request. The key value is truncated to the first 128 bytes. The
+                    #    key type defaults to ALL on a HTTP session.
+                    #    - REGION_CODE: The country/region from which the request
+                    #    originates.
+                    #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+                    #    - USER_IP: The IP address of the originating client,
+                    #    which is resolved based on "userIpRequestHeaders" configured with the
+                    #    security policy. If there is no "userIpRequestHeaders" configuration or
+                    #    an IP address cannot be resolved from it, the key type defaults toIP.
+                    #    - ASN: The autonomous system number of the originating
+                    #    client. If not available, the key type defaults toALL.
+                    #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+                    #
+                    #
+                    # For "fairshare" action, this value is limited to ALL i.e. a single rate
+                    # limit threshold is enforced for all the requests matching the rule.
+                "enforceOnKeyConfigs": [ # If specified, any combination of values of
+                    # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+                    # ratelimit threshold/action is enforced. You can specify up to 3
+                    # enforce_on_key_configs. If enforce_on_key_configs is specified,
+                    # enforce_on_key must not be specified.
+                  {
+                    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                        # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                        # taken as the key value.
+                    "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                        # values are:
+                        #
+                        #    - ALL: A single rate limit threshold is applied to all
+                        #    the requests matching this rule. This is the default value if
+                        #    "enforceOnKeyConfigs" is not configured.
+                        #    - IP: The source IP address of
+                        #    the request is the key. Each IP has this limit enforced
+                        #    separately.
+                        #    - HTTP_HEADER: The value of the HTTP
+                        #    header whose name is configured under "enforceOnKeyName". The key
+                        #    value is truncated to the first 128 bytes of the header value. If no
+                        #    such header is present in the request, the key type defaults toALL.
+                        #    - XFF_IP: The first IP address (i.e. the
+                        #    originating client IP address) specified in the list of IPs under
+                        #    X-Forwarded-For HTTP header. If no such header is present or the
+                        #    value is not a valid IP, the key defaults to the source IP address of
+                        #    the request i.e. key type IP.
+                        #    - HTTP_COOKIE: The value of the HTTP
+                        #    cookie whose name is configured under "enforceOnKeyName". The key
+                        #    value is truncated to the first 128 bytes of the cookie value. If no
+                        #    such cookie is present in the request, the key type defaults toALL.
+                        #    - HTTP_PATH: The URL path of the HTTP request. The key
+                        #    value is truncated to the first 128 bytes.
+                        #    - SNI: Server name indication in the TLS session of
+                        #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                        #    The key type defaults to ALL on a HTTP session.
+                        #    - REGION_CODE: The country/region from which the
+                        #    request originates.
+                        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                        #    key type defaults to ALL.
+                        #    - USER_IP: The IP address of the originating client,
+                        #    which is resolved based on "userIpRequestHeaders" configured with the
+                        #    security policy. If there is no "userIpRequestHeaders" configuration
+                        #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                        #    - ASN: The autonomous system number of the originating
+                        #    client. If not available, the key type defaults toALL.
+                        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                        #    key type defaults to ALL.
+                  },
+                ],
+                "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                    # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+                    # value.
+                    # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+                    # value.
+                "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+                    # threshold, to either deny with a specified HTTP response code, or
+                    # redirect to a different endpoint.
+                    # Valid options are `deny(STATUS)`, where valid values for
+                    # `STATUS` are 403, 404, 429, and 502, and
+                    # `redirect`, where the redirect parameters come from
+                    # `exceedRedirectOptions` below.
+                    # The `redirect` action is only supported in Global Security Policies of
+                    # type CLOUD_ARMOR.
+                "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+                    # action. Cannot be specified if the exceed action is not redirect.
+                    # This field is only supported in Global Security Policies of type
+                    # CLOUD_ARMOR.
+                  "target": "A String", # Target for the redirect action. This is required if the type is
+                      # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+                  "type": "A String", # Type of the redirect action. Possible values are:
+                      #
+                      #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                      #    challenge assessment.
+                      #    - EXTERNAL_302: redirect to a different URL via a 302
+                      #    response.
+                },
+                "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+                  "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+                  "intervalSec": 42, # Interval over which the threshold is computed.
+                },
+              },
+              "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+                  # other actions.
+                  # This field is only supported in Global Security Policies of type
+                  # CLOUD_ARMOR.
+                "target": "A String", # Target for the redirect action. This is required if the type is
+                    # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+                "type": "A String", # Type of the redirect action. Possible values are:
+                    #
+                    #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                    #    challenge assessment.
+                    #    - EXTERNAL_302: redirect to a different URL via a 302
+                    #    response.
+              },
+            },
+          ],
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "shortName": "A String", # User-provided name of the organization security policy. The name should be
+              # unique in the organization in which the security policy is created. This
+              # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+              # The name must be 1-63 characters long, and comply with
+              # https://www.ietf.org/rfc/rfc1035.txt. 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.
+          "type": "A String", # The type indicates the intended use of the security policy.
+              #
+              #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+              #    be configured to filter incoming HTTP requests targeting backend services.
+              #    They filter requests before they hit the origin servers.
+              #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+              #    be configured to filter incoming HTTP requests targeting backend services
+              #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+              #    They filter requests before the request is served from Google's cache.
+              #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+              #    internal service policies can be configured to filter HTTP requests
+              #    targeting services managed by Traffic Director in a service mesh. They
+              #    filter requests before the request is served from the application.
+              #
+              # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+              # can be configured to filter packets targeting network load balancing
+              # resources such as backend services, target pools, target instances, and
+              # instances with external IPs. They filter requests before the request is
+              # served from the application.
+              #
+              #
+              # This field can be set only at resource creation time.
+          "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+              # user-defined field consists of up to 4 bytes extracted from a fixed offset
+              # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+              # optional mask to select certain bits. Rules may then specify matching
+              # values for these fields.
+              #
+              # Example:
+              #
+              #  userDefinedFields:
+              #  - name: "ipv4_fragment_offset"
+              #    base: IPV4
+              #    offset: 6
+              #    size: 2
+              #    mask: "0x1fff"
+            {
+              "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+                  #
+                  #    - IPV4: Points to the beginning of the IPv4 header.
+                  #    - IPV6: Points to the beginning of the IPv6 header.
+                  #    - TCP: Points to the beginning of the TCP header, skipping
+                  #    over any IPv4 options or IPv6 extension headers. Not present for
+                  #    non-first fragments.
+                  #    - UDP: Points to the beginning of the UDP header, skipping
+                  #    over any IPv4 options or IPv6 extension headers. Not present for
+                  #    non-first fragments.
+                  #
+                  #
+                  # required
+              "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+                  # before matching. Encoded as a hexadecimal number (starting with "0x").
+                  # The last byte of the field (in network byte order) corresponds to the
+                  # least significant byte of the mask.
+              "name": "A String", # The name of this field. Must be unique within the policy.
+              "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+                  # 'base'.
+              "size": 42, # Size of the field in bytes. Valid values: 1-4.
+            },
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # security 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#securityPoliciesAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security
+      # 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. [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, securityPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, securityPolicy, x__xgafv=None) + 
List all of the ordered rules present in a single specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to get. (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 Google Cloud Armor security policy resource.
+    #
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      #
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      #
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      #
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      #
+      #
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      #
+      # Example:
+      #
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+ +
+ getRule(project, securityPolicy, priority=None, x__xgafv=None) + 
Gets a rule at the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to which the queried rule belongs. (required)
+  priority: integer, The priority of the rule to get from the security policy.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      #
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      #
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      #
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      #
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      #
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      #
+      # Example:
+      #
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      #
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+ +
+ insert(project, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates a new policy 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 Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  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).
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
List all the policies that have been configured for 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.
+  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 SecurityPolicy resources.
+    { # Represents a Google Cloud Armor security policy resource.
+        #
+        # Only external backend services that use load balancers can
+        # reference a security policy. For more information, see
+        # Google Cloud Armor security policy overview.
+      "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+        "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "ruleVisibility": "A String", # Rule visibility can be one of the following:
+              # STANDARD - opaque rules. (default)
+              # PREMIUM - transparent rules.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+          "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+              # customizable thresholds.
+            {
+              "autoDeployConfidenceThreshold": 3.14,
+              "autoDeployExpirationSec": 42,
+              "autoDeployImpactedBaselineThreshold": 3.14,
+              "autoDeployLoadThreshold": 3.14,
+              "detectionAbsoluteQps": 3.14,
+              "detectionLoadThreshold": 3.14,
+              "detectionRelativeToBaselineQps": 3.14,
+              "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+                  # The name must be unique within the security policy.
+              "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+                  # on specified granular traffic units.
+                { # Configurations to specifc granular traffic units processed by
+                    # Adaptive Protection.
+                  "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                      # type constitutes a separate traffic unit.
+                      # It can only be set to true if `value` is empty.
+                  "type": "A String", # Type of this configuration.
+                  "value": "A String", # Requests that match this value constitute a granular traffic unit.
+                },
+              ],
+            },
+          ],
+        },
+      },
+      "advancedOptionsConfig": {
+        "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+            # json_parsing is set to STANDARD.
+          "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+              #
+              # As per RFC 1341, a Content-Type header value has the following format:
+              #
+              # Content-Type := type "/" subtype *[";" parameter]
+              #
+              # When configuring a custom Content-Type header value, only the
+              # type/subtype needs to be specified, and the parameters should be
+              # excluded.
+            "A String",
+          ],
+        },
+        "jsonParsing": "A String",
+        "logLevel": "A String",
+        "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+            # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+            # Values are case insensitive.
+        "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+            # resolving the callers client IP address.
+          "A String",
+        ],
+      },
+      "associations": [ # A list of associations that belong to this policy.
+        {
+          "attachmentId": "A String", # The resource that the security policy is attached to.
+          "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+          "excludedFolders": [ # A list of folders to exclude from the security policy.
+            "A String",
+          ],
+          "excludedProjects": [ # A list of projects to exclude from the security policy.
+            "A String",
+          ],
+          "name": "A String", # The name for an association.
+          "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+          "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+        },
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "ddosProtectionConfig": {
+        "ddosAdaptiveProtection": "A String",
+        "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+            # builds DDoS mitigations that minimize collateral damage. It quantifies
+            # this as the fraction of a non-abuse baseline that's inadvertently
+            # blocked.
+            #
+            # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+            # not be deployed. Using a lower value will prioritize keeping collateral
+            # damage low, possibly at the cost of its effectiveness in rate limiting
+            # some or all of the attack. It should typically be unset, so Advanced DDoS
+            # (and Adaptive Protection) uses the best mitigation it can find. Setting
+            # the threshold is advised if there are logs for false positive detections
+            # with high collateral damage, and will cause Advanced DDoS to attempt to
+            # find a less aggressive rule that satisfies the constraint. If a suitable
+            # rule cannot be found, the system falls back to either no mitigation for
+            # smaller attacks or broader network throttles for larger ones.
+        "ddosProtection": "A String",
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+          # the metadata's contents and used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update metadata. You must always provide an
+          # up-to-date fingerprint hash in order to update or change metadata,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels.
+          #
+          # To see the latest fingerprint, make get() request to the
+          # security policy.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+      "recaptchaOptionsConfig": {
+        "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+            # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+            # the security policy. The specified site key needs to be created from the
+            # reCAPTCHA API. The user is responsible for the validity of the specified
+            # site key. If not specified, a Google-managed site key is used.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+          # resides. This field is not applicable to global security policies.
+      "rules": [ # A list of rules that belong to this policy.
+          # There must always be a default rule which is a rule with priority
+          # 2147483647 and match all condition (for the match condition this means
+          # match  "*" for srcIpRanges and for the networkMatch condition every field
+          # must be either match "*" or not set). If no rules are provided when
+          # creating a security policy, a default rule with action "allow" will be
+          # added.
+        { # Represents a rule that describes one or more match conditions along with
+            # the action to be taken when traffic matches this condition (allow or deny).
+          "action": "A String", # The Action to perform when the rule is matched.
+              # The following are the valid actions:
+              #
+              #    - allow: allow access to target.
+              #    - deny(STATUS): deny access to target, returns the
+              #    HTTP response code specified. Valid values for `STATUS`
+              #    are 403, 404, and 502.
+              #    - rate_based_ban: limit client traffic to the configured
+              #    threshold and ban the client if the traffic exceeds the threshold.
+              #    Configure parameters for this action in RateLimitOptions. Requires
+              #    rate_limit_options to be set.
+              #    - redirect: redirect to a different target. This can
+              #    either be an internal reCAPTCHA redirect, or an external URL-based
+              #    redirect via a 302 response. Parameters for this action can be configured
+              #    via redirectOptions. This action is only supported in Global Security
+              #    Policies of type CLOUD_ARMOR.
+              #    - throttle: limit
+              #    client traffic to the configured threshold. Configure parameters for this
+              #    action in rateLimitOptions. Requires rate_limit_options to be set for
+              #    this.
+              #    - fairshare (preview only): when traffic reaches the
+              #    threshold limit, requests from the clients matching this rule begin to be
+              #    rate-limited using the Fair Share algorithm. This action is only allowed
+              #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "headerAction": { # Optional, additional actions that are performed on headers.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+                # present.
+              {
+                "headerName": "A String", # The name of the header to set.
+                "headerValue": "A String", # The value to set the named header to.
+              },
+            ],
+          },
+          "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+          "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+              # If it evaluates to true, the corresponding 'action' is enforced.
+              # Exactly one field must be specified.
+            "config": { # The configuration options available when specifying versioned_expr.
+                # This field must be specified if versioned_expr is specified and cannot
+                # be specified if versioned_expr is not specified.
+              "srcIpRanges": [ # CIDR IP address range.
+                  # Maximum number of src_ip_ranges allowed is 10.
+                "A String",
+              ],
+            },
+            "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+                # A CEVAL expression is used to specify match criteria such as origin.ip,
+                # source.region_code and contents in the request header.
+                # Expressions containing `evaluateThreatIntelligence` require a Cloud
+                # Armor Enterprise subscription and are not supported in Edge Policies
+                # nor in Regional Policies. Expressions containing
+                # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+                # Enterprise subscription and are only supported in Global Security
+                # 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.
+            },
+            "exprOptions": { # The configuration options available when specifying a user defined
+                # CEVAL expression (i.e., 'expr').
+              "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+                  # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+                "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # action-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+                "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                    # session-tokens. The provided site keys need to be created from
+                    # reCAPTCHA API under the same project where the security policy is
+                    # created.
+                  "A String",
+                ],
+              },
+            },
+            "versionedExpr": "A String", # Preconfigured versioned expression.
+                # If this field is specified, config must also be specified.
+                # Available preconfigured expressions along with their requirements are:
+                # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+                # config.
+          },
+          "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+              # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+              # 'action' is enforced.
+              #
+              # The match criteria for a rule consists of built-in match fields (like
+              # 'srcIpRanges') and potentially multiple user-defined match fields
+              # ('userDefinedFields').
+              #
+              # Field values may be extracted directly from the packet or derived from it
+              # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+              # (e.g. 'srcPorts'). A user-defined field is only present if the base
+              # header is found in the packet and the entire field is in bounds.
+              #
+              # Each match field may specify which values can match it, listing one or
+              # more ranges, prefixes, or exact values that are considered a match for
+              # the field. A field value must be present in order to match a specified
+              # match field. If no match values are specified for a match field, then any
+              # field value is considered to match it, and it's not required to be
+              # present. For strings specifying '*' is also equivalent to match all.
+              #
+              # For a packet to match a rule, all specified match fields must match the
+              # corresponding field values derived from the packet.
+              #
+              # Example:
+              #
+              # networkMatch:
+              #   srcIpRanges:
+              #   - "192.0.2.0/24"
+              #   - "198.51.100.0/24"
+              #   userDefinedFields:
+              #   - name: "ipv4_fragment_offset"
+              #     values:
+              #     - "1-0x1fff"
+              #
+              # The above match condition matches packets with a source IP in
+              # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+              # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+              # against.
+            "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+                # format.
+              "A String",
+            ],
+            "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+                # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+                # "253-254"), or one of the following protocol names: "tcp", "udp",
+                # "icmp", "esp", "ah", "ipip", or "sctp".
+              "A String",
+            ],
+            "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+              42,
+            ],
+            "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+              "A String",
+            ],
+            "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+                # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+              "A String",
+            ],
+            "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+                # IP address.
+              "A String",
+            ],
+            "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+                # matching values for that field.
+              {
+                "name": "A String", # Name of the user-defined field, as given in the definition.
+                "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                    # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                    # range (e.g.  "0x400-0x7ff").
+                  "A String",
+                ],
+              },
+            ],
+          },
+          "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+              # does not evaluate preconfigured WAF rules, i.e., if
+              # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+            "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+              {
+                "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                    # preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                    # inspection during preconfigured WAF evaluation.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                    # from inspection during preconfigured WAF evaluation. Note that the
+                    # parameter can be in the query string or in the POST body.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                    # inspection during preconfigured WAF evaluation. When specifying this
+                    # field, the query or fragment part should be excluded.
+                  {
+                    "op": "A String", # The match operator for the field.
+                    "val": "A String", # The value of the field.
+                  },
+                ],
+                "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                    # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                    # IDs under the WAF rule set.
+                  "A String",
+                ],
+                "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+              },
+            ],
+          },
+          "preview": True or False, # If set to true, the specified action is not enforced.
+          "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+              # must be a positive value between 0 and 2147483647.
+              # Rules are evaluated from highest to lowest priority where 0 is the
+              # highest priority and 2147483647 is the lowest priority.
+          "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+              # "fairshare". Cannot be specified for any other actions.
+            "banDurationSec": 42, # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, determines the time (in seconds)
+                # the traffic will continue to be banned by the rate limit after the
+                # rate falls below the threshold.
+            "banThreshold": { # Can only be specified if the action for the rule is
+                # "rate_based_ban". If specified, the key will be banned for the
+                # configured 'ban_duration_sec' when the number of requests that exceed
+                # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+            "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+                # threshold. Valid option is "allow" only.
+            "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKey" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the value
+                #    is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of the
+                #    HTTPS request. The key value is truncated to the first 128 bytes. The
+                #    key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the request
+                #    originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration or
+                #    an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #
+                #
+                # For "fairshare" action, this value is limited to ALL i.e. a single rate
+                # limit threshold is enforced for all the requests matching the rule.
+            "enforceOnKeyConfigs": [ # If specified, any combination of values of
+                # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+                # ratelimit threshold/action is enforced. You can specify up to 3
+                # enforce_on_key_configs. If enforce_on_key_configs is specified,
+                # enforce_on_key must not be specified.
+              {
+                "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                    # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                    # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                    # taken as the key value.
+                "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                    # values are:
+                    #
+                    #    - ALL: A single rate limit threshold is applied to all
+                    #    the requests matching this rule. This is the default value if
+                    #    "enforceOnKeyConfigs" is not configured.
+                    #    - IP: The source IP address of
+                    #    the request is the key. Each IP has this limit enforced
+                    #    separately.
+                    #    - HTTP_HEADER: The value of the HTTP
+                    #    header whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the header value. If no
+                    #    such header is present in the request, the key type defaults toALL.
+                    #    - XFF_IP: The first IP address (i.e. the
+                    #    originating client IP address) specified in the list of IPs under
+                    #    X-Forwarded-For HTTP header. If no such header is present or the
+                    #    value is not a valid IP, the key defaults to the source IP address of
+                    #    the request i.e. key type IP.
+                    #    - HTTP_COOKIE: The value of the HTTP
+                    #    cookie whose name is configured under "enforceOnKeyName". The key
+                    #    value is truncated to the first 128 bytes of the cookie value. If no
+                    #    such cookie is present in the request, the key type defaults toALL.
+                    #    - HTTP_PATH: The URL path of the HTTP request. The key
+                    #    value is truncated to the first 128 bytes.
+                    #    - SNI: Server name indication in the TLS session of
+                    #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                    #    The key type defaults to ALL on a HTTP session.
+                    #    - REGION_CODE: The country/region from which the
+                    #    request originates.
+                    #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+                    #    - USER_IP: The IP address of the originating client,
+                    #    which is resolved based on "userIpRequestHeaders" configured with the
+                    #    security policy. If there is no "userIpRequestHeaders" configuration
+                    #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                    #    - ASN: The autonomous system number of the originating
+                    #    client. If not available, the key type defaults toALL.
+                    #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                    #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                    #    key type defaults to ALL.
+              },
+            ],
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+                # value.
+                # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+                # value.
+            "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+                # threshold, to either deny with a specified HTTP response code, or
+                # redirect to a different endpoint.
+                # Valid options are `deny(STATUS)`, where valid values for
+                # `STATUS` are 403, 404, 429, and 502, and
+                # `redirect`, where the redirect parameters come from
+                # `exceedRedirectOptions` below.
+                # The `redirect` action is only supported in Global Security Policies of
+                # type CLOUD_ARMOR.
+            "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+                # action. Cannot be specified if the exceed action is not redirect.
+                # This field is only supported in Global Security Policies of type
+                # CLOUD_ARMOR.
+              "target": "A String", # Target for the redirect action. This is required if the type is
+                  # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+              "type": "A String", # Type of the redirect action. Possible values are:
+                  #
+                  #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                  #    challenge assessment.
+                  #    - EXTERNAL_302: redirect to a different URL via a 302
+                  #    response.
+            },
+            "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+              "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+              "intervalSec": 42, # Interval over which the threshold is computed.
+            },
+          },
+          "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+              # other actions.
+              # This field is only supported in Global Security Policies of type
+              # CLOUD_ARMOR.
+            "target": "A String", # Target for the redirect action. This is required if the type is
+                # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+            "type": "A String", # Type of the redirect action. Possible values are:
+                #
+                #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+                #    challenge assessment.
+                #    - EXTERNAL_302: redirect to a different URL via a 302
+                #    response.
+          },
+        },
+      ],
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "shortName": "A String", # User-provided name of the organization security policy. The name should be
+          # unique in the organization in which the security policy is created. This
+          # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+          # The name must be 1-63 characters long, and comply with
+          # https://www.ietf.org/rfc/rfc1035.txt. 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.
+      "type": "A String", # The type indicates the intended use of the security policy.
+          #
+          #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services.
+          #    They filter requests before they hit the origin servers.
+          #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+          #    be configured to filter incoming HTTP requests targeting backend services
+          #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+          #    They filter requests before the request is served from Google's cache.
+          #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+          #    internal service policies can be configured to filter HTTP requests
+          #    targeting services managed by Traffic Director in a service mesh. They
+          #    filter requests before the request is served from the application.
+          #
+          # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+          # can be configured to filter packets targeting network load balancing
+          # resources such as backend services, target pools, target instances, and
+          # instances with external IPs. They filter requests before the request is
+          # served from the application.
+          #
+          #
+          # This field can be set only at resource creation time.
+      "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+          # user-defined field consists of up to 4 bytes extracted from a fixed offset
+          # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+          # optional mask to select certain bits. Rules may then specify matching
+          # values for these fields.
+          #
+          # Example:
+          #
+          #  userDefinedFields:
+          #  - name: "ipv4_fragment_offset"
+          #    base: IPV4
+          #    offset: 6
+          #    size: 2
+          #    mask: "0x1fff"
+        {
+          "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+              #
+              #    - IPV4: Points to the beginning of the IPv4 header.
+              #    - IPV6: Points to the beginning of the IPv6 header.
+              #    - TCP: Points to the beginning of the TCP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #    - UDP: Points to the beginning of the UDP header, skipping
+              #    over any IPv4 options or IPv6 extension headers. Not present for
+              #    non-first fragments.
+              #
+              #
+              # required
+          "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+              # before matching. Encoded as a hexadecimal number (starting with "0x").
+              # The last byte of the field (in network byte order) corresponds to the
+              # least significant byte of the mask.
+          "name": "A String", # The name of this field. Must be unique within the policy.
+          "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+              # 'base'.
+          "size": 42, # Size of the field in bytes. Valid values: 1-4.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#securityPolicyList", # Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies
+  "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.
+  "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.
+  },
+}
+
+ +
+ listPreconfiguredExpressionSets(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Gets the current list of preconfigured Web Application Firewall (WAF)
+expressions.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "preconfiguredExpressionSets": {
+    "wafRules": {
+      "expressionSets": [ # List of entities that are currently supported for WAF rules.
+        {
+          "aliases": [ # A list of alternate IDs. The format should be:
+              # - E.g. XSS-stable
+              # Generic suffix like "stable" is particularly useful if a policy
+              # likes to avail newer set of expressions without having to change
+              # the policy.
+              # A given alias name can't be used for more than one entity set.
+            "A String",
+          ],
+          "expressions": [ # List of available expressions.
+            {
+              "id": "A String", # Expression ID should uniquely identify the origin of the expression.
+                  # E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set
+                  # version 2.9.1 rule id 973337.
+                  # The ID could be used to determine the individual attack definition
+                  # that has been detected. It could also be used to exclude it from
+                  # the policy in case of false positive.
+                  # required
+              "sensitivity": 42, # The sensitivity value associated with the WAF rule ID. This corresponds
+                  # to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for
+                  # opt-in only rules.
+            },
+          ],
+          "id": "A String", # Google specified expression set ID. The format should be:
+              # - E.g. XSS-20170329
+              # required
+        },
+      ],
+    },
+  },
+}
+
+ +
+ 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, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patches the specified policy with the data included in the request. To
+clear fields in the policy, leave the fields empty and specify them in the
+updateMask. This cannot be used to be update the rules in the policy.
+Please use the per rule methods like addRule, patchRule, and removeRule
+instead.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Google Cloud Armor security policy resource.
+    # 
+    # Only external backend services that use load balancers can
+    # reference a security policy. For more information, see
+    # Google Cloud Armor security policy overview.
+  "adaptiveProtectionConfig": { # Configuration options for Cloud Armor Adaptive Protection (CAAP).
+    "layer7DdosDefenseConfig": { # Configuration options for L7 DDoS detection. # If set to true, enables Cloud Armor Machine Learning.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "enable": True or False, # If set to true, enables CAAP for L7 DDoS detection.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "ruleVisibility": "A String", # Rule visibility can be one of the following:
+          # STANDARD - opaque rules. (default)
+          # PREMIUM - transparent rules.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+      "thresholdConfigs": [ # Configuration options for layer7 adaptive protection for various
+          # customizable thresholds.
+        {
+          "autoDeployConfidenceThreshold": 3.14,
+          "autoDeployExpirationSec": 42,
+          "autoDeployImpactedBaselineThreshold": 3.14,
+          "autoDeployLoadThreshold": 3.14,
+          "detectionAbsoluteQps": 3.14,
+          "detectionLoadThreshold": 3.14,
+          "detectionRelativeToBaselineQps": 3.14,
+          "name": "A String", # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the security policy.
+          "trafficGranularityConfigs": [ # Configuration options for enabling Adaptive Protection to operate
+              # on specified granular traffic units.
+            { # Configurations to specifc granular traffic units processed by
+                # Adaptive Protection.
+              "enableEachUniqueValue": True or False, # If enabled, traffic matching each unique value for the specified
+                  # type constitutes a separate traffic unit.
+                  # It can only be set to true if `value` is empty.
+              "type": "A String", # Type of this configuration.
+              "value": "A String", # Requests that match this value constitute a granular traffic unit.
+            },
+          ],
+        },
+      ],
+    },
+  },
+  "advancedOptionsConfig": {
+    "jsonCustomConfig": { # Custom configuration to apply the JSON parsing. Only applicable when
+        # json_parsing is set to STANDARD.
+      "contentTypes": [ # A list of custom Content-Type header values to apply the JSON parsing.
+          #
+          # As per RFC 1341, a Content-Type header value has the following format:
+          #
+          # Content-Type := type "/" subtype *[";" parameter]
+          #
+          # When configuring a custom Content-Type header value, only the
+          # type/subtype needs to be specified, and the parameters should be
+          # excluded.
+        "A String",
+      ],
+    },
+    "jsonParsing": "A String",
+    "logLevel": "A String",
+    "requestBodyInspectionSize": "A String", # The maximum request size chosen by the customer with Waf enabled.
+        # Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB".
+        # Values are case insensitive.
+    "userIpRequestHeaders": [ # An optional list of case-insensitive request header names to use for
+        # resolving the callers client IP address.
+      "A String",
+    ],
+  },
+  "associations": [ # A list of associations that belong to this policy.
+    {
+      "attachmentId": "A String", # The resource that the security policy is attached to.
+      "displayName": "A String", # Output only. [Output Only] The display name of the security policy of the association.
+      "excludedFolders": [ # A list of folders to exclude from the security policy.
+        "A String",
+      ],
+      "excludedProjects": [ # A list of projects to exclude from the security policy.
+        "A String",
+      ],
+      "name": "A String", # The name for an association.
+      "securityPolicyId": "A String", # Output only. [Output Only] The security policy ID of the association.
+      "shortName": "A String", # Output only. [Output Only] The short name of the security policy of the association.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "ddosProtectionConfig": {
+    "ddosAdaptiveProtection": "A String",
+    "ddosImpactedBaselineThreshold": 3.14, # DDoS Protection for Network Load Balancers (and VMs with public IPs)
+        # builds DDoS mitigations that minimize collateral damage. It quantifies
+        # this as the fraction of a non-abuse baseline that's inadvertently
+        # blocked.
+        #
+        # Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will
+        # not be deployed. Using a lower value will prioritize keeping collateral
+        # damage low, possibly at the cost of its effectiveness in rate limiting
+        # some or all of the attack. It should typically be unset, so Advanced DDoS
+        # (and Adaptive Protection) uses the best mitigation it can find. Setting
+        # the threshold is advised if there are logs for false positive detections
+        # with high collateral damage, and will cause Advanced DDoS to attempt to
+        # find a less aggressive rule that satisfies the constraint. If a suitable
+        # rule cannot be found, the system falls back to either no mitigation for
+        # smaller attacks or broader network throttles for larger ones.
+    "ddosProtection": "A String",
+  },
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Specifies a fingerprint for this resource, which is essentially a hash of
+      # the metadata's contents and used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update metadata. You must always provide an
+      # up-to-date fingerprint hash in order to update or change metadata,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#securityPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this security policy, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels.
+      # 
+      # To see the latest fingerprint, make get() request to the
+      # security policy.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "parent": "A String", # Output only. [Output Only] The parent of the security policy.
+  "recaptchaOptionsConfig": {
+    "redirectSiteKey": "A String", # An optional field to supply a reCAPTCHA site key to be used for all the
+        # rules using the redirect action with the type of GOOGLE_RECAPTCHA under
+        # the security policy. The specified site key needs to be created from the
+        # reCAPTCHA API. The user is responsible for the validity of the specified
+        # site key. If not specified, a Google-managed site key is used.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional security policy
+      # resides. This field is not applicable to global security policies.
+  "rules": [ # A list of rules that belong to this policy.
+      # There must always be a default rule which is a rule with priority
+      # 2147483647 and match all condition (for the match condition this means
+      # match  "*" for srcIpRanges and for the networkMatch condition every field
+      # must be either match "*" or not set). If no rules are provided when
+      # creating a security policy, a default rule with action "allow" will be
+      # added.
+    { # Represents a rule that describes one or more match conditions along with
+        # the action to be taken when traffic matches this condition (allow or deny).
+      "action": "A String", # The Action to perform when the rule is matched.
+          # The following are the valid actions:
+          #
+          #    - allow: allow access to target.
+          #    - deny(STATUS): deny access to target, returns the
+          #    HTTP response code specified. Valid values for `STATUS`
+          #    are 403, 404, and 502.
+          #    - rate_based_ban: limit client traffic to the configured
+          #    threshold and ban the client if the traffic exceeds the threshold.
+          #    Configure parameters for this action in RateLimitOptions. Requires
+          #    rate_limit_options to be set.
+          #    - redirect: redirect to a different target. This can
+          #    either be an internal reCAPTCHA redirect, or an external URL-based
+          #    redirect via a 302 response. Parameters for this action can be configured
+          #    via redirectOptions. This action is only supported in Global Security
+          #    Policies of type CLOUD_ARMOR.
+          #    - throttle: limit
+          #    client traffic to the configured threshold. Configure parameters for this
+          #    action in rateLimitOptions. Requires rate_limit_options to be set for
+          #    this.
+          #    - fairshare (preview only): when traffic reaches the
+          #    threshold limit, requests from the clients matching this rule begin to be
+          #    rate-limited using the Fair Share algorithm. This action is only allowed
+          #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # Optional, additional actions that are performed on headers.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+            # present.
+          {
+            "headerName": "A String", # The name of the header to set.
+            "headerValue": "A String", # The value to set the named header to.
+          },
+        ],
+      },
+      "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+      "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+          # If it evaluates to true, the corresponding 'action' is enforced.
+          # Exactly one field must be specified.
+        "config": { # The configuration options available when specifying versioned_expr.
+            # This field must be specified if versioned_expr is specified and cannot
+            # be specified if versioned_expr is not specified.
+          "srcIpRanges": [ # CIDR IP address range.
+              # Maximum number of src_ip_ranges allowed is 10.
+            "A String",
+          ],
+        },
+        "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+            # A CEVAL expression is used to specify match criteria such as origin.ip,
+            # source.region_code and contents in the request header.
+            # Expressions containing `evaluateThreatIntelligence` require a Cloud
+            # Armor Enterprise subscription and are not supported in Edge Policies
+            # nor in Regional Policies. Expressions containing
+            # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+            # Enterprise subscription and are only supported in Global Security
+            # 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.
+        },
+        "exprOptions": { # The configuration options available when specifying a user defined
+            # CEVAL expression (i.e., 'expr').
+          "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+              # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+            "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # action-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+            "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+                # session-tokens. The provided site keys need to be created from
+                # reCAPTCHA API under the same project where the security policy is
+                # created.
+              "A String",
+            ],
+          },
+        },
+        "versionedExpr": "A String", # Preconfigured versioned expression.
+            # If this field is specified, config must also be specified.
+            # Available preconfigured expressions along with their requirements are:
+            # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+            # config.
+      },
+      "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+          # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+          # 'action' is enforced.
+          #
+          # The match criteria for a rule consists of built-in match fields (like
+          # 'srcIpRanges') and potentially multiple user-defined match fields
+          # ('userDefinedFields').
+          #
+          # Field values may be extracted directly from the packet or derived from it
+          # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+          # (e.g. 'srcPorts'). A user-defined field is only present if the base
+          # header is found in the packet and the entire field is in bounds.
+          #
+          # Each match field may specify which values can match it, listing one or
+          # more ranges, prefixes, or exact values that are considered a match for
+          # the field. A field value must be present in order to match a specified
+          # match field. If no match values are specified for a match field, then any
+          # field value is considered to match it, and it's not required to be
+          # present. For strings specifying '*' is also equivalent to match all.
+          #
+          # For a packet to match a rule, all specified match fields must match the
+          # corresponding field values derived from the packet.
+          #
+          # Example:
+          #
+          # networkMatch:
+          #   srcIpRanges:
+          #   - "192.0.2.0/24"
+          #   - "198.51.100.0/24"
+          #   userDefinedFields:
+          #   - name: "ipv4_fragment_offset"
+          #     values:
+          #     - "1-0x1fff"
+          #
+          # The above match condition matches packets with a source IP in
+          # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+          # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+          # against.
+        "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+            # format.
+          "A String",
+        ],
+        "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+            # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+            # "253-254"), or one of the following protocol names: "tcp", "udp",
+            # "icmp", "esp", "ah", "ipip", or "sctp".
+          "A String",
+        ],
+        "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+          42,
+        ],
+        "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+          "A String",
+        ],
+        "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+            # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+          "A String",
+        ],
+        "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+            # IP address.
+          "A String",
+        ],
+        "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+            # matching values for that field.
+          {
+            "name": "A String", # Name of the user-defined field, as given in the definition.
+            "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+                # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+                # range (e.g.  "0x400-0x7ff").
+              "A String",
+            ],
+          },
+        ],
+      },
+      "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+          # does not evaluate preconfigured WAF rules, i.e., if
+          # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+        "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+          {
+            "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+                # preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+                # inspection during preconfigured WAF evaluation.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+                # from inspection during preconfigured WAF evaluation. Note that the
+                # parameter can be in the query string or in the POST body.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+                # inspection during preconfigured WAF evaluation. When specifying this
+                # field, the query or fragment part should be excluded.
+              {
+                "op": "A String", # The match operator for the field.
+                "val": "A String", # The value of the field.
+              },
+            ],
+            "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+                # preconfigured WAF exclusion. If omitted, it refers to all the rule
+                # IDs under the WAF rule set.
+              "A String",
+            ],
+            "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+          },
+        ],
+      },
+      "preview": True or False, # If set to true, the specified action is not enforced.
+      "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+          # must be a positive value between 0 and 2147483647.
+          # Rules are evaluated from highest to lowest priority where 0 is the
+          # highest priority and 2147483647 is the lowest priority.
+      "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+          # "fairshare". Cannot be specified for any other actions.
+        "banDurationSec": 42, # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, determines the time (in seconds)
+            # the traffic will continue to be banned by the rate limit after the
+            # rate falls below the threshold.
+        "banThreshold": { # Can only be specified if the action for the rule is
+            # "rate_based_ban". If specified, the key will be banned for the
+            # configured 'ban_duration_sec' when the number of requests that exceed
+            # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+        "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+            # threshold. Valid option is "allow" only.
+        "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKey" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the value
+            #    is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of the
+            #    HTTPS request. The key value is truncated to the first 128 bytes. The
+            #    key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the request
+            #    originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration or
+            #    an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #
+            #
+            # For "fairshare" action, this value is limited to ALL i.e. a single rate
+            # limit threshold is enforced for all the requests matching the rule.
+        "enforceOnKeyConfigs": [ # If specified, any combination of values of
+            # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+            # ratelimit threshold/action is enforced. You can specify up to 3
+            # enforce_on_key_configs. If enforce_on_key_configs is specified,
+            # enforce_on_key must not be specified.
+          {
+            "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+                # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+                # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+                # taken as the key value.
+            "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+                # values are:
+                #
+                #    - ALL: A single rate limit threshold is applied to all
+                #    the requests matching this rule. This is the default value if
+                #    "enforceOnKeyConfigs" is not configured.
+                #    - IP: The source IP address of
+                #    the request is the key. Each IP has this limit enforced
+                #    separately.
+                #    - HTTP_HEADER: The value of the HTTP
+                #    header whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the header value. If no
+                #    such header is present in the request, the key type defaults toALL.
+                #    - XFF_IP: The first IP address (i.e. the
+                #    originating client IP address) specified in the list of IPs under
+                #    X-Forwarded-For HTTP header. If no such header is present or the
+                #    value is not a valid IP, the key defaults to the source IP address of
+                #    the request i.e. key type IP.
+                #    - HTTP_COOKIE: The value of the HTTP
+                #    cookie whose name is configured under "enforceOnKeyName". The key
+                #    value is truncated to the first 128 bytes of the cookie value. If no
+                #    such cookie is present in the request, the key type defaults toALL.
+                #    - HTTP_PATH: The URL path of the HTTP request. The key
+                #    value is truncated to the first 128 bytes.
+                #    - SNI: Server name indication in the TLS session of
+                #    the HTTPS request. The key value is truncated to the first 128 bytes.
+                #    The key type defaults to ALL on a HTTP session.
+                #    - REGION_CODE: The country/region from which the
+                #    request originates.
+                #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+                #    - USER_IP: The IP address of the originating client,
+                #    which is resolved based on "userIpRequestHeaders" configured with the
+                #    security policy. If there is no "userIpRequestHeaders" configuration
+                #    or an IP address cannot be resolved from it, the key type defaults toIP.
+                #    - ASN: The autonomous system number of the originating
+                #    client. If not available, the key type defaults toALL.
+                #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+                #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+                #    key type defaults to ALL.
+          },
+        ],
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+            # value.
+            # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+            # value.
+        "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+            # threshold, to either deny with a specified HTTP response code, or
+            # redirect to a different endpoint.
+            # Valid options are `deny(STATUS)`, where valid values for
+            # `STATUS` are 403, 404, 429, and 502, and
+            # `redirect`, where the redirect parameters come from
+            # `exceedRedirectOptions` below.
+            # The `redirect` action is only supported in Global Security Policies of
+            # type CLOUD_ARMOR.
+        "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+            # action. Cannot be specified if the exceed action is not redirect.
+            # This field is only supported in Global Security Policies of type
+            # CLOUD_ARMOR.
+          "target": "A String", # Target for the redirect action. This is required if the type is
+              # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+          "type": "A String", # Type of the redirect action. Possible values are:
+              #
+              #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+              #    challenge assessment.
+              #    - EXTERNAL_302: redirect to a different URL via a 302
+              #    response.
+        },
+        "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+          "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+          "intervalSec": 42, # Interval over which the threshold is computed.
+        },
+      },
+      "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+          # other actions.
+          # This field is only supported in Global Security Policies of type
+          # CLOUD_ARMOR.
+        "target": "A String", # Target for the redirect action. This is required if the type is
+            # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+        "type": "A String", # Type of the redirect action. Possible values are:
+            #
+            #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+            #    challenge assessment.
+            #    - EXTERNAL_302: redirect to a different URL via a 302
+            #    response.
+      },
+    },
+  ],
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "shortName": "A String", # User-provided name of the organization security policy. The name should be
+      # unique in the organization in which the security policy is created. This
+      # should only be used when SecurityPolicyType is CLOUD_ARMOR.
+      # The name must be 1-63 characters long, and comply with
+      # https://www.ietf.org/rfc/rfc1035.txt. 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.
+  "type": "A String", # The type indicates the intended use of the security policy.
+      # 
+      #    - CLOUD_ARMOR: Cloud Armor backend security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services.
+      #    They filter requests before they hit the origin servers.
+      #    - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can
+      #    be configured to filter incoming HTTP requests targeting backend services
+      #    (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).
+      #    They filter requests before the request is served from Google's cache.
+      #    - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor
+      #    internal service policies can be configured to filter HTTP requests
+      #    targeting services managed by Traffic Director in a service mesh. They
+      #    filter requests before the request is served from the application.
+      # 
+      # - CLOUD_ARMOR_NETWORK: Cloud Armor network policies
+      # can be configured to filter packets targeting network load balancing
+      # resources such as backend services, target pools, target instances, and
+      # instances with external IPs. They filter requests before the request is
+      # served from the application.
+      # 
+      # 
+      # This field can be set only at resource creation time.
+  "userDefinedFields": [ # Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A
+      # user-defined field consists of up to 4 bytes extracted from a fixed offset
+      # in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an
+      # optional mask to select certain bits. Rules may then specify matching
+      # values for these fields.
+      # 
+      # Example:
+      # 
+      #  userDefinedFields:
+      #  - name: "ipv4_fragment_offset"
+      #    base: IPV4
+      #    offset: 6
+      #    size: 2
+      #    mask: "0x1fff"
+    {
+      "base": "A String", # The base relative to which 'offset' is measured. Possible values are:
+          #
+          #    - IPV4: Points to the beginning of the IPv4 header.
+          #    - IPV6: Points to the beginning of the IPv6 header.
+          #    - TCP: Points to the beginning of the TCP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #    - UDP: Points to the beginning of the UDP header, skipping
+          #    over any IPv4 options or IPv6 extension headers. Not present for
+          #    non-first fragments.
+          #
+          #
+          # required
+      "mask": "A String", # If specified, apply this mask (bitwise AND) to the field to ignore bits
+          # before matching. Encoded as a hexadecimal number (starting with "0x").
+          # The last byte of the field (in network byte order) corresponds to the
+          # least significant byte of the mask.
+      "name": "A String", # The name of this field. Must be unique within the policy.
+      "offset": 42, # Offset of the first byte of the field (in network byte order) relative to
+          # 'base'.
+      "size": 42, # Size of the field in bytes. Valid values: 1-4.
+    },
+  ],
+}
+
+  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).
+  updateMask: string, Indicates fields to be cleared as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ patchRule(project, securityPolicy, body=None, priority=None, updateMask=None, validateOnly=None, x__xgafv=None) + 
Patches a rule at the specified priority. To clear fields in the rule,
+leave the fields empty and specify them in the updateMask.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a rule that describes one or more match conditions along with
+    # the action to be taken when traffic matches this condition (allow or deny).
+  "action": "A String", # The Action to perform when the rule is matched.
+      # The following are the valid actions:
+      # 
+      #    - allow: allow access to target.
+      #    - deny(STATUS): deny access to target, returns the
+      #    HTTP response code specified. Valid values for `STATUS`
+      #    are 403, 404, and 502.
+      #    - rate_based_ban: limit client traffic to the configured
+      #    threshold and ban the client if the traffic exceeds the threshold.
+      #    Configure parameters for this action in RateLimitOptions. Requires
+      #    rate_limit_options to be set.
+      #    - redirect: redirect to a different target. This can
+      #    either be an internal reCAPTCHA redirect, or an external URL-based
+      #    redirect via a 302 response. Parameters for this action can be configured
+      #    via redirectOptions. This action is only supported in Global Security
+      #    Policies of type CLOUD_ARMOR.
+      #    - throttle: limit
+      #    client traffic to the configured threshold. Configure parameters for this
+      #    action in rateLimitOptions. Requires rate_limit_options to be set for
+      #    this.
+      #    - fairshare (preview only): when traffic reaches the
+      #    threshold limit, requests from the clients matching this rule begin to be
+      #    rate-limited using the Fair Share algorithm. This action is only allowed
+      #    in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "headerAction": { # Optional, additional actions that are performed on headers.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "requestHeadersToAdds": [ # The list of request headers to add or overwrite if they're already
+        # present.
+      {
+        "headerName": "A String", # The name of the header to set.
+        "headerValue": "A String", # The value to set the named header to.
+      },
+    ],
+  },
+  "kind": "compute#securityPolicyRule", # Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules
+  "match": { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
+      # If it evaluates to true, the corresponding 'action' is enforced.
+      # Exactly one field must be specified.
+    "config": { # The configuration options available when specifying versioned_expr.
+        # This field must be specified if versioned_expr is specified and cannot
+        # be specified if versioned_expr is not specified.
+      "srcIpRanges": [ # CIDR IP address range.
+          # Maximum number of src_ip_ranges allowed is 10.
+        "A String",
+      ],
+    },
+    "expr": { # Represents a textual expression in the Common Expression Language (CEL) # User defined CEVAL expression.
+        # A CEVAL expression is used to specify match criteria such as origin.ip,
+        # source.region_code and contents in the request header.
+        # Expressions containing `evaluateThreatIntelligence` require a Cloud
+        # Armor Enterprise subscription and are not supported in Edge Policies
+        # nor in Regional Policies. Expressions containing
+        # `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor
+        # Enterprise subscription and are only supported in Global Security
+        # 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.
+    },
+    "exprOptions": { # The configuration options available when specifying a user defined
+        # CEVAL expression (i.e., 'expr').
+      "recaptchaOptions": { # reCAPTCHA configuration options to be applied for the rule. If the
+          # rule does not evaluate reCAPTCHA tokens, this field has no effect.
+        "actionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # action-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+        "sessionTokenSiteKeys": [ # A list of site keys to be used during the validation of reCAPTCHA
+            # session-tokens. The provided site keys need to be created from
+            # reCAPTCHA API under the same project where the security policy is
+            # created.
+          "A String",
+        ],
+      },
+    },
+    "versionedExpr": "A String", # Preconfigured versioned expression.
+        # If this field is specified, config must also be specified.
+        # Available preconfigured expressions along with their requirements are:
+        # SRC_IPS_V1 - must specify the corresponding src_ip_range field in
+        # config.
+  },
+  "networkMatch": { # Represents a match condition that incoming network traffic is evaluated # A match condition that incoming packets are evaluated against for
+      # CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding
+      # 'action' is enforced.
+      # 
+      # The match criteria for a rule consists of built-in match fields (like
+      # 'srcIpRanges') and potentially multiple user-defined match fields
+      # ('userDefinedFields').
+      # 
+      # Field values may be extracted directly from the packet or derived from it
+      # (e.g. 'srcRegionCodes'). Some fields may not be present in every packet
+      # (e.g. 'srcPorts'). A user-defined field is only present if the base
+      # header is found in the packet and the entire field is in bounds.
+      # 
+      # Each match field may specify which values can match it, listing one or
+      # more ranges, prefixes, or exact values that are considered a match for
+      # the field. A field value must be present in order to match a specified
+      # match field. If no match values are specified for a match field, then any
+      # field value is considered to match it, and it's not required to be
+      # present. For strings specifying '*' is also equivalent to match all.
+      # 
+      # For a packet to match a rule, all specified match fields must match the
+      # corresponding field values derived from the packet.
+      # 
+      # Example:
+      # 
+      # networkMatch:
+      #   srcIpRanges:
+      #   - "192.0.2.0/24"
+      #   - "198.51.100.0/24"
+      #   userDefinedFields:
+      #   - name: "ipv4_fragment_offset"
+      #     values:
+      #     - "1-0x1fff"
+      # 
+      # The above match condition matches packets with a source IP in
+      # 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named
+      # "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive.
+      # against.
+    "destIpRanges": [ # Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text
+        # format.
+      "A String",
+    ],
+    "destPorts": [ # Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "ipProtocols": [ # IPv4 protocol / IPv6 next header (after extension headers). Each
+        # element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g.
+        # "253-254"), or one of the following protocol names: "tcp", "udp",
+        # "icmp", "esp", "ah", "ipip", or "sctp".
+      "A String",
+    ],
+    "srcAsns": [ # BGP Autonomous System Number associated with the source IP address.
+      42,
+    ],
+    "srcIpRanges": [ # Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.
+      "A String",
+    ],
+    "srcPorts": [ # Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit
+        # unsigned decimal number (e.g. "80") or range (e.g. "0-1023").
+      "A String",
+    ],
+    "srcRegionCodes": [ # Two-letter ISO 3166-1 alpha-2 country code associated with the source
+        # IP address.
+      "A String",
+    ],
+    "userDefinedFields": [ # User-defined fields. Each element names a defined field and lists the
+        # matching values for that field.
+      {
+        "name": "A String", # Name of the user-defined field, as given in the definition.
+        "values": [ # Matching values of the field. Each element can be a 32-bit unsigned
+            # decimal or hexadecimal (starting with "0x") number (e.g. "64") or
+            # range (e.g.  "0x400-0x7ff").
+          "A String",
+        ],
+      },
+    ],
+  },
+  "preconfiguredWafConfig": { # Preconfigured WAF configuration to be applied for the rule. If the rule
+      # does not evaluate preconfigured WAF rules, i.e., if
+      # evaluatePreconfiguredWaf() is not used, this field will have no effect.
+    "exclusions": [ # A list of exclusions to apply during preconfigured WAF evaluation.
+      {
+        "requestBodiesToExclude": [ # A list of request body fields to be excluded from inspection during
+            # preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestCookiesToExclude": [ # A list of request cookie names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestHeadersToExclude": [ # A list of request header names whose value will be excluded from
+            # inspection during preconfigured WAF evaluation.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestQueryParamsToExclude": [ # A list of request query parameter names whose value will be excluded
+            # from inspection during preconfigured WAF evaluation. Note that the
+            # parameter can be in the query string or in the POST body.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "requestUrisToExclude": [ # A list of request URIs from the request line to be excluded from
+            # inspection during preconfigured WAF evaluation. When specifying this
+            # field, the query or fragment part should be excluded.
+          {
+            "op": "A String", # The match operator for the field.
+            "val": "A String", # The value of the field.
+          },
+        ],
+        "targetRuleIds": [ # A list of target rule IDs under the WAF rule set to apply the
+            # preconfigured WAF exclusion. If omitted, it refers to all the rule
+            # IDs under the WAF rule set.
+          "A String",
+        ],
+        "targetRuleSet": "A String", # Target WAF rule set to apply the preconfigured WAF exclusion.
+      },
+    ],
+  },
+  "preview": True or False, # If set to true, the specified action is not enforced.
+  "priority": 42, # An integer indicating the priority of a rule in the list. The priority
+      # must be a positive value between 0 and 2147483647.
+      # Rules are evaluated from highest to lowest priority where 0 is the
+      # highest priority and 2147483647 is the lowest priority.
+  "rateLimitOptions": { # Must be specified if the action is "rate_based_ban" or "throttle" or
+      # "fairshare". Cannot be specified for any other actions.
+    "banDurationSec": 42, # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, determines the time (in seconds)
+        # the traffic will continue to be banned by the rate limit after the
+        # rate falls below the threshold.
+    "banThreshold": { # Can only be specified if the action for the rule is
+        # "rate_based_ban". If specified, the key will be banned for the
+        # configured 'ban_duration_sec' when the number of requests that exceed
+        # the 'rate_limit_threshold' also exceed this 'ban_threshold'.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+    "conformAction": "A String", # Action to take for requests that are under the configured rate limit
+        # threshold. Valid option is "allow" only.
+    "enforceOnKey": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+        # values are:
+        #
+        #    - ALL: A single rate limit threshold is applied to all
+        #    the requests matching this rule. This is the default value if
+        #    "enforceOnKey" is not configured.
+        #    - IP: The source IP address of
+        #    the request is the key. Each IP has this limit enforced
+        #    separately.
+        #    - HTTP_HEADER: The value of the HTTP
+        #    header whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the header value. If no
+        #    such header is present in the request, the key type defaults toALL.
+        #    - XFF_IP: The first IP address (i.e. the
+        #    originating client IP address) specified in the list of IPs under
+        #    X-Forwarded-For HTTP header. If no such header is present or the value
+        #    is not a valid IP, the key defaults to the source IP address of
+        #    the request i.e. key type IP.
+        #    - HTTP_COOKIE: The value of the HTTP
+        #    cookie whose name is configured under "enforceOnKeyName". The key
+        #    value is truncated to the first 128 bytes of the cookie value. If no
+        #    such cookie is present in the request, the key type defaults toALL.
+        #    - HTTP_PATH: The URL path of the HTTP request. The key
+        #    value is truncated to the first 128 bytes.
+        #    - SNI: Server name indication in the TLS session of the
+        #    HTTPS request. The key value is truncated to the first 128 bytes. The
+        #    key type defaults to ALL on a HTTP session.
+        #    - REGION_CODE: The country/region from which the request
+        #    originates.
+        #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #    - USER_IP: The IP address of the originating client,
+        #    which is resolved based on "userIpRequestHeaders" configured with the
+        #    security policy. If there is no "userIpRequestHeaders" configuration or
+        #    an IP address cannot be resolved from it, the key type defaults toIP.
+        #    - ASN: The autonomous system number of the originating
+        #    client. If not available, the key type defaults toALL.
+        #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+        #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+        #    key type defaults to ALL.
+        #
+        #
+        # For "fairshare" action, this value is limited to ALL i.e. a single rate
+        # limit threshold is enforced for all the requests matching the rule.
+    "enforceOnKeyConfigs": [ # If specified, any combination of values of
+        # enforce_on_key_type/enforce_on_key_name is treated as the key on which
+        # ratelimit threshold/action is enforced. You can specify up to 3
+        # enforce_on_key_configs. If enforce_on_key_configs is specified,
+        # enforce_on_key must not be specified.
+      {
+        "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+            # HTTP_HEADER -- Name of the HTTP header whose value is taken as the
+            # key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is
+            # taken as the key value.
+        "enforceOnKeyType": "A String", # Determines the key to enforce the rate_limit_threshold on. Possible
+            # values are:
+            #
+            #    - ALL: A single rate limit threshold is applied to all
+            #    the requests matching this rule. This is the default value if
+            #    "enforceOnKeyConfigs" is not configured.
+            #    - IP: The source IP address of
+            #    the request is the key. Each IP has this limit enforced
+            #    separately.
+            #    - HTTP_HEADER: The value of the HTTP
+            #    header whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the header value. If no
+            #    such header is present in the request, the key type defaults toALL.
+            #    - XFF_IP: The first IP address (i.e. the
+            #    originating client IP address) specified in the list of IPs under
+            #    X-Forwarded-For HTTP header. If no such header is present or the
+            #    value is not a valid IP, the key defaults to the source IP address of
+            #    the request i.e. key type IP.
+            #    - HTTP_COOKIE: The value of the HTTP
+            #    cookie whose name is configured under "enforceOnKeyName". The key
+            #    value is truncated to the first 128 bytes of the cookie value. If no
+            #    such cookie is present in the request, the key type defaults toALL.
+            #    - HTTP_PATH: The URL path of the HTTP request. The key
+            #    value is truncated to the first 128 bytes.
+            #    - SNI: Server name indication in the TLS session of
+            #    the HTTPS request. The key value is truncated to the first 128 bytes.
+            #    The key type defaults to ALL on a HTTP session.
+            #    - REGION_CODE: The country/region from which the
+            #    request originates.
+            #    - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+            #    - USER_IP: The IP address of the originating client,
+            #    which is resolved based on "userIpRequestHeaders" configured with the
+            #    security policy. If there is no "userIpRequestHeaders" configuration
+            #    or an IP address cannot be resolved from it, the key type defaults toIP.
+            #    - ASN: The autonomous system number of the originating
+            #    client. If not available, the key type defaults toALL.
+            #    - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the
+            #    client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the
+            #    key type defaults to ALL.
+      },
+    ],
+    "enforceOnKeyName": "A String", # Rate limit key name applicable only for the following key types:
+        # HTTP_HEADER -- Name of the HTTP header whose value is taken as the key
+        # value.
+        # HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key
+        # value.
+    "exceedAction": "A String", # Action to take for requests that are above the configured rate limit
+        # threshold, to either deny with a specified HTTP response code, or
+        # redirect to a different endpoint.
+        # Valid options are `deny(STATUS)`, where valid values for
+        # `STATUS` are 403, 404, 429, and 502, and
+        # `redirect`, where the redirect parameters come from
+        # `exceedRedirectOptions` below.
+        # The `redirect` action is only supported in Global Security Policies of
+        # type CLOUD_ARMOR.
+    "exceedRedirectOptions": { # Parameters defining the redirect action that is used as the exceed
+        # action. Cannot be specified if the exceed action is not redirect.
+        # This field is only supported in Global Security Policies of type
+        # CLOUD_ARMOR.
+      "target": "A String", # Target for the redirect action. This is required if the type is
+          # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+      "type": "A String", # Type of the redirect action. Possible values are:
+          #
+          #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+          #    challenge assessment.
+          #    - EXTERNAL_302: redirect to a different URL via a 302
+          #    response.
+    },
+    "rateLimitThreshold": { # Threshold at which to begin ratelimiting.
+      "count": 42, # Number of HTTP(S) requests for calculating the threshold.
+      "intervalSec": 42, # Interval over which the threshold is computed.
+    },
+  },
+  "redirectOptions": { # Parameters defining the redirect action. Cannot be specified for any
+      # other actions.
+      # This field is only supported in Global Security Policies of type
+      # CLOUD_ARMOR.
+    "target": "A String", # Target for the redirect action. This is required if the type is
+        # EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.
+    "type": "A String", # Type of the redirect action. Possible values are:
+        #
+        #    - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual
+        #    challenge assessment.
+        #    - EXTERNAL_302: redirect to a different URL via a 302
+        #    response.
+  },
+}
+
+  priority: integer, The priority of the rule to patch.
+  updateMask: string, Indicates fields to be cleared as part of this request.
+  validateOnly: boolean, If true, the request will not be committed.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeRule(project, securityPolicy, priority=None, x__xgafv=None) + 
Deletes a rule at the specified priority.
+
+Args:
+  project: string, Project ID for this request. (required)
+  securityPolicy: string, Name of the security policy to update. (required)
+  priority: integer, The priority of the rule to remove from the security policy.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on a security policy. To learn more about labels,
+read the Labeling Resources
+documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.serviceAttachments.html b/docs/dyn/compute_preview.serviceAttachments.html new file mode 100644 index 0000000000..9cf6eab4ad --- /dev/null +++ b/docs/dyn/compute_preview.serviceAttachments.html @@ -0,0 +1,3315 @@ + + + +

Compute Engine API . serviceAttachments

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all ServiceAttachment resources,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, serviceAttachment, requestId=None, x__xgafv=None)

+

Deletes the specified ServiceAttachment in the given scope

+

+ get(project, region, serviceAttachment, showNatIps=None, x__xgafv=None)

+

Returns the specified ServiceAttachment resource in the given scope.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a ServiceAttachment in the specified project in the given scope

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the ServiceAttachments for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, serviceAttachment, body=None, requestId=None, x__xgafv=None)

+

Patches the specified ServiceAttachment resource with the data included in

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all ServiceAttachment resources,
+regional and global, available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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 ServiceAttachmentsScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of ServiceAttachmentsScopedList resources.
+    "a_key": { # Name of the scope containing this set of ServiceAttachments.
+      "serviceAttachments": [ # A list of ServiceAttachments contained in this scope.
+        { # Represents a ServiceAttachment resource.
+            #
+            # A service attachment represents a service that a producer has exposed.
+            # It encapsulates the load balancer which fronts the service runs and
+            # a list of NAT IP ranges that the producers uses to represent
+            # the consumers connecting to the service.
+          "connectedEndpoints": [ # Output only. [Output Only] An array of connections for all the consumers connected to
+              # this service attachment.
+            { # [Output Only] A connection connected to this service attachment.
+              "consumerNetwork": "A String", # The url of the consumer network.
+              "endpoint": "A String", # The url of a connected endpoint.
+              "endpointWithId": "A String", # The url of a connected endpoint with resource id.
+              "natIps": [ # NAT IPs of the connected PSC endpoint and those of other endpoints
+                  # propagated from it.
+                "A String",
+              ],
+              "propagatedConnectionCount": 42, # The number of consumer Network Connectivity Center spokes that the
+                  # connected Private Service Connect endpoint has propagated to.
+              "pscConnectionId": "A String", # The PSC connection id of the connected endpoint.
+              "status": "A String", # The status of a connected endpoint to this service attachment.
+            },
+          ],
+          "connectionPreference": "A String", # The connection preference of service attachment. The value can be set
+              # to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC
+              # service attachment is one that always accepts the connection from consumer
+              # forwarding rules.
+          "consumerAcceptLists": [ # Specifies which consumer projects or networks are allowed to connect to the
+              # service attachment. Each project or network has a connection limit. A given
+              # service attachment can manage connections at either the project or network
+              # level. Therefore, both the accept and reject lists for a given service
+              # attachment must contain either only projects or only networks or only
+              # endpoints.
+            {
+              "connectionLimit": 42, # The value of the limit to set. For endpoint_url, the limit should be no
+                  # more than 1.
+              "endpointUrl": "A String", # The URL for the PSC endpoint to accept
+              "networkUrl": "A String", # The network URL for the network to set the limit for.
+              "projectIdOrNum": "A String", # The project id or number for the project to set the limit for.
+            },
+          ],
+          "consumerRejectLists": [ # Specifies a list of projects or networks that are not allowed to connect to
+              # this service attachment. The project can be specified using its project ID
+              # or project number and the network can be specified using its URL. A given
+              # service attachment can manage connections at either the project or network
+              # level. Therefore, both the reject and accept lists for a given service
+              # attachment must contain either only projects or only networks.
+            "A String",
+          ],
+          "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.
+          "domainNames": [ # If specified, the domain name will be used during the integration between
+              # the PSC connected endpoints and the Cloud DNS. For example, this is a valid
+              # domain name: "p.mycompany.com.". Current max number of domain names
+              # supported is 1.
+            "A String",
+          ],
+          "enableProxyProtocol": True or False, # If true, enable the proxy protocol which is for supplying client TCP/IP
+              # address data in TCP connections that traverse proxies on their way to
+              # destination servers.
+          "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 ServiceAttachment. An up-to-date fingerprint must
+              # be provided in order to patch/update the ServiceAttachment; otherwise, the
+              # request will fail with error 412 conditionNotMet. To see the
+              # latest fingerprint, make a get() request to retrieve the
+              # ServiceAttachment.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+              # generates this identifier.
+          "kind": "compute#serviceAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+          "metadata": { # Metadata of the service attachment.
+            "a_key": "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.
+          "natIpsPerEndpoint": 42, # The number of NAT IP addresses to be allocated per connected endpoint.
+              # If not specified, the default value is 1.
+          "natSubnets": [ # An array of URLs where each entry is the URL of a subnet provided
+              # by the service producer to use for NAT in this service attachment.
+            "A String",
+          ],
+          "producerForwardingRule": "A String", # The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is
+              # serving the endpoint identified by this service attachment.
+          "propagatedConnectionLimit": 42, # The number of consumer spokes that connected Private Service Connect
+              # endpoints can be propagated to through Network Connectivity Center. This
+              # limit lets the service producer limit how many propagated Private Service
+              # Connect connections can be established to this service attachment from a
+              # single consumer.
+              #
+              # If the connection preference of the service attachment is ACCEPT_MANUAL,
+              # the limit applies to each project or network that is listed in the consumer
+              # accept list. If the connection preference of the service attachment is
+              # ACCEPT_AUTOMATIC, the limit applies to each project that contains a
+              # connected endpoint.
+              #
+              # If unspecified, the default propagated connection limit is 250.
+          "pscServiceAttachmentId": { # Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.
+            "high": "A String",
+            "low": "A String",
+          },
+          "reconcileConnections": True or False, # This flag determines whether a consumer accept/reject list change can
+              # reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.
+              #
+              #
+              #     -  If false, connection policy update will only affect existing PENDING
+              #     PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched
+              #     regardless how the connection policy is modified .
+              #    -  If true,
+              #     update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For
+              #     example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project
+              #     is added to the reject list.
+              #
+              #
+              # For newly created service attachment, this boolean defaults to false.
+          "region": "A String", # Output only. [Output Only] URL of the region where the service attachment resides.
+              # This field applies only to the region 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.
+          "targetService": "A String", # The URL of a service serving the endpoint identified by this service
+              # attachment.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # service attachments 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#serviceAttachmentAggregatedList", # 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, serviceAttachment, requestId=None, x__xgafv=None) + 
Deletes the specified ServiceAttachment in the given scope
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  serviceAttachment: string, Name of the ServiceAttachment 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, serviceAttachment, showNatIps=None, x__xgafv=None) + 
Returns the specified ServiceAttachment resource in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  serviceAttachment: string, Name of the ServiceAttachment resource to return. (required)
+  showNatIps: boolean, Indicates whether NAT IPs should be included in the response.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a ServiceAttachment resource.
+    #
+    # A service attachment represents a service that a producer has exposed.
+    # It encapsulates the load balancer which fronts the service runs and
+    # a list of NAT IP ranges that the producers uses to represent
+    # the consumers connecting to the service.
+  "connectedEndpoints": [ # Output only. [Output Only] An array of connections for all the consumers connected to
+      # this service attachment.
+    { # [Output Only] A connection connected to this service attachment.
+      "consumerNetwork": "A String", # The url of the consumer network.
+      "endpoint": "A String", # The url of a connected endpoint.
+      "endpointWithId": "A String", # The url of a connected endpoint with resource id.
+      "natIps": [ # NAT IPs of the connected PSC endpoint and those of other endpoints
+          # propagated from it.
+        "A String",
+      ],
+      "propagatedConnectionCount": 42, # The number of consumer Network Connectivity Center spokes that the
+          # connected Private Service Connect endpoint has propagated to.
+      "pscConnectionId": "A String", # The PSC connection id of the connected endpoint.
+      "status": "A String", # The status of a connected endpoint to this service attachment.
+    },
+  ],
+  "connectionPreference": "A String", # The connection preference of service attachment. The value can be set
+      # to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC
+      # service attachment is one that always accepts the connection from consumer
+      # forwarding rules.
+  "consumerAcceptLists": [ # Specifies which consumer projects or networks are allowed to connect to the
+      # service attachment. Each project or network has a connection limit. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the accept and reject lists for a given service
+      # attachment must contain either only projects or only networks or only
+      # endpoints.
+    {
+      "connectionLimit": 42, # The value of the limit to set. For endpoint_url, the limit should be no
+          # more than 1.
+      "endpointUrl": "A String", # The URL for the PSC endpoint to accept
+      "networkUrl": "A String", # The network URL for the network to set the limit for.
+      "projectIdOrNum": "A String", # The project id or number for the project to set the limit for.
+    },
+  ],
+  "consumerRejectLists": [ # Specifies a list of projects or networks that are not allowed to connect to
+      # this service attachment. The project can be specified using its project ID
+      # or project number and the network can be specified using its URL. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the reject and accept lists for a given service
+      # attachment must contain either only projects or only networks.
+    "A String",
+  ],
+  "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.
+  "domainNames": [ # If specified, the domain name will be used during the integration between
+      # the PSC connected endpoints and the Cloud DNS. For example, this is a valid
+      # domain name: "p.mycompany.com.". Current max number of domain names
+      # supported is 1.
+    "A String",
+  ],
+  "enableProxyProtocol": True or False, # If true, enable the proxy protocol which is for supplying client TCP/IP
+      # address data in TCP connections that traverse proxies on their way to
+      # destination servers.
+  "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 ServiceAttachment. An up-to-date fingerprint must
+      # be provided in order to patch/update the ServiceAttachment; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # ServiceAttachment.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#serviceAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+  "metadata": { # Metadata of the service attachment.
+    "a_key": "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.
+  "natIpsPerEndpoint": 42, # The number of NAT IP addresses to be allocated per connected endpoint.
+      # If not specified, the default value is 1.
+  "natSubnets": [ # An array of URLs where each entry is the URL of a subnet provided
+      # by the service producer to use for NAT in this service attachment.
+    "A String",
+  ],
+  "producerForwardingRule": "A String", # The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is
+      # serving the endpoint identified by this service attachment.
+  "propagatedConnectionLimit": 42, # The number of consumer spokes that connected Private Service Connect
+      # endpoints can be propagated to through Network Connectivity Center. This
+      # limit lets the service producer limit how many propagated Private Service
+      # Connect connections can be established to this service attachment from a
+      # single consumer.
+      #
+      # If the connection preference of the service attachment is ACCEPT_MANUAL,
+      # the limit applies to each project or network that is listed in the consumer
+      # accept list. If the connection preference of the service attachment is
+      # ACCEPT_AUTOMATIC, the limit applies to each project that contains a
+      # connected endpoint.
+      #
+      # If unspecified, the default propagated connection limit is 250.
+  "pscServiceAttachmentId": { # Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.
+    "high": "A String",
+    "low": "A String",
+  },
+  "reconcileConnections": True or False, # This flag determines whether a consumer accept/reject list change can
+      # reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.
+      #
+      #
+      #     -  If false, connection policy update will only affect existing PENDING
+      #     PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched
+      #     regardless how the connection policy is modified .
+      #    -  If true,
+      #     update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For
+      #     example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project
+      #     is added to the reject list.
+      #
+      #
+      # For newly created service attachment, this boolean defaults to false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the service attachment resides.
+      # This field applies only to the region 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.
+  "targetService": "A String", # The URL of a service serving the endpoint identified by this service
+      # attachment.
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a ServiceAttachment in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a ServiceAttachment resource.
+    # 
+    # A service attachment represents a service that a producer has exposed.
+    # It encapsulates the load balancer which fronts the service runs and
+    # a list of NAT IP ranges that the producers uses to represent
+    # the consumers connecting to the service.
+  "connectedEndpoints": [ # Output only. [Output Only] An array of connections for all the consumers connected to
+      # this service attachment.
+    { # [Output Only] A connection connected to this service attachment.
+      "consumerNetwork": "A String", # The url of the consumer network.
+      "endpoint": "A String", # The url of a connected endpoint.
+      "endpointWithId": "A String", # The url of a connected endpoint with resource id.
+      "natIps": [ # NAT IPs of the connected PSC endpoint and those of other endpoints
+          # propagated from it.
+        "A String",
+      ],
+      "propagatedConnectionCount": 42, # The number of consumer Network Connectivity Center spokes that the
+          # connected Private Service Connect endpoint has propagated to.
+      "pscConnectionId": "A String", # The PSC connection id of the connected endpoint.
+      "status": "A String", # The status of a connected endpoint to this service attachment.
+    },
+  ],
+  "connectionPreference": "A String", # The connection preference of service attachment. The value can be set
+      # to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC
+      # service attachment is one that always accepts the connection from consumer
+      # forwarding rules.
+  "consumerAcceptLists": [ # Specifies which consumer projects or networks are allowed to connect to the
+      # service attachment. Each project or network has a connection limit. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the accept and reject lists for a given service
+      # attachment must contain either only projects or only networks or only
+      # endpoints.
+    {
+      "connectionLimit": 42, # The value of the limit to set. For endpoint_url, the limit should be no
+          # more than 1.
+      "endpointUrl": "A String", # The URL for the PSC endpoint to accept
+      "networkUrl": "A String", # The network URL for the network to set the limit for.
+      "projectIdOrNum": "A String", # The project id or number for the project to set the limit for.
+    },
+  ],
+  "consumerRejectLists": [ # Specifies a list of projects or networks that are not allowed to connect to
+      # this service attachment. The project can be specified using its project ID
+      # or project number and the network can be specified using its URL. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the reject and accept lists for a given service
+      # attachment must contain either only projects or only networks.
+    "A String",
+  ],
+  "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.
+  "domainNames": [ # If specified, the domain name will be used during the integration between
+      # the PSC connected endpoints and the Cloud DNS. For example, this is a valid
+      # domain name: "p.mycompany.com.". Current max number of domain names
+      # supported is 1.
+    "A String",
+  ],
+  "enableProxyProtocol": True or False, # If true, enable the proxy protocol which is for supplying client TCP/IP
+      # address data in TCP connections that traverse proxies on their way to
+      # destination servers.
+  "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 ServiceAttachment. An up-to-date fingerprint must
+      # be provided in order to patch/update the ServiceAttachment; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # ServiceAttachment.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#serviceAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+  "metadata": { # Metadata of the service attachment.
+    "a_key": "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.
+  "natIpsPerEndpoint": 42, # The number of NAT IP addresses to be allocated per connected endpoint.
+      # If not specified, the default value is 1.
+  "natSubnets": [ # An array of URLs where each entry is the URL of a subnet provided
+      # by the service producer to use for NAT in this service attachment.
+    "A String",
+  ],
+  "producerForwardingRule": "A String", # The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is
+      # serving the endpoint identified by this service attachment.
+  "propagatedConnectionLimit": 42, # The number of consumer spokes that connected Private Service Connect
+      # endpoints can be propagated to through Network Connectivity Center. This
+      # limit lets the service producer limit how many propagated Private Service
+      # Connect connections can be established to this service attachment from a
+      # single consumer.
+      # 
+      # If the connection preference of the service attachment is ACCEPT_MANUAL,
+      # the limit applies to each project or network that is listed in the consumer
+      # accept list. If the connection preference of the service attachment is
+      # ACCEPT_AUTOMATIC, the limit applies to each project that contains a
+      # connected endpoint.
+      # 
+      # If unspecified, the default propagated connection limit is 250.
+  "pscServiceAttachmentId": { # Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.
+    "high": "A String",
+    "low": "A String",
+  },
+  "reconcileConnections": True or False, # This flag determines whether a consumer accept/reject list change can
+      # reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.
+      # 
+      # 
+      #     -  If false, connection policy update will only affect existing PENDING
+      #     PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched
+      #     regardless how the connection policy is modified .
+      #    -  If true,
+      #     update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For
+      #     example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project
+      #     is added to the reject list.
+      # 
+      # 
+      # For newly created service attachment, this boolean defaults to false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the service attachment resides.
+      # This field applies only to the region 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.
+  "targetService": "A String", # The URL of a service serving the endpoint identified by this service
+      # attachment.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the ServiceAttachments for a project in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region of 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.
+  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 ServiceAttachment resources.
+    { # Represents a ServiceAttachment resource.
+        #
+        # A service attachment represents a service that a producer has exposed.
+        # It encapsulates the load balancer which fronts the service runs and
+        # a list of NAT IP ranges that the producers uses to represent
+        # the consumers connecting to the service.
+      "connectedEndpoints": [ # Output only. [Output Only] An array of connections for all the consumers connected to
+          # this service attachment.
+        { # [Output Only] A connection connected to this service attachment.
+          "consumerNetwork": "A String", # The url of the consumer network.
+          "endpoint": "A String", # The url of a connected endpoint.
+          "endpointWithId": "A String", # The url of a connected endpoint with resource id.
+          "natIps": [ # NAT IPs of the connected PSC endpoint and those of other endpoints
+              # propagated from it.
+            "A String",
+          ],
+          "propagatedConnectionCount": 42, # The number of consumer Network Connectivity Center spokes that the
+              # connected Private Service Connect endpoint has propagated to.
+          "pscConnectionId": "A String", # The PSC connection id of the connected endpoint.
+          "status": "A String", # The status of a connected endpoint to this service attachment.
+        },
+      ],
+      "connectionPreference": "A String", # The connection preference of service attachment. The value can be set
+          # to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC
+          # service attachment is one that always accepts the connection from consumer
+          # forwarding rules.
+      "consumerAcceptLists": [ # Specifies which consumer projects or networks are allowed to connect to the
+          # service attachment. Each project or network has a connection limit. A given
+          # service attachment can manage connections at either the project or network
+          # level. Therefore, both the accept and reject lists for a given service
+          # attachment must contain either only projects or only networks or only
+          # endpoints.
+        {
+          "connectionLimit": 42, # The value of the limit to set. For endpoint_url, the limit should be no
+              # more than 1.
+          "endpointUrl": "A String", # The URL for the PSC endpoint to accept
+          "networkUrl": "A String", # The network URL for the network to set the limit for.
+          "projectIdOrNum": "A String", # The project id or number for the project to set the limit for.
+        },
+      ],
+      "consumerRejectLists": [ # Specifies a list of projects or networks that are not allowed to connect to
+          # this service attachment. The project can be specified using its project ID
+          # or project number and the network can be specified using its URL. A given
+          # service attachment can manage connections at either the project or network
+          # level. Therefore, both the reject and accept lists for a given service
+          # attachment must contain either only projects or only networks.
+        "A String",
+      ],
+      "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.
+      "domainNames": [ # If specified, the domain name will be used during the integration between
+          # the PSC connected endpoints and the Cloud DNS. For example, this is a valid
+          # domain name: "p.mycompany.com.". Current max number of domain names
+          # supported is 1.
+        "A String",
+      ],
+      "enableProxyProtocol": True or False, # If true, enable the proxy protocol which is for supplying client TCP/IP
+          # address data in TCP connections that traverse proxies on their way to
+          # destination servers.
+      "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 ServiceAttachment. An up-to-date fingerprint must
+          # be provided in order to patch/update the ServiceAttachment; otherwise, the
+          # request will fail with error 412 conditionNotMet. To see the
+          # latest fingerprint, make a get() request to retrieve the
+          # ServiceAttachment.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "kind": "compute#serviceAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+      "metadata": { # Metadata of the service attachment.
+        "a_key": "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.
+      "natIpsPerEndpoint": 42, # The number of NAT IP addresses to be allocated per connected endpoint.
+          # If not specified, the default value is 1.
+      "natSubnets": [ # An array of URLs where each entry is the URL of a subnet provided
+          # by the service producer to use for NAT in this service attachment.
+        "A String",
+      ],
+      "producerForwardingRule": "A String", # The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is
+          # serving the endpoint identified by this service attachment.
+      "propagatedConnectionLimit": 42, # The number of consumer spokes that connected Private Service Connect
+          # endpoints can be propagated to through Network Connectivity Center. This
+          # limit lets the service producer limit how many propagated Private Service
+          # Connect connections can be established to this service attachment from a
+          # single consumer.
+          #
+          # If the connection preference of the service attachment is ACCEPT_MANUAL,
+          # the limit applies to each project or network that is listed in the consumer
+          # accept list. If the connection preference of the service attachment is
+          # ACCEPT_AUTOMATIC, the limit applies to each project that contains a
+          # connected endpoint.
+          #
+          # If unspecified, the default propagated connection limit is 250.
+      "pscServiceAttachmentId": { # Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.
+        "high": "A String",
+        "low": "A String",
+      },
+      "reconcileConnections": True or False, # This flag determines whether a consumer accept/reject list change can
+          # reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.
+          #
+          #
+          #     -  If false, connection policy update will only affect existing PENDING
+          #     PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched
+          #     regardless how the connection policy is modified .
+          #    -  If true,
+          #     update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For
+          #     example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project
+          #     is added to the reject list.
+          #
+          #
+          # For newly created service attachment, this boolean defaults to false.
+      "region": "A String", # Output only. [Output Only] URL of the region where the service attachment resides.
+          # This field applies only to the region 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.
+      "targetService": "A String", # The URL of a service serving the endpoint identified by this service
+          # attachment.
+    },
+  ],
+  "kind": "compute#serviceAttachmentList", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+  "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, serviceAttachment, body=None, requestId=None, x__xgafv=None) + 
Patches the specified ServiceAttachment resource with the data included in
+the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The region scoping this request and should conform to RFC1035. (required)
+  serviceAttachment: string, The resource id of the ServiceAttachment to patch. It should conform to
+RFC1035 resource name or be a string form on an unsigned long number. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a ServiceAttachment resource.
+    # 
+    # A service attachment represents a service that a producer has exposed.
+    # It encapsulates the load balancer which fronts the service runs and
+    # a list of NAT IP ranges that the producers uses to represent
+    # the consumers connecting to the service.
+  "connectedEndpoints": [ # Output only. [Output Only] An array of connections for all the consumers connected to
+      # this service attachment.
+    { # [Output Only] A connection connected to this service attachment.
+      "consumerNetwork": "A String", # The url of the consumer network.
+      "endpoint": "A String", # The url of a connected endpoint.
+      "endpointWithId": "A String", # The url of a connected endpoint with resource id.
+      "natIps": [ # NAT IPs of the connected PSC endpoint and those of other endpoints
+          # propagated from it.
+        "A String",
+      ],
+      "propagatedConnectionCount": 42, # The number of consumer Network Connectivity Center spokes that the
+          # connected Private Service Connect endpoint has propagated to.
+      "pscConnectionId": "A String", # The PSC connection id of the connected endpoint.
+      "status": "A String", # The status of a connected endpoint to this service attachment.
+    },
+  ],
+  "connectionPreference": "A String", # The connection preference of service attachment. The value can be set
+      # to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC
+      # service attachment is one that always accepts the connection from consumer
+      # forwarding rules.
+  "consumerAcceptLists": [ # Specifies which consumer projects or networks are allowed to connect to the
+      # service attachment. Each project or network has a connection limit. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the accept and reject lists for a given service
+      # attachment must contain either only projects or only networks or only
+      # endpoints.
+    {
+      "connectionLimit": 42, # The value of the limit to set. For endpoint_url, the limit should be no
+          # more than 1.
+      "endpointUrl": "A String", # The URL for the PSC endpoint to accept
+      "networkUrl": "A String", # The network URL for the network to set the limit for.
+      "projectIdOrNum": "A String", # The project id or number for the project to set the limit for.
+    },
+  ],
+  "consumerRejectLists": [ # Specifies a list of projects or networks that are not allowed to connect to
+      # this service attachment. The project can be specified using its project ID
+      # or project number and the network can be specified using its URL. A given
+      # service attachment can manage connections at either the project or network
+      # level. Therefore, both the reject and accept lists for a given service
+      # attachment must contain either only projects or only networks.
+    "A String",
+  ],
+  "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.
+  "domainNames": [ # If specified, the domain name will be used during the integration between
+      # the PSC connected endpoints and the Cloud DNS. For example, this is a valid
+      # domain name: "p.mycompany.com.". Current max number of domain names
+      # supported is 1.
+    "A String",
+  ],
+  "enableProxyProtocol": True or False, # If true, enable the proxy protocol which is for supplying client TCP/IP
+      # address data in TCP connections that traverse proxies on their way to
+      # destination servers.
+  "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 ServiceAttachment. An up-to-date fingerprint must
+      # be provided in order to patch/update the ServiceAttachment; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # ServiceAttachment.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#serviceAttachment", # Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.
+  "metadata": { # Metadata of the service attachment.
+    "a_key": "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.
+  "natIpsPerEndpoint": 42, # The number of NAT IP addresses to be allocated per connected endpoint.
+      # If not specified, the default value is 1.
+  "natSubnets": [ # An array of URLs where each entry is the URL of a subnet provided
+      # by the service producer to use for NAT in this service attachment.
+    "A String",
+  ],
+  "producerForwardingRule": "A String", # The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is
+      # serving the endpoint identified by this service attachment.
+  "propagatedConnectionLimit": 42, # The number of consumer spokes that connected Private Service Connect
+      # endpoints can be propagated to through Network Connectivity Center. This
+      # limit lets the service producer limit how many propagated Private Service
+      # Connect connections can be established to this service attachment from a
+      # single consumer.
+      # 
+      # If the connection preference of the service attachment is ACCEPT_MANUAL,
+      # the limit applies to each project or network that is listed in the consumer
+      # accept list. If the connection preference of the service attachment is
+      # ACCEPT_AUTOMATIC, the limit applies to each project that contains a
+      # connected endpoint.
+      # 
+      # If unspecified, the default propagated connection limit is 250.
+  "pscServiceAttachmentId": { # Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.
+    "high": "A String",
+    "low": "A String",
+  },
+  "reconcileConnections": True or False, # This flag determines whether a consumer accept/reject list change can
+      # reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.
+      # 
+      # 
+      #     -  If false, connection policy update will only affect existing PENDING
+      #     PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched
+      #     regardless how the connection policy is modified .
+      #    -  If true,
+      #     update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For
+      #     example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project
+      #     is added to the reject list.
+      # 
+      # 
+      # For newly created service attachment, this boolean defaults to false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the service attachment resides.
+      # This field applies only to the region 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.
+  "targetService": "A String", # The URL of a service serving the endpoint identified by this service
+      # attachment.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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, 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_preview.snapshotSettings.html b/docs/dyn/compute_preview.snapshotSettings.html new file mode 100644 index 0000000000..54c0e2a31a --- /dev/null +++ b/docs/dyn/compute_preview.snapshotSettings.html @@ -0,0 +1,463 @@ + + + +

Compute Engine API . snapshotSettings

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, x__xgafv=None)

+

Get snapshot settings.

+

+ patch(project, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Patch snapshot settings.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, x__xgafv=None) + 
Get snapshot settings.
+
+Args:
+  project: string, Project ID for this request. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "accessLocation": { # (Regional snapshots use only)Policy of which location is allowed to access
+      # snapshot.
+    "locations": { # List of regions that can restore a regional
+        #  snapshot from the current region
+      "a_key": { # A structure for specifying an allowed target region.
+        "region": "A String", # Accessible region name
+      },
+    },
+    "policy": "A String", # Policy of which location is allowed to access snapshot.
+  },
+  "storageLocation": { # Policy of which storage location is going to be resolved, and additional
+      # data that particularizes how the policy is going to be carried out.
+    "locations": { # When the policy is SPECIFIC_LOCATIONS, snapshots will be stored
+        # in the locations listed in this field. Keys are Cloud Storage bucket
+        # locations. Only one location can be specified.
+      "a_key": { # A structure for specifying storage locations.
+        "name": "A String", # Name of the location. It should be one of the Cloud Storage buckets.
+            # Only one location can be specified.
+      },
+    },
+    "policy": "A String", # The chosen location policy.
+  },
+}
+
+ +
+ patch(project, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Patch snapshot settings.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "accessLocation": { # (Regional snapshots use only)Policy of which location is allowed to access
+      # snapshot.
+    "locations": { # List of regions that can restore a regional
+        #  snapshot from the current region
+      "a_key": { # A structure for specifying an allowed target region.
+        "region": "A String", # Accessible region name
+      },
+    },
+    "policy": "A String", # Policy of which location is allowed to access snapshot.
+  },
+  "storageLocation": { # Policy of which storage location is going to be resolved, and additional
+      # data that particularizes how the policy is going to be carried out.
+    "locations": { # When the policy is SPECIFIC_LOCATIONS, snapshots will be stored
+        # in the locations listed in this field. Keys are Cloud Storage bucket
+        # locations. Only one location can be specified.
+      "a_key": { # A structure for specifying storage locations.
+        "name": "A String", # Name of the location. It should be one of the Cloud Storage buckets.
+            # Only one location can be specified.
+      },
+    },
+    "policy": "A String", # The chosen location policy.
+  },
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.snapshots.html b/docs/dyn/compute_preview.snapshots.html new file mode 100644 index 0000000000..0b3ed634e9 --- /dev/null +++ b/docs/dyn/compute_preview.snapshots.html @@ -0,0 +1,3802 @@ + + + +

Compute Engine API . snapshots

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, snapshot, requestId=None, x__xgafv=None)

+

Deletes the specified Snapshot resource. Keep in mind that deleting

+

+ get(project, snapshot, x__xgafv=None)

+

Returns the specified Snapshot 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 in the specified project using the data included

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Snapshot 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.

+

+ setLabels(project, resource, body=None, x__xgafv=None)

+

Sets the labels on a snapshot. To learn more about labels, read theLabeling

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ updateKmsKey(project, snapshot, body=None, requestId=None, x__xgafv=None)

+

Rotates the customer-managed

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, snapshot, requestId=None, x__xgafv=None) + 
Deletes the specified Snapshot resource. Keep in mind that deleting
+a single snapshot might not necessarily delete all the data on that
+snapshot. If any data on the snapshot that is marked for deletion is
+needed for subsequent snapshots, the data will be moved to the next
+corresponding snapshot.
+
+For more information, seeDeleting
+snapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  snapshot: string, Name of the Snapshot 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, snapshot, x__xgafv=None) + 
Returns the specified Snapshot resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  snapshot: string, Name of the Snapshot 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 Persistent Disk Snapshot resource.
+    #
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      #
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      #
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      #
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "A String",
+  ],
+}
+
+ +
+ 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 in the specified project using the data included
+in the request. For regular snapshot creation, consider using this method
+instead of disks.createSnapshot,
+as this method supports more features, such as creating snapshots in a
+project different from the source disk project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Persistent Disk Snapshot resource.
+    # 
+    # You can use snapshots to back up data on a regular interval. For more
+    # information, read  Creating
+    # persistent disk snapshots.
+  "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+      # ARM64 or X86_64.
+  "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+      # applying resource policy on the target disk.
+  "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+      # specified name. The chain name must be 1-63 characters long and comply
+      # with RFC1035. This is an uncommon option only for advanced service
+      # owners who needs to create separate snapshot chains, for example,
+      # for chargeback tracking. When you describe your snapshot resource, this
+      # field is visible only if it has a non-empty value.
+  "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+  "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.
+  "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+  "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+  "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+      # [Output Only]: This field is not set by user, but from source disk.
+  "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+      # informing the OS to prepare for the snapshot process.
+  "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+      # Applicable only for bootable images. Read
+      # Enabling guest operating system features to see a list of available
+      # options.
+    { # Guest OS features.
+      "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+          # separate values. Set to one or more of the following values:
+          #
+          #    - VIRTIO_SCSI_MULTIQUEUE
+          #    - WINDOWS
+          #    - MULTI_IP_SUBNET
+          #    - UEFI_COMPATIBLE
+          #    - GVNIC
+          #    - SEV_CAPABLE
+          #    - SUSPEND_RESUME_COMPATIBLE
+          #    - SEV_LIVE_MIGRATABLE_V2
+          #    - SEV_SNP_CAPABLE
+          #    - TDX_CAPABLE
+          #    - IDPF
+          #    - SNP_SVSM_CAPABLE
+          #    - CCA_CAPABLE
+          #    - SUSPEND_SAFE_FPR
+          #
+          #
+          # For more information, see
+          # Enabling guest operating system features.
+    },
+  ],
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+      # for Snapshot resources.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a snapshot.
+  "labels": { # Labels to apply to this snapshot. These can be later modified by
+      # the setLabels method.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+      # to this snapshot.
+    "A String",
+  ],
+  "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+      # snapshot. This can be because the original image had licenses attached
+      # (such as a Windows image).
+    "A String",
+  ],
+  "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+      # resources.
+      # This field is for use by internal tools that use the public API.
+  "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.
+  "params": { # Additional snapshot params. # Input only. [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 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/{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",
+    },
+  },
+  "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+      # for regional snapshots.
+  "satisfiesPzi": True or False, # Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+      # encryption key.
+      # 
+      # After you encrypt a snapshot using a customer-supplied key, you must
+      # provide the same key if you use the snapshot later. For example, you must
+      # provide the encryption key when you create a disk from the encrypted
+      # snapshot in a future request.
+      # 
+      # Customer-supplied encryption keys do not protect access to metadata
+      # of the snapshot.
+      # 
+      # If you do not provide an encryption key when creating the snapshot, then
+      # the snapshot will be encrypted using an automatically generated key and you
+      # do not need to provide a key to use the snapshot later.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 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. The usage of snapshot group feature is restricted.
+  "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+      # of snapshot group feature is restricted.
+  "snapshotType": "A String", # Indicates the type of the snapshot.
+  "sourceDisk": "A String", # The source disk used to create this snapshot.
+  "sourceDiskEncryptionKey": { # The customer-supplied
+      # encryption key of the source disk. Required if the source disk is
+      # protected by a customer-supplied encryption key.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+      # snapshot.
+  "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+      # value may be used to determine whether the snapshot was taken from the
+      # current or a previous instance of a given disk name.
+  "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+      #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+      #    - zones/zone/instantSnapshots/instantSnapshot
+  "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+      # Snapshot.
+    "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+        # For example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        #
+        # The fully-qualifed key name may be returned for resource GET requests. For
+        # example:
+        #
+        # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+        # key_region/cryptoKeys/key
+        # /cryptoKeyVersions/1
+    "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+        # key. If absent, the Compute Engine default service account is used.
+        # For example:
+        #
+        # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+    "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies a 256-bit customer-supplied
+        # encryption key, encoded in RFC
+        # 4648 base64 to either encrypt or decrypt this resource. You can
+        # provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rawKey":
+        # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+    "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+        # customer-supplied encryption key to either encrypt or decrypt this
+        # resource. You can provide either the rawKey or thersaEncryptedKey.
+        # For example:
+        #
+        # "rsaEncryptedKey":
+        # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+        # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+        # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+        #
+        # The key must meet the following requirements before you can provide it to
+        # Compute Engine:
+        #
+        #    1. The key is wrapped using a RSA public key certificate provided by
+        #    Google.
+        #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+        #    encoding.
+        #
+        # Gets the RSA public key certificate provided by Google at:
+        #
+        #
+        # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+    "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+        # [Output only] TheRFC
+        # 4648 base64 encoded SHA-256 hash of the customer-supplied
+        # encryption key that protects this resource.
+  },
+  "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+      # snapshot. This value identifies the exact instant snapshot that was used to
+      # create this snapshot. For example, if you created the snapshot from an
+      # instant snapshot that was later deleted and recreated under the same name,
+      # the source instant snapshot ID would identify the exact instant snapshot
+      # that was used.
+  "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+      # scheduled snapshot.
+  "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+      # scheduled snapshot.
+  "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+  "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+      # share storage, this number is expected to change with snapshot
+      # creation/deletion.
+  "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+      # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+      # [Output Only] An indicator whether storageBytes is in a
+      # stable state or it is being adjusted as a result of shared storage
+      # reallocation. This status can either be unset, meaning the snapshot is
+      # being created, or UP_TO_DATE, meaning the size of the snapshot
+      # is up-to-date.
+  "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+      # multi-regional).
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of Snapshot 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.
+  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 Snapshot resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Snapshot resources.
+    { # Represents a Persistent Disk Snapshot resource.
+        #
+        # You can use snapshots to back up data on a regular interval. For more
+        # information, read  Creating
+        # persistent disk snapshots.
+      "architecture": "A String", # Output only. [Output Only] The architecture of the snapshot. Valid values are
+          # ARM64 or X86_64.
+      "autoCreated": True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
+          # applying resource policy on the target disk.
+      "chainName": "A String", # Creates the new snapshot in the snapshot chain labeled with the
+          # specified name. The chain name must be 1-63 characters long and comply
+          # with RFC1035. This is an uncommon option only for advanced service
+          # owners who needs to create separate snapshot chains, for example,
+          # for chargeback tracking. When you describe your snapshot resource, this
+          # field is visible only if it has a non-empty value.
+      "creationSizeBytes": "A String", # Output only. [Output Only] Size in bytes of the snapshot at creation time.
+      "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.
+      "diskSizeGb": "A String", # Output only. [Output Only] Size of the source disk, specified in GB.
+      "downloadBytes": "A String", # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+      "enableConfidentialCompute": True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
+          # [Output Only]: This field is not set by user, but from source disk.
+      "guestFlush": True or False, # [Input Only] Whether to attempt an application consistent snapshot by
+          # informing the OS to prepare for the snapshot process.
+      "guestOsFeatures": [ # Output only. [Output Only] A list of features to enable on the guest operating system.
+          # Applicable only for bootable images. Read
+          # Enabling guest operating system features to see a list of available
+          # options.
+        { # Guest OS features.
+          "type": "A String", # The ID of a supported feature. To add multiple values, use commas to
+              # separate values. Set to one or more of the following values:
+              #
+              #    - VIRTIO_SCSI_MULTIQUEUE
+              #    - WINDOWS
+              #    - MULTI_IP_SUBNET
+              #    - UEFI_COMPATIBLE
+              #    - GVNIC
+              #    - SEV_CAPABLE
+              #    - SUSPEND_RESUME_COMPATIBLE
+              #    - SEV_LIVE_MIGRATABLE_V2
+              #    - SEV_SNP_CAPABLE
+              #    - TDX_CAPABLE
+              #    - IDPF
+              #    - SNP_SVSM_CAPABLE
+              #    - CCA_CAPABLE
+              #    - SUSPEND_SAFE_FPR
+              #
+              #
+              # For more information, see
+              # Enabling guest operating system features.
+        },
+      ],
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#snapshot", # Output only. [Output Only] Type of the resource. Always compute#snapshot
+          # for Snapshot resources.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this snapshot, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a snapshot.
+      "labels": { # Labels to apply to this snapshot. These can be later modified by
+          # the setLabels method.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "licenseCodes": [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
+          # to this snapshot.
+        "A String",
+      ],
+      "licenses": [ # Output only. [Output Only] A list of public visible licenses that apply to this
+          # snapshot. This can be because the original image had licenses attached
+          # (such as a Windows image).
+        "A String",
+      ],
+      "locationHint": "A String", # An opaque location hint used to place the snapshot close to other
+          # resources.
+          # This field is for use by internal tools that use the public API.
+      "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.
+      "params": { # Additional snapshot params. # Input only. [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 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/{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",
+        },
+      },
+      "region": "A String", # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
+          # for regional snapshots.
+      "satisfiesPzi": True or False, # Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Output only. [Output Only] Reserved for future use.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "snapshotEncryptionKey": { # Encrypts the snapshot using acustomer-supplied
+          # encryption key.
+          #
+          # After you encrypt a snapshot using a customer-supplied key, you must
+          # provide the same key if you use the snapshot later. For example, you must
+          # provide the encryption key when you create a disk from the encrypted
+          # snapshot in a future request.
+          #
+          # Customer-supplied encryption keys do not protect access to metadata
+          # of the snapshot.
+          #
+          # If you do not provide an encryption key when creating the snapshot, then
+          # the snapshot will be encrypted using an automatically generated key and you
+          # do not need to provide a key to use the snapshot later.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 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. The usage of snapshot group feature is restricted.
+      "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
+          # of snapshot group feature is restricted.
+      "snapshotType": "A String", # Indicates the type of the snapshot.
+      "sourceDisk": "A String", # The source disk used to create this snapshot.
+      "sourceDiskEncryptionKey": { # The customer-supplied
+          # encryption key of the source disk. Required if the source disk is
+          # protected by a customer-supplied encryption key.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceDiskForRecoveryCheckpoint": "A String", # The source disk whose recovery checkpoint will be used to create this
+          # snapshot.
+      "sourceDiskId": "A String", # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
+          # value may be used to determine whether the snapshot was taken from the
+          # current or a previous instance of a given disk name.
+      "sourceInstantSnapshot": "A String", # The source instant snapshot used to create this snapshot. 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/zones/zone/instantSnapshots/instantSnapshot
+          #      - projects/project/zones/zone/instantSnapshots/instantSnapshot
+          #    - zones/zone/instantSnapshots/instantSnapshot
+      "sourceInstantSnapshotEncryptionKey": { # Customer provided encryption key when creating Snapshot from Instant
+          # Snapshot.
+        "kmsKeyName": "A String", # The name of the encryption key that is stored in Google Cloud KMS.
+            # For example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            #
+            # The fully-qualifed key name may be returned for resource GET requests. For
+            # example:
+            #
+            # "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/
+            # key_region/cryptoKeys/key
+            # /cryptoKeyVersions/1
+        "kmsKeyServiceAccount": "A String", # The service account being used for the encryption request for the given KMS
+            # key. If absent, the Compute Engine default service account is used.
+            # For example:
+            #
+            # "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/
+        "rawKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies a 256-bit customer-supplied
+            # encryption key, encoded in RFC
+            # 4648 base64 to either encrypt or decrypt this resource. You can
+            # provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rawKey":
+            # "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
+        "rsaEncryptedKey": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
+            # customer-supplied encryption key to either encrypt or decrypt this
+            # resource. You can provide either the rawKey or thersaEncryptedKey.
+            # For example:
+            #
+            # "rsaEncryptedKey":
+            # "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
+            # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
+            # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe=="
+            #
+            # The key must meet the following requirements before you can provide it to
+            # Compute Engine:
+            #
+            #    1. The key is wrapped using a RSA public key certificate provided by
+            #    Google.
+            #    2. After being wrapped, the key must be encoded in RFC 4648 base64
+            #    encoding.
+            #
+            # Gets the RSA public key certificate provided by Google at:
+            #
+            #
+            # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
+        "sha256": "A String", # [DEPRECATED] CSEK is no longer supported. Use CMEK instead.
+            # [Output only] TheRFC
+            # 4648 base64 encoded SHA-256 hash of the customer-supplied
+            # encryption key that protects this resource.
+      },
+      "sourceInstantSnapshotId": "A String", # Output only. [Output Only] The unique ID of the instant snapshot used to create this
+          # snapshot. This value identifies the exact instant snapshot that was used to
+          # create this snapshot. For example, if you created the snapshot from an
+          # instant snapshot that was later deleted and recreated under the same name,
+          # the source instant snapshot ID would identify the exact instant snapshot
+          # that was used.
+      "sourceSnapshotSchedulePolicy": "A String", # Output only. [Output Only] URL of the resource policy which created this
+          # scheduled snapshot.
+      "sourceSnapshotSchedulePolicyId": "A String", # Output only. [Output Only] ID of the resource policy which created this
+          # scheduled snapshot.
+      "status": "A String", # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
+      "storageBytes": "A String", # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
+          # share storage, this number is expected to change with snapshot
+          # creation/deletion.
+      "storageBytesStatus": "A String", # Output only. [Deprecated] Instead, check the storageBytes field. After
+          # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
+          # [Output Only] An indicator whether storageBytes is in a
+          # stable state or it is being adjusted as a result of shared storage
+          # reallocation. This status can either be unset, meaning the snapshot is
+          # being created, or UP_TO_DATE, meaning the size of the snapshot
+          # is up-to-date.
+      "storageLocations": [ # Cloud Storage bucket storage location of the snapshot (regional or
+          # multi-regional).
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#snapshotList", # 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.
+  "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).
+}
+
+ +
+ setLabels(project, resource, body=None, x__xgafv=None) + 
Sets the labels on a snapshot. To learn more about labels, read theLabeling
+Resources documentation.
+
+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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash when updating or changing
+      # labels, otherwise the request will fail with error412 conditionNotMet.  Make a get() request to the
+      # resource to get the latest fingerprint.
+  "labels": { # A list of labels to apply for this resource. Each label must comply with
+      # the
+      # requirements for labels. For example,"webserver-frontend": "images". A label value can also be
+      # empty (e.g. "my-label": "").
+    "a_key": "A String",
+  },
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ updateKmsKey(project, snapshot, body=None, requestId=None, x__xgafv=None) + 
Rotates the customer-managed
+encryption key to the latest version for the specified snapshot.
+
+Args:
+  project: string, Project ID for this request. (required)
+  snapshot: string, Name of the snapshot resource to update. Should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "kmsKeyName": "A String", # Optional. The new KMS key to replace the current one on the snapshot. If empty, the
+      # snapshot will be re-encrypted using the primary version of the snapshot's
+      # current KMS key.
+      # 
+      # The KMS key can be provided in the following formats:
+      # 
+      # 
+      #      - projects/project_id/locations/region/keyRings/key_ring/cryptoKeys/key
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.sslCertificates.html b/docs/dyn/compute_preview.sslCertificates.html new file mode 100644 index 0000000000..9cb337206a --- /dev/null +++ b/docs/dyn/compute_preview.sslCertificates.html @@ -0,0 +1,1406 @@ + + + +

Compute Engine API . sslCertificates

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all SslCertificate resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, sslCertificate, requestId=None, x__xgafv=None)

+

Deletes the specified SslCertificate resource.

+

+ get(project, sslCertificate, x__xgafv=None)

+

Returns the specified SslCertificate resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a SslCertificate resource in the specified project using the data

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of SslCertificate resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all SslCertificate resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of SslCertificatesScopedList resources.
+    "a_key": { # Name of the scope containing this set of SslCertificates.
+      "sslCertificates": [ # List of SslCertificates contained in this scope.
+        { # Represents an SSL certificate resource.
+            #
+            # Google Compute Engine has two SSL certificate resources:
+            #
+            # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+            # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+            #
+            #
+            # The global SSL certificates (sslCertificates) are used by:
+            #
+            #    - Global external Application Load Balancers
+            #    - Classic Application Load Balancers
+            #    - Proxy Network Load Balancers (with target SSL proxies)
+            #
+            #
+            #
+            # The regional SSL certificates (regionSslCertificates) are used
+            # by:
+            #
+            #    - Regional external Application Load Balancers
+            #    - Regional internal Application Load Balancers
+            #
+            #
+            #
+            # Optionally, certificate file contents that you upload can contain a set of up
+            # to five PEM-encoded certificates.
+            # The API call creates an object (sslCertificate) that holds this data.
+            # You can use SSL keys and certificates to secure connections to a load
+            # balancer.
+            # For more information, read
+            # Creating and using SSL certificates,SSL certificates
+            # quotas and limits, and
+            # Troubleshooting SSL certificates.
+          "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+              # be in PEM format. The certificate chain must be no greater than 5 certs
+              # long. The chain must include at least one intermediate cert.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+          "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+            "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+                # certificate resource.
+              "a_key": "A String",
+            },
+            "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+                # Google-managed SSL certificate supports up to the [maximum number of
+                # domains per Google-managed SSL
+                # certificate](/load-balancing/docs/quotas#ssl_certificates).
+              "A String",
+            ],
+            "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+          },
+          "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.
+          "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+              # key file must be in PEM format. For security, only insert
+              # requests include this field.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+              # resides. This field is not applicable to global SSL Certificate.
+          "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+          "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+            "certificate": "A String", # A local certificate file. The certificate must be in
+                # PEM format. The certificate chain must be no greater than 5 certs
+                # long. The chain must include at least one intermediate cert.
+            "privateKey": "A String", # A write-only private key in PEM format. Only insert
+                # requests will include this field.
+          },
+          "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+              # Alternative Name.
+            "A String",
+          ],
+          "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+              # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#sslCertificateAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL
+      # Certificates.
+  "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, sslCertificate, requestId=None, x__xgafv=None) + 
Deletes the specified SslCertificate resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  sslCertificate: string, Name of the SslCertificate 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, sslCertificate, x__xgafv=None) + 
Returns the specified SslCertificate resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  sslCertificate: string, Name of the SslCertificate 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 an SSL certificate resource.
+    #
+    # Google Compute Engine has two SSL certificate resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+    #
+    #
+    # The global SSL certificates (sslCertificates) are used by:
+    #
+    #    - Global external Application Load Balancers
+    #    - Classic Application Load Balancers
+    #    - Proxy Network Load Balancers (with target SSL proxies)
+    #
+    #
+    #
+    # The regional SSL certificates (regionSslCertificates) are used
+    # by:
+    #
+    #    - Regional external Application Load Balancers
+    #    - Regional internal Application Load Balancers
+    #
+    #
+    #
+    # Optionally, certificate file contents that you upload can contain a set of up
+    # to five PEM-encoded certificates.
+    # The API call creates an object (sslCertificate) that holds this data.
+    # You can use SSL keys and certificates to secure connections to a load
+    # balancer.
+    # For more information, read
+    # Creating and using SSL certificates,SSL certificates
+    # quotas and limits, and
+    # Troubleshooting SSL certificates.
+  "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+      # be in PEM format. The certificate chain must be no greater than 5 certs
+      # long. The chain must include at least one intermediate cert.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+  "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+    "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+        # certificate resource.
+      "a_key": "A String",
+    },
+    "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+        # Google-managed SSL certificate supports up to the [maximum number of
+        # domains per Google-managed SSL
+        # certificate](/load-balancing/docs/quotas#ssl_certificates).
+      "A String",
+    ],
+    "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+  },
+  "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.
+  "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+      # key file must be in PEM format. For security, only insert
+      # requests include this field.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+      # resides. This field is not applicable to global SSL Certificate.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+    "certificate": "A String", # A local certificate file. The certificate must be in
+        # PEM format. The certificate chain must be no greater than 5 certs
+        # long. The chain must include at least one intermediate cert.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert
+        # requests will include this field.
+  },
+  "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+      # Alternative Name.
+    "A String",
+  ],
+  "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+      # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a SslCertificate resource 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 an SSL certificate resource.
+    # 
+    # Google Compute Engine has two SSL certificate resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+    # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+    # 
+    # 
+    # The global SSL certificates (sslCertificates) are used by:
+    # 
+    #    - Global external Application Load Balancers
+    #    - Classic Application Load Balancers
+    #    - Proxy Network Load Balancers (with target SSL proxies)
+    # 
+    # 
+    # 
+    # The regional SSL certificates (regionSslCertificates) are used
+    # by:
+    # 
+    #    - Regional external Application Load Balancers
+    #    - Regional internal Application Load Balancers
+    # 
+    # 
+    # 
+    # Optionally, certificate file contents that you upload can contain a set of up
+    # to five PEM-encoded certificates.
+    # The API call creates an object (sslCertificate) that holds this data.
+    # You can use SSL keys and certificates to secure connections to a load
+    # balancer.
+    # For more information, read
+    # Creating and using SSL certificates,SSL certificates
+    # quotas and limits, and
+    # Troubleshooting SSL certificates.
+  "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+      # be in PEM format. The certificate chain must be no greater than 5 certs
+      # long. The chain must include at least one intermediate cert.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+  "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+    "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+        # certificate resource.
+      "a_key": "A String",
+    },
+    "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+        # Google-managed SSL certificate supports up to the [maximum number of
+        # domains per Google-managed SSL
+        # certificate](/load-balancing/docs/quotas#ssl_certificates).
+      "A String",
+    ],
+    "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+  },
+  "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.
+  "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+      # key file must be in PEM format. For security, only insert
+      # requests include this field.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+      # resides. This field is not applicable to global SSL Certificate.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+    "certificate": "A String", # A local certificate file. The certificate must be in
+        # PEM format. The certificate chain must be no greater than 5 certs
+        # long. The chain must include at least one intermediate cert.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert
+        # requests will include this field.
+  },
+  "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+      # Alternative Name.
+    "A String",
+  ],
+  "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+      # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of SslCertificate resources available to 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.
+  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 SslCertificate resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of SslCertificate resources.
+    { # Represents an SSL certificate resource.
+        #
+        # Google Compute Engine has two SSL certificate resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/sslCertificates)
+        # * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)
+        #
+        #
+        # The global SSL certificates (sslCertificates) are used by:
+        #
+        #    - Global external Application Load Balancers
+        #    - Classic Application Load Balancers
+        #    - Proxy Network Load Balancers (with target SSL proxies)
+        #
+        #
+        #
+        # The regional SSL certificates (regionSslCertificates) are used
+        # by:
+        #
+        #    - Regional external Application Load Balancers
+        #    - Regional internal Application Load Balancers
+        #
+        #
+        #
+        # Optionally, certificate file contents that you upload can contain a set of up
+        # to five PEM-encoded certificates.
+        # The API call creates an object (sslCertificate) that holds this data.
+        # You can use SSL keys and certificates to secure connections to a load
+        # balancer.
+        # For more information, read
+        # Creating and using SSL certificates,SSL certificates
+        # quotas and limits, and
+        # Troubleshooting SSL certificates.
+      "certificate": "A String", # A value read into memory from a certificate file. The certificate file must
+          # be in PEM format. The certificate chain must be no greater than 5 certs
+          # long. The chain must include at least one intermediate cert.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "expireTime": "A String", # Output only. [Output Only] Expire time of the certificate. RFC3339
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#sslCertificate", # Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.
+      "managed": { # Configuration and status of a managed SSL certificate. # Configuration and status of a managed SSL certificate.
+        "domainStatus": { # Output only. [Output only] Detailed statuses of the domains specified for managed
+            # certificate resource.
+          "a_key": "A String",
+        },
+        "domains": [ # The domains for which a managed SSL certificate will be generated. Each
+            # Google-managed SSL certificate supports up to the [maximum number of
+            # domains per Google-managed SSL
+            # certificate](/load-balancing/docs/quotas#ssl_certificates).
+          "A String",
+        ],
+        "status": "A String", # Output only. [Output only] Status of the managed certificate resource.
+      },
+      "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.
+      "privateKey": "A String", # A value read into memory from a write-only private key file. The private
+          # key file must be in PEM format. For security, only insert
+          # requests include this field.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL Certificate
+          # resides. This field is not applicable to global SSL Certificate.
+      "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+      "selfManaged": { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
+        "certificate": "A String", # A local certificate file. The certificate must be in
+            # PEM format. The certificate chain must be no greater than 5 certs
+            # long. The chain must include at least one intermediate cert.
+        "privateKey": "A String", # A write-only private key in PEM format. Only insert
+            # requests will include this field.
+      },
+      "subjectAlternativeNames": [ # Output only. [Output Only] Domains associated with the certificate via Subject
+          # Alternative Name.
+        "A String",
+      ],
+      "type": "A String", # (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or
+          # "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.
+    },
+  ],
+  "kind": "compute#sslCertificateList", # 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.sslPolicies.html b/docs/dyn/compute_preview.sslPolicies.html new file mode 100644 index 0000000000..540ee4c3cb --- /dev/null +++ b/docs/dyn/compute_preview.sslPolicies.html @@ -0,0 +1,1896 @@ + + + +

Compute Engine API . sslPolicies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all SslPolicy resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, sslPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified SSL policy. The SSL policy resource can be deleted

+

+ get(project, sslPolicy, x__xgafv=None)

+

Lists all of the ordered rules present in a single specified policy.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Returns the specified SSL policy resource.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all the SSL policies that have been configured for the specified

+

+ listAvailableFeatures(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all features that can be specified in the SSL policy when using

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, sslPolicy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified SSL policy with the data included in the request.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all SslPolicy resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of SslPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of SSL policies.
+      "sslPolicies": [ # A list of SslPolicies contained in this scope.
+        { # Represents an SSL Policy resource.
+            #
+            # Use SSL policies to control SSL features, such as versions and cipher
+            # suites, that are offered by Application Load Balancers and proxy Network Load
+            # Balancers. For more information, read
+            # SSL policies overview.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+              #  method returns the set of features that can be
+              # specified in this list. This field must be empty if the profile is notCUSTOM.
+            "A String",
+          ],
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+            "A String",
+          ],
+          "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 SslPolicy. An up-to-date fingerprint must be
+              # provided in order to update the SslPolicy, otherwise the
+              # request will fail with error 412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve an SslPolicy.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+          "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+              # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+              # must be set to RESTRICTED.
+          "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+              # with RFC1035. 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.
+          "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+              # X25519MLKEM768 key exchange when clients advertise support for it. When set
+              # to DEFAULT, or if no SSL Policy is attached to the target
+              # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+              # October 2026, and allows it afterward. When set to ENABLED,
+              # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+              # exchange until October 2027, and allows it afterward.
+          "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+              # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+              # the customFeatures field. If using FIPS_202205,
+              # the min_tls_version field must be set to TLS_1_2.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+              # resides. This field is not applicable to global SSL policies.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+              # SSL policy, this field will be populated with warning messages.
+            {
+              "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.
+            },
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # SSL 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#sslPoliciesAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL 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. [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, sslPolicy, requestId=None, x__xgafv=None) + 
Deletes the specified SSL policy. The SSL policy resource can be deleted
+only if it is not in use by any TargetHttpsProxy or TargetSslProxy
+resources.
+
+Args:
+  project: string, Project ID for this request. (required)
+  sslPolicy: string, Name of the SSL policy to delete. The name must be 1-63 characters long,
+and comply with RFC1035. (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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, sslPolicy, x__xgafv=None) + 
Lists all of the ordered rules present in a single specified policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  sslPolicy: string, Name of the SSL policy to update. The name must be 1-63 characters long,
+and comply with RFC1035. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an SSL Policy resource.
+    #
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Returns the specified SSL policy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents an SSL Policy resource.
+    # 
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists all the SSL policies that have been configured for 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.
+  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. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # Output only. A list of SslPolicy resources.
+    { # Represents an SSL Policy resource.
+        #
+        # Use SSL policies to control SSL features, such as versions and cipher
+        # suites, that are offered by Application Load Balancers and proxy Network Load
+        # Balancers. For more information, read
+        # SSL policies overview.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+          #  method returns the set of features that can be
+          # specified in this list. This field must be empty if the profile is notCUSTOM.
+        "A String",
+      ],
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+        "A String",
+      ],
+      "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 SslPolicy. An up-to-date fingerprint must be
+          # provided in order to update the SslPolicy, otherwise the
+          # request will fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve an SslPolicy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+      "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+          # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+          # must be set to RESTRICTED.
+      "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+          # with RFC1035. 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.
+      "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+          # X25519MLKEM768 key exchange when clients advertise support for it. When set
+          # to DEFAULT, or if no SSL Policy is attached to the target
+          # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+          # October 2026, and allows it afterward. When set to ENABLED,
+          # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+          # exchange until October 2027, and allows it afterward.
+      "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+          # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+          # the customFeatures field. If using FIPS_202205,
+          # the min_tls_version field must be set to TLS_1_2.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+          # resides. This field is not applicable to global SSL policies.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+          # SSL policy, this field will be populated with warning messages.
+        {
+          "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#sslPoliciesList", # Output only. [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies.
+  "nextPageToken": "A String", # Output only. [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.
+  "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.
+  },
+}
+
+ +
+ listAvailableFeatures(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all features that can be specified in the SSL policy when using
+custom profile.
+
+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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "features": [
+    "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.
+
+
+ +
+ patch(project, sslPolicy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified SSL policy with the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  sslPolicy: string, Name of the SSL policy 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 an SSL Policy resource.
+    # 
+    # Use SSL policies to control SSL features, such as versions and cipher
+    # suites, that are offered by Application Load Balancers and proxy Network Load
+    # Balancers. For more information, read
+    # SSL policies overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "customFeatures": [ # A list of features enabled when the selected profile is CUSTOM. The
+      #  method returns the set of features that can be
+      # specified in this list. This field must be empty if the profile is notCUSTOM.
+    "A String",
+  ],
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "enabledFeatures": [ # Output only. [Output Only] The list of features enabled in the SSL policy.
+    "A String",
+  ],
+  "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 SslPolicy. An up-to-date fingerprint must be
+      # provided in order to update the SslPolicy, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve an SslPolicy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#sslPolicy", # Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.
+  "minTlsVersion": "A String", # The minimum version of SSL protocol that can be used by the clients to
+      # establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field
+      # must be set to RESTRICTED.
+  "name": "A String", # Name of the resource. The name must be 1-63 characters long, and comply
+      # with RFC1035. 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.
+  "postQuantumKeyExchange": "A String", # One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates
+      # X25519MLKEM768 key exchange when clients advertise support for it. When set
+      # to DEFAULT, or if no SSL Policy is attached to the target
+      # proxy, the load balancer disallows X25519MLKEM768 key exchange before
+      # October 2026, and allows it afterward. When set to ENABLED,
+      # the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key
+      # exchange until October 2027, and allows it afterward.
+  "profile": "A String", # Profile specifies the set of SSL features that can be used by the load
+      # balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in
+      # the customFeatures field. If using FIPS_202205,
+      # the min_tls_version field must be set to TLS_1_2.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional SSL policy
+      # resides. This field is not applicable to global SSL policies.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "warnings": [ # Output only. [Output Only] If potential misconfigurations are detected for this
+      # SSL policy, this field will be populated with warning messages.
+    {
+      "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.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.storagePoolTypes.html b/docs/dyn/compute_preview.storagePoolTypes.html new file mode 100644 index 0000000000..e0b7024174 --- /dev/null +++ b/docs/dyn/compute_preview.storagePoolTypes.html @@ -0,0 +1,592 @@ + + + +

Compute Engine API . storagePoolTypes

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of storage pool types.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, storagePoolType, x__xgafv=None)

+

Returns the specified storage pool type.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of storage pool types available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of storage pool types.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of StoragePoolTypesScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of storage pool types.
+      "storagePoolTypes": [ # [Output Only] A list of storage pool types contained in this scope.
+        {
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this storage pool
+              # type.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DELETED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to DEPRECATED. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+                # resource is intended to change to OBSOLETE. This is only
+                # informational and the status will not change unless the client explicitly
+                # changes it.
+            "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+                # The suggested replacement resource must be the same kind of resource as the
+                # deprecated resource.
+            "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+                # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+                # warning indicating the deprecated resource and recommending its
+                # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+          },
+          "description": "A String", # [Output Only] An optional description of this resource.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#storagePoolType", # Output only. [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types.
+          "maxPoolProvisionedCapacityGb": "A String", # [Output Only] Maximum storage pool size in GB.
+          "maxPoolProvisionedIops": "A String", # [Output Only] Maximum provisioned IOPS.
+          "maxPoolProvisionedThroughput": "A String", # [Output Only] Maximum provisioned throughput.
+          "minPoolProvisionedCapacityGb": "A String", # [Output Only] Minimum storage pool size in GB.
+          "minPoolProvisionedIops": "A String", # [Output Only] Minimum provisioned IOPS.
+          "minPoolProvisionedThroughput": "A String", # [Output Only] Minimum provisioned throughput.
+          "minSizeGb": "A String", # [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb
+              # instead.
+          "name": "A String", # [Output Only] Name of the resource.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+          "supportedDiskTypes": [ # [Output Only] The list of disk types supported in this storage pool type.
+            "A String",
+          ],
+          "zone": "A String", # [Output Only] URL of the zone where the storage pool type resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of storage pool
+          # types 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#storagePoolTypeAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList.
+  "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.
+  "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.
+
+ +
+ get(project, zone, storagePoolType, x__xgafv=None) + 
Returns the specified storage pool type.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  storagePoolType: string, Name of the storage pool type 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:
+
+    {
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this storage pool
+      # type.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] An optional description of this resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#storagePoolType", # Output only. [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types.
+  "maxPoolProvisionedCapacityGb": "A String", # [Output Only] Maximum storage pool size in GB.
+  "maxPoolProvisionedIops": "A String", # [Output Only] Maximum provisioned IOPS.
+  "maxPoolProvisionedThroughput": "A String", # [Output Only] Maximum provisioned throughput.
+  "minPoolProvisionedCapacityGb": "A String", # [Output Only] Minimum storage pool size in GB.
+  "minPoolProvisionedIops": "A String", # [Output Only] Minimum provisioned IOPS.
+  "minPoolProvisionedThroughput": "A String", # [Output Only] Minimum provisioned throughput.
+  "minSizeGb": "A String", # [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb
+      # instead.
+  "name": "A String", # [Output Only] Name of the resource.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+  "supportedDiskTypes": [ # [Output Only] The list of disk types supported in this storage pool type.
+    "A String",
+  ],
+  "zone": "A String", # [Output Only] URL of the zone where the storage pool type resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of storage pool types available to the specified
+project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  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 storage pool types.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of StoragePoolType resources.
+    {
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this storage pool
+          # type.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] An optional description of this resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#storagePoolType", # Output only. [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types.
+      "maxPoolProvisionedCapacityGb": "A String", # [Output Only] Maximum storage pool size in GB.
+      "maxPoolProvisionedIops": "A String", # [Output Only] Maximum provisioned IOPS.
+      "maxPoolProvisionedThroughput": "A String", # [Output Only] Maximum provisioned throughput.
+      "minPoolProvisionedCapacityGb": "A String", # [Output Only] Minimum storage pool size in GB.
+      "minPoolProvisionedIops": "A String", # [Output Only] Minimum provisioned IOPS.
+      "minPoolProvisionedThroughput": "A String", # [Output Only] Minimum provisioned throughput.
+      "minSizeGb": "A String", # [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb
+          # instead.
+      "name": "A String", # [Output Only] Name of the resource.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id.
+      "supportedDiskTypes": [ # [Output Only] The list of disk types supported in this storage pool type.
+        "A String",
+      ],
+      "zone": "A String", # [Output Only] URL of the zone where the storage pool type resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#storagePoolTypeList", # Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types.
+  "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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.storagePools.html b/docs/dyn/compute_preview.storagePools.html new file mode 100644 index 0000000000..c8c3015a62 --- /dev/null +++ b/docs/dyn/compute_preview.storagePools.html @@ -0,0 +1,3535 @@ + + + +

Compute Engine API . storagePools

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of storage pools.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, storagePool, requestId=None, x__xgafv=None)

+

Deletes the specified storage pool. Deleting a storagePool

+

+ get(project, zone, storagePool, x__xgafv=None)

+

Returns a specified storage pool. Gets a list of available

+

+ getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a storage pool in the specified project using the data

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of storage pools contained within

+

+ listDisks(project, zone, storagePool, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the disks in a specified storage pool.

+

+ listDisks_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, zone, storagePool, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates the specified storagePool with the data included in the request.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of storage pools.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of StoragePoolsScopedList resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of storage pool.
+      "storagePools": [ # [Output Only] A list of storage pool contained in this scope.
+        { # Represents a zonal storage pool resource.
+          "capacityProvisioningType": "A String", # Provisioning type of the byte capacity of the pool.
+          "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.
+          "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Provisioned capacities for each SKU for this Exapool in GiB
+            "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+            "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+            "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+          },
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#storagePool", # Output only. [Output Only] Type of the resource. Always compute#storagePool
+              # for storage pools.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this storage pool, which is
+              # essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a storage pool.
+          "labels": { # Labels to apply to this storage pool. These can be later modified by
+              # the setLabels method.
+            "a_key": "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.
+          "params": { # Additional storage pool 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 storage pool. 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",
+            },
+          },
+          "performanceProvisioningType": "A String", # Provisioning type of the performance-related parameters of the pool,
+              # such as throughput and IOPS.
+          "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. For more information about the size
+              # limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
+          "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+              # type is hyperdisk-balanced.
+          "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if the
+              # storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+          "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+            "diskCount": "A String", # [Output Only] Number of disks used.
+            "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+            "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+                # this Exapool.
+            "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+            "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+                # for this Exapool.
+            "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+            "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+            "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+                # (in bytes). This will reflect the total number of bytes written to the
+                # disks in the pool, in contrast to the capacity of those disks.
+            "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+                # that is allowed per disk that is not counted towards pool's IOPS
+                # capacity. For more information, see
+                # https://cloud.google.com/compute/docs/disks/storage-pools.
+            "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+            "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+                # compacted.
+            "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+                # this storage pool. A disk's provisioned capacity is the same as its total
+                # capacity.
+            "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+            "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+                # minus some amount that is allowed per disk that is not counted towards
+                # pool's throughput capacity.
+          },
+          "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.
+          "shareSettings": { # Share settings for the storage pool. # Share settings for the storage pool.
+            "projectMap": { # A map of project id and project config.
+              "a_key": { # Config for each project in the share settings.
+                "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                    # parent map.
+              },
+            },
+          },
+          "state": "A String", # Output only. [Output Only] The status of storage pool creation.
+              #
+              #
+              #      - CREATING: Storage pool is provisioning.
+              #      storagePool.
+              #      - FAILED: Storage pool creation failed.
+              #      - READY: Storage pool is ready for use.
+              #      - DELETING: Storage pool is deleting.
+          "status": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+            "diskCount": "A String", # [Output Only] Number of disks used.
+            "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+            "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+                # this Exapool.
+            "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+            "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+                # for this Exapool.
+            "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+            "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+            "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+                # (in bytes). This will reflect the total number of bytes written to the
+                # disks in the pool, in contrast to the capacity of those disks.
+            "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+                # that is allowed per disk that is not counted towards pool's IOPS
+                # capacity. For more information, see
+                # https://cloud.google.com/compute/docs/disks/storage-pools.
+            "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+            "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+                # compacted.
+            "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+                # this storage pool. A disk's provisioned capacity is the same as its total
+                # capacity.
+            "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+            "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+                # minus some amount that is allowed per disk that is not counted towards
+                # pool's throughput capacity.
+          },
+          "storagePoolType": "A String", # Type of the storage pool.
+          "zone": "A String", # Output only. [Output Only] URL of the zone where the storage pool resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of storage pool
+          # 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#storagePoolAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of
+      # storage pools.
+  "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, zone, storagePool, requestId=None, x__xgafv=None) + 
Deletes the specified storage pool. Deleting a storagePool
+removes its data permanently and is irreversible. However, deleting a
+storagePool does not delete any snapshots previously
+made from the storagePool. You must separately delete
+snapshots.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  storagePool: string, Name of the storage pool 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, storagePool, x__xgafv=None) + 
Returns a specified storage pool. Gets a list of available
+storage pools by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  storagePool: string, Name of the storage pool 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 zonal storage pool resource.
+  "capacityProvisioningType": "A String", # Provisioning type of the byte capacity of the pool.
+  "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.
+  "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Provisioned capacities for each SKU for this Exapool in GiB
+    "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+    "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+    "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#storagePool", # Output only. [Output Only] Type of the resource. Always compute#storagePool
+      # for storage pools.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this storage pool, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a storage pool.
+  "labels": { # Labels to apply to this storage pool. These can be later modified by
+      # the setLabels method.
+    "a_key": "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.
+  "params": { # Additional storage pool 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 storage pool. 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",
+    },
+  },
+  "performanceProvisioningType": "A String", # Provisioning type of the performance-related parameters of the pool,
+      # such as throughput and IOPS.
+  "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. For more information about the size
+      # limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
+  "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+      # type is hyperdisk-balanced.
+  "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if the
+      # storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "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.
+  "shareSettings": { # Share settings for the storage pool. # Share settings for the storage pool.
+    "projectMap": { # A map of project id and project config.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+  },
+  "state": "A String", # Output only. [Output Only] The status of storage pool creation.
+      #
+      #
+      #      - CREATING: Storage pool is provisioning.
+      #      storagePool.
+      #      - FAILED: Storage pool creation failed.
+      #      - READY: Storage pool is ready for use.
+      #      - DELETING: Storage pool is deleting.
+  "status": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "storagePoolType": "A String", # Type of the storage pool.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the storage pool resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ getIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a storage pool in the specified project using the data
+in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a zonal storage pool resource.
+  "capacityProvisioningType": "A String", # Provisioning type of the byte capacity of the pool.
+  "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.
+  "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Provisioned capacities for each SKU for this Exapool in GiB
+    "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+    "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+    "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#storagePool", # Output only. [Output Only] Type of the resource. Always compute#storagePool
+      # for storage pools.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this storage pool, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a storage pool.
+  "labels": { # Labels to apply to this storage pool. These can be later modified by
+      # the setLabels method.
+    "a_key": "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.
+  "params": { # Additional storage pool 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 storage pool. 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",
+    },
+  },
+  "performanceProvisioningType": "A String", # Provisioning type of the performance-related parameters of the pool,
+      # such as throughput and IOPS.
+  "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. For more information about the size
+      # limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
+  "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+      # type is hyperdisk-balanced.
+  "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if the
+      # storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "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.
+  "shareSettings": { # Share settings for the storage pool. # Share settings for the storage pool.
+    "projectMap": { # A map of project id and project config.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+  },
+  "state": "A String", # Output only. [Output Only] The status of storage pool creation.
+      # 
+      # 
+      #      - CREATING: Storage pool is provisioning.
+      #      storagePool.
+      #      - FAILED: Storage pool creation failed.
+      #      - READY: Storage pool is ready for use.
+      #      - DELETING: Storage pool is deleting.
+  "status": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "storagePoolType": "A String", # Type of the storage pool.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the storage pool resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of storage pools contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of StoragePool resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of StoragePool resources.
+    { # Represents a zonal storage pool resource.
+      "capacityProvisioningType": "A String", # Provisioning type of the byte capacity of the pool.
+      "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.
+      "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Provisioned capacities for each SKU for this Exapool in GiB
+        "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+        "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+        "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#storagePool", # Output only. [Output Only] Type of the resource. Always compute#storagePool
+          # for storage pools.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this storage pool, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a storage pool.
+      "labels": { # Labels to apply to this storage pool. These can be later modified by
+          # the setLabels method.
+        "a_key": "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.
+      "params": { # Additional storage pool 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 storage pool. 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",
+        },
+      },
+      "performanceProvisioningType": "A String", # Provisioning type of the performance-related parameters of the pool,
+          # such as throughput and IOPS.
+      "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. For more information about the size
+          # limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
+      "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+          # type is hyperdisk-balanced.
+      "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if the
+          # storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+      "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+        "diskCount": "A String", # [Output Only] Number of disks used.
+        "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+        "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+            # this Exapool.
+        "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+        "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+            # for this Exapool.
+        "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+        "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+        "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+            # (in bytes). This will reflect the total number of bytes written to the
+            # disks in the pool, in contrast to the capacity of those disks.
+        "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+            # that is allowed per disk that is not counted towards pool's IOPS
+            # capacity. For more information, see
+            # https://cloud.google.com/compute/docs/disks/storage-pools.
+        "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+        "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+            # compacted.
+        "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+            # this storage pool. A disk's provisioned capacity is the same as its total
+            # capacity.
+        "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+        "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+            # minus some amount that is allowed per disk that is not counted towards
+            # pool's throughput capacity.
+      },
+      "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.
+      "shareSettings": { # Share settings for the storage pool. # Share settings for the storage pool.
+        "projectMap": { # A map of project id and project config.
+          "a_key": { # Config for each project in the share settings.
+            "projectId": "A String", # The project ID, should be same as the key of this project config in the
+                # parent map.
+          },
+        },
+      },
+      "state": "A String", # Output only. [Output Only] The status of storage pool creation.
+          #
+          #
+          #      - CREATING: Storage pool is provisioning.
+          #      storagePool.
+          #      - FAILED: Storage pool creation failed.
+          #      - READY: Storage pool is ready for use.
+          #      - DELETING: Storage pool is deleting.
+      "status": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+        "diskCount": "A String", # [Output Only] Number of disks used.
+        "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+        "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+            # this Exapool.
+        "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+        "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+            # for this Exapool.
+        "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+        "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+        "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+            # (in bytes). This will reflect the total number of bytes written to the
+            # disks in the pool, in contrast to the capacity of those disks.
+        "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+            # that is allowed per disk that is not counted towards pool's IOPS
+            # capacity. For more information, see
+            # https://cloud.google.com/compute/docs/disks/storage-pools.
+        "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+        "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+            # compacted.
+        "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+            # this storage pool. A disk's provisioned capacity is the same as its total
+            # capacity.
+        "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+        "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+            # minus some amount that is allowed per disk that is not counted towards
+            # pool's throughput capacity.
+      },
+      "storagePoolType": "A String", # Type of the storage pool.
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the storage pool resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#storagePoolList", # Output only. [Output Only] Type of resource. Always compute#storagePoolList
+      # for lists of storagePools.
+  "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.
+  },
+}
+
+ +
+ listDisks(project, zone, storagePool, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the disks in a specified storage pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  storagePool: string, Name of the storage pool to list disks of. (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # Output only. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of StoragePoolDisk resources.
+    {
+      "attachedInstances": [ # Output only. [Output Only] Instances this disk is attached to.
+        "A String",
+      ],
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "disk": "A String", # Output only. [Output Only] The URL of the disk.
+      "name": "A String", # Output only. [Output Only] The name of the disk.
+      "provisionedIops": "A String", # Output only. [Output Only] The number of IOPS provisioned for the disk.
+      "provisionedThroughput": "A String", # Output only. [Output Only] The throughput provisioned for the disk.
+      "resourcePolicies": [ # Output only. [Output Only] Resource policies applied to disk for automatic snapshot
+          # creations.
+        "A String",
+      ],
+      "sizeGb": "A String", # Output only. [Output Only] The disk size, in GB.
+      "status": "A String", # Output only. [Output Only] The disk status.
+      "type": "A String", # Output only. [Output Only] The disk type.
+      "usedBytes": "A String", # Output only. [Output Only] Amount of disk space used.
+    },
+  ],
+  "kind": "compute#storagePoolListDisks", # Output only. [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a
+      # storagePool.
+  "nextPageToken": "A String", # Output only. [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. [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.
+  },
+}
+
+ +
+ listDisks_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.
+
+
+ +
+ setIamPolicy(project, zone, 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)
+  zone: string, The name of the zone 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 backwacd 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, zone, 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)
+  zone: string, The name of the zone 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, zone, storagePool, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the specified storagePool 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:
+pool_provisioned_capacity_gb, pool_provisioned_iops and
+pool_provisioned_throughput.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  storagePool: string, The storagePool name for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a zonal storage pool resource.
+  "capacityProvisioningType": "A String", # Provisioning type of the byte capacity of the pool.
+  "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.
+  "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Provisioned capacities for each SKU for this Exapool in GiB
+    "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool
+    "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool
+    "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#storagePool", # Output only. [Output Only] Type of the resource. Always compute#storagePool
+      # for storage pools.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this storage pool, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a storage pool.
+  "labels": { # Labels to apply to this storage pool. These can be later modified by
+      # the setLabels method.
+    "a_key": "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.
+  "params": { # Additional storage pool 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 storage pool. 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",
+    },
+  },
+  "performanceProvisioningType": "A String", # Provisioning type of the performance-related parameters of the pool,
+      # such as throughput and IOPS.
+  "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. For more information about the size
+      # limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
+  "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool
+      # type is hyperdisk-balanced.
+  "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if the
+      # storage pool type is hyperdisk-balanced or hyperdisk-throughput.
+  "resourceStatus": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "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.
+  "shareSettings": { # Share settings for the storage pool. # Share settings for the storage pool.
+    "projectMap": { # A map of project id and project config.
+      "a_key": { # Config for each project in the share settings.
+        "projectId": "A String", # The project ID, should be same as the key of this project config in the
+            # parent map.
+      },
+    },
+  },
+  "state": "A String", # Output only. [Output Only] The status of storage pool creation.
+      # 
+      # 
+      #      - CREATING: Storage pool is provisioning.
+      #      storagePool.
+      #      - FAILED: Storage pool creation failed.
+      #      - READY: Storage pool is ready for use.
+      #      - DELETING: Storage pool is deleting.
+  "status": { # [Output Only] Contains output only fields. # Output only. [Output Only] Status information for the storage pool resource.
+    "diskCount": "A String", # [Output Only] Number of disks used.
+    "exapoolMaxReadIops": "A String", # Output only. [Output Only] Maximum allowed read IOPS for this Exapool.
+    "exapoolMaxReadThroughput": "A String", # Output only. [Output Only] Maximum allowed read throughput in MiB/s for
+        # this Exapool.
+    "exapoolMaxWriteIops": "A String", # Output only. [Output Only] Maximum allowed write IOPS for this Exapool.
+    "exapoolMaxWriteThroughput": "A String", # Output only. [Output Only] Maximum allowed write throughput in MiB/s
+        # for this Exapool.
+    "lastResizeTimestamp": "A String", # Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.
+    "maxTotalProvisionedDiskCapacityGb": "A String", # [Output Only] Maximum allowed aggregate disk size in GiB.
+    "poolUsedCapacityBytes": "A String", # [Output Only] Space used by data stored in disks within the storage pool
+        # (in bytes). This will reflect the total number of bytes written to the
+        # disks in the pool, in contrast to the capacity of those disks.
+    "poolUsedIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS, minus some amount
+        # that is allowed per disk that is not counted towards pool's IOPS
+        # capacity. For more information, see
+        # https://cloud.google.com/compute/docs/disks/storage-pools.
+    "poolUsedThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s.
+    "poolUserWrittenBytes": "A String", # [Output Only] Amount of data written into the pool, before it is
+        # compacted.
+    "totalProvisionedDiskCapacityGb": "A String", # [Output Only] Sum of all the disks' provisioned capacity (in GiB) in
+        # this storage pool. A disk's provisioned capacity is the same as its total
+        # capacity.
+    "totalProvisionedDiskIops": "A String", # [Output Only] Sum of all the disks' provisioned IOPS.
+    "totalProvisionedDiskThroughput": "A String", # [Output Only] Sum of all the disks' provisioned throughput in MiB/s,
+        # minus some amount that is allowed per disk that is not counted towards
+        # pool's throughput capacity.
+  },
+  "storagePoolType": "A String", # Type of the storage pool.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the storage pool resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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).
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.subnetworks.html b/docs/dyn/compute_preview.subnetworks.html new file mode 100644 index 0000000000..f2c26fde46 --- /dev/null +++ b/docs/dyn/compute_preview.subnetworks.html @@ -0,0 +1,4871 @@ + + + +

Compute Engine API . subnetworks

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, views=None, x__xgafv=None)

+

Retrieves an aggregated list of subnetworks.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, subnetwork, requestId=None, x__xgafv=None)

+

Deletes the specified subnetwork.

+

+ expandIpCidrRange(project, region, subnetwork, body=None, requestId=None, x__xgafv=None)

+

Expands the IP CIDR range of the subnetwork to a specified value.

+

+ get(project, region, subnetwork, views=None, x__xgafv=None)

+

Returns the specified subnetwork.

+

+ getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a subnetwork in the specified project using the data

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, views=None, x__xgafv=None)

+

Retrieves a list of subnetworks available to the specified

+

+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, serviceProject=None, x__xgafv=None)

+

Retrieves an aggregated list of all usable subnetworks in the project.

+

+ listUsable_next()

+

Retrieves the next page of results.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, subnetwork, body=None, drainTimeoutSeconds=None, requestId=None, x__xgafv=None)

+

Patches the specified subnetwork with the data included in the request.

+

+ setIamPolicy(project, region, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ setPrivateIpGoogleAccess(project, region, subnetwork, body=None, requestId=None, x__xgafv=None)

+

Set whether VMs in this subnet can access Google services without assigning

+

+ 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, serviceProjectNumber=None, views=None, x__xgafv=None) + 
Retrieves an aggregated list of subnetworks.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  serviceProjectNumber: string, The Shared VPC service project id or service project number for which
+aggregated list request is invoked for subnetworks list-usable api.
+  views: string, Defines the extra views returned back in the subnetwork resource.
+Supported values:
+   
+   - WITH_UTILIZATION: Utilization data is included in the
+   response. (repeated)
+    Allowed values
+      DEFAULT - 
+      WITH_UTILIZATION - Utilization data is included in the response.
+  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 SubnetworksScopedList resources.
+    "a_key": { # Name of the scope containing this set of Subnetworks.
+      "subnetworks": [ # A list of subnetworks contained in this scope.
+        { # Represents a Subnetwork resource.
+            #
+            # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+            # Private Cloud network with one primary IP range and zero or more secondary
+            # IP ranges. For more information, read
+            # Virtual Private Cloud (VPC) Network.
+          "allowSubnetCidrRoutesOverlap": True or False, # Whether this subnetwork's ranges can conflict with existing custom routes.
+              # Setting this to true allows this subnetwork's primary and secondary ranges
+              # to overlap with (and contain) custom routes that have already been
+              # configured on the corresponding network.
+              #
+              # For example if a static route has range 10.1.0.0/16, a subnet
+              # range 10.0.0.0/8 could only be created if allow_conflicting_routes=true.
+              #
+              # Overlapping is only allowed on subnetwork operations; routes
+              # whose ranges conflict with this subnetwork's ranges won't be allowed unless
+              # route.allow_conflicting_subnetworks is set to true.
+              #
+              # Typically packets destined to IPs within the subnetwork (which may contain
+              # private/sensitive data) are prevented from leaving the virtual network.
+              # Setting this field to true will disable this feature.
+              #
+              # The default value is false and applies to all existing subnetworks and
+              # automatically created subnetworks.
+          "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. This field can be set only at resource creation time.
+          "enableFlowLogs": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+              # explicitly set, it will not appear in get listings. If not set
+              # the default behavior is determined by the org policy, if there is no org
+              # policy specified, then it will default to disabled. This field isn't
+              # supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.
+          "externalIpv6Prefix": "A String", # The external IPv6 address range that is owned by this
+              # subnetwork.
+          "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 Subnetwork. An up-to-date fingerprint must be
+              # provided in order to update the Subnetwork, otherwise the
+              # request will fail with error 412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a Subnetwork.
+          "gatewayAddress": "A String", # Output only. [Output Only] The gateway address for default routes to reach destination
+              # addresses outside this subnetwork.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this
+              # subnetwork.
+          "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+              # Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must
+              # be unique and non-overlapping within a network. Only IPv4 is supported.
+              # This field is set at resource creation time. The range can be any range
+              # listed in theValid
+              # ranges list. The range can be expanded after creation usingexpandIpCidrRange.
+          "ipCollection": "A String", # Reference to the source of IP, like a PublicDelegatedPrefix
+              # (PDP) for BYOIP. The PDP must be a sub-PDP in
+              # EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
+              # mode.
+              #
+              # Use one of the following formats to specify a sub-PDP when creating a dual
+              # stack or IPv6-only subnetwork with external access using BYOIP:
+              #
+              #    -
+              #    Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+              #    -
+              #    Partial URL, as in
+              #
+              #
+              #           - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+              #           - regions/region/publicDelegatedPrefixes/sub-pdp-name
+          "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+              # only be specified during creation or the first time the subnet is updated
+              # into IPV4_IPV6 dual stack.
+          "ipv6CidrRange": "A String", # Output only. [Output Only] This field is for internal use.
+          "ipv6GceEndpoint": "A String", # Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the
+              # following:
+              #
+              #    - VM_ONLY: The subnetwork can be used for creating instances and
+              #    IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6
+              #    ranges from a public delegated prefix and cannot be used to create NetLb.
+              #    - VM_AND_FR: The subnetwork can be used for creating both VM
+              #    instances and Forwarding Rules. It can also be used to reserve IPv6
+              #    addresses with both VM and FR endpoint types. Such a subnetwork gets its
+              #    IPv6 range from Google IP Pool directly.
+          "kind": "compute#subnetwork", # Output only. [Output Only] Type of the resource. Always compute#subnetwork
+              # for Subnetwork resources.
+          "logConfig": { # The available logging options for this subnetwork. # This field denotes the VPC flow logging options for this subnetwork.
+              # If logging is enabled, logs are exported to Cloud Logging.
+            "aggregationInterval": "A String", # Can only be specified if VPC flow logging for this subnetwork is enabled.
+                # Toggles the aggregation interval for collecting flow logs. Increasing the
+                # interval time will reduce the amount of generated flow logs for long
+                # lasting connections. Default is an interval of 5 seconds per connection.
+            "enable": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+                # explicitly set, it will not appear in get listings. If not
+                # set the default behavior is determined by the org policy, if there is no
+                # org policy specified, then it will default to disabled.
+                # Flow logging isn't supported if the subnet purpose field is
+                # set to REGIONAL_MANAGED_PROXY.
+            "filterExpr": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+                # The filter expression is used to define which VPC flow logs should be
+                # exported to Cloud Logging.
+            "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled.
+                # The value of the field must be in [0, 1]. Set the sampling rate of VPC
+                # flow logs within the subnetwork where 1.0 means all collected logs are
+                # reported and 0.0 means no logs are reported. Default is 0.5 unless
+                # otherwise specified by the org policy, which means half of all collected
+                # logs are reported.
+            "metadata": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+                # Configures whether all, none or a subset of metadata fields should be
+                # added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.
+            "metadataFields": [ # Can only be specified if VPC flow logs for this subnetwork is enabled and
+                # "metadata" was set to CUSTOM_METADATA.
+              "A String",
+            ],
+          },
+          "name": "A String", # The name of the resource, provided by the client when initially creating
+              # the resource. 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.
+          "network": "A String", # The URL of the network to which this subnetwork belongs, provided by the
+              # client when initially creating the subnetwork. This field can be set only
+              # at resource creation time.
+          "params": { # Additional subnetwork 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.
+                # 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.
+              "a_key": "A String",
+            },
+          },
+          "privateIpGoogleAccess": True or False, # Whether the VMs in this subnet can access Google services without assigned
+              # external IP addresses. This field can be both set at resource creation
+              # time and updated using setPrivateIpGoogleAccess.
+          "privateIpv6GoogleAccess": "A String", # This field is for internal use.
+              #
+              # This field can be both set at resource creation time and updated usingpatch.
+          "purpose": "A String",
+          "region": "A String", # URL of the region where the Subnetwork resides. This
+              # field can be set only at resource creation time.
+          "reservedInternalRange": "A String", # The URL of the reserved internal range.
+          "resolveSubnetMask": "A String", # Configures subnet mask resolution for this subnetwork.
+          "role": "A String", # The role of subnetwork. Currently, this field is only used when
+              # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+              # subnetwork is one that is currently being used for Envoy-based load
+              # balancers in a region. A BACKUP subnetwork is one that is
+              # ready to be promoted to ACTIVE or is currently draining.
+              # This field can be updated with a patch request.
+          "secondaryIpRanges": [ # An array of configurations for secondary IP ranges for VM instances
+              # contained in this subnetwork. The primary IP of such VM must belong to the
+              # primary ipCidrRange of the subnetwork. The alias IPs may belong to either
+              # primary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.
+            { # Represents a secondary IP range of a subnetwork.
+              "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+                  # Provide this property when you create the subnetwork. Ranges must be
+                  # unique and non-overlapping with all primary and secondary IP ranges
+                  # within a network. Both IPv4 and IPv6 ranges are supported. For IPv4,
+                  # the range can be any range listed in theValid
+                  # ranges list.
+                  #
+                  # For IPv6:
+                  # The range must have a /64 prefix length.
+                  # The range must be omitted, for auto-allocation from Google-defined ULA
+                  # IPv6 range.
+                  # For BYOGUA internal IPv6 secondary range, the range may be specified
+                  # along with the `ipCollection` field.
+                  # If an `ipCollection` is specified, the requested ip_cidr_range must lie
+                  # within the range of the PDP referenced by the `ipCollection` field for
+                  # allocation.
+                  # If `ipCollection` field is specified, but ip_cidr_range is not,
+                  # the range is auto-allocated from the PDP referenced by the `ipCollection`
+                  # field.
+              "ipCollection": "A String", # Reference to a Public Delegated Prefix (PDP) for BYOIP.
+                  # This field should be specified for configuring BYOGUA internal IPv6
+                  # secondary range.
+                  # When specified along with the ip_cidr_range, the ip_cidr_range must lie
+                  # within the PDP referenced by the `ipCollection` field.
+                  # When specified without the ip_cidr_range, the range is auto-allocated
+                  # from the PDP referenced by the `ipCollection` field.
+              "ipVersion": "A String",
+              "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+                  # an alias IP/IPv6 range to a VM instance.
+                  # The name must be 1-63 characters long, and comply withRFC1035.
+                  # The name must be unique within the subnetwork.
+              "reservedInternalRange": "A String", # The URL of the reserved internal range. Only IPv4 is supported.
+            },
+          ],
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+              # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+              # IPv6 addresses. If not specified, IPV4_ONLY is used.
+              #
+              # This field can be both set at resource creation time and updated usingpatch.
+          "state": "A String", # Output only. [Output Only] The state of the subnetwork, which can be one of the
+              # following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the
+              # purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that
+              # connections to the load balancer are being drained. A subnetwork that is
+              # draining cannot be used or modified until it reaches a status ofREADY
+          "systemReservedExternalIpv6Ranges": [ # Output only. [Output Only] The array of external IPv6 network ranges reserved from
+              # the subnetwork's external IPv6 range for system use.
+            "A String",
+          ],
+          "systemReservedInternalIpv6Ranges": [ # Output only. [Output Only] The array of internal IPv6 network ranges reserved from
+              # the subnetwork's internal IPv6 range for system use.
+            "A String",
+          ],
+          "utilizationDetails": { # The current IP utilization of all subnetwork ranges. Contains the total # Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains
+              # the total number of allocated and free IPs in each range.
+              # number of allocated and free IPs in each range.
+            "externalIpv6InstanceUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range.
+              "totalAllocatedIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+              "totalFreeIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+            },
+            "externalIpv6LbUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range for NetLB.
+              "totalAllocatedIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+              "totalFreeIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+            },
+            "internalIpv6Utilization": { # The IPV6 utilization of a single IP range. # Utilizations of internal IPV6 IP range.
+              "totalAllocatedIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+              "totalFreeIp": {
+                "high": "A String",
+                "low": "A String",
+              },
+            },
+            "ipv4Utilizations": [ # Utilizations of all IPV4 IP ranges. For primary ranges, the range name
+                # will be empty.
+              { # The IPV4 utilization of a single IP range.
+                "rangeName": "A String", # Will be set for secondary range. Empty for primary IPv4 range.
+                "totalAllocatedIp": "A String",
+                "totalFreeIp": "A String",
+              },
+            ],
+          },
+        },
+      ],
+      "warning": { # An informational warning that appears when the list of addresses
+          # 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#subnetworkAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of
+      # subnetworks.
+  "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, subnetwork, requestId=None, x__xgafv=None) + 
Deletes the specified subnetwork.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ expandIpCidrRange(project, region, subnetwork, body=None, requestId=None, x__xgafv=None) + 
Expands the IP CIDR range of the subnetwork to a specified value.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "ipCidrRange": "A String", # The IP (in CIDR format or netmask) of internal addresses that are legal on
+      # this Subnetwork. This range should be disjoint from other subnetworks
+      # within this network. This range can only be larger than (i.e. a superset
+      # of) the range previously defined before the update.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, subnetwork, views=None, x__xgafv=None) + 
Returns the specified subnetwork.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork resource to return. (required)
+  views: string, Defines the extra views returned back in the subnetwork resource.
+Supported values:
+   
+   - WITH_UTILIZATION: Utilization data is included in the
+   response. (repeated)
+    Allowed values
+      DEFAULT - 
+      WITH_UTILIZATION - Utilization data is included in the response.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a Subnetwork resource.
+    #
+    # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+    # Private Cloud network with one primary IP range and zero or more secondary
+    # IP ranges. For more information, read
+    # Virtual Private Cloud (VPC) Network.
+  "allowSubnetCidrRoutesOverlap": True or False, # Whether this subnetwork's ranges can conflict with existing custom routes.
+      # Setting this to true allows this subnetwork's primary and secondary ranges
+      # to overlap with (and contain) custom routes that have already been
+      # configured on the corresponding network.
+      #
+      # For example if a static route has range 10.1.0.0/16, a subnet
+      # range 10.0.0.0/8 could only be created if allow_conflicting_routes=true.
+      #
+      # Overlapping is only allowed on subnetwork operations; routes
+      # whose ranges conflict with this subnetwork's ranges won't be allowed unless
+      # route.allow_conflicting_subnetworks is set to true.
+      #
+      # Typically packets destined to IPs within the subnetwork (which may contain
+      # private/sensitive data) are prevented from leaving the virtual network.
+      # Setting this field to true will disable this feature.
+      #
+      # The default value is false and applies to all existing subnetworks and
+      # automatically created subnetworks.
+  "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. This field can be set only at resource creation time.
+  "enableFlowLogs": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+      # explicitly set, it will not appear in get listings. If not set
+      # the default behavior is determined by the org policy, if there is no org
+      # policy specified, then it will default to disabled. This field isn't
+      # supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.
+  "externalIpv6Prefix": "A String", # The external IPv6 address range that is owned by this
+      # subnetwork.
+  "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 Subnetwork. An up-to-date fingerprint must be
+      # provided in order to update the Subnetwork, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a Subnetwork.
+  "gatewayAddress": "A String", # Output only. [Output Only] The gateway address for default routes to reach destination
+      # addresses outside this subnetwork.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this
+      # subnetwork.
+  "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+      # Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must
+      # be unique and non-overlapping within a network. Only IPv4 is supported.
+      # This field is set at resource creation time. The range can be any range
+      # listed in theValid
+      # ranges list. The range can be expanded after creation usingexpandIpCidrRange.
+  "ipCollection": "A String", # Reference to the source of IP, like a PublicDelegatedPrefix
+      # (PDP) for BYOIP. The PDP must be a sub-PDP in
+      # EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
+      # mode.
+      #
+      # Use one of the following formats to specify a sub-PDP when creating a dual
+      # stack or IPv6-only subnetwork with external access using BYOIP:
+      #
+      #    -
+      #    Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    -
+      #    Partial URL, as in
+      #
+      #
+      #           - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #           - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+      # only be specified during creation or the first time the subnet is updated
+      # into IPV4_IPV6 dual stack.
+  "ipv6CidrRange": "A String", # Output only. [Output Only] This field is for internal use.
+  "ipv6GceEndpoint": "A String", # Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the
+      # following:
+      #
+      #    - VM_ONLY: The subnetwork can be used for creating instances and
+      #    IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6
+      #    ranges from a public delegated prefix and cannot be used to create NetLb.
+      #    - VM_AND_FR: The subnetwork can be used for creating both VM
+      #    instances and Forwarding Rules. It can also be used to reserve IPv6
+      #    addresses with both VM and FR endpoint types. Such a subnetwork gets its
+      #    IPv6 range from Google IP Pool directly.
+  "kind": "compute#subnetwork", # Output only. [Output Only] Type of the resource. Always compute#subnetwork
+      # for Subnetwork resources.
+  "logConfig": { # The available logging options for this subnetwork. # This field denotes the VPC flow logging options for this subnetwork.
+      # If logging is enabled, logs are exported to Cloud Logging.
+    "aggregationInterval": "A String", # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # Toggles the aggregation interval for collecting flow logs. Increasing the
+        # interval time will reduce the amount of generated flow logs for long
+        # lasting connections. Default is an interval of 5 seconds per connection.
+    "enable": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+        # explicitly set, it will not appear in get listings. If not
+        # set the default behavior is determined by the org policy, if there is no
+        # org policy specified, then it will default to disabled.
+        # Flow logging isn't supported if the subnet purpose field is
+        # set to REGIONAL_MANAGED_PROXY.
+    "filterExpr": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # The filter expression is used to define which VPC flow logs should be
+        # exported to Cloud Logging.
+    "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # The value of the field must be in [0, 1]. Set the sampling rate of VPC
+        # flow logs within the subnetwork where 1.0 means all collected logs are
+        # reported and 0.0 means no logs are reported. Default is 0.5 unless
+        # otherwise specified by the org policy, which means half of all collected
+        # logs are reported.
+    "metadata": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # Configures whether all, none or a subset of metadata fields should be
+        # added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.
+    "metadataFields": [ # Can only be specified if VPC flow logs for this subnetwork is enabled and
+        # "metadata" was set to CUSTOM_METADATA.
+      "A String",
+    ],
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. 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.
+  "network": "A String", # The URL of the network to which this subnetwork belongs, provided by the
+      # client when initially creating the subnetwork. This field can be set only
+      # at resource creation time.
+  "params": { # Additional subnetwork 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "privateIpGoogleAccess": True or False, # Whether the VMs in this subnet can access Google services without assigned
+      # external IP addresses. This field can be both set at resource creation
+      # time and updated using setPrivateIpGoogleAccess.
+  "privateIpv6GoogleAccess": "A String", # This field is for internal use.
+      #
+      # This field can be both set at resource creation time and updated usingpatch.
+  "purpose": "A String",
+  "region": "A String", # URL of the region where the Subnetwork resides. This
+      # field can be set only at resource creation time.
+  "reservedInternalRange": "A String", # The URL of the reserved internal range.
+  "resolveSubnetMask": "A String", # Configures subnet mask resolution for this subnetwork.
+  "role": "A String", # The role of subnetwork. Currently, this field is only used when
+      # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+      # subnetwork is one that is currently being used for Envoy-based load
+      # balancers in a region. A BACKUP subnetwork is one that is
+      # ready to be promoted to ACTIVE or is currently draining.
+      # This field can be updated with a patch request.
+  "secondaryIpRanges": [ # An array of configurations for secondary IP ranges for VM instances
+      # contained in this subnetwork. The primary IP of such VM must belong to the
+      # primary ipCidrRange of the subnetwork. The alias IPs may belong to either
+      # primary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.
+    { # Represents a secondary IP range of a subnetwork.
+      "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+          # Provide this property when you create the subnetwork. Ranges must be
+          # unique and non-overlapping with all primary and secondary IP ranges
+          # within a network. Both IPv4 and IPv6 ranges are supported. For IPv4,
+          # the range can be any range listed in theValid
+          # ranges list.
+          #
+          # For IPv6:
+          # The range must have a /64 prefix length.
+          # The range must be omitted, for auto-allocation from Google-defined ULA
+          # IPv6 range.
+          # For BYOGUA internal IPv6 secondary range, the range may be specified
+          # along with the `ipCollection` field.
+          # If an `ipCollection` is specified, the requested ip_cidr_range must lie
+          # within the range of the PDP referenced by the `ipCollection` field for
+          # allocation.
+          # If `ipCollection` field is specified, but ip_cidr_range is not,
+          # the range is auto-allocated from the PDP referenced by the `ipCollection`
+          # field.
+      "ipCollection": "A String", # Reference to a Public Delegated Prefix (PDP) for BYOIP.
+          # This field should be specified for configuring BYOGUA internal IPv6
+          # secondary range.
+          # When specified along with the ip_cidr_range, the ip_cidr_range must lie
+          # within the PDP referenced by the `ipCollection` field.
+          # When specified without the ip_cidr_range, the range is auto-allocated
+          # from the PDP referenced by the `ipCollection` field.
+      "ipVersion": "A String",
+      "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+          # an alias IP/IPv6 range to a VM instance.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+          # The name must be unique within the subnetwork.
+      "reservedInternalRange": "A String", # The URL of the reserved internal range. Only IPv4 is supported.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+      # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+      # IPv6 addresses. If not specified, IPV4_ONLY is used.
+      #
+      # This field can be both set at resource creation time and updated usingpatch.
+  "state": "A String", # Output only. [Output Only] The state of the subnetwork, which can be one of the
+      # following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the
+      # purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that
+      # connections to the load balancer are being drained. A subnetwork that is
+      # draining cannot be used or modified until it reaches a status ofREADY
+  "systemReservedExternalIpv6Ranges": [ # Output only. [Output Only] The array of external IPv6 network ranges reserved from
+      # the subnetwork's external IPv6 range for system use.
+    "A String",
+  ],
+  "systemReservedInternalIpv6Ranges": [ # Output only. [Output Only] The array of internal IPv6 network ranges reserved from
+      # the subnetwork's internal IPv6 range for system use.
+    "A String",
+  ],
+  "utilizationDetails": { # The current IP utilization of all subnetwork ranges. Contains the total # Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains
+      # the total number of allocated and free IPs in each range.
+      # number of allocated and free IPs in each range.
+    "externalIpv6InstanceUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "externalIpv6LbUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range for NetLB.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "internalIpv6Utilization": { # The IPV6 utilization of a single IP range. # Utilizations of internal IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "ipv4Utilizations": [ # Utilizations of all IPV4 IP ranges. For primary ranges, the range name
+        # will be empty.
+      { # The IPV4 utilization of a single IP range.
+        "rangeName": "A String", # Will be set for secondary range. Empty for primary IPv4 range.
+        "totalAllocatedIp": "A String",
+        "totalFreeIp": "A String",
+      },
+    ],
+  },
+}
+
+ +
+ getIamPolicy(project, region, 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)
+  region: string, The name of the region 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, region, body=None, requestId=None, x__xgafv=None) + 
Creates a subnetwork in the specified project using the data
+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 Subnetwork resource.
+    # 
+    # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+    # Private Cloud network with one primary IP range and zero or more secondary
+    # IP ranges. For more information, read
+    # Virtual Private Cloud (VPC) Network.
+  "allowSubnetCidrRoutesOverlap": True or False, # Whether this subnetwork's ranges can conflict with existing custom routes.
+      # Setting this to true allows this subnetwork's primary and secondary ranges
+      # to overlap with (and contain) custom routes that have already been
+      # configured on the corresponding network.
+      # 
+      # For example if a static route has range 10.1.0.0/16, a subnet
+      # range 10.0.0.0/8 could only be created if allow_conflicting_routes=true.
+      # 
+      # Overlapping is only allowed on subnetwork operations; routes
+      # whose ranges conflict with this subnetwork's ranges won't be allowed unless
+      # route.allow_conflicting_subnetworks is set to true.
+      # 
+      # Typically packets destined to IPs within the subnetwork (which may contain
+      # private/sensitive data) are prevented from leaving the virtual network.
+      # Setting this field to true will disable this feature.
+      # 
+      # The default value is false and applies to all existing subnetworks and
+      # automatically created subnetworks.
+  "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. This field can be set only at resource creation time.
+  "enableFlowLogs": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+      # explicitly set, it will not appear in get listings. If not set
+      # the default behavior is determined by the org policy, if there is no org
+      # policy specified, then it will default to disabled. This field isn't
+      # supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.
+  "externalIpv6Prefix": "A String", # The external IPv6 address range that is owned by this
+      # subnetwork.
+  "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 Subnetwork. An up-to-date fingerprint must be
+      # provided in order to update the Subnetwork, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a Subnetwork.
+  "gatewayAddress": "A String", # Output only. [Output Only] The gateway address for default routes to reach destination
+      # addresses outside this subnetwork.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this
+      # subnetwork.
+  "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+      # Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must
+      # be unique and non-overlapping within a network. Only IPv4 is supported.
+      # This field is set at resource creation time. The range can be any range
+      # listed in theValid
+      # ranges list. The range can be expanded after creation usingexpandIpCidrRange.
+  "ipCollection": "A String", # Reference to the source of IP, like a PublicDelegatedPrefix
+      # (PDP) for BYOIP. The PDP must be a sub-PDP in
+      # EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
+      # mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating a dual
+      # stack or IPv6-only subnetwork with external access using BYOIP:
+      # 
+      #    -
+      #    Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    -
+      #    Partial URL, as in
+      # 
+      # 
+      #           - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #           - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+      # only be specified during creation or the first time the subnet is updated
+      # into IPV4_IPV6 dual stack.
+  "ipv6CidrRange": "A String", # Output only. [Output Only] This field is for internal use.
+  "ipv6GceEndpoint": "A String", # Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the
+      # following:
+      # 
+      #    - VM_ONLY: The subnetwork can be used for creating instances and
+      #    IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6
+      #    ranges from a public delegated prefix and cannot be used to create NetLb.
+      #    - VM_AND_FR: The subnetwork can be used for creating both VM
+      #    instances and Forwarding Rules. It can also be used to reserve IPv6
+      #    addresses with both VM and FR endpoint types. Such a subnetwork gets its
+      #    IPv6 range from Google IP Pool directly.
+  "kind": "compute#subnetwork", # Output only. [Output Only] Type of the resource. Always compute#subnetwork
+      # for Subnetwork resources.
+  "logConfig": { # The available logging options for this subnetwork. # This field denotes the VPC flow logging options for this subnetwork.
+      # If logging is enabled, logs are exported to Cloud Logging.
+    "aggregationInterval": "A String", # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # Toggles the aggregation interval for collecting flow logs. Increasing the
+        # interval time will reduce the amount of generated flow logs for long
+        # lasting connections. Default is an interval of 5 seconds per connection.
+    "enable": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+        # explicitly set, it will not appear in get listings. If not
+        # set the default behavior is determined by the org policy, if there is no
+        # org policy specified, then it will default to disabled.
+        # Flow logging isn't supported if the subnet purpose field is
+        # set to REGIONAL_MANAGED_PROXY.
+    "filterExpr": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # The filter expression is used to define which VPC flow logs should be
+        # exported to Cloud Logging.
+    "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # The value of the field must be in [0, 1]. Set the sampling rate of VPC
+        # flow logs within the subnetwork where 1.0 means all collected logs are
+        # reported and 0.0 means no logs are reported. Default is 0.5 unless
+        # otherwise specified by the org policy, which means half of all collected
+        # logs are reported.
+    "metadata": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # Configures whether all, none or a subset of metadata fields should be
+        # added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.
+    "metadataFields": [ # Can only be specified if VPC flow logs for this subnetwork is enabled and
+        # "metadata" was set to CUSTOM_METADATA.
+      "A String",
+    ],
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. 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.
+  "network": "A String", # The URL of the network to which this subnetwork belongs, provided by the
+      # client when initially creating the subnetwork. This field can be set only
+      # at resource creation time.
+  "params": { # Additional subnetwork 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "privateIpGoogleAccess": True or False, # Whether the VMs in this subnet can access Google services without assigned
+      # external IP addresses. This field can be both set at resource creation
+      # time and updated using setPrivateIpGoogleAccess.
+  "privateIpv6GoogleAccess": "A String", # This field is for internal use.
+      # 
+      # This field can be both set at resource creation time and updated usingpatch.
+  "purpose": "A String",
+  "region": "A String", # URL of the region where the Subnetwork resides. This
+      # field can be set only at resource creation time.
+  "reservedInternalRange": "A String", # The URL of the reserved internal range.
+  "resolveSubnetMask": "A String", # Configures subnet mask resolution for this subnetwork.
+  "role": "A String", # The role of subnetwork. Currently, this field is only used when
+      # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+      # subnetwork is one that is currently being used for Envoy-based load
+      # balancers in a region. A BACKUP subnetwork is one that is
+      # ready to be promoted to ACTIVE or is currently draining.
+      # This field can be updated with a patch request.
+  "secondaryIpRanges": [ # An array of configurations for secondary IP ranges for VM instances
+      # contained in this subnetwork. The primary IP of such VM must belong to the
+      # primary ipCidrRange of the subnetwork. The alias IPs may belong to either
+      # primary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.
+    { # Represents a secondary IP range of a subnetwork.
+      "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+          # Provide this property when you create the subnetwork. Ranges must be
+          # unique and non-overlapping with all primary and secondary IP ranges
+          # within a network. Both IPv4 and IPv6 ranges are supported. For IPv4,
+          # the range can be any range listed in theValid
+          # ranges list.
+          #
+          # For IPv6:
+          # The range must have a /64 prefix length.
+          # The range must be omitted, for auto-allocation from Google-defined ULA
+          # IPv6 range.
+          # For BYOGUA internal IPv6 secondary range, the range may be specified
+          # along with the `ipCollection` field.
+          # If an `ipCollection` is specified, the requested ip_cidr_range must lie
+          # within the range of the PDP referenced by the `ipCollection` field for
+          # allocation.
+          # If `ipCollection` field is specified, but ip_cidr_range is not,
+          # the range is auto-allocated from the PDP referenced by the `ipCollection`
+          # field.
+      "ipCollection": "A String", # Reference to a Public Delegated Prefix (PDP) for BYOIP.
+          # This field should be specified for configuring BYOGUA internal IPv6
+          # secondary range.
+          # When specified along with the ip_cidr_range, the ip_cidr_range must lie
+          # within the PDP referenced by the `ipCollection` field.
+          # When specified without the ip_cidr_range, the range is auto-allocated
+          # from the PDP referenced by the `ipCollection` field.
+      "ipVersion": "A String",
+      "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+          # an alias IP/IPv6 range to a VM instance.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+          # The name must be unique within the subnetwork.
+      "reservedInternalRange": "A String", # The URL of the reserved internal range. Only IPv4 is supported.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+      # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+      # IPv6 addresses. If not specified, IPV4_ONLY is used.
+      # 
+      # This field can be both set at resource creation time and updated usingpatch.
+  "state": "A String", # Output only. [Output Only] The state of the subnetwork, which can be one of the
+      # following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the
+      # purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that
+      # connections to the load balancer are being drained. A subnetwork that is
+      # draining cannot be used or modified until it reaches a status ofREADY
+  "systemReservedExternalIpv6Ranges": [ # Output only. [Output Only] The array of external IPv6 network ranges reserved from
+      # the subnetwork's external IPv6 range for system use.
+    "A String",
+  ],
+  "systemReservedInternalIpv6Ranges": [ # Output only. [Output Only] The array of internal IPv6 network ranges reserved from
+      # the subnetwork's internal IPv6 range for system use.
+    "A String",
+  ],
+  "utilizationDetails": { # The current IP utilization of all subnetwork ranges. Contains the total # Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains
+      # the total number of allocated and free IPs in each range.
+      # number of allocated and free IPs in each range.
+    "externalIpv6InstanceUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "externalIpv6LbUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range for NetLB.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "internalIpv6Utilization": { # The IPV6 utilization of a single IP range. # Utilizations of internal IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "ipv4Utilizations": [ # Utilizations of all IPV4 IP ranges. For primary ranges, the range name
+        # will be empty.
+      { # The IPV4 utilization of a single IP range.
+        "rangeName": "A String", # Will be set for secondary range. Empty for primary IPv4 range.
+        "totalAllocatedIp": "A String",
+        "totalFreeIp": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, views=None, x__xgafv=None) + 
Retrieves a list of subnetworks available to the specified
+project.
+
+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.
+  views: string, Defines the extra views returned back in the subnetwork resource.
+Supported values:
+   
+   - WITH_UTILIZATION: Utilization data is included in the
+   response. (repeated)
+    Allowed values
+      DEFAULT - 
+      WITH_UTILIZATION - Utilization data is included in the response.
+  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 Subnetwork resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Subnetwork resources.
+    { # Represents a Subnetwork resource.
+        #
+        # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+        # Private Cloud network with one primary IP range and zero or more secondary
+        # IP ranges. For more information, read
+        # Virtual Private Cloud (VPC) Network.
+      "allowSubnetCidrRoutesOverlap": True or False, # Whether this subnetwork's ranges can conflict with existing custom routes.
+          # Setting this to true allows this subnetwork's primary and secondary ranges
+          # to overlap with (and contain) custom routes that have already been
+          # configured on the corresponding network.
+          #
+          # For example if a static route has range 10.1.0.0/16, a subnet
+          # range 10.0.0.0/8 could only be created if allow_conflicting_routes=true.
+          #
+          # Overlapping is only allowed on subnetwork operations; routes
+          # whose ranges conflict with this subnetwork's ranges won't be allowed unless
+          # route.allow_conflicting_subnetworks is set to true.
+          #
+          # Typically packets destined to IPs within the subnetwork (which may contain
+          # private/sensitive data) are prevented from leaving the virtual network.
+          # Setting this field to true will disable this feature.
+          #
+          # The default value is false and applies to all existing subnetworks and
+          # automatically created subnetworks.
+      "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. This field can be set only at resource creation time.
+      "enableFlowLogs": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+          # explicitly set, it will not appear in get listings. If not set
+          # the default behavior is determined by the org policy, if there is no org
+          # policy specified, then it will default to disabled. This field isn't
+          # supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.
+      "externalIpv6Prefix": "A String", # The external IPv6 address range that is owned by this
+          # subnetwork.
+      "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 Subnetwork. An up-to-date fingerprint must be
+          # provided in order to update the Subnetwork, otherwise the
+          # request will fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a Subnetwork.
+      "gatewayAddress": "A String", # Output only. [Output Only] The gateway address for default routes to reach destination
+          # addresses outside this subnetwork.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this
+          # subnetwork.
+      "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+          # Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must
+          # be unique and non-overlapping within a network. Only IPv4 is supported.
+          # This field is set at resource creation time. The range can be any range
+          # listed in theValid
+          # ranges list. The range can be expanded after creation usingexpandIpCidrRange.
+      "ipCollection": "A String", # Reference to the source of IP, like a PublicDelegatedPrefix
+          # (PDP) for BYOIP. The PDP must be a sub-PDP in
+          # EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
+          # mode.
+          #
+          # Use one of the following formats to specify a sub-PDP when creating a dual
+          # stack or IPv6-only subnetwork with external access using BYOIP:
+          #
+          #    -
+          #    Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          #    -
+          #    Partial URL, as in
+          #
+          #
+          #           - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+          #           - regions/region/publicDelegatedPrefixes/sub-pdp-name
+      "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+          # only be specified during creation or the first time the subnet is updated
+          # into IPV4_IPV6 dual stack.
+      "ipv6CidrRange": "A String", # Output only. [Output Only] This field is for internal use.
+      "ipv6GceEndpoint": "A String", # Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the
+          # following:
+          #
+          #    - VM_ONLY: The subnetwork can be used for creating instances and
+          #    IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6
+          #    ranges from a public delegated prefix and cannot be used to create NetLb.
+          #    - VM_AND_FR: The subnetwork can be used for creating both VM
+          #    instances and Forwarding Rules. It can also be used to reserve IPv6
+          #    addresses with both VM and FR endpoint types. Such a subnetwork gets its
+          #    IPv6 range from Google IP Pool directly.
+      "kind": "compute#subnetwork", # Output only. [Output Only] Type of the resource. Always compute#subnetwork
+          # for Subnetwork resources.
+      "logConfig": { # The available logging options for this subnetwork. # This field denotes the VPC flow logging options for this subnetwork.
+          # If logging is enabled, logs are exported to Cloud Logging.
+        "aggregationInterval": "A String", # Can only be specified if VPC flow logging for this subnetwork is enabled.
+            # Toggles the aggregation interval for collecting flow logs. Increasing the
+            # interval time will reduce the amount of generated flow logs for long
+            # lasting connections. Default is an interval of 5 seconds per connection.
+        "enable": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+            # explicitly set, it will not appear in get listings. If not
+            # set the default behavior is determined by the org policy, if there is no
+            # org policy specified, then it will default to disabled.
+            # Flow logging isn't supported if the subnet purpose field is
+            # set to REGIONAL_MANAGED_PROXY.
+        "filterExpr": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+            # The filter expression is used to define which VPC flow logs should be
+            # exported to Cloud Logging.
+        "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled.
+            # The value of the field must be in [0, 1]. Set the sampling rate of VPC
+            # flow logs within the subnetwork where 1.0 means all collected logs are
+            # reported and 0.0 means no logs are reported. Default is 0.5 unless
+            # otherwise specified by the org policy, which means half of all collected
+            # logs are reported.
+        "metadata": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+            # Configures whether all, none or a subset of metadata fields should be
+            # added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.
+        "metadataFields": [ # Can only be specified if VPC flow logs for this subnetwork is enabled and
+            # "metadata" was set to CUSTOM_METADATA.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name of the resource, provided by the client when initially creating
+          # the resource. 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.
+      "network": "A String", # The URL of the network to which this subnetwork belongs, provided by the
+          # client when initially creating the subnetwork. This field can be set only
+          # at resource creation time.
+      "params": { # Additional subnetwork 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.
+            # 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.
+          "a_key": "A String",
+        },
+      },
+      "privateIpGoogleAccess": True or False, # Whether the VMs in this subnet can access Google services without assigned
+          # external IP addresses. This field can be both set at resource creation
+          # time and updated using setPrivateIpGoogleAccess.
+      "privateIpv6GoogleAccess": "A String", # This field is for internal use.
+          #
+          # This field can be both set at resource creation time and updated usingpatch.
+      "purpose": "A String",
+      "region": "A String", # URL of the region where the Subnetwork resides. This
+          # field can be set only at resource creation time.
+      "reservedInternalRange": "A String", # The URL of the reserved internal range.
+      "resolveSubnetMask": "A String", # Configures subnet mask resolution for this subnetwork.
+      "role": "A String", # The role of subnetwork. Currently, this field is only used when
+          # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+          # subnetwork is one that is currently being used for Envoy-based load
+          # balancers in a region. A BACKUP subnetwork is one that is
+          # ready to be promoted to ACTIVE or is currently draining.
+          # This field can be updated with a patch request.
+      "secondaryIpRanges": [ # An array of configurations for secondary IP ranges for VM instances
+          # contained in this subnetwork. The primary IP of such VM must belong to the
+          # primary ipCidrRange of the subnetwork. The alias IPs may belong to either
+          # primary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.
+        { # Represents a secondary IP range of a subnetwork.
+          "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+              # Provide this property when you create the subnetwork. Ranges must be
+              # unique and non-overlapping with all primary and secondary IP ranges
+              # within a network. Both IPv4 and IPv6 ranges are supported. For IPv4,
+              # the range can be any range listed in theValid
+              # ranges list.
+              #
+              # For IPv6:
+              # The range must have a /64 prefix length.
+              # The range must be omitted, for auto-allocation from Google-defined ULA
+              # IPv6 range.
+              # For BYOGUA internal IPv6 secondary range, the range may be specified
+              # along with the `ipCollection` field.
+              # If an `ipCollection` is specified, the requested ip_cidr_range must lie
+              # within the range of the PDP referenced by the `ipCollection` field for
+              # allocation.
+              # If `ipCollection` field is specified, but ip_cidr_range is not,
+              # the range is auto-allocated from the PDP referenced by the `ipCollection`
+              # field.
+          "ipCollection": "A String", # Reference to a Public Delegated Prefix (PDP) for BYOIP.
+              # This field should be specified for configuring BYOGUA internal IPv6
+              # secondary range.
+              # When specified along with the ip_cidr_range, the ip_cidr_range must lie
+              # within the PDP referenced by the `ipCollection` field.
+              # When specified without the ip_cidr_range, the range is auto-allocated
+              # from the PDP referenced by the `ipCollection` field.
+          "ipVersion": "A String",
+          "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+              # an alias IP/IPv6 range to a VM instance.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the subnetwork.
+          "reservedInternalRange": "A String", # The URL of the reserved internal range. Only IPv4 is supported.
+        },
+      ],
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+          # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+          # IPv6 addresses. If not specified, IPV4_ONLY is used.
+          #
+          # This field can be both set at resource creation time and updated usingpatch.
+      "state": "A String", # Output only. [Output Only] The state of the subnetwork, which can be one of the
+          # following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the
+          # purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that
+          # connections to the load balancer are being drained. A subnetwork that is
+          # draining cannot be used or modified until it reaches a status ofREADY
+      "systemReservedExternalIpv6Ranges": [ # Output only. [Output Only] The array of external IPv6 network ranges reserved from
+          # the subnetwork's external IPv6 range for system use.
+        "A String",
+      ],
+      "systemReservedInternalIpv6Ranges": [ # Output only. [Output Only] The array of internal IPv6 network ranges reserved from
+          # the subnetwork's internal IPv6 range for system use.
+        "A String",
+      ],
+      "utilizationDetails": { # The current IP utilization of all subnetwork ranges. Contains the total # Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains
+          # the total number of allocated and free IPs in each range.
+          # number of allocated and free IPs in each range.
+        "externalIpv6InstanceUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range.
+          "totalAllocatedIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+          "totalFreeIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+        },
+        "externalIpv6LbUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range for NetLB.
+          "totalAllocatedIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+          "totalFreeIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+        },
+        "internalIpv6Utilization": { # The IPV6 utilization of a single IP range. # Utilizations of internal IPV6 IP range.
+          "totalAllocatedIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+          "totalFreeIp": {
+            "high": "A String",
+            "low": "A String",
+          },
+        },
+        "ipv4Utilizations": [ # Utilizations of all IPV4 IP ranges. For primary ranges, the range name
+            # will be empty.
+          { # The IPV4 utilization of a single IP range.
+            "rangeName": "A String", # Will be set for secondary range. Empty for primary IPv4 range.
+            "totalAllocatedIp": "A String",
+            "totalFreeIp": "A String",
+          },
+        ],
+      },
+    },
+  ],
+  "kind": "compute#subnetworkList", # Output only. [Output Only] Type of resource. Always compute#subnetworkList
+      # for lists of subnetworks.
+  "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.
+  "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.
+  },
+}
+
+ +
+ listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, serviceProject=None, x__xgafv=None) + 
Retrieves an aggregated list of all usable subnetworks in the 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.
+  serviceProject: string, The project id or project number in which the subnetwork is intended to be
+used. Only applied for Shared VPC. See [Shared VPC
+documentation](https://cloud.google.com/vpc/docs/shared-vpc/)
+  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] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output] A list of usable subnetwork URLs.
+    { # Subnetwork which the current user has compute.subnetworks.use permission on.
+      "externalIpv6Prefix": "A String", # Output only. [Output Only] The external IPv6 address range that is assigned to this
+          # subnetwork.
+      "internalIpv6Prefix": "A String", # Output only. [Output Only] The internal IPv6 address range that is assigned to this
+          # subnetwork.
+      "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+      "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+          # only be specified during creation or the first time the subnet is updated
+          # into IPV4_IPV6 dual stack.
+      "network": "A String", # Network URL.
+      "purpose": "A String",
+      "role": "A String", # The role of subnetwork. Currently, this field is only used when
+          # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+          # subnetwork is one that is currently being used for Envoy-based load
+          # balancers in a region. A BACKUP subnetwork is one that is
+          # ready to be promoted to ACTIVE or is currently draining.
+          # This field can be updated with a patch request.
+      "secondaryIpRanges": [ # Secondary IP ranges.
+        { # Secondary IP range of a usable subnetwork.
+          "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+              # Can be Ipv4 or Ipv6 range.
+          "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+              # an alias IP range to a VM instance.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+              # The name must be unique within the subnetwork.
+        },
+      ],
+      "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+          # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+          # IPv6 addresses. If not specified, IPV4_ONLY is used.
+          #
+          # This field can be both set at resource creation time and updated usingpatch.
+      "subnetwork": "A String", # Subnetwork URL.
+    },
+  ],
+  "kind": "compute#usableSubnetworksAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists
+      # of usable subnetworks.
+  "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.
+      # In special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the
+      # next page of results.
+  "scopedWarnings": [ # Output only. [Output Only] Informational warning messages for failures encountered from
+      # scopes.
+    {
+      "scopeName": "A String", # Name of the scope containing this set of Subnetworks.
+      "warning": { # An informational warning about unreachable scope
+        "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.
+      },
+    },
+  ],
+  "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.
+  },
+}
+
+ +
+ listUsable_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, subnetwork, body=None, drainTimeoutSeconds=None, requestId=None, x__xgafv=None) + 
Patches the specified subnetwork with the data included in the request.
+Only certain fields can be updated with a patch request
+as indicated in the field descriptions.
+You must specify the current fingerprint of the
+subnetwork resource being patched.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Subnetwork resource.
+    # 
+    # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+    # Private Cloud network with one primary IP range and zero or more secondary
+    # IP ranges. For more information, read
+    # Virtual Private Cloud (VPC) Network.
+  "allowSubnetCidrRoutesOverlap": True or False, # Whether this subnetwork's ranges can conflict with existing custom routes.
+      # Setting this to true allows this subnetwork's primary and secondary ranges
+      # to overlap with (and contain) custom routes that have already been
+      # configured on the corresponding network.
+      # 
+      # For example if a static route has range 10.1.0.0/16, a subnet
+      # range 10.0.0.0/8 could only be created if allow_conflicting_routes=true.
+      # 
+      # Overlapping is only allowed on subnetwork operations; routes
+      # whose ranges conflict with this subnetwork's ranges won't be allowed unless
+      # route.allow_conflicting_subnetworks is set to true.
+      # 
+      # Typically packets destined to IPs within the subnetwork (which may contain
+      # private/sensitive data) are prevented from leaving the virtual network.
+      # Setting this field to true will disable this feature.
+      # 
+      # The default value is false and applies to all existing subnetworks and
+      # automatically created subnetworks.
+  "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. This field can be set only at resource creation time.
+  "enableFlowLogs": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+      # explicitly set, it will not appear in get listings. If not set
+      # the default behavior is determined by the org policy, if there is no org
+      # policy specified, then it will default to disabled. This field isn't
+      # supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.
+  "externalIpv6Prefix": "A String", # The external IPv6 address range that is owned by this
+      # subnetwork.
+  "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 Subnetwork. An up-to-date fingerprint must be
+      # provided in order to update the Subnetwork, otherwise the
+      # request will fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a Subnetwork.
+  "gatewayAddress": "A String", # Output only. [Output Only] The gateway address for default routes to reach destination
+      # addresses outside this subnetwork.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this
+      # subnetwork.
+  "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork.
+      # Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must
+      # be unique and non-overlapping within a network. Only IPv4 is supported.
+      # This field is set at resource creation time. The range can be any range
+      # listed in theValid
+      # ranges list. The range can be expanded after creation usingexpandIpCidrRange.
+  "ipCollection": "A String", # Reference to the source of IP, like a PublicDelegatedPrefix
+      # (PDP) for BYOIP. The PDP must be a sub-PDP in
+      # EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
+      # mode.
+      # 
+      # Use one of the following formats to specify a sub-PDP when creating a dual
+      # stack or IPv6-only subnetwork with external access using BYOIP:
+      # 
+      #    -
+      #    Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #    -
+      #    Partial URL, as in
+      # 
+      # 
+      #           - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name
+      #           - regions/region/publicDelegatedPrefixes/sub-pdp-name
+  "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can
+      # only be specified during creation or the first time the subnet is updated
+      # into IPV4_IPV6 dual stack.
+  "ipv6CidrRange": "A String", # Output only. [Output Only] This field is for internal use.
+  "ipv6GceEndpoint": "A String", # Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the
+      # following:
+      # 
+      #    - VM_ONLY: The subnetwork can be used for creating instances and
+      #    IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6
+      #    ranges from a public delegated prefix and cannot be used to create NetLb.
+      #    - VM_AND_FR: The subnetwork can be used for creating both VM
+      #    instances and Forwarding Rules. It can also be used to reserve IPv6
+      #    addresses with both VM and FR endpoint types. Such a subnetwork gets its
+      #    IPv6 range from Google IP Pool directly.
+  "kind": "compute#subnetwork", # Output only. [Output Only] Type of the resource. Always compute#subnetwork
+      # for Subnetwork resources.
+  "logConfig": { # The available logging options for this subnetwork. # This field denotes the VPC flow logging options for this subnetwork.
+      # If logging is enabled, logs are exported to Cloud Logging.
+    "aggregationInterval": "A String", # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # Toggles the aggregation interval for collecting flow logs. Increasing the
+        # interval time will reduce the amount of generated flow logs for long
+        # lasting connections. Default is an interval of 5 seconds per connection.
+    "enable": True or False, # Whether to enable flow logging for this subnetwork. If this field is not
+        # explicitly set, it will not appear in get listings. If not
+        # set the default behavior is determined by the org policy, if there is no
+        # org policy specified, then it will default to disabled.
+        # Flow logging isn't supported if the subnet purpose field is
+        # set to REGIONAL_MANAGED_PROXY.
+    "filterExpr": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # The filter expression is used to define which VPC flow logs should be
+        # exported to Cloud Logging.
+    "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # The value of the field must be in [0, 1]. Set the sampling rate of VPC
+        # flow logs within the subnetwork where 1.0 means all collected logs are
+        # reported and 0.0 means no logs are reported. Default is 0.5 unless
+        # otherwise specified by the org policy, which means half of all collected
+        # logs are reported.
+    "metadata": "A String", # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # Configures whether all, none or a subset of metadata fields should be
+        # added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.
+    "metadataFields": [ # Can only be specified if VPC flow logs for this subnetwork is enabled and
+        # "metadata" was set to CUSTOM_METADATA.
+      "A String",
+    ],
+  },
+  "name": "A String", # The name of the resource, provided by the client when initially creating
+      # the resource. 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.
+  "network": "A String", # The URL of the network to which this subnetwork belongs, provided by the
+      # client when initially creating the subnetwork. This field can be set only
+      # at resource creation time.
+  "params": { # Additional subnetwork 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.
+        # 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.
+      "a_key": "A String",
+    },
+  },
+  "privateIpGoogleAccess": True or False, # Whether the VMs in this subnet can access Google services without assigned
+      # external IP addresses. This field can be both set at resource creation
+      # time and updated using setPrivateIpGoogleAccess.
+  "privateIpv6GoogleAccess": "A String", # This field is for internal use.
+      # 
+      # This field can be both set at resource creation time and updated usingpatch.
+  "purpose": "A String",
+  "region": "A String", # URL of the region where the Subnetwork resides. This
+      # field can be set only at resource creation time.
+  "reservedInternalRange": "A String", # The URL of the reserved internal range.
+  "resolveSubnetMask": "A String", # Configures subnet mask resolution for this subnetwork.
+  "role": "A String", # The role of subnetwork. Currently, this field is only used when
+      # purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE
+      # subnetwork is one that is currently being used for Envoy-based load
+      # balancers in a region. A BACKUP subnetwork is one that is
+      # ready to be promoted to ACTIVE or is currently draining.
+      # This field can be updated with a patch request.
+  "secondaryIpRanges": [ # An array of configurations for secondary IP ranges for VM instances
+      # contained in this subnetwork. The primary IP of such VM must belong to the
+      # primary ipCidrRange of the subnetwork. The alias IPs may belong to either
+      # primary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.
+    { # Represents a secondary IP range of a subnetwork.
+      "ipCidrRange": "A String", # The range of IP addresses belonging to this subnetwork secondary range.
+          # Provide this property when you create the subnetwork. Ranges must be
+          # unique and non-overlapping with all primary and secondary IP ranges
+          # within a network. Both IPv4 and IPv6 ranges are supported. For IPv4,
+          # the range can be any range listed in theValid
+          # ranges list.
+          #
+          # For IPv6:
+          # The range must have a /64 prefix length.
+          # The range must be omitted, for auto-allocation from Google-defined ULA
+          # IPv6 range.
+          # For BYOGUA internal IPv6 secondary range, the range may be specified
+          # along with the `ipCollection` field.
+          # If an `ipCollection` is specified, the requested ip_cidr_range must lie
+          # within the range of the PDP referenced by the `ipCollection` field for
+          # allocation.
+          # If `ipCollection` field is specified, but ip_cidr_range is not,
+          # the range is auto-allocated from the PDP referenced by the `ipCollection`
+          # field.
+      "ipCollection": "A String", # Reference to a Public Delegated Prefix (PDP) for BYOIP.
+          # This field should be specified for configuring BYOGUA internal IPv6
+          # secondary range.
+          # When specified along with the ip_cidr_range, the ip_cidr_range must lie
+          # within the PDP referenced by the `ipCollection` field.
+          # When specified without the ip_cidr_range, the range is auto-allocated
+          # from the PDP referenced by the `ipCollection` field.
+      "ipVersion": "A String",
+      "rangeName": "A String", # The name associated with this subnetwork secondary range, used when adding
+          # an alias IP/IPv6 range to a VM instance.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+          # The name must be unique within the subnetwork.
+      "reservedInternalRange": "A String", # The URL of the reserved internal range. Only IPv4 is supported.
+    },
+  ],
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "stackType": "A String", # The stack type for the subnet. If set to IPV4_ONLY, new VMs
+      # in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and
+      # IPv6 addresses. If not specified, IPV4_ONLY is used.
+      # 
+      # This field can be both set at resource creation time and updated usingpatch.
+  "state": "A String", # Output only. [Output Only] The state of the subnetwork, which can be one of the
+      # following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the
+      # purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that
+      # connections to the load balancer are being drained. A subnetwork that is
+      # draining cannot be used or modified until it reaches a status ofREADY
+  "systemReservedExternalIpv6Ranges": [ # Output only. [Output Only] The array of external IPv6 network ranges reserved from
+      # the subnetwork's external IPv6 range for system use.
+    "A String",
+  ],
+  "systemReservedInternalIpv6Ranges": [ # Output only. [Output Only] The array of internal IPv6 network ranges reserved from
+      # the subnetwork's internal IPv6 range for system use.
+    "A String",
+  ],
+  "utilizationDetails": { # The current IP utilization of all subnetwork ranges. Contains the total # Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains
+      # the total number of allocated and free IPs in each range.
+      # number of allocated and free IPs in each range.
+    "externalIpv6InstanceUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "externalIpv6LbUtilization": { # The IPV6 utilization of a single IP range. # Utilizations of external IPV6 IP range for NetLB.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "internalIpv6Utilization": { # The IPV6 utilization of a single IP range. # Utilizations of internal IPV6 IP range.
+      "totalAllocatedIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+      "totalFreeIp": {
+        "high": "A String",
+        "low": "A String",
+      },
+    },
+    "ipv4Utilizations": [ # Utilizations of all IPV4 IP ranges. For primary ranges, the range name
+        # will be empty.
+      { # The IPV4 utilization of a single IP range.
+        "rangeName": "A String", # Will be set for secondary range. Empty for primary IPv4 range.
+        "totalAllocatedIp": "A String",
+        "totalFreeIp": "A String",
+      },
+    ],
+  },
+}
+
+  drainTimeoutSeconds: integer, The drain timeout specifies the upper bound in seconds on the amount of
+time allowed to drain connections from the current ACTIVE subnetwork
+to the current BACKUP subnetwork. The drain timeout is only applicable
+when the following conditions are true:
+ - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER
+ - the subnetwork being patched has role = BACKUP
+ - the patch request is setting the role to ACTIVE. Note that after this
+   patch operation the roles of the ACTIVE and BACKUP subnetworks will be
+   swapped.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setIamPolicy(project, region, 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)
+  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:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd 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).
+}
+
+ +
+ setPrivateIpGoogleAccess(project, region, subnetwork, body=None, requestId=None, x__xgafv=None) + 
Set whether VMs in this subnet can access Google services without assigning
+external IP addresses through Private Google Access.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork resource. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "privateIpGoogleAccess": True or False,
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.targetGrpcProxies.html b/docs/dyn/compute_preview.targetGrpcProxies.html new file mode 100644 index 0000000000..5b57a66b39 --- /dev/null +++ b/docs/dyn/compute_preview.targetGrpcProxies.html @@ -0,0 +1,1361 @@ + + + +

Compute Engine API . targetGrpcProxies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, targetGrpcProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetGrpcProxy in the given scope

+

+ get(project, targetGrpcProxy, x__xgafv=None)

+

Returns the specified TargetGrpcProxy resource in the given scope.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetGrpcProxy in the specified project in the given scope

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the TargetGrpcProxies for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, targetGrpcProxy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified TargetGrpcProxy resource with the data included in

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, targetGrpcProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetGrpcProxy in the given scope
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetGrpcProxy: string, Name of the TargetGrpcProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetGrpcProxy, x__xgafv=None) + 
Returns the specified TargetGrpcProxy resource in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetGrpcProxy: string, Name of the TargetGrpcProxy 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 Target gRPC Proxy resource.
+    #
+    # A target gRPC proxy is a component of load balancers intended for
+    # load balancing gRPC traffic. Only global forwarding rules with load balancing
+    # scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target
+    # gRPC Proxy references a URL map that specifies how traffic is routed to
+    # gRPC backend services.
+  "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 TargetGrpcProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetGrpcProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetGrpcProxy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#targetGrpcProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.
+  "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.
+  "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.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to the
+      # BackendService. The protocol field in the BackendService must be set to
+      # GRPC.
+  "validateForProxyless": True or False, # If true, indicates that the BackendServices referenced by the urlMap may be
+      # accessed by gRPC applications without using a sidecar proxy. This will
+      # enable configuration checks on urlMap and its referenced BackendServices to
+      # not allow unsupported features. A gRPC application must use
+      # "xds:///" scheme in the target URI of the service it is
+      # connecting to.
+      # If false, indicates that the BackendServices referenced by the urlMap will
+      # be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC
+      # application must not use "xds:///" scheme in the target URI of
+      # the service it is connecting to
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetGrpcProxy in the specified project in the given scope
+using the parameters that are 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 Target gRPC Proxy resource.
+    # 
+    # A target gRPC proxy is a component of load balancers intended for
+    # load balancing gRPC traffic. Only global forwarding rules with load balancing
+    # scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target
+    # gRPC Proxy references a URL map that specifies how traffic is routed to
+    # gRPC backend services.
+  "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 TargetGrpcProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetGrpcProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetGrpcProxy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#targetGrpcProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.
+  "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.
+  "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.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to the
+      # BackendService. The protocol field in the BackendService must be set to
+      # GRPC.
+  "validateForProxyless": True or False, # If true, indicates that the BackendServices referenced by the urlMap may be
+      # accessed by gRPC applications without using a sidecar proxy. This will
+      # enable configuration checks on urlMap and its referenced BackendServices to
+      # not allow unsupported features. A gRPC application must use
+      # "xds:///" scheme in the target URI of the service it is
+      # connecting to.
+      # If false, indicates that the BackendServices referenced by the urlMap will
+      # be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC
+      # application must not use "xds:///" scheme in the target URI of
+      # the service it is connecting to
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Lists the TargetGrpcProxies for a project in the given scope.
+
+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.
+  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 TargetGrpcProxy resources.
+    { # Represents a Target gRPC Proxy resource.
+        #
+        # A target gRPC proxy is a component of load balancers intended for
+        # load balancing gRPC traffic. Only global forwarding rules with load balancing
+        # scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target
+        # gRPC Proxy references a URL map that specifies how traffic is routed to
+        # gRPC backend services.
+      "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 TargetGrpcProxy. An up-to-date fingerprint must
+          # be provided in order to patch/update the TargetGrpcProxy; otherwise, the
+          # request will fail with error 412 conditionNotMet. To see the
+          # latest fingerprint, make a get() request to retrieve the
+          # TargetGrpcProxy.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "kind": "compute#targetGrpcProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.
+      "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.
+      "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.
+      "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to the
+          # BackendService. The protocol field in the BackendService must be set to
+          # GRPC.
+      "validateForProxyless": True or False, # If true, indicates that the BackendServices referenced by the urlMap may be
+          # accessed by gRPC applications without using a sidecar proxy. This will
+          # enable configuration checks on urlMap and its referenced BackendServices to
+          # not allow unsupported features. A gRPC application must use
+          # "xds:///" scheme in the target URI of the service it is
+          # connecting to.
+          # If false, indicates that the BackendServices referenced by the urlMap will
+          # be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC
+          # application must not use "xds:///" scheme in the target URI of
+          # the service it is connecting to
+    },
+  ],
+  "kind": "compute#targetGrpcProxyList", # Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.
+  "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, targetGrpcProxy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified TargetGrpcProxy resource with the data included in
+the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetGrpcProxy: string, Name of the TargetGrpcProxy resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target gRPC Proxy resource.
+    # 
+    # A target gRPC proxy is a component of load balancers intended for
+    # load balancing gRPC traffic. Only global forwarding rules with load balancing
+    # scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target
+    # gRPC Proxy references a URL map that specifies how traffic is routed to
+    # gRPC backend services.
+  "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 TargetGrpcProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetGrpcProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetGrpcProxy.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#targetGrpcProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.
+  "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.
+  "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.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to the
+      # BackendService. The protocol field in the BackendService must be set to
+      # GRPC.
+  "validateForProxyless": True or False, # If true, indicates that the BackendServices referenced by the urlMap may be
+      # accessed by gRPC applications without using a sidecar proxy. This will
+      # enable configuration checks on urlMap and its referenced BackendServices to
+      # not allow unsupported features. A gRPC application must use
+      # "xds:///" scheme in the target URI of the service it is
+      # connecting to.
+      # If false, indicates that the BackendServices referenced by the urlMap will
+      # be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC
+      # application must not use "xds:///" scheme in the target URI of
+      # the service it is connecting to
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.targetHttpProxies.html b/docs/dyn/compute_preview.targetHttpProxies.html new file mode 100644 index 0000000000..94022e5385 --- /dev/null +++ b/docs/dyn/compute_preview.targetHttpProxies.html @@ -0,0 +1,2002 @@ + + + +

Compute Engine API . targetHttpProxies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all TargetHttpProxy resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, targetHttpProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetHttpProxy resource.

+

+ get(project, targetHttpProxy, x__xgafv=None)

+

Returns the specified TargetHttpProxy resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetHttpProxy resource in the specified

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetHttpProxy resources available

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified TargetHttpProxy resource with the data included in

+

+ setUrlMap(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the URL map for TargetHttpProxy.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all TargetHttpProxy resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetHttpProxiesScopedList resources.
+    "a_key": { # Name of the scope containing this set of TargetHttpProxies.
+      "targetHttpProxies": [ # A list of TargetHttpProxies contained in this scope.
+        { # Represents a Target HTTP Proxy resource.
+            #
+            # Google Compute Engine has two Target HTTP Proxy resources:
+            #
+            # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+            # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+            #
+            # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+            #
+            # * targetHttpProxies are used by global external Application Load Balancers,
+            #   classic Application Load Balancers, cross-region internal Application Load
+            #   Balancers, and Traffic Director.
+            # * regionTargetHttpProxies are used by regional internal Application Load
+            #   Balancers and regional external Application Load Balancers.
+            #
+            # Forwarding rules reference a target HTTP proxy, and the target proxy
+            # then references a URL map. For more information, readUsing Target Proxies
+            # and
+            # Forwarding rule concepts.
+          "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 TargetHttpProxy. An up-to-date fingerprint must
+              # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+              # request will fail with error 412 conditionNotMet. To see the
+              # latest fingerprint, make a get() request to retrieve the
+              # TargetHttpProxy.
+          "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+              # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+              # not specified, a default value (610 seconds) will be used.
+              #
+              # For global external Application Load Balancers, the minimum allowed value
+              # is 5 seconds and the maximum allowed value is 1200 seconds.
+              #
+              # For classic Application Load Balancers, this option is not supported.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+              # for target HTTP proxies.
+          "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.
+          "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+              # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+              #
+              # When this field is set to true, Envoy proxies set up inbound
+              # traffic interception and bind to the IP address and port specified in the
+              # forwarding rule. This is generally useful when using Traffic Director to
+              # configure Envoy as a gateway or middle proxy (in other words, not a
+              # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+              # requests when it receives them.
+              #
+              # The default is false.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+              # resides. This field is not applicable to global Target HTTP Proxies.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+              # the BackendService.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#targetHttpProxyAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP
+      # Proxies.
+  "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",
+  ],
+}
+
+ +
+ 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, targetHttpProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetHttpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetHttpProxy, x__xgafv=None) + 
Returns the specified TargetHttpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy 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 Target HTTP Proxy resource.
+    #
+    # Google Compute Engine has two Target HTTP Proxy resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+    #
+    # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+    #
+    # * targetHttpProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    #
+    # Forwarding rules reference a target HTTP proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "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 TargetHttpProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetHttpProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      #
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      #
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+      # for target HTTP proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+      # resides. This field is not applicable to global Target HTTP Proxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+      # the BackendService.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetHttpProxy resource 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 Target HTTP Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTP Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+    # 
+    # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+    # 
+    # * targetHttpProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTP proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "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 TargetHttpProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetHttpProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+      # for target HTTP proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+      # resides. This field is not applicable to global Target HTTP Proxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+      # the BackendService.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetHttpProxy resources available
+to 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A list of TargetHttpProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetHttpProxy resources.
+    { # Represents a Target HTTP Proxy resource.
+        #
+        # Google Compute Engine has two Target HTTP Proxy resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+        # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+        #
+        # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+        #
+        # * targetHttpProxies are used by global external Application Load Balancers,
+        #   classic Application Load Balancers, cross-region internal Application Load
+        #   Balancers, and Traffic Director.
+        # * regionTargetHttpProxies are used by regional internal Application Load
+        #   Balancers and regional external Application Load Balancers.
+        #
+        # Forwarding rules reference a target HTTP proxy, and the target proxy
+        # then references a URL map. For more information, readUsing Target Proxies
+        # and
+        # Forwarding rule concepts.
+      "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 TargetHttpProxy. An up-to-date fingerprint must
+          # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+          # request will fail with error 412 conditionNotMet. To see the
+          # latest fingerprint, make a get() request to retrieve the
+          # TargetHttpProxy.
+      "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+          # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+          # not specified, a default value (610 seconds) will be used.
+          #
+          # For global external Application Load Balancers, the minimum allowed value
+          # is 5 seconds and the maximum allowed value is 1200 seconds.
+          #
+          # For classic Application Load Balancers, this option is not supported.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+          # for target HTTP proxies.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+          # resides. This field is not applicable to global Target HTTP Proxies.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+          # the BackendService.
+    },
+  ],
+  "kind": "compute#targetHttpProxyList", # Output only. Type of resource. Always compute#targetHttpProxyList for lists
+      # of target HTTP proxies.
+  "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.
+  "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, targetHttpProxy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified TargetHttpProxy resource with the data included in
+the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target HTTP Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTP Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)
+    # 
+    # A target HTTP proxy is a component of Google Cloud HTTP load balancers.
+    # 
+    # * targetHttpProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTP proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "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 TargetHttpProxy. An up-to-date fingerprint must
+      # be provided in order to patch/update the TargetHttpProxy; otherwise, the
+      # request will fail with error 412 conditionNotMet. To see the
+      # latest fingerprint, make a get() request to retrieve the
+      # TargetHttpProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpProxy", # Output only. [Output Only] Type of resource. Always compute#targetHttpProxy
+      # for target HTTP proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional Target HTTP Proxy
+      # resides. This field is not applicable to global Target HTTP Proxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "urlMap": "A String", # URL to the UrlMap resource that defines the mapping from URL to
+      # the BackendService.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setUrlMap(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the URL map for TargetHttpProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpProxy: string, Name of the TargetHttpProxy to set a URL map for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "urlMap": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.targetHttpsProxies.html b/docs/dyn/compute_preview.targetHttpsProxies.html new file mode 100644 index 0000000000..1ec51f9fca --- /dev/null +++ b/docs/dyn/compute_preview.targetHttpsProxies.html @@ -0,0 +1,3774 @@ + + + +

Compute Engine API . targetHttpsProxies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all TargetHttpsProxy resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, targetHttpsProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetHttpsProxy resource.

+

+ get(project, targetHttpsProxy, x__xgafv=None)

+

Returns the specified TargetHttpsProxy resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetHttpsProxy resource in the specified

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetHttpsProxy resources

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Patches the specified TargetHttpsProxy resource with the data included in

+

+ setCertificateMap(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the Certificate Map for TargetHttpsProxy.

+

+ setQuicOverride(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Sets the QUIC override policy for TargetHttpsProxy.

+

+ setSslCertificates(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Replaces SslCertificates for TargetHttpsProxy.

+

+ setSslPolicy(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the

+

+ setUrlMap(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the URL map for TargetHttpsProxy.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all TargetHttpsProxy resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetHttpsProxiesScopedList resources.
+    "a_key": { # Name of the scope containing this set of TargetHttpsProxies.
+      "targetHttpsProxies": [ # A list of TargetHttpsProxies contained in this scope.
+        { # Represents a Target HTTPS Proxy resource.
+            #
+            # Google Compute Engine has two Target HTTPS Proxy resources:
+            #
+            # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+            # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+            #
+            # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+            #
+            # * targetHttpsProxies are used by global external Application Load Balancers,
+            #   classic Application Load Balancers, cross-region internal Application Load
+            #   Balancers, and Traffic Director.
+            # * regionTargetHttpsProxies are used by regional internal Application Load
+            #   Balancers and regional external Application Load Balancers.
+            #
+            # Forwarding rules reference a target HTTPS proxy, and the target proxy
+            # then references a URL map. For more information, readUsing Target Proxies
+            # and
+            # Forwarding rule concepts.
+          "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+              # that describes how the proxy should authorize inbound traffic. If left
+              # blank, access will not be restricted by an authorization policy.
+              #
+              #  Refer to the AuthorizationPolicy resource for additional
+              # details.
+              #
+              #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+              #
+              #  Note: This field currently has no impact.
+          "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+              # the given target proxy.
+              # This field can only be set for Global external Application Load Balancer or
+              # Classic Application Load Balancer. For other products use Certificate
+              # Manager Certificates instead.
+              #
+              # If set, sslCertificates will be ignored.
+              #
+              #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+          "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 TargetHttpsProxy. An up-to-date fingerprint must
+              # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+              # will fail with error 412 conditionNotMet. To see the latest
+              # fingerprint, make a get() request to retrieve the
+              # TargetHttpsProxy.
+          "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+              # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+              # not specified, a default value (610 seconds) will be used.
+              #
+              # For global external Application Load Balancers, the minimum allowed value
+              # is 5 seconds and the maximum allowed value is 1200 seconds.
+              #
+              # For classic Application Load Balancers, this option is not supported.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+          "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.
+          "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+              # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+              #
+              # When this field is set to true, Envoy proxies set up inbound
+              # traffic interception and bind to the IP address and port specified in the
+              # forwarding rule. This is generally useful when using Traffic Director to
+              # configure Envoy as a gateway or middle proxy (in other words, not a
+              # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+              # requests when it receives them.
+              #
+              # The default is false.
+          "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+              # setting determines whether the load balancer attempts to negotiate QUIC
+              # with clients.
+              # You can specify NONE, ENABLE, orDISABLE.
+              #
+              #    - When quic-override is set to NONE,
+              #    Google manages whether QUIC is used.
+              #    - When quic-override is set to ENABLE, the
+              #    load balancer uses QUIC when possible.
+              #    - When quic-override is set to DISABLE, the
+              #    load balancer doesn't use QUIC.
+              #    - If the quic-override flag is not specified,NONE is implied.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+              # resides. This field is not applicable to global TargetHttpsProxies.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+              # that describes how the proxy should authenticate inbound traffic.
+              #
+              #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+              # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+              # It also applies to a regional TargetHttpsProxy attached to
+              # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+              # documentation.
+              #
+              #   If left blank, communications are not encrypted.
+          "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+              # connections between users and the load balancer. At least one SSL
+              # certificate must be specified. SslCertificates do not apply when the load
+              # balancing scheme is set to INTERNAL_SELF_MANAGED.
+              #
+              # The URLs should refer to a SSL Certificate resource or Certificate Manager
+              # Certificate resource. Mixing Classic Certificates and Certificate Manager
+              # Certificates is not allowed. Certificate Manager Certificates must include
+              # the certificatemanager API namespace. Using Certificate Manager
+              # Certificates in this field is not supported by Global external Application
+              # Load Balancer or Classic Application Load Balancer, use certificate_map
+              # instead.
+              #
+              # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+              # Certificate Manager Certificates.
+              #
+              # Certificate Manager Certificates accepted formats are:
+              #
+              #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+              #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+            "A String",
+          ],
+          "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+              # resource. If not set, the TargetHttpsProxy resource has no
+              # SSL policy configured.
+          "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+              # for this service. Early Data allows a TLS resumption handshake to include
+              # the initial application payload (a HTTP request) alongside the handshake,
+              # reducing the effective round trips to "zero". This applies to TLS 1.3
+              # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+              #
+              #
+              # This can improve application performance, especially on networks where
+              # interruptions may be common, such as on mobile.
+              #
+              #
+              # Requests with Early Data will have the "Early-Data" HTTP header set on
+              # the request, with a value of "1", to allow the backend to determine whether
+              # Early Data was included.
+              #
+              #
+              # Note: TLS Early Data may allow requests to be replayed, as the data is
+              # sent to the backend before the handshake has fully completed. Applications
+              # that allow idempotent HTTP methods to make non-idempotent changes, such as
+              # a GET request updating a database, should not accept Early Data on those
+              # requests, and reject requests with the "Early-Data: 1" HTTP header by
+              # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+              # compliant.
+              #
+              #
+              # The default value is DISABLED.
+          "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+              # the mapping from URL to the BackendService. For example, the following are
+              # all valid URLs for specifying a URL map:
+              #
+              #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+              #    - projects/project/global/urlMaps/url-map
+              #    - global/urlMaps/url-map
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#targetHttpsProxyAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target
+      # HTTP Proxies.
+  "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, targetHttpsProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetHttpsProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetHttpsProxy, x__xgafv=None) + 
Returns the specified TargetHttpsProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy 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 Target HTTPS Proxy resource.
+    #
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    #
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    #
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    #
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      #
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      #
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      #
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      #
+      # If set, sslCertificates will be ignored.
+      #
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      #
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      #
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      #
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      #
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      #
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      #
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      #
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      #
+      # Certificate Manager Certificates accepted formats are:
+      #
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      #
+      #
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      #
+      #
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      #
+      #
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      #
+      #
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      #
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetHttpsProxy resource 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 Target HTTPS Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    # 
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    # 
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      # 
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      # 
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      # 
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      # 
+      # If set, sslCertificates will be ignored.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      # 
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      # 
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      # 
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      # 
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      # 
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      # 
+      # Certificate Manager Certificates accepted formats are:
+      # 
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      # 
+      # 
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      # 
+      # 
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      # 
+      # 
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      # 
+      # 
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      # 
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetHttpsProxy resources
+available to 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.
+  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 TargetHttpsProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetHttpsProxy resources.
+    { # Represents a Target HTTPS Proxy resource.
+        #
+        # Google Compute Engine has two Target HTTPS Proxy resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+        # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+        #
+        # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+        #
+        # * targetHttpsProxies are used by global external Application Load Balancers,
+        #   classic Application Load Balancers, cross-region internal Application Load
+        #   Balancers, and Traffic Director.
+        # * regionTargetHttpsProxies are used by regional internal Application Load
+        #   Balancers and regional external Application Load Balancers.
+        #
+        # Forwarding rules reference a target HTTPS proxy, and the target proxy
+        # then references a URL map. For more information, readUsing Target Proxies
+        # and
+        # Forwarding rule concepts.
+      "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+          # that describes how the proxy should authorize inbound traffic. If left
+          # blank, access will not be restricted by an authorization policy.
+          #
+          #  Refer to the AuthorizationPolicy resource for additional
+          # details.
+          #
+          #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+          #
+          #  Note: This field currently has no impact.
+      "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+          # the given target proxy.
+          # This field can only be set for Global external Application Load Balancer or
+          # Classic Application Load Balancer. For other products use Certificate
+          # Manager Certificates instead.
+          #
+          # If set, sslCertificates will be ignored.
+          #
+          #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+      "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 TargetHttpsProxy. An up-to-date fingerprint must
+          # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+          # will fail with error 412 conditionNotMet. To see the latest
+          # fingerprint, make a get() request to retrieve the
+          # TargetHttpsProxy.
+      "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+          # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+          # not specified, a default value (610 seconds) will be used.
+          #
+          # For global external Application Load Balancers, the minimum allowed value
+          # is 5 seconds and the maximum allowed value is 1200 seconds.
+          #
+          # For classic Application Load Balancers, this option is not supported.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+          # setting determines whether the load balancer attempts to negotiate QUIC
+          # with clients.
+          # You can specify NONE, ENABLE, orDISABLE.
+          #
+          #    - When quic-override is set to NONE,
+          #    Google manages whether QUIC is used.
+          #    - When quic-override is set to ENABLE, the
+          #    load balancer uses QUIC when possible.
+          #    - When quic-override is set to DISABLE, the
+          #    load balancer doesn't use QUIC.
+          #    - If the quic-override flag is not specified,NONE is implied.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+          # resides. This field is not applicable to global TargetHttpsProxies.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+          # that describes how the proxy should authenticate inbound traffic.
+          #
+          #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+          # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+          # It also applies to a regional TargetHttpsProxy attached to
+          # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+          # documentation.
+          #
+          #   If left blank, communications are not encrypted.
+      "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+          # connections between users and the load balancer. At least one SSL
+          # certificate must be specified. SslCertificates do not apply when the load
+          # balancing scheme is set to INTERNAL_SELF_MANAGED.
+          #
+          # The URLs should refer to a SSL Certificate resource or Certificate Manager
+          # Certificate resource. Mixing Classic Certificates and Certificate Manager
+          # Certificates is not allowed. Certificate Manager Certificates must include
+          # the certificatemanager API namespace. Using Certificate Manager
+          # Certificates in this field is not supported by Global external Application
+          # Load Balancer or Classic Application Load Balancer, use certificate_map
+          # instead.
+          #
+          # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+          # Certificate Manager Certificates.
+          #
+          # Certificate Manager Certificates accepted formats are:
+          #
+          #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+          #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+        "A String",
+      ],
+      "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+          # resource. If not set, the TargetHttpsProxy resource has no
+          # SSL policy configured.
+      "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+          # for this service. Early Data allows a TLS resumption handshake to include
+          # the initial application payload (a HTTP request) alongside the handshake,
+          # reducing the effective round trips to "zero". This applies to TLS 1.3
+          # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+          #
+          #
+          # This can improve application performance, especially on networks where
+          # interruptions may be common, such as on mobile.
+          #
+          #
+          # Requests with Early Data will have the "Early-Data" HTTP header set on
+          # the request, with a value of "1", to allow the backend to determine whether
+          # Early Data was included.
+          #
+          #
+          # Note: TLS Early Data may allow requests to be replayed, as the data is
+          # sent to the backend before the handshake has fully completed. Applications
+          # that allow idempotent HTTP methods to make non-idempotent changes, such as
+          # a GET request updating a database, should not accept Early Data on those
+          # requests, and reject requests with the "Early-Data: 1" HTTP header by
+          # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+          # compliant.
+          #
+          #
+          # The default value is DISABLED.
+      "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+          # the mapping from URL to the BackendService. For example, the following are
+          # all valid URLs for specifying a URL map:
+          #
+          #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+          #    - projects/project/global/urlMaps/url-map
+          #    - global/urlMaps/url-map
+    },
+  ],
+  "kind": "compute#targetHttpsProxyList", # Output only. Type of resource. Always compute#targetHttpsProxyList for
+      # lists of target HTTPS proxies.
+  "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.
+  "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, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Patches the specified TargetHttpsProxy resource with the data included in
+the request. This method supports PATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target HTTPS Proxy resource.
+    # 
+    # Google Compute Engine has two Target HTTPS Proxy resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)
+    # * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)
+    # 
+    # A target HTTPS proxy is a component of Google Cloud HTTPS load balancers.
+    # 
+    # * targetHttpsProxies are used by global external Application Load Balancers,
+    #   classic Application Load Balancers, cross-region internal Application Load
+    #   Balancers, and Traffic Director.
+    # * regionTargetHttpsProxies are used by regional internal Application Load
+    #   Balancers and regional external Application Load Balancers.
+    # 
+    # Forwarding rules reference a target HTTPS proxy, and the target proxy
+    # then references a URL map. For more information, readUsing Target Proxies
+    # and
+    # Forwarding rule concepts.
+  "authorizationPolicy": "A String", # Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
+      # that describes how the proxy should authorize inbound traffic. If left
+      # blank, access will not be restricted by an authorization policy.
+      # 
+      #  Refer to the AuthorizationPolicy resource for additional
+      # details.
+      # 
+      #  authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.
+      # 
+      #  Note: This field currently has no impact.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for Global external Application Load Balancer or
+      # Classic Application Load Balancer. For other products use Certificate
+      # Manager Certificates instead.
+      # 
+      # If set, sslCertificates will be ignored.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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 TargetHttpsProxy. An up-to-date fingerprint must
+      # be provided in order to patch the TargetHttpsProxy; otherwise, the request
+      # will fail with error 412 conditionNotMet. To see the latest
+      # fingerprint, make a get() request to retrieve the
+      # TargetHttpsProxy.
+  "httpKeepAliveTimeoutSec": 42, # Specifies how long to keep a connection open, after completing a response,
+      # while there is no matching traffic (in seconds). If an HTTP keep-alive is
+      # not specified, a default value (610 seconds) will be used.
+      # 
+      # For global external Application Load Balancers, the minimum allowed value
+      # is 5 seconds and the maximum allowed value is 1200 seconds.
+      # 
+      # For classic Application Load Balancers, this option is not supported.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetHttpsProxy", # Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "quicOverride": "A String", # Specifies the QUIC override policy for this TargetHttpsProxy resource. This
+      # setting determines whether the load balancer attempts to negotiate QUIC
+      # with clients.
+      # You can specify NONE, ENABLE, orDISABLE.
+      # 
+      #    - When quic-override is set to NONE,
+      #    Google manages whether QUIC is used.
+      #    - When quic-override is set to ENABLE, the
+      #    load balancer uses QUIC when possible.
+      #    - When quic-override is set to DISABLE, the
+      #    load balancer doesn't use QUIC.
+      #    - If the quic-override flag is not specified,NONE is implied.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TargetHttpsProxy
+      # resides. This field is not applicable to global TargetHttpsProxies.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "serverTlsPolicy": "A String", # Optional. A URL referring to a networksecurity.ServerTlsPolicy resource
+      # that describes how the proxy should authenticate inbound traffic.
+      # 
+      #  serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED
+      # or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.
+      # It also applies to a regional TargetHttpsProxy attached to
+      # regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy
+      # documentation.
+      # 
+      #   If left blank, communications are not encrypted.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to authenticate
+      # connections between users and the load balancer. At least one SSL
+      # certificate must be specified. SslCertificates do not apply when the load
+      # balancing scheme is set to INTERNAL_SELF_MANAGED.
+      # 
+      # The URLs should refer to a SSL Certificate resource or Certificate Manager
+      # Certificate resource. Mixing Classic Certificates and Certificate Manager
+      # Certificates is not allowed. Certificate Manager Certificates must include
+      # the certificatemanager API namespace. Using Certificate Manager
+      # Certificates in this field is not supported by Global external Application
+      # Load Balancer or Classic Application Load Balancer, use certificate_map
+      # instead.
+      # 
+      # Currently, you may specify up to 15 Classic SSL Certificates or up to 100
+      # Certificate Manager Certificates.
+      # 
+      # Certificate Manager Certificates accepted formats are:
+      # 
+      #    - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.
+      #    - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetHttpsProxy
+      # resource. If not set, the TargetHttpsProxy resource has no
+      # SSL policy configured.
+  "tlsEarlyData": "A String", # Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted
+      # for this service. Early Data allows a TLS resumption handshake to include
+      # the initial application payload (a HTTP request) alongside the handshake,
+      # reducing the effective round trips to "zero". This applies to TLS 1.3
+      # connections over TCP (HTTP/2) as well as over UDP (QUIC/h3).
+      # 
+      # 
+      # This can improve application performance, especially on networks where
+      # interruptions may be common, such as on mobile.
+      # 
+      # 
+      # Requests with Early Data will have the "Early-Data" HTTP header set on
+      # the request, with a value of "1", to allow the backend to determine whether
+      # Early Data was included.
+      # 
+      # 
+      # Note: TLS Early Data may allow requests to be replayed, as the data is
+      # sent to the backend before the handshake has fully completed. Applications
+      # that allow idempotent HTTP methods to make non-idempotent changes, such as
+      # a GET request updating a database, should not accept Early Data on those
+      # requests, and reject requests with the "Early-Data: 1" HTTP header by
+      # returning a HTTP 425 (Too Early) status code, in order to remain RFC
+      # compliant.
+      # 
+      # 
+      # The default value is DISABLED.
+  "urlMap": "A String", # A fully-qualified or valid partial URL to the UrlMap resource that defines
+      # the mapping from URL to the BackendService. For example, the following are
+      # all valid URLs for specifying a URL map:
+      # 
+      #    - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+      #    - projects/project/global/urlMaps/url-map
+      #    - global/urlMaps/url-map
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setCertificateMap(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the Certificate Map for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource whose CertificateMap is
+to be set. The name must be 1-63 characters long, and comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "certificateMap": "A String", # URL of the Certificate Map to associate with this TargetHttpsProxy.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setQuicOverride(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Sets the QUIC override policy for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource to set the QUIC override policy for.
+The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "quicOverride": "A String", # QUIC policy for the TargetHttpsProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSslCertificates(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Replaces SslCertificates for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource to set an
+SslCertificates resource for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sslCertificates": [ # New set of SslCertificate resources to associate
+      # with this TargetHttpsProxy resource. At least one SSL
+      # certificate must be specified. Currently, you may specify up to 15 SSL
+      # certificates.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSslPolicy(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the
+server-side support for SSL features. This affects connections between
+clients and the HTTPS proxy load balancer. They do not affect the
+connection between the load balancer and the backends.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource whose SSL policy is
+to be set. The name must be 1-63 characters long, and comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sslPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setUrlMap(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the URL map for TargetHttpsProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetHttpsProxy: string, Name of the TargetHttpsProxy resource whose URL map is
+to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "urlMap": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.targetInstances.html b/docs/dyn/compute_preview.targetInstances.html new file mode 100644 index 0000000000..bd12841b70 --- /dev/null +++ b/docs/dyn/compute_preview.targetInstances.html @@ -0,0 +1,1594 @@ + + + +

Compute Engine API . targetInstances

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of target instances.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, targetInstance, requestId=None, x__xgafv=None)

+

Deletes the specified TargetInstance resource.

+

+ get(project, zone, targetInstance, x__xgafv=None)

+

Returns the specified TargetInstance resource.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetInstance resource in the specified project and zone using

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of TargetInstance resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setSecurityPolicy(project, zone, targetInstance, body=None, requestId=None, x__xgafv=None)

+

Sets the Google Cloud Armor security policy for the specified target

+

+ testIamPermissions(project, zone, 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of target instances.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetInstance resources.
+    "a_key": { # Name of the scope containing this set of target instances.
+      "targetInstances": [ # A list of target instances contained in this scope.
+        { # Represents a Target Instance resource.
+            #
+            # You can use a target instance to handle traffic for one or more forwarding
+            # rules, which is ideal for forwarding protocol traffic that is managed by a
+            # single source. For example, ESP, AH, TCP, or UDP.
+            # For more information, readTarget
+            # instances.
+          "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.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instance": "A String", # A URL to the virtual machine instance that handles traffic for this target
+              # instance. When creating a target instance, you can provide the
+              # fully-qualified URL or a valid partial URL to the desired virtual machine.
+              # For example, the following are all valid URLs:
+              #
+              #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+              #    - projects/project/zones/zone/instances/instance
+              #    - zones/zone/instances/instance
+          "kind": "compute#targetInstance", # Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.
+          "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.
+          "natPolicy": "A String", # Must have a value of NO_NAT.
+              # Protocol forwarding delivers packets while preserving the destination IP
+              # address of the forwarding rule referencing the target instance.
+          "network": "A String", # The URL of the network this target instance uses to forward traffic.
+              # If not specified, the traffic will be forwarded to the network that
+              # the default network interface belongs to.
+          "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+              # target instance.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "zone": "A String", # Output only. [Output Only] URL of the zone where the target instance resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of addresses 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#targetInstanceAggregatedList", # 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, zone, targetInstance, requestId=None, x__xgafv=None) + 
Deletes the specified TargetInstance resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone scoping this request. (required)
+  targetInstance: string, Name of the TargetInstance 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, targetInstance, x__xgafv=None) + 
Returns the specified TargetInstance resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone scoping this request. (required)
+  targetInstance: string, Name of the TargetInstance 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 Target Instance resource.
+    #
+    # You can use a target instance to handle traffic for one or more forwarding
+    # rules, which is ideal for forwarding protocol traffic that is managed by a
+    # single source. For example, ESP, AH, TCP, or UDP.
+    # For more information, readTarget
+    # instances.
+  "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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instance": "A String", # A URL to the virtual machine instance that handles traffic for this target
+      # instance. When creating a target instance, you can provide the
+      # fully-qualified URL or a valid partial URL to the desired virtual machine.
+      # For example, the following are all valid URLs:
+      #
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+      #    - zones/zone/instances/instance
+  "kind": "compute#targetInstance", # Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.
+  "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.
+  "natPolicy": "A String", # Must have a value of NO_NAT.
+      # Protocol forwarding delivers packets while preserving the destination IP
+      # address of the forwarding rule referencing the target instance.
+  "network": "A String", # The URL of the network this target instance uses to forward traffic.
+      # If not specified, the traffic will be forwarded to the network that
+      # the default network interface belongs to.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # target instance.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the target instance resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetInstance resource in the specified project and zone using
+the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target Instance resource.
+    # 
+    # You can use a target instance to handle traffic for one or more forwarding
+    # rules, which is ideal for forwarding protocol traffic that is managed by a
+    # single source. For example, ESP, AH, TCP, or UDP.
+    # For more information, readTarget
+    # instances.
+  "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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instance": "A String", # A URL to the virtual machine instance that handles traffic for this target
+      # instance. When creating a target instance, you can provide the
+      # fully-qualified URL or a valid partial URL to the desired virtual machine.
+      # For example, the following are all valid URLs:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+      #    - projects/project/zones/zone/instances/instance
+      #    - zones/zone/instances/instance
+  "kind": "compute#targetInstance", # Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.
+  "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.
+  "natPolicy": "A String", # Must have a value of NO_NAT.
+      # Protocol forwarding delivers packets while preserving the destination IP
+      # address of the forwarding rule referencing the target instance.
+  "network": "A String", # The URL of the network this target instance uses to forward traffic.
+      # If not specified, the traffic will be forwarded to the network that
+      # the default network interface belongs to.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # target instance.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "zone": "A String", # Output only. [Output Only] URL of the zone where the target instance resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of TargetInstance resources available to the specified
+project and zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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.
+  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 TargetInstance resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetInstance resources.
+    { # Represents a Target Instance resource.
+        #
+        # You can use a target instance to handle traffic for one or more forwarding
+        # rules, which is ideal for forwarding protocol traffic that is managed by a
+        # single source. For example, ESP, AH, TCP, or UDP.
+        # For more information, readTarget
+        # instances.
+      "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.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instance": "A String", # A URL to the virtual machine instance that handles traffic for this target
+          # instance. When creating a target instance, you can provide the
+          # fully-qualified URL or a valid partial URL to the desired virtual machine.
+          # For example, the following are all valid URLs:
+          #
+          #    - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+          #    - projects/project/zones/zone/instances/instance
+          #    - zones/zone/instances/instance
+      "kind": "compute#targetInstance", # Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.
+      "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.
+      "natPolicy": "A String", # Must have a value of NO_NAT.
+          # Protocol forwarding delivers packets while preserving the destination IP
+          # address of the forwarding rule referencing the target instance.
+      "network": "A String", # The URL of the network this target instance uses to forward traffic.
+          # If not specified, the traffic will be forwarded to the network that
+          # the default network interface belongs to.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # target instance.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "zone": "A String", # Output only. [Output Only] URL of the zone where the target instance resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+    },
+  ],
+  "kind": "compute#targetInstanceList", # 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.
+  "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.
+
+
+ +
+ setSecurityPolicy(project, zone, targetInstance, body=None, requestId=None, x__xgafv=None) + 
Sets the Google Cloud Armor security policy for the specified target
+instance. For more information, seeGoogle
+Cloud Armor Overview
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone scoping this request. (required)
+  targetInstance: string, Name of the TargetInstance resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, 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)
+  zone: string, The name of the zone 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_preview.targetPools.html b/docs/dyn/compute_preview.targetPools.html new file mode 100644 index 0000000000..d4238a512e --- /dev/null +++ b/docs/dyn/compute_preview.targetPools.html @@ -0,0 +1,3388 @@ + + + +

Compute Engine API . targetPools

+

Instance Methods

+

+ addHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

+

Adds health check URLs to a target pool.

+

+ addInstance(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

+

Adds an instance to a target pool.

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of target pools.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, targetPool, requestId=None, x__xgafv=None)

+

Deletes the specified target pool.

+

+ get(project, region, targetPool, x__xgafv=None)

+

Returns the specified target pool.

+

+ getHealth(project, region, targetPool, body=None, x__xgafv=None)

+

Gets the most recent health check results for each IP for the

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a target pool in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of target pools available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ removeHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

+

Removes health check URL from a target pool.

+

+ removeInstance(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

+

Removes instance URL from a target pool.

+

+ setBackup(project, region, targetPool, body=None, failoverRatio=None, requestId=None, x__xgafv=None)

+

Changes a backup target pool's configurations.

+

+ setSecurityPolicy(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

+

Sets the Google Cloud Armor security policy for the specified target pool.

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ addHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None) + 
Adds health check URLs to a target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the target pool to add a health check to. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "healthChecks": [ # The HttpHealthCheck to add to the target pool.
+    { # A full or valid partial URL to a health check. For example, the following are
+        # valid URLs:
+        #
+        #    - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+        #    - projects/project-id/global/httpHealthChecks/health-check
+        #    - global/httpHealthChecks/health-check
+      "healthCheck": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ addInstance(project, region, targetPool, body=None, requestId=None, x__xgafv=None) + 
Adds an instance to a target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool resource to add instances to. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # A full or partial URL to an instance to add to this target pool. This can
+      # be a full or partial URL. For example, the following are valid URLs:
+      # 
+      #    - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name
+      #    - projects/project-id/zones/zone/instances/instance-name
+      #    - zones/zone/instances/instance-name
+    {
+      "instance": "A String", # The URL for a specific instance.
+          # @required compute.instancegroups.addInstances/removeInstances
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of target pools.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetPool resources.
+    "a_key": { # Name of the scope containing this set of target pools.
+      "targetPools": [ # A list of target pools contained in this scope.
+        { # Represents a Target Pool resource.
+            #
+            # Target pools are used with external passthrough Network Load Balancers.
+            # A target pool references member instances, an associated legacy
+            # HttpHealthCheck resource, and, optionally, a backup target pool.
+            # For more information, readUsing target pools.
+          "backupPool": "A String", # The server-defined URL for the resource. This field is applicable only when
+              # the containing target pool is serving a forwarding rule as the primary
+              # pool, and its failoverRatio field is properly set to a value
+              # between [0, 1].
+              # backupPool and failoverRatio together define
+              # the fallback behavior of the primary target pool: if the ratio of the
+              # healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced
+              # IP will be directed to the backup pool.
+              #
+              # In case where failoverRatio and backupPool
+              # are not set, or all the instances in the backup pool are unhealthy,
+              # the traffic will be directed back to the primary pool in the "force"
+              # mode, where traffic will be spread to the healthy instances with the
+              # best effort, or to all instances when no instance is healthy.
+          "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.
+          "failoverRatio": 3.14, # This field is applicable only when the containing target pool is serving a
+              # forwarding rule as the primary pool (i.e., not as a backup pool to some
+              # other target pool). The value of the field must be in [0, 1].
+              #
+              # If set, backupPool must also be set. They together define
+              # the fallback behavior of the primary target pool: if the ratio of the
+              # healthy instances in the primary pool is at or below this number,
+              # traffic arriving at the load-balanced IP will be directed to the
+              # backup pool.
+              #
+              # In case where failoverRatio is not set or all the
+              # instances in the backup pool are unhealthy, the traffic will be
+              # directed back to the primary pool in the "force" mode, where traffic
+              # will be spread to the healthy instances with the
+              # best effort, or to all instances when no instance is healthy.
+          "healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this
+              # pool is considered healthy if and only if the health checks pass.
+              # Only legacy HttpHealthChecks are supported. Only one health check may be
+              # specified.
+            "A String",
+          ],
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "instances": [ # A list of resource URLs to the virtual machine instances serving this pool.
+              # They must live in zones contained in the same region as this pool.
+            "A String",
+          ],
+          "kind": "compute#targetPool", # Output only. [Output Only] Type of the resource. Always compute#targetPool
+              # for target pools.
+          "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.
+          "region": "A String", # Output only. [Output Only] URL of the region where the target pool resides.
+          "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+              # target pool.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "sessionAffinity": "A String", # Session affinity option, must be one of the following values:
+              # NONE: Connections from the same client IP may go to any
+              #     instance in the pool.
+              # CLIENT_IP: Connections from the same client IP will go
+              #     to the same instance in
+              #     the pool while that instance remains healthy.
+              # CLIENT_IP_PROTO: Connections from the same client IP
+              #     with the same IP protocol will go to the same instance in the
+              #     pool while that instance remains healthy.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of addresses 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#targetPoolAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of
+      # target pools.
+  "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, targetPool, requestId=None, x__xgafv=None) + 
Deletes the specified target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetPool, x__xgafv=None) + 
Returns the specified target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool 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 Target Pool resource.
+    #
+    # Target pools are used with external passthrough Network Load Balancers.
+    # A target pool references member instances, an associated legacy
+    # HttpHealthCheck resource, and, optionally, a backup target pool.
+    # For more information, readUsing target pools.
+  "backupPool": "A String", # The server-defined URL for the resource. This field is applicable only when
+      # the containing target pool is serving a forwarding rule as the primary
+      # pool, and its failoverRatio field is properly set to a value
+      # between [0, 1].
+      # backupPool and failoverRatio together define
+      # the fallback behavior of the primary target pool: if the ratio of the
+      # healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced
+      # IP will be directed to the backup pool.
+      #
+      # In case where failoverRatio and backupPool
+      # are not set, or all the instances in the backup pool are unhealthy,
+      # the traffic will be directed back to the primary pool in the "force"
+      # mode, where traffic will be spread to the healthy instances with the
+      # best effort, or to all instances when no instance is healthy.
+  "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.
+  "failoverRatio": 3.14, # This field is applicable only when the containing target pool is serving a
+      # forwarding rule as the primary pool (i.e., not as a backup pool to some
+      # other target pool). The value of the field must be in [0, 1].
+      #
+      # If set, backupPool must also be set. They together define
+      # the fallback behavior of the primary target pool: if the ratio of the
+      # healthy instances in the primary pool is at or below this number,
+      # traffic arriving at the load-balanced IP will be directed to the
+      # backup pool.
+      #
+      # In case where failoverRatio is not set or all the
+      # instances in the backup pool are unhealthy, the traffic will be
+      # directed back to the primary pool in the "force" mode, where traffic
+      # will be spread to the healthy instances with the
+      # best effort, or to all instances when no instance is healthy.
+  "healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this
+      # pool is considered healthy if and only if the health checks pass.
+      # Only legacy HttpHealthChecks are supported. Only one health check may be
+      # specified.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instances": [ # A list of resource URLs to the virtual machine instances serving this pool.
+      # They must live in zones contained in the same region as this pool.
+    "A String",
+  ],
+  "kind": "compute#targetPool", # Output only. [Output Only] Type of the resource. Always compute#targetPool
+      # for target pools.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the target pool resides.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # target pool.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sessionAffinity": "A String", # Session affinity option, must be one of the following values:
+      # NONE: Connections from the same client IP may go to any
+      #     instance in the pool.
+      # CLIENT_IP: Connections from the same client IP will go
+      #     to the same instance in
+      #     the pool while that instance remains healthy.
+      # CLIENT_IP_PROTO: Connections from the same client IP
+      #     with the same IP protocol will go to the same instance in the
+      #     pool while that instance remains healthy.
+}
+
+ +
+ getHealth(project, region, targetPool, body=None, x__xgafv=None) + 
Gets the most recent health check results for each IP for the
+instance that is referenced by the given target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool resource to which the queried instance belongs. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instance": "A String", # The URL for a specific instance.
+      # @required compute.instancegroups.addInstances/removeInstances
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "healthStatus": [
+    {
+      "annotations": { # Metadata defined as annotations for network endpoint.
+        "a_key": "A String",
+      },
+      "forwardingRule": "A String", # URL of the forwarding rule associated with the health status of the
+          # instance.
+      "forwardingRuleIp": "A String", # A forwarding rule IP address assigned to this instance.
+      "healthState": "A String", # Health state of the IPv4 address of the instance.
+      "instance": "A String", # URL of the instance resource.
+      "ipAddress": "A String", # For target pool based Network Load Balancing, it indicates the forwarding
+          # rule's IP address assigned to this instance. For other types of load
+          # balancing, the field indicates VM internal ip.
+      "ipv6Address": "A String",
+      "ipv6HealthState": "A String", # Health state of the IPv6 address of the instance.
+      "port": 42, # The named port of the instance group, not necessarily the port that is
+          # health-checked.
+      "weight": "A String",
+      "weightError": "A String",
+    },
+  ],
+  "kind": "compute#targetPoolInstanceHealth", # Output only. [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of
+      # an instance.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a target pool in the specified project and region using
+the data 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 Target Pool resource.
+    # 
+    # Target pools are used with external passthrough Network Load Balancers.
+    # A target pool references member instances, an associated legacy
+    # HttpHealthCheck resource, and, optionally, a backup target pool.
+    # For more information, readUsing target pools.
+  "backupPool": "A String", # The server-defined URL for the resource. This field is applicable only when
+      # the containing target pool is serving a forwarding rule as the primary
+      # pool, and its failoverRatio field is properly set to a value
+      # between [0, 1].
+      # backupPool and failoverRatio together define
+      # the fallback behavior of the primary target pool: if the ratio of the
+      # healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced
+      # IP will be directed to the backup pool.
+      # 
+      # In case where failoverRatio and backupPool
+      # are not set, or all the instances in the backup pool are unhealthy,
+      # the traffic will be directed back to the primary pool in the "force"
+      # mode, where traffic will be spread to the healthy instances with the
+      # best effort, or to all instances when no instance is healthy.
+  "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.
+  "failoverRatio": 3.14, # This field is applicable only when the containing target pool is serving a
+      # forwarding rule as the primary pool (i.e., not as a backup pool to some
+      # other target pool). The value of the field must be in [0, 1].
+      # 
+      # If set, backupPool must also be set. They together define
+      # the fallback behavior of the primary target pool: if the ratio of the
+      # healthy instances in the primary pool is at or below this number,
+      # traffic arriving at the load-balanced IP will be directed to the
+      # backup pool.
+      # 
+      # In case where failoverRatio is not set or all the
+      # instances in the backup pool are unhealthy, the traffic will be
+      # directed back to the primary pool in the "force" mode, where traffic
+      # will be spread to the healthy instances with the
+      # best effort, or to all instances when no instance is healthy.
+  "healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this
+      # pool is considered healthy if and only if the health checks pass.
+      # Only legacy HttpHealthChecks are supported. Only one health check may be
+      # specified.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instances": [ # A list of resource URLs to the virtual machine instances serving this pool.
+      # They must live in zones contained in the same region as this pool.
+    "A String",
+  ],
+  "kind": "compute#targetPool", # Output only. [Output Only] Type of the resource. Always compute#targetPool
+      # for target pools.
+  "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.
+  "region": "A String", # Output only. [Output Only] URL of the region where the target pool resides.
+  "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+      # target pool.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sessionAffinity": "A String", # Session affinity option, must be one of the following values:
+      # NONE: Connections from the same client IP may go to any
+      #     instance in the pool.
+      # CLIENT_IP: Connections from the same client IP will go
+      #     to the same instance in
+      #     the pool while that instance remains healthy.
+      # CLIENT_IP_PROTO: Connections from the same client IP
+      #     with the same IP protocol will go to the same instance in the
+      #     pool while that instance remains healthy.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of target pools available to the specified
+project and 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.
+  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 TargetPool resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetPool resources.
+    { # Represents a Target Pool resource.
+        #
+        # Target pools are used with external passthrough Network Load Balancers.
+        # A target pool references member instances, an associated legacy
+        # HttpHealthCheck resource, and, optionally, a backup target pool.
+        # For more information, readUsing target pools.
+      "backupPool": "A String", # The server-defined URL for the resource. This field is applicable only when
+          # the containing target pool is serving a forwarding rule as the primary
+          # pool, and its failoverRatio field is properly set to a value
+          # between [0, 1].
+          # backupPool and failoverRatio together define
+          # the fallback behavior of the primary target pool: if the ratio of the
+          # healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced
+          # IP will be directed to the backup pool.
+          #
+          # In case where failoverRatio and backupPool
+          # are not set, or all the instances in the backup pool are unhealthy,
+          # the traffic will be directed back to the primary pool in the "force"
+          # mode, where traffic will be spread to the healthy instances with the
+          # best effort, or to all instances when no instance is healthy.
+      "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.
+      "failoverRatio": 3.14, # This field is applicable only when the containing target pool is serving a
+          # forwarding rule as the primary pool (i.e., not as a backup pool to some
+          # other target pool). The value of the field must be in [0, 1].
+          #
+          # If set, backupPool must also be set. They together define
+          # the fallback behavior of the primary target pool: if the ratio of the
+          # healthy instances in the primary pool is at or below this number,
+          # traffic arriving at the load-balanced IP will be directed to the
+          # backup pool.
+          #
+          # In case where failoverRatio is not set or all the
+          # instances in the backup pool are unhealthy, the traffic will be
+          # directed back to the primary pool in the "force" mode, where traffic
+          # will be spread to the healthy instances with the
+          # best effort, or to all instances when no instance is healthy.
+      "healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this
+          # pool is considered healthy if and only if the health checks pass.
+          # Only legacy HttpHealthChecks are supported. Only one health check may be
+          # specified.
+        "A String",
+      ],
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instances": [ # A list of resource URLs to the virtual machine instances serving this pool.
+          # They must live in zones contained in the same region as this pool.
+        "A String",
+      ],
+      "kind": "compute#targetPool", # Output only. [Output Only] Type of the resource. Always compute#targetPool
+          # for target pools.
+      "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.
+      "region": "A String", # Output only. [Output Only] URL of the region where the target pool resides.
+      "securityPolicy": "A String", # [Output Only] The resource URL for the security policy associated with this
+          # target pool.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sessionAffinity": "A String", # Session affinity option, must be one of the following values:
+          # NONE: Connections from the same client IP may go to any
+          #     instance in the pool.
+          # CLIENT_IP: Connections from the same client IP will go
+          #     to the same instance in
+          #     the pool while that instance remains healthy.
+          # CLIENT_IP_PROTO: Connections from the same client IP
+          #     with the same IP protocol will go to the same instance in the
+          #     pool while that instance remains healthy.
+    },
+  ],
+  "kind": "compute#targetPoolList", # Output only. [Output Only] Type of resource. Always compute#targetPoolList
+      # for lists of target pools.
+  "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.
+  "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.
+
+
+ +
+ removeHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None) + 
Removes health check URL from a target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  targetPool: string, Name of the target pool to remove health checks from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "healthChecks": [ # Health check URL to be removed. This can be a full or valid partial URL.
+      # For example, the following are valid URLs:
+      # 
+      #    - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check
+      #    - projects/project/global/httpHealthChecks/health-check
+      #    - global/httpHealthChecks/health-check
+    { # A full or valid partial URL to a health check. For example, the following are
+        # valid URLs:
+        #
+        #    - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+        #    - projects/project-id/global/httpHealthChecks/health-check
+        #    - global/httpHealthChecks/health-check
+      "healthCheck": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ removeInstance(project, region, targetPool, body=None, requestId=None, x__xgafv=None) + 
Removes instance URL from a target pool.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool resource to remove instances from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "instances": [ # URLs of the instances to be removed from target pool.
+    {
+      "instance": "A String", # The URL for a specific instance.
+          # @required compute.instancegroups.addInstances/removeInstances
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setBackup(project, region, targetPool, body=None, failoverRatio=None, requestId=None, x__xgafv=None) + 
Changes a backup target pool's configurations.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool resource to set a backup pool for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "target": "A String",
+}
+
+  failoverRatio: number, New failoverRatio value for the target pool.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSecurityPolicy(project, region, targetPool, body=None, requestId=None, x__xgafv=None) + 
Sets the Google Cloud Armor security policy for the specified target pool.
+For more information, seeGoogle
+Cloud Armor Overview
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  targetPool: string, Name of the TargetPool resource to which the security policy should be
+set. The name should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "securityPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.targetSslProxies.html b/docs/dyn/compute_preview.targetSslProxies.html new file mode 100644 index 0000000000..f34be8ab48 --- /dev/null +++ b/docs/dyn/compute_preview.targetSslProxies.html @@ -0,0 +1,2614 @@ + + + +

Compute Engine API . targetSslProxies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, targetSslProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetSslProxy resource.

+

+ get(project, targetSslProxy, x__xgafv=None)

+

Returns the specified TargetSslProxy resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetSslProxy resource in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetSslProxy resources

+

+ list_next()

+

Retrieves the next page of results.

+

+ setBackendService(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the BackendService for TargetSslProxy.

+

+ setCertificateMap(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the Certificate Map for TargetSslProxy.

+

+ setProxyHeader(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the ProxyHeaderType for TargetSslProxy.

+

+ setSslCertificates(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

+

Changes SslCertificates for TargetSslProxy.

+

+ setSslPolicy(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

+

Sets the SSL policy for TargetSslProxy. The SSL policy specifies the

+

+ 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, targetSslProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetSslProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetSslProxy, x__xgafv=None) + 
Returns the specified TargetSslProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy 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 Target SSL Proxy resource.
+    #
+    # A target SSL proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target SSL proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer overview.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for global target proxies.
+      # If set, sslCertificates will be ignored.
+      #
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetSslProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies.
+  "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.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService resource.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to
+      # authenticate connections to Backends. At least one SSL certificate
+      # must be specified. Currently, you may specify up to 15 SSL certificates.
+      # sslCertificates do not apply when the load balancing scheme is set to
+      # INTERNAL_SELF_MANAGED.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetSslProxy
+      # resource. If not set, the TargetSslProxy resource will not have any
+      # SSL policy configured.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetSslProxy resource 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 Target SSL Proxy resource.
+    # 
+    # A target SSL proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target SSL proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer overview.
+  "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+      # the given target proxy.
+      # This field can only be set for global target proxies.
+      # If set, sslCertificates will be ignored.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+  "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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetSslProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies.
+  "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.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService resource.
+  "sslCertificates": [ # URLs to SslCertificate resources that are used to
+      # authenticate connections to Backends. At least one SSL certificate
+      # must be specified. Currently, you may specify up to 15 SSL certificates.
+      # sslCertificates do not apply when the load balancing scheme is set to
+      # INTERNAL_SELF_MANAGED.
+    "A String",
+  ],
+  "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetSslProxy
+      # resource. If not set, the TargetSslProxy resource will not have any
+      # SSL policy configured.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetSslProxy resources
+available to 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.
+  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 TargetSslProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetSslProxy resources.
+    { # Represents a Target SSL Proxy resource.
+        #
+        # A target SSL proxy is a component of a Proxy Network Load Balancer.
+        # The forwarding rule references the target SSL proxy, and the target proxy
+        # then references a backend service. For more information, readProxy Network
+        # Load Balancer overview.
+      "certificateMap": "A String", # URL of a certificate map that identifies a certificate map associated with
+          # the given target proxy.
+          # This field can only be set for global target proxies.
+          # If set, sslCertificates will be ignored.
+          #
+          #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+      "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.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetSslProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies.
+      "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.
+      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+          # backend, either NONE or PROXY_V1. The default
+          # is NONE.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "service": "A String", # URL to the BackendService resource.
+      "sslCertificates": [ # URLs to SslCertificate resources that are used to
+          # authenticate connections to Backends. At least one SSL certificate
+          # must be specified. Currently, you may specify up to 15 SSL certificates.
+          # sslCertificates do not apply when the load balancing scheme is set to
+          # INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "sslPolicy": "A String", # URL of SslPolicy resource that will be associated with the TargetSslProxy
+          # resource. If not set, the TargetSslProxy resource will not have any
+          # SSL policy configured.
+    },
+  ],
+  "kind": "compute#targetSslProxyList", # 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.
+  "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.
+
+
+ +
+ setBackendService(project, targetSslProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the BackendService for TargetSslProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy resource whose BackendService resource
+is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "service": "A String", # The URL of the new BackendService resource for the targetSslProxy.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setCertificateMap(project, targetSslProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the Certificate Map for TargetSslProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy resource whose CertificateMap is
+to be set. The name must be 1-63 characters long, and comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "certificateMap": "A String", # URL of the Certificate Map to associate with this TargetSslProxy.
+      # 
+      #  Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setProxyHeader(project, targetSslProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the ProxyHeaderType for TargetSslProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy resource whose ProxyHeader is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "proxyHeader": "A String", # The new type of proxy header to append before sending data to the
+      # backend.  NONE or PROXY_V1 are allowed.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSslCertificates(project, targetSslProxy, body=None, requestId=None, x__xgafv=None) + 
Changes SslCertificates for TargetSslProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy resource whose SslCertificate resource
+is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sslCertificates": [ # New set of URLs to SslCertificate resources to associate with this
+      # TargetSslProxy. At least one SSL certificate must be specified.
+      # Currently, you may specify up to 15 SSL certificates.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setSslPolicy(project, targetSslProxy, body=None, requestId=None, x__xgafv=None) + 
Sets the SSL policy for TargetSslProxy. The SSL policy specifies the
+server-side support for SSL features. This affects connections between
+clients and the load balancer. They do not affect the
+connection between the load balancer and the backends.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetSslProxy: string, Name of the TargetSslProxy resource whose SSL policy is
+to be set. The name must be 1-63 characters long, and comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "sslPolicy": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.targetTcpProxies.html b/docs/dyn/compute_preview.targetTcpProxies.html new file mode 100644 index 0000000000..db83d70b39 --- /dev/null +++ b/docs/dyn/compute_preview.targetTcpProxies.html @@ -0,0 +1,1894 @@ + + + +

Compute Engine API . targetTcpProxies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all TargetTcpProxy resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, targetTcpProxy, requestId=None, x__xgafv=None)

+

Deletes the specified TargetTcpProxy resource.

+

+ get(project, targetTcpProxy, x__xgafv=None)

+

Returns the specified TargetTcpProxy resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a TargetTcpProxy resource in the specified project using

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of TargetTcpProxy resources

+

+ list_next()

+

Retrieves the next page of results.

+

+ setBackendService(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the BackendService for TargetTcpProxy.

+

+ setProxyHeader(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None)

+

Changes the ProxyHeaderType for TargetTcpProxy.

+

+ testIamPermissions(project, 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all TargetTcpProxy resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetTcpProxiesScopedList resources.
+    "a_key": { # Name of the scope containing this set of TargetTcpProxies.
+      "targetTcpProxies": [ # A list of TargetTcpProxies contained in this scope.
+        { # Represents a Target TCP Proxy resource.
+            #
+            # A target TCP proxy is a component of a Proxy Network Load Balancer.
+            # The forwarding rule references the target TCP proxy, and the target proxy
+            # then references a backend service. For more information, readProxy Network
+            # Load Balancer 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.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+          "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+          "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.
+          "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+              # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+              #
+              # When this field is set to true, Envoy proxies set up inbound
+              # traffic interception and bind to the IP address and port specified in the
+              # forwarding rule. This is generally useful when using Traffic Director to
+              # configure Envoy as a gateway or middle proxy (in other words, not a
+              # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+              # requests when it receives them.
+              #
+              # The default is false.
+          "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+              # backend, either NONE or PROXY_V1. The default
+              # is NONE.
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+              # This field is not applicable to global TCP proxy.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "service": "A String", # URL to the BackendService resource.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#targetTcpProxyAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target
+      # TCP Proxies.
+  "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, targetTcpProxy, requestId=None, x__xgafv=None) + 
Deletes the specified TargetTcpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetTcpProxy, x__xgafv=None) + 
Returns the specified TargetTcpProxy resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy 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 Target TCP Proxy resource.
+    #
+    # A target TCP proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target TCP proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer 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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+  "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      #
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      #
+      # The default is false.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+      # This field is not applicable to global TCP proxy.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService resource.
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a TargetTcpProxy resource 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 Target TCP Proxy resource.
+    # 
+    # A target TCP proxy is a component of a Proxy Network Load Balancer.
+    # The forwarding rule references the target TCP proxy, and the target proxy
+    # then references a backend service. For more information, readProxy Network
+    # Load Balancer 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.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+  "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+  "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.
+  "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+      # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+      # 
+      # When this field is set to true, Envoy proxies set up inbound
+      # traffic interception and bind to the IP address and port specified in the
+      # forwarding rule. This is generally useful when using Traffic Director to
+      # configure Envoy as a gateway or middle proxy (in other words, not a
+      # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+      # requests when it receives them.
+      # 
+      # The default is false.
+  "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+      # backend, either NONE or PROXY_V1. The default
+      # is NONE.
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+      # This field is not applicable to global TCP proxy.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "service": "A String", # URL to the BackendService 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of TargetTcpProxy resources
+available to 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.
+  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 TargetTcpProxy resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetTcpProxy resources.
+    { # Represents a Target TCP Proxy resource.
+        #
+        # A target TCP proxy is a component of a Proxy Network Load Balancer.
+        # The forwarding rule references the target TCP proxy, and the target proxy
+        # then references a backend service. For more information, readProxy Network
+        # Load Balancer 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.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetTcpProxy", # Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.
+      "loadBalancingScheme": "A String", # Specifies the type of load balancing scheme used by this target proxy.
+      "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.
+      "proxyBind": True or False, # This field only applies when the forwarding rule that references this
+          # target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          #
+          # When this field is set to true, Envoy proxies set up inbound
+          # traffic interception and bind to the IP address and port specified in the
+          # forwarding rule. This is generally useful when using Traffic Director to
+          # configure Envoy as a gateway or middle proxy (in other words, not a
+          # sidecar proxy). The Envoy proxy listens for inbound requests and handles
+          # requests when it receives them.
+          #
+          # The default is false.
+      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the
+          # backend, either NONE or PROXY_V1. The default
+          # is NONE.
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional TCP proxy resides.
+          # This field is not applicable to global TCP proxy.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "service": "A String", # URL to the BackendService resource.
+    },
+  ],
+  "kind": "compute#targetTcpProxyList", # 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.
+  "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.
+
+
+ +
+ setBackendService(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the BackendService for TargetTcpProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy resource whose BackendService resource
+is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "service": "A String", # The URL of the new BackendService resource for the targetTcpProxy.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ setProxyHeader(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None) + 
Changes the ProxyHeaderType for TargetTcpProxy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  targetTcpProxy: string, Name of the TargetTcpProxy resource whose ProxyHeader is to be set. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "proxyHeader": "A String", # The new type of proxy header to append before sending data to the
+      # backend.  NONE or PROXY_V1 are allowed.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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_preview.targetVpnGateways.html b/docs/dyn/compute_preview.targetVpnGateways.html new file mode 100644 index 0000000000..0f6cb5dcfb --- /dev/null +++ b/docs/dyn/compute_preview.targetVpnGateways.html @@ -0,0 +1,1675 @@ + + + +

Compute Engine API . targetVpnGateways

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of target VPN gateways.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, targetVpnGateway, requestId=None, x__xgafv=None)

+

Deletes the specified target VPN gateway.

+

+ get(project, region, targetVpnGateway, x__xgafv=None)

+

Returns the specified target VPN gateway.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a target VPN gateway in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of target VPN gateways available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of target VPN gateways.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of TargetVpnGateway resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of target VPN gateways.
+      "targetVpnGateways": [ # [Output Only] A list of target VPN gateways contained in this scope.
+        { # Represents a Target VPN Gateway resource.
+            #
+            # The target VPN gateway resource represents a Classic Cloud VPN gateway.
+            # For more information, read thethe
+            # Cloud VPN 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.
+          "forwardingRules": [ # [Output Only] A list of URLs to the ForwardingRule resources.
+              # ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN
+              # gateway.
+            "A String",
+          ],
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#targetVpnGateway", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this TargetVpnGateway, which
+              # is essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a TargetVpnGateway.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "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.
+          "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.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "status": "A String", # [Output Only] The status of the VPN gateway,
+              # which can be one of the following: CREATING, READY, FAILED, or DELETING.
+          "tunnels": [ # [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are
+              # created using the compute.vpntunnels.insert method and
+              # associated with a VPN gateway.
+            "A String",
+          ],
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of addresses
+          # 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#targetVpnGatewayAggregatedList", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+  "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, targetVpnGateway, requestId=None, x__xgafv=None) + 
Deletes the specified target VPN gateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  targetVpnGateway: string, Name of the target VPN gateway 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, targetVpnGateway, x__xgafv=None) + 
Returns the specified target VPN gateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  targetVpnGateway: string, Name of the target VPN gateway 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 Target VPN Gateway resource.
+    #
+    # The target VPN gateway resource represents a Classic Cloud VPN gateway.
+    # For more information, read thethe
+    # Cloud VPN 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.
+  "forwardingRules": [ # [Output Only] A list of URLs to the ForwardingRule resources.
+      # ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN
+      # gateway.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetVpnGateway", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this TargetVpnGateway, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a TargetVpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the VPN gateway,
+      # which can be one of the following: CREATING, READY, FAILED, or DELETING.
+  "tunnels": [ # [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are
+      # created using the compute.vpntunnels.insert method and
+      # associated with a VPN gateway.
+    "A String",
+  ],
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a target VPN gateway in the specified project and region using
+the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Target VPN Gateway resource.
+    # 
+    # The target VPN gateway resource represents a Classic Cloud VPN gateway.
+    # For more information, read thethe
+    # Cloud VPN 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.
+  "forwardingRules": [ # [Output Only] A list of URLs to the ForwardingRule resources.
+      # ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN
+      # gateway.
+    "A String",
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#targetVpnGateway", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this TargetVpnGateway, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a TargetVpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] The status of the VPN gateway,
+      # which can be one of the following: CREATING, READY, FAILED, or DELETING.
+  "tunnels": [ # [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are
+      # created using the compute.vpntunnels.insert method and
+      # associated with a VPN gateway.
+    "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of target VPN gateways available to the specified
+project and region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 TargetVpnGateway resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of TargetVpnGateway resources.
+    { # Represents a Target VPN Gateway resource.
+        #
+        # The target VPN gateway resource represents a Classic Cloud VPN gateway.
+        # For more information, read thethe
+        # Cloud VPN 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.
+      "forwardingRules": [ # [Output Only] A list of URLs to the ForwardingRule resources.
+          # ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN
+          # gateway.
+        "A String",
+      ],
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#targetVpnGateway", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this TargetVpnGateway, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a TargetVpnGateway.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "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.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] The status of the VPN gateway,
+          # which can be one of the following: CREATING, READY, FAILED, or DELETING.
+      "tunnels": [ # [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are
+          # created using the compute.vpntunnels.insert method and
+          # associated with a VPN gateway.
+        "A String",
+      ],
+    },
+  ],
+  "kind": "compute#targetVpnGatewayList", # Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.
+  "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.
+  "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.
+
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.urlMaps.html b/docs/dyn/compute_preview.urlMaps.html new file mode 100644 index 0000000000..0bcf388f72 --- /dev/null +++ b/docs/dyn/compute_preview.urlMaps.html @@ -0,0 +1,27755 @@ + + + +

Compute Engine API . urlMaps

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all UrlMap resources, regional and global,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, urlMap, requestId=None, x__xgafv=None)

+

Deletes the specified UrlMap resource.

+

+ get(project, urlMap, x__xgafv=None)

+

Returns the specified UrlMap resource.

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a UrlMap resource in the specified project using

+

+ invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None)

+

Initiates a cache invalidation operation, invalidating the specified path,

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of UrlMap resources available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, urlMap, body=None, requestId=None, x__xgafv=None)

+

Patches the specified UrlMap resource with the data included in the

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

+ update(project, urlMap, body=None, requestId=None, x__xgafv=None)

+

Updates the specified UrlMap resource with the data included in the

+

+ validate(project, urlMap, body=None, x__xgafv=None)

+

Runs static validation for the UrlMap. In particular, the tests of the

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all UrlMap resources, regional and global,
+available to the specified project.
+
+To prevent failure, Google recommends 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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of UrlMapsScopedList resources.
+    "a_key": { # Name of the scope containing this set of UrlMaps.
+      "urlMaps": [ # A list of UrlMaps contained in this scope.
+        { # Represents a URL Map resource.
+            #
+            # Compute Engine has two URL Map resources:
+            #
+            # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+            # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+            #
+            # A URL map resource is a component of certain types of cloud load balancers
+            # and Traffic Director:
+            #
+            # * urlMaps are used by global external Application Load
+            # Balancers, classic Application Load Balancers, and cross-region internal
+            # Application Load Balancers.
+            # * regionUrlMaps are used by internal Application Load Balancers,
+            # regional external Application Load Balancers and regional internal
+            # Application Load Balancers.
+            #
+            # For a list of supported URL map features by the load balancer type, see the
+            # Load balancing features: Routing and traffic management table.
+            #
+            # For a list of supported URL map features for Traffic Director, see the
+            # Traffic Director features: Routing and traffic management table.
+            #
+            # This resource defines mappings from hostnames and URL paths to either a
+            # backend service or a backend bucket.
+            #
+            # To use the global urlMaps resource, the backend service must
+            # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+            # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+            # information, read URL
+            # Map Concepts.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # This policy takes
+              # effect at the load balancer level and applies only when no policy has been
+              # defined for the error code at lower levels like PathMatcher, RouteRule and
+              # PathRule within this UrlMap.
+              #
+              # For example, consider a UrlMap with the
+              # following configuration:
+              #
+              #
+              #      - defaultCustomErrorResponsePolicy containing policies for
+              #      responding to 5xx and 4xx errors
+              #      - A PathMatcher configured for *.example.com has
+              #      defaultCustomErrorResponsePolicy for 4xx.
+              #
+              # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+              # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+              # a request that does not match any host in *.example.com such
+              # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+              # takes effect.
+              #
+              # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+              # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the defaultCustomErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # defaultCustomErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+              # hostRules match. The load balancer performs advanced routing
+              # actions, such as URL rewrites and header transformations, before forwarding
+              # the request to the selected backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              #  URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within defaultRouteAction.
+              #
+              #
+              # defaultRouteAction has no effect when the URL map is bound
+              # to a target gRPC proxy that has the validateForProxyless field
+              # set to true.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "defaultService": "A String", # The full or partial URL of the defaultService resource to
+              # which traffic is directed if none of the hostRules match.
+              # If defaultRouteAction is also specified, advanced
+              # routing actions, such as URL rewrites, take effect before sending the
+              # request to the backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # defaultService has no effect when the URL map is bound
+              # to a target gRPC proxy that has the validateForProxyless field
+              # set to true.
+          "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+              # is redirected to a URL specified by defaultUrlRedirect.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+          "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 is ignored when
+              # inserting a UrlMap. An up-to-date fingerprint must be provided
+              # in order to update the UrlMap, otherwise the request will
+              # fail with error 412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a UrlMap.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+              #
+              # headerAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "hostRules": [ # The list of host rules to use against the URL.
+            { # UrlMaps
+                # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+                  # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+                  # that case, * must be the first character, and if followed by
+                  # anything, the immediate following character must be either -
+                  # or ..
+                  #
+                  # * based matching is not supported when the URL map is bound
+                  # to a target gRPC proxy that has the validateForProxyless field
+                  # set to true.
+                "A String",
+              ],
+              "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+                  # of the URL if the hostRule matches the URL's host portion.
+            },
+          ],
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+              # url maps.
+          "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.
+          "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+            { # A matcher for the path portion of the URL. The BackendService
+                # from the longest-matched rule will serve the URL. If no rule was matched, the
+                # default service is used.
+              "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+                  # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                  #
+                  # This policy takes
+                  # effect at the PathMatcher level and applies only when no
+                  # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+                  # in defaultCustomErrorResponsePolicy, then a policy defined for
+                  # the error code in UrlMap.defaultCustomErrorResponsePolicy
+                  # takes effect.
+                  #
+                  # For example, consider a UrlMap with the following
+                  # configuration:
+                  #
+                  #
+                  #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+                  #      with policies for 5xx and 4xx errors
+                  #      - A RouteRule for /coming_soon/ is configured for the
+                  #      error code 404.
+                  #
+                  # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                  # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                  # the policy in RouteRule.customErrorResponsePolicy takes
+                  # effect. If any of the requests in this example encounter a 500
+                  # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                  #
+                  # When
+                  # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+                  # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+                  # a retry, if load balancer is successful in reaching the
+                  # service, the defaultCustomErrorResponsePolicy is ignored and
+                  # the response from the service is returned to the client.
+                  #
+                  # defaultCustomErrorResponsePolicy is supported only for
+                  # global external Application Load Balancers.
+                  # backend service or backend bucket responds with an error.
+                "errorResponseRules": [ # Specifies rules for returning error responses.
+                    #
+                    # In a given policy, if you specify rules for both a range of error codes
+                    # as well as rules for specific error codes then rules with specific error
+                    # codes have a higher priority. For example, assume that you configure a rule
+                    # for 401 (Un-authorized) code, and another for all 4 series
+                    # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                    # However if the backend service returns a 403, the rule for4xx takes effect.
+                  { # Specifies the mapping between the response code that will be returned along
+                      # with the custom error content and the response code returned by the backend
+                      # service.
+                    "matchResponseCodes": [ # Valid values include:
+                        #
+                        #
+                        #      - A number between 400 and 599: For example
+                        #      401 or 503, in which case the load balancer
+                        #      applies the policy if the error code exactly matches this value.
+                        #      - 5xx: Load Balancer will apply the policy if the
+                        #      backend service responds with any response code in the range of
+                        #      500 to 599.
+                        #    - 4xx: Load
+                        #      Balancer will apply the policy if the backend service responds with any
+                        #      response code in the range of 400 to
+                        #      499.
+                        #
+                        # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                      "A String",
+                    ],
+                    "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                        # error content. If overrideResponseCode is not supplied, the
+                        # same response code returned by the original backend bucket or backend
+                        # service is returned to the client.
+                    "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                        #
+                        # path must start
+                        # with a leading slash. path cannot have trailing slashes.
+                        #
+                        # If the file is not available in backendBucket  or the
+                        # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                        #
+                        # The value must
+                        # be from 1 to 1024 characters
+                  },
+                ],
+                "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                    # contains the custom error content. Examples are:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - global/backendBuckets/myBackendBucket
+                    #
+                    # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                    # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                    #
+                    # If load balancer cannot reach
+                    # the backendBucket, a simple Not Found Error will
+                    # be returned, with the original response code (oroverrideResponseCode if configured).
+                    #
+                    # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+              },
+              "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+                  # pathRules or routeRules match. The load balancer
+                  # performs advanced routing actions, such as URL rewrites and
+                  # header transformations, before forwarding the request to the
+                  # selected backend.
+                  #
+                  #
+                  # Only one of defaultUrlRedirect, defaultService
+                  # or defaultRouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # URL maps for classic Application Load Balancers only support
+                  # the urlRewrite action within a path matcher'sdefaultRouteAction.
+                "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                    # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                    # property must be specified. This policy cannot be specified if any target
+                    # backend has Identity-Aware Proxy enabled.
+                  "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                      # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                      # header names can be specified. The cache is bypassed for all `cacheMode`
+                      # values.
+                    "A String",
+                  ],
+                  "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                      # on the backend type: for Backend Services, the complete request URI is
+                      # used; for Backend Buckets, the request URI is used without the protocol or
+                      # host, and only query parameters known to Cloud Storage are included.
+                      # Policy defined on Route Action.
+                    "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                        # parameters will be included. Either specify `excludedQueryParameters`
+                        # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                      "A String",
+                    ],
+                    "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # host is never included in a Backend Bucket's cache key. Attempting to set
+                        # it on a route that points exclusively to Backend Buckets will result in a
+                        # configuration error.
+                    "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # protocol is never included in a Backend Bucket's cache key. Attempting to
+                        # set on a route that points exclusively to Backend Buckets will result in
+                        # a configuration error.
+                    "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                        # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                        # is set, the entire query string will be included. If false, the query
+                        # string will be excluded from the cache key entirely.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                    "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                        # The name=value pair will be used in the cache key Cloud CDN generates.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket.
+                        # Attempting to set it on a route that points exclusively to Backend
+                        # Buckets will result in a configuration error. Up to 5 cookie names can be
+                        # specified.
+                      "A String",
+                    ],
+                    "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                      "A String",
+                    ],
+                    "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                        # parameters will be excluded. Either specify `includedQueryParameters`
+                        # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                      "A String",
+                    ],
+                  },
+                  "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                      # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                  "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                      # content. This is used to clamp the max-age (or Expires) value sent to the
+                      # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                      # is used for the response max-age directive, along with a "public"
+                      # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                      # clamps the max-age from the origin (if specified), or else sets the
+                      # response max-age directive to the lesser of the `clientTtl` and
+                      # `defaultTtl`, and also ensures a "public" cache-control directive is
+                      # present. The maximum allowed value is 31,622,400s (1 year). If not
+                      # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                      # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                      # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                      # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                      # greater than that of `maxTtl`. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                      # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                      # accessed objects may be evicted from the cache before the defined TTL. If
+                      # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                      # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                      # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                      # more than `maxTtl` seconds in the future will be capped at the value of
+                      # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                      # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                      # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                      # Infrequently accessed objects may be evicted from the cache before the
+                      # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                      # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                      # mode.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                      # to apply fine-grained caching for common errors or redirects.
+                      # This can reduce the load on your origin and improve end-user
+                      # experience by reducing response latency.
+                      # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                      # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                      # the specified response code that lack any Cache-Control, Expires, or
+                      # Pragma: no-cache directives. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                      # with the specified response code, and overrides any caching headers. By
+                      # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                      #
+                      # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                      # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                      # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                      #
+                      # These defaults can be overridden in `negativeCachingPolicy`.
+                      # If not specified, Cloud CDN applies negative caching by default.
+                  "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                      # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                      # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                      # CDN's default cache TTLs. Note that when specifying an explicit
+                      # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                      # all response codes that you wish to cache. Cloud CDN will not apply any
+                      # default negative caching when a policy exists.
+                    { # Specify CDN TTLs for response error codes.
+                      "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                          # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                          # specified as values, and you cannot specify a status code more than
+                          # once.
+                      "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                          # corresponding status code.
+                          # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                          # objects may be evicted from the cache before the defined TTL.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                  ],
+                  "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                      # requests into a small number of requests to the origin. If not specified,
+                      # Cloud CDN applies request coalescing by default.
+                  "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                      # content with the origin, or when an error is encountered when refreshing
+                      # the cache.
+                      # This setting defines the default "max-stale" duration for any cached
+                      # responses that do not specify a max-stale directive. Stale responses that
+                      # exceed the TTL configured here will not be served. The default limit
+                      # (max-stale) is 86400s (1 day), which will allow stale content to be
+                      # served up to this limit beyond the max-age (or s-maxage) of a cached
+                      # response.
+                      # The maximum allowed value is 604800 (1 week).
+                      # Set this to zero (0) to disable serve-while-stale.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+                "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                  "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                      # indicates that
+                      # the actual request can include user credentials. This field translates to
+                      # the Access-Control-Allow-Credentials header.
+                      #
+                      # Default is false.
+                  "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                      # header.
+                    "A String",
+                  ],
+                  "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                      # more information, see regular expression syntax.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED.
+                    "A String",
+                  ],
+                  "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    "A String",
+                  ],
+                  "disabled": True or False, # If true, disables the CORS policy.
+                      # The default value is false, which indicates that the CORS
+                      # policy is in effect.
+                  "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                      # seconds. This field translates to the Access-Control-Max-Age
+                      # header.
+                },
+                "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by a load balancer on a percentage of requests before sending
+                    # those requests to the backend service. Similarly requests from clients can
+                    # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                    # that are configured with a fault_injection_policy if:
+                    # 1. The traffic is generated by fault injection AND
+                    # 2. The fault injection is not a delay fault injection.
+                    # Fault injection is not supported with the classic Application Load Balancer
+                    # . To see which load balancers support fault injection,
+                    # see Load
+                    # balancing: Routing and traffic management features.
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by the load balancer on a percentage of requests before sending
+                    # those request to the backend service. Similarly requests from clients can be
+                    # aborted by the load balancer for a percentage of requests.
+                  "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                      # injection.
+                    "httpStatus": 42, # The HTTP status code used to abort the request.
+                        #
+                        # The value must be from 200 to 599 inclusive.
+                        #
+                        # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                        # according to this
+                        # mapping table. HTTP status 200 is mapped to gRPC status
+                        # UNKNOWN. Injecting an OK status is currently not supported by
+                        # Traffic Director.
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                        # that is aborted as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                  "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                      # injection, before being sent to a backend service.
+                      # request to the backend service as part of fault injection.
+                    "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                        # which a delay is introduced as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                },
+                "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                    # Unlike the timeout field where the timeout duration starts
+                    # from the time the request has been fully processed (known as*end-of-stream*),
+                    # the duration in this field is computed from the beginning of the stream
+                    # until the response has been processed, including all retries. A
+                    # stream that does not complete in this duration is closed.
+                    #
+                    # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                    # with the route.
+                    #
+                    # This field is only allowed if the Url map is used with backend services
+                    # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                    # are shadowed to a separate mirrored backend service. The load balancer does
+                    # not wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host / authority header is suffixed with-shadow.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # are shadowed to a separate mirrored backend service. The load balancer
+                    # doesn't wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host or authority header is suffixed with-shadow.
+                  "backendService": "A String", # The full or partial URL to the BackendService resource being
+                      # mirrored to.
+                      #
+                      # The backend service configured for a mirroring
+                      # policy must reference backends that are of the same type as the original
+                      # backend service matched in the URL map.
+                      #
+                      # Serverless NEG backends are not currently supported as a mirrored
+                      # backend service.
+                  "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                },
+                "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                  "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                      # If not specified, defaults to 1.
+                  "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                      #
+                      # If not specified, will use the timeout set in theHttpRouteAction field.
+                      # If timeout in the HttpRouteAction field is not set, this field
+                      # uses the largest timeout
+                      # among all backend services associated with the route.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has the validateForProxyless field set to true.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                      # values are:
+                      #
+                      #    - 5xx: retry is attempted if the instance or endpoint
+                      #    responds with any 5xx response code, or if the instance or
+                      #    endpoint does not respond at all. For example, disconnects, reset, read
+                      #    timeout, connection failure, and refused streams.
+                      #    - gateway-error: Similar to 5xx, but only
+                      #    applies to response codes 502, 503 or504.
+                      #    - connect-failure: a retry is attempted on failures
+                      #    connecting to the instance or endpoint. For example, connection
+                      #    timeouts.
+                      #    - retriable-4xx: a retry is attempted if the instance
+                      #    or endpoint responds with a 4xx response code.
+                      #    The only error that you can retry is error code 409.
+                      #    - refused-stream: a retry is attempted if the instance
+                      #    or endpoint resets the stream with a REFUSED_STREAM error
+                      #    code. This reset type indicates that it is safe to retry.
+                      #    - cancelled: a retry is attempted if the gRPC status
+                      #    code in the response header is set to cancelled.
+                      #    - deadline-exceeded: a retry is attempted if the gRPC
+                      #    status code in the response header is set todeadline-exceeded.
+                      #    - internal: a retry is attempted if the gRPC
+                      #    status code in the response header is set tointernal.
+                      #    - resource-exhausted: a retry is attempted if the gRPC
+                      #    status code in the response header is set toresource-exhausted.
+                      #    - unavailable: a retry is attempted if the gRPC
+                      #    status code in the response header is set tounavailable.
+                      #
+                      # Only the following codes are supported when the URL map is bound to
+                      # target gRPC proxy that has validateForProxyless field set to true.
+                      #
+                      #    - cancelled
+                      #    - deadline-exceeded
+                      #    - internal
+                      #    - resource-exhausted
+                      #    - unavailable
+                    "A String",
+                  ],
+                },
+                "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                    # time the request has been fully processed (known as *end-of-stream*)
+                    # up until the response has been processed. Timeout includes
+                    # all retries.
+                    #
+                    # If not specified, this field uses the largest timeout among all backend
+                    # services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                    # to the matched service.
+                    #
+                    #  urlRewrite is the only action supported in UrlMaps
+                    # for classic Application Load Balancers.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # backend service.
+                  "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                      # host header is replaced with contents of hostRewrite.
+                      #
+                      # The value must be from 1 to 255 characters.
+                  "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                      # matching portion of the request's path is replaced bypathPrefixRewrite.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                  "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                      # header) using the HTTP template syntax.
+                      #
+                      # A corresponding
+                      # path_template_match must be specified. Any template variables must exist in
+                      # the path_template_match field.
+                      #
+                      #
+                      #       - -At least one variable must be specified in the path_template_match
+                      #       field
+                      #    - You can omit variables from the rewritten URL
+                      #       - The * and ** operators cannot be matched
+                      #       unless they have a corresponding variable name - e.g.
+                      #       {format=*} or {var=**}.
+                      #
+                      # For example, a path_template_match of /static/{format=**}
+                      # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                      # rewrite, so that /{country}/{format}/{suffix=**} can be
+                      # rewritten as /content/{format}/{country}/{suffix}.
+                      #
+                      # At least
+                      # one non-empty routeRules[].matchRules[].path_template_match is
+                      # required.
+                      #
+                      # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                  "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                    "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                        # It uses RE2 syntax with the following constraints:
+                        #
+                        #
+                        #      - Any single character operators
+                        #      - Groups are allowed to have only submatch operator inside
+                        #      - Groups are allowed only without any char repetition, e.g.
+                        #      .*
+                        #      - Any char repetition, e.g. .*, is
+                        #      only allowed to be used in a single regex together with:
+                        #
+                        #
+                        #             - Empty string operators
+                        #             - Other repetitions
+                        #             - Ranges
+                        #             - Repetitions of ranges
+                        #
+                        #
+                        #      - Ranges are only allowed to have:
+                        #
+                        #
+                        #             - Character range
+                        #             - Digits range
+                        #             - Symbols listed in characters allowed for ranges
+                    "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                        # the path.
+                  },
+                },
+                "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                    # occurs. The weights determine the fraction of traffic that flows to
+                    # their corresponding backend service. If all traffic needs to
+                    # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                    #
+                    # After a backend service is identified and before forwarding
+                    # the request to
+                    # the backend service, advanced routing actions such as URL rewrites and
+                    # header transformations are applied depending on additional settings
+                    # specified in this HttpRouteAction.
+                  { # In contrast to a single BackendService in
+                      # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                      # multiple backend services. The volume of traffic for each
+                      # backend service is proportional to the weight specified
+                      # in each WeightedBackendService
+                    "backendService": "A String", # The full or partial URL to the default BackendService
+                        # resource. Before
+                        # forwarding the request to backendService, the load balancer
+                        # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                        # effect for the selected backendService.
+                        #
+                        # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                        #
+                        # headerAction is not supported for load balancers that have
+                        # their loadBalancingScheme set to EXTERNAL.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # the request is passed along to the selected backendService.
+                      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # request before forwarding the request to the backendService.
+                        "A String",
+                      ],
+                      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                          # client.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # response before sending the response back to the client.
+                        "A String",
+                      ],
+                    },
+                    "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                        # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                        #
+                        # The selection of a backend service is determined only for new traffic.
+                        # Once a user's request has been directed to a backend service,
+                        # subsequent requests are sent to the same backend service as
+                        # determined by the backend service's session affinity policy.
+                        # Don't configure session affinity if you're using weighted traffic
+                        # splitting. If you do, the weighted traffic splitting configuration takes
+                        # precedence.
+                        #
+                        # The value must be from 0 to 1000.
+                  },
+                ],
+              },
+              "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+                  # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+                  # matched. For example, the
+                  # following are all valid URLs to a BackendService resource:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+                  #      - compute/v1/projects/project/global/backendServices/backendService
+                  #      - global/backendServices/backendService
+                  #
+                  #
+                  # If defaultRouteAction is also specified, advanced
+                  # routing actions, such as URL rewrites, take effect before sending the
+                  # request to the backend.
+                  #
+                  #
+                  # Only one of defaultUrlRedirect, defaultService
+                  # or defaultRouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Authorization requires one or more of the following Google IAM permissions on the
+                  # specified resource default_service:
+                  #
+                  #
+                  #       - compute.backendBuckets.use
+                  #       - compute.backendServices.use
+              "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+                  # by defaultUrlRedirect.
+                  #
+                  #
+                  # Only one of defaultUrlRedirect, defaultService
+                  # or defaultRouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                    # was supplied in the request.
+                    #
+                    # The value must be from 1 to 255
+                    # characters.
+                "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                    # set to HTTPS.
+                    # If set to false, the URL scheme of the redirected request
+                    # remains the same as that of the request.
+                    #
+                    # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                    #
+                    # The default is set to false.
+                "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                    # that was supplied in the request.
+                    #
+                    # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                    # the HttpRouteRuleMatch, retaining the remaining portion
+                    # of the URL before redirecting the request.
+                    #
+                    # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                    #
+                    # Supported values are:
+                    #
+                    #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                    #    to 301.
+                    #    - FOUND, which corresponds to 302.
+                    #    - SEE_OTHER which corresponds to 303.
+                    #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                    #    method is retained.
+                    #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                    #    method is retained.
+                "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                    # URL is
+                    # removed before redirecting the request. If set to false, the
+                    # query portion of the original URL is retained.
+                    #
+                    # The default is set to false.
+              },
+              "description": "A String", # An optional description of this resource. Provide this property when you
+                  # create the resource.
+              "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                  # for the selected backend service.
+                  #
+                  # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+                  #
+                  # HeaderAction is not supported for load balancers
+                  # that have
+                  # their loadBalancingScheme set to EXTERNAL.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # the request is passed along to the selected backendService.
+                "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # request before forwarding the request to the backendService.
+                  "A String",
+                ],
+                "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                    # client.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # response before sending the response back to the client.
+                  "A String",
+                ],
+              },
+              "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+              "pathRules": [ # The list of path rules. Use this list instead of routeRules
+                  # when routing based on simple path matching is all that's required. A path
+                  # rule can only include a wildcard character (*) after a
+                  # forward slash character ("/").
+                  #
+                  # The order by which path rules are specified does not matter.
+                  # Matches are always done on the longest-path-first basis.
+                  #
+                  # For example: a pathRule with a path /a/b/c/* will match
+                  # before /a/b/* irrespective of the order in which those paths appear in this
+                  # list.
+                  #
+                  # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+                { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+                  "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                      #
+                      # If a policy for an
+                      # error code is not configured for the PathRule, a policy for
+                      # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                      # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                      # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                      # effect.
+                      #
+                      # For example, consider a UrlMap with the following configuration:
+                      #
+                      #
+                      #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                      #      with policies for 5xx and 4xx errors
+                      #      - A PathRule for /coming_soon/ is configured for the error
+                      #      code 404.
+                      #
+                      # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                      # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                      # the policy in PathRule.customErrorResponsePolicy takes
+                      # effect. If any of the requests in this example encounter a 500
+                      # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                      #
+                      # customErrorResponsePolicy is supported only for
+                      # global external Application Load Balancers.
+                      # backend service or backend bucket responds with an error.
+                    "errorResponseRules": [ # Specifies rules for returning error responses.
+                        #
+                        # In a given policy, if you specify rules for both a range of error codes
+                        # as well as rules for specific error codes then rules with specific error
+                        # codes have a higher priority. For example, assume that you configure a rule
+                        # for 401 (Un-authorized) code, and another for all 4 series
+                        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                        # However if the backend service returns a 403, the rule for4xx takes effect.
+                      { # Specifies the mapping between the response code that will be returned along
+                          # with the custom error content and the response code returned by the backend
+                          # service.
+                        "matchResponseCodes": [ # Valid values include:
+                            #
+                            #
+                            #      - A number between 400 and 599: For example
+                            #      401 or 503, in which case the load balancer
+                            #      applies the policy if the error code exactly matches this value.
+                            #      - 5xx: Load Balancer will apply the policy if the
+                            #      backend service responds with any response code in the range of
+                            #      500 to 599.
+                            #    - 4xx: Load
+                            #      Balancer will apply the policy if the backend service responds with any
+                            #      response code in the range of 400 to
+                            #      499.
+                            #
+                            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                          "A String",
+                        ],
+                        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                            # error content. If overrideResponseCode is not supplied, the
+                            # same response code returned by the original backend bucket or backend
+                            # service is returned to the client.
+                        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                            #
+                            # path must start
+                            # with a leading slash. path cannot have trailing slashes.
+                            #
+                            # If the file is not available in backendBucket  or the
+                            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                            #
+                            # The value must
+                            # be from 1 to 1024 characters
+                      },
+                    ],
+                    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                        # contains the custom error content. Examples are:
+                        #
+                        #
+                        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                        #      - global/backendBuckets/myBackendBucket
+                        #
+                        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                        #
+                        # If load balancer cannot reach
+                        # the backendBucket, a simple Not Found Error will
+                        # be returned, with the original response code (oroverrideResponseCode if configured).
+                        #
+                        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+                  },
+                  "paths": [ # The list of path patterns to match. Each must start with /
+                      # and the only place a * is allowed is at the end following
+                      # a /.  The string fed to the path matcher does not include
+                      # any text after the first ? or #, and
+                      # those chars are not allowed here.
+                    "A String",
+                  ],
+                  "routeAction": { # In response to a matching path, the load balancer
+                      # performs advanced routing actions, such as URL rewrites and header
+                      # transformations, before forwarding the request to the selected
+                      # backend.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                      #
+                      #
+                      # URL maps for classic Application Load Balancers only support
+                      # the urlRewrite action within a path rule'srouteAction.
+                    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                        # property must be specified. This policy cannot be specified if any target
+                        # backend has Identity-Aware Proxy enabled.
+                      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                          # header names can be specified. The cache is bypassed for all `cacheMode`
+                          # values.
+                        "A String",
+                      ],
+                      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                          # on the backend type: for Backend Services, the complete request URI is
+                          # used; for Backend Buckets, the request URI is used without the protocol or
+                          # host, and only query parameters known to Cloud Storage are included.
+                          # Policy defined on Route Action.
+                        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                            # parameters will be included. Either specify `excludedQueryParameters`
+                            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                            # encoded and not treated as delimiters.
+                            #
+                            # Note: This field applies to routes that use backend services. Attempting
+                            # to set it on a route that points exclusively to Backend Buckets will
+                            # result in a configuration error. For routes that point to a Backend
+                            # Bucket, use `includedQueryParameters` to define which parameters should
+                            # be part of the cache key.
+                          "A String",
+                        ],
+                        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket, as the
+                            # host is never included in a Backend Bucket's cache key. Attempting to set
+                            # it on a route that points exclusively to Backend Buckets will result in a
+                            # configuration error.
+                        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket, as the
+                            # protocol is never included in a Backend Bucket's cache key. Attempting to
+                            # set on a route that points exclusively to Backend Buckets will result in
+                            # a configuration error.
+                        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                            # is set, the entire query string will be included. If false, the query
+                            # string will be excluded from the cache key entirely.
+                            #
+                            # Note: This field applies to routes that use backend services. Attempting
+                            # to set it on a route that points exclusively to Backend Buckets will
+                            # result in a configuration error. For routes that point to a Backend
+                            # Bucket, use `includedQueryParameters` to define which parameters should
+                            # be part of the cache key.
+                        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                            # The name=value pair will be used in the cache key Cloud CDN generates.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket.
+                            # Attempting to set it on a route that points exclusively to Backend
+                            # Buckets will result in a configuration error. Up to 5 cookie names can be
+                            # specified.
+                          "A String",
+                        ],
+                        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                          "A String",
+                        ],
+                        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                            # parameters will be excluded. Either specify `includedQueryParameters`
+                            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                            # encoded and not treated as delimiters.
+                          "A String",
+                        ],
+                      },
+                      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                          # content. This is used to clamp the max-age (or Expires) value sent to the
+                          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                          # is used for the response max-age directive, along with a "public"
+                          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                          # clamps the max-age from the origin (if specified), or else sets the
+                          # response max-age directive to the lesser of the `clientTtl` and
+                          # `defaultTtl`, and also ensures a "public" cache-control directive is
+                          # present. The maximum allowed value is 31,622,400s (1 year). If not
+                          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                          # `USE_ORIGIN_HEADERS`.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                          # greater than that of `maxTtl`. When the `cacheMode` is set to
+                          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                          # accessed objects may be evicted from the cache before the defined TTL. If
+                          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                          # `USE_ORIGIN_HEADERS`.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                          # more than `maxTtl` seconds in the future will be capped at the value of
+                          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                          # Infrequently accessed objects may be evicted from the cache before the
+                          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                          # mode.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                          # to apply fine-grained caching for common errors or redirects.
+                          # This can reduce the load on your origin and improve end-user
+                          # experience by reducing response latency.
+                          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                          # the specified response code that lack any Cache-Control, Expires, or
+                          # Pragma: no-cache directives. When the `cacheMode` is set to
+                          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                          # with the specified response code, and overrides any caching headers. By
+                          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                          #
+                          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                          #
+                          # These defaults can be overridden in `negativeCachingPolicy`.
+                          # If not specified, Cloud CDN applies negative caching by default.
+                      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                          # CDN's default cache TTLs. Note that when specifying an explicit
+                          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                          # all response codes that you wish to cache. Cloud CDN will not apply any
+                          # default negative caching when a policy exists.
+                        { # Specify CDN TTLs for response error codes.
+                          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                              # specified as values, and you cannot specify a status code more than
+                              # once.
+                          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                              # corresponding status code.
+                              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                              # objects may be evicted from the cache before the defined TTL.
+                              # as a count of seconds and fractions of seconds at nanosecond
+                              # resolution. It is independent of any calendar and concepts like "day"
+                              # or "month". Range is approximately 10,000 years.
+                            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                                # Durations less than one second are represented with a 0
+                                # `seconds` field and a positive `nanos` field. Must be from 0
+                                # to 999,999,999 inclusive.
+                            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                                # 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
+                          },
+                        },
+                      ],
+                      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                          # requests into a small number of requests to the origin. If not specified,
+                          # Cloud CDN applies request coalescing by default.
+                      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                          # content with the origin, or when an error is encountered when refreshing
+                          # the cache.
+                          # This setting defines the default "max-stale" duration for any cached
+                          # responses that do not specify a max-stale directive. Stale responses that
+                          # exceed the TTL configured here will not be served. The default limit
+                          # (max-stale) is 86400s (1 day), which will allow stale content to be
+                          # served up to this limit beyond the max-age (or s-maxage) of a cached
+                          # response.
+                          # The maximum allowed value is 604800 (1 week).
+                          # Set this to zero (0) to disable serve-while-stale.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                        # information about the W3C recommendation for cross-origin resource sharing
+                        # (CORS), see Fetch API Living
+                        # Standard.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy.
+                        # information about the W3C recommendation for cross-origin resource sharing
+                        # (CORS), see Fetch API Living
+                        # Standard.
+                      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                          # indicates that
+                          # the actual request can include user credentials. This field translates to
+                          # the Access-Control-Allow-Credentials header.
+                          #
+                          # Default is false.
+                      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                          # header.
+                        "A String",
+                      ],
+                      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                          # header.
+                        "A String",
+                      ],
+                      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                          # more information, see regular expression syntax.
+                          #
+                          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED.
+                        "A String",
+                      ],
+                      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                          #
+                          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                        "A String",
+                      ],
+                      "disabled": True or False, # If true, disables the CORS policy.
+                          # The default value is false, which indicates that the CORS
+                          # policy is in effect.
+                      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                          # header.
+                        "A String",
+                      ],
+                      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                          # seconds. This field translates to the Access-Control-Max-Age
+                          # header.
+                    },
+                    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                        # the resiliency of clients to backend service failure. As part of fault
+                        # injection, when clients send requests to a backend service, delays can be
+                        # introduced by a load balancer on a percentage of requests before sending
+                        # those requests to the backend service. Similarly requests from clients can
+                        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                        # that are configured with a fault_injection_policy if:
+                        # 1. The traffic is generated by fault injection AND
+                        # 2. The fault injection is not a delay fault injection.
+                        # Fault injection is not supported with the classic Application Load Balancer
+                        # . To see which load balancers support fault injection,
+                        # see Load
+                        # balancing: Routing and traffic management features.
+                        # the resiliency of clients to backend service failure. As part of fault
+                        # injection, when clients send requests to a backend service, delays can be
+                        # introduced by the load balancer on a percentage of requests before sending
+                        # those request to the backend service. Similarly requests from clients can be
+                        # aborted by the load balancer for a percentage of requests.
+                      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                          # injection.
+                        "httpStatus": 42, # The HTTP status code used to abort the request.
+                            #
+                            # The value must be from 200 to 599 inclusive.
+                            #
+                            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                            # according to this
+                            # mapping table. HTTP status 200 is mapped to gRPC status
+                            # UNKNOWN. Injecting an OK status is currently not supported by
+                            # Traffic Director.
+                        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                            # that is aborted as part of fault injection.
+                            #
+                            # The value must be from 0.0 to 100.0 inclusive.
+                      },
+                      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                          # injection, before being sent to a backend service.
+                          # request to the backend service as part of fault injection.
+                        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                            # as a count of seconds and fractions of seconds at nanosecond
+                            # resolution. It is independent of any calendar and concepts like "day"
+                            # or "month". Range is approximately 10,000 years.
+                          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                              # Durations less than one second are represented with a 0
+                              # `seconds` field and a positive `nanos` field. Must be from 0
+                              # to 999,999,999 inclusive.
+                          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                              # 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
+                        },
+                        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                            # which a delay is introduced as part of fault injection.
+                            #
+                            # The value must be from 0.0 to 100.0 inclusive.
+                      },
+                    },
+                    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                        # Unlike the timeout field where the timeout duration starts
+                        # from the time the request has been fully processed (known as*end-of-stream*),
+                        # the duration in this field is computed from the beginning of the stream
+                        # until the response has been processed, including all retries. A
+                        # stream that does not complete in this duration is closed.
+                        #
+                        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                        # with the route.
+                        #
+                        # This field is only allowed if the Url map is used with backend services
+                        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                        # are shadowed to a separate mirrored backend service. The load balancer does
+                        # not wait for responses from the shadow service. Before sending traffic
+                        # to the shadow service, the host / authority header is suffixed with-shadow.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has the validateForProxyless field set to true.
+                        # are shadowed to a separate mirrored backend service. The load balancer
+                        # doesn't wait for responses from the shadow service. Before sending traffic
+                        # to the shadow service, the host or authority header is suffixed with-shadow.
+                      "backendService": "A String", # The full or partial URL to the BackendService resource being
+                          # mirrored to.
+                          #
+                          # The backend service configured for a mirroring
+                          # policy must reference backends that are of the same type as the original
+                          # backend service matched in the URL map.
+                          #
+                          # Serverless NEG backends are not currently supported as a mirrored
+                          # backend service.
+                      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                    },
+                    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                          # If not specified, defaults to 1.
+                      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                          #
+                          # If not specified, will use the timeout set in theHttpRouteAction field.
+                          # If timeout in the HttpRouteAction field is not set, this field
+                          # uses the largest timeout
+                          # among all backend services associated with the route.
+                          #
+                          # Not supported when the URL map is bound to a target gRPC proxy that
+                          # has the validateForProxyless field set to true.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                          # values are:
+                          #
+                          #    - 5xx: retry is attempted if the instance or endpoint
+                          #    responds with any 5xx response code, or if the instance or
+                          #    endpoint does not respond at all. For example, disconnects, reset, read
+                          #    timeout, connection failure, and refused streams.
+                          #    - gateway-error: Similar to 5xx, but only
+                          #    applies to response codes 502, 503 or504.
+                          #    - connect-failure: a retry is attempted on failures
+                          #    connecting to the instance or endpoint. For example, connection
+                          #    timeouts.
+                          #    - retriable-4xx: a retry is attempted if the instance
+                          #    or endpoint responds with a 4xx response code.
+                          #    The only error that you can retry is error code 409.
+                          #    - refused-stream: a retry is attempted if the instance
+                          #    or endpoint resets the stream with a REFUSED_STREAM error
+                          #    code. This reset type indicates that it is safe to retry.
+                          #    - cancelled: a retry is attempted if the gRPC status
+                          #    code in the response header is set to cancelled.
+                          #    - deadline-exceeded: a retry is attempted if the gRPC
+                          #    status code in the response header is set todeadline-exceeded.
+                          #    - internal: a retry is attempted if the gRPC
+                          #    status code in the response header is set tointernal.
+                          #    - resource-exhausted: a retry is attempted if the gRPC
+                          #    status code in the response header is set toresource-exhausted.
+                          #    - unavailable: a retry is attempted if the gRPC
+                          #    status code in the response header is set tounavailable.
+                          #
+                          # Only the following codes are supported when the URL map is bound to
+                          # target gRPC proxy that has validateForProxyless field set to true.
+                          #
+                          #    - cancelled
+                          #    - deadline-exceeded
+                          #    - internal
+                          #    - resource-exhausted
+                          #    - unavailable
+                        "A String",
+                      ],
+                    },
+                    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                        # time the request has been fully processed (known as *end-of-stream*)
+                        # up until the response has been processed. Timeout includes
+                        # all retries.
+                        #
+                        # If not specified, this field uses the largest timeout among all backend
+                        # services associated with the route.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                        # to the matched service.
+                        #
+                        #  urlRewrite is the only action supported in UrlMaps
+                        # for classic Application Load Balancers.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has the validateForProxyless field set to true.
+                        # backend service.
+                      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                          # host header is replaced with contents of hostRewrite.
+                          #
+                          # The value must be from 1 to 255 characters.
+                      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                          # matching portion of the request's path is replaced bypathPrefixRewrite.
+                          #
+                          # The value must be from 1 to 1024 characters.
+                      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                          # header) using the HTTP template syntax.
+                          #
+                          # A corresponding
+                          # path_template_match must be specified. Any template variables must exist in
+                          # the path_template_match field.
+                          #
+                          #
+                          #       - -At least one variable must be specified in the path_template_match
+                          #       field
+                          #    - You can omit variables from the rewritten URL
+                          #       - The * and ** operators cannot be matched
+                          #       unless they have a corresponding variable name - e.g.
+                          #       {format=*} or {var=**}.
+                          #
+                          # For example, a path_template_match of /static/{format=**}
+                          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                          # rewrite, so that /{country}/{format}/{suffix=**} can be
+                          # rewritten as /content/{format}/{country}/{suffix}.
+                          #
+                          # At least
+                          # one non-empty routeRules[].matchRules[].path_template_match is
+                          # required.
+                          #
+                          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                            # It uses RE2 syntax with the following constraints:
+                            #
+                            #
+                            #      - Any single character operators
+                            #      - Groups are allowed to have only submatch operator inside
+                            #      - Groups are allowed only without any char repetition, e.g.
+                            #      .*
+                            #      - Any char repetition, e.g. .*, is
+                            #      only allowed to be used in a single regex together with:
+                            #
+                            #
+                            #             - Empty string operators
+                            #             - Other repetitions
+                            #             - Ranges
+                            #             - Repetitions of ranges
+                            #
+                            #
+                            #      - Ranges are only allowed to have:
+                            #
+                            #
+                            #             - Character range
+                            #             - Digits range
+                            #             - Symbols listed in characters allowed for ranges
+                        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                            # the path.
+                      },
+                    },
+                    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                        # occurs. The weights determine the fraction of traffic that flows to
+                        # their corresponding backend service. If all traffic needs to
+                        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                        #
+                        # After a backend service is identified and before forwarding
+                        # the request to
+                        # the backend service, advanced routing actions such as URL rewrites and
+                        # header transformations are applied depending on additional settings
+                        # specified in this HttpRouteAction.
+                      { # In contrast to a single BackendService in
+                          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                          # multiple backend services. The volume of traffic for each
+                          # backend service is proportional to the weight specified
+                          # in each WeightedBackendService
+                        "backendService": "A String", # The full or partial URL to the default BackendService
+                            # resource. Before
+                            # forwarding the request to backendService, the load balancer
+                            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                            # effect for the selected backendService.
+                            #
+                            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                            #
+                            # headerAction is not supported for load balancers that have
+                            # their loadBalancingScheme set to EXTERNAL.
+                            #
+                            # Not supported when the URL map is bound to a target gRPC proxy that
+                            # has validateForProxyless field set to true.
+                            # the request is passed along to the selected backendService.
+                          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                            { # Specification determining how headers are added to requests or responses.
+                              "headerName": "A String", # The name of the header.
+                              "headerValue": "A String", # The value of the header to add.
+                              "replace": True or False, # If false, headerValue is appended to any values
+                                  # that already
+                                  # exist for the header. If true, headerValue is set for the
+                                  # header, discarding any values that were set for that header.
+                                  #
+                                  # The default value is true,
+                                  # unless a variable is present in headerValue,
+                                  # in which case the default value is false.
+                                  # .
+                            },
+                          ],
+                          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                              # request before forwarding the request to the backendService.
+                            "A String",
+                          ],
+                          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                              # client.
+                            { # Specification determining how headers are added to requests or responses.
+                              "headerName": "A String", # The name of the header.
+                              "headerValue": "A String", # The value of the header to add.
+                              "replace": True or False, # If false, headerValue is appended to any values
+                                  # that already
+                                  # exist for the header. If true, headerValue is set for the
+                                  # header, discarding any values that were set for that header.
+                                  #
+                                  # The default value is true,
+                                  # unless a variable is present in headerValue,
+                                  # in which case the default value is false.
+                                  # .
+                            },
+                          ],
+                          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                              # response before sending the response back to the client.
+                            "A String",
+                          ],
+                        },
+                        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                            #
+                            # The selection of a backend service is determined only for new traffic.
+                            # Once a user's request has been directed to a backend service,
+                            # subsequent requests are sent to the same backend service as
+                            # determined by the backend service's session affinity policy.
+                            # Don't configure session affinity if you're using weighted traffic
+                            # splitting. If you do, the weighted traffic splitting configuration takes
+                            # precedence.
+                            #
+                            # The value must be from 0 to 1000.
+                      },
+                    ],
+                  },
+                  "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                      # is directed if this rule is matched. If routeAction is
+                      # also specified, advanced routing actions, such as URL rewrites,
+                      # take effect before sending the request to the backend.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+                      # specified by urlRedirect.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                      #
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                        # was supplied in the request.
+                        #
+                        # The value must be from 1 to 255
+                        # characters.
+                    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                        # set to HTTPS.
+                        # If set to false, the URL scheme of the redirected request
+                        # remains the same as that of the request.
+                        #
+                        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                        #
+                        # The default is set to false.
+                    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                        # that was supplied in the request.
+                        #
+                        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                        # supplied, the path of the original request is used for the redirect.
+                        #
+                        # The value must be from 1 to 1024 characters.
+                    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                        # the HttpRouteRuleMatch, retaining the remaining portion
+                        # of the URL before redirecting the request.
+                        #
+                        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                        # supplied, the path of the original request is used for the redirect.
+                        #
+                        # The value must be from 1 to 1024 characters.
+                    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                        #
+                        # Supported values are:
+                        #
+                        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                        #    to 301.
+                        #    - FOUND, which corresponds to 302.
+                        #    - SEE_OTHER which corresponds to 303.
+                        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                        #    method is retained.
+                        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                        #    method is retained.
+                    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                        # URL is
+                        # removed before redirecting the request. If set to false, the
+                        # query portion of the original URL is retained.
+                        #
+                        # The default is set to false.
+                  },
+                },
+              ],
+              "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+                  # desired. routeRules are evaluated in order of priority, from
+                  # the lowest to highest number.
+                  #
+                  # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+                { # The HttpRouteRule setting specifies how to match an HTTP request
+                    # and the corresponding routing action that load balancing proxies perform.
+                  "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                      #
+                      # If a policy for an
+                      # error code is not configured for the RouteRule, a policy for
+                      # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                      # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                      # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                      # effect.
+                      #
+                      # For example, consider a UrlMap with the following configuration:
+                      #
+                      #
+                      #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                      #      with policies for 5xx and 4xx errors
+                      #      - A RouteRule for /coming_soon/ is configured for the
+                      #      error code 404.
+                      #
+                      # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                      # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                      # the policy in RouteRule.customErrorResponsePolicy takes
+                      # effect. If any of the requests in this example encounter a 500
+                      # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                      #
+                      # When
+                      # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+                      # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+                      # a retry, if load balancer is successful in reaching the
+                      # service, the customErrorResponsePolicy is ignored and
+                      # the response from the service is returned to the client.
+                      #
+                      # customErrorResponsePolicy is supported only for
+                      # global external Application Load Balancers.
+                      # backend service or backend bucket responds with an error.
+                    "errorResponseRules": [ # Specifies rules for returning error responses.
+                        #
+                        # In a given policy, if you specify rules for both a range of error codes
+                        # as well as rules for specific error codes then rules with specific error
+                        # codes have a higher priority. For example, assume that you configure a rule
+                        # for 401 (Un-authorized) code, and another for all 4 series
+                        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                        # However if the backend service returns a 403, the rule for4xx takes effect.
+                      { # Specifies the mapping between the response code that will be returned along
+                          # with the custom error content and the response code returned by the backend
+                          # service.
+                        "matchResponseCodes": [ # Valid values include:
+                            #
+                            #
+                            #      - A number between 400 and 599: For example
+                            #      401 or 503, in which case the load balancer
+                            #      applies the policy if the error code exactly matches this value.
+                            #      - 5xx: Load Balancer will apply the policy if the
+                            #      backend service responds with any response code in the range of
+                            #      500 to 599.
+                            #    - 4xx: Load
+                            #      Balancer will apply the policy if the backend service responds with any
+                            #      response code in the range of 400 to
+                            #      499.
+                            #
+                            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                          "A String",
+                        ],
+                        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                            # error content. If overrideResponseCode is not supplied, the
+                            # same response code returned by the original backend bucket or backend
+                            # service is returned to the client.
+                        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                            #
+                            # path must start
+                            # with a leading slash. path cannot have trailing slashes.
+                            #
+                            # If the file is not available in backendBucket  or the
+                            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                            #
+                            # The value must
+                            # be from 1 to 1024 characters
+                      },
+                    ],
+                    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                        # contains the custom error content. Examples are:
+                        #
+                        #
+                        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                        #      - global/backendBuckets/myBackendBucket
+                        #
+                        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                        #
+                        # If load balancer cannot reach
+                        # the backendBucket, a simple Not Found Error will
+                        # be returned, with the original response code (oroverrideResponseCode if configured).
+                        #
+                        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+                  },
+                  "description": "A String", # The short description conveying the intent of this routeRule.
+                      #
+                      #
+                      # The description can have a maximum length of 1024 characters.
+                  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                      # for the selected backendService.
+                      #
+                      # The headerAction value specified here is applied before the
+                      # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+                      #
+                      # HeaderAction is not supported for load balancers
+                      # that have
+                      # their loadBalancingScheme set to EXTERNAL.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                      # the request is passed along to the selected backendService.
+                    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # request before forwarding the request to the backendService.
+                      "A String",
+                    ],
+                    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                        # client.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # response before sending the response back to the client.
+                      "A String",
+                    ],
+                  },
+                  "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+                      # this routeRule when any of thematchRules are satisfied. However predicates within
+                      # a given matchRule have AND semantics. All predicates
+                      # within a matchRule must match for the request to
+                      # match the rule.
+                    { # HttpRouteRuleMatch specifies a set of criteria for matching
+                        # requests to an HttpRouteRule. All specified criteria must
+                        # be satisfied for a match to occur.
+                      "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                          # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                          # that may be part of the original URL.
+                          #
+                          # fullPathMatch must be from 1 to 1024 characters.
+                          #
+                          # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                          # specified.
+                      "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                          # corresponding headers in the request.
+                        { # matchRule criteria for request header matches.
+                          "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          "headerName": "A String", # The name of the HTTP header to match.
+                              #
+                              # For matching against the HTTP request's authority, use a headerMatch
+                              # with the header name ":authority".
+                              #
+                              # For matching a request's method, use the headerName ":method".
+                              #
+                              # When the URL map is bound to a target gRPC proxy that has
+                              # the validateForProxyless field set to true, only
+                              # non-binary
+                              # user-specified custom metadata and the `content-type` header are supported.
+                              # The following transport-level headers cannot be used in header matching
+                              # rules:
+                              # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                              # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                              # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                              # `grpc-timeout` and `grpc-trace-bin`.
+                          "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                              # match if the preceding match criteria are met. If set to true,
+                              # the headerMatch is considered a match if the preceding
+                              # match criteria are NOT met.
+                              #
+                              # The default setting is false.
+                          "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                              # match takes place whether or not the request's header has a value.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                              # specified in rangeMatch. If the header does not contain an
+                              # integer, number or is empty, the match fails.
+                              #
+                              # For example for a range [-5, 0]
+                              #
+                              #
+                              #       - -3 will match.
+                              #       - 0 will not match.
+                              #       - 0.25 will not match.
+                              #       - -3someString will not match.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                              #
+                              # rangeMatch is not supported for load balancers
+                              # that have loadBalancingScheme set to EXTERNAL.
+                              # within the specified integer range.
+                            "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                            "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                          },
+                          "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                              # For more information about regular expression syntax, see Syntax.
+                              #
+                              # For matching against a port specified in the HTTP request, use a
+                              # headerMatch with headerName set to PORT and a regular expression that
+                              # satisfies the RFC2616 Host header's port specifier.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                              #
+                              # Regular expressions can only be used when the loadBalancingScheme is
+                              # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                              # (regional scope) or INTERNAL_MANAGED.
+                          "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                              #
+                              # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                        },
+                      ],
+                      "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                          # matches are case sensitive.
+                          #
+                          # The default value is false.
+                          #
+                          # ignoreCase must not be used with regexMatch.
+                          #
+                          # Not supported when the URL map is bound to a target gRPC proxy.
+                      "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                          # configuration to a limited set of xDS
+                          # compliant clients. In their xDS requests to the load balancer, xDS clients
+                          # present node
+                          # metadata. When there is a match, the relevant routing configuration
+                          # is made available to those proxies.
+                          #
+                          # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                          # the metadata. If its filterMatchCriteria is set to
+                          # MATCH_ALL, then all of its filterLabels must match with
+                          # corresponding labels provided in the metadata. If multiple
+                          # metadata filters are specified, all of them need to be
+                          # satisfied in order to be considered a match.
+                          #
+                          # metadataFilters specified here is applied after those
+                          # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                          #
+                          # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                          #
+                          # Not supported when the URL map is bound to a target gRPC proxy that
+                          # has validateForProxyless field set to true.
+                        { # Opaque filter criteria used by load balancers to restrict routing
+                            # configuration to a limited set of load balancing proxies. Proxies and
+                            # sidecars involved in load balancing would typically present metadata to the
+                            # load balancers that need to match criteria specified here. If a match takes
+                            # place, the relevant configuration is made available to those
+                            # proxies.
+                            #
+                            # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                            # one of thefilterLabels must match the corresponding label provided in
+                            # the metadata. If its filterMatchCriteria is set to
+                            # MATCH_ALL, then all of its filterLabels must match with
+                            # corresponding labels provided in the metadata.
+                            #
+                            # An example for using metadataFilters would be: if
+                            # load balancing involves
+                            # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                          "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                              # metadata based on filterMatchCriteria
+                              #
+                              # This list must not be empty and can have at the most 64 entries.
+                            { # MetadataFilter label name value pairs that are expected
+                                # to match corresponding labels presented as metadata to the load balancer.
+                              "name": "A String", # Name of metadata label.
+                                  #
+                                  #  The name can have a maximum length of 1024 characters and must be at
+                                  # least 1 character long.
+                              "value": "A String", # The value of the label must match the specified value.
+                                  #
+                                  # value can have a maximum length of 1024 characters.
+                            },
+                          ],
+                          "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                              # within the list of filterLabels and contributes toward the
+                              # overall metadataFilter match.
+                              #
+                              #  Supported values are:
+                              #
+                              #    - MATCH_ANY: at least one of the filterLabels
+                              #    must have a matching label in the provided metadata.
+                              #    - MATCH_ALL: all filterLabels must have
+                              #    matching labels in the provided metadata.
+                        },
+                      ],
+                      "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                          # the :path header after the query string is removed.
+                          #
+                          # A path template pattern can include variables and wildcards.
+                          # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                          # matches a single path segment, and ** that matches zero or
+                          # more path segments. The pattern must follow these rules:
+                          #
+                          #
+                          #       - The value must be between 1 and 1024 characters.
+                          #       - The pattern must start with a leading slash ("/").
+                          #       - No more than 5 operators (variables or wildcards) may appear in
+                          #       the pattern.
+                          #
+                          # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                          # set.
+                      "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                          # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                          #
+                          # The value must be from 1 to 1024 characters.
+                          #
+                          # The * character inside a prefix match is
+                          # treated as a literal character, not as a wildcard.
+                          #
+                          # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                          # used within a matchRule.
+                      "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                          # match corresponding query parameters in the request.
+                          #
+                          # Not supported when the URL map is bound to a target gRPC proxy.
+                        { # HttpRouteRuleMatch criteria for a request's query parameter.
+                          "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                              # parameter exactly matches the contents of exactMatch.
+                              #
+                              # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                          "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                              # the request, in the absence of which the request match fails.
+                          "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                              # request contains the query parameter, irrespective of whether the
+                              # parameter has a value or not.
+                              #
+                              # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                          "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                              # parameter matches the regular expression specified byregexMatch. For
+                              # more information about regular expression syntax, see Syntax.
+                              #
+                              # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                              #
+                              # Regular expressions can only be used when the loadBalancingScheme is
+                              # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                              # (regional scope) or INTERNAL_MANAGED.
+                        },
+                      ],
+                      "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                          # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                          # supplied with the original URL. For
+                          # more information about regular expression syntax, see Syntax.
+                          #
+                          # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                          # specified.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                          # (regional scope) or INTERNAL_MANAGED.
+                    },
+                  ],
+                  "priority": 42, # For routeRules within a given pathMatcher,
+                      # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+                      # of priority, from the lowest to highest number. The priority of a
+                      # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+                      # that matches the request is applied.
+                      #
+                      #
+                      # You cannot configure two or more routeRules with the same priority.
+                      # Priority for each rule must be set to a number from 0 to 2147483647
+                      # inclusive.
+                      #
+                      #
+                      # Priority numbers can have gaps, which enable you to add or remove rules
+                      # in the future without affecting the rest of the rules. For example, 1, 2,
+                      # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+                      # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+                      # without any impact on existing rules.
+                  "routeAction": { # In response to a matching matchRule, the load balancer
+                      # performs advanced routing actions, such as URL rewrites and header
+                      # transformations, before forwarding the request to the selected backend.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                      #
+                      #
+                      # URL maps for classic Application Load Balancers only support
+                      # the urlRewrite action within a route rule'srouteAction.
+                    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                        # property must be specified. This policy cannot be specified if any target
+                        # backend has Identity-Aware Proxy enabled.
+                      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                          # header names can be specified. The cache is bypassed for all `cacheMode`
+                          # values.
+                        "A String",
+                      ],
+                      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                          # on the backend type: for Backend Services, the complete request URI is
+                          # used; for Backend Buckets, the request URI is used without the protocol or
+                          # host, and only query parameters known to Cloud Storage are included.
+                          # Policy defined on Route Action.
+                        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                            # parameters will be included. Either specify `excludedQueryParameters`
+                            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                            # encoded and not treated as delimiters.
+                            #
+                            # Note: This field applies to routes that use backend services. Attempting
+                            # to set it on a route that points exclusively to Backend Buckets will
+                            # result in a configuration error. For routes that point to a Backend
+                            # Bucket, use `includedQueryParameters` to define which parameters should
+                            # be part of the cache key.
+                          "A String",
+                        ],
+                        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket, as the
+                            # host is never included in a Backend Bucket's cache key. Attempting to set
+                            # it on a route that points exclusively to Backend Buckets will result in a
+                            # configuration error.
+                        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket, as the
+                            # protocol is never included in a Backend Bucket's cache key. Attempting to
+                            # set on a route that points exclusively to Backend Buckets will result in
+                            # a configuration error.
+                        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                            # is set, the entire query string will be included. If false, the query
+                            # string will be excluded from the cache key entirely.
+                            #
+                            # Note: This field applies to routes that use backend services. Attempting
+                            # to set it on a route that points exclusively to Backend Buckets will
+                            # result in a configuration error. For routes that point to a Backend
+                            # Bucket, use `includedQueryParameters` to define which parameters should
+                            # be part of the cache key.
+                        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                            # The name=value pair will be used in the cache key Cloud CDN generates.
+                            #
+                            # Note: This setting is only applicable to routes that use a Backend
+                            # Service. It does not affect requests served by a Backend Bucket.
+                            # Attempting to set it on a route that points exclusively to Backend
+                            # Buckets will result in a configuration error. Up to 5 cookie names can be
+                            # specified.
+                          "A String",
+                        ],
+                        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                          "A String",
+                        ],
+                        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                            # parameters will be excluded. Either specify `includedQueryParameters`
+                            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                            # encoded and not treated as delimiters.
+                          "A String",
+                        ],
+                      },
+                      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                          # content. This is used to clamp the max-age (or Expires) value sent to the
+                          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                          # is used for the response max-age directive, along with a "public"
+                          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                          # clamps the max-age from the origin (if specified), or else sets the
+                          # response max-age directive to the lesser of the `clientTtl` and
+                          # `defaultTtl`, and also ensures a "public" cache-control directive is
+                          # present. The maximum allowed value is 31,622,400s (1 year). If not
+                          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                          # `USE_ORIGIN_HEADERS`.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                          # greater than that of `maxTtl`. When the `cacheMode` is set to
+                          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                          # accessed objects may be evicted from the cache before the defined TTL. If
+                          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                          # `USE_ORIGIN_HEADERS`.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                          # more than `maxTtl` seconds in the future will be capped at the value of
+                          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                          # Infrequently accessed objects may be evicted from the cache before the
+                          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                          # mode.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                          # to apply fine-grained caching for common errors or redirects.
+                          # This can reduce the load on your origin and improve end-user
+                          # experience by reducing response latency.
+                          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                          # the specified response code that lack any Cache-Control, Expires, or
+                          # Pragma: no-cache directives. When the `cacheMode` is set to
+                          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                          # with the specified response code, and overrides any caching headers. By
+                          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                          #
+                          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                          #
+                          # These defaults can be overridden in `negativeCachingPolicy`.
+                          # If not specified, Cloud CDN applies negative caching by default.
+                      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                          # CDN's default cache TTLs. Note that when specifying an explicit
+                          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                          # all response codes that you wish to cache. Cloud CDN will not apply any
+                          # default negative caching when a policy exists.
+                        { # Specify CDN TTLs for response error codes.
+                          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                              # specified as values, and you cannot specify a status code more than
+                              # once.
+                          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                              # corresponding status code.
+                              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                              # objects may be evicted from the cache before the defined TTL.
+                              # as a count of seconds and fractions of seconds at nanosecond
+                              # resolution. It is independent of any calendar and concepts like "day"
+                              # or "month". Range is approximately 10,000 years.
+                            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                                # Durations less than one second are represented with a 0
+                                # `seconds` field and a positive `nanos` field. Must be from 0
+                                # to 999,999,999 inclusive.
+                            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                                # 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
+                          },
+                        },
+                      ],
+                      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                          # requests into a small number of requests to the origin. If not specified,
+                          # Cloud CDN applies request coalescing by default.
+                      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                          # content with the origin, or when an error is encountered when refreshing
+                          # the cache.
+                          # This setting defines the default "max-stale" duration for any cached
+                          # responses that do not specify a max-stale directive. Stale responses that
+                          # exceed the TTL configured here will not be served. The default limit
+                          # (max-stale) is 86400s (1 day), which will allow stale content to be
+                          # served up to this limit beyond the max-age (or s-maxage) of a cached
+                          # response.
+                          # The maximum allowed value is 604800 (1 week).
+                          # Set this to zero (0) to disable serve-while-stale.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                        # information about the W3C recommendation for cross-origin resource sharing
+                        # (CORS), see Fetch API Living
+                        # Standard.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy.
+                        # information about the W3C recommendation for cross-origin resource sharing
+                        # (CORS), see Fetch API Living
+                        # Standard.
+                      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                          # indicates that
+                          # the actual request can include user credentials. This field translates to
+                          # the Access-Control-Allow-Credentials header.
+                          #
+                          # Default is false.
+                      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                          # header.
+                        "A String",
+                      ],
+                      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                          # header.
+                        "A String",
+                      ],
+                      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                          # more information, see regular expression syntax.
+                          #
+                          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED.
+                        "A String",
+                      ],
+                      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                          #
+                          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                        "A String",
+                      ],
+                      "disabled": True or False, # If true, disables the CORS policy.
+                          # The default value is false, which indicates that the CORS
+                          # policy is in effect.
+                      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                          # header.
+                        "A String",
+                      ],
+                      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                          # seconds. This field translates to the Access-Control-Max-Age
+                          # header.
+                    },
+                    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                        # the resiliency of clients to backend service failure. As part of fault
+                        # injection, when clients send requests to a backend service, delays can be
+                        # introduced by a load balancer on a percentage of requests before sending
+                        # those requests to the backend service. Similarly requests from clients can
+                        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                        # that are configured with a fault_injection_policy if:
+                        # 1. The traffic is generated by fault injection AND
+                        # 2. The fault injection is not a delay fault injection.
+                        # Fault injection is not supported with the classic Application Load Balancer
+                        # . To see which load balancers support fault injection,
+                        # see Load
+                        # balancing: Routing and traffic management features.
+                        # the resiliency of clients to backend service failure. As part of fault
+                        # injection, when clients send requests to a backend service, delays can be
+                        # introduced by the load balancer on a percentage of requests before sending
+                        # those request to the backend service. Similarly requests from clients can be
+                        # aborted by the load balancer for a percentage of requests.
+                      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                          # injection.
+                        "httpStatus": 42, # The HTTP status code used to abort the request.
+                            #
+                            # The value must be from 200 to 599 inclusive.
+                            #
+                            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                            # according to this
+                            # mapping table. HTTP status 200 is mapped to gRPC status
+                            # UNKNOWN. Injecting an OK status is currently not supported by
+                            # Traffic Director.
+                        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                            # that is aborted as part of fault injection.
+                            #
+                            # The value must be from 0.0 to 100.0 inclusive.
+                      },
+                      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                          # injection, before being sent to a backend service.
+                          # request to the backend service as part of fault injection.
+                        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                            # as a count of seconds and fractions of seconds at nanosecond
+                            # resolution. It is independent of any calendar and concepts like "day"
+                            # or "month". Range is approximately 10,000 years.
+                          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                              # Durations less than one second are represented with a 0
+                              # `seconds` field and a positive `nanos` field. Must be from 0
+                              # to 999,999,999 inclusive.
+                          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                              # 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
+                        },
+                        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                            # which a delay is introduced as part of fault injection.
+                            #
+                            # The value must be from 0.0 to 100.0 inclusive.
+                      },
+                    },
+                    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                        # Unlike the timeout field where the timeout duration starts
+                        # from the time the request has been fully processed (known as*end-of-stream*),
+                        # the duration in this field is computed from the beginning of the stream
+                        # until the response has been processed, including all retries. A
+                        # stream that does not complete in this duration is closed.
+                        #
+                        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                        # with the route.
+                        #
+                        # This field is only allowed if the Url map is used with backend services
+                        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                        # are shadowed to a separate mirrored backend service. The load balancer does
+                        # not wait for responses from the shadow service. Before sending traffic
+                        # to the shadow service, the host / authority header is suffixed with-shadow.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has the validateForProxyless field set to true.
+                        # are shadowed to a separate mirrored backend service. The load balancer
+                        # doesn't wait for responses from the shadow service. Before sending traffic
+                        # to the shadow service, the host or authority header is suffixed with-shadow.
+                      "backendService": "A String", # The full or partial URL to the BackendService resource being
+                          # mirrored to.
+                          #
+                          # The backend service configured for a mirroring
+                          # policy must reference backends that are of the same type as the original
+                          # backend service matched in the URL map.
+                          #
+                          # Serverless NEG backends are not currently supported as a mirrored
+                          # backend service.
+                      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                    },
+                    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                          # If not specified, defaults to 1.
+                      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                          #
+                          # If not specified, will use the timeout set in theHttpRouteAction field.
+                          # If timeout in the HttpRouteAction field is not set, this field
+                          # uses the largest timeout
+                          # among all backend services associated with the route.
+                          #
+                          # Not supported when the URL map is bound to a target gRPC proxy that
+                          # has the validateForProxyless field set to true.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                          # values are:
+                          #
+                          #    - 5xx: retry is attempted if the instance or endpoint
+                          #    responds with any 5xx response code, or if the instance or
+                          #    endpoint does not respond at all. For example, disconnects, reset, read
+                          #    timeout, connection failure, and refused streams.
+                          #    - gateway-error: Similar to 5xx, but only
+                          #    applies to response codes 502, 503 or504.
+                          #    - connect-failure: a retry is attempted on failures
+                          #    connecting to the instance or endpoint. For example, connection
+                          #    timeouts.
+                          #    - retriable-4xx: a retry is attempted if the instance
+                          #    or endpoint responds with a 4xx response code.
+                          #    The only error that you can retry is error code 409.
+                          #    - refused-stream: a retry is attempted if the instance
+                          #    or endpoint resets the stream with a REFUSED_STREAM error
+                          #    code. This reset type indicates that it is safe to retry.
+                          #    - cancelled: a retry is attempted if the gRPC status
+                          #    code in the response header is set to cancelled.
+                          #    - deadline-exceeded: a retry is attempted if the gRPC
+                          #    status code in the response header is set todeadline-exceeded.
+                          #    - internal: a retry is attempted if the gRPC
+                          #    status code in the response header is set tointernal.
+                          #    - resource-exhausted: a retry is attempted if the gRPC
+                          #    status code in the response header is set toresource-exhausted.
+                          #    - unavailable: a retry is attempted if the gRPC
+                          #    status code in the response header is set tounavailable.
+                          #
+                          # Only the following codes are supported when the URL map is bound to
+                          # target gRPC proxy that has validateForProxyless field set to true.
+                          #
+                          #    - cancelled
+                          #    - deadline-exceeded
+                          #    - internal
+                          #    - resource-exhausted
+                          #    - unavailable
+                        "A String",
+                      ],
+                    },
+                    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                        # time the request has been fully processed (known as *end-of-stream*)
+                        # up until the response has been processed. Timeout includes
+                        # all retries.
+                        #
+                        # If not specified, this field uses the largest timeout among all backend
+                        # services associated with the route.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                        # to the matched service.
+                        #
+                        #  urlRewrite is the only action supported in UrlMaps
+                        # for classic Application Load Balancers.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has the validateForProxyless field set to true.
+                        # backend service.
+                      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                          # host header is replaced with contents of hostRewrite.
+                          #
+                          # The value must be from 1 to 255 characters.
+                      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                          # matching portion of the request's path is replaced bypathPrefixRewrite.
+                          #
+                          # The value must be from 1 to 1024 characters.
+                      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                          # header) using the HTTP template syntax.
+                          #
+                          # A corresponding
+                          # path_template_match must be specified. Any template variables must exist in
+                          # the path_template_match field.
+                          #
+                          #
+                          #       - -At least one variable must be specified in the path_template_match
+                          #       field
+                          #    - You can omit variables from the rewritten URL
+                          #       - The * and ** operators cannot be matched
+                          #       unless they have a corresponding variable name - e.g.
+                          #       {format=*} or {var=**}.
+                          #
+                          # For example, a path_template_match of /static/{format=**}
+                          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                          # rewrite, so that /{country}/{format}/{suffix=**} can be
+                          # rewritten as /content/{format}/{country}/{suffix}.
+                          #
+                          # At least
+                          # one non-empty routeRules[].matchRules[].path_template_match is
+                          # required.
+                          #
+                          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                            # It uses RE2 syntax with the following constraints:
+                            #
+                            #
+                            #      - Any single character operators
+                            #      - Groups are allowed to have only submatch operator inside
+                            #      - Groups are allowed only without any char repetition, e.g.
+                            #      .*
+                            #      - Any char repetition, e.g. .*, is
+                            #      only allowed to be used in a single regex together with:
+                            #
+                            #
+                            #             - Empty string operators
+                            #             - Other repetitions
+                            #             - Ranges
+                            #             - Repetitions of ranges
+                            #
+                            #
+                            #      - Ranges are only allowed to have:
+                            #
+                            #
+                            #             - Character range
+                            #             - Digits range
+                            #             - Symbols listed in characters allowed for ranges
+                        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                            # the path.
+                      },
+                    },
+                    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                        # occurs. The weights determine the fraction of traffic that flows to
+                        # their corresponding backend service. If all traffic needs to
+                        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                        #
+                        # After a backend service is identified and before forwarding
+                        # the request to
+                        # the backend service, advanced routing actions such as URL rewrites and
+                        # header transformations are applied depending on additional settings
+                        # specified in this HttpRouteAction.
+                      { # In contrast to a single BackendService in
+                          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                          # multiple backend services. The volume of traffic for each
+                          # backend service is proportional to the weight specified
+                          # in each WeightedBackendService
+                        "backendService": "A String", # The full or partial URL to the default BackendService
+                            # resource. Before
+                            # forwarding the request to backendService, the load balancer
+                            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                            # effect for the selected backendService.
+                            #
+                            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                            #
+                            # headerAction is not supported for load balancers that have
+                            # their loadBalancingScheme set to EXTERNAL.
+                            #
+                            # Not supported when the URL map is bound to a target gRPC proxy that
+                            # has validateForProxyless field set to true.
+                            # the request is passed along to the selected backendService.
+                          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                            { # Specification determining how headers are added to requests or responses.
+                              "headerName": "A String", # The name of the header.
+                              "headerValue": "A String", # The value of the header to add.
+                              "replace": True or False, # If false, headerValue is appended to any values
+                                  # that already
+                                  # exist for the header. If true, headerValue is set for the
+                                  # header, discarding any values that were set for that header.
+                                  #
+                                  # The default value is true,
+                                  # unless a variable is present in headerValue,
+                                  # in which case the default value is false.
+                                  # .
+                            },
+                          ],
+                          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                              # request before forwarding the request to the backendService.
+                            "A String",
+                          ],
+                          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                              # client.
+                            { # Specification determining how headers are added to requests or responses.
+                              "headerName": "A String", # The name of the header.
+                              "headerValue": "A String", # The value of the header to add.
+                              "replace": True or False, # If false, headerValue is appended to any values
+                                  # that already
+                                  # exist for the header. If true, headerValue is set for the
+                                  # header, discarding any values that were set for that header.
+                                  #
+                                  # The default value is true,
+                                  # unless a variable is present in headerValue,
+                                  # in which case the default value is false.
+                                  # .
+                            },
+                          ],
+                          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                              # response before sending the response back to the client.
+                            "A String",
+                          ],
+                        },
+                        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                            #
+                            # The selection of a backend service is determined only for new traffic.
+                            # Once a user's request has been directed to a backend service,
+                            # subsequent requests are sent to the same backend service as
+                            # determined by the backend service's session affinity policy.
+                            # Don't configure session affinity if you're using weighted traffic
+                            # splitting. If you do, the weighted traffic splitting configuration takes
+                            # precedence.
+                            #
+                            # The value must be from 0 to 1000.
+                      },
+                    ],
+                  },
+                  "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                      # is directed if this rule is matched. If routeAction is
+                      # also specified, advanced routing actions, such as URL rewrites,
+                      # take effect before sending the request to the backend.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+                      # specified by urlRedirect.
+                      #
+                      #
+                      # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                      #
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                        # was supplied in the request.
+                        #
+                        # The value must be from 1 to 255
+                        # characters.
+                    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                        # set to HTTPS.
+                        # If set to false, the URL scheme of the redirected request
+                        # remains the same as that of the request.
+                        #
+                        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                        #
+                        # The default is set to false.
+                    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                        # that was supplied in the request.
+                        #
+                        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                        # supplied, the path of the original request is used for the redirect.
+                        #
+                        # The value must be from 1 to 1024 characters.
+                    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                        # the HttpRouteRuleMatch, retaining the remaining portion
+                        # of the URL before redirecting the request.
+                        #
+                        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                        # supplied, the path of the original request is used for the redirect.
+                        #
+                        # The value must be from 1 to 1024 characters.
+                    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                        #
+                        # Supported values are:
+                        #
+                        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                        #    to 301.
+                        #    - FOUND, which corresponds to 302.
+                        #    - SEE_OTHER which corresponds to 303.
+                        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                        #    method is retained.
+                        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                        #    method is retained.
+                    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                        # URL is
+                        # removed before redirecting the request. If set to false, the
+                        # query portion of the original URL is retained.
+                        #
+                        # The default is set to false.
+                  },
+                },
+              ],
+            },
+          ],
+          "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+              # This field is not applicable to global URL maps.
+              # 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.
+          "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+              # maximum of 100 tests per UrlMap.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+            { # Message for the expected URL mappings.
+              "description": "A String", # Description of this test case.
+              "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+                  # containing the scheme, host, path and query parameters.
+                  #
+                  # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+                  # the load balancer to backends. For rules with urlRewrite,
+                  # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+                  #
+                  # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+                  # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+                  # If urlRedirect specifies strip_query, the test
+                  # passes only if expectedOutputUrl does not contain any query
+                  # parameters.
+                  #
+                  # expectedOutputUrl is optional whenservice is specified.
+              "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+                  # load balancer's redirect response.
+                  #
+                  # expectedRedirectResponseCode cannot be set whenservice is set.
+              "headers": [ # HTTP headers for this request. If headers contains
+                  # a host header, then host must also match the header value.
+                { # HTTP headers used in UrlMapTests.
+                  "name": "A String", # Header name.
+                  "value": "A String", # Header value.
+                },
+              ],
+              "host": "A String", # Host portion of the URL. If headers contains a host header,
+                  # then host must also match the header value.
+              "path": "A String", # Path portion of the URL.
+              "service": "A String", # Expected BackendService or BackendBucket resource
+                  # the given URL should be mapped to.
+                  #
+                  # The service field cannot
+                  # be set if expectedRedirectResponseCode is set.
+            },
+          ],
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of
+          # backend services 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#urlMapsAggregatedList", # 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, urlMap, requestId=None, x__xgafv=None) + 
Deletes the specified UrlMap resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  urlMap: string, Name of the UrlMap 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, urlMap, x__xgafv=None) + 
Returns the specified UrlMap resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  urlMap: string, Name of the UrlMap 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 URL Map resource.
+    #
+    # Compute Engine has two URL Map resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    #
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    #
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    #
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    #
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    #
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    #
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      #
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      #
+      # For example, consider a UrlMap with the
+      # following configuration:
+      #
+      #
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      #
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      #
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      #
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      #
+      #
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      #
+      #
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      #
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      #
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      #
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      #
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) + 
Creates a UrlMap resource 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 URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None) + 
Initiates a cache invalidation operation, invalidating the specified path,
+scoped to the specified UrlMap.
+
+For more information, see [Invalidating cached
+content](/cdn/docs/invalidating-cached-content).
+
+Args:
+  project: string, Project ID for this request. (required)
+  urlMap: string, Name of the UrlMap scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "cacheTags": [ # A list of cache tags used to identify cached objects.
+      # 
+      # 
+      #    - Cache tags are specified when the response is first cached, by setting
+      #    the `Cache-Tag` response header at the origin.
+      #    - Multiple cache tags in the same invalidation request are treated as
+      #    Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
+      #    - If other fields are also specified, these are treated as Boolean `AND`
+      #    with any tags.
+      # 
+      # 
+      # Up to 10 tags can be specified in a single invalidation request.
+    "A String",
+  ],
+  "host": "A String", # If set, this invalidation rule will only apply to requests with a Host
+      # header matching host.
+  "path": "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
+      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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves the list of UrlMap resources available to 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.
+  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 UrlMap resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of UrlMap resources.
+    { # Represents a URL Map resource.
+        #
+        # Compute Engine has two URL Map resources:
+        #
+        # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+        # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+        #
+        # A URL map resource is a component of certain types of cloud load balancers
+        # and Traffic Director:
+        #
+        # * urlMaps are used by global external Application Load
+        # Balancers, classic Application Load Balancers, and cross-region internal
+        # Application Load Balancers.
+        # * regionUrlMaps are used by internal Application Load Balancers,
+        # regional external Application Load Balancers and regional internal
+        # Application Load Balancers.
+        #
+        # For a list of supported URL map features by the load balancer type, see the
+        # Load balancing features: Routing and traffic management table.
+        #
+        # For a list of supported URL map features for Traffic Director, see the
+        # Traffic Director features: Routing and traffic management table.
+        #
+        # This resource defines mappings from hostnames and URL paths to either a
+        # backend service or a backend bucket.
+        #
+        # To use the global urlMaps resource, the backend service must
+        # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+        # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+        # information, read URL
+        # Map Concepts.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the load balancer level and applies only when no policy has been
+          # defined for the error code at lower levels like PathMatcher, RouteRule and
+          # PathRule within this UrlMap.
+          #
+          # For example, consider a UrlMap with the
+          # following configuration:
+          #
+          #
+          #      - defaultCustomErrorResponsePolicy containing policies for
+          #      responding to 5xx and 4xx errors
+          #      - A PathMatcher configured for *.example.com has
+          #      defaultCustomErrorResponsePolicy for 4xx.
+          #
+          # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+          # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+          # a request that does not match any host in *.example.com such
+          # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+          # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # hostRules match. The load balancer performs advanced routing
+          # actions, such as URL rewrites and header transformations, before forwarding
+          # the request to the selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          #  URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within defaultRouteAction.
+          #
+          #
+          # defaultRouteAction has no effect when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL of the defaultService resource to
+          # which traffic is directed if none of the hostRules match.
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # defaultService has no effect when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+          # is redirected to a URL specified by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "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 is ignored when
+          # inserting a UrlMap. An up-to-date fingerprint must be provided
+          # in order to update the UrlMap, otherwise the request will
+          # fail with error 412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a UrlMap.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backendService.
+          #
+          # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+          #
+          # headerAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "hostRules": [ # The list of host rules to use against the URL.
+        { # UrlMaps
+            # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+              # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+              # that case, * must be the first character, and if followed by
+              # anything, the immediate following character must be either -
+              # or ..
+              #
+              # * based matching is not supported when the URL map is bound
+              # to a target gRPC proxy that has the validateForProxyless field
+              # set to true.
+            "A String",
+          ],
+          "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+              # of the URL if the hostRule matches the URL's host portion.
+        },
+      ],
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+          # url maps.
+      "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.
+      "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+        { # A matcher for the path portion of the URL. The BackendService
+            # from the longest-matched rule will serve the URL. If no rule was matched, the
+            # default service is used.
+          "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # This policy takes
+              # effect at the PathMatcher level and applies only when no
+              # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+              # in defaultCustomErrorResponsePolicy, then a policy defined for
+              # the error code in UrlMap.defaultCustomErrorResponsePolicy
+              # takes effect.
+              #
+              # For example, consider a UrlMap with the following
+              # configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the defaultCustomErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # defaultCustomErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+              # pathRules or routeRules match. The load balancer
+              # performs advanced routing actions, such as URL rewrites and
+              # header transformations, before forwarding the request to the
+              # selected backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path matcher'sdefaultRouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+              # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+              # matched. For example, the
+              # following are all valid URLs to a BackendService resource:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+              #      - compute/v1/projects/project/global/backendServices/backendService
+              #      - global/backendServices/backendService
+              #
+              #
+              # If defaultRouteAction is also specified, advanced
+              # routing actions, such as URL rewrites, take effect before sending the
+              # request to the backend.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # Authorization requires one or more of the following Google IAM permissions on the
+              # specified resource default_service:
+              #
+              #
+              #       - compute.backendBuckets.use
+              #       - compute.backendServices.use
+          "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+              # by defaultUrlRedirect.
+              #
+              #
+              # Only one of defaultUrlRedirect, defaultService
+              # or defaultRouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backend service.
+              #
+              # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+          "pathRules": [ # The list of path rules. Use this list instead of routeRules
+              # when routing based on simple path matching is all that's required. A path
+              # rule can only include a wildcard character (*) after a
+              # forward slash character ("/").
+              #
+              # The order by which path rules are specified does not matter.
+              # Matches are always done on the longest-path-first basis.
+              #
+              # For example: a pathRule with a path /a/b/c/* will match
+              # before /a/b/* irrespective of the order in which those paths appear in this
+              # list.
+              #
+              # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+            { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+              "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                  # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                  #
+                  # If a policy for an
+                  # error code is not configured for the PathRule, a policy for
+                  # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                  # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                  # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                  # effect.
+                  #
+                  # For example, consider a UrlMap with the following configuration:
+                  #
+                  #
+                  #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                  #      with policies for 5xx and 4xx errors
+                  #      - A PathRule for /coming_soon/ is configured for the error
+                  #      code 404.
+                  #
+                  # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                  # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                  # the policy in PathRule.customErrorResponsePolicy takes
+                  # effect. If any of the requests in this example encounter a 500
+                  # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                  #
+                  # customErrorResponsePolicy is supported only for
+                  # global external Application Load Balancers.
+                  # backend service or backend bucket responds with an error.
+                "errorResponseRules": [ # Specifies rules for returning error responses.
+                    #
+                    # In a given policy, if you specify rules for both a range of error codes
+                    # as well as rules for specific error codes then rules with specific error
+                    # codes have a higher priority. For example, assume that you configure a rule
+                    # for 401 (Un-authorized) code, and another for all 4 series
+                    # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                    # However if the backend service returns a 403, the rule for4xx takes effect.
+                  { # Specifies the mapping between the response code that will be returned along
+                      # with the custom error content and the response code returned by the backend
+                      # service.
+                    "matchResponseCodes": [ # Valid values include:
+                        #
+                        #
+                        #      - A number between 400 and 599: For example
+                        #      401 or 503, in which case the load balancer
+                        #      applies the policy if the error code exactly matches this value.
+                        #      - 5xx: Load Balancer will apply the policy if the
+                        #      backend service responds with any response code in the range of
+                        #      500 to 599.
+                        #    - 4xx: Load
+                        #      Balancer will apply the policy if the backend service responds with any
+                        #      response code in the range of 400 to
+                        #      499.
+                        #
+                        # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                      "A String",
+                    ],
+                    "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                        # error content. If overrideResponseCode is not supplied, the
+                        # same response code returned by the original backend bucket or backend
+                        # service is returned to the client.
+                    "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                        #
+                        # path must start
+                        # with a leading slash. path cannot have trailing slashes.
+                        #
+                        # If the file is not available in backendBucket  or the
+                        # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                        #
+                        # The value must
+                        # be from 1 to 1024 characters
+                  },
+                ],
+                "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                    # contains the custom error content. Examples are:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - global/backendBuckets/myBackendBucket
+                    #
+                    # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                    # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                    #
+                    # If load balancer cannot reach
+                    # the backendBucket, a simple Not Found Error will
+                    # be returned, with the original response code (oroverrideResponseCode if configured).
+                    #
+                    # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+              },
+              "paths": [ # The list of path patterns to match. Each must start with /
+                  # and the only place a * is allowed is at the end following
+                  # a /.  The string fed to the path matcher does not include
+                  # any text after the first ? or #, and
+                  # those chars are not allowed here.
+                "A String",
+              ],
+              "routeAction": { # In response to a matching path, the load balancer
+                  # performs advanced routing actions, such as URL rewrites and header
+                  # transformations, before forwarding the request to the selected
+                  # backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # URL maps for classic Application Load Balancers only support
+                  # the urlRewrite action within a path rule'srouteAction.
+                "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                    # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                    # property must be specified. This policy cannot be specified if any target
+                    # backend has Identity-Aware Proxy enabled.
+                  "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                      # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                      # header names can be specified. The cache is bypassed for all `cacheMode`
+                      # values.
+                    "A String",
+                  ],
+                  "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                      # on the backend type: for Backend Services, the complete request URI is
+                      # used; for Backend Buckets, the request URI is used without the protocol or
+                      # host, and only query parameters known to Cloud Storage are included.
+                      # Policy defined on Route Action.
+                    "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                        # parameters will be included. Either specify `excludedQueryParameters`
+                        # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                      "A String",
+                    ],
+                    "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # host is never included in a Backend Bucket's cache key. Attempting to set
+                        # it on a route that points exclusively to Backend Buckets will result in a
+                        # configuration error.
+                    "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # protocol is never included in a Backend Bucket's cache key. Attempting to
+                        # set on a route that points exclusively to Backend Buckets will result in
+                        # a configuration error.
+                    "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                        # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                        # is set, the entire query string will be included. If false, the query
+                        # string will be excluded from the cache key entirely.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                    "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                        # The name=value pair will be used in the cache key Cloud CDN generates.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket.
+                        # Attempting to set it on a route that points exclusively to Backend
+                        # Buckets will result in a configuration error. Up to 5 cookie names can be
+                        # specified.
+                      "A String",
+                    ],
+                    "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                      "A String",
+                    ],
+                    "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                        # parameters will be excluded. Either specify `includedQueryParameters`
+                        # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                      "A String",
+                    ],
+                  },
+                  "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                      # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                  "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                      # content. This is used to clamp the max-age (or Expires) value sent to the
+                      # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                      # is used for the response max-age directive, along with a "public"
+                      # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                      # clamps the max-age from the origin (if specified), or else sets the
+                      # response max-age directive to the lesser of the `clientTtl` and
+                      # `defaultTtl`, and also ensures a "public" cache-control directive is
+                      # present. The maximum allowed value is 31,622,400s (1 year). If not
+                      # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                      # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                      # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                      # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                      # greater than that of `maxTtl`. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                      # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                      # accessed objects may be evicted from the cache before the defined TTL. If
+                      # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                      # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                      # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                      # more than `maxTtl` seconds in the future will be capped at the value of
+                      # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                      # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                      # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                      # Infrequently accessed objects may be evicted from the cache before the
+                      # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                      # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                      # mode.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                      # to apply fine-grained caching for common errors or redirects.
+                      # This can reduce the load on your origin and improve end-user
+                      # experience by reducing response latency.
+                      # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                      # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                      # the specified response code that lack any Cache-Control, Expires, or
+                      # Pragma: no-cache directives. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                      # with the specified response code, and overrides any caching headers. By
+                      # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                      #
+                      # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                      # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                      # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                      #
+                      # These defaults can be overridden in `negativeCachingPolicy`.
+                      # If not specified, Cloud CDN applies negative caching by default.
+                  "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                      # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                      # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                      # CDN's default cache TTLs. Note that when specifying an explicit
+                      # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                      # all response codes that you wish to cache. Cloud CDN will not apply any
+                      # default negative caching when a policy exists.
+                    { # Specify CDN TTLs for response error codes.
+                      "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                          # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                          # specified as values, and you cannot specify a status code more than
+                          # once.
+                      "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                          # corresponding status code.
+                          # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                          # objects may be evicted from the cache before the defined TTL.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                  ],
+                  "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                      # requests into a small number of requests to the origin. If not specified,
+                      # Cloud CDN applies request coalescing by default.
+                  "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                      # content with the origin, or when an error is encountered when refreshing
+                      # the cache.
+                      # This setting defines the default "max-stale" duration for any cached
+                      # responses that do not specify a max-stale directive. Stale responses that
+                      # exceed the TTL configured here will not be served. The default limit
+                      # (max-stale) is 86400s (1 day), which will allow stale content to be
+                      # served up to this limit beyond the max-age (or s-maxage) of a cached
+                      # response.
+                      # The maximum allowed value is 604800 (1 week).
+                      # Set this to zero (0) to disable serve-while-stale.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+                "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                  "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                      # indicates that
+                      # the actual request can include user credentials. This field translates to
+                      # the Access-Control-Allow-Credentials header.
+                      #
+                      # Default is false.
+                  "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                      # header.
+                    "A String",
+                  ],
+                  "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                      # more information, see regular expression syntax.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED.
+                    "A String",
+                  ],
+                  "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    "A String",
+                  ],
+                  "disabled": True or False, # If true, disables the CORS policy.
+                      # The default value is false, which indicates that the CORS
+                      # policy is in effect.
+                  "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                      # seconds. This field translates to the Access-Control-Max-Age
+                      # header.
+                },
+                "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by a load balancer on a percentage of requests before sending
+                    # those requests to the backend service. Similarly requests from clients can
+                    # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                    # that are configured with a fault_injection_policy if:
+                    # 1. The traffic is generated by fault injection AND
+                    # 2. The fault injection is not a delay fault injection.
+                    # Fault injection is not supported with the classic Application Load Balancer
+                    # . To see which load balancers support fault injection,
+                    # see Load
+                    # balancing: Routing and traffic management features.
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by the load balancer on a percentage of requests before sending
+                    # those request to the backend service. Similarly requests from clients can be
+                    # aborted by the load balancer for a percentage of requests.
+                  "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                      # injection.
+                    "httpStatus": 42, # The HTTP status code used to abort the request.
+                        #
+                        # The value must be from 200 to 599 inclusive.
+                        #
+                        # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                        # according to this
+                        # mapping table. HTTP status 200 is mapped to gRPC status
+                        # UNKNOWN. Injecting an OK status is currently not supported by
+                        # Traffic Director.
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                        # that is aborted as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                  "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                      # injection, before being sent to a backend service.
+                      # request to the backend service as part of fault injection.
+                    "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                        # which a delay is introduced as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                },
+                "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                    # Unlike the timeout field where the timeout duration starts
+                    # from the time the request has been fully processed (known as*end-of-stream*),
+                    # the duration in this field is computed from the beginning of the stream
+                    # until the response has been processed, including all retries. A
+                    # stream that does not complete in this duration is closed.
+                    #
+                    # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                    # with the route.
+                    #
+                    # This field is only allowed if the Url map is used with backend services
+                    # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                    # are shadowed to a separate mirrored backend service. The load balancer does
+                    # not wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host / authority header is suffixed with-shadow.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # are shadowed to a separate mirrored backend service. The load balancer
+                    # doesn't wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host or authority header is suffixed with-shadow.
+                  "backendService": "A String", # The full or partial URL to the BackendService resource being
+                      # mirrored to.
+                      #
+                      # The backend service configured for a mirroring
+                      # policy must reference backends that are of the same type as the original
+                      # backend service matched in the URL map.
+                      #
+                      # Serverless NEG backends are not currently supported as a mirrored
+                      # backend service.
+                  "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                },
+                "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                  "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                      # If not specified, defaults to 1.
+                  "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                      #
+                      # If not specified, will use the timeout set in theHttpRouteAction field.
+                      # If timeout in the HttpRouteAction field is not set, this field
+                      # uses the largest timeout
+                      # among all backend services associated with the route.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has the validateForProxyless field set to true.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                      # values are:
+                      #
+                      #    - 5xx: retry is attempted if the instance or endpoint
+                      #    responds with any 5xx response code, or if the instance or
+                      #    endpoint does not respond at all. For example, disconnects, reset, read
+                      #    timeout, connection failure, and refused streams.
+                      #    - gateway-error: Similar to 5xx, but only
+                      #    applies to response codes 502, 503 or504.
+                      #    - connect-failure: a retry is attempted on failures
+                      #    connecting to the instance or endpoint. For example, connection
+                      #    timeouts.
+                      #    - retriable-4xx: a retry is attempted if the instance
+                      #    or endpoint responds with a 4xx response code.
+                      #    The only error that you can retry is error code 409.
+                      #    - refused-stream: a retry is attempted if the instance
+                      #    or endpoint resets the stream with a REFUSED_STREAM error
+                      #    code. This reset type indicates that it is safe to retry.
+                      #    - cancelled: a retry is attempted if the gRPC status
+                      #    code in the response header is set to cancelled.
+                      #    - deadline-exceeded: a retry is attempted if the gRPC
+                      #    status code in the response header is set todeadline-exceeded.
+                      #    - internal: a retry is attempted if the gRPC
+                      #    status code in the response header is set tointernal.
+                      #    - resource-exhausted: a retry is attempted if the gRPC
+                      #    status code in the response header is set toresource-exhausted.
+                      #    - unavailable: a retry is attempted if the gRPC
+                      #    status code in the response header is set tounavailable.
+                      #
+                      # Only the following codes are supported when the URL map is bound to
+                      # target gRPC proxy that has validateForProxyless field set to true.
+                      #
+                      #    - cancelled
+                      #    - deadline-exceeded
+                      #    - internal
+                      #    - resource-exhausted
+                      #    - unavailable
+                    "A String",
+                  ],
+                },
+                "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                    # time the request has been fully processed (known as *end-of-stream*)
+                    # up until the response has been processed. Timeout includes
+                    # all retries.
+                    #
+                    # If not specified, this field uses the largest timeout among all backend
+                    # services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                    # to the matched service.
+                    #
+                    #  urlRewrite is the only action supported in UrlMaps
+                    # for classic Application Load Balancers.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # backend service.
+                  "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                      # host header is replaced with contents of hostRewrite.
+                      #
+                      # The value must be from 1 to 255 characters.
+                  "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                      # matching portion of the request's path is replaced bypathPrefixRewrite.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                  "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                      # header) using the HTTP template syntax.
+                      #
+                      # A corresponding
+                      # path_template_match must be specified. Any template variables must exist in
+                      # the path_template_match field.
+                      #
+                      #
+                      #       - -At least one variable must be specified in the path_template_match
+                      #       field
+                      #    - You can omit variables from the rewritten URL
+                      #       - The * and ** operators cannot be matched
+                      #       unless they have a corresponding variable name - e.g.
+                      #       {format=*} or {var=**}.
+                      #
+                      # For example, a path_template_match of /static/{format=**}
+                      # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                      # rewrite, so that /{country}/{format}/{suffix=**} can be
+                      # rewritten as /content/{format}/{country}/{suffix}.
+                      #
+                      # At least
+                      # one non-empty routeRules[].matchRules[].path_template_match is
+                      # required.
+                      #
+                      # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                  "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                    "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                        # It uses RE2 syntax with the following constraints:
+                        #
+                        #
+                        #      - Any single character operators
+                        #      - Groups are allowed to have only submatch operator inside
+                        #      - Groups are allowed only without any char repetition, e.g.
+                        #      .*
+                        #      - Any char repetition, e.g. .*, is
+                        #      only allowed to be used in a single regex together with:
+                        #
+                        #
+                        #             - Empty string operators
+                        #             - Other repetitions
+                        #             - Ranges
+                        #             - Repetitions of ranges
+                        #
+                        #
+                        #      - Ranges are only allowed to have:
+                        #
+                        #
+                        #             - Character range
+                        #             - Digits range
+                        #             - Symbols listed in characters allowed for ranges
+                    "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                        # the path.
+                  },
+                },
+                "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                    # occurs. The weights determine the fraction of traffic that flows to
+                    # their corresponding backend service. If all traffic needs to
+                    # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                    #
+                    # After a backend service is identified and before forwarding
+                    # the request to
+                    # the backend service, advanced routing actions such as URL rewrites and
+                    # header transformations are applied depending on additional settings
+                    # specified in this HttpRouteAction.
+                  { # In contrast to a single BackendService in
+                      # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                      # multiple backend services. The volume of traffic for each
+                      # backend service is proportional to the weight specified
+                      # in each WeightedBackendService
+                    "backendService": "A String", # The full or partial URL to the default BackendService
+                        # resource. Before
+                        # forwarding the request to backendService, the load balancer
+                        # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                        # effect for the selected backendService.
+                        #
+                        # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                        #
+                        # headerAction is not supported for load balancers that have
+                        # their loadBalancingScheme set to EXTERNAL.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # the request is passed along to the selected backendService.
+                      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # request before forwarding the request to the backendService.
+                        "A String",
+                      ],
+                      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                          # client.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # response before sending the response back to the client.
+                        "A String",
+                      ],
+                    },
+                    "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                        # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                        #
+                        # The selection of a backend service is determined only for new traffic.
+                        # Once a user's request has been directed to a backend service,
+                        # subsequent requests are sent to the same backend service as
+                        # determined by the backend service's session affinity policy.
+                        # Don't configure session affinity if you're using weighted traffic
+                        # splitting. If you do, the weighted traffic splitting configuration takes
+                        # precedence.
+                        #
+                        # The value must be from 0 to 1000.
+                  },
+                ],
+              },
+              "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                  # is directed if this rule is matched. If routeAction is
+                  # also specified, advanced routing actions, such as URL rewrites,
+                  # take effect before sending the request to the backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+                  # specified by urlRedirect.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                    # was supplied in the request.
+                    #
+                    # The value must be from 1 to 255
+                    # characters.
+                "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                    # set to HTTPS.
+                    # If set to false, the URL scheme of the redirected request
+                    # remains the same as that of the request.
+                    #
+                    # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                    #
+                    # The default is set to false.
+                "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                    # that was supplied in the request.
+                    #
+                    # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                    # the HttpRouteRuleMatch, retaining the remaining portion
+                    # of the URL before redirecting the request.
+                    #
+                    # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                    #
+                    # Supported values are:
+                    #
+                    #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                    #    to 301.
+                    #    - FOUND, which corresponds to 302.
+                    #    - SEE_OTHER which corresponds to 303.
+                    #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                    #    method is retained.
+                    #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                    #    method is retained.
+                "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                    # URL is
+                    # removed before redirecting the request. If set to false, the
+                    # query portion of the original URL is retained.
+                    #
+                    # The default is set to false.
+              },
+            },
+          ],
+          "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+              # desired. routeRules are evaluated in order of priority, from
+              # the lowest to highest number.
+              #
+              # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+            { # The HttpRouteRule setting specifies how to match an HTTP request
+                # and the corresponding routing action that load balancing proxies perform.
+              "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                  # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                  #
+                  # If a policy for an
+                  # error code is not configured for the RouteRule, a policy for
+                  # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                  # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                  # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                  # effect.
+                  #
+                  # For example, consider a UrlMap with the following configuration:
+                  #
+                  #
+                  #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                  #      with policies for 5xx and 4xx errors
+                  #      - A RouteRule for /coming_soon/ is configured for the
+                  #      error code 404.
+                  #
+                  # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                  # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                  # the policy in RouteRule.customErrorResponsePolicy takes
+                  # effect. If any of the requests in this example encounter a 500
+                  # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                  #
+                  # When
+                  # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+                  # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+                  # a retry, if load balancer is successful in reaching the
+                  # service, the customErrorResponsePolicy is ignored and
+                  # the response from the service is returned to the client.
+                  #
+                  # customErrorResponsePolicy is supported only for
+                  # global external Application Load Balancers.
+                  # backend service or backend bucket responds with an error.
+                "errorResponseRules": [ # Specifies rules for returning error responses.
+                    #
+                    # In a given policy, if you specify rules for both a range of error codes
+                    # as well as rules for specific error codes then rules with specific error
+                    # codes have a higher priority. For example, assume that you configure a rule
+                    # for 401 (Un-authorized) code, and another for all 4 series
+                    # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                    # However if the backend service returns a 403, the rule for4xx takes effect.
+                  { # Specifies the mapping between the response code that will be returned along
+                      # with the custom error content and the response code returned by the backend
+                      # service.
+                    "matchResponseCodes": [ # Valid values include:
+                        #
+                        #
+                        #      - A number between 400 and 599: For example
+                        #      401 or 503, in which case the load balancer
+                        #      applies the policy if the error code exactly matches this value.
+                        #      - 5xx: Load Balancer will apply the policy if the
+                        #      backend service responds with any response code in the range of
+                        #      500 to 599.
+                        #    - 4xx: Load
+                        #      Balancer will apply the policy if the backend service responds with any
+                        #      response code in the range of 400 to
+                        #      499.
+                        #
+                        # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                      "A String",
+                    ],
+                    "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                        # error content. If overrideResponseCode is not supplied, the
+                        # same response code returned by the original backend bucket or backend
+                        # service is returned to the client.
+                    "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                        #
+                        # path must start
+                        # with a leading slash. path cannot have trailing slashes.
+                        #
+                        # If the file is not available in backendBucket  or the
+                        # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                        #
+                        # The value must
+                        # be from 1 to 1024 characters
+                  },
+                ],
+                "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                    # contains the custom error content. Examples are:
+                    #
+                    #
+                    #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                    #      - global/backendBuckets/myBackendBucket
+                    #
+                    # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                    # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                    #
+                    # If load balancer cannot reach
+                    # the backendBucket, a simple Not Found Error will
+                    # be returned, with the original response code (oroverrideResponseCode if configured).
+                    #
+                    # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+              },
+              "description": "A String", # The short description conveying the intent of this routeRule.
+                  #
+                  #
+                  # The description can have a maximum length of 1024 characters.
+              "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                  # for the selected backendService.
+                  #
+                  # The headerAction value specified here is applied before the
+                  # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+                  #
+                  # HeaderAction is not supported for load balancers
+                  # that have
+                  # their loadBalancingScheme set to EXTERNAL.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # the request is passed along to the selected backendService.
+                "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # request before forwarding the request to the backendService.
+                  "A String",
+                ],
+                "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                    # client.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # response before sending the response back to the client.
+                  "A String",
+                ],
+              },
+              "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+                  # this routeRule when any of thematchRules are satisfied. However predicates within
+                  # a given matchRule have AND semantics. All predicates
+                  # within a matchRule must match for the request to
+                  # match the rule.
+                { # HttpRouteRuleMatch specifies a set of criteria for matching
+                    # requests to an HttpRouteRule. All specified criteria must
+                    # be satisfied for a match to occur.
+                  "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                      # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                      # that may be part of the original URL.
+                      #
+                      # fullPathMatch must be from 1 to 1024 characters.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                      # specified.
+                  "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                      # corresponding headers in the request.
+                    { # matchRule criteria for request header matches.
+                      "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "headerName": "A String", # The name of the HTTP header to match.
+                          #
+                          # For matching against the HTTP request's authority, use a headerMatch
+                          # with the header name ":authority".
+                          #
+                          # For matching a request's method, use the headerName ":method".
+                          #
+                          # When the URL map is bound to a target gRPC proxy that has
+                          # the validateForProxyless field set to true, only
+                          # non-binary
+                          # user-specified custom metadata and the `content-type` header are supported.
+                          # The following transport-level headers cannot be used in header matching
+                          # rules:
+                          # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                          # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                          # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                          # `grpc-timeout` and `grpc-trace-bin`.
+                      "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                          # match if the preceding match criteria are met. If set to true,
+                          # the headerMatch is considered a match if the preceding
+                          # match criteria are NOT met.
+                          #
+                          # The default setting is false.
+                      "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                          # match takes place whether or not the request's header has a value.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                          # specified in rangeMatch. If the header does not contain an
+                          # integer, number or is empty, the match fails.
+                          #
+                          # For example for a range [-5, 0]
+                          #
+                          #
+                          #       - -3 will match.
+                          #       - 0 will not match.
+                          #       - 0.25 will not match.
+                          #       - -3someString will not match.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          #
+                          # rangeMatch is not supported for load balancers
+                          # that have loadBalancingScheme set to EXTERNAL.
+                          # within the specified integer range.
+                        "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                        "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                      },
+                      "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                          # For more information about regular expression syntax, see Syntax.
+                          #
+                          # For matching against a port specified in the HTTP request, use a
+                          # headerMatch with headerName set to PORT and a regular expression that
+                          # satisfies the RFC2616 Host header's port specifier.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                          # (regional scope) or INTERNAL_MANAGED.
+                      "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                          #
+                          # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    },
+                  ],
+                  "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                      # matches are case sensitive.
+                      #
+                      # The default value is false.
+                      #
+                      # ignoreCase must not be used with regexMatch.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                  "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                      # configuration to a limited set of xDS
+                      # compliant clients. In their xDS requests to the load balancer, xDS clients
+                      # present node
+                      # metadata. When there is a match, the relevant routing configuration
+                      # is made available to those proxies.
+                      #
+                      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                      # the metadata. If its filterMatchCriteria is set to
+                      # MATCH_ALL, then all of its filterLabels must match with
+                      # corresponding labels provided in the metadata. If multiple
+                      # metadata filters are specified, all of them need to be
+                      # satisfied in order to be considered a match.
+                      #
+                      # metadataFilters specified here is applied after those
+                      # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                      #
+                      # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                    { # Opaque filter criteria used by load balancers to restrict routing
+                        # configuration to a limited set of load balancing proxies. Proxies and
+                        # sidecars involved in load balancing would typically present metadata to the
+                        # load balancers that need to match criteria specified here. If a match takes
+                        # place, the relevant configuration is made available to those
+                        # proxies.
+                        #
+                        # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                        # one of thefilterLabels must match the corresponding label provided in
+                        # the metadata. If its filterMatchCriteria is set to
+                        # MATCH_ALL, then all of its filterLabels must match with
+                        # corresponding labels provided in the metadata.
+                        #
+                        # An example for using metadataFilters would be: if
+                        # load balancing involves
+                        # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                      "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                          # metadata based on filterMatchCriteria
+                          #
+                          # This list must not be empty and can have at the most 64 entries.
+                        { # MetadataFilter label name value pairs that are expected
+                            # to match corresponding labels presented as metadata to the load balancer.
+                          "name": "A String", # Name of metadata label.
+                              #
+                              #  The name can have a maximum length of 1024 characters and must be at
+                              # least 1 character long.
+                          "value": "A String", # The value of the label must match the specified value.
+                              #
+                              # value can have a maximum length of 1024 characters.
+                        },
+                      ],
+                      "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                          # within the list of filterLabels and contributes toward the
+                          # overall metadataFilter match.
+                          #
+                          #  Supported values are:
+                          #
+                          #    - MATCH_ANY: at least one of the filterLabels
+                          #    must have a matching label in the provided metadata.
+                          #    - MATCH_ALL: all filterLabels must have
+                          #    matching labels in the provided metadata.
+                    },
+                  ],
+                  "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                      # the :path header after the query string is removed.
+                      #
+                      # A path template pattern can include variables and wildcards.
+                      # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                      # matches a single path segment, and ** that matches zero or
+                      # more path segments. The pattern must follow these rules:
+                      #
+                      #
+                      #       - The value must be between 1 and 1024 characters.
+                      #       - The pattern must start with a leading slash ("/").
+                      #       - No more than 5 operators (variables or wildcards) may appear in
+                      #       the pattern.
+                      #
+                      # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                      # set.
+                  "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                      # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                      #
+                      # The * character inside a prefix match is
+                      # treated as a literal character, not as a wildcard.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                      # used within a matchRule.
+                  "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                      # match corresponding query parameters in the request.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy.
+                    { # HttpRouteRuleMatch criteria for a request's query parameter.
+                      "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                          # parameter exactly matches the contents of exactMatch.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                          # the request, in the absence of which the request match fails.
+                      "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                          # request contains the query parameter, irrespective of whether the
+                          # parameter has a value or not.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                          # parameter matches the regular expression specified byregexMatch. For
+                          # more information about regular expression syntax, see Syntax.
+                          #
+                          # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                          #
+                          # Regular expressions can only be used when the loadBalancingScheme is
+                          # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                          # (regional scope) or INTERNAL_MANAGED.
+                    },
+                  ],
+                  "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                      # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                      # supplied with the original URL. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                      # specified.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "priority": 42, # For routeRules within a given pathMatcher,
+                  # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+                  # of priority, from the lowest to highest number. The priority of a
+                  # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+                  # that matches the request is applied.
+                  #
+                  #
+                  # You cannot configure two or more routeRules with the same priority.
+                  # Priority for each rule must be set to a number from 0 to 2147483647
+                  # inclusive.
+                  #
+                  #
+                  # Priority numbers can have gaps, which enable you to add or remove rules
+                  # in the future without affecting the rest of the rules. For example, 1, 2,
+                  # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+                  # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+                  # without any impact on existing rules.
+              "routeAction": { # In response to a matching matchRule, the load balancer
+                  # performs advanced routing actions, such as URL rewrites and header
+                  # transformations, before forwarding the request to the selected backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # URL maps for classic Application Load Balancers only support
+                  # the urlRewrite action within a route rule'srouteAction.
+                "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                    # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                    # property must be specified. This policy cannot be specified if any target
+                    # backend has Identity-Aware Proxy enabled.
+                  "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                      # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                      # header names can be specified. The cache is bypassed for all `cacheMode`
+                      # values.
+                    "A String",
+                  ],
+                  "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                      # on the backend type: for Backend Services, the complete request URI is
+                      # used; for Backend Buckets, the request URI is used without the protocol or
+                      # host, and only query parameters known to Cloud Storage are included.
+                      # Policy defined on Route Action.
+                    "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                        # parameters will be included. Either specify `excludedQueryParameters`
+                        # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                      "A String",
+                    ],
+                    "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # host is never included in a Backend Bucket's cache key. Attempting to set
+                        # it on a route that points exclusively to Backend Buckets will result in a
+                        # configuration error.
+                    "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket, as the
+                        # protocol is never included in a Backend Bucket's cache key. Attempting to
+                        # set on a route that points exclusively to Backend Buckets will result in
+                        # a configuration error.
+                    "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                        # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                        # is set, the entire query string will be included. If false, the query
+                        # string will be excluded from the cache key entirely.
+                        #
+                        # Note: This field applies to routes that use backend services. Attempting
+                        # to set it on a route that points exclusively to Backend Buckets will
+                        # result in a configuration error. For routes that point to a Backend
+                        # Bucket, use `includedQueryParameters` to define which parameters should
+                        # be part of the cache key.
+                    "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                        # The name=value pair will be used in the cache key Cloud CDN generates.
+                        #
+                        # Note: This setting is only applicable to routes that use a Backend
+                        # Service. It does not affect requests served by a Backend Bucket.
+                        # Attempting to set it on a route that points exclusively to Backend
+                        # Buckets will result in a configuration error. Up to 5 cookie names can be
+                        # specified.
+                      "A String",
+                    ],
+                    "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                      "A String",
+                    ],
+                    "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                        # parameters will be excluded. Either specify `includedQueryParameters`
+                        # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                        # encoded and not treated as delimiters.
+                      "A String",
+                    ],
+                  },
+                  "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                      # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                  "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                      # content. This is used to clamp the max-age (or Expires) value sent to the
+                      # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                      # is used for the response max-age directive, along with a "public"
+                      # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                      # clamps the max-age from the origin (if specified), or else sets the
+                      # response max-age directive to the lesser of the `clientTtl` and
+                      # `defaultTtl`, and also ensures a "public" cache-control directive is
+                      # present. The maximum allowed value is 31,622,400s (1 year). If not
+                      # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                      # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                      # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                      # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                      # greater than that of `maxTtl`. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                      # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                      # accessed objects may be evicted from the cache before the defined TTL. If
+                      # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                      # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                      # `USE_ORIGIN_HEADERS`.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                      # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                      # more than `maxTtl` seconds in the future will be capped at the value of
+                      # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                      # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                      # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                      # Infrequently accessed objects may be evicted from the cache before the
+                      # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                      # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                      # mode.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                      # to apply fine-grained caching for common errors or redirects.
+                      # This can reduce the load on your origin and improve end-user
+                      # experience by reducing response latency.
+                      # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                      # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                      # the specified response code that lack any Cache-Control, Expires, or
+                      # Pragma: no-cache directives. When the `cacheMode` is set to
+                      # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                      # with the specified response code, and overrides any caching headers. By
+                      # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                      #
+                      # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                      # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                      # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                      #
+                      # These defaults can be overridden in `negativeCachingPolicy`.
+                      # If not specified, Cloud CDN applies negative caching by default.
+                  "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                      # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                      # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                      # CDN's default cache TTLs. Note that when specifying an explicit
+                      # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                      # all response codes that you wish to cache. Cloud CDN will not apply any
+                      # default negative caching when a policy exists.
+                    { # Specify CDN TTLs for response error codes.
+                      "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                          # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                          # specified as values, and you cannot specify a status code more than
+                          # once.
+                      "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                          # corresponding status code.
+                          # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                          # objects may be evicted from the cache before the defined TTL.
+                          # as a count of seconds and fractions of seconds at nanosecond
+                          # resolution. It is independent of any calendar and concepts like "day"
+                          # or "month". Range is approximately 10,000 years.
+                        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                            # Durations less than one second are represented with a 0
+                            # `seconds` field and a positive `nanos` field. Must be from 0
+                            # to 999,999,999 inclusive.
+                        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                            # 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
+                      },
+                    },
+                  ],
+                  "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                      # requests into a small number of requests to the origin. If not specified,
+                      # Cloud CDN applies request coalescing by default.
+                  "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                      # content with the origin, or when an error is encountered when refreshing
+                      # the cache.
+                      # This setting defines the default "max-stale" duration for any cached
+                      # responses that do not specify a max-stale directive. Stale responses that
+                      # exceed the TTL configured here will not be served. The default limit
+                      # (max-stale) is 86400s (1 day), which will allow stale content to be
+                      # served up to this limit beyond the max-age (or s-maxage) of a cached
+                      # response.
+                      # The maximum allowed value is 604800 (1 week).
+                      # Set this to zero (0) to disable serve-while-stale.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+                "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                    # information about the W3C recommendation for cross-origin resource sharing
+                    # (CORS), see Fetch API Living
+                    # Standard.
+                  "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                      # indicates that
+                      # the actual request can include user credentials. This field translates to
+                      # the Access-Control-Allow-Credentials header.
+                      #
+                      # Default is false.
+                  "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                      # header.
+                    "A String",
+                  ],
+                  "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                      # more information, see regular expression syntax.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED.
+                    "A String",
+                  ],
+                  "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                      #
+                      # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    "A String",
+                  ],
+                  "disabled": True or False, # If true, disables the CORS policy.
+                      # The default value is false, which indicates that the CORS
+                      # policy is in effect.
+                  "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                      # header.
+                    "A String",
+                  ],
+                  "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                      # seconds. This field translates to the Access-Control-Max-Age
+                      # header.
+                },
+                "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by a load balancer on a percentage of requests before sending
+                    # those requests to the backend service. Similarly requests from clients can
+                    # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                    # that are configured with a fault_injection_policy if:
+                    # 1. The traffic is generated by fault injection AND
+                    # 2. The fault injection is not a delay fault injection.
+                    # Fault injection is not supported with the classic Application Load Balancer
+                    # . To see which load balancers support fault injection,
+                    # see Load
+                    # balancing: Routing and traffic management features.
+                    # the resiliency of clients to backend service failure. As part of fault
+                    # injection, when clients send requests to a backend service, delays can be
+                    # introduced by the load balancer on a percentage of requests before sending
+                    # those request to the backend service. Similarly requests from clients can be
+                    # aborted by the load balancer for a percentage of requests.
+                  "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                      # injection.
+                    "httpStatus": 42, # The HTTP status code used to abort the request.
+                        #
+                        # The value must be from 200 to 599 inclusive.
+                        #
+                        # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                        # according to this
+                        # mapping table. HTTP status 200 is mapped to gRPC status
+                        # UNKNOWN. Injecting an OK status is currently not supported by
+                        # Traffic Director.
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                        # that is aborted as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                  "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                      # injection, before being sent to a backend service.
+                      # request to the backend service as part of fault injection.
+                    "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                    "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                        # which a delay is introduced as part of fault injection.
+                        #
+                        # The value must be from 0.0 to 100.0 inclusive.
+                  },
+                },
+                "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                    # Unlike the timeout field where the timeout duration starts
+                    # from the time the request has been fully processed (known as*end-of-stream*),
+                    # the duration in this field is computed from the beginning of the stream
+                    # until the response has been processed, including all retries. A
+                    # stream that does not complete in this duration is closed.
+                    #
+                    # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                    # with the route.
+                    #
+                    # This field is only allowed if the Url map is used with backend services
+                    # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                    # are shadowed to a separate mirrored backend service. The load balancer does
+                    # not wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host / authority header is suffixed with-shadow.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # are shadowed to a separate mirrored backend service. The load balancer
+                    # doesn't wait for responses from the shadow service. Before sending traffic
+                    # to the shadow service, the host or authority header is suffixed with-shadow.
+                  "backendService": "A String", # The full or partial URL to the BackendService resource being
+                      # mirrored to.
+                      #
+                      # The backend service configured for a mirroring
+                      # policy must reference backends that are of the same type as the original
+                      # backend service matched in the URL map.
+                      #
+                      # Serverless NEG backends are not currently supported as a mirrored
+                      # backend service.
+                  "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+                },
+                "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                  "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                      # If not specified, defaults to 1.
+                  "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                      #
+                      # If not specified, will use the timeout set in theHttpRouteAction field.
+                      # If timeout in the HttpRouteAction field is not set, this field
+                      # uses the largest timeout
+                      # among all backend services associated with the route.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has the validateForProxyless field set to true.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                      # values are:
+                      #
+                      #    - 5xx: retry is attempted if the instance or endpoint
+                      #    responds with any 5xx response code, or if the instance or
+                      #    endpoint does not respond at all. For example, disconnects, reset, read
+                      #    timeout, connection failure, and refused streams.
+                      #    - gateway-error: Similar to 5xx, but only
+                      #    applies to response codes 502, 503 or504.
+                      #    - connect-failure: a retry is attempted on failures
+                      #    connecting to the instance or endpoint. For example, connection
+                      #    timeouts.
+                      #    - retriable-4xx: a retry is attempted if the instance
+                      #    or endpoint responds with a 4xx response code.
+                      #    The only error that you can retry is error code 409.
+                      #    - refused-stream: a retry is attempted if the instance
+                      #    or endpoint resets the stream with a REFUSED_STREAM error
+                      #    code. This reset type indicates that it is safe to retry.
+                      #    - cancelled: a retry is attempted if the gRPC status
+                      #    code in the response header is set to cancelled.
+                      #    - deadline-exceeded: a retry is attempted if the gRPC
+                      #    status code in the response header is set todeadline-exceeded.
+                      #    - internal: a retry is attempted if the gRPC
+                      #    status code in the response header is set tointernal.
+                      #    - resource-exhausted: a retry is attempted if the gRPC
+                      #    status code in the response header is set toresource-exhausted.
+                      #    - unavailable: a retry is attempted if the gRPC
+                      #    status code in the response header is set tounavailable.
+                      #
+                      # Only the following codes are supported when the URL map is bound to
+                      # target gRPC proxy that has validateForProxyless field set to true.
+                      #
+                      #    - cancelled
+                      #    - deadline-exceeded
+                      #    - internal
+                      #    - resource-exhausted
+                      #    - unavailable
+                    "A String",
+                  ],
+                },
+                "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                    # time the request has been fully processed (known as *end-of-stream*)
+                    # up until the response has been processed. Timeout includes
+                    # all retries.
+                    #
+                    # If not specified, this field uses the largest timeout among all backend
+                    # services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                    # to the matched service.
+                    #
+                    #  urlRewrite is the only action supported in UrlMaps
+                    # for classic Application Load Balancers.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # backend service.
+                  "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                      # host header is replaced with contents of hostRewrite.
+                      #
+                      # The value must be from 1 to 255 characters.
+                  "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                      # matching portion of the request's path is replaced bypathPrefixRewrite.
+                      #
+                      # The value must be from 1 to 1024 characters.
+                  "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                      # header) using the HTTP template syntax.
+                      #
+                      # A corresponding
+                      # path_template_match must be specified. Any template variables must exist in
+                      # the path_template_match field.
+                      #
+                      #
+                      #       - -At least one variable must be specified in the path_template_match
+                      #       field
+                      #    - You can omit variables from the rewritten URL
+                      #       - The * and ** operators cannot be matched
+                      #       unless they have a corresponding variable name - e.g.
+                      #       {format=*} or {var=**}.
+                      #
+                      # For example, a path_template_match of /static/{format=**}
+                      # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                      # rewrite, so that /{country}/{format}/{suffix=**} can be
+                      # rewritten as /content/{format}/{country}/{suffix}.
+                      #
+                      # At least
+                      # one non-empty routeRules[].matchRules[].path_template_match is
+                      # required.
+                      #
+                      # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                  "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                    "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                        # It uses RE2 syntax with the following constraints:
+                        #
+                        #
+                        #      - Any single character operators
+                        #      - Groups are allowed to have only submatch operator inside
+                        #      - Groups are allowed only without any char repetition, e.g.
+                        #      .*
+                        #      - Any char repetition, e.g. .*, is
+                        #      only allowed to be used in a single regex together with:
+                        #
+                        #
+                        #             - Empty string operators
+                        #             - Other repetitions
+                        #             - Ranges
+                        #             - Repetitions of ranges
+                        #
+                        #
+                        #      - Ranges are only allowed to have:
+                        #
+                        #
+                        #             - Character range
+                        #             - Digits range
+                        #             - Symbols listed in characters allowed for ranges
+                    "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                        # the path.
+                  },
+                },
+                "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                    # occurs. The weights determine the fraction of traffic that flows to
+                    # their corresponding backend service. If all traffic needs to
+                    # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                    #
+                    # After a backend service is identified and before forwarding
+                    # the request to
+                    # the backend service, advanced routing actions such as URL rewrites and
+                    # header transformations are applied depending on additional settings
+                    # specified in this HttpRouteAction.
+                  { # In contrast to a single BackendService in
+                      # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                      # multiple backend services. The volume of traffic for each
+                      # backend service is proportional to the weight specified
+                      # in each WeightedBackendService
+                    "backendService": "A String", # The full or partial URL to the default BackendService
+                        # resource. Before
+                        # forwarding the request to backendService, the load balancer
+                        # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                        # effect for the selected backendService.
+                        #
+                        # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                        #
+                        # headerAction is not supported for load balancers that have
+                        # their loadBalancingScheme set to EXTERNAL.
+                        #
+                        # Not supported when the URL map is bound to a target gRPC proxy that
+                        # has validateForProxyless field set to true.
+                        # the request is passed along to the selected backendService.
+                      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # request before forwarding the request to the backendService.
+                        "A String",
+                      ],
+                      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                          # client.
+                        { # Specification determining how headers are added to requests or responses.
+                          "headerName": "A String", # The name of the header.
+                          "headerValue": "A String", # The value of the header to add.
+                          "replace": True or False, # If false, headerValue is appended to any values
+                              # that already
+                              # exist for the header. If true, headerValue is set for the
+                              # header, discarding any values that were set for that header.
+                              #
+                              # The default value is true,
+                              # unless a variable is present in headerValue,
+                              # in which case the default value is false.
+                              # .
+                        },
+                      ],
+                      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                          # response before sending the response back to the client.
+                        "A String",
+                      ],
+                    },
+                    "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                        # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                        #
+                        # The selection of a backend service is determined only for new traffic.
+                        # Once a user's request has been directed to a backend service,
+                        # subsequent requests are sent to the same backend service as
+                        # determined by the backend service's session affinity policy.
+                        # Don't configure session affinity if you're using weighted traffic
+                        # splitting. If you do, the weighted traffic splitting configuration takes
+                        # precedence.
+                        #
+                        # The value must be from 0 to 1000.
+                  },
+                ],
+              },
+              "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                  # is directed if this rule is matched. If routeAction is
+                  # also specified, advanced routing actions, such as URL rewrites,
+                  # take effect before sending the request to the backend.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+                  # specified by urlRedirect.
+                  #
+                  #
+                  # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                  #
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                    # was supplied in the request.
+                    #
+                    # The value must be from 1 to 255
+                    # characters.
+                "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                    # set to HTTPS.
+                    # If set to false, the URL scheme of the redirected request
+                    # remains the same as that of the request.
+                    #
+                    # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                    #
+                    # The default is set to false.
+                "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                    # that was supplied in the request.
+                    #
+                    # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                    # the HttpRouteRuleMatch, retaining the remaining portion
+                    # of the URL before redirecting the request.
+                    #
+                    # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                    # supplied, the path of the original request is used for the redirect.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                    #
+                    # Supported values are:
+                    #
+                    #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                    #    to 301.
+                    #    - FOUND, which corresponds to 302.
+                    #    - SEE_OTHER which corresponds to 303.
+                    #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                    #    method is retained.
+                    #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                    #    method is retained.
+                "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                    # URL is
+                    # removed before redirecting the request. If set to false, the
+                    # query portion of the original URL is retained.
+                    #
+                    # The default is set to false.
+              },
+            },
+          ],
+        },
+      ],
+      "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+          # This field is not applicable to global URL maps.
+          # 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.
+      "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+          # maximum of 100 tests per UrlMap.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+        { # Message for the expected URL mappings.
+          "description": "A String", # Description of this test case.
+          "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+              # containing the scheme, host, path and query parameters.
+              #
+              # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+              # the load balancer to backends. For rules with urlRewrite,
+              # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+              #
+              # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+              # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+              # If urlRedirect specifies strip_query, the test
+              # passes only if expectedOutputUrl does not contain any query
+              # parameters.
+              #
+              # expectedOutputUrl is optional whenservice is specified.
+          "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+              # load balancer's redirect response.
+              #
+              # expectedRedirectResponseCode cannot be set whenservice is set.
+          "headers": [ # HTTP headers for this request. If headers contains
+              # a host header, then host must also match the header value.
+            { # HTTP headers used in UrlMapTests.
+              "name": "A String", # Header name.
+              "value": "A String", # Header value.
+            },
+          ],
+          "host": "A String", # Host portion of the URL. If headers contains a host header,
+              # then host must also match the header value.
+          "path": "A String", # Path portion of the URL.
+          "service": "A String", # Expected BackendService or BackendBucket resource
+              # the given URL should be mapped to.
+              #
+              # The service field cannot
+              # be set if expectedRedirectResponseCode is set.
+        },
+      ],
+    },
+  ],
+  "kind": "compute#urlMapList", # 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.
+  "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, urlMap, body=None, requestId=None, x__xgafv=None) + 
Patches the specified UrlMap 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)
+  urlMap: string, Name of the UrlMap resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, 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",
+  ],
+}
+
+ +
+ update(project, urlMap, body=None, requestId=None, x__xgafv=None) + 
Updates the specified UrlMap resource with the data included in the
+request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  urlMap: string, Name of the UrlMap resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a URL Map resource.
+    # 
+    # Compute Engine has two URL Map resources:
+    # 
+    # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+    # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+    # 
+    # A URL map resource is a component of certain types of cloud load balancers
+    # and Traffic Director:
+    # 
+    # * urlMaps are used by global external Application Load
+    # Balancers, classic Application Load Balancers, and cross-region internal
+    # Application Load Balancers.
+    # * regionUrlMaps are used by internal Application Load Balancers,
+    # regional external Application Load Balancers and regional internal
+    # Application Load Balancers.
+    # 
+    # For a list of supported URL map features by the load balancer type, see the
+    # Load balancing features: Routing and traffic management table.
+    # 
+    # For a list of supported URL map features for Traffic Director, see the
+    # Traffic Director features: Routing and traffic management table.
+    # 
+    # This resource defines mappings from hostnames and URL paths to either a
+    # backend service or a backend bucket.
+    # 
+    # To use the global urlMaps resource, the backend service must
+    # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+    # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+    # information, read URL
+    # Map Concepts.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+      # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+      # 
+      # This policy takes
+      # effect at the load balancer level and applies only when no policy has been
+      # defined for the error code at lower levels like PathMatcher, RouteRule and
+      # PathRule within this UrlMap.
+      # 
+      # For example, consider a UrlMap with the
+      # following configuration:
+      # 
+      # 
+      #      - defaultCustomErrorResponsePolicy containing policies for
+      #      responding to 5xx and 4xx errors
+      #      - A PathMatcher configured for *.example.com has
+      #      defaultCustomErrorResponsePolicy for 4xx.
+      # 
+      # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+      # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+      # a request that does not match any host in *.example.com such
+      # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+      # takes effect.
+      # 
+      # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+      # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+      # a retry, if load balancer is successful in reaching the
+      # service, the defaultCustomErrorResponsePolicy is ignored and
+      # the response from the service is returned to the client.
+      # 
+      # defaultCustomErrorResponsePolicy is supported only for
+      # global external Application Load Balancers.
+      # backend service or backend bucket responds with an error.
+    "errorResponseRules": [ # Specifies rules for returning error responses.
+        #
+        # In a given policy, if you specify rules for both a range of error codes
+        # as well as rules for specific error codes then rules with specific error
+        # codes have a higher priority. For example, assume that you configure a rule
+        # for 401 (Un-authorized) code, and another for all 4 series
+        # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+        # However if the backend service returns a 403, the rule for4xx takes effect.
+      { # Specifies the mapping between the response code that will be returned along
+          # with the custom error content and the response code returned by the backend
+          # service.
+        "matchResponseCodes": [ # Valid values include:
+            #
+            #
+            #      - A number between 400 and 599: For example
+            #      401 or 503, in which case the load balancer
+            #      applies the policy if the error code exactly matches this value.
+            #      - 5xx: Load Balancer will apply the policy if the
+            #      backend service responds with any response code in the range of
+            #      500 to 599.
+            #    - 4xx: Load
+            #      Balancer will apply the policy if the backend service responds with any
+            #      response code in the range of 400 to
+            #      499.
+            #
+            # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+          "A String",
+        ],
+        "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+            # error content. If overrideResponseCode is not supplied, the
+            # same response code returned by the original backend bucket or backend
+            # service is returned to the client.
+        "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+            #
+            # path must start
+            # with a leading slash. path cannot have trailing slashes.
+            #
+            # If the file is not available in backendBucket  or the
+            # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+            #
+            # The value must
+            # be from 1 to 1024 characters
+      },
+    ],
+    "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+        # contains the custom error content. Examples are:
+        #
+        #
+        #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+        #      - global/backendBuckets/myBackendBucket
+        #
+        # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+        # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+        #
+        # If load balancer cannot reach
+        # the backendBucket, a simple Not Found Error will
+        # be returned, with the original response code (oroverrideResponseCode if configured).
+        #
+        # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+  },
+  "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+      # hostRules match. The load balancer performs advanced routing
+      # actions, such as URL rewrites and header transformations, before forwarding
+      # the request to the selected backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      #  URL maps for classic Application Load Balancers only support
+      # the urlRewrite action within defaultRouteAction.
+      # 
+      # 
+      # defaultRouteAction has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+    "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+        # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+        # property must be specified. This policy cannot be specified if any target
+        # backend has Identity-Aware Proxy enabled.
+      "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+          # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+          # header names can be specified. The cache is bypassed for all `cacheMode`
+          # values.
+        "A String",
+      ],
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+          # on the backend type: for Backend Services, the complete request URI is
+          # used; for Backend Buckets, the request URI is used without the protocol or
+          # host, and only query parameters known to Cloud Storage are included.
+          # Policy defined on Route Action.
+        "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+            # parameters will be included. Either specify `excludedQueryParameters`
+            # or `includedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+          "A String",
+        ],
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # host is never included in a Backend Bucket's cache key. Attempting to set
+            # it on a route that points exclusively to Backend Buckets will result in a
+            # configuration error.
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket, as the
+            # protocol is never included in a Backend Bucket's cache key. Attempting to
+            # set on a route that points exclusively to Backend Buckets will result in
+            # a configuration error.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+            # `includedQueryParameters` and `excludedQueryParameters`. If neither
+            # is set, the entire query string will be included. If false, the query
+            # string will be excluded from the cache key entirely.
+            #
+            # Note: This field applies to routes that use backend services. Attempting
+            # to set it on a route that points exclusively to Backend Buckets will
+            # result in a configuration error. For routes that point to a Backend
+            # Bucket, use `includedQueryParameters` to define which parameters should
+            # be part of the cache key.
+        "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+            # The name=value pair will be used in the cache key Cloud CDN generates.
+            #
+            # Note: This setting is only applicable to routes that use a Backend
+            # Service. It does not affect requests served by a Backend Bucket.
+            # Attempting to set it on a route that points exclusively to Backend
+            # Buckets will result in a configuration error. Up to 5 cookie names can be
+            # specified.
+          "A String",
+        ],
+        "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+          "A String",
+        ],
+        "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+            # parameters will be excluded. Either specify `includedQueryParameters`
+            # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+            # encoded and not treated as delimiters.
+          "A String",
+        ],
+      },
+      "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+          # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+      "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+          # content. This is used to clamp the max-age (or Expires) value sent to the
+          # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+          # is used for the response max-age directive, along with a "public"
+          # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+          # clamps the max-age from the origin (if specified), or else sets the
+          # response max-age directive to the lesser of the `clientTtl` and
+          # `defaultTtl`, and also ensures a "public" cache-control directive is
+          # present. The maximum allowed value is 31,622,400s (1 year). If not
+          # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+          # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+          # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+          # "always revalidate". The value of `defaultTtl` cannot be set to a value
+          # greater than that of `maxTtl`. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+          # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+          # accessed objects may be evicted from the cache before the defined TTL. If
+          # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+          # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+          # `USE_ORIGIN_HEADERS`.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+          # attempt to set a max-age or s-maxage higher than this, or an Expires header
+          # more than `maxTtl` seconds in the future will be capped at the value of
+          # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+          # Headers sent to the client will not be modified. Setting a TTL of "0" means
+          # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+          # Infrequently accessed objects may be evicted from the cache before the
+          # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+          # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+          # mode.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+          # to apply fine-grained caching for common errors or redirects.
+          # This can reduce the load on your origin and improve end-user
+          # experience by reducing response latency.
+          # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+          # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+          # the specified response code that lack any Cache-Control, Expires, or
+          # Pragma: no-cache directives. When the `cacheMode` is set to
+          # `FORCE_CACHE_ALL`, negative caching applies to all responses
+          # with the specified response code, and overrides any caching headers. By
+          # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+          #
+          # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+          # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+          # * 405 (Method Not Found), 501 (Not Implemented): 60s
+          #
+          # These defaults can be overridden in `negativeCachingPolicy`.
+          # If not specified, Cloud CDN applies negative caching by default.
+      "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+          # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+          # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+          # CDN's default cache TTLs. Note that when specifying an explicit
+          # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+          # all response codes that you wish to cache. Cloud CDN will not apply any
+          # default negative caching when a policy exists.
+        { # Specify CDN TTLs for response error codes.
+          "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+              # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+              # specified as values, and you cannot specify a status code more than
+              # once.
+          "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+              # corresponding status code.
+              # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+              # objects may be evicted from the cache before the defined TTL.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+      ],
+      "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+          # requests into a small number of requests to the origin. If not specified,
+          # Cloud CDN applies request coalescing by default.
+      "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+          # content with the origin, or when an error is encountered when refreshing
+          # the cache.
+          # This setting defines the default "max-stale" duration for any cached
+          # responses that do not specify a max-stale directive. Stale responses that
+          # exceed the TTL configured here will not be served. The default limit
+          # (max-stale) is 86400s (1 day), which will allow stale content to be
+          # served up to this limit beyond the max-age (or s-maxage) of a cached
+          # response.
+          # The maximum allowed value is 604800 (1 week).
+          # Set this to zero (0) to disable serve-while-stale.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+    },
+    "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+        # information about the W3C recommendation for cross-origin resource sharing
+        # (CORS), see Fetch API Living
+        # Standard.
+      "allowCredentials": True or False, # In response to a preflight request, setting this to true
+          # indicates that
+          # the actual request can include user credentials. This field translates to
+          # the Access-Control-Allow-Credentials header.
+          #
+          # Default is false.
+      "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+          # header.
+        "A String",
+      ],
+      "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+          # header.
+        "A String",
+      ],
+      "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+          # more information, see regular expression syntax.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          #
+          # Regular expressions can only be used when the loadBalancingScheme is
+          # set to INTERNAL_SELF_MANAGED.
+        "A String",
+      ],
+      "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+          #
+          # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+        "A String",
+      ],
+      "disabled": True or False, # If true, disables the CORS policy.
+          # The default value is false, which indicates that the CORS
+          # policy is in effect.
+      "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+          # header.
+        "A String",
+      ],
+      "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+          # seconds. This field translates to the Access-Control-Max-Age
+          # header.
+    },
+    "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by a load balancer on a percentage of requests before sending
+        # those requests to the backend service. Similarly requests from clients can
+        # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+        # that are configured with a fault_injection_policy if:
+        # 1. The traffic is generated by fault injection AND
+        # 2. The fault injection is not a delay fault injection.
+        # Fault injection is not supported with the classic Application Load Balancer
+        # . To see which load balancers support fault injection,
+        # see Load
+        # balancing: Routing and traffic management features.
+        # the resiliency of clients to backend service failure. As part of fault
+        # injection, when clients send requests to a backend service, delays can be
+        # introduced by the load balancer on a percentage of requests before sending
+        # those request to the backend service. Similarly requests from clients can be
+        # aborted by the load balancer for a percentage of requests.
+      "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+          # injection.
+        "httpStatus": 42, # The HTTP status code used to abort the request.
+            #
+            # The value must be from 200 to 599 inclusive.
+            #
+            # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+            # according to this
+            # mapping table. HTTP status 200 is mapped to gRPC status
+            # UNKNOWN. Injecting an OK status is currently not supported by
+            # Traffic Director.
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+            # that is aborted as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+      "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+          # injection, before being sent to a backend service.
+          # request to the backend service as part of fault injection.
+        "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+            # which a delay is introduced as part of fault injection.
+            #
+            # The value must be from 0.0 to 100.0 inclusive.
+      },
+    },
+    "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+        # Unlike the timeout field where the timeout duration starts
+        # from the time the request has been fully processed (known as*end-of-stream*),
+        # the duration in this field is computed from the beginning of the stream
+        # until the response has been processed, including all retries. A
+        # stream that does not complete in this duration is closed.
+        #
+        # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+        # with the route.
+        #
+        # This field is only allowed if the Url map is used with backend services
+        # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+        # are shadowed to a separate mirrored backend service. The load balancer does
+        # not wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host / authority header is suffixed with-shadow.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # are shadowed to a separate mirrored backend service. The load balancer
+        # doesn't wait for responses from the shadow service. Before sending traffic
+        # to the shadow service, the host or authority header is suffixed with-shadow.
+      "backendService": "A String", # The full or partial URL to the BackendService resource being
+          # mirrored to.
+          #
+          # The backend service configured for a mirroring
+          # policy must reference backends that are of the same type as the original
+          # backend service matched in the URL map.
+          #
+          # Serverless NEG backends are not currently supported as a mirrored
+          # backend service.
+      "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+    },
+    "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+      "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+          # If not specified, defaults to 1.
+      "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+          #
+          # If not specified, will use the timeout set in theHttpRouteAction field.
+          # If timeout in the HttpRouteAction field is not set, this field
+          # uses the largest timeout
+          # among all backend services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+          # values are:
+          #
+          #    - 5xx: retry is attempted if the instance or endpoint
+          #    responds with any 5xx response code, or if the instance or
+          #    endpoint does not respond at all. For example, disconnects, reset, read
+          #    timeout, connection failure, and refused streams.
+          #    - gateway-error: Similar to 5xx, but only
+          #    applies to response codes 502, 503 or504.
+          #    - connect-failure: a retry is attempted on failures
+          #    connecting to the instance or endpoint. For example, connection
+          #    timeouts.
+          #    - retriable-4xx: a retry is attempted if the instance
+          #    or endpoint responds with a 4xx response code.
+          #    The only error that you can retry is error code 409.
+          #    - refused-stream: a retry is attempted if the instance
+          #    or endpoint resets the stream with a REFUSED_STREAM error
+          #    code. This reset type indicates that it is safe to retry.
+          #    - cancelled: a retry is attempted if the gRPC status
+          #    code in the response header is set to cancelled.
+          #    - deadline-exceeded: a retry is attempted if the gRPC
+          #    status code in the response header is set todeadline-exceeded.
+          #    - internal: a retry is attempted if the gRPC
+          #    status code in the response header is set tointernal.
+          #    - resource-exhausted: a retry is attempted if the gRPC
+          #    status code in the response header is set toresource-exhausted.
+          #    - unavailable: a retry is attempted if the gRPC
+          #    status code in the response header is set tounavailable.
+          #
+          # Only the following codes are supported when the URL map is bound to
+          # target gRPC proxy that has validateForProxyless field set to true.
+          #
+          #    - cancelled
+          #    - deadline-exceeded
+          #    - internal
+          #    - resource-exhausted
+          #    - unavailable
+        "A String",
+      ],
+    },
+    "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+        # time the request has been fully processed (known as *end-of-stream*)
+        # up until the response has been processed. Timeout includes
+        # all retries.
+        #
+        # If not specified, this field uses the largest timeout among all backend
+        # services associated with the route.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # as a count of seconds and fractions of seconds at nanosecond
+        # resolution. It is independent of any calendar and concepts like "day"
+        # or "month". Range is approximately 10,000 years.
+      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+          # Durations less than one second are represented with a 0
+          # `seconds` field and a positive `nanos` field. Must be from 0
+          # to 999,999,999 inclusive.
+      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+          # 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
+    },
+    "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+        # to the matched service.
+        #
+        #  urlRewrite is the only action supported in UrlMaps
+        # for classic Application Load Balancers.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has the validateForProxyless field set to true.
+        # backend service.
+      "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+          # host header is replaced with contents of hostRewrite.
+          #
+          # The value must be from 1 to 255 characters.
+      "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+          # matching portion of the request's path is replaced bypathPrefixRewrite.
+          #
+          # The value must be from 1 to 1024 characters.
+      "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+          # header) using the HTTP template syntax.
+          #
+          # A corresponding
+          # path_template_match must be specified. Any template variables must exist in
+          # the path_template_match field.
+          #
+          #
+          #       - -At least one variable must be specified in the path_template_match
+          #       field
+          #    - You can omit variables from the rewritten URL
+          #       - The * and ** operators cannot be matched
+          #       unless they have a corresponding variable name - e.g.
+          #       {format=*} or {var=**}.
+          #
+          # For example, a path_template_match of /static/{format=**}
+          # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+          # rewrite, so that /{country}/{format}/{suffix=**} can be
+          # rewritten as /content/{format}/{country}/{suffix}.
+          #
+          # At least
+          # one non-empty routeRules[].matchRules[].path_template_match is
+          # required.
+          #
+          # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+      "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+        "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+            # It uses RE2 syntax with the following constraints:
+            #
+            #
+            #      - Any single character operators
+            #      - Groups are allowed to have only submatch operator inside
+            #      - Groups are allowed only without any char repetition, e.g.
+            #      .*
+            #      - Any char repetition, e.g. .*, is
+            #      only allowed to be used in a single regex together with:
+            #
+            #
+            #             - Empty string operators
+            #             - Other repetitions
+            #             - Ranges
+            #             - Repetitions of ranges
+            #
+            #
+            #      - Ranges are only allowed to have:
+            #
+            #
+            #             - Character range
+            #             - Digits range
+            #             - Symbols listed in characters allowed for ranges
+        "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+            # the path.
+      },
+    },
+    "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+        # occurs. The weights determine the fraction of traffic that flows to
+        # their corresponding backend service. If all traffic needs to
+        # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+        #
+        # After a backend service is identified and before forwarding
+        # the request to
+        # the backend service, advanced routing actions such as URL rewrites and
+        # header transformations are applied depending on additional settings
+        # specified in this HttpRouteAction.
+      { # In contrast to a single BackendService in
+          # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+          # multiple backend services. The volume of traffic for each
+          # backend service is proportional to the weight specified
+          # in each WeightedBackendService
+        "backendService": "A String", # The full or partial URL to the default BackendService
+            # resource. Before
+            # forwarding the request to backendService, the load balancer
+            # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+            # effect for the selected backendService.
+            #
+            # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+            #
+            # headerAction is not supported for load balancers that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+            # computed asweight / (sum of all weightedBackendService weights in routeAction).
+            #
+            # The selection of a backend service is determined only for new traffic.
+            # Once a user's request has been directed to a backend service,
+            # subsequent requests are sent to the same backend service as
+            # determined by the backend service's session affinity policy.
+            # Don't configure session affinity if you're using weighted traffic
+            # splitting. If you do, the weighted traffic splitting configuration takes
+            # precedence.
+            #
+            # The value must be from 0 to 1000.
+      },
+    ],
+  },
+  "defaultService": "A String", # The full or partial URL of the defaultService resource to
+      # which traffic is directed if none of the hostRules match.
+      # If defaultRouteAction is also specified, advanced
+      # routing actions, such as URL rewrites, take effect before sending the
+      # request to the backend.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # defaultService has no effect when the URL map is bound
+      # to a target gRPC proxy that has the validateForProxyless field
+      # set to true.
+  "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+      # is redirected to a URL specified by defaultUrlRedirect.
+      # 
+      # 
+      # Only one of defaultUrlRedirect, defaultService
+      # or defaultRouteAction.weightedBackendService can be set.
+      # 
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy.
+    "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+        # was supplied in the request.
+        #
+        # The value must be from 1 to 255
+        # characters.
+    "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+        # set to HTTPS.
+        # If set to false, the URL scheme of the redirected request
+        # remains the same as that of the request.
+        #
+        # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+        #
+        # The default is set to false.
+    "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+        # that was supplied in the request.
+        #
+        # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+        # the HttpRouteRuleMatch, retaining the remaining portion
+        # of the URL before redirecting the request.
+        #
+        # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+        # supplied, the path of the original request is used for the redirect.
+        #
+        # The value must be from 1 to 1024 characters.
+    "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+        #
+        # Supported values are:
+        #
+        #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+        #    to 301.
+        #    - FOUND, which corresponds to 302.
+        #    - SEE_OTHER which corresponds to 303.
+        #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+        #    method is retained.
+        #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+        #    method is retained.
+    "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+        # URL is
+        # removed before redirecting the request. If set to false, the
+        # query portion of the original URL is retained.
+        #
+        # The default is set to false.
+  },
+  "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 is ignored when
+      # inserting a UrlMap. An up-to-date fingerprint must be provided
+      # in order to update the UrlMap, otherwise the request will
+      # fail with error 412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a UrlMap.
+  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+      # for the selected backendService.
+      # 
+      # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+      # 
+      # headerAction is not supported for load balancers
+      # that have
+      # their loadBalancingScheme set to EXTERNAL.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+      # the request is passed along to the selected backendService.
+    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # request before forwarding the request to the backendService.
+      "A String",
+    ],
+    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+        # client.
+      { # Specification determining how headers are added to requests or responses.
+        "headerName": "A String", # The name of the header.
+        "headerValue": "A String", # The value of the header to add.
+        "replace": True or False, # If false, headerValue is appended to any values
+            # that already
+            # exist for the header. If true, headerValue is set for the
+            # header, discarding any values that were set for that header.
+            #
+            # The default value is true,
+            # unless a variable is present in headerValue,
+            # in which case the default value is false.
+            # .
+      },
+    ],
+    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+        # response before sending the response back to the client.
+      "A String",
+    ],
+  },
+  "hostRules": [ # The list of host rules to use against the URL.
+    { # UrlMaps
+        # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+          # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+          # that case, * must be the first character, and if followed by
+          # anything, the immediate following character must be either -
+          # or ..
+          #
+          # * based matching is not supported when the URL map is bound
+          # to a target gRPC proxy that has the validateForProxyless field
+          # set to true.
+        "A String",
+      ],
+      "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+          # of the URL if the hostRule matches the URL's host portion.
+    },
+  ],
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+      # url maps.
+  "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.
+  "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+    { # A matcher for the path portion of the URL. The BackendService
+        # from the longest-matched rule will serve the URL. If no rule was matched, the
+        # default service is used.
+      "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+          # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+          #
+          # This policy takes
+          # effect at the PathMatcher level and applies only when no
+          # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+          # in defaultCustomErrorResponsePolicy, then a policy defined for
+          # the error code in UrlMap.defaultCustomErrorResponsePolicy
+          # takes effect.
+          #
+          # For example, consider a UrlMap with the following
+          # configuration:
+          #
+          #
+          #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+          #      with policies for 5xx and 4xx errors
+          #      - A RouteRule for /coming_soon/ is configured for the
+          #      error code 404.
+          #
+          # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+          # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+          # the policy in RouteRule.customErrorResponsePolicy takes
+          # effect. If any of the requests in this example encounter a 500
+          # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+          #
+          # When
+          # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+          # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+          # a retry, if load balancer is successful in reaching the
+          # service, the defaultCustomErrorResponsePolicy is ignored and
+          # the response from the service is returned to the client.
+          #
+          # defaultCustomErrorResponsePolicy is supported only for
+          # global external Application Load Balancers.
+          # backend service or backend bucket responds with an error.
+        "errorResponseRules": [ # Specifies rules for returning error responses.
+            #
+            # In a given policy, if you specify rules for both a range of error codes
+            # as well as rules for specific error codes then rules with specific error
+            # codes have a higher priority. For example, assume that you configure a rule
+            # for 401 (Un-authorized) code, and another for all 4 series
+            # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+            # However if the backend service returns a 403, the rule for4xx takes effect.
+          { # Specifies the mapping between the response code that will be returned along
+              # with the custom error content and the response code returned by the backend
+              # service.
+            "matchResponseCodes": [ # Valid values include:
+                #
+                #
+                #      - A number between 400 and 599: For example
+                #      401 or 503, in which case the load balancer
+                #      applies the policy if the error code exactly matches this value.
+                #      - 5xx: Load Balancer will apply the policy if the
+                #      backend service responds with any response code in the range of
+                #      500 to 599.
+                #    - 4xx: Load
+                #      Balancer will apply the policy if the backend service responds with any
+                #      response code in the range of 400 to
+                #      499.
+                #
+                # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+              "A String",
+            ],
+            "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                # error content. If overrideResponseCode is not supplied, the
+                # same response code returned by the original backend bucket or backend
+                # service is returned to the client.
+            "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                #
+                # path must start
+                # with a leading slash. path cannot have trailing slashes.
+                #
+                # If the file is not available in backendBucket  or the
+                # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                #
+                # The value must
+                # be from 1 to 1024 characters
+          },
+        ],
+        "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+            # contains the custom error content. Examples are:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+            #      - global/backendBuckets/myBackendBucket
+            #
+            # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+            # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+            #
+            # If load balancer cannot reach
+            # the backendBucket, a simple Not Found Error will
+            # be returned, with the original response code (oroverrideResponseCode if configured).
+            #
+            # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+      },
+      "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+          # pathRules or routeRules match. The load balancer
+          # performs advanced routing actions, such as URL rewrites and
+          # header transformations, before forwarding the request to the
+          # selected backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # URL maps for classic Application Load Balancers only support
+          # the urlRewrite action within a path matcher'sdefaultRouteAction.
+        "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+            # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+            # property must be specified. This policy cannot be specified if any target
+            # backend has Identity-Aware Proxy enabled.
+          "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+              # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+              # header names can be specified. The cache is bypassed for all `cacheMode`
+              # values.
+            "A String",
+          ],
+          "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+              # on the backend type: for Backend Services, the complete request URI is
+              # used; for Backend Buckets, the request URI is used without the protocol or
+              # host, and only query parameters known to Cloud Storage are included.
+              # Policy defined on Route Action.
+            "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                # parameters will be included. Either specify `excludedQueryParameters`
+                # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+              "A String",
+            ],
+            "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # host is never included in a Backend Bucket's cache key. Attempting to set
+                # it on a route that points exclusively to Backend Buckets will result in a
+                # configuration error.
+            "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket, as the
+                # protocol is never included in a Backend Bucket's cache key. Attempting to
+                # set on a route that points exclusively to Backend Buckets will result in
+                # a configuration error.
+            "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                # is set, the entire query string will be included. If false, the query
+                # string will be excluded from the cache key entirely.
+                #
+                # Note: This field applies to routes that use backend services. Attempting
+                # to set it on a route that points exclusively to Backend Buckets will
+                # result in a configuration error. For routes that point to a Backend
+                # Bucket, use `includedQueryParameters` to define which parameters should
+                # be part of the cache key.
+            "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                # The name=value pair will be used in the cache key Cloud CDN generates.
+                #
+                # Note: This setting is only applicable to routes that use a Backend
+                # Service. It does not affect requests served by a Backend Bucket.
+                # Attempting to set it on a route that points exclusively to Backend
+                # Buckets will result in a configuration error. Up to 5 cookie names can be
+                # specified.
+              "A String",
+            ],
+            "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+              "A String",
+            ],
+            "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                # parameters will be excluded. Either specify `includedQueryParameters`
+                # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                # encoded and not treated as delimiters.
+              "A String",
+            ],
+          },
+          "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+              # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+          "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+              # content. This is used to clamp the max-age (or Expires) value sent to the
+              # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+              # is used for the response max-age directive, along with a "public"
+              # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+              # clamps the max-age from the origin (if specified), or else sets the
+              # response max-age directive to the lesser of the `clientTtl` and
+              # `defaultTtl`, and also ensures a "public" cache-control directive is
+              # present. The maximum allowed value is 31,622,400s (1 year). If not
+              # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+              # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+              # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+              # "always revalidate". The value of `defaultTtl` cannot be set to a value
+              # greater than that of `maxTtl`. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+              # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+              # accessed objects may be evicted from the cache before the defined TTL. If
+              # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+              # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+              # `USE_ORIGIN_HEADERS`.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+              # attempt to set a max-age or s-maxage higher than this, or an Expires header
+              # more than `maxTtl` seconds in the future will be capped at the value of
+              # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+              # Headers sent to the client will not be modified. Setting a TTL of "0" means
+              # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+              # Infrequently accessed objects may be evicted from the cache before the
+              # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+              # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+              # mode.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+              # to apply fine-grained caching for common errors or redirects.
+              # This can reduce the load on your origin and improve end-user
+              # experience by reducing response latency.
+              # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+              # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+              # the specified response code that lack any Cache-Control, Expires, or
+              # Pragma: no-cache directives. When the `cacheMode` is set to
+              # `FORCE_CACHE_ALL`, negative caching applies to all responses
+              # with the specified response code, and overrides any caching headers. By
+              # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+              #
+              # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+              # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+              # * 405 (Method Not Found), 501 (Not Implemented): 60s
+              #
+              # These defaults can be overridden in `negativeCachingPolicy`.
+              # If not specified, Cloud CDN applies negative caching by default.
+          "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+              # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+              # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+              # CDN's default cache TTLs. Note that when specifying an explicit
+              # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+              # all response codes that you wish to cache. Cloud CDN will not apply any
+              # default negative caching when a policy exists.
+            { # Specify CDN TTLs for response error codes.
+              "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                  # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                  # specified as values, and you cannot specify a status code more than
+                  # once.
+              "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                  # corresponding status code.
+                  # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                  # objects may be evicted from the cache before the defined TTL.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+          ],
+          "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+              # requests into a small number of requests to the origin. If not specified,
+              # Cloud CDN applies request coalescing by default.
+          "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+              # content with the origin, or when an error is encountered when refreshing
+              # the cache.
+              # This setting defines the default "max-stale" duration for any cached
+              # responses that do not specify a max-stale directive. Stale responses that
+              # exceed the TTL configured here will not be served. The default limit
+              # (max-stale) is 86400s (1 day), which will allow stale content to be
+              # served up to this limit beyond the max-age (or s-maxage) of a cached
+              # response.
+              # The maximum allowed value is 604800 (1 week).
+              # Set this to zero (0) to disable serve-while-stale.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+        },
+        "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+            # information about the W3C recommendation for cross-origin resource sharing
+            # (CORS), see Fetch API Living
+            # Standard.
+          "allowCredentials": True or False, # In response to a preflight request, setting this to true
+              # indicates that
+              # the actual request can include user credentials. This field translates to
+              # the Access-Control-Allow-Credentials header.
+              #
+              # Default is false.
+          "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+              # header.
+            "A String",
+          ],
+          "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+              # header.
+            "A String",
+          ],
+          "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+              # more information, see regular expression syntax.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              #
+              # Regular expressions can only be used when the loadBalancingScheme is
+              # set to INTERNAL_SELF_MANAGED.
+            "A String",
+          ],
+          "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+              #
+              # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            "A String",
+          ],
+          "disabled": True or False, # If true, disables the CORS policy.
+              # The default value is false, which indicates that the CORS
+              # policy is in effect.
+          "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+              # header.
+            "A String",
+          ],
+          "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+              # seconds. This field translates to the Access-Control-Max-Age
+              # header.
+        },
+        "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by a load balancer on a percentage of requests before sending
+            # those requests to the backend service. Similarly requests from clients can
+            # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+            # that are configured with a fault_injection_policy if:
+            # 1. The traffic is generated by fault injection AND
+            # 2. The fault injection is not a delay fault injection.
+            # Fault injection is not supported with the classic Application Load Balancer
+            # . To see which load balancers support fault injection,
+            # see Load
+            # balancing: Routing and traffic management features.
+            # the resiliency of clients to backend service failure. As part of fault
+            # injection, when clients send requests to a backend service, delays can be
+            # introduced by the load balancer on a percentage of requests before sending
+            # those request to the backend service. Similarly requests from clients can be
+            # aborted by the load balancer for a percentage of requests.
+          "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+              # injection.
+            "httpStatus": 42, # The HTTP status code used to abort the request.
+                #
+                # The value must be from 200 to 599 inclusive.
+                #
+                # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                # according to this
+                # mapping table. HTTP status 200 is mapped to gRPC status
+                # UNKNOWN. Injecting an OK status is currently not supported by
+                # Traffic Director.
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                # that is aborted as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+          "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+              # injection, before being sent to a backend service.
+              # request to the backend service as part of fault injection.
+            "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                # which a delay is introduced as part of fault injection.
+                #
+                # The value must be from 0.0 to 100.0 inclusive.
+          },
+        },
+        "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+            # Unlike the timeout field where the timeout duration starts
+            # from the time the request has been fully processed (known as*end-of-stream*),
+            # the duration in this field is computed from the beginning of the stream
+            # until the response has been processed, including all retries. A
+            # stream that does not complete in this duration is closed.
+            #
+            # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+            # with the route.
+            #
+            # This field is only allowed if the Url map is used with backend services
+            # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+            # are shadowed to a separate mirrored backend service. The load balancer does
+            # not wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host / authority header is suffixed with-shadow.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # are shadowed to a separate mirrored backend service. The load balancer
+            # doesn't wait for responses from the shadow service. Before sending traffic
+            # to the shadow service, the host or authority header is suffixed with-shadow.
+          "backendService": "A String", # The full or partial URL to the BackendService resource being
+              # mirrored to.
+              #
+              # The backend service configured for a mirroring
+              # policy must reference backends that are of the same type as the original
+              # backend service matched in the URL map.
+              #
+              # Serverless NEG backends are not currently supported as a mirrored
+              # backend service.
+          "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+        },
+        "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+          "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+              # If not specified, defaults to 1.
+          "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+              #
+              # If not specified, will use the timeout set in theHttpRouteAction field.
+              # If timeout in the HttpRouteAction field is not set, this field
+              # uses the largest timeout
+              # among all backend services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+              # values are:
+              #
+              #    - 5xx: retry is attempted if the instance or endpoint
+              #    responds with any 5xx response code, or if the instance or
+              #    endpoint does not respond at all. For example, disconnects, reset, read
+              #    timeout, connection failure, and refused streams.
+              #    - gateway-error: Similar to 5xx, but only
+              #    applies to response codes 502, 503 or504.
+              #    - connect-failure: a retry is attempted on failures
+              #    connecting to the instance or endpoint. For example, connection
+              #    timeouts.
+              #    - retriable-4xx: a retry is attempted if the instance
+              #    or endpoint responds with a 4xx response code.
+              #    The only error that you can retry is error code 409.
+              #    - refused-stream: a retry is attempted if the instance
+              #    or endpoint resets the stream with a REFUSED_STREAM error
+              #    code. This reset type indicates that it is safe to retry.
+              #    - cancelled: a retry is attempted if the gRPC status
+              #    code in the response header is set to cancelled.
+              #    - deadline-exceeded: a retry is attempted if the gRPC
+              #    status code in the response header is set todeadline-exceeded.
+              #    - internal: a retry is attempted if the gRPC
+              #    status code in the response header is set tointernal.
+              #    - resource-exhausted: a retry is attempted if the gRPC
+              #    status code in the response header is set toresource-exhausted.
+              #    - unavailable: a retry is attempted if the gRPC
+              #    status code in the response header is set tounavailable.
+              #
+              # Only the following codes are supported when the URL map is bound to
+              # target gRPC proxy that has validateForProxyless field set to true.
+              #
+              #    - cancelled
+              #    - deadline-exceeded
+              #    - internal
+              #    - resource-exhausted
+              #    - unavailable
+            "A String",
+          ],
+        },
+        "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+            # time the request has been fully processed (known as *end-of-stream*)
+            # up until the response has been processed. Timeout includes
+            # all retries.
+            #
+            # If not specified, this field uses the largest timeout among all backend
+            # services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+            # to the matched service.
+            #
+            #  urlRewrite is the only action supported in UrlMaps
+            # for classic Application Load Balancers.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # backend service.
+          "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+              # host header is replaced with contents of hostRewrite.
+              #
+              # The value must be from 1 to 255 characters.
+          "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+              # matching portion of the request's path is replaced bypathPrefixRewrite.
+              #
+              # The value must be from 1 to 1024 characters.
+          "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+              # header) using the HTTP template syntax.
+              #
+              # A corresponding
+              # path_template_match must be specified. Any template variables must exist in
+              # the path_template_match field.
+              #
+              #
+              #       - -At least one variable must be specified in the path_template_match
+              #       field
+              #    - You can omit variables from the rewritten URL
+              #       - The * and ** operators cannot be matched
+              #       unless they have a corresponding variable name - e.g.
+              #       {format=*} or {var=**}.
+              #
+              # For example, a path_template_match of /static/{format=**}
+              # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+              # rewrite, so that /{country}/{format}/{suffix=**} can be
+              # rewritten as /content/{format}/{country}/{suffix}.
+              #
+              # At least
+              # one non-empty routeRules[].matchRules[].path_template_match is
+              # required.
+              #
+              # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+          "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+            "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                # It uses RE2 syntax with the following constraints:
+                #
+                #
+                #      - Any single character operators
+                #      - Groups are allowed to have only submatch operator inside
+                #      - Groups are allowed only without any char repetition, e.g.
+                #      .*
+                #      - Any char repetition, e.g. .*, is
+                #      only allowed to be used in a single regex together with:
+                #
+                #
+                #             - Empty string operators
+                #             - Other repetitions
+                #             - Ranges
+                #             - Repetitions of ranges
+                #
+                #
+                #      - Ranges are only allowed to have:
+                #
+                #
+                #             - Character range
+                #             - Digits range
+                #             - Symbols listed in characters allowed for ranges
+            "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                # the path.
+          },
+        },
+        "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+            # occurs. The weights determine the fraction of traffic that flows to
+            # their corresponding backend service. If all traffic needs to
+            # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+            #
+            # After a backend service is identified and before forwarding
+            # the request to
+            # the backend service, advanced routing actions such as URL rewrites and
+            # header transformations are applied depending on additional settings
+            # specified in this HttpRouteAction.
+          { # In contrast to a single BackendService in
+              # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+              # multiple backend services. The volume of traffic for each
+              # backend service is proportional to the weight specified
+              # in each WeightedBackendService
+            "backendService": "A String", # The full or partial URL to the default BackendService
+                # resource. Before
+                # forwarding the request to backendService, the load balancer
+                # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                # effect for the selected backendService.
+                #
+                # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                #
+                # headerAction is not supported for load balancers that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                #
+                # The selection of a backend service is determined only for new traffic.
+                # Once a user's request has been directed to a backend service,
+                # subsequent requests are sent to the same backend service as
+                # determined by the backend service's session affinity policy.
+                # Don't configure session affinity if you're using weighted traffic
+                # splitting. If you do, the weighted traffic splitting configuration takes
+                # precedence.
+                #
+                # The value must be from 0 to 1000.
+          },
+        ],
+      },
+      "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+          # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+          # matched. For example, the
+          # following are all valid URLs to a BackendService resource:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+          #      - compute/v1/projects/project/global/backendServices/backendService
+          #      - global/backendServices/backendService
+          #
+          #
+          # If defaultRouteAction is also specified, advanced
+          # routing actions, such as URL rewrites, take effect before sending the
+          # request to the backend.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Authorization requires one or more of the following Google IAM permissions on the
+          # specified resource default_service:
+          #
+          #
+          #       - compute.backendBuckets.use
+          #       - compute.backendServices.use
+      "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+          # by defaultUrlRedirect.
+          #
+          #
+          # Only one of defaultUrlRedirect, defaultService
+          # or defaultRouteAction.weightedBackendService can be set.
+          #
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+        "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+            # was supplied in the request.
+            #
+            # The value must be from 1 to 255
+            # characters.
+        "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+            # set to HTTPS.
+            # If set to false, the URL scheme of the redirected request
+            # remains the same as that of the request.
+            #
+            # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+            #
+            # The default is set to false.
+        "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+            # that was supplied in the request.
+            #
+            # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+            # the HttpRouteRuleMatch, retaining the remaining portion
+            # of the URL before redirecting the request.
+            #
+            # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+            # supplied, the path of the original request is used for the redirect.
+            #
+            # The value must be from 1 to 1024 characters.
+        "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+            #
+            # Supported values are:
+            #
+            #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+            #    to 301.
+            #    - FOUND, which corresponds to 302.
+            #    - SEE_OTHER which corresponds to 303.
+            #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+            #    method is retained.
+            #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+            #    method is retained.
+        "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+            # URL is
+            # removed before redirecting the request. If set to false, the
+            # query portion of the original URL is retained.
+            #
+            # The default is set to false.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+          # for the selected backend service.
+          #
+          # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+          #
+          # HeaderAction is not supported for load balancers
+          # that have
+          # their loadBalancingScheme set to EXTERNAL.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # the request is passed along to the selected backendService.
+        "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # request before forwarding the request to the backendService.
+          "A String",
+        ],
+        "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+            # client.
+          { # Specification determining how headers are added to requests or responses.
+            "headerName": "A String", # The name of the header.
+            "headerValue": "A String", # The value of the header to add.
+            "replace": True or False, # If false, headerValue is appended to any values
+                # that already
+                # exist for the header. If true, headerValue is set for the
+                # header, discarding any values that were set for that header.
+                #
+                # The default value is true,
+                # unless a variable is present in headerValue,
+                # in which case the default value is false.
+                # .
+          },
+        ],
+        "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+            # response before sending the response back to the client.
+          "A String",
+        ],
+      },
+      "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+      "pathRules": [ # The list of path rules. Use this list instead of routeRules
+          # when routing based on simple path matching is all that's required. A path
+          # rule can only include a wildcard character (*) after a
+          # forward slash character ("/").
+          #
+          # The order by which path rules are specified does not matter.
+          # Matches are always done on the longest-path-first basis.
+          #
+          # For example: a pathRule with a path /a/b/c/* will match
+          # before /a/b/* irrespective of the order in which those paths appear in this
+          # list.
+          #
+          # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+        { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the PathRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A PathRule for /coming_soon/ is configured for the error
+              #      code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in PathRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "paths": [ # The list of path patterns to match. Each must start with /
+              # and the only place a * is allowed is at the end following
+              # a /.  The string fed to the path matcher does not include
+              # any text after the first ? or #, and
+              # those chars are not allowed here.
+            "A String",
+          ],
+          "routeAction": { # In response to a matching path, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected
+              # backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a path rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+      "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+          # desired. routeRules are evaluated in order of priority, from
+          # the lowest to highest number.
+          #
+          # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+        { # The HttpRouteRule setting specifies how to match an HTTP request
+            # and the corresponding routing action that load balancing proxies perform.
+          "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+              # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+              #
+              # If a policy for an
+              # error code is not configured for the RouteRule, a policy for
+              # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+              # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+              # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+              # effect.
+              #
+              # For example, consider a UrlMap with the following configuration:
+              #
+              #
+              #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+              #      with policies for 5xx and 4xx errors
+              #      - A RouteRule for /coming_soon/ is configured for the
+              #      error code 404.
+              #
+              # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+              # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+              # the policy in RouteRule.customErrorResponsePolicy takes
+              # effect. If any of the requests in this example encounter a 500
+              # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+              #
+              # When
+              # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+              # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+              # a retry, if load balancer is successful in reaching the
+              # service, the customErrorResponsePolicy is ignored and
+              # the response from the service is returned to the client.
+              #
+              # customErrorResponsePolicy is supported only for
+              # global external Application Load Balancers.
+              # backend service or backend bucket responds with an error.
+            "errorResponseRules": [ # Specifies rules for returning error responses.
+                #
+                # In a given policy, if you specify rules for both a range of error codes
+                # as well as rules for specific error codes then rules with specific error
+                # codes have a higher priority. For example, assume that you configure a rule
+                # for 401 (Un-authorized) code, and another for all 4 series
+                # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                # However if the backend service returns a 403, the rule for4xx takes effect.
+              { # Specifies the mapping between the response code that will be returned along
+                  # with the custom error content and the response code returned by the backend
+                  # service.
+                "matchResponseCodes": [ # Valid values include:
+                    #
+                    #
+                    #      - A number between 400 and 599: For example
+                    #      401 or 503, in which case the load balancer
+                    #      applies the policy if the error code exactly matches this value.
+                    #      - 5xx: Load Balancer will apply the policy if the
+                    #      backend service responds with any response code in the range of
+                    #      500 to 599.
+                    #    - 4xx: Load
+                    #      Balancer will apply the policy if the backend service responds with any
+                    #      response code in the range of 400 to
+                    #      499.
+                    #
+                    # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                  "A String",
+                ],
+                "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                    # error content. If overrideResponseCode is not supplied, the
+                    # same response code returned by the original backend bucket or backend
+                    # service is returned to the client.
+                "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                    #
+                    # path must start
+                    # with a leading slash. path cannot have trailing slashes.
+                    #
+                    # If the file is not available in backendBucket  or the
+                    # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                    #
+                    # The value must
+                    # be from 1 to 1024 characters
+              },
+            ],
+            "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                # contains the custom error content. Examples are:
+                #
+                #
+                #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                #      - global/backendBuckets/myBackendBucket
+                #
+                # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                #
+                # If load balancer cannot reach
+                # the backendBucket, a simple Not Found Error will
+                # be returned, with the original response code (oroverrideResponseCode if configured).
+                #
+                # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+          },
+          "description": "A String", # The short description conveying the intent of this routeRule.
+              #
+              #
+              # The description can have a maximum length of 1024 characters.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+              # for the selected backendService.
+              #
+              # The headerAction value specified here is applied before the
+              # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+              #
+              # HeaderAction is not supported for load balancers
+              # that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+              # this routeRule when any of thematchRules are satisfied. However predicates within
+              # a given matchRule have AND semantics. All predicates
+              # within a matchRule must match for the request to
+              # match the rule.
+            { # HttpRouteRuleMatch specifies a set of criteria for matching
+                # requests to an HttpRouteRule. All specified criteria must
+                # be satisfied for a match to occur.
+              "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                  # that may be part of the original URL.
+                  #
+                  # fullPathMatch must be from 1 to 1024 characters.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+              "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                  # corresponding headers in the request.
+                { # matchRule criteria for request header matches.
+                  "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "headerName": "A String", # The name of the HTTP header to match.
+                      #
+                      # For matching against the HTTP request's authority, use a headerMatch
+                      # with the header name ":authority".
+                      #
+                      # For matching a request's method, use the headerName ":method".
+                      #
+                      # When the URL map is bound to a target gRPC proxy that has
+                      # the validateForProxyless field set to true, only
+                      # non-binary
+                      # user-specified custom metadata and the `content-type` header are supported.
+                      # The following transport-level headers cannot be used in header matching
+                      # rules:
+                      # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                      # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                      # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                      # `grpc-timeout` and `grpc-trace-bin`.
+                  "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                      # match if the preceding match criteria are met. If set to true,
+                      # the headerMatch is considered a match if the preceding
+                      # match criteria are NOT met.
+                      #
+                      # The default setting is false.
+                  "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                      # match takes place whether or not the request's header has a value.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                      # specified in rangeMatch. If the header does not contain an
+                      # integer, number or is empty, the match fails.
+                      #
+                      # For example for a range [-5, 0]
+                      #
+                      #
+                      #       - -3 will match.
+                      #       - 0 will not match.
+                      #       - 0.25 will not match.
+                      #       - -3someString will not match.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # rangeMatch is not supported for load balancers
+                      # that have loadBalancingScheme set to EXTERNAL.
+                      # within the specified integer range.
+                    "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                    "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                  },
+                  "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                      # For more information about regular expression syntax, see Syntax.
+                      #
+                      # For matching against a port specified in the HTTP request, use a
+                      # headerMatch with headerName set to PORT and a regular expression that
+                      # satisfies the RFC2616 Host header's port specifier.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                  "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                      #
+                      # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                },
+              ],
+              "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                  # matches are case sensitive.
+                  #
+                  # The default value is false.
+                  #
+                  # ignoreCase must not be used with regexMatch.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+              "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                  # configuration to a limited set of xDS
+                  # compliant clients. In their xDS requests to the load balancer, xDS clients
+                  # present node
+                  # metadata. When there is a match, the relevant routing configuration
+                  # is made available to those proxies.
+                  #
+                  # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                  # the metadata. If its filterMatchCriteria is set to
+                  # MATCH_ALL, then all of its filterLabels must match with
+                  # corresponding labels provided in the metadata. If multiple
+                  # metadata filters are specified, all of them need to be
+                  # satisfied in order to be considered a match.
+                  #
+                  # metadataFilters specified here is applied after those
+                  # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                  #
+                  # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                { # Opaque filter criteria used by load balancers to restrict routing
+                    # configuration to a limited set of load balancing proxies. Proxies and
+                    # sidecars involved in load balancing would typically present metadata to the
+                    # load balancers that need to match criteria specified here. If a match takes
+                    # place, the relevant configuration is made available to those
+                    # proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                    # one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata.
+                    #
+                    # An example for using metadataFilters would be: if
+                    # load balancing involves
+                    # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                  "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                      # metadata based on filterMatchCriteria
+                      #
+                      # This list must not be empty and can have at the most 64 entries.
+                    { # MetadataFilter label name value pairs that are expected
+                        # to match corresponding labels presented as metadata to the load balancer.
+                      "name": "A String", # Name of metadata label.
+                          #
+                          #  The name can have a maximum length of 1024 characters and must be at
+                          # least 1 character long.
+                      "value": "A String", # The value of the label must match the specified value.
+                          #
+                          # value can have a maximum length of 1024 characters.
+                    },
+                  ],
+                  "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                      # within the list of filterLabels and contributes toward the
+                      # overall metadataFilter match.
+                      #
+                      #  Supported values are:
+                      #
+                      #    - MATCH_ANY: at least one of the filterLabels
+                      #    must have a matching label in the provided metadata.
+                      #    - MATCH_ALL: all filterLabels must have
+                      #    matching labels in the provided metadata.
+                },
+              ],
+              "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                  # the :path header after the query string is removed.
+                  #
+                  # A path template pattern can include variables and wildcards.
+                  # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                  # matches a single path segment, and ** that matches zero or
+                  # more path segments. The pattern must follow these rules:
+                  #
+                  #
+                  #       - The value must be between 1 and 1024 characters.
+                  #       - The pattern must start with a leading slash ("/").
+                  #       - No more than 5 operators (variables or wildcards) may appear in
+                  #       the pattern.
+                  #
+                  # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                  # set.
+              "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                  # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                  #
+                  # The value must be from 1 to 1024 characters.
+                  #
+                  # The * character inside a prefix match is
+                  # treated as a literal character, not as a wildcard.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                  # used within a matchRule.
+              "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                  # match corresponding query parameters in the request.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                { # HttpRouteRuleMatch criteria for a request's query parameter.
+                  "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter exactly matches the contents of exactMatch.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                      # the request, in the absence of which the request match fails.
+                  "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                      # request contains the query parameter, irrespective of whether the
+                      # parameter has a value or not.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                  "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                      # parameter matches the regular expression specified byregexMatch. For
+                      # more information about regular expression syntax, see Syntax.
+                      #
+                      # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                      #
+                      # Regular expressions can only be used when the loadBalancingScheme is
+                      # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                      # (regional scope) or INTERNAL_MANAGED.
+                },
+              ],
+              "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                  # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                  # supplied with the original URL. For
+                  # more information about regular expression syntax, see Syntax.
+                  #
+                  # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                  # specified.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                  # (regional scope) or INTERNAL_MANAGED.
+            },
+          ],
+          "priority": 42, # For routeRules within a given pathMatcher,
+              # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+              # of priority, from the lowest to highest number. The priority of a
+              # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+              # that matches the request is applied.
+              #
+              #
+              # You cannot configure two or more routeRules with the same priority.
+              # Priority for each rule must be set to a number from 0 to 2147483647
+              # inclusive.
+              #
+              #
+              # Priority numbers can have gaps, which enable you to add or remove rules
+              # in the future without affecting the rest of the rules. For example, 1, 2,
+              # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+              # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+              # without any impact on existing rules.
+          "routeAction": { # In response to a matching matchRule, the load balancer
+              # performs advanced routing actions, such as URL rewrites and header
+              # transformations, before forwarding the request to the selected backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # URL maps for classic Application Load Balancers only support
+              # the urlRewrite action within a route rule'srouteAction.
+            "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                # property must be specified. This policy cannot be specified if any target
+                # backend has Identity-Aware Proxy enabled.
+              "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                  # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                  # header names can be specified. The cache is bypassed for all `cacheMode`
+                  # values.
+                "A String",
+              ],
+              "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                  # on the backend type: for Backend Services, the complete request URI is
+                  # used; for Backend Buckets, the request URI is used without the protocol or
+                  # host, and only query parameters known to Cloud Storage are included.
+                  # Policy defined on Route Action.
+                "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                    # parameters will be included. Either specify `excludedQueryParameters`
+                    # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                  "A String",
+                ],
+                "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # host is never included in a Backend Bucket's cache key. Attempting to set
+                    # it on a route that points exclusively to Backend Buckets will result in a
+                    # configuration error.
+                "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket, as the
+                    # protocol is never included in a Backend Bucket's cache key. Attempting to
+                    # set on a route that points exclusively to Backend Buckets will result in
+                    # a configuration error.
+                "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                    # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                    # is set, the entire query string will be included. If false, the query
+                    # string will be excluded from the cache key entirely.
+                    #
+                    # Note: This field applies to routes that use backend services. Attempting
+                    # to set it on a route that points exclusively to Backend Buckets will
+                    # result in a configuration error. For routes that point to a Backend
+                    # Bucket, use `includedQueryParameters` to define which parameters should
+                    # be part of the cache key.
+                "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                    # The name=value pair will be used in the cache key Cloud CDN generates.
+                    #
+                    # Note: This setting is only applicable to routes that use a Backend
+                    # Service. It does not affect requests served by a Backend Bucket.
+                    # Attempting to set it on a route that points exclusively to Backend
+                    # Buckets will result in a configuration error. Up to 5 cookie names can be
+                    # specified.
+                  "A String",
+                ],
+                "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                  "A String",
+                ],
+                "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                    # parameters will be excluded. Either specify `includedQueryParameters`
+                    # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                    # encoded and not treated as delimiters.
+                  "A String",
+                ],
+              },
+              "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                  # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+              "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                  # content. This is used to clamp the max-age (or Expires) value sent to the
+                  # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                  # is used for the response max-age directive, along with a "public"
+                  # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                  # clamps the max-age from the origin (if specified), or else sets the
+                  # response max-age directive to the lesser of the `clientTtl` and
+                  # `defaultTtl`, and also ensures a "public" cache-control directive is
+                  # present. The maximum allowed value is 31,622,400s (1 year). If not
+                  # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                  # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                  # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                  # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                  # greater than that of `maxTtl`. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                  # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                  # accessed objects may be evicted from the cache before the defined TTL. If
+                  # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                  # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                  # `USE_ORIGIN_HEADERS`.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                  # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                  # more than `maxTtl` seconds in the future will be capped at the value of
+                  # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                  # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                  # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                  # Infrequently accessed objects may be evicted from the cache before the
+                  # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                  # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                  # mode.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                  # to apply fine-grained caching for common errors or redirects.
+                  # This can reduce the load on your origin and improve end-user
+                  # experience by reducing response latency.
+                  # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                  # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                  # the specified response code that lack any Cache-Control, Expires, or
+                  # Pragma: no-cache directives. When the `cacheMode` is set to
+                  # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                  # with the specified response code, and overrides any caching headers. By
+                  # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                  #
+                  # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                  # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                  # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                  #
+                  # These defaults can be overridden in `negativeCachingPolicy`.
+                  # If not specified, Cloud CDN applies negative caching by default.
+              "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                  # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                  # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                  # CDN's default cache TTLs. Note that when specifying an explicit
+                  # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                  # all response codes that you wish to cache. Cloud CDN will not apply any
+                  # default negative caching when a policy exists.
+                { # Specify CDN TTLs for response error codes.
+                  "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                      # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                      # specified as values, and you cannot specify a status code more than
+                      # once.
+                  "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                      # corresponding status code.
+                      # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                      # objects may be evicted from the cache before the defined TTL.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                },
+              ],
+              "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                  # requests into a small number of requests to the origin. If not specified,
+                  # Cloud CDN applies request coalescing by default.
+              "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                  # content with the origin, or when an error is encountered when refreshing
+                  # the cache.
+                  # This setting defines the default "max-stale" duration for any cached
+                  # responses that do not specify a max-stale directive. Stale responses that
+                  # exceed the TTL configured here will not be served. The default limit
+                  # (max-stale) is 86400s (1 day), which will allow stale content to be
+                  # served up to this limit beyond the max-age (or s-maxage) of a cached
+                  # response.
+                  # The maximum allowed value is 604800 (1 week).
+                  # Set this to zero (0) to disable serve-while-stale.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+            },
+            "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+                # information about the W3C recommendation for cross-origin resource sharing
+                # (CORS), see Fetch API Living
+                # Standard.
+              "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                  # indicates that
+                  # the actual request can include user credentials. This field translates to
+                  # the Access-Control-Allow-Credentials header.
+                  #
+                  # Default is false.
+              "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                  # header.
+                "A String",
+              ],
+              "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                  # header.
+                "A String",
+              ],
+              "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                  # more information, see regular expression syntax.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  #
+                  # Regular expressions can only be used when the loadBalancingScheme is
+                  # set to INTERNAL_SELF_MANAGED.
+                "A String",
+              ],
+              "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                  #
+                  # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                "A String",
+              ],
+              "disabled": True or False, # If true, disables the CORS policy.
+                  # The default value is false, which indicates that the CORS
+                  # policy is in effect.
+              "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                  # header.
+                "A String",
+              ],
+              "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                  # seconds. This field translates to the Access-Control-Max-Age
+                  # header.
+            },
+            "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by a load balancer on a percentage of requests before sending
+                # those requests to the backend service. Similarly requests from clients can
+                # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                # that are configured with a fault_injection_policy if:
+                # 1. The traffic is generated by fault injection AND
+                # 2. The fault injection is not a delay fault injection.
+                # Fault injection is not supported with the classic Application Load Balancer
+                # . To see which load balancers support fault injection,
+                # see Load
+                # balancing: Routing and traffic management features.
+                # the resiliency of clients to backend service failure. As part of fault
+                # injection, when clients send requests to a backend service, delays can be
+                # introduced by the load balancer on a percentage of requests before sending
+                # those request to the backend service. Similarly requests from clients can be
+                # aborted by the load balancer for a percentage of requests.
+              "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                  # injection.
+                "httpStatus": 42, # The HTTP status code used to abort the request.
+                    #
+                    # The value must be from 200 to 599 inclusive.
+                    #
+                    # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                    # according to this
+                    # mapping table. HTTP status 200 is mapped to gRPC status
+                    # UNKNOWN. Injecting an OK status is currently not supported by
+                    # Traffic Director.
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                    # that is aborted as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+              "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                  # injection, before being sent to a backend service.
+                  # request to the backend service as part of fault injection.
+                "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                    # which a delay is introduced as part of fault injection.
+                    #
+                    # The value must be from 0.0 to 100.0 inclusive.
+              },
+            },
+            "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                # Unlike the timeout field where the timeout duration starts
+                # from the time the request has been fully processed (known as*end-of-stream*),
+                # the duration in this field is computed from the beginning of the stream
+                # until the response has been processed, including all retries. A
+                # stream that does not complete in this duration is closed.
+                #
+                # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                # with the route.
+                #
+                # This field is only allowed if the Url map is used with backend services
+                # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                # are shadowed to a separate mirrored backend service. The load balancer does
+                # not wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host / authority header is suffixed with-shadow.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # are shadowed to a separate mirrored backend service. The load balancer
+                # doesn't wait for responses from the shadow service. Before sending traffic
+                # to the shadow service, the host or authority header is suffixed with-shadow.
+              "backendService": "A String", # The full or partial URL to the BackendService resource being
+                  # mirrored to.
+                  #
+                  # The backend service configured for a mirroring
+                  # policy must reference backends that are of the same type as the original
+                  # backend service matched in the URL map.
+                  #
+                  # Serverless NEG backends are not currently supported as a mirrored
+                  # backend service.
+              "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+            },
+            "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+              "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                  # If not specified, defaults to 1.
+              "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                  #
+                  # If not specified, will use the timeout set in theHttpRouteAction field.
+                  # If timeout in the HttpRouteAction field is not set, this field
+                  # uses the largest timeout
+                  # among all backend services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                  # values are:
+                  #
+                  #    - 5xx: retry is attempted if the instance or endpoint
+                  #    responds with any 5xx response code, or if the instance or
+                  #    endpoint does not respond at all. For example, disconnects, reset, read
+                  #    timeout, connection failure, and refused streams.
+                  #    - gateway-error: Similar to 5xx, but only
+                  #    applies to response codes 502, 503 or504.
+                  #    - connect-failure: a retry is attempted on failures
+                  #    connecting to the instance or endpoint. For example, connection
+                  #    timeouts.
+                  #    - retriable-4xx: a retry is attempted if the instance
+                  #    or endpoint responds with a 4xx response code.
+                  #    The only error that you can retry is error code 409.
+                  #    - refused-stream: a retry is attempted if the instance
+                  #    or endpoint resets the stream with a REFUSED_STREAM error
+                  #    code. This reset type indicates that it is safe to retry.
+                  #    - cancelled: a retry is attempted if the gRPC status
+                  #    code in the response header is set to cancelled.
+                  #    - deadline-exceeded: a retry is attempted if the gRPC
+                  #    status code in the response header is set todeadline-exceeded.
+                  #    - internal: a retry is attempted if the gRPC
+                  #    status code in the response header is set tointernal.
+                  #    - resource-exhausted: a retry is attempted if the gRPC
+                  #    status code in the response header is set toresource-exhausted.
+                  #    - unavailable: a retry is attempted if the gRPC
+                  #    status code in the response header is set tounavailable.
+                  #
+                  # Only the following codes are supported when the URL map is bound to
+                  # target gRPC proxy that has validateForProxyless field set to true.
+                  #
+                  #    - cancelled
+                  #    - deadline-exceeded
+                  #    - internal
+                  #    - resource-exhausted
+                  #    - unavailable
+                "A String",
+              ],
+            },
+            "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                # time the request has been fully processed (known as *end-of-stream*)
+                # up until the response has been processed. Timeout includes
+                # all retries.
+                #
+                # If not specified, this field uses the largest timeout among all backend
+                # services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                # to the matched service.
+                #
+                #  urlRewrite is the only action supported in UrlMaps
+                # for classic Application Load Balancers.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # backend service.
+              "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                  # host header is replaced with contents of hostRewrite.
+                  #
+                  # The value must be from 1 to 255 characters.
+              "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                  # matching portion of the request's path is replaced bypathPrefixRewrite.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                  # header) using the HTTP template syntax.
+                  #
+                  # A corresponding
+                  # path_template_match must be specified. Any template variables must exist in
+                  # the path_template_match field.
+                  #
+                  #
+                  #       - -At least one variable must be specified in the path_template_match
+                  #       field
+                  #    - You can omit variables from the rewritten URL
+                  #       - The * and ** operators cannot be matched
+                  #       unless they have a corresponding variable name - e.g.
+                  #       {format=*} or {var=**}.
+                  #
+                  # For example, a path_template_match of /static/{format=**}
+                  # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                  # rewrite, so that /{country}/{format}/{suffix=**} can be
+                  # rewritten as /content/{format}/{country}/{suffix}.
+                  #
+                  # At least
+                  # one non-empty routeRules[].matchRules[].path_template_match is
+                  # required.
+                  #
+                  # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+              "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                    # It uses RE2 syntax with the following constraints:
+                    #
+                    #
+                    #      - Any single character operators
+                    #      - Groups are allowed to have only submatch operator inside
+                    #      - Groups are allowed only without any char repetition, e.g.
+                    #      .*
+                    #      - Any char repetition, e.g. .*, is
+                    #      only allowed to be used in a single regex together with:
+                    #
+                    #
+                    #             - Empty string operators
+                    #             - Other repetitions
+                    #             - Ranges
+                    #             - Repetitions of ranges
+                    #
+                    #
+                    #      - Ranges are only allowed to have:
+                    #
+                    #
+                    #             - Character range
+                    #             - Digits range
+                    #             - Symbols listed in characters allowed for ranges
+                "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                    # the path.
+              },
+            },
+            "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                # occurs. The weights determine the fraction of traffic that flows to
+                # their corresponding backend service. If all traffic needs to
+                # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                #
+                # After a backend service is identified and before forwarding
+                # the request to
+                # the backend service, advanced routing actions such as URL rewrites and
+                # header transformations are applied depending on additional settings
+                # specified in this HttpRouteAction.
+              { # In contrast to a single BackendService in
+                  # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                  # multiple backend services. The volume of traffic for each
+                  # backend service is proportional to the weight specified
+                  # in each WeightedBackendService
+                "backendService": "A String", # The full or partial URL to the default BackendService
+                    # resource. Before
+                    # forwarding the request to backendService, the load balancer
+                    # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                    # effect for the selected backendService.
+                    #
+                    # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                    #
+                    # headerAction is not supported for load balancers that have
+                    # their loadBalancingScheme set to EXTERNAL.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                    # the request is passed along to the selected backendService.
+                  "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # request before forwarding the request to the backendService.
+                    "A String",
+                  ],
+                  "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                      # client.
+                    { # Specification determining how headers are added to requests or responses.
+                      "headerName": "A String", # The name of the header.
+                      "headerValue": "A String", # The value of the header to add.
+                      "replace": True or False, # If false, headerValue is appended to any values
+                          # that already
+                          # exist for the header. If true, headerValue is set for the
+                          # header, discarding any values that were set for that header.
+                          #
+                          # The default value is true,
+                          # unless a variable is present in headerValue,
+                          # in which case the default value is false.
+                          # .
+                    },
+                  ],
+                  "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                      # response before sending the response back to the client.
+                    "A String",
+                  ],
+                },
+                "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                    # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                    #
+                    # The selection of a backend service is determined only for new traffic.
+                    # Once a user's request has been directed to a backend service,
+                    # subsequent requests are sent to the same backend service as
+                    # determined by the backend service's session affinity policy.
+                    # Don't configure session affinity if you're using weighted traffic
+                    # splitting. If you do, the weighted traffic splitting configuration takes
+                    # precedence.
+                    #
+                    # The value must be from 0 to 1000.
+              },
+            ],
+          },
+          "service": "A String", # The full or partial URL of the backend service resource to which traffic
+              # is directed if this rule is matched. If routeAction is
+              # also specified, advanced routing actions, such as URL rewrites,
+              # take effect before sending the request to the backend.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+          "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+              # specified by urlRedirect.
+              #
+              #
+              # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+              #
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+            "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                # was supplied in the request.
+                #
+                # The value must be from 1 to 255
+                # characters.
+            "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                # set to HTTPS.
+                # If set to false, the URL scheme of the redirected request
+                # remains the same as that of the request.
+                #
+                # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                #
+                # The default is set to false.
+            "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                # that was supplied in the request.
+                #
+                # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                # the HttpRouteRuleMatch, retaining the remaining portion
+                # of the URL before redirecting the request.
+                #
+                # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                # supplied, the path of the original request is used for the redirect.
+                #
+                # The value must be from 1 to 1024 characters.
+            "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                #
+                # Supported values are:
+                #
+                #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                #    to 301.
+                #    - FOUND, which corresponds to 302.
+                #    - SEE_OTHER which corresponds to 303.
+                #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                #    method is retained.
+                #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                #    method is retained.
+            "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                # URL is
+                # removed before redirecting the request. If set to false, the
+                # query portion of the original URL is retained.
+                #
+                # The default is set to false.
+          },
+        },
+      ],
+    },
+  ],
+  "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+      # This field is not applicable to global URL maps.
+      # 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.
+  "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+      # maximum of 100 tests per UrlMap.
+      # 
+      # Not supported when the URL map is bound to a target gRPC proxy that
+      # has validateForProxyless field set to true.
+    { # Message for the expected URL mappings.
+      "description": "A String", # Description of this test case.
+      "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+          # containing the scheme, host, path and query parameters.
+          #
+          # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+          # the load balancer to backends. For rules with urlRewrite,
+          # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+          #
+          # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+          # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+          # If urlRedirect specifies strip_query, the test
+          # passes only if expectedOutputUrl does not contain any query
+          # parameters.
+          #
+          # expectedOutputUrl is optional whenservice is specified.
+      "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+          # load balancer's redirect response.
+          #
+          # expectedRedirectResponseCode cannot be set whenservice is set.
+      "headers": [ # HTTP headers for this request. If headers contains
+          # a host header, then host must also match the header value.
+        { # HTTP headers used in UrlMapTests.
+          "name": "A String", # Header name.
+          "value": "A String", # Header value.
+        },
+      ],
+      "host": "A String", # Host portion of the URL. If headers contains a host header,
+          # then host must also match the header value.
+      "path": "A String", # Path portion of the URL.
+      "service": "A String", # Expected BackendService or BackendBucket resource
+          # the given URL should be mapped to.
+          #
+          # The service field cannot
+          # be set if expectedRedirectResponseCode is set.
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ +
+ validate(project, urlMap, body=None, x__xgafv=None) + 
Runs static validation for the UrlMap. In particular, the tests of the
+provided UrlMap will be run. Calling this method does NOT create the
+UrlMap.
+
+Args:
+  project: string, Project ID for this request. (required)
+  urlMap: string, Name of the UrlMap resource to be validated as. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "loadBalancingSchemes": [ # Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load
+      # Balancers and regional external Application Load Balancers.
+      # Use EXTERNAL for classic Application Load Balancers.
+      # 
+      # Use INTERNAL_MANAGED for internal Application Load Balancers. For more
+      # information, refer to Choosing
+      # a load balancer.
+      # 
+      # If unspecified, the load balancing scheme will be inferred from the backend
+      # service resources this URL map references. If that can not be inferred (for
+      # example, this URL map only references backend buckets, or this Url map is
+      # for rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type.
+      # 
+      # If specified, the scheme(s) must not conflict with the load balancing
+      # scheme of the backend service resources this Url map references.
+    "A String",
+  ],
+  "resource": { # Represents a URL Map resource. # Content of the UrlMap to be validated.
+      #
+      # Compute Engine has two URL Map resources:
+      #
+      # * [Global](/compute/docs/reference/rest/v1/urlMaps)
+      # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
+      #
+      # A URL map resource is a component of certain types of cloud load balancers
+      # and Traffic Director:
+      #
+      # * urlMaps are used by global external Application Load
+      # Balancers, classic Application Load Balancers, and cross-region internal
+      # Application Load Balancers.
+      # * regionUrlMaps are used by internal Application Load Balancers,
+      # regional external Application Load Balancers and regional internal
+      # Application Load Balancers.
+      #
+      # For a list of supported URL map features by the load balancer type, see the
+      # Load balancing features: Routing and traffic management table.
+      #
+      # For a list of supported URL map features for Traffic Director, see the
+      # Traffic Director features: Routing and traffic management table.
+      #
+      # This resource defines mappings from hostnames and URL paths to either a
+      # backend service or a backend bucket.
+      #
+      # To use the global urlMaps resource, the backend service must
+      # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
+      # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
+      # information, read URL
+      # Map Concepts.
+    "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+        # text format.
+    "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+        # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+        #
+        # This policy takes
+        # effect at the load balancer level and applies only when no policy has been
+        # defined for the error code at lower levels like PathMatcher, RouteRule and
+        # PathRule within this UrlMap.
+        #
+        # For example, consider a UrlMap with the
+        # following configuration:
+        #
+        #
+        #      - defaultCustomErrorResponsePolicy containing policies for
+        #      responding to 5xx and 4xx errors
+        #      - A PathMatcher configured for *.example.com has
+        #      defaultCustomErrorResponsePolicy for 4xx.
+        #
+        # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
+        # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
+        # a request that does not match any host in *.example.com such
+        # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
+        # takes effect.
+        #
+        # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
+        # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+        # a retry, if load balancer is successful in reaching the
+        # service, the defaultCustomErrorResponsePolicy is ignored and
+        # the response from the service is returned to the client.
+        #
+        # defaultCustomErrorResponsePolicy is supported only for
+        # global external Application Load Balancers.
+        # backend service or backend bucket responds with an error.
+      "errorResponseRules": [ # Specifies rules for returning error responses.
+          #
+          # In a given policy, if you specify rules for both a range of error codes
+          # as well as rules for specific error codes then rules with specific error
+          # codes have a higher priority. For example, assume that you configure a rule
+          # for 401 (Un-authorized) code, and another for all 4 series
+          # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+          # However if the backend service returns a 403, the rule for4xx takes effect.
+        { # Specifies the mapping between the response code that will be returned along
+            # with the custom error content and the response code returned by the backend
+            # service.
+          "matchResponseCodes": [ # Valid values include:
+              #
+              #
+              #      - A number between 400 and 599: For example
+              #      401 or 503, in which case the load balancer
+              #      applies the policy if the error code exactly matches this value.
+              #      - 5xx: Load Balancer will apply the policy if the
+              #      backend service responds with any response code in the range of
+              #      500 to 599.
+              #    - 4xx: Load
+              #      Balancer will apply the policy if the backend service responds with any
+              #      response code in the range of 400 to
+              #      499.
+              #
+              # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+            "A String",
+          ],
+          "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+              # error content. If overrideResponseCode is not supplied, the
+              # same response code returned by the original backend bucket or backend
+              # service is returned to the client.
+          "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+              #
+              # path must start
+              # with a leading slash. path cannot have trailing slashes.
+              #
+              # If the file is not available in backendBucket  or the
+              # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+              #
+              # The value must
+              # be from 1 to 1024 characters
+        },
+      ],
+      "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+          # contains the custom error content. Examples are:
+          #
+          #
+          #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+          #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+          #      - global/backendBuckets/myBackendBucket
+          #
+          # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+          # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+          #
+          # If load balancer cannot reach
+          # the backendBucket, a simple Not Found Error will
+          # be returned, with the original response code (oroverrideResponseCode if configured).
+          #
+          # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+    },
+    "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+        # hostRules match. The load balancer performs advanced routing
+        # actions, such as URL rewrites and header transformations, before forwarding
+        # the request to the selected backend.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        #  URL maps for classic Application Load Balancers only support
+        # the urlRewrite action within defaultRouteAction.
+        #
+        #
+        # defaultRouteAction has no effect when the URL map is bound
+        # to a target gRPC proxy that has the validateForProxyless field
+        # set to true.
+      "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+          # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+          # property must be specified. This policy cannot be specified if any target
+          # backend has Identity-Aware Proxy enabled.
+        "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+            # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+            # header names can be specified. The cache is bypassed for all `cacheMode`
+            # values.
+          "A String",
+        ],
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+            # on the backend type: for Backend Services, the complete request URI is
+            # used; for Backend Buckets, the request URI is used without the protocol or
+            # host, and only query parameters known to Cloud Storage are included.
+            # Policy defined on Route Action.
+          "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+              # parameters will be included. Either specify `excludedQueryParameters`
+              # or `includedQueryParameters`, not both. '&' and '=' will be percent
+              # encoded and not treated as delimiters.
+              #
+              # Note: This field applies to routes that use backend services. Attempting
+              # to set it on a route that points exclusively to Backend Buckets will
+              # result in a configuration error. For routes that point to a Backend
+              # Bucket, use `includedQueryParameters` to define which parameters should
+              # be part of the cache key.
+            "A String",
+          ],
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket, as the
+              # host is never included in a Backend Bucket's cache key. Attempting to set
+              # it on a route that points exclusively to Backend Buckets will result in a
+              # configuration error.
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket, as the
+              # protocol is never included in a Backend Bucket's cache key. Attempting to
+              # set on a route that points exclusively to Backend Buckets will result in
+              # a configuration error.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+              # `includedQueryParameters` and `excludedQueryParameters`. If neither
+              # is set, the entire query string will be included. If false, the query
+              # string will be excluded from the cache key entirely.
+              #
+              # Note: This field applies to routes that use backend services. Attempting
+              # to set it on a route that points exclusively to Backend Buckets will
+              # result in a configuration error. For routes that point to a Backend
+              # Bucket, use `includedQueryParameters` to define which parameters should
+              # be part of the cache key.
+          "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+              # The name=value pair will be used in the cache key Cloud CDN generates.
+              #
+              # Note: This setting is only applicable to routes that use a Backend
+              # Service. It does not affect requests served by a Backend Bucket.
+              # Attempting to set it on a route that points exclusively to Backend
+              # Buckets will result in a configuration error. Up to 5 cookie names can be
+              # specified.
+            "A String",
+          ],
+          "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+            "A String",
+          ],
+          "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+              # parameters will be excluded. Either specify `includedQueryParameters`
+              # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+              # encoded and not treated as delimiters.
+            "A String",
+          ],
+        },
+        "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+            # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+        "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+            # content. This is used to clamp the max-age (or Expires) value sent to the
+            # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+            # is used for the response max-age directive, along with a "public"
+            # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+            # clamps the max-age from the origin (if specified), or else sets the
+            # response max-age directive to the lesser of the `clientTtl` and
+            # `defaultTtl`, and also ensures a "public" cache-control directive is
+            # present. The maximum allowed value is 31,622,400s (1 year). If not
+            # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+            # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+            # `USE_ORIGIN_HEADERS`.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+            # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+            # "always revalidate". The value of `defaultTtl` cannot be set to a value
+            # greater than that of `maxTtl`. When the `cacheMode` is set to
+            # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+            # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+            # accessed objects may be evicted from the cache before the defined TTL. If
+            # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+            # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+            # `USE_ORIGIN_HEADERS`.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+            # attempt to set a max-age or s-maxage higher than this, or an Expires header
+            # more than `maxTtl` seconds in the future will be capped at the value of
+            # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+            # Headers sent to the client will not be modified. Setting a TTL of "0" means
+            # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+            # Infrequently accessed objects may be evicted from the cache before the
+            # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+            # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+            # mode.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+            # to apply fine-grained caching for common errors or redirects.
+            # This can reduce the load on your origin and improve end-user
+            # experience by reducing response latency.
+            # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+            # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+            # the specified response code that lack any Cache-Control, Expires, or
+            # Pragma: no-cache directives. When the `cacheMode` is set to
+            # `FORCE_CACHE_ALL`, negative caching applies to all responses
+            # with the specified response code, and overrides any caching headers. By
+            # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+            #
+            # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+            # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+            # * 405 (Method Not Found), 501 (Not Implemented): 60s
+            #
+            # These defaults can be overridden in `negativeCachingPolicy`.
+            # If not specified, Cloud CDN applies negative caching by default.
+        "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+            # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+            # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+            # CDN's default cache TTLs. Note that when specifying an explicit
+            # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+            # all response codes that you wish to cache. Cloud CDN will not apply any
+            # default negative caching when a policy exists.
+          { # Specify CDN TTLs for response error codes.
+            "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                # specified as values, and you cannot specify a status code more than
+                # once.
+            "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                # corresponding status code.
+                # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                # objects may be evicted from the cache before the defined TTL.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+        ],
+        "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+            # requests into a small number of requests to the origin. If not specified,
+            # Cloud CDN applies request coalescing by default.
+        "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+            # content with the origin, or when an error is encountered when refreshing
+            # the cache.
+            # This setting defines the default "max-stale" duration for any cached
+            # responses that do not specify a max-stale directive. Stale responses that
+            # exceed the TTL configured here will not be served. The default limit
+            # (max-stale) is 86400s (1 day), which will allow stale content to be
+            # served up to this limit beyond the max-age (or s-maxage) of a cached
+            # response.
+            # The maximum allowed value is 604800 (1 week).
+            # Set this to zero (0) to disable serve-while-stale.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+      },
+      "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+          # information about the W3C recommendation for cross-origin resource sharing
+          # (CORS), see Fetch API Living
+          # Standard.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy.
+          # information about the W3C recommendation for cross-origin resource sharing
+          # (CORS), see Fetch API Living
+          # Standard.
+        "allowCredentials": True or False, # In response to a preflight request, setting this to true
+            # indicates that
+            # the actual request can include user credentials. This field translates to
+            # the Access-Control-Allow-Credentials header.
+            #
+            # Default is false.
+        "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+            # header.
+          "A String",
+        ],
+        "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+            # header.
+          "A String",
+        ],
+        "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+            # more information, see regular expression syntax.
+            #
+            # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+            #
+            # Regular expressions can only be used when the loadBalancingScheme is
+            # set to INTERNAL_SELF_MANAGED.
+          "A String",
+        ],
+        "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+            #
+            # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+          "A String",
+        ],
+        "disabled": True or False, # If true, disables the CORS policy.
+            # The default value is false, which indicates that the CORS
+            # policy is in effect.
+        "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+            # header.
+          "A String",
+        ],
+        "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+            # seconds. This field translates to the Access-Control-Max-Age
+            # header.
+      },
+      "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+          # the resiliency of clients to backend service failure. As part of fault
+          # injection, when clients send requests to a backend service, delays can be
+          # introduced by a load balancer on a percentage of requests before sending
+          # those requests to the backend service. Similarly requests from clients can
+          # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+          # that are configured with a fault_injection_policy if:
+          # 1. The traffic is generated by fault injection AND
+          # 2. The fault injection is not a delay fault injection.
+          # Fault injection is not supported with the classic Application Load Balancer
+          # . To see which load balancers support fault injection,
+          # see Load
+          # balancing: Routing and traffic management features.
+          # the resiliency of clients to backend service failure. As part of fault
+          # injection, when clients send requests to a backend service, delays can be
+          # introduced by the load balancer on a percentage of requests before sending
+          # those request to the backend service. Similarly requests from clients can be
+          # aborted by the load balancer for a percentage of requests.
+        "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+            # injection.
+          "httpStatus": 42, # The HTTP status code used to abort the request.
+              #
+              # The value must be from 200 to 599 inclusive.
+              #
+              # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+              # according to this
+              # mapping table. HTTP status 200 is mapped to gRPC status
+              # UNKNOWN. Injecting an OK status is currently not supported by
+              # Traffic Director.
+          "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+              # that is aborted as part of fault injection.
+              #
+              # The value must be from 0.0 to 100.0 inclusive.
+        },
+        "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+            # injection, before being sent to a backend service.
+            # request to the backend service as part of fault injection.
+          "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+              # which a delay is introduced as part of fault injection.
+              #
+              # The value must be from 0.0 to 100.0 inclusive.
+        },
+      },
+      "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+          # Unlike the timeout field where the timeout duration starts
+          # from the time the request has been fully processed (known as*end-of-stream*),
+          # the duration in this field is computed from the beginning of the stream
+          # until the response has been processed, including all retries. A
+          # stream that does not complete in this duration is closed.
+          #
+          # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+          # with the route.
+          #
+          # This field is only allowed if the Url map is used with backend services
+          # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+          # are shadowed to a separate mirrored backend service. The load balancer does
+          # not wait for responses from the shadow service. Before sending traffic
+          # to the shadow service, the host / authority header is suffixed with-shadow.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # are shadowed to a separate mirrored backend service. The load balancer
+          # doesn't wait for responses from the shadow service. Before sending traffic
+          # to the shadow service, the host or authority header is suffixed with-shadow.
+        "backendService": "A String", # The full or partial URL to the BackendService resource being
+            # mirrored to.
+            #
+            # The backend service configured for a mirroring
+            # policy must reference backends that are of the same type as the original
+            # backend service matched in the URL map.
+            #
+            # Serverless NEG backends are not currently supported as a mirrored
+            # backend service.
+        "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+      },
+      "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+        "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+            # If not specified, defaults to 1.
+        "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+            #
+            # If not specified, will use the timeout set in theHttpRouteAction field.
+            # If timeout in the HttpRouteAction field is not set, this field
+            # uses the largest timeout
+            # among all backend services associated with the route.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has the validateForProxyless field set to true.
+            # as a count of seconds and fractions of seconds at nanosecond
+            # resolution. It is independent of any calendar and concepts like "day"
+            # or "month". Range is approximately 10,000 years.
+          "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+              # Durations less than one second are represented with a 0
+              # `seconds` field and a positive `nanos` field. Must be from 0
+              # to 999,999,999 inclusive.
+          "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+              # 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
+        },
+        "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+            # values are:
+            #
+            #    - 5xx: retry is attempted if the instance or endpoint
+            #    responds with any 5xx response code, or if the instance or
+            #    endpoint does not respond at all. For example, disconnects, reset, read
+            #    timeout, connection failure, and refused streams.
+            #    - gateway-error: Similar to 5xx, but only
+            #    applies to response codes 502, 503 or504.
+            #    - connect-failure: a retry is attempted on failures
+            #    connecting to the instance or endpoint. For example, connection
+            #    timeouts.
+            #    - retriable-4xx: a retry is attempted if the instance
+            #    or endpoint responds with a 4xx response code.
+            #    The only error that you can retry is error code 409.
+            #    - refused-stream: a retry is attempted if the instance
+            #    or endpoint resets the stream with a REFUSED_STREAM error
+            #    code. This reset type indicates that it is safe to retry.
+            #    - cancelled: a retry is attempted if the gRPC status
+            #    code in the response header is set to cancelled.
+            #    - deadline-exceeded: a retry is attempted if the gRPC
+            #    status code in the response header is set todeadline-exceeded.
+            #    - internal: a retry is attempted if the gRPC
+            #    status code in the response header is set tointernal.
+            #    - resource-exhausted: a retry is attempted if the gRPC
+            #    status code in the response header is set toresource-exhausted.
+            #    - unavailable: a retry is attempted if the gRPC
+            #    status code in the response header is set tounavailable.
+            #
+            # Only the following codes are supported when the URL map is bound to
+            # target gRPC proxy that has validateForProxyless field set to true.
+            #
+            #    - cancelled
+            #    - deadline-exceeded
+            #    - internal
+            #    - resource-exhausted
+            #    - unavailable
+          "A String",
+        ],
+      },
+      "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+          # time the request has been fully processed (known as *end-of-stream*)
+          # up until the response has been processed. Timeout includes
+          # all retries.
+          #
+          # If not specified, this field uses the largest timeout among all backend
+          # services associated with the route.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has validateForProxyless field set to true.
+          # as a count of seconds and fractions of seconds at nanosecond
+          # resolution. It is independent of any calendar and concepts like "day"
+          # or "month". Range is approximately 10,000 years.
+        "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+            # Durations less than one second are represented with a 0
+            # `seconds` field and a positive `nanos` field. Must be from 0
+            # to 999,999,999 inclusive.
+        "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+            # 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
+      },
+      "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+          # to the matched service.
+          #
+          #  urlRewrite is the only action supported in UrlMaps
+          # for classic Application Load Balancers.
+          #
+          # Not supported when the URL map is bound to a target gRPC proxy that
+          # has the validateForProxyless field set to true.
+          # backend service.
+        "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+            # host header is replaced with contents of hostRewrite.
+            #
+            # The value must be from 1 to 255 characters.
+        "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+            # matching portion of the request's path is replaced bypathPrefixRewrite.
+            #
+            # The value must be from 1 to 1024 characters.
+        "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+            # header) using the HTTP template syntax.
+            #
+            # A corresponding
+            # path_template_match must be specified. Any template variables must exist in
+            # the path_template_match field.
+            #
+            #
+            #       - -At least one variable must be specified in the path_template_match
+            #       field
+            #    - You can omit variables from the rewritten URL
+            #       - The * and ** operators cannot be matched
+            #       unless they have a corresponding variable name - e.g.
+            #       {format=*} or {var=**}.
+            #
+            # For example, a path_template_match of /static/{format=**}
+            # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+            # rewrite, so that /{country}/{format}/{suffix=**} can be
+            # rewritten as /content/{format}/{country}/{suffix}.
+            #
+            # At least
+            # one non-empty routeRules[].matchRules[].path_template_match is
+            # required.
+            #
+            # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+        "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+          "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+              # It uses RE2 syntax with the following constraints:
+              #
+              #
+              #      - Any single character operators
+              #      - Groups are allowed to have only submatch operator inside
+              #      - Groups are allowed only without any char repetition, e.g.
+              #      .*
+              #      - Any char repetition, e.g. .*, is
+              #      only allowed to be used in a single regex together with:
+              #
+              #
+              #             - Empty string operators
+              #             - Other repetitions
+              #             - Ranges
+              #             - Repetitions of ranges
+              #
+              #
+              #      - Ranges are only allowed to have:
+              #
+              #
+              #             - Character range
+              #             - Digits range
+              #             - Symbols listed in characters allowed for ranges
+          "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+              # the path.
+        },
+      },
+      "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+          # occurs. The weights determine the fraction of traffic that flows to
+          # their corresponding backend service. If all traffic needs to
+          # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+          #
+          # After a backend service is identified and before forwarding
+          # the request to
+          # the backend service, advanced routing actions such as URL rewrites and
+          # header transformations are applied depending on additional settings
+          # specified in this HttpRouteAction.
+        { # In contrast to a single BackendService in
+            # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+            # multiple backend services. The volume of traffic for each
+            # backend service is proportional to the weight specified
+            # in each WeightedBackendService
+          "backendService": "A String", # The full or partial URL to the default BackendService
+              # resource. Before
+              # forwarding the request to backendService, the load balancer
+              # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+          "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+              # effect for the selected backendService.
+              #
+              # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+              #
+              # headerAction is not supported for load balancers that have
+              # their loadBalancingScheme set to EXTERNAL.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # the request is passed along to the selected backendService.
+            "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # request before forwarding the request to the backendService.
+              "A String",
+            ],
+            "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                # client.
+              { # Specification determining how headers are added to requests or responses.
+                "headerName": "A String", # The name of the header.
+                "headerValue": "A String", # The value of the header to add.
+                "replace": True or False, # If false, headerValue is appended to any values
+                    # that already
+                    # exist for the header. If true, headerValue is set for the
+                    # header, discarding any values that were set for that header.
+                    #
+                    # The default value is true,
+                    # unless a variable is present in headerValue,
+                    # in which case the default value is false.
+                    # .
+              },
+            ],
+            "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                # response before sending the response back to the client.
+              "A String",
+            ],
+          },
+          "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+              # computed asweight / (sum of all weightedBackendService weights in routeAction).
+              #
+              # The selection of a backend service is determined only for new traffic.
+              # Once a user's request has been directed to a backend service,
+              # subsequent requests are sent to the same backend service as
+              # determined by the backend service's session affinity policy.
+              # Don't configure session affinity if you're using weighted traffic
+              # splitting. If you do, the weighted traffic splitting configuration takes
+              # precedence.
+              #
+              # The value must be from 0 to 1000.
+        },
+      ],
+    },
+    "defaultService": "A String", # The full or partial URL of the defaultService resource to
+        # which traffic is directed if none of the hostRules match.
+        # If defaultRouteAction is also specified, advanced
+        # routing actions, such as URL rewrites, take effect before sending the
+        # request to the backend.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        # defaultService has no effect when the URL map is bound
+        # to a target gRPC proxy that has the validateForProxyless field
+        # set to true.
+    "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
+        # is redirected to a URL specified by defaultUrlRedirect.
+        #
+        #
+        # Only one of defaultUrlRedirect, defaultService
+        # or defaultRouteAction.weightedBackendService can be set.
+        #
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy.
+      "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+          # was supplied in the request.
+          #
+          # The value must be from 1 to 255
+          # characters.
+      "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+          # set to HTTPS.
+          # If set to false, the URL scheme of the redirected request
+          # remains the same as that of the request.
+          #
+          # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+          #
+          # The default is set to false.
+      "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+          # that was supplied in the request.
+          #
+          # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+          # supplied, the path of the original request is used for the redirect.
+          #
+          # The value must be from 1 to 1024 characters.
+      "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+          # the HttpRouteRuleMatch, retaining the remaining portion
+          # of the URL before redirecting the request.
+          #
+          # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+          # supplied, the path of the original request is used for the redirect.
+          #
+          # The value must be from 1 to 1024 characters.
+      "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+          #
+          # Supported values are:
+          #
+          #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+          #    to 301.
+          #    - FOUND, which corresponds to 302.
+          #    - SEE_OTHER which corresponds to 303.
+          #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+          #    method is retained.
+          #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+          #    method is retained.
+      "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+          # URL is
+          # removed before redirecting the request. If set to false, the
+          # query portion of the original URL is retained.
+          #
+          # The default is set to false.
+    },
+    "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 is ignored when
+        # inserting a UrlMap. An up-to-date fingerprint must be provided
+        # in order to update the UrlMap, otherwise the request will
+        # fail with error 412 conditionNotMet.
+        #
+        # To see the latest fingerprint, make a get() request to
+        # retrieve a UrlMap.
+    "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+        # for the selected backendService.
+        #
+        # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
+        #
+        # headerAction is not supported for load balancers
+        # that have
+        # their loadBalancingScheme set to EXTERNAL.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+        # the request is passed along to the selected backendService.
+      "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+        { # Specification determining how headers are added to requests or responses.
+          "headerName": "A String", # The name of the header.
+          "headerValue": "A String", # The value of the header to add.
+          "replace": True or False, # If false, headerValue is appended to any values
+              # that already
+              # exist for the header. If true, headerValue is set for the
+              # header, discarding any values that were set for that header.
+              #
+              # The default value is true,
+              # unless a variable is present in headerValue,
+              # in which case the default value is false.
+              # .
+        },
+      ],
+      "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+          # request before forwarding the request to the backendService.
+        "A String",
+      ],
+      "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+          # client.
+        { # Specification determining how headers are added to requests or responses.
+          "headerName": "A String", # The name of the header.
+          "headerValue": "A String", # The value of the header to add.
+          "replace": True or False, # If false, headerValue is appended to any values
+              # that already
+              # exist for the header. If true, headerValue is set for the
+              # header, discarding any values that were set for that header.
+              #
+              # The default value is true,
+              # unless a variable is present in headerValue,
+              # in which case the default value is false.
+              # .
+        },
+      ],
+      "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+          # response before sending the response back to the client.
+        "A String",
+      ],
+    },
+    "hostRules": [ # The list of host rules to use against the URL.
+      { # UrlMaps
+          # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "hosts": [ # The list of host patterns to match. They must be valid hostnames with
+            # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
+            # that case, * must be the first character, and if followed by
+            # anything, the immediate following character must be either -
+            # or ..
+            #
+            # * based matching is not supported when the URL map is bound
+            # to a target gRPC proxy that has the validateForProxyless field
+            # set to true.
+          "A String",
+        ],
+        "pathMatcher": "A String", # The name of the PathMatcher to use to match the path portion
+            # of the URL if the hostRule matches the URL's host portion.
+      },
+    ],
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+    "kind": "compute#urlMap", # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
+        # url maps.
+    "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.
+    "pathMatchers": [ # The list of named PathMatchers to use against the URL.
+      { # A matcher for the path portion of the URL. The BackendService
+          # from the longest-matched rule will serve the URL. If no rule was matched, the
+          # default service is used.
+        "defaultCustomErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
+            # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+            #
+            # This policy takes
+            # effect at the PathMatcher level and applies only when no
+            # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
+            # in defaultCustomErrorResponsePolicy, then a policy defined for
+            # the error code in UrlMap.defaultCustomErrorResponsePolicy
+            # takes effect.
+            #
+            # For example, consider a UrlMap with the following
+            # configuration:
+            #
+            #
+            #      - UrlMap.defaultCustomErrorResponsePolicy is configured
+            #      with policies for 5xx and 4xx errors
+            #      - A RouteRule for /coming_soon/ is configured for the
+            #      error code 404.
+            #
+            # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+            # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+            # the policy in RouteRule.customErrorResponsePolicy takes
+            # effect. If any of the requests in this example encounter a 500
+            # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+            #
+            # When
+            # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
+            # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
+            # a retry, if load balancer is successful in reaching the
+            # service, the defaultCustomErrorResponsePolicy is ignored and
+            # the response from the service is returned to the client.
+            #
+            # defaultCustomErrorResponsePolicy is supported only for
+            # global external Application Load Balancers.
+            # backend service or backend bucket responds with an error.
+          "errorResponseRules": [ # Specifies rules for returning error responses.
+              #
+              # In a given policy, if you specify rules for both a range of error codes
+              # as well as rules for specific error codes then rules with specific error
+              # codes have a higher priority. For example, assume that you configure a rule
+              # for 401 (Un-authorized) code, and another for all 4 series
+              # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+              # However if the backend service returns a 403, the rule for4xx takes effect.
+            { # Specifies the mapping between the response code that will be returned along
+                # with the custom error content and the response code returned by the backend
+                # service.
+              "matchResponseCodes": [ # Valid values include:
+                  #
+                  #
+                  #      - A number between 400 and 599: For example
+                  #      401 or 503, in which case the load balancer
+                  #      applies the policy if the error code exactly matches this value.
+                  #      - 5xx: Load Balancer will apply the policy if the
+                  #      backend service responds with any response code in the range of
+                  #      500 to 599.
+                  #    - 4xx: Load
+                  #      Balancer will apply the policy if the backend service responds with any
+                  #      response code in the range of 400 to
+                  #      499.
+                  #
+                  # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                "A String",
+              ],
+              "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                  # error content. If overrideResponseCode is not supplied, the
+                  # same response code returned by the original backend bucket or backend
+                  # service is returned to the client.
+              "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                  #
+                  # path must start
+                  # with a leading slash. path cannot have trailing slashes.
+                  #
+                  # If the file is not available in backendBucket  or the
+                  # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                  #
+                  # The value must
+                  # be from 1 to 1024 characters
+            },
+          ],
+          "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+              # contains the custom error content. Examples are:
+              #
+              #
+              #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+              #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+              #      - global/backendBuckets/myBackendBucket
+              #
+              # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+              # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+              #
+              # If load balancer cannot reach
+              # the backendBucket, a simple Not Found Error will
+              # be returned, with the original response code (oroverrideResponseCode if configured).
+              #
+              # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+        },
+        "defaultRouteAction": { # defaultRouteAction takes effect when none of the
+            # pathRules or routeRules match. The load balancer
+            # performs advanced routing actions, such as URL rewrites and
+            # header transformations, before forwarding the request to the
+            # selected backend.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # URL maps for classic Application Load Balancers only support
+            # the urlRewrite action within a path matcher'sdefaultRouteAction.
+          "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+              # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+              # property must be specified. This policy cannot be specified if any target
+              # backend has Identity-Aware Proxy enabled.
+            "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                # header names can be specified. The cache is bypassed for all `cacheMode`
+                # values.
+              "A String",
+            ],
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                # on the backend type: for Backend Services, the complete request URI is
+                # used; for Backend Buckets, the request URI is used without the protocol or
+                # host, and only query parameters known to Cloud Storage are included.
+                # Policy defined on Route Action.
+              "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                  # parameters will be included. Either specify `excludedQueryParameters`
+                  # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                  # encoded and not treated as delimiters.
+                  #
+                  # Note: This field applies to routes that use backend services. Attempting
+                  # to set it on a route that points exclusively to Backend Buckets will
+                  # result in a configuration error. For routes that point to a Backend
+                  # Bucket, use `includedQueryParameters` to define which parameters should
+                  # be part of the cache key.
+                "A String",
+              ],
+              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket, as the
+                  # host is never included in a Backend Bucket's cache key. Attempting to set
+                  # it on a route that points exclusively to Backend Buckets will result in a
+                  # configuration error.
+              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket, as the
+                  # protocol is never included in a Backend Bucket's cache key. Attempting to
+                  # set on a route that points exclusively to Backend Buckets will result in
+                  # a configuration error.
+              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                  # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                  # is set, the entire query string will be included. If false, the query
+                  # string will be excluded from the cache key entirely.
+                  #
+                  # Note: This field applies to routes that use backend services. Attempting
+                  # to set it on a route that points exclusively to Backend Buckets will
+                  # result in a configuration error. For routes that point to a Backend
+                  # Bucket, use `includedQueryParameters` to define which parameters should
+                  # be part of the cache key.
+              "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                  # The name=value pair will be used in the cache key Cloud CDN generates.
+                  #
+                  # Note: This setting is only applicable to routes that use a Backend
+                  # Service. It does not affect requests served by a Backend Bucket.
+                  # Attempting to set it on a route that points exclusively to Backend
+                  # Buckets will result in a configuration error. Up to 5 cookie names can be
+                  # specified.
+                "A String",
+              ],
+              "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                "A String",
+              ],
+              "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                  # parameters will be excluded. Either specify `includedQueryParameters`
+                  # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                  # encoded and not treated as delimiters.
+                "A String",
+              ],
+            },
+            "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+            "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                # content. This is used to clamp the max-age (or Expires) value sent to the
+                # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                # is used for the response max-age directive, along with a "public"
+                # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                # clamps the max-age from the origin (if specified), or else sets the
+                # response max-age directive to the lesser of the `clientTtl` and
+                # `defaultTtl`, and also ensures a "public" cache-control directive is
+                # present. The maximum allowed value is 31,622,400s (1 year). If not
+                # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                # `USE_ORIGIN_HEADERS`.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                # greater than that of `maxTtl`. When the `cacheMode` is set to
+                # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                # accessed objects may be evicted from the cache before the defined TTL. If
+                # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                # `USE_ORIGIN_HEADERS`.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                # more than `maxTtl` seconds in the future will be capped at the value of
+                # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                # Infrequently accessed objects may be evicted from the cache before the
+                # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                # mode.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                # to apply fine-grained caching for common errors or redirects.
+                # This can reduce the load on your origin and improve end-user
+                # experience by reducing response latency.
+                # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                # the specified response code that lack any Cache-Control, Expires, or
+                # Pragma: no-cache directives. When the `cacheMode` is set to
+                # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                # with the specified response code, and overrides any caching headers. By
+                # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                #
+                # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                #
+                # These defaults can be overridden in `negativeCachingPolicy`.
+                # If not specified, Cloud CDN applies negative caching by default.
+            "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                # CDN's default cache TTLs. Note that when specifying an explicit
+                # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                # all response codes that you wish to cache. Cloud CDN will not apply any
+                # default negative caching when a policy exists.
+              { # Specify CDN TTLs for response error codes.
+                "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                    # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                    # specified as values, and you cannot specify a status code more than
+                    # once.
+                "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                    # corresponding status code.
+                    # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                    # objects may be evicted from the cache before the defined TTL.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+            ],
+            "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                # requests into a small number of requests to the origin. If not specified,
+                # Cloud CDN applies request coalescing by default.
+            "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                # content with the origin, or when an error is encountered when refreshing
+                # the cache.
+                # This setting defines the default "max-stale" duration for any cached
+                # responses that do not specify a max-stale directive. Stale responses that
+                # exceed the TTL configured here will not be served. The default limit
+                # (max-stale) is 86400s (1 day), which will allow stale content to be
+                # served up to this limit beyond the max-age (or s-maxage) of a cached
+                # response.
+                # The maximum allowed value is 604800 (1 week).
+                # Set this to zero (0) to disable serve-while-stale.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+          },
+          "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+              # information about the W3C recommendation for cross-origin resource sharing
+              # (CORS), see Fetch API Living
+              # Standard.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy.
+              # information about the W3C recommendation for cross-origin resource sharing
+              # (CORS), see Fetch API Living
+              # Standard.
+            "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                # indicates that
+                # the actual request can include user credentials. This field translates to
+                # the Access-Control-Allow-Credentials header.
+                #
+                # Default is false.
+            "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                # header.
+              "A String",
+            ],
+            "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                # header.
+              "A String",
+            ],
+            "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                # more information, see regular expression syntax.
+                #
+                # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                #
+                # Regular expressions can only be used when the loadBalancingScheme is
+                # set to INTERNAL_SELF_MANAGED.
+              "A String",
+            ],
+            "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                #
+                # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+              "A String",
+            ],
+            "disabled": True or False, # If true, disables the CORS policy.
+                # The default value is false, which indicates that the CORS
+                # policy is in effect.
+            "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                # header.
+              "A String",
+            ],
+            "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                # seconds. This field translates to the Access-Control-Max-Age
+                # header.
+          },
+          "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+              # the resiliency of clients to backend service failure. As part of fault
+              # injection, when clients send requests to a backend service, delays can be
+              # introduced by a load balancer on a percentage of requests before sending
+              # those requests to the backend service. Similarly requests from clients can
+              # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+              # that are configured with a fault_injection_policy if:
+              # 1. The traffic is generated by fault injection AND
+              # 2. The fault injection is not a delay fault injection.
+              # Fault injection is not supported with the classic Application Load Balancer
+              # . To see which load balancers support fault injection,
+              # see Load
+              # balancing: Routing and traffic management features.
+              # the resiliency of clients to backend service failure. As part of fault
+              # injection, when clients send requests to a backend service, delays can be
+              # introduced by the load balancer on a percentage of requests before sending
+              # those request to the backend service. Similarly requests from clients can be
+              # aborted by the load balancer for a percentage of requests.
+            "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                # injection.
+              "httpStatus": 42, # The HTTP status code used to abort the request.
+                  #
+                  # The value must be from 200 to 599 inclusive.
+                  #
+                  # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                  # according to this
+                  # mapping table. HTTP status 200 is mapped to gRPC status
+                  # UNKNOWN. Injecting an OK status is currently not supported by
+                  # Traffic Director.
+              "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                  # that is aborted as part of fault injection.
+                  #
+                  # The value must be from 0.0 to 100.0 inclusive.
+            },
+            "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                # injection, before being sent to a backend service.
+                # request to the backend service as part of fault injection.
+              "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                  # which a delay is introduced as part of fault injection.
+                  #
+                  # The value must be from 0.0 to 100.0 inclusive.
+            },
+          },
+          "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+              # Unlike the timeout field where the timeout duration starts
+              # from the time the request has been fully processed (known as*end-of-stream*),
+              # the duration in this field is computed from the beginning of the stream
+              # until the response has been processed, including all retries. A
+              # stream that does not complete in this duration is closed.
+              #
+              # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+              # with the route.
+              #
+              # This field is only allowed if the Url map is used with backend services
+              # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+              # are shadowed to a separate mirrored backend service. The load balancer does
+              # not wait for responses from the shadow service. Before sending traffic
+              # to the shadow service, the host / authority header is suffixed with-shadow.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # are shadowed to a separate mirrored backend service. The load balancer
+              # doesn't wait for responses from the shadow service. Before sending traffic
+              # to the shadow service, the host or authority header is suffixed with-shadow.
+            "backendService": "A String", # The full or partial URL to the BackendService resource being
+                # mirrored to.
+                #
+                # The backend service configured for a mirroring
+                # policy must reference backends that are of the same type as the original
+                # backend service matched in the URL map.
+                #
+                # Serverless NEG backends are not currently supported as a mirrored
+                # backend service.
+            "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+          },
+          "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+            "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                # If not specified, defaults to 1.
+            "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                #
+                # If not specified, will use the timeout set in theHttpRouteAction field.
+                # If timeout in the HttpRouteAction field is not set, this field
+                # uses the largest timeout
+                # among all backend services associated with the route.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has the validateForProxyless field set to true.
+                # as a count of seconds and fractions of seconds at nanosecond
+                # resolution. It is independent of any calendar and concepts like "day"
+                # or "month". Range is approximately 10,000 years.
+              "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                  # Durations less than one second are represented with a 0
+                  # `seconds` field and a positive `nanos` field. Must be from 0
+                  # to 999,999,999 inclusive.
+              "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                  # 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
+            },
+            "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                # values are:
+                #
+                #    - 5xx: retry is attempted if the instance or endpoint
+                #    responds with any 5xx response code, or if the instance or
+                #    endpoint does not respond at all. For example, disconnects, reset, read
+                #    timeout, connection failure, and refused streams.
+                #    - gateway-error: Similar to 5xx, but only
+                #    applies to response codes 502, 503 or504.
+                #    - connect-failure: a retry is attempted on failures
+                #    connecting to the instance or endpoint. For example, connection
+                #    timeouts.
+                #    - retriable-4xx: a retry is attempted if the instance
+                #    or endpoint responds with a 4xx response code.
+                #    The only error that you can retry is error code 409.
+                #    - refused-stream: a retry is attempted if the instance
+                #    or endpoint resets the stream with a REFUSED_STREAM error
+                #    code. This reset type indicates that it is safe to retry.
+                #    - cancelled: a retry is attempted if the gRPC status
+                #    code in the response header is set to cancelled.
+                #    - deadline-exceeded: a retry is attempted if the gRPC
+                #    status code in the response header is set todeadline-exceeded.
+                #    - internal: a retry is attempted if the gRPC
+                #    status code in the response header is set tointernal.
+                #    - resource-exhausted: a retry is attempted if the gRPC
+                #    status code in the response header is set toresource-exhausted.
+                #    - unavailable: a retry is attempted if the gRPC
+                #    status code in the response header is set tounavailable.
+                #
+                # Only the following codes are supported when the URL map is bound to
+                # target gRPC proxy that has validateForProxyless field set to true.
+                #
+                #    - cancelled
+                #    - deadline-exceeded
+                #    - internal
+                #    - resource-exhausted
+                #    - unavailable
+              "A String",
+            ],
+          },
+          "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+              # time the request has been fully processed (known as *end-of-stream*)
+              # up until the response has been processed. Timeout includes
+              # all retries.
+              #
+              # If not specified, this field uses the largest timeout among all backend
+              # services associated with the route.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has validateForProxyless field set to true.
+              # as a count of seconds and fractions of seconds at nanosecond
+              # resolution. It is independent of any calendar and concepts like "day"
+              # or "month". Range is approximately 10,000 years.
+            "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                # Durations less than one second are represented with a 0
+                # `seconds` field and a positive `nanos` field. Must be from 0
+                # to 999,999,999 inclusive.
+            "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                # 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
+          },
+          "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+              # to the matched service.
+              #
+              #  urlRewrite is the only action supported in UrlMaps
+              # for classic Application Load Balancers.
+              #
+              # Not supported when the URL map is bound to a target gRPC proxy that
+              # has the validateForProxyless field set to true.
+              # backend service.
+            "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                # host header is replaced with contents of hostRewrite.
+                #
+                # The value must be from 1 to 255 characters.
+            "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                # matching portion of the request's path is replaced bypathPrefixRewrite.
+                #
+                # The value must be from 1 to 1024 characters.
+            "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                # header) using the HTTP template syntax.
+                #
+                # A corresponding
+                # path_template_match must be specified. Any template variables must exist in
+                # the path_template_match field.
+                #
+                #
+                #       - -At least one variable must be specified in the path_template_match
+                #       field
+                #    - You can omit variables from the rewritten URL
+                #       - The * and ** operators cannot be matched
+                #       unless they have a corresponding variable name - e.g.
+                #       {format=*} or {var=**}.
+                #
+                # For example, a path_template_match of /static/{format=**}
+                # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                # rewrite, so that /{country}/{format}/{suffix=**} can be
+                # rewritten as /content/{format}/{country}/{suffix}.
+                #
+                # At least
+                # one non-empty routeRules[].matchRules[].path_template_match is
+                # required.
+                #
+                # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+            "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+              "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                  # It uses RE2 syntax with the following constraints:
+                  #
+                  #
+                  #      - Any single character operators
+                  #      - Groups are allowed to have only submatch operator inside
+                  #      - Groups are allowed only without any char repetition, e.g.
+                  #      .*
+                  #      - Any char repetition, e.g. .*, is
+                  #      only allowed to be used in a single regex together with:
+                  #
+                  #
+                  #             - Empty string operators
+                  #             - Other repetitions
+                  #             - Ranges
+                  #             - Repetitions of ranges
+                  #
+                  #
+                  #      - Ranges are only allowed to have:
+                  #
+                  #
+                  #             - Character range
+                  #             - Digits range
+                  #             - Symbols listed in characters allowed for ranges
+              "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                  # the path.
+            },
+          },
+          "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+              # occurs. The weights determine the fraction of traffic that flows to
+              # their corresponding backend service. If all traffic needs to
+              # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+              #
+              # After a backend service is identified and before forwarding
+              # the request to
+              # the backend service, advanced routing actions such as URL rewrites and
+              # header transformations are applied depending on additional settings
+              # specified in this HttpRouteAction.
+            { # In contrast to a single BackendService in
+                # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                # multiple backend services. The volume of traffic for each
+                # backend service is proportional to the weight specified
+                # in each WeightedBackendService
+              "backendService": "A String", # The full or partial URL to the default BackendService
+                  # resource. Before
+                  # forwarding the request to backendService, the load balancer
+                  # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+              "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                  # effect for the selected backendService.
+                  #
+                  # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                  #
+                  # headerAction is not supported for load balancers that have
+                  # their loadBalancingScheme set to EXTERNAL.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # the request is passed along to the selected backendService.
+                "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # request before forwarding the request to the backendService.
+                  "A String",
+                ],
+                "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                    # client.
+                  { # Specification determining how headers are added to requests or responses.
+                    "headerName": "A String", # The name of the header.
+                    "headerValue": "A String", # The value of the header to add.
+                    "replace": True or False, # If false, headerValue is appended to any values
+                        # that already
+                        # exist for the header. If true, headerValue is set for the
+                        # header, discarding any values that were set for that header.
+                        #
+                        # The default value is true,
+                        # unless a variable is present in headerValue,
+                        # in which case the default value is false.
+                        # .
+                  },
+                ],
+                "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                    # response before sending the response back to the client.
+                  "A String",
+                ],
+              },
+              "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                  # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                  #
+                  # The selection of a backend service is determined only for new traffic.
+                  # Once a user's request has been directed to a backend service,
+                  # subsequent requests are sent to the same backend service as
+                  # determined by the backend service's session affinity policy.
+                  # Don't configure session affinity if you're using weighted traffic
+                  # splitting. If you do, the weighted traffic splitting configuration takes
+                  # precedence.
+                  #
+                  # The value must be from 0 to 1000.
+            },
+          ],
+        },
+        "defaultService": "A String", # The full or partial URL to the BackendService resource. This
+            # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
+            # matched. For example, the
+            # following are all valid URLs to a BackendService resource:
+            #
+            #
+            #      - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
+            #      - compute/v1/projects/project/global/backendServices/backendService
+            #      - global/backendServices/backendService
+            #
+            #
+            # If defaultRouteAction is also specified, advanced
+            # routing actions, such as URL rewrites, take effect before sending the
+            # request to the backend.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # Authorization requires one or more of the following Google IAM permissions on the
+            # specified resource default_service:
+            #
+            #
+            #       - compute.backendBuckets.use
+            #       - compute.backendServices.use
+        "defaultUrlRedirect": { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
+            # by defaultUrlRedirect.
+            #
+            #
+            # Only one of defaultUrlRedirect, defaultService
+            # or defaultRouteAction.weightedBackendService can be set.
+            #
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy.
+          "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+              # was supplied in the request.
+              #
+              # The value must be from 1 to 255
+              # characters.
+          "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+              # set to HTTPS.
+              # If set to false, the URL scheme of the redirected request
+              # remains the same as that of the request.
+              #
+              # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+              #
+              # The default is set to false.
+          "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+              # that was supplied in the request.
+              #
+              # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+              # supplied, the path of the original request is used for the redirect.
+              #
+              # The value must be from 1 to 1024 characters.
+          "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+              # the HttpRouteRuleMatch, retaining the remaining portion
+              # of the URL before redirecting the request.
+              #
+              # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+              # supplied, the path of the original request is used for the redirect.
+              #
+              # The value must be from 1 to 1024 characters.
+          "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+              #
+              # Supported values are:
+              #
+              #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+              #    to 301.
+              #    - FOUND, which corresponds to 302.
+              #    - SEE_OTHER which corresponds to 303.
+              #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+              #    method is retained.
+              #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+              #    method is retained.
+          "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+              # URL is
+              # removed before redirecting the request. If set to false, the
+              # query portion of the original URL is retained.
+              #
+              # The default is set to false.
+        },
+        "description": "A String", # An optional description of this resource. Provide this property when you
+            # create the resource.
+        "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+            # for the selected backend service.
+            #
+            # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
+            #
+            # HeaderAction is not supported for load balancers
+            # that have
+            # their loadBalancingScheme set to EXTERNAL.
+            #
+            # Not supported when the URL map is bound to a target gRPC proxy that
+            # has validateForProxyless field set to true.
+            # the request is passed along to the selected backendService.
+          "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # request before forwarding the request to the backendService.
+            "A String",
+          ],
+          "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+              # client.
+            { # Specification determining how headers are added to requests or responses.
+              "headerName": "A String", # The name of the header.
+              "headerValue": "A String", # The value of the header to add.
+              "replace": True or False, # If false, headerValue is appended to any values
+                  # that already
+                  # exist for the header. If true, headerValue is set for the
+                  # header, discarding any values that were set for that header.
+                  #
+                  # The default value is true,
+                  # unless a variable is present in headerValue,
+                  # in which case the default value is false.
+                  # .
+            },
+          ],
+          "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+              # response before sending the response back to the client.
+            "A String",
+          ],
+        },
+        "name": "A String", # The name to which this PathMatcher is referred by theHostRule.
+        "pathRules": [ # The list of path rules. Use this list instead of routeRules
+            # when routing based on simple path matching is all that's required. A path
+            # rule can only include a wildcard character (*) after a
+            # forward slash character ("/").
+            #
+            # The order by which path rules are specified does not matter.
+            # Matches are always done on the longest-path-first basis.
+            #
+            # For example: a pathRule with a path /a/b/c/* will match
+            # before /a/b/* irrespective of the order in which those paths appear in this
+            # list.
+            #
+            # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
+          { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
+            "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                #
+                # If a policy for an
+                # error code is not configured for the PathRule, a policy for
+                # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                # effect.
+                #
+                # For example, consider a UrlMap with the following configuration:
+                #
+                #
+                #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                #      with policies for 5xx and 4xx errors
+                #      - A PathRule for /coming_soon/ is configured for the error
+                #      code 404.
+                #
+                # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                # the policy in PathRule.customErrorResponsePolicy takes
+                # effect. If any of the requests in this example encounter a 500
+                # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                #
+                # customErrorResponsePolicy is supported only for
+                # global external Application Load Balancers.
+                # backend service or backend bucket responds with an error.
+              "errorResponseRules": [ # Specifies rules for returning error responses.
+                  #
+                  # In a given policy, if you specify rules for both a range of error codes
+                  # as well as rules for specific error codes then rules with specific error
+                  # codes have a higher priority. For example, assume that you configure a rule
+                  # for 401 (Un-authorized) code, and another for all 4 series
+                  # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                  # However if the backend service returns a 403, the rule for4xx takes effect.
+                { # Specifies the mapping between the response code that will be returned along
+                    # with the custom error content and the response code returned by the backend
+                    # service.
+                  "matchResponseCodes": [ # Valid values include:
+                      #
+                      #
+                      #      - A number between 400 and 599: For example
+                      #      401 or 503, in which case the load balancer
+                      #      applies the policy if the error code exactly matches this value.
+                      #      - 5xx: Load Balancer will apply the policy if the
+                      #      backend service responds with any response code in the range of
+                      #      500 to 599.
+                      #    - 4xx: Load
+                      #      Balancer will apply the policy if the backend service responds with any
+                      #      response code in the range of 400 to
+                      #      499.
+                      #
+                      # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                    "A String",
+                  ],
+                  "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                      # error content. If overrideResponseCode is not supplied, the
+                      # same response code returned by the original backend bucket or backend
+                      # service is returned to the client.
+                  "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                      #
+                      # path must start
+                      # with a leading slash. path cannot have trailing slashes.
+                      #
+                      # If the file is not available in backendBucket  or the
+                      # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                      #
+                      # The value must
+                      # be from 1 to 1024 characters
+                },
+              ],
+              "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                  # contains the custom error content. Examples are:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - global/backendBuckets/myBackendBucket
+                  #
+                  # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                  # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                  #
+                  # If load balancer cannot reach
+                  # the backendBucket, a simple Not Found Error will
+                  # be returned, with the original response code (oroverrideResponseCode if configured).
+                  #
+                  # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+            },
+            "paths": [ # The list of path patterns to match. Each must start with /
+                # and the only place a * is allowed is at the end following
+                # a /.  The string fed to the path matcher does not include
+                # any text after the first ? or #, and
+                # those chars are not allowed here.
+              "A String",
+            ],
+            "routeAction": { # In response to a matching path, the load balancer
+                # performs advanced routing actions, such as URL rewrites and header
+                # transformations, before forwarding the request to the selected
+                # backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # URL maps for classic Application Load Balancers only support
+                # the urlRewrite action within a path rule'srouteAction.
+              "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                  # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                  # property must be specified. This policy cannot be specified if any target
+                  # backend has Identity-Aware Proxy enabled.
+                "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                    # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                    # header names can be specified. The cache is bypassed for all `cacheMode`
+                    # values.
+                  "A String",
+                ],
+                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                    # on the backend type: for Backend Services, the complete request URI is
+                    # used; for Backend Buckets, the request URI is used without the protocol or
+                    # host, and only query parameters known to Cloud Storage are included.
+                    # Policy defined on Route Action.
+                  "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                      # parameters will be included. Either specify `excludedQueryParameters`
+                      # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                    "A String",
+                  ],
+                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # host is never included in a Backend Bucket's cache key. Attempting to set
+                      # it on a route that points exclusively to Backend Buckets will result in a
+                      # configuration error.
+                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # protocol is never included in a Backend Bucket's cache key. Attempting to
+                      # set on a route that points exclusively to Backend Buckets will result in
+                      # a configuration error.
+                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                      # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                      # is set, the entire query string will be included. If false, the query
+                      # string will be excluded from the cache key entirely.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                  "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                      # The name=value pair will be used in the cache key Cloud CDN generates.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket.
+                      # Attempting to set it on a route that points exclusively to Backend
+                      # Buckets will result in a configuration error. Up to 5 cookie names can be
+                      # specified.
+                    "A String",
+                  ],
+                  "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                    "A String",
+                  ],
+                  "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                      # parameters will be excluded. Either specify `includedQueryParameters`
+                      # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                },
+                "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                    # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                    # content. This is used to clamp the max-age (or Expires) value sent to the
+                    # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                    # is used for the response max-age directive, along with a "public"
+                    # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                    # clamps the max-age from the origin (if specified), or else sets the
+                    # response max-age directive to the lesser of the `clientTtl` and
+                    # `defaultTtl`, and also ensures a "public" cache-control directive is
+                    # present. The maximum allowed value is 31,622,400s (1 year). If not
+                    # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                    # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                    # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                    # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                    # greater than that of `maxTtl`. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                    # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                    # accessed objects may be evicted from the cache before the defined TTL. If
+                    # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                    # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                    # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                    # more than `maxTtl` seconds in the future will be capped at the value of
+                    # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                    # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                    # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                    # Infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                    # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                    # mode.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                    # to apply fine-grained caching for common errors or redirects.
+                    # This can reduce the load on your origin and improve end-user
+                    # experience by reducing response latency.
+                    # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                    # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                    # the specified response code that lack any Cache-Control, Expires, or
+                    # Pragma: no-cache directives. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                    # with the specified response code, and overrides any caching headers. By
+                    # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                    #
+                    # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                    # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                    # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                    #
+                    # These defaults can be overridden in `negativeCachingPolicy`.
+                    # If not specified, Cloud CDN applies negative caching by default.
+                "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                    # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                    # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                    # CDN's default cache TTLs. Note that when specifying an explicit
+                    # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                    # all response codes that you wish to cache. Cloud CDN will not apply any
+                    # default negative caching when a policy exists.
+                  { # Specify CDN TTLs for response error codes.
+                    "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                        # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                        # specified as values, and you cannot specify a status code more than
+                        # once.
+                    "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                        # corresponding status code.
+                        # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                        # objects may be evicted from the cache before the defined TTL.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                  },
+                ],
+                "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                    # requests into a small number of requests to the origin. If not specified,
+                    # Cloud CDN applies request coalescing by default.
+                "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                    # content with the origin, or when an error is encountered when refreshing
+                    # the cache.
+                    # This setting defines the default "max-stale" duration for any cached
+                    # responses that do not specify a max-stale directive. Stale responses that
+                    # exceed the TTL configured here will not be served. The default limit
+                    # (max-stale) is 86400s (1 day), which will allow stale content to be
+                    # served up to this limit beyond the max-age (or s-maxage) of a cached
+                    # response.
+                    # The maximum allowed value is 604800 (1 week).
+                    # Set this to zero (0) to disable serve-while-stale.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+              "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                    # indicates that
+                    # the actual request can include user credentials. This field translates to
+                    # the Access-Control-Allow-Credentials header.
+                    #
+                    # Default is false.
+                "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                    # header.
+                  "A String",
+                ],
+                "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                    # header.
+                  "A String",
+                ],
+                "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                    # more information, see regular expression syntax.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED.
+                  "A String",
+                ],
+                "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  "A String",
+                ],
+                "disabled": True or False, # If true, disables the CORS policy.
+                    # The default value is false, which indicates that the CORS
+                    # policy is in effect.
+                "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                    # header.
+                  "A String",
+                ],
+                "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                    # seconds. This field translates to the Access-Control-Max-Age
+                    # header.
+              },
+              "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by a load balancer on a percentage of requests before sending
+                  # those requests to the backend service. Similarly requests from clients can
+                  # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                  # that are configured with a fault_injection_policy if:
+                  # 1. The traffic is generated by fault injection AND
+                  # 2. The fault injection is not a delay fault injection.
+                  # Fault injection is not supported with the classic Application Load Balancer
+                  # . To see which load balancers support fault injection,
+                  # see Load
+                  # balancing: Routing and traffic management features.
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by the load balancer on a percentage of requests before sending
+                  # those request to the backend service. Similarly requests from clients can be
+                  # aborted by the load balancer for a percentage of requests.
+                "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                    # injection.
+                  "httpStatus": 42, # The HTTP status code used to abort the request.
+                      #
+                      # The value must be from 200 to 599 inclusive.
+                      #
+                      # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                      # according to this
+                      # mapping table. HTTP status 200 is mapped to gRPC status
+                      # UNKNOWN. Injecting an OK status is currently not supported by
+                      # Traffic Director.
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                      # that is aborted as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+                "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                    # injection, before being sent to a backend service.
+                    # request to the backend service as part of fault injection.
+                  "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                      # which a delay is introduced as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+              },
+              "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                  # Unlike the timeout field where the timeout duration starts
+                  # from the time the request has been fully processed (known as*end-of-stream*),
+                  # the duration in this field is computed from the beginning of the stream
+                  # until the response has been processed, including all retries. A
+                  # stream that does not complete in this duration is closed.
+                  #
+                  # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                  # with the route.
+                  #
+                  # This field is only allowed if the Url map is used with backend services
+                  # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                  # are shadowed to a separate mirrored backend service. The load balancer does
+                  # not wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host / authority header is suffixed with-shadow.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # are shadowed to a separate mirrored backend service. The load balancer
+                  # doesn't wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host or authority header is suffixed with-shadow.
+                "backendService": "A String", # The full or partial URL to the BackendService resource being
+                    # mirrored to.
+                    #
+                    # The backend service configured for a mirroring
+                    # policy must reference backends that are of the same type as the original
+                    # backend service matched in the URL map.
+                    #
+                    # Serverless NEG backends are not currently supported as a mirrored
+                    # backend service.
+                "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+              },
+              "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                    # If not specified, defaults to 1.
+                "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                    #
+                    # If not specified, will use the timeout set in theHttpRouteAction field.
+                    # If timeout in the HttpRouteAction field is not set, this field
+                    # uses the largest timeout
+                    # among all backend services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                    # values are:
+                    #
+                    #    - 5xx: retry is attempted if the instance or endpoint
+                    #    responds with any 5xx response code, or if the instance or
+                    #    endpoint does not respond at all. For example, disconnects, reset, read
+                    #    timeout, connection failure, and refused streams.
+                    #    - gateway-error: Similar to 5xx, but only
+                    #    applies to response codes 502, 503 or504.
+                    #    - connect-failure: a retry is attempted on failures
+                    #    connecting to the instance or endpoint. For example, connection
+                    #    timeouts.
+                    #    - retriable-4xx: a retry is attempted if the instance
+                    #    or endpoint responds with a 4xx response code.
+                    #    The only error that you can retry is error code 409.
+                    #    - refused-stream: a retry is attempted if the instance
+                    #    or endpoint resets the stream with a REFUSED_STREAM error
+                    #    code. This reset type indicates that it is safe to retry.
+                    #    - cancelled: a retry is attempted if the gRPC status
+                    #    code in the response header is set to cancelled.
+                    #    - deadline-exceeded: a retry is attempted if the gRPC
+                    #    status code in the response header is set todeadline-exceeded.
+                    #    - internal: a retry is attempted if the gRPC
+                    #    status code in the response header is set tointernal.
+                    #    - resource-exhausted: a retry is attempted if the gRPC
+                    #    status code in the response header is set toresource-exhausted.
+                    #    - unavailable: a retry is attempted if the gRPC
+                    #    status code in the response header is set tounavailable.
+                    #
+                    # Only the following codes are supported when the URL map is bound to
+                    # target gRPC proxy that has validateForProxyless field set to true.
+                    #
+                    #    - cancelled
+                    #    - deadline-exceeded
+                    #    - internal
+                    #    - resource-exhausted
+                    #    - unavailable
+                  "A String",
+                ],
+              },
+              "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                  # time the request has been fully processed (known as *end-of-stream*)
+                  # up until the response has been processed. Timeout includes
+                  # all retries.
+                  #
+                  # If not specified, this field uses the largest timeout among all backend
+                  # services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                  # to the matched service.
+                  #
+                  #  urlRewrite is the only action supported in UrlMaps
+                  # for classic Application Load Balancers.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # backend service.
+                "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                    # host header is replaced with contents of hostRewrite.
+                    #
+                    # The value must be from 1 to 255 characters.
+                "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                    # matching portion of the request's path is replaced bypathPrefixRewrite.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                    # header) using the HTTP template syntax.
+                    #
+                    # A corresponding
+                    # path_template_match must be specified. Any template variables must exist in
+                    # the path_template_match field.
+                    #
+                    #
+                    #       - -At least one variable must be specified in the path_template_match
+                    #       field
+                    #    - You can omit variables from the rewritten URL
+                    #       - The * and ** operators cannot be matched
+                    #       unless they have a corresponding variable name - e.g.
+                    #       {format=*} or {var=**}.
+                    #
+                    # For example, a path_template_match of /static/{format=**}
+                    # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                    # rewrite, so that /{country}/{format}/{suffix=**} can be
+                    # rewritten as /content/{format}/{country}/{suffix}.
+                    #
+                    # At least
+                    # one non-empty routeRules[].matchRules[].path_template_match is
+                    # required.
+                    #
+                    # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                  "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                      # It uses RE2 syntax with the following constraints:
+                      #
+                      #
+                      #      - Any single character operators
+                      #      - Groups are allowed to have only submatch operator inside
+                      #      - Groups are allowed only without any char repetition, e.g.
+                      #      .*
+                      #      - Any char repetition, e.g. .*, is
+                      #      only allowed to be used in a single regex together with:
+                      #
+                      #
+                      #             - Empty string operators
+                      #             - Other repetitions
+                      #             - Ranges
+                      #             - Repetitions of ranges
+                      #
+                      #
+                      #      - Ranges are only allowed to have:
+                      #
+                      #
+                      #             - Character range
+                      #             - Digits range
+                      #             - Symbols listed in characters allowed for ranges
+                  "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                      # the path.
+                },
+              },
+              "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                  # occurs. The weights determine the fraction of traffic that flows to
+                  # their corresponding backend service. If all traffic needs to
+                  # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                  #
+                  # After a backend service is identified and before forwarding
+                  # the request to
+                  # the backend service, advanced routing actions such as URL rewrites and
+                  # header transformations are applied depending on additional settings
+                  # specified in this HttpRouteAction.
+                { # In contrast to a single BackendService in
+                    # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                    # multiple backend services. The volume of traffic for each
+                    # backend service is proportional to the weight specified
+                    # in each WeightedBackendService
+                  "backendService": "A String", # The full or partial URL to the default BackendService
+                      # resource. Before
+                      # forwarding the request to backendService, the load balancer
+                      # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                      # effect for the selected backendService.
+                      #
+                      # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                      #
+                      # headerAction is not supported for load balancers that have
+                      # their loadBalancingScheme set to EXTERNAL.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                      # the request is passed along to the selected backendService.
+                    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # request before forwarding the request to the backendService.
+                      "A String",
+                    ],
+                    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                        # client.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # response before sending the response back to the client.
+                      "A String",
+                    ],
+                  },
+                  "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                      # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                      #
+                      # The selection of a backend service is determined only for new traffic.
+                      # Once a user's request has been directed to a backend service,
+                      # subsequent requests are sent to the same backend service as
+                      # determined by the backend service's session affinity policy.
+                      # Don't configure session affinity if you're using weighted traffic
+                      # splitting. If you do, the weighted traffic splitting configuration takes
+                      # precedence.
+                      #
+                      # The value must be from 0 to 1000.
+                },
+              ],
+            },
+            "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                # is directed if this rule is matched. If routeAction is
+                # also specified, advanced routing actions, such as URL rewrites,
+                # take effect before sending the request to the backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+            "urlRedirect": { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
+                # specified by urlRedirect.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+              "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                  # was supplied in the request.
+                  #
+                  # The value must be from 1 to 255
+                  # characters.
+              "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                  # set to HTTPS.
+                  # If set to false, the URL scheme of the redirected request
+                  # remains the same as that of the request.
+                  #
+                  # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                  #
+                  # The default is set to false.
+              "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                  # that was supplied in the request.
+                  #
+                  # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                  # the HttpRouteRuleMatch, retaining the remaining portion
+                  # of the URL before redirecting the request.
+                  #
+                  # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                  #
+                  # Supported values are:
+                  #
+                  #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                  #    to 301.
+                  #    - FOUND, which corresponds to 302.
+                  #    - SEE_OTHER which corresponds to 303.
+                  #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                  #    method is retained.
+                  #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                  #    method is retained.
+              "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                  # URL is
+                  # removed before redirecting the request. If set to false, the
+                  # query portion of the original URL is retained.
+                  #
+                  # The default is set to false.
+            },
+          },
+        ],
+        "routeRules": [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
+            # desired. routeRules are evaluated in order of priority, from
+            # the lowest to highest number.
+            #
+            # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
+          { # The HttpRouteRule setting specifies how to match an HTTP request
+              # and the corresponding routing action that load balancing proxies perform.
+            "customErrorResponsePolicy": { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
+                # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
+                #
+                # If a policy for an
+                # error code is not configured for the RouteRule, a policy for
+                # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
+                # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
+                # configured in UrlMap.defaultCustomErrorResponsePolicy takes
+                # effect.
+                #
+                # For example, consider a UrlMap with the following configuration:
+                #
+                #
+                #      - UrlMap.defaultCustomErrorResponsePolicy are configured
+                #      with policies for 5xx and 4xx errors
+                #      - A RouteRule for /coming_soon/ is configured for the
+                #      error code 404.
+                #
+                # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy
+                # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
+                # the policy in RouteRule.customErrorResponsePolicy takes
+                # effect. If any of the requests in this example encounter a 500
+                # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
+                #
+                # When
+                # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
+                # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
+                # a retry, if load balancer is successful in reaching the
+                # service, the customErrorResponsePolicy is ignored and
+                # the response from the service is returned to the client.
+                #
+                # customErrorResponsePolicy is supported only for
+                # global external Application Load Balancers.
+                # backend service or backend bucket responds with an error.
+              "errorResponseRules": [ # Specifies rules for returning error responses.
+                  #
+                  # In a given policy, if you specify rules for both a range of error codes
+                  # as well as rules for specific error codes then rules with specific error
+                  # codes have a higher priority. For example, assume that you configure a rule
+                  # for 401 (Un-authorized) code, and another for all 4 series
+                  # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
+                  # However if the backend service returns a 403, the rule for4xx takes effect.
+                { # Specifies the mapping between the response code that will be returned along
+                    # with the custom error content and the response code returned by the backend
+                    # service.
+                  "matchResponseCodes": [ # Valid values include:
+                      #
+                      #
+                      #      - A number between 400 and 599: For example
+                      #      401 or 503, in which case the load balancer
+                      #      applies the policy if the error code exactly matches this value.
+                      #      - 5xx: Load Balancer will apply the policy if the
+                      #      backend service responds with any response code in the range of
+                      #      500 to 599.
+                      #    - 4xx: Load
+                      #      Balancer will apply the policy if the backend service responds with any
+                      #      response code in the range of 400 to
+                      #      499.
+                      #
+                      # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
+                    "A String",
+                  ],
+                  "overrideResponseCode": 42, # The HTTP status code returned with the response containing the custom
+                      # error content. If overrideResponseCode is not supplied, the
+                      # same response code returned by the original backend bucket or backend
+                      # service is returned to the client.
+                  "path": "A String", # The full path to a file within backendBucket . For example:/errors/defaultError.html
+                      #
+                      # path must start
+                      # with a leading slash. path cannot have trailing slashes.
+                      #
+                      # If the file is not available in backendBucket  or the
+                      # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
+                      #
+                      # The value must
+                      # be from 1 to 1024 characters
+                },
+              ],
+              "errorService": "A String", # The full or partial URL to the BackendBucket resource that
+                  # contains the custom error content. Examples are:
+                  #
+                  #
+                  #      - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - compute/v1/projects/project/global/backendBuckets/myBackendBucket
+                  #      - global/backendBuckets/myBackendBucket
+                  #
+                  # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
+                  # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
+                  #
+                  # If load balancer cannot reach
+                  # the backendBucket, a simple Not Found Error will
+                  # be returned, with the original response code (oroverrideResponseCode if configured).
+                  #
+                  # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
+            },
+            "description": "A String", # The short description conveying the intent of this routeRule.
+                #
+                #
+                # The description can have a maximum length of 1024 characters.
+            "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
+                # for the selected backendService.
+                #
+                # The headerAction value specified here is applied before the
+                # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
+                #
+                # HeaderAction is not supported for load balancers
+                # that have
+                # their loadBalancingScheme set to EXTERNAL.
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy that
+                # has validateForProxyless field set to true.
+                # the request is passed along to the selected backendService.
+              "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # request before forwarding the request to the backendService.
+                "A String",
+              ],
+              "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                  # client.
+                { # Specification determining how headers are added to requests or responses.
+                  "headerName": "A String", # The name of the header.
+                  "headerValue": "A String", # The value of the header to add.
+                  "replace": True or False, # If false, headerValue is appended to any values
+                      # that already
+                      # exist for the header. If true, headerValue is set for the
+                      # header, discarding any values that were set for that header.
+                      #
+                      # The default value is true,
+                      # unless a variable is present in headerValue,
+                      # in which case the default value is false.
+                      # .
+                },
+              ],
+              "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                  # response before sending the response back to the client.
+                "A String",
+              ],
+            },
+            "matchRules": [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
+                # this routeRule when any of thematchRules are satisfied. However predicates within
+                # a given matchRule have AND semantics. All predicates
+                # within a matchRule must match for the request to
+                # match the rule.
+              { # HttpRouteRuleMatch specifies a set of criteria for matching
+                  # requests to an HttpRouteRule. All specified criteria must
+                  # be satisfied for a match to occur.
+                "fullPathMatch": "A String", # For satisfying the matchRule condition, the path of the
+                    # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
+                    # that may be part of the original URL.
+                    #
+                    # fullPathMatch must be from 1 to 1024 characters.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                    # specified.
+                "headerMatches": [ # Specifies a list of header match criteria, all of which must match
+                    # corresponding headers in the request.
+                  { # matchRule criteria for request header matches.
+                    "exactMatch": "A String", # The value should exactly match contents of exactMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "headerName": "A String", # The name of the HTTP header to match.
+                        #
+                        # For matching against the HTTP request's authority, use a headerMatch
+                        # with the header name ":authority".
+                        #
+                        # For matching a request's method, use the headerName ":method".
+                        #
+                        # When the URL map is bound to a target gRPC proxy that has
+                        # the validateForProxyless field set to true, only
+                        # non-binary
+                        # user-specified custom metadata and the `content-type` header are supported.
+                        # The following transport-level headers cannot be used in header matching
+                        # rules:
+                        # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
+                        # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
+                        # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
+                        # `grpc-timeout` and `grpc-trace-bin`.
+                    "invertMatch": True or False, # If set to false, the headerMatch is considered a
+                        # match if the preceding match criteria are met. If set to true,
+                        # the headerMatch is considered a match if the preceding
+                        # match criteria are NOT met.
+                        #
+                        # The default setting is false.
+                    "prefixMatch": "A String", # The value of the header must start with the contents ofprefixMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "presentMatch": True or False, # A header with the contents of headerName must exist. The
+                        # match takes place whether or not the request's header has a value.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                    "rangeMatch": { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
+                        # specified in rangeMatch. If the header does not contain an
+                        # integer, number or is empty, the match fails.
+                        #
+                        # For example for a range [-5, 0]
+                        #
+                        #
+                        #       - -3 will match.
+                        #       - 0 will not match.
+                        #       - 0.25 will not match.
+                        #       - -3someString will not match.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                        #
+                        # rangeMatch is not supported for load balancers
+                        # that have loadBalancingScheme set to EXTERNAL.
+                        # within the specified integer range.
+                      "rangeEnd": "A String", # The end of the range (exclusive) in signed long integer format.
+                      "rangeStart": "A String", # The start of the range (inclusive) in signed long integer format.
+                    },
+                    "regexMatch": "A String", # The value of the header must match the regular expression specified inregexMatch.
+                        # For more information about regular expression syntax, see Syntax.
+                        #
+                        # For matching against a port specified in the HTTP request, use a
+                        # headerMatch with headerName set to PORT and a regular expression that
+                        # satisfies the RFC2616 Host header's port specifier.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                        #
+                        # Regular expressions can only be used when the loadBalancingScheme is
+                        # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                        # (regional scope) or INTERNAL_MANAGED.
+                    "suffixMatch": "A String", # The value of the header must end with the contents ofsuffixMatch.
+                        #
+                        # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
+                  },
+                ],
+                "ignoreCase": True or False, # Specifies that prefixMatch and fullPathMatch
+                    # matches are case sensitive.
+                    #
+                    # The default value is false.
+                    #
+                    # ignoreCase must not be used with regexMatch.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                "metadataFilters": [ # Opaque filter criteria used by the load balancer to restrict routing
+                    # configuration to a limited set of xDS
+                    # compliant clients. In their xDS requests to the load balancer, xDS clients
+                    # present node
+                    # metadata. When there is a match, the relevant routing configuration
+                    # is made available to those proxies.
+                    #
+                    # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
+                    # the metadata. If its filterMatchCriteria is set to
+                    # MATCH_ALL, then all of its filterLabels must match with
+                    # corresponding labels provided in the metadata. If multiple
+                    # metadata filters are specified, all of them need to be
+                    # satisfied in order to be considered a match.
+                    #
+                    # metadataFilters specified here is applied after those
+                    # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
+                    #
+                    # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has validateForProxyless field set to true.
+                  { # Opaque filter criteria used by load balancers to restrict routing
+                      # configuration to a limited set of load balancing proxies. Proxies and
+                      # sidecars involved in load balancing would typically present metadata to the
+                      # load balancers that need to match criteria specified here. If a match takes
+                      # place, the relevant configuration is made available to those
+                      # proxies.
+                      #
+                      # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
+                      # one of thefilterLabels must match the corresponding label provided in
+                      # the metadata. If its filterMatchCriteria is set to
+                      # MATCH_ALL, then all of its filterLabels must match with
+                      # corresponding labels provided in the metadata.
+                      #
+                      # An example for using metadataFilters would be: if
+                      # load balancing involves
+                      # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in  of their XDS requests to loadbalancers.
+                    "filterLabels": [ # The list of label value pairs that must match labels in the provided
+                        # metadata based on filterMatchCriteria
+                        #
+                        # This list must not be empty and can have at the most 64 entries.
+                      { # MetadataFilter label name value pairs that are expected
+                          # to match corresponding labels presented as metadata to the load balancer.
+                        "name": "A String", # Name of metadata label.
+                            #
+                            #  The name can have a maximum length of 1024 characters and must be at
+                            # least 1 character long.
+                        "value": "A String", # The value of the label must match the specified value.
+                            #
+                            # value can have a maximum length of 1024 characters.
+                      },
+                    ],
+                    "filterMatchCriteria": "A String", # Specifies how individual filter label matches
+                        # within the list of filterLabels and contributes toward the
+                        # overall metadataFilter match.
+                        #
+                        #  Supported values are:
+                        #
+                        #    - MATCH_ANY: at least one of the filterLabels
+                        #    must have a matching label in the provided metadata.
+                        #    - MATCH_ALL: all filterLabels must have
+                        #    matching labels in the provided metadata.
+                  },
+                ],
+                "pathTemplateMatch": "A String", # If specified, this field defines a path template pattern that must match
+                    # the :path header after the query string is removed.
+                    #
+                    # A path template pattern can include variables and wildcards.
+                    # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
+                    # matches a single path segment, and ** that matches zero or
+                    # more path segments. The pattern must follow these rules:
+                    #
+                    #
+                    #       - The value must be between 1 and 1024 characters.
+                    #       - The pattern must start with a leading slash ("/").
+                    #       - No more than 5 operators (variables or wildcards) may appear in
+                    #       the pattern.
+                    #
+                    # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
+                    # set.
+                "prefixMatch": "A String", # For satisfying the matchRule condition, the request's
+                    # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                    #
+                    # The * character inside a prefix match is
+                    # treated as a literal character, not as a wildcard.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
+                    # used within a matchRule.
+                "queryParameterMatches": [ # Specifies a list of query parameter match criteria, all of which must
+                    # match corresponding query parameters in the request.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy.
+                  { # HttpRouteRuleMatch criteria for a request's query parameter.
+                    "exactMatch": "A String", # The queryParameterMatch matches if the value of the
+                        # parameter exactly matches the contents of exactMatch.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                    "name": "A String", # The name of the query parameter to match. The query parameter must exist in
+                        # the request, in the absence of which the request match fails.
+                    "presentMatch": True or False, # Specifies that the queryParameterMatch matches if the
+                        # request contains the query parameter, irrespective of whether the
+                        # parameter has a value or not.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                    "regexMatch": "A String", # The queryParameterMatch matches if the value of the
+                        # parameter matches the regular expression specified byregexMatch. For
+                        # more information about regular expression syntax, see Syntax.
+                        #
+                        # Only one of presentMatch, exactMatch, orregexMatch must be set.
+                        #
+                        # Regular expressions can only be used when the loadBalancingScheme is
+                        # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                        # (regional scope) or INTERNAL_MANAGED.
+                  },
+                ],
+                "regexMatch": "A String", # For satisfying the matchRule condition, the path of the
+                    # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
+                    # supplied with the original URL. For
+                    # more information about regular expression syntax, see Syntax.
+                    #
+                    # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
+                    # specified.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
+                    # (regional scope) or INTERNAL_MANAGED.
+              },
+            ],
+            "priority": 42, # For routeRules within a given pathMatcher,
+                # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
+                # of priority, from the lowest to highest number. The priority of a
+                # rule decreases as its number increases (1, 2, 3, N+1). The first rule
+                # that matches the request is applied.
+                #
+                #
+                # You cannot configure two or more routeRules with the same priority.
+                # Priority for each rule must be set to a number from 0 to 2147483647
+                # inclusive.
+                #
+                #
+                # Priority numbers can have gaps, which enable you to add or remove rules
+                # in the future without affecting the rest of the rules. For example, 1, 2,
+                # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
+                # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
+                # without any impact on existing rules.
+            "routeAction": { # In response to a matching matchRule, the load balancer
+                # performs advanced routing actions, such as URL rewrites and header
+                # transformations, before forwarding the request to the selected backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # URL maps for classic Application Load Balancers only support
+                # the urlRewrite action within a route rule'srouteAction.
+              "cachePolicy": { # Message containing CachePolicy configuration for URL Map's Route Action. # Specifies the cache policy configuration for matched traffic. Available
+                  # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
+                  # property must be specified. This policy cannot be specified if any target
+                  # backend has Identity-Aware Proxy enabled.
+                "cacheBypassRequestHeaderNames": [ # Bypass the cache when the specified request headers are matched by name,
+                    # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
+                    # header names can be specified. The cache is bypassed for all `cacheMode`
+                    # values.
+                  "A String",
+                ],
+                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
+                    # on the backend type: for Backend Services, the complete request URI is
+                    # used; for Backend Buckets, the request URI is used without the protocol or
+                    # host, and only query parameters known to Cloud Storage are included.
+                    # Policy defined on Route Action.
+                  "excludedQueryParameters": [ # Names of query string parameters to exclude in cache keys. All other
+                      # parameters will be included. Either specify `excludedQueryParameters`
+                      # or `includedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                    "A String",
+                  ],
+                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # host is never included in a Backend Bucket's cache key. Attempting to set
+                      # it on a route that points exclusively to Backend Buckets will result in a
+                      # configuration error.
+                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket, as the
+                      # protocol is never included in a Backend Bucket's cache key. Attempting to
+                      # set on a route that points exclusively to Backend Buckets will result in
+                      # a configuration error.
+                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to
+                      # `includedQueryParameters` and `excludedQueryParameters`. If neither
+                      # is set, the entire query string will be included. If false, the query
+                      # string will be excluded from the cache key entirely.
+                      #
+                      # Note: This field applies to routes that use backend services. Attempting
+                      # to set it on a route that points exclusively to Backend Buckets will
+                      # result in a configuration error. For routes that point to a Backend
+                      # Bucket, use `includedQueryParameters` to define which parameters should
+                      # be part of the cache key.
+                  "includedCookieNames": [ # Allows HTTP cookies (by name) to be used in the cache key.
+                      # The name=value pair will be used in the cache key Cloud CDN generates.
+                      #
+                      # Note: This setting is only applicable to routes that use a Backend
+                      # Service. It does not affect requests served by a Backend Bucket.
+                      # Attempting to set it on a route that points exclusively to Backend
+                      # Buckets will result in a configuration error. Up to 5 cookie names can be
+                      # specified.
+                    "A String",
+                  ],
+                  "includedHeaderNames": [ # Allows HTTP request headers (by name) to be used in the cache key.
+                    "A String",
+                  ],
+                  "includedQueryParameters": [ # Names of query string parameters to include in cache keys. All other
+                      # parameters will be excluded. Either specify `includedQueryParameters`
+                      # or `excludedQueryParameters`, not both. '&' and '=' will be percent
+                      # encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                },
+                "cacheMode": "A String", # Specifies the cache setting for all responses from this route. If not
+                    # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
+                "clientTtl": { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
+                    # content. This is used to clamp the max-age (or Expires) value sent to the
+                    # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
+                    # is used for the response max-age directive, along with a "public"
+                    # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
+                    # clamps the max-age from the origin (if specified), or else sets the
+                    # response max-age directive to the lesser of the `clientTtl` and
+                    # `defaultTtl`, and also ensures a "public" cache-control directive is
+                    # present. The maximum allowed value is 31,622,400s (1 year). If not
+                    # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
+                    # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "defaultTtl": { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
+                    # an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
+                    # "always revalidate". The value of `defaultTtl` cannot be set to a value
+                    # greater than that of `maxTtl`. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
+                    # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
+                    # accessed objects may be evicted from the cache before the defined TTL. If
+                    # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
+                    # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
+                    # `USE_ORIGIN_HEADERS`.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "maxTtl": { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
+                    # attempt to set a max-age or s-maxage higher than this, or an Expires header
+                    # more than `maxTtl` seconds in the future will be capped at the value of
+                    # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
+                    # Headers sent to the client will not be modified. Setting a TTL of "0" means
+                    # "always revalidate". The maximum allowed value is 31,622,400s (1 year).
+                    # Infrequently accessed objects may be evicted from the cache before the
+                    # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
+                    # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
+                    # mode.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "negativeCaching": True or False, # Negative caching allows per-status code TTLs to be set, in order
+                    # to apply fine-grained caching for common errors or redirects.
+                    # This can reduce the load on your origin and improve end-user
+                    # experience by reducing response latency.
+                    # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
+                    # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
+                    # the specified response code that lack any Cache-Control, Expires, or
+                    # Pragma: no-cache directives. When the `cacheMode` is set to
+                    # `FORCE_CACHE_ALL`, negative caching applies to all responses
+                    # with the specified response code, and overrides any caching headers. By
+                    # default, Cloud CDN applies the following TTLs to these HTTP status codes:
+                    #
+                    # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
+                    # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
+                    # * 405 (Method Not Found), 501 (Not Implemented): 60s
+                    #
+                    # These defaults can be overridden in `negativeCachingPolicy`.
+                    # If not specified, Cloud CDN applies negative caching by default.
+                "negativeCachingPolicy": [ # Sets a cache TTL for the specified HTTP status code.
+                    # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
+                    # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
+                    # CDN's default cache TTLs. Note that when specifying an explicit
+                    # `negativeCachingPolicy`, you should take care to specify a cache TTL for
+                    # all response codes that you wish to cache. Cloud CDN will not apply any
+                    # default negative caching when a policy exists.
+                  { # Specify CDN TTLs for response error codes.
+                    "code": 42, # The HTTP status code to define a TTL against. Only HTTP status codes
+                        # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
+                        # specified as values, and you cannot specify a status code more than
+                        # once.
+                    "ttl": { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
+                        # corresponding status code.
+                        # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
+                        # objects may be evicted from the cache before the defined TTL.
+                        # as a count of seconds and fractions of seconds at nanosecond
+                        # resolution. It is independent of any calendar and concepts like "day"
+                        # or "month". Range is approximately 10,000 years.
+                      "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                          # Durations less than one second are represented with a 0
+                          # `seconds` field and a positive `nanos` field. Must be from 0
+                          # to 999,999,999 inclusive.
+                      "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                          # 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
+                    },
+                  },
+                ],
+                "requestCoalescing": True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
+                    # requests into a small number of requests to the origin. If not specified,
+                    # Cloud CDN applies request coalescing by default.
+                "serveWhileStale": { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
+                    # content with the origin, or when an error is encountered when refreshing
+                    # the cache.
+                    # This setting defines the default "max-stale" duration for any cached
+                    # responses that do not specify a max-stale directive. Stale responses that
+                    # exceed the TTL configured here will not be served. The default limit
+                    # (max-stale) is 86400s (1 day), which will allow stale content to be
+                    # served up to this limit beyond the max-age (or s-maxage) of a cached
+                    # response.
+                    # The maximum allowed value is 604800 (1 week).
+                    # Set this to zero (0) to disable serve-while-stale.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+              },
+              "corsPolicy": { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy.
+                  # information about the W3C recommendation for cross-origin resource sharing
+                  # (CORS), see Fetch API Living
+                  # Standard.
+                "allowCredentials": True or False, # In response to a preflight request, setting this to true
+                    # indicates that
+                    # the actual request can include user credentials. This field translates to
+                    # the Access-Control-Allow-Credentials header.
+                    #
+                    # Default is false.
+                "allowHeaders": [ # Specifies the content for the Access-Control-Allow-Headers
+                    # header.
+                  "A String",
+                ],
+                "allowMethods": [ # Specifies the content for the Access-Control-Allow-Methods
+                    # header.
+                  "A String",
+                ],
+                "allowOriginRegexes": [ # Specifies a regular expression that matches allowed origins. For
+                    # more information, see regular expression syntax.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                    #
+                    # Regular expressions can only be used when the loadBalancingScheme is
+                    # set to INTERNAL_SELF_MANAGED.
+                  "A String",
+                ],
+                "allowOrigins": [ # Specifies the list of origins that is allowed to do CORS requests.
+                    #
+                    # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
+                  "A String",
+                ],
+                "disabled": True or False, # If true, disables the CORS policy.
+                    # The default value is false, which indicates that the CORS
+                    # policy is in effect.
+                "exposeHeaders": [ # Specifies the content for the Access-Control-Expose-Headers
+                    # header.
+                  "A String",
+                ],
+                "maxAge": 42, # Specifies how long results of a preflight request can be cached in
+                    # seconds. This field translates to the Access-Control-Max-Age
+                    # header.
+              },
+              "faultInjectionPolicy": { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by a load balancer on a percentage of requests before sending
+                  # those requests to the backend service. Similarly requests from clients can
+                  # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
+                  # that are configured with a fault_injection_policy if:
+                  # 1. The traffic is generated by fault injection AND
+                  # 2. The fault injection is not a delay fault injection.
+                  # Fault injection is not supported with the classic Application Load Balancer
+                  # . To see which load balancers support fault injection,
+                  # see Load
+                  # balancing: Routing and traffic management features.
+                  # the resiliency of clients to backend service failure. As part of fault
+                  # injection, when clients send requests to a backend service, delays can be
+                  # introduced by the load balancer on a percentage of requests before sending
+                  # those request to the backend service. Similarly requests from clients can be
+                  # aborted by the load balancer for a percentage of requests.
+                "abort": { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
+                    # injection.
+                  "httpStatus": 42, # The HTTP status code used to abort the request.
+                      #
+                      # The value must be from 200 to 599 inclusive.
+                      #
+                      # For gRPC protocol, the gRPC status code is mapped to HTTP status code
+                      # according to this
+                      # mapping table. HTTP status 200 is mapped to gRPC status
+                      # UNKNOWN. Injecting an OK status is currently not supported by
+                      # Traffic Director.
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests
+                      # that is aborted as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+                "delay": { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
+                    # injection, before being sent to a backend service.
+                    # request to the backend service as part of fault injection.
+                  "fixedDelay": { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
+                      # as a count of seconds and fractions of seconds at nanosecond
+                      # resolution. It is independent of any calendar and concepts like "day"
+                      # or "month". Range is approximately 10,000 years.
+                    "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                        # Durations less than one second are represented with a 0
+                        # `seconds` field and a positive `nanos` field. Must be from 0
+                        # to 999,999,999 inclusive.
+                    "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                        # 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
+                  },
+                  "percentage": 3.14, # The percentage of traffic for connections, operations, or requests for
+                      # which a delay is introduced as part of fault injection.
+                      #
+                      # The value must be from 0.0 to 100.0 inclusive.
+                },
+              },
+              "maxStreamDuration": { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
+                  # Unlike the timeout field where the timeout duration starts
+                  # from the time the request has been fully processed (known as*end-of-stream*),
+                  # the duration in this field is computed from the beginning of the stream
+                  # until the response has been processed, including all retries. A
+                  # stream that does not complete in this duration is closed.
+                  #
+                  # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
+                  # with the route.
+                  #
+                  # This field is only allowed if the Url map is used with backend services
+                  # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "requestMirrorPolicy": { # A policy that specifies how requests intended for the route's backends # Specifies the policy on how requests intended for the route's backends
+                  # are shadowed to a separate mirrored backend service. The load balancer does
+                  # not wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host / authority header is suffixed with-shadow.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # are shadowed to a separate mirrored backend service. The load balancer
+                  # doesn't wait for responses from the shadow service. Before sending traffic
+                  # to the shadow service, the host or authority header is suffixed with-shadow.
+                "backendService": "A String", # The full or partial URL to the BackendService resource being
+                    # mirrored to.
+                    #
+                    # The backend service configured for a mirroring
+                    # policy must reference backends that are of the same type as the original
+                    # backend service matched in the URL map.
+                    #
+                    # Serverless NEG backends are not currently supported as a mirrored
+                    # backend service.
+                "mirrorPercent": 3.14, # The percentage of requests to be mirrored to `backend_service`.
+              },
+              "retryPolicy": { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
+                "numRetries": 42, # Specifies the allowed number retries. This number must be > 0.
+                    # If not specified, defaults to 1.
+                "perTryTimeout": { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
+                    #
+                    # If not specified, will use the timeout set in theHttpRouteAction field.
+                    # If timeout in the HttpRouteAction field is not set, this field
+                    # uses the largest timeout
+                    # among all backend services associated with the route.
+                    #
+                    # Not supported when the URL map is bound to a target gRPC proxy that
+                    # has the validateForProxyless field set to true.
+                    # as a count of seconds and fractions of seconds at nanosecond
+                    # resolution. It is independent of any calendar and concepts like "day"
+                    # or "month". Range is approximately 10,000 years.
+                  "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                      # Durations less than one second are represented with a 0
+                      # `seconds` field and a positive `nanos` field. Must be from 0
+                      # to 999,999,999 inclusive.
+                  "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                      # 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
+                },
+                "retryConditions": [ # Specifies one or more conditions when this retry policy applies. Valid
+                    # values are:
+                    #
+                    #    - 5xx: retry is attempted if the instance or endpoint
+                    #    responds with any 5xx response code, or if the instance or
+                    #    endpoint does not respond at all. For example, disconnects, reset, read
+                    #    timeout, connection failure, and refused streams.
+                    #    - gateway-error: Similar to 5xx, but only
+                    #    applies to response codes 502, 503 or504.
+                    #    - connect-failure: a retry is attempted on failures
+                    #    connecting to the instance or endpoint. For example, connection
+                    #    timeouts.
+                    #    - retriable-4xx: a retry is attempted if the instance
+                    #    or endpoint responds with a 4xx response code.
+                    #    The only error that you can retry is error code 409.
+                    #    - refused-stream: a retry is attempted if the instance
+                    #    or endpoint resets the stream with a REFUSED_STREAM error
+                    #    code. This reset type indicates that it is safe to retry.
+                    #    - cancelled: a retry is attempted if the gRPC status
+                    #    code in the response header is set to cancelled.
+                    #    - deadline-exceeded: a retry is attempted if the gRPC
+                    #    status code in the response header is set todeadline-exceeded.
+                    #    - internal: a retry is attempted if the gRPC
+                    #    status code in the response header is set tointernal.
+                    #    - resource-exhausted: a retry is attempted if the gRPC
+                    #    status code in the response header is set toresource-exhausted.
+                    #    - unavailable: a retry is attempted if the gRPC
+                    #    status code in the response header is set tounavailable.
+                    #
+                    # Only the following codes are supported when the URL map is bound to
+                    # target gRPC proxy that has validateForProxyless field set to true.
+                    #
+                    #    - cancelled
+                    #    - deadline-exceeded
+                    #    - internal
+                    #    - resource-exhausted
+                    #    - unavailable
+                  "A String",
+                ],
+              },
+              "timeout": { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
+                  # time the request has been fully processed (known as *end-of-stream*)
+                  # up until the response has been processed. Timeout includes
+                  # all retries.
+                  #
+                  # If not specified, this field uses the largest timeout among all backend
+                  # services associated with the route.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has validateForProxyless field set to true.
+                  # as a count of seconds and fractions of seconds at nanosecond
+                  # resolution. It is independent of any calendar and concepts like "day"
+                  # or "month". Range is approximately 10,000 years.
+                "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution.
+                    # Durations less than one second are represented with a 0
+                    # `seconds` field and a positive `nanos` field. Must be from 0
+                    # to 999,999,999 inclusive.
+                "seconds": "A String", # Span of time at a resolution of a second. Must be from 0
+                    # 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
+              },
+              "urlRewrite": { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
+                  # to the matched service.
+                  #
+                  #  urlRewrite is the only action supported in UrlMaps
+                  # for classic Application Load Balancers.
+                  #
+                  # Not supported when the URL map is bound to a target gRPC proxy that
+                  # has the validateForProxyless field set to true.
+                  # backend service.
+                "hostRewrite": "A String", # Before forwarding the request to the selected service, the request's
+                    # host header is replaced with contents of hostRewrite.
+                    #
+                    # The value must be from 1 to 255 characters.
+                "pathPrefixRewrite": "A String", # Before forwarding the request to the selected backend service, the
+                    # matching portion of the request's path is replaced bypathPrefixRewrite.
+                    #
+                    # The value must be from 1 to 1024 characters.
+                "pathTemplateRewrite": "A String", # If specified, the pattern rewrites the URL path (based on the :path
+                    # header) using the HTTP template syntax.
+                    #
+                    # A corresponding
+                    # path_template_match must be specified. Any template variables must exist in
+                    # the path_template_match field.
+                    #
+                    #
+                    #       - -At least one variable must be specified in the path_template_match
+                    #       field
+                    #    - You can omit variables from the rewritten URL
+                    #       - The * and ** operators cannot be matched
+                    #       unless they have a corresponding variable name - e.g.
+                    #       {format=*} or {var=**}.
+                    #
+                    # For example, a path_template_match of /static/{format=**}
+                    # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
+                    # rewrite, so that /{country}/{format}/{suffix=**} can be
+                    # rewritten as /content/{format}/{country}/{suffix}.
+                    #
+                    # At least
+                    # one non-empty routeRules[].matchRules[].path_template_match is
+                    # required.
+                    #
+                    # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
+                "regexRewrite": { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
+                  "pathPattern": "A String", # Required. The regular expression used to match against the URL path.
+                      # It uses RE2 syntax with the following constraints:
+                      #
+                      #
+                      #      - Any single character operators
+                      #      - Groups are allowed to have only submatch operator inside
+                      #      - Groups are allowed only without any char repetition, e.g.
+                      #      .*
+                      #      - Any char repetition, e.g. .*, is
+                      #      only allowed to be used in a single regex together with:
+                      #
+                      #
+                      #             - Empty string operators
+                      #             - Other repetitions
+                      #             - Ranges
+                      #             - Repetitions of ranges
+                      #
+                      #
+                      #      - Ranges are only allowed to have:
+                      #
+                      #
+                      #             - Character range
+                      #             - Digits range
+                      #             - Symbols listed in characters allowed for ranges
+                  "pathSubstitution": "A String", # Required. Required when path pattern is specified. Used to rewrite matching parts of
+                      # the path.
+                },
+              },
+              "weightedBackendServices": [ # A list of weighted backend services to send traffic to when a route match
+                  # occurs. The weights determine the fraction of traffic that flows to
+                  # their corresponding backend service. If all traffic needs to
+                  # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
+                  #
+                  # After a backend service is identified and before forwarding
+                  # the request to
+                  # the backend service, advanced routing actions such as URL rewrites and
+                  # header transformations are applied depending on additional settings
+                  # specified in this HttpRouteAction.
+                { # In contrast to a single BackendService in
+                    # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
+                    # multiple backend services. The volume of traffic for each
+                    # backend service is proportional to the weight specified
+                    # in each WeightedBackendService
+                  "backendService": "A String", # The full or partial URL to the default BackendService
+                      # resource. Before
+                      # forwarding the request to backendService, the load balancer
+                      # applies any relevant headerActions specified as part of thisbackendServiceWeight.
+                  "headerAction": { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
+                      # effect for the selected backendService.
+                      #
+                      # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
+                      #
+                      # headerAction is not supported for load balancers that have
+                      # their loadBalancingScheme set to EXTERNAL.
+                      #
+                      # Not supported when the URL map is bound to a target gRPC proxy that
+                      # has validateForProxyless field set to true.
+                      # the request is passed along to the selected backendService.
+                    "requestHeadersToAdd": [ # Headers to add to a matching request before forwarding the request to thebackendService.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "requestHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # request before forwarding the request to the backendService.
+                      "A String",
+                    ],
+                    "responseHeadersToAdd": [ # Headers to add the response before sending the response back to the
+                        # client.
+                      { # Specification determining how headers are added to requests or responses.
+                        "headerName": "A String", # The name of the header.
+                        "headerValue": "A String", # The value of the header to add.
+                        "replace": True or False, # If false, headerValue is appended to any values
+                            # that already
+                            # exist for the header. If true, headerValue is set for the
+                            # header, discarding any values that were set for that header.
+                            #
+                            # The default value is true,
+                            # unless a variable is present in headerValue,
+                            # in which case the default value is false.
+                            # .
+                      },
+                    ],
+                    "responseHeadersToRemove": [ # A list of header names for headers that need to be removed from the
+                        # response before sending the response back to the client.
+                      "A String",
+                    ],
+                  },
+                  "weight": 42, # Specifies the fraction of traffic sent to a backend service,
+                      # computed asweight / (sum of all weightedBackendService weights in routeAction).
+                      #
+                      # The selection of a backend service is determined only for new traffic.
+                      # Once a user's request has been directed to a backend service,
+                      # subsequent requests are sent to the same backend service as
+                      # determined by the backend service's session affinity policy.
+                      # Don't configure session affinity if you're using weighted traffic
+                      # splitting. If you do, the weighted traffic splitting configuration takes
+                      # precedence.
+                      #
+                      # The value must be from 0 to 1000.
+                },
+              ],
+            },
+            "service": "A String", # The full or partial URL of the backend service resource to which traffic
+                # is directed if this rule is matched. If routeAction is
+                # also specified, advanced routing actions, such as URL rewrites,
+                # take effect before sending the request to the backend.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+            "urlRedirect": { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
+                # specified by urlRedirect.
+                #
+                #
+                # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
+                #
+                #
+                # Not supported when the URL map is bound to a target gRPC proxy.
+              "hostRedirect": "A String", # The host that is used in the redirect response instead of the one that
+                  # was supplied in the request.
+                  #
+                  # The value must be from 1 to 255
+                  # characters.
+              "httpsRedirect": True or False, # If set to true, the URL scheme in the redirected request is
+                  # set to HTTPS.
+                  # If set to false, the URL scheme of the redirected request
+                  # remains the same as that of the request.
+                  #
+                  # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
+                  #
+                  # The default is set to false.
+              "pathRedirect": "A String", # The path that is used in the redirect response instead of the one
+                  # that was supplied in the request.
+                  #
+                  # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "prefixRedirect": "A String", # The prefix that replaces the prefixMatch specified in
+                  # the HttpRouteRuleMatch, retaining the remaining portion
+                  # of the URL before redirecting the request.
+                  #
+                  # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
+                  # supplied, the path of the original request is used for the redirect.
+                  #
+                  # The value must be from 1 to 1024 characters.
+              "redirectResponseCode": "A String", # The HTTP Status code to use for this RedirectAction.
+                  #
+                  # Supported values are:
+                  #
+                  #    - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
+                  #    to 301.
+                  #    - FOUND, which corresponds to 302.
+                  #    - SEE_OTHER which corresponds to 303.
+                  #    - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
+                  #    method is retained.
+                  #    - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
+                  #    method is retained.
+              "stripQuery": True or False, # If set to true, any accompanying query portion of the original
+                  # URL is
+                  # removed before redirecting the request. If set to false, the
+                  # query portion of the original URL is retained.
+                  #
+                  # The default is set to false.
+            },
+          },
+        ],
+      },
+    ],
+    "region": "A String", # Output only. [Output Only] URL of the region where the regional URL map resides.
+        # This field is not applicable to global URL maps.
+        # 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.
+    "tests": [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
+        # maximum of 100 tests per UrlMap.
+        #
+        # Not supported when the URL map is bound to a target gRPC proxy that
+        # has validateForProxyless field set to true.
+      { # Message for the expected URL mappings.
+        "description": "A String", # Description of this test case.
+        "expectedOutputUrl": "A String", # The expected output URL evaluated by the load balancer
+            # containing the scheme, host, path and query parameters.
+            #
+            # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
+            # the load balancer to backends. For rules with urlRewrite,
+            # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
+            #
+            # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's
+            # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
+            # If urlRedirect specifies strip_query, the test
+            # passes only if expectedOutputUrl does not contain any query
+            # parameters.
+            #
+            # expectedOutputUrl is optional whenservice is specified.
+        "expectedRedirectResponseCode": 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
+            # load balancer's redirect response.
+            #
+            # expectedRedirectResponseCode cannot be set whenservice is set.
+        "headers": [ # HTTP headers for this request. If headers contains
+            # a host header, then host must also match the header value.
+          { # HTTP headers used in UrlMapTests.
+            "name": "A String", # Header name.
+            "value": "A String", # Header value.
+          },
+        ],
+        "host": "A String", # Host portion of the URL. If headers contains a host header,
+            # then host must also match the header value.
+        "path": "A String", # Path portion of the URL.
+        "service": "A String", # Expected BackendService or BackendBucket resource
+            # the given URL should be mapped to.
+            #
+            # The service field cannot
+            # be set if expectedRedirectResponseCode is set.
+      },
+    ],
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "result": { # Message representing the validation result for a UrlMap.
+    "loadErrors": [
+      "A String",
+    ],
+    "loadSucceeded": True or False, # Whether the given UrlMap can be successfully loaded.
+        # If false, 'loadErrors' indicates the reasons.
+    "testFailures": [
+      {
+        "actualOutputUrl": "A String", # The actual output URL evaluated by a load balancer containing the scheme,
+            # host, path and query parameters.
+        "actualRedirectResponseCode": 42, # Actual HTTP status code for rule with `urlRedirect`
+            # calculated by load balancer
+        "actualService": "A String", # BackendService or BackendBucket returned by load
+            # balancer.
+        "expectedOutputUrl": "A String", # The expected output URL evaluated by a load balancer containing the scheme,
+            # host, path and query parameters.
+        "expectedRedirectResponseCode": 42, # Expected HTTP status code for rule with `urlRedirect`
+            # calculated by load balancer
+        "expectedService": "A String", # Expected BackendService or BackendBucket resource
+            # the given URL should be mapped to.
+        "headers": [ # HTTP headers of the request.
+          { # HTTP headers used in UrlMapTests.
+            "name": "A String", # Header name.
+            "value": "A String", # Header value.
+          },
+        ],
+        "host": "A String", # Host portion of the URL.
+        "path": "A String", # Path portion including query parameters in the URL.
+      },
+    ],
+    "testPassed": True or False, # If successfully loaded, this field indicates whether the test passed.
+        # If false, 'testFailures's indicate the reason of failure.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.vpnGateways.html b/docs/dyn/compute_preview.vpnGateways.html new file mode 100644 index 0000000000..88b059c2c8 --- /dev/null +++ b/docs/dyn/compute_preview.vpnGateways.html @@ -0,0 +1,1844 @@ + + + +

Compute Engine API . vpnGateways

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of VPN gateways.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, vpnGateway, requestId=None, x__xgafv=None)

+

Deletes the specified VPN gateway.

+

+ get(project, region, vpnGateway, x__xgafv=None)

+

Returns the specified VPN gateway.

+

+ getStatus(project, region, vpnGateway, x__xgafv=None)

+

Returns the status for the specified VPN gateway.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a VPN gateway in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of VPN gateways available to the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a VpnGateway. To learn more about labels, read theLabeling

+

+ 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, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of VPN gateways.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of VpnGateway resources.
+    "a_key": { # [Output Only] Name of the scope containing this set of VPN gateways.
+      "vpnGateways": [ # [Output Only] A list of VPN gateways contained in this scope.
+        { # Represents a HA VPN gateway.
+            #
+            # HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely
+            # connect your on-premises network to your Google Cloud Virtual Private Cloud
+            # network through an IPsec VPN connection in a single region.
+            # For more information about Cloud HA VPN solutions, see
+            # Cloud VPN topologies .
+          "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.
+          "gatewayIpVersion": "A String", # The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not
+              # specified, IPV4 will be used.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#vpnGateway", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+              # VPN gateways.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnGateway, which
+              # is essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a VpnGateway.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "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.
+          "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
+              # enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.
+          "vpnInterfaces": [ # The list of VPN interfaces associated with this VPN gateway.
+            { # A VPN gateway interface.
+              "id": 42, # Output only. [Output Only] Numeric identifier for this VPN interface associated with
+                  # the VPN gateway.
+              "interconnectAttachment": "A String", # URL of the VLAN attachment (interconnectAttachment) resource for this
+                  # VPN gateway interface. When the value of this field is present, the VPN
+                  # gateway is used for HA VPN over Cloud Interconnect; all egress
+                  # or ingress traffic for this VPN gateway interface goes through the
+                  # specified VLAN attachment resource.
+              "ipAddress": "A String", # Output only. [Output Only] IP address for this VPN interface associated with the VPN
+                  # gateway.
+                  # The IP address could be either a regional external IP address or
+                  # a regional internal IP address. The two IP addresses for a VPN gateway
+                  # must be all regional external or regional internal IP addresses. There
+                  # cannot be a mix of regional external IP addresses and regional internal
+                  # IP addresses. For HA VPN over Cloud Interconnect, the IP addresses
+                  # for both interfaces could either be regional internal IP addresses or
+                  # regional external IP addresses. For regular (non HA VPN over Cloud
+                  # Interconnect) HA VPN tunnels, the IP address must be a regional external
+                  # IP address.
+              "ipv6Address": "A String", # Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN
+                  # gateway.
+                  # The IPv6 address must be a regional external IPv6 address. The format is
+                  # RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+            },
+          ],
+        },
+      ],
+      "warning": { # [Output Only] Informational warning which replaces the list of addresses
+          # 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#vpnGatewayAggregatedList", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+      # VPN gateways.
+  "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, vpnGateway, requestId=None, x__xgafv=None) + 
Deletes the specified VPN gateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  vpnGateway: string, Name of the VPN gateway 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, vpnGateway, x__xgafv=None) + 
Returns the specified VPN gateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  vpnGateway: string, Name of the VPN gateway 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 HA VPN gateway.
+    #
+    # HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely
+    # connect your on-premises network to your Google Cloud Virtual Private Cloud
+    # network through an IPsec VPN connection in a single region.
+    # For more information about Cloud HA VPN solutions, see
+    # Cloud VPN topologies .
+  "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.
+  "gatewayIpVersion": "A String", # The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not
+      # specified, IPV4 will be used.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#vpnGateway", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+      # VPN gateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnGateway, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a VpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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
+      # enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.
+  "vpnInterfaces": [ # The list of VPN interfaces associated with this VPN gateway.
+    { # A VPN gateway interface.
+      "id": 42, # Output only. [Output Only] Numeric identifier for this VPN interface associated with
+          # the VPN gateway.
+      "interconnectAttachment": "A String", # URL of the VLAN attachment (interconnectAttachment) resource for this
+          # VPN gateway interface. When the value of this field is present, the VPN
+          # gateway is used for HA VPN over Cloud Interconnect; all egress
+          # or ingress traffic for this VPN gateway interface goes through the
+          # specified VLAN attachment resource.
+      "ipAddress": "A String", # Output only. [Output Only] IP address for this VPN interface associated with the VPN
+          # gateway.
+          # The IP address could be either a regional external IP address or
+          # a regional internal IP address. The two IP addresses for a VPN gateway
+          # must be all regional external or regional internal IP addresses. There
+          # cannot be a mix of regional external IP addresses and regional internal
+          # IP addresses. For HA VPN over Cloud Interconnect, the IP addresses
+          # for both interfaces could either be regional internal IP addresses or
+          # regional external IP addresses. For regular (non HA VPN over Cloud
+          # Interconnect) HA VPN tunnels, the IP address must be a regional external
+          # IP address.
+      "ipv6Address": "A String", # Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN
+          # gateway.
+          # The IPv6 address must be a regional external IPv6 address. The format is
+          # RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+    },
+  ],
+}
+
+ +
+ getStatus(project, region, vpnGateway, x__xgafv=None) + 
Returns the status for the specified VPN gateway.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  vpnGateway: string, Name of the VPN gateway 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:
+
+    {
+  "result": {
+    "vpnConnections": [ # Output only. List of VPN connection for this VpnGateway.
+      { # A VPN connection contains all VPN tunnels connected from this VpnGateway
+          # to the same peer gateway. The peer gateway could either be an external VPN
+          # gateway or a Google Cloud VPN gateway.
+        "peerExternalGateway": "A String", # Output only. URL reference to the peer external VPN gateways to which the VPN tunnels
+            # in this VPN connection are connected.
+            # This field is mutually exclusive with peer_gcp_gateway.
+        "peerGcpGateway": "A String", # Output only. URL reference to the peer side VPN gateways to which the VPN tunnels in
+            # this VPN connection are connected.
+            # This field is mutually exclusive with peer_gcp_gateway.
+        "state": { # Describes the high availability requirement state for the VPN connection # HighAvailabilityRequirementState for the VPN connection.
+            # between this Cloud VPN gateway and a peer gateway.
+          "state": "A String", # Indicates the high availability requirement state for the VPN connection.
+              # Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET.
+          "unsatisfiedReason": "A String", # Indicates the reason why the VPN connection does not meet the high
+              # availability redundancy criteria/requirement.
+              # Valid values is INCOMPLETE_TUNNELS_COVERAGE.
+        },
+        "tunnels": [ # List of VPN tunnels that are in this VPN connection.
+          { # Contains some information about a VPN tunnel.
+            "localGatewayInterface": 42, # Output only. The VPN gateway interface this VPN tunnel is associated with.
+            "peerGatewayInterface": 42, # Output only. The peer gateway interface this VPN tunnel is connected to, the peer
+                # gateway could either be an external VPN gateway or a Google Cloud
+                # VPN gateway.
+            "tunnelUrl": "A String", # Output only. URL reference to the VPN tunnel.
+          },
+        ],
+      },
+    ],
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a VPN gateway in the specified project and region using
+the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a HA VPN gateway.
+    # 
+    # HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely
+    # connect your on-premises network to your Google Cloud Virtual Private Cloud
+    # network through an IPsec VPN connection in a single region.
+    # For more information about Cloud HA VPN solutions, see
+    # Cloud VPN topologies .
+  "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.
+  "gatewayIpVersion": "A String", # The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not
+      # specified, IPV4 will be used.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#vpnGateway", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+      # VPN gateways.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnGateway, which
+      # is essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a VpnGateway.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "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.
+  "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
+      # enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.
+  "vpnInterfaces": [ # The list of VPN interfaces associated with this VPN gateway.
+    { # A VPN gateway interface.
+      "id": 42, # Output only. [Output Only] Numeric identifier for this VPN interface associated with
+          # the VPN gateway.
+      "interconnectAttachment": "A String", # URL of the VLAN attachment (interconnectAttachment) resource for this
+          # VPN gateway interface. When the value of this field is present, the VPN
+          # gateway is used for HA VPN over Cloud Interconnect; all egress
+          # or ingress traffic for this VPN gateway interface goes through the
+          # specified VLAN attachment resource.
+      "ipAddress": "A String", # Output only. [Output Only] IP address for this VPN interface associated with the VPN
+          # gateway.
+          # The IP address could be either a regional external IP address or
+          # a regional internal IP address. The two IP addresses for a VPN gateway
+          # must be all regional external or regional internal IP addresses. There
+          # cannot be a mix of regional external IP addresses and regional internal
+          # IP addresses. For HA VPN over Cloud Interconnect, the IP addresses
+          # for both interfaces could either be regional internal IP addresses or
+          # regional external IP addresses. For regular (non HA VPN over Cloud
+          # Interconnect) HA VPN tunnels, the IP address must be a regional external
+          # IP address.
+      "ipv6Address": "A String", # Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN
+          # gateway.
+          # The IPv6 address must be a regional external IPv6 address. The format is
+          # RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+    },
+  ],
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of VPN gateways available to the specified
+project and region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 VpnGateway resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of VpnGateway resources.
+    { # Represents a HA VPN gateway.
+        #
+        # HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely
+        # connect your on-premises network to your Google Cloud Virtual Private Cloud
+        # network through an IPsec VPN connection in a single region.
+        # For more information about Cloud HA VPN solutions, see
+        # Cloud VPN topologies .
+      "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.
+      "gatewayIpVersion": "A String", # The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not
+          # specified, IPV4 will be used.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#vpnGateway", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+          # VPN gateways.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnGateway, which
+          # is essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a VpnGateway.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "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.
+      "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
+          # enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.
+      "vpnInterfaces": [ # The list of VPN interfaces associated with this VPN gateway.
+        { # A VPN gateway interface.
+          "id": 42, # Output only. [Output Only] Numeric identifier for this VPN interface associated with
+              # the VPN gateway.
+          "interconnectAttachment": "A String", # URL of the VLAN attachment (interconnectAttachment) resource for this
+              # VPN gateway interface. When the value of this field is present, the VPN
+              # gateway is used for HA VPN over Cloud Interconnect; all egress
+              # or ingress traffic for this VPN gateway interface goes through the
+              # specified VLAN attachment resource.
+          "ipAddress": "A String", # Output only. [Output Only] IP address for this VPN interface associated with the VPN
+              # gateway.
+              # The IP address could be either a regional external IP address or
+              # a regional internal IP address. The two IP addresses for a VPN gateway
+              # must be all regional external or regional internal IP addresses. There
+              # cannot be a mix of regional external IP addresses and regional internal
+              # IP addresses. For HA VPN over Cloud Interconnect, the IP addresses
+              # for both interfaces could either be regional internal IP addresses or
+              # regional external IP addresses. For regular (non HA VPN over Cloud
+              # Interconnect) HA VPN tunnels, the IP address must be a regional external
+              # IP address.
+          "ipv6Address": "A String", # Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN
+              # gateway.
+              # The IPv6 address must be a regional external IPv6 address. The format is
+              # RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).
+        },
+      ],
+    },
+  ],
+  "kind": "compute#vpnGatewayList", # Output only. [Output Only] Type of resource. Always compute#vpnGateway for
+      # VPN gateways.
+  "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.
+  "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.
+
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a VpnGateway. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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_preview.vpnTunnels.html b/docs/dyn/compute_preview.vpnTunnels.html new file mode 100644 index 0000000000..be58a90909 --- /dev/null +++ b/docs/dyn/compute_preview.vpnTunnels.html @@ -0,0 +1,2053 @@ + + + +

Compute Engine API . vpnTunnels

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves an aggregated list of VPN tunnels.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, vpnTunnel, requestId=None, x__xgafv=None)

+

Deletes the specified VpnTunnel resource.

+

+ get(project, region, vpnTunnel, x__xgafv=None)

+

Returns the specified VpnTunnel resource.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates a VpnTunnel resource in the specified project and region using

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of VpnTunnel resources contained in the specified

+

+ list_next()

+

Retrieves the next page of results.

+

+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

+

Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves an aggregated list of VPN tunnels.
+
+To prevent failure, Google recommends that you set the
+`returnPartialSuccess` parameter to `true`.
+
+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.
+  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.
+  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:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of VpnTunnelsScopedList resources.
+    "a_key": { # Name of the scope containing this set of VPN tunnels.
+      "vpnTunnels": [ # A list of VPN tunnels contained in this scope.
+        { # Represents a Cloud VPN Tunnel resource.
+            #
+            # For more information about VPN, read the
+            # the Cloud VPN Overview.
+          "cipherSuite": { # User specified list of ciphers to use for the phase 1 and phase 2 of the
+              # IKE protocol.
+            "phase1": {
+              "dh": [
+                "A String",
+              ],
+              "encryption": [
+                "A String",
+              ],
+              "integrity": [
+                "A String",
+              ],
+              "prf": [
+                "A String",
+              ],
+            },
+            "phase2": {
+              "encryption": [
+                "A String",
+              ],
+              "integrity": [
+                "A String",
+              ],
+              "pfs": [
+                "A String",
+              ],
+            },
+          },
+          "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.
+          "detailedStatus": "A String", # [Output Only] Detailed status message for the VPN tunnel.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "ikeVersion": 42, # IKE protocol version to use when establishing the VPN tunnel with the peer
+              # VPN gateway. Acceptable IKE versions are 1 or 2.
+              # The default version is 2.
+          "kind": "compute#vpnTunnel", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+              # VPN tunnels.
+          "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnTunnel, which is
+              # essentially a hash of the labels set used for optimistic locking. The
+              # fingerprint is initially generated by Compute Engine and changes after
+              # every request to modify or update labels. You must always provide an
+              # up-to-date fingerprint hash in order to update or change labels,
+              # otherwise the request will fail with error412 conditionNotMet.
+              #
+              # To see the latest fingerprint, make a get() request to
+              # retrieve a VpnTunnel.
+          "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+              # Label values may be empty.
+            "a_key": "A String",
+          },
+          "localTrafficSelector": [ # Local traffic selector to use when establishing the VPN tunnel with the
+              # peer VPN gateway. The value should be a CIDR formatted string, for
+              # example: 192.168.0.0/16. The ranges must be disjoint.
+              # Only IPv4 is supported for Classic VPN tunnels. This field is output only
+              # for HA VPN tunnels.
+            "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.
+          "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.
+              # This field is exclusive with the field peerGcpGateway.
+          "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is
+              # connected. Provided by the client when the VPN tunnel is created.
+              # Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use
+              # depends on the external VPN gateway redundancy type.
+          "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel
+              # is connected. Provided by the client when the VPN tunnel is created.
+              # This field can be used when creating highly available VPN from VPC network
+              # to VPC network, the field is exclusive with the field peerExternalGateway.
+              # If provided, the VPN tunnel will automatically use the same
+              # vpnGatewayInterface ID in the peer Google Cloud VPN gateway.
+          "peerIp": "A String", # IP address of the peer VPN gateway. Only IPv4 is supported. This field can
+              # be set only for Classic VPN tunnels.
+          "region": "A String", # [Output Only] URL of the region where the VPN tunnel resides.
+              # You must specify this field as part of the HTTP request URL. It is
+              # not settable as a field in the request body.
+          "remoteTrafficSelector": [ # Remote traffic selectors to use when establishing the VPN tunnel with
+              # the peer VPN gateway. The value should be a CIDR formatted string,
+              # for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is
+              # supported for Classic VPN tunnels. This field is output only for HA VPN
+              # tunnels.
+            "A String",
+          ],
+          "router": "A String", # URL of the router resource to be used for dynamic routing.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "sharedSecret": "A String", # Shared secret used to set the secure session between the Cloud VPN gateway
+              # and the peer VPN gateway.
+          "sharedSecretHash": "A String", # Hash of the shared secret.
+          "status": "A String", # [Output Only] The status of the VPN tunnel, which can be one of the
+              # following:
+              #
+              #    - PROVISIONING: Resource is being allocated for the VPN tunnel.
+              #    - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs
+              #    from
+              #      the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route
+              #      resources are needed to setup the VPN tunnel.
+              #    - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.
+              #    - ESTABLISHED: Secure session is successfully established with the peer
+              #    VPN.
+              #    - NETWORK_ERROR: Deprecated, replaced by
+              #    NO_INCOMING_PACKETS
+              #    - AUTHORIZATION_ERROR: Auth error (for example,
+              #    bad shared secret).
+              #    - NEGOTIATION_FAILURE: Handshake failed.
+              #    - DEPROVISIONING: Resources are being deallocated for the VPN
+              #    tunnel.
+              #    - FAILED: Tunnel creation has failed and the tunnel is not
+              #    ready to be used.
+              #    - NO_INCOMING_PACKETS: No incoming packets from
+              #    peer.
+              #    - REJECTED: Tunnel configuration was rejected, can be result
+              #    of being denied access.
+              #    - ALLOCATING_RESOURCES: Cloud VPN is in the
+              #    process of allocating all required resources.
+              #    - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted
+              #    for Classic VPN tunnels or the project is in frozen state.
+              #    - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,
+              #    probably behind NAT.
+              #    - TS_NARROWING_NOT_ALLOWED: Traffic selector
+              #    narrowing not allowed for an HA-VPN tunnel.
+          "targetVpnGateway": "A String", # URL of the Target VPN gateway with which this VPN tunnel is associated.
+              # Provided by the client when the VPN tunnel is created.
+              # This field can be set only for Classic VPN tunnels.
+          "vpnGateway": "A String", # URL of the VPN gateway with which this VPN tunnel is associated.
+              # Provided by the client when the VPN tunnel is created. This must be
+              # used (instead of target_vpn_gateway) if a High Availability VPN gateway
+              # resource is created.
+          "vpnGatewayInterface": 42, # The interface ID of the VPN gateway with which this VPN tunnel is
+              # associated.
+              # Possible values are: `0`, `1`.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of addresses 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#vpnTunnelAggregatedList", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+      # VPN tunnels.
+  "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, vpnTunnel, requestId=None, x__xgafv=None) + 
Deletes the specified VpnTunnel resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  vpnTunnel: string, Name of the VpnTunnel 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, vpnTunnel, x__xgafv=None) + 
Returns the specified VpnTunnel resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  vpnTunnel: string, Name of the VpnTunnel 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 VPN Tunnel resource.
+    #
+    # For more information about VPN, read the
+    # the Cloud VPN Overview.
+  "cipherSuite": { # User specified list of ciphers to use for the phase 1 and phase 2 of the
+      # IKE protocol.
+    "phase1": {
+      "dh": [
+        "A String",
+      ],
+      "encryption": [
+        "A String",
+      ],
+      "integrity": [
+        "A String",
+      ],
+      "prf": [
+        "A String",
+      ],
+    },
+    "phase2": {
+      "encryption": [
+        "A String",
+      ],
+      "integrity": [
+        "A String",
+      ],
+      "pfs": [
+        "A String",
+      ],
+    },
+  },
+  "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.
+  "detailedStatus": "A String", # [Output Only] Detailed status message for the VPN tunnel.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ikeVersion": 42, # IKE protocol version to use when establishing the VPN tunnel with the peer
+      # VPN gateway. Acceptable IKE versions are 1 or 2.
+      # The default version is 2.
+  "kind": "compute#vpnTunnel", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+      # VPN tunnels.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnTunnel, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      #
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a VpnTunnel.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "localTrafficSelector": [ # Local traffic selector to use when establishing the VPN tunnel with the
+      # peer VPN gateway. The value should be a CIDR formatted string, for
+      # example: 192.168.0.0/16. The ranges must be disjoint.
+      # Only IPv4 is supported for Classic VPN tunnels. This field is output only
+      # for HA VPN tunnels.
+    "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.
+  "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.
+      # This field is exclusive with the field peerGcpGateway.
+  "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is
+      # connected. Provided by the client when the VPN tunnel is created.
+      # Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use
+      # depends on the external VPN gateway redundancy type.
+  "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel
+      # is connected. Provided by the client when the VPN tunnel is created.
+      # This field can be used when creating highly available VPN from VPC network
+      # to VPC network, the field is exclusive with the field peerExternalGateway.
+      # If provided, the VPN tunnel will automatically use the same
+      # vpnGatewayInterface ID in the peer Google Cloud VPN gateway.
+  "peerIp": "A String", # IP address of the peer VPN gateway. Only IPv4 is supported. This field can
+      # be set only for Classic VPN tunnels.
+  "region": "A String", # [Output Only] URL of the region where the VPN tunnel resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "remoteTrafficSelector": [ # Remote traffic selectors to use when establishing the VPN tunnel with
+      # the peer VPN gateway. The value should be a CIDR formatted string,
+      # for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is
+      # supported for Classic VPN tunnels. This field is output only for HA VPN
+      # tunnels.
+    "A String",
+  ],
+  "router": "A String", # URL of the router resource to be used for dynamic routing.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sharedSecret": "A String", # Shared secret used to set the secure session between the Cloud VPN gateway
+      # and the peer VPN gateway.
+  "sharedSecretHash": "A String", # Hash of the shared secret.
+  "status": "A String", # [Output Only] The status of the VPN tunnel, which can be one of the
+      # following:
+      #
+      #    - PROVISIONING: Resource is being allocated for the VPN tunnel.
+      #    - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs
+      #    from
+      #      the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route
+      #      resources are needed to setup the VPN tunnel.
+      #    - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.
+      #    - ESTABLISHED: Secure session is successfully established with the peer
+      #    VPN.
+      #    - NETWORK_ERROR: Deprecated, replaced by
+      #    NO_INCOMING_PACKETS
+      #    - AUTHORIZATION_ERROR: Auth error (for example,
+      #    bad shared secret).
+      #    - NEGOTIATION_FAILURE: Handshake failed.
+      #    - DEPROVISIONING: Resources are being deallocated for the VPN
+      #    tunnel.
+      #    - FAILED: Tunnel creation has failed and the tunnel is not
+      #    ready to be used.
+      #    - NO_INCOMING_PACKETS: No incoming packets from
+      #    peer.
+      #    - REJECTED: Tunnel configuration was rejected, can be result
+      #    of being denied access.
+      #    - ALLOCATING_RESOURCES: Cloud VPN is in the
+      #    process of allocating all required resources.
+      #    - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted
+      #    for Classic VPN tunnels or the project is in frozen state.
+      #    - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,
+      #    probably behind NAT.
+      #    - TS_NARROWING_NOT_ALLOWED: Traffic selector
+      #    narrowing not allowed for an HA-VPN tunnel.
+  "targetVpnGateway": "A String", # URL of the Target VPN gateway with which this VPN tunnel is associated.
+      # Provided by the client when the VPN tunnel is created.
+      # This field can be set only for Classic VPN tunnels.
+  "vpnGateway": "A String", # URL of the VPN gateway with which this VPN tunnel is associated.
+      # Provided by the client when the VPN tunnel is created. This must be
+      # used (instead of target_vpn_gateway) if a High Availability VPN gateway
+      # resource is created.
+  "vpnGatewayInterface": 42, # The interface ID of the VPN gateway with which this VPN tunnel is
+      # associated.
+      # Possible values are: `0`, `1`.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates a VpnTunnel resource in the specified project and region using
+the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud VPN Tunnel resource.
+    # 
+    # For more information about VPN, read the
+    # the Cloud VPN Overview.
+  "cipherSuite": { # User specified list of ciphers to use for the phase 1 and phase 2 of the
+      # IKE protocol.
+    "phase1": {
+      "dh": [
+        "A String",
+      ],
+      "encryption": [
+        "A String",
+      ],
+      "integrity": [
+        "A String",
+      ],
+      "prf": [
+        "A String",
+      ],
+    },
+    "phase2": {
+      "encryption": [
+        "A String",
+      ],
+      "integrity": [
+        "A String",
+      ],
+      "pfs": [
+        "A String",
+      ],
+    },
+  },
+  "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.
+  "detailedStatus": "A String", # [Output Only] Detailed status message for the VPN tunnel.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "ikeVersion": 42, # IKE protocol version to use when establishing the VPN tunnel with the peer
+      # VPN gateway. Acceptable IKE versions are 1 or 2.
+      # The default version is 2.
+  "kind": "compute#vpnTunnel", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+      # VPN tunnels.
+  "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnTunnel, which is
+      # essentially a hash of the labels set used for optimistic locking. The
+      # fingerprint is initially generated by Compute Engine and changes after
+      # every request to modify or update labels. You must always provide an
+      # up-to-date fingerprint hash in order to update or change labels,
+      # otherwise the request will fail with error412 conditionNotMet.
+      # 
+      # To see the latest fingerprint, make a get() request to
+      # retrieve a VpnTunnel.
+  "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+      # Label values may be empty.
+    "a_key": "A String",
+  },
+  "localTrafficSelector": [ # Local traffic selector to use when establishing the VPN tunnel with the
+      # peer VPN gateway. The value should be a CIDR formatted string, for
+      # example: 192.168.0.0/16. The ranges must be disjoint.
+      # Only IPv4 is supported for Classic VPN tunnels. This field is output only
+      # for HA VPN tunnels.
+    "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.
+  "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.
+      # This field is exclusive with the field peerGcpGateway.
+  "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is
+      # connected. Provided by the client when the VPN tunnel is created.
+      # Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use
+      # depends on the external VPN gateway redundancy type.
+  "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel
+      # is connected. Provided by the client when the VPN tunnel is created.
+      # This field can be used when creating highly available VPN from VPC network
+      # to VPC network, the field is exclusive with the field peerExternalGateway.
+      # If provided, the VPN tunnel will automatically use the same
+      # vpnGatewayInterface ID in the peer Google Cloud VPN gateway.
+  "peerIp": "A String", # IP address of the peer VPN gateway. Only IPv4 is supported. This field can
+      # be set only for Classic VPN tunnels.
+  "region": "A String", # [Output Only] URL of the region where the VPN tunnel resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "remoteTrafficSelector": [ # Remote traffic selectors to use when establishing the VPN tunnel with
+      # the peer VPN gateway. The value should be a CIDR formatted string,
+      # for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is
+      # supported for Classic VPN tunnels. This field is output only for HA VPN
+      # tunnels.
+    "A String",
+  ],
+  "router": "A String", # URL of the router resource to be used for dynamic routing.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "sharedSecret": "A String", # Shared secret used to set the secure session between the Cloud VPN gateway
+      # and the peer VPN gateway.
+  "sharedSecretHash": "A String", # Hash of the shared secret.
+  "status": "A String", # [Output Only] The status of the VPN tunnel, which can be one of the
+      # following:
+      # 
+      #    - PROVISIONING: Resource is being allocated for the VPN tunnel.
+      #    - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs
+      #    from
+      #      the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route
+      #      resources are needed to setup the VPN tunnel.
+      #    - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.
+      #    - ESTABLISHED: Secure session is successfully established with the peer
+      #    VPN.
+      #    - NETWORK_ERROR: Deprecated, replaced by
+      #    NO_INCOMING_PACKETS
+      #    - AUTHORIZATION_ERROR: Auth error (for example,
+      #    bad shared secret).
+      #    - NEGOTIATION_FAILURE: Handshake failed.
+      #    - DEPROVISIONING: Resources are being deallocated for the VPN
+      #    tunnel.
+      #    - FAILED: Tunnel creation has failed and the tunnel is not
+      #    ready to be used.
+      #    - NO_INCOMING_PACKETS: No incoming packets from
+      #    peer.
+      #    - REJECTED: Tunnel configuration was rejected, can be result
+      #    of being denied access.
+      #    - ALLOCATING_RESOURCES: Cloud VPN is in the
+      #    process of allocating all required resources.
+      #    - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted
+      #    for Classic VPN tunnels or the project is in frozen state.
+      #    - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,
+      #    probably behind NAT.
+      #    - TS_NARROWING_NOT_ALLOWED: Traffic selector
+      #    narrowing not allowed for an HA-VPN tunnel.
+  "targetVpnGateway": "A String", # URL of the Target VPN gateway with which this VPN tunnel is associated.
+      # Provided by the client when the VPN tunnel is created.
+      # This field can be set only for Classic VPN tunnels.
+  "vpnGateway": "A String", # URL of the VPN gateway with which this VPN tunnel is associated.
+      # Provided by the client when the VPN tunnel is created. This must be
+      # used (instead of target_vpn_gateway) if a High Availability VPN gateway
+      # resource is created.
+  "vpnGatewayInterface": 42, # The interface ID of the VPN gateway with which this VPN tunnel is
+      # associated.
+      # Possible values are: `0`, `1`.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, x__xgafv=None) + 
Retrieves a list of VpnTunnel resources contained in the specified
+project and region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region 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.
+  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 VpnTunnel resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of VpnTunnel resources.
+    { # Represents a Cloud VPN Tunnel resource.
+        #
+        # For more information about VPN, read the
+        # the Cloud VPN Overview.
+      "cipherSuite": { # User specified list of ciphers to use for the phase 1 and phase 2 of the
+          # IKE protocol.
+        "phase1": {
+          "dh": [
+            "A String",
+          ],
+          "encryption": [
+            "A String",
+          ],
+          "integrity": [
+            "A String",
+          ],
+          "prf": [
+            "A String",
+          ],
+        },
+        "phase2": {
+          "encryption": [
+            "A String",
+          ],
+          "integrity": [
+            "A String",
+          ],
+          "pfs": [
+            "A String",
+          ],
+        },
+      },
+      "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.
+      "detailedStatus": "A String", # [Output Only] Detailed status message for the VPN tunnel.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "ikeVersion": 42, # IKE protocol version to use when establishing the VPN tunnel with the peer
+          # VPN gateway. Acceptable IKE versions are 1 or 2.
+          # The default version is 2.
+      "kind": "compute#vpnTunnel", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+          # VPN tunnels.
+      "labelFingerprint": "A String", # A fingerprint for the labels being applied to this VpnTunnel, which is
+          # essentially a hash of the labels set used for optimistic locking. The
+          # fingerprint is initially generated by Compute Engine and changes after
+          # every request to modify or update labels. You must always provide an
+          # up-to-date fingerprint hash in order to update or change labels,
+          # otherwise the request will fail with error412 conditionNotMet.
+          #
+          # To see the latest fingerprint, make a get() request to
+          # retrieve a VpnTunnel.
+      "labels": { # Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.
+          # Label values may be empty.
+        "a_key": "A String",
+      },
+      "localTrafficSelector": [ # Local traffic selector to use when establishing the VPN tunnel with the
+          # peer VPN gateway. The value should be a CIDR formatted string, for
+          # example: 192.168.0.0/16. The ranges must be disjoint.
+          # Only IPv4 is supported for Classic VPN tunnels. This field is output only
+          # for HA VPN tunnels.
+        "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.
+      "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.
+          # This field is exclusive with the field peerGcpGateway.
+      "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is
+          # connected. Provided by the client when the VPN tunnel is created.
+          # Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use
+          # depends on the external VPN gateway redundancy type.
+      "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel
+          # is connected. Provided by the client when the VPN tunnel is created.
+          # This field can be used when creating highly available VPN from VPC network
+          # to VPC network, the field is exclusive with the field peerExternalGateway.
+          # If provided, the VPN tunnel will automatically use the same
+          # vpnGatewayInterface ID in the peer Google Cloud VPN gateway.
+      "peerIp": "A String", # IP address of the peer VPN gateway. Only IPv4 is supported. This field can
+          # be set only for Classic VPN tunnels.
+      "region": "A String", # [Output Only] URL of the region where the VPN tunnel resides.
+          # You must specify this field as part of the HTTP request URL. It is
+          # not settable as a field in the request body.
+      "remoteTrafficSelector": [ # Remote traffic selectors to use when establishing the VPN tunnel with
+          # the peer VPN gateway. The value should be a CIDR formatted string,
+          # for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is
+          # supported for Classic VPN tunnels. This field is output only for HA VPN
+          # tunnels.
+        "A String",
+      ],
+      "router": "A String", # URL of the router resource to be used for dynamic routing.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "sharedSecret": "A String", # Shared secret used to set the secure session between the Cloud VPN gateway
+          # and the peer VPN gateway.
+      "sharedSecretHash": "A String", # Hash of the shared secret.
+      "status": "A String", # [Output Only] The status of the VPN tunnel, which can be one of the
+          # following:
+          #
+          #    - PROVISIONING: Resource is being allocated for the VPN tunnel.
+          #    - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs
+          #    from
+          #      the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route
+          #      resources are needed to setup the VPN tunnel.
+          #    - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.
+          #    - ESTABLISHED: Secure session is successfully established with the peer
+          #    VPN.
+          #    - NETWORK_ERROR: Deprecated, replaced by
+          #    NO_INCOMING_PACKETS
+          #    - AUTHORIZATION_ERROR: Auth error (for example,
+          #    bad shared secret).
+          #    - NEGOTIATION_FAILURE: Handshake failed.
+          #    - DEPROVISIONING: Resources are being deallocated for the VPN
+          #    tunnel.
+          #    - FAILED: Tunnel creation has failed and the tunnel is not
+          #    ready to be used.
+          #    - NO_INCOMING_PACKETS: No incoming packets from
+          #    peer.
+          #    - REJECTED: Tunnel configuration was rejected, can be result
+          #    of being denied access.
+          #    - ALLOCATING_RESOURCES: Cloud VPN is in the
+          #    process of allocating all required resources.
+          #    - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted
+          #    for Classic VPN tunnels or the project is in frozen state.
+          #    - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,
+          #    probably behind NAT.
+          #    - TS_NARROWING_NOT_ALLOWED: Traffic selector
+          #    narrowing not allowed for an HA-VPN tunnel.
+      "targetVpnGateway": "A String", # URL of the Target VPN gateway with which this VPN tunnel is associated.
+          # Provided by the client when the VPN tunnel is created.
+          # This field can be set only for Classic VPN tunnels.
+      "vpnGateway": "A String", # URL of the VPN gateway with which this VPN tunnel is associated.
+          # Provided by the client when the VPN tunnel is created. This must be
+          # used (instead of target_vpn_gateway) if a High Availability VPN gateway
+          # resource is created.
+      "vpnGatewayInterface": 42, # The interface ID of the VPN gateway with which this VPN tunnel is
+          # associated.
+          # Possible values are: `0`, `1`.
+    },
+  ],
+  "kind": "compute#vpnTunnelList", # Output only. [Output Only] Type of resource. Always compute#vpnTunnel for
+      # VPN tunnels.
+  "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.
+  "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.
+
+
+ +
+ setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None) + 
Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling
+Resources documentation.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, 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:
+
+{
+  "labelFingerprint": "A String", # The fingerprint of the previous set of labels for this resource,
+      # used to detect conflicts. The fingerprint is initially generated by Compute
+      # Engine and changes after every request to modify or update labels. You must
+      # always provide an up-to-date fingerprint hash in order to update or change
+      # labels. Make a get() request to the resource to get the latest
+      # fingerprint.
+  "labels": { # The labels to set for this resource.
+    "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. 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.wireGroups.html b/docs/dyn/compute_preview.wireGroups.html new file mode 100644 index 0000000000..c567f87dfd --- /dev/null +++ b/docs/dyn/compute_preview.wireGroups.html @@ -0,0 +1,1765 @@ + + + +

Compute Engine API . wireGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, crossSiteNetwork, wireGroup, requestId=None, x__xgafv=None)

+

Deletes the specified wire group in the given scope.

+

+ get(project, crossSiteNetwork, wireGroup, x__xgafv=None)

+

Gets the specified wire group resource in the given scope.

+

+ insert(project, crossSiteNetwork, body=None, requestId=None, validateOnly=None, x__xgafv=None)

+

Creates a wire group in the specified project in the given scope

+

+ list(project, crossSiteNetwork, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists the wire groups for a project in the given scope.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, crossSiteNetwork, wireGroup, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

+

Updates the specified wire group resource with the data included in the

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, crossSiteNetwork, wireGroup, requestId=None, x__xgafv=None) + 
Deletes the specified wire group in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, A parameter (required)
+  wireGroup: string, Name of the wire group 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).
+end_interface: MixerMutationRequestBuilder
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, crossSiteNetwork, wireGroup, x__xgafv=None) + 
Gets the specified wire group resource in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, A parameter (required)
+  wireGroup: string, Name of the wire group 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:
+
+    { # A resource that represents a group of redundant wires.
+  "adminEnabled": True or False, # Indicates whether the wires in the wire group are enabled. When false, the
+      # wires in the wire group are disabled. When true and when
+      # there is simultaneously no wire-specific override of `adminEnabled` to
+      # false, a given wire is enabled. Defaults to true.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the wire group.
+  "endpoints": { # A map that contains the logical endpoints of the wire group. Specify
+      # key-value pairs for the map as follows:
+      #
+      #    - Key: an RFC1035 user-specified label.
+      #    - Value: an Endpoint object.
+    "a_key": { # A logical endpoint for the wire group. An endpoint represents a metro that
+        # contains redundant Interconnect connections. A wire group is created
+        # between two endpoints.
+      "interconnects": { # A map that contains the redundant Interconnect connections. Specify
+          # key-value pairs for the map as follows:
+          #
+          #    - Key: an RFC1035 user-specified label.
+          #    - Value: an Interconnect object.
+        "a_key": { # The redundant Interconnect connections for this endpoint.
+          "interconnect": "A String", # Required. An Interconnect connection. You can specify the connection as
+              # a partial or full URL. If the connection is in a different project from
+              # the cross-site network, use a format that specifies the project. See
+              # the following examples of partial and full URLs:
+              #
+              #
+              #
+              #       global/interconnects/NAME
+              #
+              #
+              #        projects/PROJECT_ID/global/interconnects/NAME
+              #
+              #     -
+              #       https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME
+          "vlanTags": [ # Required. To configure the wire group for VLAN mode, enter a VLAN tag,
+              # which is a number from `2` to `4093`. You can autoallocate a tag by
+              # entering `0`. To configure the wire group for port mode, enter `-1`.
+              # Review the following guidelines:
+              #
+              #    - A VLAN tag must be unique for an Interconnect connection across all
+              #    attachments and wire groups.
+              #    - Both endpoints of a wire must use the same VLAN tag value.
+              #    - Single wire and redundant type wire groups must have only one
+              #    VLAN tag.
+              #    - Port mode pseudowires must have a single VLAN tag with a value of
+              #    `-1` for both endpoints.
+              #    - Box and cross type wire groups must have two VLAN tags. The first
+              #    is for the same-zone pseudowire, and the second is for the cross-zone
+              #    pseudowire.
+            42,
+          ],
+        },
+      },
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#wireGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.
+  "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.
+  "reconciling": True or False, # Output only. [Output Only] Indicates whether there are wire changes yet to be processed.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "topology": { # Topology details for the wire group. # Output only. Topology details for the wire group configuration.
+    "endpoints": [ # Output only. Topology details for all endpoints in the wire group.
+      { # Topology details for a single wire group endpoint.
+        "city": "A String", # Output only. The InterconnectLocation.city (metropolitan area designator) that all
+            # interconnects are located in.
+        "label": "A String", # Output only. Endpoint label from the wire group.
+      },
+    ],
+  },
+  "wireProperties": { # The properties of a wire. # Properties for all wires in the wire group.
+    "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+        #
+        #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+        #    (and associated charges) for each wire in the group.
+        #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+        #    one unmetered bandwidth allocation for the wire group. The unmetered
+        #    bandwidth is divided equally across each wire in the group, but dynamic
+        #    throttling reallocates unused unmetered bandwidth from unused or underused
+        #    wires to other wires in the group.
+    "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+        # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+    "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+        #
+        #    - NONE: default.
+        #    - DISABLE_PORT: set the port line protocol down when inline probes
+        #    detect a fault. This setting is only permitted on port mode
+        #    pseudowires.
+  },
+  "wires": [ # Output only. The single/redundant wire(s) managed by the wire group.
+    { # A pseudowire that connects two Interconnect connections.
+      "adminEnabled": True or False, # Output only. [Output Only] Indicates whether the wire is enabled.
+          # When false, the wire is disabled. When true and when the wire group of
+          # the wire is also enabled, the wire is enabled. Defaults to true.
+      "endpoints": [ # Output only. Wire endpoints are specific Interconnect connections.
+        { # Wire endpoints are specific Interconnect connections.
+          "interconnect": "A String",
+          "vlanTag": 42,
+        },
+      ],
+      "label": "A String", # Output only. [Output Only] A label that identifies the wire. The format of this label
+          # combines the existing labels of the wire group endpoints and Interconnect
+          # connections used by this wire in alphabetical order as follows:
+          # `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:
+          #
+          #    - ENDPOINT_A and ENDPOINT_B: are the labels
+          #    that you entered as map keys when you specified the wire group endpoint
+          #    objects.
+          #    - CONNECTION_A1 and CONNECTION_B1: are the
+          #    labels that you entered as map keys when you specified the wire group
+          #    Interconnect objects.
+      "wireProperties": { # The properties of a wire. # Output only. [Output Only] Properties of the wire.
+        "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+            #
+            #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+            #    (and associated charges) for each wire in the group.
+            #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+            #    one unmetered bandwidth allocation for the wire group. The unmetered
+            #    bandwidth is divided equally across each wire in the group, but dynamic
+            #    throttling reallocates unused unmetered bandwidth from unused or underused
+            #    wires to other wires in the group.
+        "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+            # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+        "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+            #
+            #    - NONE: default.
+            #    - DISABLE_PORT: set the port line protocol down when inline probes
+            #    detect a fault. This setting is only permitted on port mode
+            #    pseudowires.
+      },
+    },
+  ],
+}
+
+ +
+ insert(project, crossSiteNetwork, body=None, requestId=None, validateOnly=None, x__xgafv=None) + 
Creates a wire group in the specified project in the given scope
+using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, A parameter (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A resource that represents a group of redundant wires.
+  "adminEnabled": True or False, # Indicates whether the wires in the wire group are enabled. When false, the
+      # wires in the wire group are disabled. When true and when
+      # there is simultaneously no wire-specific override of `adminEnabled` to
+      # false, a given wire is enabled. Defaults to true.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the wire group.
+  "endpoints": { # A map that contains the logical endpoints of the wire group. Specify
+      # key-value pairs for the map as follows:
+      # 
+      #    - Key: an RFC1035 user-specified label.
+      #    - Value: an Endpoint object.
+    "a_key": { # A logical endpoint for the wire group. An endpoint represents a metro that
+        # contains redundant Interconnect connections. A wire group is created
+        # between two endpoints.
+      "interconnects": { # A map that contains the redundant Interconnect connections. Specify
+          # key-value pairs for the map as follows:
+          #
+          #    - Key: an RFC1035 user-specified label.
+          #    - Value: an Interconnect object.
+        "a_key": { # The redundant Interconnect connections for this endpoint.
+          "interconnect": "A String", # Required. An Interconnect connection. You can specify the connection as
+              # a partial or full URL. If the connection is in a different project from
+              # the cross-site network, use a format that specifies the project. See
+              # the following examples of partial and full URLs:
+              #
+              #
+              #
+              #       global/interconnects/NAME
+              #
+              #
+              #        projects/PROJECT_ID/global/interconnects/NAME
+              #
+              #     -
+              #       https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME
+          "vlanTags": [ # Required. To configure the wire group for VLAN mode, enter a VLAN tag,
+              # which is a number from `2` to `4093`. You can autoallocate a tag by
+              # entering `0`. To configure the wire group for port mode, enter `-1`.
+              # Review the following guidelines:
+              #
+              #    - A VLAN tag must be unique for an Interconnect connection across all
+              #    attachments and wire groups.
+              #    - Both endpoints of a wire must use the same VLAN tag value.
+              #    - Single wire and redundant type wire groups must have only one
+              #    VLAN tag.
+              #    - Port mode pseudowires must have a single VLAN tag with a value of
+              #    `-1` for both endpoints.
+              #    - Box and cross type wire groups must have two VLAN tags. The first
+              #    is for the same-zone pseudowire, and the second is for the cross-zone
+              #    pseudowire.
+            42,
+          ],
+        },
+      },
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#wireGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.
+  "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.
+  "reconciling": True or False, # Output only. [Output Only] Indicates whether there are wire changes yet to be processed.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "topology": { # Topology details for the wire group. # Output only. Topology details for the wire group configuration.
+    "endpoints": [ # Output only. Topology details for all endpoints in the wire group.
+      { # Topology details for a single wire group endpoint.
+        "city": "A String", # Output only. The InterconnectLocation.city (metropolitan area designator) that all
+            # interconnects are located in.
+        "label": "A String", # Output only. Endpoint label from the wire group.
+      },
+    ],
+  },
+  "wireProperties": { # The properties of a wire. # Properties for all wires in the wire group.
+    "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+        #
+        #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+        #    (and associated charges) for each wire in the group.
+        #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+        #    one unmetered bandwidth allocation for the wire group. The unmetered
+        #    bandwidth is divided equally across each wire in the group, but dynamic
+        #    throttling reallocates unused unmetered bandwidth from unused or underused
+        #    wires to other wires in the group.
+    "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+        # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+    "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+        #
+        #    - NONE: default.
+        #    - DISABLE_PORT: set the port line protocol down when inline probes
+        #    detect a fault. This setting is only permitted on port mode
+        #    pseudowires.
+  },
+  "wires": [ # Output only. The single/redundant wire(s) managed by the wire group.
+    { # A pseudowire that connects two Interconnect connections.
+      "adminEnabled": True or False, # Output only. [Output Only] Indicates whether the wire is enabled.
+          # When false, the wire is disabled. When true and when the wire group of
+          # the wire is also enabled, the wire is enabled. Defaults to true.
+      "endpoints": [ # Output only. Wire endpoints are specific Interconnect connections.
+        { # Wire endpoints are specific Interconnect connections.
+          "interconnect": "A String",
+          "vlanTag": 42,
+        },
+      ],
+      "label": "A String", # Output only. [Output Only] A label that identifies the wire. The format of this label
+          # combines the existing labels of the wire group endpoints and Interconnect
+          # connections used by this wire in alphabetical order as follows:
+          # `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:
+          #
+          #    - ENDPOINT_A and ENDPOINT_B: are the labels
+          #    that you entered as map keys when you specified the wire group endpoint
+          #    objects.
+          #    - CONNECTION_A1 and CONNECTION_B1: are the
+          #    labels that you entered as map keys when you specified the wire group
+          #    Interconnect objects.
+      "wireProperties": { # The properties of a wire. # Output only. [Output Only] Properties of the wire.
+        "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+            #
+            #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+            #    (and associated charges) for each wire in the group.
+            #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+            #    one unmetered bandwidth allocation for the wire group. The unmetered
+            #    bandwidth is divided equally across each wire in the group, but dynamic
+            #    throttling reallocates unused unmetered bandwidth from unused or underused
+            #    wires to other wires in the group.
+        "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+            # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+        "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+            #
+            #    - NONE: default.
+            #    - DISABLE_PORT: set the port line protocol down when inline probes
+            #    detect a fault. This setting is only permitted on port mode
+            #    pseudowires.
+      },
+    },
+  ],
+}
+
+  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).
+end_interface: MixerMutationRequestBuilder
+  validateOnly: boolean, [Input Only] Validate the new configuration, but don't create it.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, crossSiteNetwork, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists the wire groups for a project in the given scope.
+
+Args:
+  project: string, Project ID for this request. (required)
+  crossSiteNetwork: string, A parameter (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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for the list request.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of wire group resources.
+    { # A resource that represents a group of redundant wires.
+      "adminEnabled": True or False, # Indicates whether the wires in the wire group are enabled. When false, the
+          # wires in the wire group are disabled. When true and when
+          # there is simultaneously no wire-specific override of `adminEnabled` to
+          # false, a given wire is enabled. Defaults to true.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of the wire group.
+      "endpoints": { # A map that contains the logical endpoints of the wire group. Specify
+          # key-value pairs for the map as follows:
+          #
+          #    - Key: an RFC1035 user-specified label.
+          #    - Value: an Endpoint object.
+        "a_key": { # A logical endpoint for the wire group. An endpoint represents a metro that
+            # contains redundant Interconnect connections. A wire group is created
+            # between two endpoints.
+          "interconnects": { # A map that contains the redundant Interconnect connections. Specify
+              # key-value pairs for the map as follows:
+              #
+              #    - Key: an RFC1035 user-specified label.
+              #    - Value: an Interconnect object.
+            "a_key": { # The redundant Interconnect connections for this endpoint.
+              "interconnect": "A String", # Required. An Interconnect connection. You can specify the connection as
+                  # a partial or full URL. If the connection is in a different project from
+                  # the cross-site network, use a format that specifies the project. See
+                  # the following examples of partial and full URLs:
+                  #
+                  #
+                  #
+                  #       global/interconnects/NAME
+                  #
+                  #
+                  #        projects/PROJECT_ID/global/interconnects/NAME
+                  #
+                  #     -
+                  #       https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME
+              "vlanTags": [ # Required. To configure the wire group for VLAN mode, enter a VLAN tag,
+                  # which is a number from `2` to `4093`. You can autoallocate a tag by
+                  # entering `0`. To configure the wire group for port mode, enter `-1`.
+                  # Review the following guidelines:
+                  #
+                  #    - A VLAN tag must be unique for an Interconnect connection across all
+                  #    attachments and wire groups.
+                  #    - Both endpoints of a wire must use the same VLAN tag value.
+                  #    - Single wire and redundant type wire groups must have only one
+                  #    VLAN tag.
+                  #    - Port mode pseudowires must have a single VLAN tag with a value of
+                  #    `-1` for both endpoints.
+                  #    - Box and cross type wire groups must have two VLAN tags. The first
+                  #    is for the same-zone pseudowire, and the second is for the cross-zone
+                  #    pseudowire.
+                42,
+              ],
+            },
+          },
+        },
+      },
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+          # generates this identifier.
+      "kind": "compute#wireGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.
+      "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.
+      "reconciling": True or False, # Output only. [Output Only] Indicates whether there are wire changes yet to be processed.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "topology": { # Topology details for the wire group. # Output only. Topology details for the wire group configuration.
+        "endpoints": [ # Output only. Topology details for all endpoints in the wire group.
+          { # Topology details for a single wire group endpoint.
+            "city": "A String", # Output only. The InterconnectLocation.city (metropolitan area designator) that all
+                # interconnects are located in.
+            "label": "A String", # Output only. Endpoint label from the wire group.
+          },
+        ],
+      },
+      "wireProperties": { # The properties of a wire. # Properties for all wires in the wire group.
+        "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+            #
+            #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+            #    (and associated charges) for each wire in the group.
+            #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+            #    one unmetered bandwidth allocation for the wire group. The unmetered
+            #    bandwidth is divided equally across each wire in the group, but dynamic
+            #    throttling reallocates unused unmetered bandwidth from unused or underused
+            #    wires to other wires in the group.
+        "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+            # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+        "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+            #
+            #    - NONE: default.
+            #    - DISABLE_PORT: set the port line protocol down when inline probes
+            #    detect a fault. This setting is only permitted on port mode
+            #    pseudowires.
+      },
+      "wires": [ # Output only. The single/redundant wire(s) managed by the wire group.
+        { # A pseudowire that connects two Interconnect connections.
+          "adminEnabled": True or False, # Output only. [Output Only] Indicates whether the wire is enabled.
+              # When false, the wire is disabled. When true and when the wire group of
+              # the wire is also enabled, the wire is enabled. Defaults to true.
+          "endpoints": [ # Output only. Wire endpoints are specific Interconnect connections.
+            { # Wire endpoints are specific Interconnect connections.
+              "interconnect": "A String",
+              "vlanTag": 42,
+            },
+          ],
+          "label": "A String", # Output only. [Output Only] A label that identifies the wire. The format of this label
+              # combines the existing labels of the wire group endpoints and Interconnect
+              # connections used by this wire in alphabetical order as follows:
+              # `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:
+              #
+              #    - ENDPOINT_A and ENDPOINT_B: are the labels
+              #    that you entered as map keys when you specified the wire group endpoint
+              #    objects.
+              #    - CONNECTION_A1 and CONNECTION_B1: are the
+              #    labels that you entered as map keys when you specified the wire group
+              #    Interconnect objects.
+          "wireProperties": { # The properties of a wire. # Output only. [Output Only] Properties of the wire.
+            "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+                #
+                #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+                #    (and associated charges) for each wire in the group.
+                #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+                #    one unmetered bandwidth allocation for the wire group. The unmetered
+                #    bandwidth is divided equally across each wire in the group, but dynamic
+                #    throttling reallocates unused unmetered bandwidth from unused or underused
+                #    wires to other wires in the group.
+            "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+                # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+            "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+                #
+                #    - NONE: default.
+                #    - DISABLE_PORT: set the port line protocol down when inline probes
+                #    detect a fault. This setting is only permitted on port mode
+                #    pseudowires.
+          },
+        },
+      ],
+    },
+  ],
+  "kind": "compute#wireGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.
+  "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.
+  "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.
+
+
+ +
+ patch(project, crossSiteNetwork, wireGroup, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None) + 
Updates the specified wire group 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)
+  crossSiteNetwork: string, A parameter (required)
+  wireGroup: string, Name of the WireGroups resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A resource that represents a group of redundant wires.
+  "adminEnabled": True or False, # Indicates whether the wires in the wire group are enabled. When false, the
+      # wires in the wire group are disabled. When true and when
+      # there is simultaneously no wire-specific override of `adminEnabled` to
+      # false, a given wire is enabled. Defaults to true.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of the wire group.
+  "endpoints": { # A map that contains the logical endpoints of the wire group. Specify
+      # key-value pairs for the map as follows:
+      # 
+      #    - Key: an RFC1035 user-specified label.
+      #    - Value: an Endpoint object.
+    "a_key": { # A logical endpoint for the wire group. An endpoint represents a metro that
+        # contains redundant Interconnect connections. A wire group is created
+        # between two endpoints.
+      "interconnects": { # A map that contains the redundant Interconnect connections. Specify
+          # key-value pairs for the map as follows:
+          #
+          #    - Key: an RFC1035 user-specified label.
+          #    - Value: an Interconnect object.
+        "a_key": { # The redundant Interconnect connections for this endpoint.
+          "interconnect": "A String", # Required. An Interconnect connection. You can specify the connection as
+              # a partial or full URL. If the connection is in a different project from
+              # the cross-site network, use a format that specifies the project. See
+              # the following examples of partial and full URLs:
+              #
+              #
+              #
+              #       global/interconnects/NAME
+              #
+              #
+              #        projects/PROJECT_ID/global/interconnects/NAME
+              #
+              #     -
+              #       https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME
+          "vlanTags": [ # Required. To configure the wire group for VLAN mode, enter a VLAN tag,
+              # which is a number from `2` to `4093`. You can autoallocate a tag by
+              # entering `0`. To configure the wire group for port mode, enter `-1`.
+              # Review the following guidelines:
+              #
+              #    - A VLAN tag must be unique for an Interconnect connection across all
+              #    attachments and wire groups.
+              #    - Both endpoints of a wire must use the same VLAN tag value.
+              #    - Single wire and redundant type wire groups must have only one
+              #    VLAN tag.
+              #    - Port mode pseudowires must have a single VLAN tag with a value of
+              #    `-1` for both endpoints.
+              #    - Box and cross type wire groups must have two VLAN tags. The first
+              #    is for the same-zone pseudowire, and the second is for the cross-zone
+              #    pseudowire.
+            42,
+          ],
+        },
+      },
+    },
+  },
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource type. The server
+      # generates this identifier.
+  "kind": "compute#wireGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.
+  "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.
+  "reconciling": True or False, # Output only. [Output Only] Indicates whether there are wire changes yet to be processed.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "topology": { # Topology details for the wire group. # Output only. Topology details for the wire group configuration.
+    "endpoints": [ # Output only. Topology details for all endpoints in the wire group.
+      { # Topology details for a single wire group endpoint.
+        "city": "A String", # Output only. The InterconnectLocation.city (metropolitan area designator) that all
+            # interconnects are located in.
+        "label": "A String", # Output only. Endpoint label from the wire group.
+      },
+    ],
+  },
+  "wireProperties": { # The properties of a wire. # Properties for all wires in the wire group.
+    "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+        #
+        #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+        #    (and associated charges) for each wire in the group.
+        #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+        #    one unmetered bandwidth allocation for the wire group. The unmetered
+        #    bandwidth is divided equally across each wire in the group, but dynamic
+        #    throttling reallocates unused unmetered bandwidth from unused or underused
+        #    wires to other wires in the group.
+    "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+        # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+    "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+        #
+        #    - NONE: default.
+        #    - DISABLE_PORT: set the port line protocol down when inline probes
+        #    detect a fault. This setting is only permitted on port mode
+        #    pseudowires.
+  },
+  "wires": [ # Output only. The single/redundant wire(s) managed by the wire group.
+    { # A pseudowire that connects two Interconnect connections.
+      "adminEnabled": True or False, # Output only. [Output Only] Indicates whether the wire is enabled.
+          # When false, the wire is disabled. When true and when the wire group of
+          # the wire is also enabled, the wire is enabled. Defaults to true.
+      "endpoints": [ # Output only. Wire endpoints are specific Interconnect connections.
+        { # Wire endpoints are specific Interconnect connections.
+          "interconnect": "A String",
+          "vlanTag": 42,
+        },
+      ],
+      "label": "A String", # Output only. [Output Only] A label that identifies the wire. The format of this label
+          # combines the existing labels of the wire group endpoints and Interconnect
+          # connections used by this wire in alphabetical order as follows:
+          # `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:
+          #
+          #    - ENDPOINT_A and ENDPOINT_B: are the labels
+          #    that you entered as map keys when you specified the wire group endpoint
+          #    objects.
+          #    - CONNECTION_A1 and CONNECTION_B1: are the
+          #    labels that you entered as map keys when you specified the wire group
+          #    Interconnect objects.
+      "wireProperties": { # The properties of a wire. # Output only. [Output Only] Properties of the wire.
+        "bandwidthAllocation": "A String", # The configuration of the bandwidth allocation, one of the following:
+            #
+            #    - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation
+            #    (and associated charges) for each wire in the group.
+            #    - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures
+            #    one unmetered bandwidth allocation for the wire group. The unmetered
+            #    bandwidth is divided equally across each wire in the group, but dynamic
+            #    throttling reallocates unused unmetered bandwidth from unused or underused
+            #    wires to other wires in the group.
+        "bandwidthUnmetered": "A String", # The unmetered bandwidth in Gigabits per second, using decimal units. `10`
+            # is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.
+        "faultResponse": "A String", # Response when a fault is detected in a pseudowire:
+            #
+            #    - NONE: default.
+            #    - DISABLE_PORT: set the port line protocol down when inline probes
+            #    detect a fault. This setting is only permitted on port mode
+            #    pseudowires.
+      },
+    },
+  ],
+}
+
+  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).
+end_interface: MixerMutationRequestBuilder
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  validateOnly: boolean, [Input Only] Validate the new configuration, but don't update it.
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.zoneOperations.html b/docs/dyn/compute_preview.zoneOperations.html new file mode 100644 index 0000000000..adaaee585d --- /dev/null +++ b/docs/dyn/compute_preview.zoneOperations.html @@ -0,0 +1,1137 @@ + + + +

Compute Engine API . zoneOperations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, operation, x__xgafv=None)

+

Deletes the specified zone-specific Operations resource.

+

+ get(project, zone, operation, x__xgafv=None)

+

Retrieves the specified zone-specific Operations resource.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves a list of Operation resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ wait(project, zone, operation, x__xgafv=None)

+

Waits for the specified Operation resource to return as `DONE`

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, operation, x__xgafv=None) + 
Deletes the specified zone-specific Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  operation: string, Name of the Operations resource to delete, or its unique numeric
+identifier. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ get(project, zone, operation, x__xgafv=None) + 
Retrieves the specified zone-specific Operations resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves a list of Operation resources contained within
+the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for 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.
+  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 Operation resources.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "items": [ # [Output Only] A list of Operation resources.
+    { # 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.
+          { # Represents a single error encountered during the processing of an
+              # 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.
+              { # Container for structured error details providing additional context
+                  # specific to the encountered error code.
+                "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                    #
+                    # 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. # Links and information to help the user resolve the error.
+                    #
+                    # 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 # A localized human-readable error message intended for end users.
+                    # 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. # Details about quota limits and metrics when a quota is exceeded.
+                  "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.
+          },
+        ],
+      },
+      "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+        "healthInfo": { # Health information. # Output only. The health information.
+          "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+          "healthStatus": "A String", # Output only. The health status.
+          "repairCategory": "A String", # Output only. The repair category.
+          "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+          "updateTime": "A String", # Output only. The time when health info was updated.
+        },
+      },
+      "getVersionOperationMetadata": {
+        "inlineSbomInfo": {
+          "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+              # appropriate identifiers.
+            "a_key": "A String",
+          },
+          "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+              # identifiers.
+            "a_key": "A String",
+          },
+        },
+      },
+      "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.
+    },
+  ],
+  "kind": "compute#operationList", # Output only. [Output Only] Type of resource. Always `compute#operations` for Operations
+      # 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 than
+      # `maxResults`, 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.
+
+
+ +
+ wait(project, zone, operation, x__xgafv=None) + 
Waits for the specified Operation resource to return as `DONE`
+or for the request to approach the 2 minute deadline, and retrieves the
+specified Operation resource. This method waits for no more than the
+2 minutes and then returns the current state of the
+operation, which might be `DONE` or still in progress.
+
+This method is called on a best-effort basis. Specifically:
+   
+   
+    - In uncommon cases, when the server is overloaded, the request might
+    return before the default deadline is reached, or might return after zero
+    seconds.
+   - If the default deadline is reached, there is no guarantee that the
+    operation is actually done when the method returns. Be prepared to retry
+    if the operation is not `DONE`.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  operation: string, Name of the Operations resource to return, or its unique numeric
+identifier. (required)
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.zoneVmExtensionPolicies.html b/docs/dyn/compute_preview.zoneVmExtensionPolicies.html new file mode 100644 index 0000000000..3bc400f3fd --- /dev/null +++ b/docs/dyn/compute_preview.zoneVmExtensionPolicies.html @@ -0,0 +1,1428 @@ + + + +

Compute Engine API . zoneVmExtensionPolicies

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, zone, vmExtensionPolicy, requestId=None, x__xgafv=None)

+

Deletes a specified zone VM extension policy within a project.

+

+ get(project, zone, vmExtensionPolicy, x__xgafv=None)

+

Retrieves details of a specific zone VM extension policy within a project.

+

+ insert(project, zone, body=None, requestId=None, x__xgafv=None)

+

Creates a new zone-level VM extension policy within a project.

+

+ list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Lists all VM extension policies within a specific zone for a project.

+

+ list_next()

+

Retrieves the next page of results.

+

+ update(project, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

+

Modifies an existing zone VM extension policy within a project.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(project, zone, vmExtensionPolicy, requestId=None, x__xgafv=None) + 
Deletes a specified zone VM extension policy within a project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  vmExtensionPolicy: string, Name of the zone VM extension policy 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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, vmExtensionPolicy, x__xgafv=None) + 
Retrieves details of a specific zone VM extension policy within a project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  vmExtensionPolicy: string, Name of the VM extension policy 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 VM extension policy.
+  "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 (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.
+      "stringConfig": "A String", # Optional. String-based configuration data for the extension.
+    },
+  },
+  "globalResourceLink": "A String", # Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if
+      # applicable.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selectors to target VMs for this policy. VMs are selected if they match
+      # *any* of the provided selectors (logical OR). If this list is empty, the
+      # policy applies to all VMs.
+    { # Defines how to select VMs to apply a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applied to a VM only if it matches all the specified # Optional. LabelSelector selects VMs based on their labels.
+          # labels.
+        "inclusionLabels": { # Optional. A map of key-value pairs representing VM labels.
+            # VMs must have all of the labels specified in this map to be selected
+            # (logical AND).
+            #
+            # e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2",
+            # "value2")}, the VM labels must contain both ("key1", "value1") and
+            # ("key2", "value2") to be selected. If the VM labels are ("key1",
+            # "value1") and ("something", "else"), it will not be selected.
+            #
+            # If the map is empty, it's considered a match.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#vmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.
+  "managedByGlobal": True or False, # Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.
+  "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.
+  "priority": 42, # Optional. Priority of this policy. Used to resolve conflicts when multiple policies
+      # apply to the same extension.
+      # 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 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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+ +
+ insert(project, zone, body=None, requestId=None, x__xgafv=None) + 
Creates a new zone-level VM extension policy within a project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a VM extension policy.
+  "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 (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.
+      "stringConfig": "A String", # Optional. String-based configuration data for the extension.
+    },
+  },
+  "globalResourceLink": "A String", # Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if
+      # applicable.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selectors to target VMs for this policy. VMs are selected if they match
+      # *any* of the provided selectors (logical OR). If this list is empty, the
+      # policy applies to all VMs.
+    { # Defines how to select VMs to apply a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applied to a VM only if it matches all the specified # Optional. LabelSelector selects VMs based on their labels.
+          # labels.
+        "inclusionLabels": { # Optional. A map of key-value pairs representing VM labels.
+            # VMs must have all of the labels specified in this map to be selected
+            # (logical AND).
+            #
+            # e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2",
+            # "value2")}, the VM labels must contain both ("key1", "value1") and
+            # ("key2", "value2") to be selected. If the VM labels are ("key1",
+            # "value1") and ("something", "else"), it will not be selected.
+            #
+            # If the map is empty, it's considered a match.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#vmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.
+  "managedByGlobal": True or False, # Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.
+  "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.
+  "priority": 42, # Optional. Priority of this policy. Used to resolve conflicts when multiple policies
+      # apply to the same extension.
+      # 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 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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Lists all VM extension policies within a specific zone for a project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String", # Output only. [Output Only] 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 VmExtensionPolicy. An up-to-date
+      # fingerprint must be provided in order to update the VmExtensionPolicy.
+      #
+      # To see the latest value of the fingerprint, make a get() request to
+      # retrieve a VmExtensionPolicy.
+  "id": "A String", # Output only. [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # Output only. [Output Only] A list of VM extension policy resources.
+    { # Represents a VM extension policy.
+      "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 (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.
+          "stringConfig": "A String", # Optional. String-based configuration data for the extension.
+        },
+      },
+      "globalResourceLink": "A String", # Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if
+          # applicable.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "instanceSelectors": [ # Optional. Selectors to target VMs for this policy. VMs are selected if they match
+          # *any* of the provided selectors (logical OR). If this list is empty, the
+          # policy applies to all VMs.
+        { # Defines how to select VMs to apply a zone VM extension policy.
+          "labelSelector": { # A LabelSelector is applied to a VM only if it matches all the specified # Optional. LabelSelector selects VMs based on their labels.
+              # labels.
+            "inclusionLabels": { # Optional. A map of key-value pairs representing VM labels.
+                # VMs must have all of the labels specified in this map to be selected
+                # (logical AND).
+                #
+                # e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2",
+                # "value2")}, the VM labels must contain both ("key1", "value1") and
+                # ("key2", "value2") to be selected. If the VM labels are ("key1",
+                # "value1") and ("something", "else"), it will not be selected.
+                #
+                # If the map is empty, it's considered a match.
+              "a_key": "A String",
+            },
+          },
+        },
+      ],
+      "kind": "compute#vmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.
+      "managedByGlobal": True or False, # Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.
+      "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.
+      "priority": 42, # Optional. Priority of this policy. Used to resolve conflicts when multiple policies
+          # apply to the same extension.
+          # 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 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.
+      "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+          # text format.
+    },
+  ],
+  "kind": "compute#vmExtensionPolicyList", # Output only. Type of resource.
+  "nextPageToken": "A String", # Output only. [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. [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.
+
+
+ +
+ update(project, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None) + 
Modifies an existing zone VM extension policy within a project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  vmExtensionPolicy: string, Name of the zone VM extension policy to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a VM extension policy.
+  "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 (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.
+      "stringConfig": "A String", # Optional. String-based configuration data for the extension.
+    },
+  },
+  "globalResourceLink": "A String", # Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if
+      # applicable.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "instanceSelectors": [ # Optional. Selectors to target VMs for this policy. VMs are selected if they match
+      # *any* of the provided selectors (logical OR). If this list is empty, the
+      # policy applies to all VMs.
+    { # Defines how to select VMs to apply a zone VM extension policy.
+      "labelSelector": { # A LabelSelector is applied to a VM only if it matches all the specified # Optional. LabelSelector selects VMs based on their labels.
+          # labels.
+        "inclusionLabels": { # Optional. A map of key-value pairs representing VM labels.
+            # VMs must have all of the labels specified in this map to be selected
+            # (logical AND).
+            #
+            # e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2",
+            # "value2")}, the VM labels must contain both ("key1", "value1") and
+            # ("key2", "value2") to be selected. If the VM labels are ("key1",
+            # "value1") and ("something", "else"), it will not be selected.
+            #
+            # If the map is empty, it's considered a match.
+          "a_key": "A String",
+        },
+      },
+    },
+  ],
+  "kind": "compute#vmExtensionPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.
+  "managedByGlobal": True or False, # Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.
+  "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.
+  "priority": 42, # Optional. Priority of this policy. Used to resolve conflicts when multiple policies
+      # apply to the same extension.
+      # 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 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.
+  "updateTimestamp": "A String", # Output only. [Output Only] Update timestamp inRFC3339
+      # text format.
+}
+
+  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.
+      { # Represents a single error encountered during the processing of an
+          # 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.
+          { # Container for structured error details providing additional context
+              # specific to the encountered error code.
+            "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata.
+                #
+                # 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. # Links and information to help the user resolve the error.
+                #
+                # 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 # A localized human-readable error message intended for end users.
+                # 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. # Details about quota limits and metrics when a quota is exceeded.
+              "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.
+      },
+    ],
+  },
+  "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations.
+    "healthInfo": { # Health information. # Output only. The health information.
+      "availabilitySloStatus": "A String", # Output only. The availability SLO status.
+      "healthStatus": "A String", # Output only. The health status.
+      "repairCategory": "A String", # Output only. The repair category.
+      "unhealthyReason": "A String", # Output only. The reason for unhealthy status.
+      "updateTime": "A String", # Output only. The time when health info was updated.
+    },
+  },
+  "getVersionOperationMetadata": {
+    "inlineSbomInfo": {
+      "currentComponentVersions": { # A mapping of components to their currently-applied versions or other
+          # appropriate identifiers.
+        "a_key": "A String",
+      },
+      "targetComponentVersions": { # A mapping of components to their target versions or other appropriate
+          # identifiers.
+        "a_key": "A String",
+      },
+    },
+  },
+  "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.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_preview.zones.html b/docs/dyn/compute_preview.zones.html new file mode 100644 index 0000000000..f0fcf76375 --- /dev/null +++ b/docs/dyn/compute_preview.zones.html @@ -0,0 +1,556 @@ + + + +

Compute Engine API . zones

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(project, zone, x__xgafv=None)

+

Returns the specified Zone resource.

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

+

Retrieves the list of Zone resources available to the specified project.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(project, zone, x__xgafv=None) + 
Returns the specified Zone resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone 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 Zone resource.
+    #
+    # A zone is a deployment area. These deployment areas are subsets of a region.
+    # For example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and
+    # Zones.
+  "availableCpuPlatforms": [ # [Output Only] Available cpu/platform selections for the zone.
+    "A String",
+  ],
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
+    "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DELETED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to DEPRECATED. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+        # resource is intended to change to OBSOLETE. This is only
+        # informational and the status will not change unless the client explicitly
+        # changes it.
+    "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+        # The suggested replacement resource must be the same kind of resource as the
+        # deprecated resource.
+    "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+        # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+        # warning indicating the deprecated resource and recommending its
+        # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+  },
+  "description": "A String", # [Output Only] Textual description of the resource.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#zone", # Output only. [Output Only] Type of the resource. Always compute#zone for
+      # zones.
+  "name": "A String", # [Output Only] Name of the resource.
+  "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
+  "resourceStatus": {
+    "upcomingMaintenances": [ # Output only. [Output Only] The upcoming maintenance schedule.
+      { # The periodic partial maintenance schedule includes 52 weeks worth of
+          # maintenance windows.
+          # LINT.IfChange(PeriodicPartialMaintenanceSchedule)
+        "subType": "A String", # The maintenance type in which the zone is during the given window.
+        "targetResource": "A String", # The target resource that the maintenance window is for.
+            # For example, "projects/my-project/zones/us-central1-a".
+        "type": "A String",
+        "windowEndTime": { # Represents civil time (or occasionally physical time). # The end civil timestamp of the window (not inclusive).
+            # This contains a time zone.
+            #
+            # This type can represent a civil time in one of a few possible ways:
+            #
+            #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+            #    day with a particular offset from UTC.
+            #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+            #    day in a particular time zone.
+            #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+            #    day in local time.
+            #
+            # The date is relative to the Proleptic Gregorian Calendar.
+            #
+            # If year, month, or day are 0, the DateTime is considered not to have a
+            # specific year, month, or day respectively.
+            #
+            # This type may also be used to represent a physical time if all the date and
+            # time fields are set and either case of the `time_offset` oneof is set.
+            # Consider using `Timestamp` message for physical time instead. If your use
+            # case also would like to store the user's timezone, that can be done in
+            # another field.
+            #
+            # This type is more flexible than some applications may want. Make sure to
+            # document and validate your application's limitations.
+          "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+              # month, or 0 if specifying a datetime without a day.
+          "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+              # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+              # scenarios like business closing time.
+          "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+          "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+              # datetime without a month.
+          "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+              # 999,999,999, defaults to 0.
+          "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+              # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+          "timeZone": { # Represents a time zone from the # Time zone.
+              # [IANA Time Zone Database](https://www.iana.org/time-zones).
+            "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+            "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+          },
+          "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+              # For example, a UTC offset of -4:00 would be represented as
+              # { seconds: -14400 }.
+          "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+              # datetime without a year.
+        },
+        "windowStartTime": { # Represents civil time (or occasionally physical time). # The start civil timestamp of the window.
+            # This contains a time zone.
+            #
+            # This type can represent a civil time in one of a few possible ways:
+            #
+            #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+            #    day with a particular offset from UTC.
+            #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+            #    day in a particular time zone.
+            #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+            #    day in local time.
+            #
+            # The date is relative to the Proleptic Gregorian Calendar.
+            #
+            # If year, month, or day are 0, the DateTime is considered not to have a
+            # specific year, month, or day respectively.
+            #
+            # This type may also be used to represent a physical time if all the date and
+            # time fields are set and either case of the `time_offset` oneof is set.
+            # Consider using `Timestamp` message for physical time instead. If your use
+            # case also would like to store the user's timezone, that can be done in
+            # another field.
+            #
+            # This type is more flexible than some applications may want. Make sure to
+            # document and validate your application's limitations.
+          "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+              # month, or 0 if specifying a datetime without a day.
+          "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+              # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+              # scenarios like business closing time.
+          "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+          "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+              # datetime without a month.
+          "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+              # 999,999,999, defaults to 0.
+          "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+              # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+          "timeZone": { # Represents a time zone from the # Time zone.
+              # [IANA Time Zone Database](https://www.iana.org/time-zones).
+            "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+            "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+          },
+          "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+              # For example, a UTC offset of -4:00 would be represented as
+              # { seconds: -14400 }.
+          "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+              # datetime without a year.
+        },
+      },
+    ],
+  },
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "status": "A String", # [Output Only] Status of the zone, either UP orDOWN.
+  "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None) + 
Retrieves the list of Zone resources available to 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.
+  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 zone resources.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of Zone resources.
+    { # Represents a Zone resource.
+        #
+        # A zone is a deployment area. These deployment areas are subsets of a region.
+        # For example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and
+        # Zones.
+      "availableCpuPlatforms": [ # [Output Only] Available cpu/platform selections for the zone.
+        "A String",
+      ],
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DELETED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to DEPRECATED. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this
+            # resource is intended to change to OBSOLETE. This is only
+            # informational and the status will not change unless the client explicitly
+            # changes it.
+        "replacement": "A String", # The URL of the suggested replacement for a deprecated resource.
+            # The suggested replacement resource must be the same kind of resource as the
+            # deprecated resource.
+        "state": "A String", # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
+            # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
+            # warning indicating the deprecated resource and recommending its
+            # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
+      },
+      "description": "A String", # [Output Only] Textual description of the resource.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#zone", # Output only. [Output Only] Type of the resource. Always compute#zone for
+          # zones.
+      "name": "A String", # [Output Only] Name of the resource.
+      "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
+      "resourceStatus": {
+        "upcomingMaintenances": [ # Output only. [Output Only] The upcoming maintenance schedule.
+          { # The periodic partial maintenance schedule includes 52 weeks worth of
+              # maintenance windows.
+              # LINT.IfChange(PeriodicPartialMaintenanceSchedule)
+            "subType": "A String", # The maintenance type in which the zone is during the given window.
+            "targetResource": "A String", # The target resource that the maintenance window is for.
+                # For example, "projects/my-project/zones/us-central1-a".
+            "type": "A String",
+            "windowEndTime": { # Represents civil time (or occasionally physical time). # The end civil timestamp of the window (not inclusive).
+                # This contains a time zone.
+                #
+                # This type can represent a civil time in one of a few possible ways:
+                #
+                #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+                #    day with a particular offset from UTC.
+                #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+                #    day in a particular time zone.
+                #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+                #    day in local time.
+                #
+                # The date is relative to the Proleptic Gregorian Calendar.
+                #
+                # If year, month, or day are 0, the DateTime is considered not to have a
+                # specific year, month, or day respectively.
+                #
+                # This type may also be used to represent a physical time if all the date and
+                # time fields are set and either case of the `time_offset` oneof is set.
+                # Consider using `Timestamp` message for physical time instead. If your use
+                # case also would like to store the user's timezone, that can be done in
+                # another field.
+                #
+                # This type is more flexible than some applications may want. Make sure to
+                # document and validate your application's limitations.
+              "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+                  # month, or 0 if specifying a datetime without a day.
+              "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+                  # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+                  # scenarios like business closing time.
+              "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+              "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+                  # datetime without a month.
+              "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+                  # 999,999,999, defaults to 0.
+              "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+                  # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+              "timeZone": { # Represents a time zone from the # Time zone.
+                  # [IANA Time Zone Database](https://www.iana.org/time-zones).
+                "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+                "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+              },
+              "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+                  # For example, a UTC offset of -4:00 would be represented as
+                  # { seconds: -14400 }.
+              "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+                  # datetime without a year.
+            },
+            "windowStartTime": { # Represents civil time (or occasionally physical time). # The start civil timestamp of the window.
+                # This contains a time zone.
+                #
+                # This type can represent a civil time in one of a few possible ways:
+                #
+                #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+                #    day with a particular offset from UTC.
+                #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+                #    day in a particular time zone.
+                #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+                #    day in local time.
+                #
+                # The date is relative to the Proleptic Gregorian Calendar.
+                #
+                # If year, month, or day are 0, the DateTime is considered not to have a
+                # specific year, month, or day respectively.
+                #
+                # This type may also be used to represent a physical time if all the date and
+                # time fields are set and either case of the `time_offset` oneof is set.
+                # Consider using `Timestamp` message for physical time instead. If your use
+                # case also would like to store the user's timezone, that can be done in
+                # another field.
+                #
+                # This type is more flexible than some applications may want. Make sure to
+                # document and validate your application's limitations.
+              "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and
+                  # month, or 0 if specifying a datetime without a day.
+              "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults
+                  # to 0 (midnight). An API may choose to allow the value "24:00:00" for
+                  # scenarios like business closing time.
+              "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+              "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a
+                  # datetime without a month.
+              "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to
+                  # 999,999,999, defaults to 0.
+              "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59,
+                  # defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+              "timeZone": { # Represents a time zone from the # Time zone.
+                  # [IANA Time Zone Database](https://www.iana.org/time-zones).
+                "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+                "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+              },
+              "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+                  # For example, a UTC offset of -4:00 would be represented as
+                  # { seconds: -14400 }.
+              "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+                  # datetime without a year.
+            },
+          },
+        ],
+      },
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "status": "A String", # [Output Only] Status of the zone, either UP orDOWN.
+      "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use.
+    },
+  ],
+  "kind": "compute#zoneList", # 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.
+  "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.
+
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_v1.acceleratorTypes.html b/docs/dyn/compute_v1.acceleratorTypes.html index bb36ae6c4a..9108d325b7 100644 --- a/docs/dyn/compute_v1.acceleratorTypes.html +++ b/docs/dyn/compute_v1.acceleratorTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of accelerator types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of accelerator types that are available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -326,17 +326,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -601,17 +601,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.addresses.html b/docs/dyn/compute_v1.addresses.html index 1889d2e8cf..e26797878b 100644 --- a/docs/dyn/compute_v1.addresses.html +++ b/docs/dyn/compute_v1.addresses.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of addresses.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of addresses contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, region, address, body=None, requestId=None, x__xgafv=None)

@@ -423,17 +423,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1607,17 +1607,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.autoscalers.html b/docs/dyn/compute_v1.autoscalers.html index 8c1719b80f..02b0b0faac 100644 --- a/docs/dyn/compute_v1.autoscalers.html +++ b/docs/dyn/compute_v1.autoscalers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of autoscalers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -630,17 +630,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2432,17 +2432,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.backendBuckets.html b/docs/dyn/compute_v1.backendBuckets.html index 7c8edda0c4..02a1497380 100644 --- a/docs/dyn/compute_v1.backendBuckets.html +++ b/docs/dyn/compute_v1.backendBuckets.html @@ -81,7 +81,7 @@

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 BackendBucket resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -822,17 +822,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3192,31 +3192,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.backendServices.html b/docs/dyn/compute_v1.backendServices.html index 0f19435b96..8b15c43c88 100644 --- a/docs/dyn/compute_v1.backendServices.html +++ b/docs/dyn/compute_v1.backendServices.html @@ -81,7 +81,7 @@

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 BackendService resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -114,10 +114,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, backendService, body=None, requestId=None, x__xgafv=None)

@@ -1978,17 +1978,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -9003,31 +9003,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.crossSiteNetworks.html b/docs/dyn/compute_v1.crossSiteNetworks.html index 3f156e6394..1abcc27b02 100644 --- a/docs/dyn/compute_v1.crossSiteNetworks.html +++ b/docs/dyn/compute_v1.crossSiteNetworks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the cross-site networks for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -930,17 +930,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.diskTypes.html b/docs/dyn/compute_v1.diskTypes.html index 9b2e325d68..81ddc88519 100644 --- a/docs/dyn/compute_v1.diskTypes.html +++ b/docs/dyn/compute_v1.diskTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of disk types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of disk types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -332,17 +332,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.disks.html b/docs/dyn/compute_v1.disks.html index 848186e389..6686ad73c9 100644 --- a/docs/dyn/compute_v1.disks.html +++ b/docs/dyn/compute_v1.disks.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of persistent disks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)

@@ -111,7 +111,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)

@@ -1160,17 +1160,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5198,17 +5198,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.externalVpnGateways.html b/docs/dyn/compute_v1.externalVpnGateways.html index 817bd4f3d9..8ab3411b9a 100644 --- a/docs/dyn/compute_v1.externalVpnGateways.html +++ b/docs/dyn/compute_v1.externalVpnGateways.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of ExternalVpnGateway available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, resource, body=None, x__xgafv=None)

@@ -1129,17 +1129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.firewallPolicies.html b/docs/dyn/compute_v1.firewallPolicies.html index 96347a54eb..eb7856295d 100644 --- a/docs/dyn/compute_v1.firewallPolicies.html +++ b/docs/dyn/compute_v1.firewallPolicies.html @@ -111,7 +111,7 @@

Instance Methods

listAssociations(includeInheritedPolicies=None, targetResource=None, x__xgafv=None)

Lists associations of a specified target, i.e., organization or folder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(firewallPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -4018,17 +4018,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.firewalls.html b/docs/dyn/compute_v1.firewalls.html index f2ad19bc35..a3f7cf0940 100644 --- a/docs/dyn/compute_v1.firewalls.html +++ b/docs/dyn/compute_v1.firewalls.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of firewall rules available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewall, body=None, requestId=None, x__xgafv=None)

@@ -1365,17 +1365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.forwardingRules.html b/docs/dyn/compute_v1.forwardingRules.html index f4292ef4a1..aff7ece927 100644 --- a/docs/dyn/compute_v1.forwardingRules.html +++ b/docs/dyn/compute_v1.forwardingRules.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of forwarding rules.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of ForwardingRule resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -716,17 +716,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2785,17 +2785,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.futureReservations.html b/docs/dyn/compute_v1.futureReservations.html index 719ad9b62c..8617eb073e 100644 --- a/docs/dyn/compute_v1.futureReservations.html +++ b/docs/dyn/compute_v1.futureReservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of future reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the future reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -627,17 +627,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2737,17 +2737,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.globalAddresses.html b/docs/dyn/compute_v1.globalAddresses.html index fe3c9960bb..ee0e129ff8 100644 --- a/docs/dyn/compute_v1.globalAddresses.html +++ b/docs/dyn/compute_v1.globalAddresses.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of global addresses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(project, address, body=None, requestId=None, x__xgafv=None)

@@ -1268,17 +1268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.globalForwardingRules.html b/docs/dyn/compute_v1.globalForwardingRules.html index 8a418af37a..b09a39ba58 100644 --- a/docs/dyn/compute_v1.globalForwardingRules.html +++ b/docs/dyn/compute_v1.globalForwardingRules.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of GlobalForwardingRule resources available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, forwardingRule, body=None, requestId=None, x__xgafv=None)

@@ -2155,17 +2155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.globalNetworkEndpointGroups.html b/docs/dyn/compute_v1.globalNetworkEndpointGroups.html index 673f3505ea..4a371bb3d8 100644 --- a/docs/dyn/compute_v1.globalNetworkEndpointGroups.html +++ b/docs/dyn/compute_v1.globalNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2278,31 +2278,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.globalOperations.html b/docs/dyn/compute_v1.globalOperations.html index 29c75d42d0..7ea7657e4d 100644 --- a/docs/dyn/compute_v1.globalOperations.html +++ b/docs/dyn/compute_v1.globalOperations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all operations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, operation, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1295,17 +1295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.globalOrganizationOperations.html b/docs/dyn/compute_v1.globalOrganizationOperations.html index a8e7ee3dc5..76819a838d 100644 --- a/docs/dyn/compute_v1.globalOrganizationOperations.html +++ b/docs/dyn/compute_v1.globalOrganizationOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -816,17 +816,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.globalPublicDelegatedPrefixes.html b/docs/dyn/compute_v1.globalPublicDelegatedPrefixes.html index d806927eeb..2d2d5ac849 100644 --- a/docs/dyn/compute_v1.globalPublicDelegatedPrefixes.html +++ b/docs/dyn/compute_v1.globalPublicDelegatedPrefixes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the global PublicDelegatedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1109,17 +1109,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.globalVmExtensionPolicies.html b/docs/dyn/compute_v1.globalVmExtensionPolicies.html index edece70482..60233a979e 100644 --- a/docs/dyn/compute_v1.globalVmExtensionPolicies.html +++ b/docs/dyn/compute_v1.globalVmExtensionPolicies.html @@ -78,7 +78,7 @@

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 VM Extension Policy resources

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists global VM extension policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, globalVmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -345,17 +345,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1544,17 +1544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.healthChecks.html b/docs/dyn/compute_v1.healthChecks.html index 0ab42821dc..be2fb8859b 100644 --- a/docs/dyn/compute_v1.healthChecks.html +++ b/docs/dyn/compute_v1.healthChecks.html @@ -78,7 +78,7 @@

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 HealthCheck resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -639,17 +639,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2466,17 +2466,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.hosts.html b/docs/dyn/compute_v1.hosts.html index 6e621fe31c..dc7a64888f 100644 --- a/docs/dyn/compute_v1.hosts.html +++ b/docs/dyn/compute_v1.hosts.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, association, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of hosts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -634,17 +634,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.html b/docs/dyn/compute_v1.html index 821bfb2175..724ce573ba 100644 --- a/docs/dyn/compute_v1.html +++ b/docs/dyn/compute_v1.html @@ -733,7 +733,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -742,20 +742,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/compute_v1.httpHealthChecks.html b/docs/dyn/compute_v1.httpHealthChecks.html index e98b2d7822..d10630db5d 100644 --- a/docs/dyn/compute_v1.httpHealthChecks.html +++ b/docs/dyn/compute_v1.httpHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -986,17 +986,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.httpsHealthChecks.html b/docs/dyn/compute_v1.httpsHealthChecks.html index e7aa0df875..68e0be707d 100644 --- a/docs/dyn/compute_v1.httpsHealthChecks.html +++ b/docs/dyn/compute_v1.httpsHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HttpsHealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, httpsHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -998,17 +998,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.imageViews.html b/docs/dyn/compute_v1.imageViews.html index 06656259da..4931e57205 100644 --- a/docs/dyn/compute_v1.imageViews.html +++ b/docs/dyn/compute_v1.imageViews.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns a list of global ImageView resources, with a regional

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1200,17 +1200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.images.html b/docs/dyn/compute_v1.images.html index 65ba373404..8ed03ad9da 100644 --- a/docs/dyn/compute_v1.images.html +++ b/docs/dyn/compute_v1.images.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of custom images

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, image, body=None, requestId=None, x__xgafv=None)

@@ -3500,17 +3500,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instanceGroupManagerResizeRequests.html b/docs/dyn/compute_v1.instanceGroupManagerResizeRequests.html index 3086aaf980..ba65bc9d01 100644 --- a/docs/dyn/compute_v1.instanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_v1.instanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resize requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2164,17 +2164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.instanceGroupManagers.html b/docs/dyn/compute_v1.instanceGroupManagers.html index 41ff2fac5d..600ba8c189 100644 --- a/docs/dyn/compute_v1.instanceGroupManagers.html +++ b/docs/dyn/compute_v1.instanceGroupManagers.html @@ -81,7 +81,7 @@

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 managed instance groups and groups them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)

@@ -114,22 +114,22 @@

Instance Methods

listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given managed

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the instances in the managed instance group. Each instance

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -1888,17 +1888,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -7832,17 +7832,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -8715,17 +8715,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -8933,31 +8933,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instanceGroups.html b/docs/dyn/compute_v1.instanceGroups.html index 36a0fbca8c..4de99ccccd 100644 --- a/docs/dyn/compute_v1.instanceGroups.html +++ b/docs/dyn/compute_v1.instanceGroups.html @@ -81,7 +81,7 @@

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 instance groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listInstances(project, zone, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group.

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeInstances(project, zone, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -680,17 +680,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1824,31 +1824,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instanceTemplates.html b/docs/dyn/compute_v1.instanceTemplates.html index db7610ff8c..e91baed109 100644 --- a/docs/dyn/compute_v1.instanceTemplates.html +++ b/docs/dyn/compute_v1.instanceTemplates.html @@ -78,7 +78,7 @@

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 InstanceTemplates resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1313,17 +1313,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5542,17 +5542,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instances.html b/docs/dyn/compute_v1.instances.html index 9036d10c4e..98a4f3d992 100644 --- a/docs/dyn/compute_v1.instances.html +++ b/docs/dyn/compute_v1.instances.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of all of the instances in your project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachDisk(project, zone, instance, body=None, forceAttach=None, requestId=None, x__xgafv=None)

@@ -141,10 +141,10 @@

Instance Methods

listReferrers(project, zone, instance, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of resources that refer to the VM instance specified in

- listReferrers_next(previous_request, previous_response)

+ listReferrers_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, instance, requestId=None, x__xgafv=None)

@@ -2849,17 +2849,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -12200,31 +12200,31 @@

Method Details

- listReferrers_next(previous_request, previous_response) + listReferrers_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instantSnapshotGroups.html b/docs/dyn/compute_v1.instantSnapshotGroups.html index 9f6e3fdb8e..6b3606eaec 100644 --- a/docs/dyn/compute_v1.instantSnapshotGroups.html +++ b/docs/dyn/compute_v1.instantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -1361,17 +1361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.instantSnapshots.html b/docs/dyn/compute_v1.instantSnapshots.html index b423896020..406ffb7333 100644 --- a/docs/dyn/compute_v1.instantSnapshots.html +++ b/docs/dyn/compute_v1.instantSnapshots.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of instantSnapshots.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1832,17 +1832,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.interconnectAttachmentGroups.html b/docs/dyn/compute_v1.interconnectAttachmentGroups.html index 519514985b..f634f2c90d 100644 --- a/docs/dyn/compute_v1.interconnectAttachmentGroups.html +++ b/docs/dyn/compute_v1.interconnectAttachmentGroups.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectAttachmentGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectAttachmentGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1713,17 +1713,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.interconnectAttachments.html b/docs/dyn/compute_v1.interconnectAttachments.html index c3a18c4400..8ad36c6a4f 100644 --- a/docs/dyn/compute_v1.interconnectAttachments.html +++ b/docs/dyn/compute_v1.interconnectAttachments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of interconnect attachments.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect attachments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, interconnectAttachment, body=None, requestId=None, x__xgafv=None)

@@ -665,17 +665,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2586,17 +2586,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.interconnectGroups.html b/docs/dyn/compute_v1.interconnectGroups.html index 824b056b35..8bae24277e 100644 --- a/docs/dyn/compute_v1.interconnectGroups.html +++ b/docs/dyn/compute_v1.interconnectGroups.html @@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the InterconnectGroups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnectGroup, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2206,17 +2206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.interconnectLocations.html b/docs/dyn/compute_v1.interconnectLocations.html index 4609101d24..f0ba79de16 100644 --- a/docs/dyn/compute_v1.interconnectLocations.html +++ b/docs/dyn/compute_v1.interconnectLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect locations available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -433,17 +433,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.interconnectRemoteLocations.html b/docs/dyn/compute_v1.interconnectRemoteLocations.html index fb4294eeb3..89f412ab14 100644 --- a/docs/dyn/compute_v1.interconnectRemoteLocations.html +++ b/docs/dyn/compute_v1.interconnectRemoteLocations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of interconnect remote locations available to the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -494,17 +494,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.interconnects.html b/docs/dyn/compute_v1.interconnects.html index 5a034b478e..5a4e656d7f 100644 --- a/docs/dyn/compute_v1.interconnects.html +++ b/docs/dyn/compute_v1.interconnects.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Interconnects available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, interconnect, body=None, requestId=None, x__xgafv=None)

@@ -1874,17 +1874,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.licenses.html b/docs/dyn/compute_v1.licenses.html index e64ff1cc05..23dba8ca08 100644 --- a/docs/dyn/compute_v1.licenses.html +++ b/docs/dyn/compute_v1.licenses.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of licenses

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -1500,17 +1500,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.machineImages.html b/docs/dyn/compute_v1.machineImages.html index a293d29510..7299486d1c 100644 --- a/docs/dyn/compute_v1.machineImages.html +++ b/docs/dyn/compute_v1.machineImages.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine images that are contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -6315,17 +6315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.machineTypes.html b/docs/dyn/compute_v1.machineTypes.html index ec6d82276a..33069babe0 100644 --- a/docs/dyn/compute_v1.machineTypes.html +++ b/docs/dyn/compute_v1.machineTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of machine types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of machine types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -335,17 +335,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -629,17 +629,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.managedRulesets.html b/docs/dyn/compute_v1.managedRulesets.html index b38f3cf7d4..1961653fa6 100644 --- a/docs/dyn/compute_v1.managedRulesets.html +++ b/docs/dyn/compute_v1.managedRulesets.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of all the managed rulesets available.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -292,17 +292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.networkAttachments.html b/docs/dyn/compute_v1.networkAttachments.html index b61acbc059..30f8561fc6 100644 --- a/docs/dyn/compute_v1.networkAttachments.html +++ b/docs/dyn/compute_v1.networkAttachments.html @@ -78,7 +78,7 @@

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 NetworkAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NetworkAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, networkAttachment, body=None, requestId=None, x__xgafv=None)

@@ -359,17 +359,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.networkEdgeSecurityServices.html b/docs/dyn/compute_v1.networkEdgeSecurityServices.html index 9f607ba3f7..1f5fc99313 100644 --- a/docs/dyn/compute_v1.networkEdgeSecurityServices.html +++ b/docs/dyn/compute_v1.networkEdgeSecurityServices.html @@ -78,7 +78,7 @@

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 NetworkEdgeSecurityService resources available to

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -313,17 +313,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.networkEndpointGroups.html b/docs/dyn/compute_v1.networkEndpointGroups.html index a47ed8b589..5ad9e6ab68 100644 --- a/docs/dyn/compute_v1.networkEndpointGroups.html +++ b/docs/dyn/compute_v1.networkEndpointGroups.html @@ -78,7 +78,7 @@

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 network endpoint groups and sorts them by zone.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

attachNetworkEndpoints(project, zone, networkEndpointGroup, body=None, requestId=None, x__xgafv=None)

@@ -105,10 +105,10 @@

Instance Methods

listNetworkEndpoints(project, zone, networkEndpointGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, zone, resource, body=None, x__xgafv=None)

@@ -457,17 +457,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2671,31 +2671,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.networkFirewallPolicies.html b/docs/dyn/compute_v1.networkFirewallPolicies.html index afd27e1d9b..a26d25d9c6 100644 --- a/docs/dyn/compute_v1.networkFirewallPolicies.html +++ b/docs/dyn/compute_v1.networkFirewallPolicies.html @@ -87,7 +87,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of network firewall policies, listing network

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

cloneRules(project, firewallPolicy, requestId=None, sourceFirewallPolicy=None, x__xgafv=None)

@@ -120,7 +120,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the policies that have been configured for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -2101,17 +2101,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -5347,17 +5347,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.networkProfiles.html b/docs/dyn/compute_v1.networkProfiles.html index 4251f2827c..65d5060474 100644 --- a/docs/dyn/compute_v1.networkProfiles.html +++ b/docs/dyn/compute_v1.networkProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of network profiles available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.networks.html b/docs/dyn/compute_v1.networks.html index 337d3339b7..0a5d626d0a 100644 --- a/docs/dyn/compute_v1.networks.html +++ b/docs/dyn/compute_v1.networks.html @@ -102,10 +102,10 @@

Instance Methods

listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, returnPartialSuccess=None, x__xgafv=None)

Lists the peering routes exchanged over peering connection.

- listPeeringRoutes_next(previous_request, previous_response)

+ listPeeringRoutes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, network, body=None, requestId=None, x__xgafv=None)

@@ -2864,31 +2864,31 @@

Method Details

- listPeeringRoutes_next(previous_request, previous_response) + listPeeringRoutes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.nodeGroups.html b/docs/dyn/compute_v1.nodeGroups.html index 49cace2b6c..44d128259a 100644 --- a/docs/dyn/compute_v1.nodeGroups.html +++ b/docs/dyn/compute_v1.nodeGroups.html @@ -81,7 +81,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node groups.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -108,10 +108,10 @@

Instance Methods

listNodes(project, zone, nodeGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists nodes in the node group.

- listNodes_next(previous_request, previous_response)

+ listNodes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, zone, nodeGroup, body=None, requestId=None, x__xgafv=None)

@@ -705,17 +705,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2632,31 +2632,31 @@

Method Details

- listNodes_next(previous_request, previous_response) + listNodes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.nodeTemplates.html b/docs/dyn/compute_v1.nodeTemplates.html index 9581f22831..bf668c9c6a 100644 --- a/docs/dyn/compute_v1.nodeTemplates.html +++ b/docs/dyn/compute_v1.nodeTemplates.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node templates.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node templates available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1736,17 +1736,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.nodeTypes.html b/docs/dyn/compute_v1.nodeTypes.html index f4579090a3..722935656f 100644 --- a/docs/dyn/compute_v1.nodeTypes.html +++ b/docs/dyn/compute_v1.nodeTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of node types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of node types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -322,17 +322,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -590,17 +590,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.organizationSecurityPolicies.html b/docs/dyn/compute_v1.organizationSecurityPolicies.html index b0e9c0bdac..a9e29ce1df 100644 --- a/docs/dyn/compute_v1.organizationSecurityPolicies.html +++ b/docs/dyn/compute_v1.organizationSecurityPolicies.html @@ -111,7 +111,7 @@

Instance Methods

listPreconfiguredExpressionSets(filter=None, maxResults=None, orderBy=None, pageToken=None, parentId=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(securityPolicy, parentId=None, requestId=None, x__xgafv=None)

@@ -4867,17 +4867,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.packetMirrorings.html b/docs/dyn/compute_v1.packetMirrorings.html index e9d0452dad..44f5ec3685 100644 --- a/docs/dyn/compute_v1.packetMirrorings.html +++ b/docs/dyn/compute_v1.packetMirrorings.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of packetMirrorings.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of PacketMirroring resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, packetMirroring, body=None, requestId=None, x__xgafv=None)

@@ -389,17 +389,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1483,17 +1483,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.previewFeatures.html b/docs/dyn/compute_v1.previewFeatures.html index ed57d97c01..1c121e16f6 100644 --- a/docs/dyn/compute_v1.previewFeatures.html +++ b/docs/dyn/compute_v1.previewFeatures.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Returns the details of the given PreviewFeature.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, previewFeature, body=None, requestId=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.projects.html b/docs/dyn/compute_v1.projects.html index b672075bd7..dfcbc7a739 100644 --- a/docs/dyn/compute_v1.projects.html +++ b/docs/dyn/compute_v1.projects.html @@ -99,13 +99,13 @@

Instance Methods

getXpnResources(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets service resources (a.k.a service project) associated with this host

- getXpnResources_next(previous_request, previous_response)

+ getXpnResources_next()

Retrieves the next page of results.

listXpnHosts(project, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all shared VPC host projects visible to the user in an organization.

- listXpnHosts_next(previous_request, previous_response)

+ listXpnHosts_next()

Retrieves the next page of results.

moveDisk(project, body=None, requestId=None, x__xgafv=None)

@@ -1692,17 +1692,17 @@

Method Details

- getXpnResources_next(previous_request, previous_response) + getXpnResources_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)
+        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.
-
+ 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. +
@@ -1935,17 +1935,17 @@

Method Details

- listXpnHosts_next(previous_request, previous_response) + listXpnHosts_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.publicAdvertisedPrefixes.html b/docs/dyn/compute_v1.publicAdvertisedPrefixes.html index 6d51041134..44139ac5ff 100644 --- a/docs/dyn/compute_v1.publicAdvertisedPrefixes.html +++ b/docs/dyn/compute_v1.publicAdvertisedPrefixes.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicAdvertisedPrefixes for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, publicAdvertisedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -1381,17 +1381,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.publicDelegatedPrefixes.html b/docs/dyn/compute_v1.publicDelegatedPrefixes.html index 0af460a2db..ae254309bf 100644 --- a/docs/dyn/compute_v1.publicDelegatedPrefixes.html +++ b/docs/dyn/compute_v1.publicDelegatedPrefixes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Lists all PublicDelegatedPrefix resources owned by the specific project

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

announce(project, region, publicDelegatedPrefix, requestId=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the PublicDelegatedPrefixes for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, publicDelegatedPrefix, body=None, requestId=None, x__xgafv=None)

@@ -374,17 +374,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1709,17 +1709,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionAutoscalers.html b/docs/dyn/compute_v1.regionAutoscalers.html index 593e208587..d4bd9a6f15 100644 --- a/docs/dyn/compute_v1.regionAutoscalers.html +++ b/docs/dyn/compute_v1.regionAutoscalers.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of autoscalers contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, autoscaler=None, body=None, requestId=None, x__xgafv=None)

@@ -1890,17 +1890,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionBackendBuckets.html b/docs/dyn/compute_v1.regionBackendBuckets.html index 2ed26209fd..14bf3b7201 100644 --- a/docs/dyn/compute_v1.regionBackendBuckets.html +++ b/docs/dyn/compute_v1.regionBackendBuckets.html @@ -96,10 +96,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend buckets in the specified project in

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendBucket, body=None, requestId=None, x__xgafv=None)

@@ -2171,31 +2171,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionBackendServices.html b/docs/dyn/compute_v1.regionBackendServices.html index d2b68df048..812856f891 100644 --- a/docs/dyn/compute_v1.regionBackendServices.html +++ b/docs/dyn/compute_v1.regionBackendServices.html @@ -99,10 +99,10 @@

Instance Methods

listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of all usable backend services for Application Load

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, backendService, body=None, requestId=None, x__xgafv=None)

@@ -6814,31 +6814,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionCommitments.html b/docs/dyn/compute_v1.regionCommitments.html index e0c4764308..45fe52b656 100644 --- a/docs/dyn/compute_v1.regionCommitments.html +++ b/docs/dyn/compute_v1.regionCommitments.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of commitments by region.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of commitments contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, region, commitment, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -661,17 +661,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2282,17 +2282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionCompositeHealthChecks.html b/docs/dyn/compute_v1.regionCompositeHealthChecks.html index d939636f38..c5fa6369b5 100644 --- a/docs/dyn/compute_v1.regionCompositeHealthChecks.html +++ b/docs/dyn/compute_v1.regionCompositeHealthChecks.html @@ -78,7 +78,7 @@

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 CompositeHealthCheck resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the CompositeHealthChecks for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, compositeHealthCheck, body=None, requestId=None, x__xgafv=None)

@@ -333,17 +333,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1275,17 +1275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionDiskTypes.html b/docs/dyn/compute_v1.regionDiskTypes.html index 167be51e68..f4b2fa85b9 100644 --- a/docs/dyn/compute_v1.regionDiskTypes.html +++ b/docs/dyn/compute_v1.regionDiskTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of regional disk types available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionDisks.html b/docs/dyn/compute_v1.regionDisks.html index 51c474cd3f..29182cb046 100644 --- a/docs/dyn/compute_v1.regionDisks.html +++ b/docs/dyn/compute_v1.regionDisks.html @@ -102,7 +102,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of persistent disks contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)

@@ -4146,17 +4146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionHealthAggregationPolicies.html b/docs/dyn/compute_v1.regionHealthAggregationPolicies.html index a76ab03c38..5a91126416 100644 --- a/docs/dyn/compute_v1.regionHealthAggregationPolicies.html +++ b/docs/dyn/compute_v1.regionHealthAggregationPolicies.html @@ -78,7 +78,7 @@

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(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthAggregationPolicy, body=None, requestId=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1307,17 +1307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionHealthCheckServices.html b/docs/dyn/compute_v1.regionHealthCheckServices.html index 57283b7ff9..4c918681a1 100644 --- a/docs/dyn/compute_v1.regionHealthCheckServices.html +++ b/docs/dyn/compute_v1.regionHealthCheckServices.html @@ -78,7 +78,7 @@

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 HealthCheckService resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the HealthCheckService resources that have been

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheckService, body=None, requestId=None, x__xgafv=None)

@@ -348,17 +348,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1318,17 +1318,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionHealthChecks.html b/docs/dyn/compute_v1.regionHealthChecks.html index b05a5a8a63..daeccab1dd 100644 --- a/docs/dyn/compute_v1.regionHealthChecks.html +++ b/docs/dyn/compute_v1.regionHealthChecks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of HealthCheck resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthCheck, body=None, requestId=None, x__xgafv=None)

@@ -1920,17 +1920,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionHealthSources.html b/docs/dyn/compute_v1.regionHealthSources.html index 93f70692b9..083c33117f 100644 --- a/docs/dyn/compute_v1.regionHealthSources.html +++ b/docs/dyn/compute_v1.regionHealthSources.html @@ -78,7 +78,7 @@

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 HealthSource resources (all

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the HealthSources for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, healthSource, body=None, requestId=None, x__xgafv=None)

@@ -336,17 +336,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1300,17 +1300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionInstanceGroupManagerResizeRequests.html b/docs/dyn/compute_v1.regionInstanceGroupManagerResizeRequests.html index 02eda37161..694c62b729 100644 --- a/docs/dyn/compute_v1.regionInstanceGroupManagerResizeRequests.html +++ b/docs/dyn/compute_v1.regionInstanceGroupManagerResizeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Resize Requests that are contained in the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2168,17 +2168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionInstanceGroupManagers.html b/docs/dyn/compute_v1.regionInstanceGroupManagers.html index b8b7403aa7..a4d739611b 100644 --- a/docs/dyn/compute_v1.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_v1.regionInstanceGroupManagers.html @@ -108,22 +108,22 @@

Instance Methods

listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all errors thrown by actions on instances for a given regional

- listErrors_next(previous_request, previous_response)

+ listErrors_next()

Retrieves the next page of results.

listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the managed instance group and instances that are

- listManagedInstances_next(previous_request, previous_response)

+ listManagedInstances_next()

Retrieves the next page of results.

listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all of the per-instance configurations defined for the managed

- listPerInstanceConfigs_next(previous_request, previous_response)

+ listPerInstanceConfigs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

@@ -6400,17 +6400,17 @@

Method Details

- listErrors_next(previous_request, previous_response) + listErrors_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)
+        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.
-
+ 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. +
@@ -7279,17 +7279,17 @@

Method Details

- listManagedInstances_next(previous_request, previous_response) + listManagedInstances_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)
+        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.
-
+ 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. +
@@ -7495,31 +7495,31 @@

Method Details

- listPerInstanceConfigs_next(previous_request, previous_response) + listPerInstanceConfigs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionInstanceGroups.html b/docs/dyn/compute_v1.regionInstanceGroups.html index b2e60a2f30..16f2be95b2 100644 --- a/docs/dyn/compute_v1.regionInstanceGroups.html +++ b/docs/dyn/compute_v1.regionInstanceGroups.html @@ -87,10 +87,10 @@

Instance Methods

listInstances(project, region, instanceGroup, body=None, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the instances in the specified instance group and displays

- listInstances_next(previous_request, previous_response)

+ listInstances_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setNamedPorts(project, region, instanceGroup, body=None, requestId=None, x__xgafv=None)

@@ -544,31 +544,31 @@

Method Details

- listInstances_next(previous_request, previous_response) + listInstances_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionInstanceTemplates.html b/docs/dyn/compute_v1.regionInstanceTemplates.html index 58f4689f6c..3ae59bdc96 100644 --- a/docs/dyn/compute_v1.regionInstanceTemplates.html +++ b/docs/dyn/compute_v1.regionInstanceTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of instance templates that are contained within the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -3941,17 +3941,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionInstantSnapshotGroups.html b/docs/dyn/compute_v1.regionInstantSnapshotGroups.html index bc97e2776d..12e5398231 100644 --- a/docs/dyn/compute_v1.regionInstantSnapshotGroups.html +++ b/docs/dyn/compute_v1.regionInstantSnapshotGroups.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

retrieves the list of InstantSnapshotGroup resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1362,17 +1362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionInstantSnapshots.html b/docs/dyn/compute_v1.regionInstantSnapshots.html index ffcd8f3424..a8eee05006 100644 --- a/docs/dyn/compute_v1.regionInstantSnapshots.html +++ b/docs/dyn/compute_v1.regionInstantSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of InstantSnapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -1536,17 +1536,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionNetworkEndpointGroups.html b/docs/dyn/compute_v1.regionNetworkEndpointGroups.html index b1c0d8a073..398c8102af 100644 --- a/docs/dyn/compute_v1.regionNetworkEndpointGroups.html +++ b/docs/dyn/compute_v1.regionNetworkEndpointGroups.html @@ -99,10 +99,10 @@

Instance Methods

listNetworkEndpoints(project, region, networkEndpointGroup, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the network endpoints in the specified network endpoint group.

- listNetworkEndpoints_next(previous_request, previous_response)

+ listNetworkEndpoints_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2296,31 +2296,31 @@

Method Details

- listNetworkEndpoints_next(previous_request, previous_response) + listNetworkEndpoints_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionNetworkFirewallPolicies.html b/docs/dyn/compute_v1.regionNetworkFirewallPolicies.html index 5c840afb6a..a78df264a5 100644 --- a/docs/dyn/compute_v1.regionNetworkFirewallPolicies.html +++ b/docs/dyn/compute_v1.regionNetworkFirewallPolicies.html @@ -111,7 +111,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all the network firewall policies that have been configured

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, firewallPolicy, body=None, requestId=None, x__xgafv=None)

@@ -4573,17 +4573,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionNotificationEndpoints.html b/docs/dyn/compute_v1.regionNotificationEndpoints.html index a0bccfc47d..d5c93627b4 100644 --- a/docs/dyn/compute_v1.regionNotificationEndpoints.html +++ b/docs/dyn/compute_v1.regionNotificationEndpoints.html @@ -78,7 +78,7 @@

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 NotificationEndpoint resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the NotificationEndpoints for a project in the given region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, region, resource, body=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1300,17 +1300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionOperations.html b/docs/dyn/compute_v1.regionOperations.html index 8caa0cf321..f339ba9a12 100644 --- a/docs/dyn/compute_v1.regionOperations.html +++ b/docs/dyn/compute_v1.regionOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, region, operation, x__xgafv=None)

@@ -821,17 +821,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionSecurityPolicies.html b/docs/dyn/compute_v1.regionSecurityPolicies.html index 17d51a1308..7de4b09fbf 100644 --- a/docs/dyn/compute_v1.regionSecurityPolicies.html +++ b/docs/dyn/compute_v1.regionSecurityPolicies.html @@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

List all the policies that have been configured for the specified project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -3972,17 +3972,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionSnapshots.html b/docs/dyn/compute_v1.regionSnapshots.html index b9d1df9d1f..ee59bda197 100644 --- a/docs/dyn/compute_v1.regionSnapshots.html +++ b/docs/dyn/compute_v1.regionSnapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, region, resource, body=None, x__xgafv=None)

@@ -2260,17 +2260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionSslCertificates.html b/docs/dyn/compute_v1.regionSslCertificates.html index 9295333b14..3668176043 100644 --- a/docs/dyn/compute_v1.regionSslCertificates.html +++ b/docs/dyn/compute_v1.regionSslCertificates.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1121,17 +1121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionSslPolicies.html b/docs/dyn/compute_v1.regionSslPolicies.html index 46fb30837d..0dd0e51403 100644 --- a/docs/dyn/compute_v1.regionSslPolicies.html +++ b/docs/dyn/compute_v1.regionSslPolicies.html @@ -93,7 +93,7 @@

Instance Methods

listAvailableFeatures(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1229,17 +1229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionTargetHttpProxies.html b/docs/dyn/compute_v1.regionTargetHttpProxies.html index d3bd5639cb..91126934c8 100644 --- a/docs/dyn/compute_v1.regionTargetHttpProxies.html +++ b/docs/dyn/compute_v1.regionTargetHttpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setUrlMap(project, region, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -1069,17 +1069,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionTargetHttpsProxies.html b/docs/dyn/compute_v1.regionTargetHttpsProxies.html index 91210566b7..c2ba2f3824 100644 --- a/docs/dyn/compute_v1.regionTargetHttpsProxies.html +++ b/docs/dyn/compute_v1.regionTargetHttpsProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -1363,17 +1363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionTargetTcpProxies.html b/docs/dyn/compute_v1.regionTargetTcpProxies.html index 53da805d76..d664fd35eb 100644 --- a/docs/dyn/compute_v1.regionTargetTcpProxies.html +++ b/docs/dyn/compute_v1.regionTargetTcpProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -987,17 +987,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regionUrlMaps.html b/docs/dyn/compute_v1.regionUrlMaps.html index 5764628da8..ae57f988ab 100644 --- a/docs/dyn/compute_v1.regionUrlMaps.html +++ b/docs/dyn/compute_v1.regionUrlMaps.html @@ -90,7 +90,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -11831,17 +11831,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.regionZones.html b/docs/dyn/compute_v1.regionZones.html index af9e1ed5e2..43b2d8cb96 100644 --- a/docs/dyn/compute_v1.regionZones.html +++ b/docs/dyn/compute_v1.regionZones.html @@ -81,7 +81,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources under the specific region available to

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -378,17 +378,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.regions.html b/docs/dyn/compute_v1.regions.html index ec1f9101e4..f4d1b35df8 100644 --- a/docs/dyn/compute_v1.regions.html +++ b/docs/dyn/compute_v1.regions.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of region resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -436,17 +436,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.reliabilityRisks.html b/docs/dyn/compute_v1.reliabilityRisks.html index 1202c89717..2f9b3406e4 100644 --- a/docs/dyn/compute_v1.reliabilityRisks.html +++ b/docs/dyn/compute_v1.reliabilityRisks.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of reliabilityRisks available in the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -312,17 +312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.reservationBlocks.html b/docs/dyn/compute_v1.reservationBlocks.html index aab831e9d9..45e1df61a5 100644 --- a/docs/dyn/compute_v1.reservationBlocks.html +++ b/docs/dyn/compute_v1.reservationBlocks.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, reservation, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation blocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, reservationBlock, body=None, requestId=None, x__xgafv=None)

@@ -792,17 +792,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.reservationSlots.html b/docs/dyn/compute_v1.reservationSlots.html index 55ac5c5d05..fc9520b1fc 100644 --- a/docs/dyn/compute_v1.reservationSlots.html +++ b/docs/dyn/compute_v1.reservationSlots.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation slots under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, parentName, reservationSlot, body=None, updateMask=None, x__xgafv=None)

@@ -965,17 +965,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.reservationSubBlocks.html b/docs/dyn/compute_v1.reservationSubBlocks.html index dc0f50300e..882fe5d4f6 100644 --- a/docs/dyn/compute_v1.reservationSubBlocks.html +++ b/docs/dyn/compute_v1.reservationSubBlocks.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of reservation subBlocks under a single reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)

@@ -1121,17 +1121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.reservations.html b/docs/dyn/compute_v1.reservations.html index e91211a233..50ad57cc39 100644 --- a/docs/dyn/compute_v1.reservations.html +++ b/docs/dyn/compute_v1.reservations.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of reservations.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list of all the reservations that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenance(project, zone, reservation, body=None, requestId=None, x__xgafv=None)

@@ -536,17 +536,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2405,17 +2405,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.resourcePolicies.html b/docs/dyn/compute_v1.resourcePolicies.html index 2b102061a1..664a8b6d06 100644 --- a/docs/dyn/compute_v1.resourcePolicies.html +++ b/docs/dyn/compute_v1.resourcePolicies.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of resource policies.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

A list all the resource policies that have been configured for the

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, resourcePolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -425,17 +425,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1975,17 +1975,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.rolloutPlans.html b/docs/dyn/compute_v1.rolloutPlans.html index fcc2f7b6ab..960ebfb44e 100644 --- a/docs/dyn/compute_v1.rolloutPlans.html +++ b/docs/dyn/compute_v1.rolloutPlans.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists RolloutPlans in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1150,17 +1150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.rollouts.html b/docs/dyn/compute_v1.rollouts.html index 62bb3cdbea..70e753afb1 100644 --- a/docs/dyn/compute_v1.rollouts.html +++ b/docs/dyn/compute_v1.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Rollouts in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(project, rollout, etag=None, requestId=None, x__xgafv=None)

@@ -1349,17 +1349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.routers.html b/docs/dyn/compute_v1.routers.html index 47638b43a2..7fc263c902 100644 --- a/docs/dyn/compute_v1.routers.html +++ b/docs/dyn/compute_v1.routers.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of routers.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

getNatMappingInfo(project, region, router, filter=None, maxResults=None, natName=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves runtime Nat mapping information of VM endpoints.

- getNatMappingInfo_next(previous_request, previous_response)

+ getNatMappingInfo_next()

Retrieves the next page of results.

getRoutePolicy(project, region, router, policy=None, x__xgafv=None)

@@ -123,22 +123,22 @@

Instance Methods

listBgpRoutes(project, region, router, addressFamily=None, destinationPrefix=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peer=None, policyApplied=None, returnPartialSuccess=None, routeType=None, x__xgafv=None)

Retrieves a list of router bgp routes available to the specified project.

- listBgpRoutes_next(previous_request, previous_response)

+ 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(previous_request, previous_response)

+ 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

- listRoutePolicies_next(previous_request, previous_response)

+ listRoutePolicies_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, router, body=None, requestId=None, x__xgafv=None)

@@ -858,17 +858,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2640,17 +2640,17 @@

Method Details

- getNatMappingInfo_next(previous_request, previous_response) + getNatMappingInfo_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)
+        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.
-
+ 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. +
@@ -5157,17 +5157,17 @@

Method Details

- listBgpRoutes_next(previous_request, previous_response) + listBgpRoutes_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)
+        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.
-
+ 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. +
@@ -5375,17 +5375,17 @@

Method Details

- listNamedSets_next(previous_request, previous_response) + listNamedSets_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)
+        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.
-
+ 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. +
@@ -5643,31 +5643,31 @@

Method Details

- listRoutePolicies_next(previous_request, previous_response) + 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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.routes.html b/docs/dyn/compute_v1.routes.html index cfb5c99d48..6add722d20 100644 --- a/docs/dyn/compute_v1.routes.html +++ b/docs/dyn/compute_v1.routes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Route resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(project, resource, body=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.securityPolicies.html b/docs/dyn/compute_v1.securityPolicies.html index cfb4103d47..1a4d9ff55c 100644 --- a/docs/dyn/compute_v1.securityPolicies.html +++ b/docs/dyn/compute_v1.securityPolicies.html @@ -81,7 +81,7 @@

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 SecurityPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

listPreconfiguredExpressionSets(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Gets the current list of preconfigured Web Application Firewall (WAF)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, securityPolicy, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1663,17 +1663,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -4953,17 +4953,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.serviceAttachments.html b/docs/dyn/compute_v1.serviceAttachments.html index ab7505aec9..6876da35fc 100644 --- a/docs/dyn/compute_v1.serviceAttachments.html +++ b/docs/dyn/compute_v1.serviceAttachments.html @@ -78,7 +78,7 @@

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 ServiceAttachment resources,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the ServiceAttachments for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, serviceAttachment, body=None, requestId=None, x__xgafv=None)

@@ -422,17 +422,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1962,17 +1962,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.snapshots.html b/docs/dyn/compute_v1.snapshots.html index 25be7d18c5..b6dfdf466c 100644 --- a/docs/dyn/compute_v1.snapshots.html +++ b/docs/dyn/compute_v1.snapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Snapshot resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, resource, body=None, x__xgafv=None)

@@ -2258,17 +2258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.sslCertificates.html b/docs/dyn/compute_v1.sslCertificates.html index 9c2ab34a3b..418b3186ec 100644 --- a/docs/dyn/compute_v1.sslCertificates.html +++ b/docs/dyn/compute_v1.sslCertificates.html @@ -78,7 +78,7 @@

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 SslCertificate resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of SslCertificate resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -367,17 +367,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1402,17 +1402,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.sslPolicies.html b/docs/dyn/compute_v1.sslPolicies.html index 5b99276127..96f891fb10 100644 --- a/docs/dyn/compute_v1.sslPolicies.html +++ b/docs/dyn/compute_v1.sslPolicies.html @@ -78,7 +78,7 @@

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 SslPolicy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

listAvailableFeatures(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all features that can be specified in the SSL policy when using

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, sslPolicy, body=None, requestId=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1508,17 +1508,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.storagePoolTypes.html b/docs/dyn/compute_v1.storagePoolTypes.html index 734700064c..587625a101 100644 --- a/docs/dyn/compute_v1.storagePoolTypes.html +++ b/docs/dyn/compute_v1.storagePoolTypes.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pool types.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of storage pool types available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -319,17 +319,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -588,17 +588,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/compute_v1.storagePools.html b/docs/dyn/compute_v1.storagePools.html index a492d04edb..0e975597f3 100644 --- a/docs/dyn/compute_v1.storagePools.html +++ b/docs/dyn/compute_v1.storagePools.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of storage pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -102,10 +102,10 @@

Instance Methods

listDisks(project, zone, storagePool, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the disks in a specified storage pool.

- listDisks_next(previous_request, previous_response)

+ listDisks_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(project, zone, resource, body=None, x__xgafv=None)

@@ -435,17 +435,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2167,31 +2167,31 @@

Method Details

- listDisks_next(previous_request, previous_response) + listDisks_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.subnetworks.html b/docs/dyn/compute_v1.subnetworks.html index e2b3602de7..7fe96a7c76 100644 --- a/docs/dyn/compute_v1.subnetworks.html +++ b/docs/dyn/compute_v1.subnetworks.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, views=None, x__xgafv=None)

Retrieves an aggregated list of subnetworks.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,10 +105,10 @@

Instance Methods

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProject=None, x__xgafv=None)

Retrieves an aggregated list of all usable subnetworks in the project.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, region, subnetwork, body=None, drainTimeoutSeconds=None, requestId=None, x__xgafv=None)

@@ -575,17 +575,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -3056,31 +3056,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetGrpcProxies.html b/docs/dyn/compute_v1.targetGrpcProxies.html index c76d97139a..0df76f8190 100644 --- a/docs/dyn/compute_v1.targetGrpcProxies.html +++ b/docs/dyn/compute_v1.targetGrpcProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the TargetGrpcProxies for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetGrpcProxy, body=None, requestId=None, x__xgafv=None)

@@ -997,17 +997,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetHttpProxies.html b/docs/dyn/compute_v1.targetHttpProxies.html index fd8ee9cd15..fe655d2296 100644 --- a/docs/dyn/compute_v1.targetHttpProxies.html +++ b/docs/dyn/compute_v1.targetHttpProxies.html @@ -78,7 +78,7 @@

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 TargetHttpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpProxy resources available

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpProxy, body=None, requestId=None, x__xgafv=None)

@@ -330,17 +330,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1312,17 +1312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetHttpsProxies.html b/docs/dyn/compute_v1.targetHttpsProxies.html index 5d65442dbf..f6bcb17fe9 100644 --- a/docs/dyn/compute_v1.targetHttpsProxies.html +++ b/docs/dyn/compute_v1.targetHttpsProxies.html @@ -78,7 +78,7 @@

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 TargetHttpsProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetHttpsProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, targetHttpsProxy, body=None, requestId=None, x__xgafv=None)

@@ -463,17 +463,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1733,17 +1733,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetInstances.html b/docs/dyn/compute_v1.targetInstances.html index 2c71e75b31..736d5b47a8 100644 --- a/docs/dyn/compute_v1.targetInstances.html +++ b/docs/dyn/compute_v1.targetInstances.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target instances.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of TargetInstance resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setSecurityPolicy(project, zone, targetInstance, body=None, requestId=None, x__xgafv=None)

@@ -329,17 +329,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1242,17 +1242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetPools.html b/docs/dyn/compute_v1.targetPools.html index e15d85a6a6..3aaa51ee6e 100644 --- a/docs/dyn/compute_v1.targetPools.html +++ b/docs/dyn/compute_v1.targetPools.html @@ -84,7 +84,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target pools.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -105,7 +105,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target pools available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeHealthCheck(project, region, targetPool, body=None, requestId=None, x__xgafv=None)

@@ -1021,17 +1021,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2083,17 +2083,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetSslProxies.html b/docs/dyn/compute_v1.targetSslProxies.html index c2e424f2f1..81e0f16564 100644 --- a/docs/dyn/compute_v1.targetSslProxies.html +++ b/docs/dyn/compute_v1.targetSslProxies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetSslProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetSslProxy, body=None, requestId=None, x__xgafv=None)

@@ -1007,17 +1007,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetTcpProxies.html b/docs/dyn/compute_v1.targetTcpProxies.html index b8be787358..eb063efe7f 100644 --- a/docs/dyn/compute_v1.targetTcpProxies.html +++ b/docs/dyn/compute_v1.targetTcpProxies.html @@ -78,7 +78,7 @@

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 TargetTcpProxy resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of TargetTcpProxy resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setBackendService(project, targetTcpProxy, body=None, requestId=None, x__xgafv=None)

@@ -332,17 +332,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1235,17 +1235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.targetVpnGateways.html b/docs/dyn/compute_v1.targetVpnGateways.html index d9787cd8bf..096604dbdf 100644 --- a/docs/dyn/compute_v1.targetVpnGateways.html +++ b/docs/dyn/compute_v1.targetVpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of target VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of target VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -354,17 +354,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1351,17 +1351,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.urlMaps.html b/docs/dyn/compute_v1.urlMaps.html index 8daff27c78..99f4645171 100644 --- a/docs/dyn/compute_v1.urlMaps.html +++ b/docs/dyn/compute_v1.urlMaps.html @@ -78,7 +78,7 @@

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 UrlMap resources, regional and global,

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of UrlMap resources available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, urlMap, body=None, requestId=None, x__xgafv=None)

@@ -3956,17 +3956,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -16046,17 +16046,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.vpnGateways.html b/docs/dyn/compute_v1.vpnGateways.html index dd263c01fe..dc4f718d36 100644 --- a/docs/dyn/compute_v1.vpnGateways.html +++ b/docs/dyn/compute_v1.vpnGateways.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN gateways.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -99,7 +99,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VPN gateways available to the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1486,17 +1486,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.vpnTunnels.html b/docs/dyn/compute_v1.vpnTunnels.html index 6c53c85226..e6a221feb4 100644 --- a/docs/dyn/compute_v1.vpnTunnels.html +++ b/docs/dyn/compute_v1.vpnTunnels.html @@ -78,7 +78,7 @@

Instance Methods

aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

Retrieves an aggregated list of VPN tunnels.

- aggregatedList_next(previous_request, previous_response)

+ aggregatedList_next()

Retrieves the next page of results.

close()

@@ -96,7 +96,7 @@

Instance Methods

list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of VpnTunnel resources contained in the specified

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)

@@ -449,17 +449,17 @@

Method Details

- aggregatedList_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1729,17 +1729,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.wireGroups.html b/docs/dyn/compute_v1.wireGroups.html index dd60c4bf50..e70ee47135 100644 --- a/docs/dyn/compute_v1.wireGroups.html +++ b/docs/dyn/compute_v1.wireGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(project, crossSiteNetwork, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the wire groups for a project in the given scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, crossSiteNetwork, wireGroup, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1300,17 +1300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.zoneOperations.html b/docs/dyn/compute_v1.zoneOperations.html index 05f9e33df1..865c2db570 100644 --- a/docs/dyn/compute_v1.zoneOperations.html +++ b/docs/dyn/compute_v1.zoneOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of Operation resources contained within

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(project, zone, operation, x__xgafv=None)

@@ -821,17 +821,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.zoneVmExtensionPolicies.html b/docs/dyn/compute_v1.zoneVmExtensionPolicies.html index da8e9ad059..fcf80fcd60 100644 --- a/docs/dyn/compute_v1.zoneVmExtensionPolicies.html +++ b/docs/dyn/compute_v1.zoneVmExtensionPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all VM extension policies within a specific zone for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(project, zone, vmExtensionPolicy, body=None, requestId=None, x__xgafv=None)

@@ -1052,17 +1052,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/compute_v1.zones.html b/docs/dyn/compute_v1.zones.html index 3d62a1749c..3a5f5f6664 100644 --- a/docs/dyn/compute_v1.zones.html +++ b/docs/dyn/compute_v1.zones.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves the list of Zone resources available to the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -546,17 +546,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.html b/docs/dyn/config_v1.html index 3eafd8095f..4a5f5efeed 100644 --- a/docs/dyn/config_v1.html +++ b/docs/dyn/config_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/config_v1.projects.locations.deploymentGroups.html b/docs/dyn/config_v1.projects.locations.deploymentGroups.html index e6b0bb8fd2..81d23206b6 100644 --- a/docs/dyn/config_v1.projects.locations.deploymentGroups.html +++ b/docs/dyn/config_v1.projects.locations.deploymentGroups.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List DeploymentGroups for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/config_v1.projects.locations.deploymentGroups.revisions.html b/docs/dyn/config_v1.projects.locations.deploymentGroups.revisions.html index 494d8864bc..105096d77a 100644 --- a/docs/dyn/config_v1.projects.locations.deploymentGroups.revisions.html +++ b/docs/dyn/config_v1.projects.locations.deploymentGroups.revisions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeploymentGroupRevisions in a given DeploymentGroup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.deployments.html b/docs/dyn/config_v1.projects.locations.deployments.html index efdc3e9806..8d5b2190a5 100644 --- a/docs/dyn/config_v1.projects.locations.deployments.html +++ b/docs/dyn/config_v1.projects.locations.deployments.html @@ -110,7 +110,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Deployments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lock(name, body=None, x__xgafv=None)

@@ -638,17 +638,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/config_v1.projects.locations.deployments.revisions.html b/docs/dyn/config_v1.projects.locations.deployments.revisions.html index 1559b8d2e1..48a703fecc 100644 --- a/docs/dyn/config_v1.projects.locations.deployments.revisions.html +++ b/docs/dyn/config_v1.projects.locations.deployments.revisions.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Revisions of a deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -308,17 +308,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.deployments.revisions.resources.html b/docs/dyn/config_v1.projects.locations.deployments.revisions.resources.html index 1955c2534d..789f447b43 100644 --- a/docs/dyn/config_v1.projects.locations.deployments.revisions.resources.html +++ b/docs/dyn/config_v1.projects.locations.deployments.revisions.resources.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Resources in a given revision.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.html b/docs/dyn/config_v1.projects.locations.html index 5d28b78f4a..94bfb32fdc 100644 --- a/docs/dyn/config_v1.projects.locations.html +++ b/docs/dyn/config_v1.projects.locations.html @@ -112,7 +112,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateAutoMigrationConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/config_v1.projects.locations.operations.html b/docs/dyn/config_v1.projects.locations.operations.html index f8af712d7e..ed1b640f67 100644 --- a/docs/dyn/config_v1.projects.locations.operations.html +++ b/docs/dyn/config_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.previews.html b/docs/dyn/config_v1.projects.locations.previews.html index b3e13b2709..2e868a88e6 100644 --- a/docs/dyn/config_v1.projects.locations.previews.html +++ b/docs/dyn/config_v1.projects.locations.previews.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Previews in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -486,17 +486,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.previews.resourceChanges.html b/docs/dyn/config_v1.projects.locations.previews.resourceChanges.html index d10f2c1ad0..35dfef3752 100644 --- a/docs/dyn/config_v1.projects.locations.previews.resourceChanges.html +++ b/docs/dyn/config_v1.projects.locations.previews.resourceChanges.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ResourceChanges for a given preview.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -189,17 +189,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.previews.resourceDrifts.html b/docs/dyn/config_v1.projects.locations.previews.resourceDrifts.html index 0b2bc18313..b8ee51660e 100644 --- a/docs/dyn/config_v1.projects.locations.previews.resourceDrifts.html +++ b/docs/dyn/config_v1.projects.locations.previews.resourceDrifts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List ResourceDrifts for a given preview.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/config_v1.projects.locations.terraformVersions.html b/docs/dyn/config_v1.projects.locations.terraformVersions.html index dbde8ab48a..b39c4fb73a 100644 --- a/docs/dyn/config_v1.projects.locations.terraformVersions.html +++ b/docs/dyn/config_v1.projects.locations.terraformVersions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TerraformVersions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.html b/docs/dyn/connectors_v1.html index 7fae3f6c19..d9933522f6 100644 --- a/docs/dyn/connectors_v1.html +++ b/docs/dyn/connectors_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/connectors_v1.projects.locations.connections.connectionSchemaMetadata.html b/docs/dyn/connectors_v1.projects.locations.connections.connectionSchemaMetadata.html index 0b50d25c03..8ebc985bd6 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.connectionSchemaMetadata.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.connectionSchemaMetadata.html @@ -87,13 +87,13 @@

Instance Methods

listActions(name, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List actions.

- listActions_next(previous_request, previous_response)

+ listActions_next()

Retrieves the next page of results.

listEntityTypes(name, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List entity types.

- listEntityTypes_next(previous_request, previous_response)

+ listEntityTypes_next()

Retrieves the next page of results.

refresh(name, body=None, x__xgafv=None)

@@ -538,17 +538,17 @@

Method Details

- listActions_next(previous_request, previous_response) + listActions_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)
+        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.
-
+ 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. +
@@ -754,17 +754,17 @@

Method Details

- listEntityTypes_next(previous_request, previous_response) + listEntityTypes_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.connections.endUserAuthentications.html b/docs/dyn/connectors_v1.projects.locations.connections.endUserAuthentications.html index c1be2149bb..a150da383c 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.endUserAuthentications.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.endUserAuthentications.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List EndUserAuthentications in a given project,location and connection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -682,17 +682,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.connections.eventSubscriptions.html b/docs/dyn/connectors_v1.projects.locations.connections.eventSubscriptions.html index 8685200dd4..b13fa72c3f 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.eventSubscriptions.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.eventSubscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List EventSubscriptions in a given project,location and connection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -425,17 +425,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.connections.html b/docs/dyn/connectors_v1.projects.locations.connections.html index c145cfb1b2..a5aeb26559 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.html @@ -127,7 +127,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Connections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

listenEvent(resourcePath, body=None, x__xgafv=None)

@@ -148,7 +148,7 @@

Instance Methods

search(name, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Returns Top matching Connections for a given query.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -2225,17 +2225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -4133,17 +4133,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.connections.runtimeActionSchemas.html b/docs/dyn/connectors_v1.projects.locations.connections.runtimeActionSchemas.html index d8a9988995..40edd6665f 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.runtimeActionSchemas.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.runtimeActionSchemas.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, schemaAsString=None, x__xgafv=None)

List schema of a runtime actions filtered by action name.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.connections.runtimeEntitySchemas.html b/docs/dyn/connectors_v1.projects.locations.connections.runtimeEntitySchemas.html index eb46587416..a8b72a0c5b 100644 --- a/docs/dyn/connectors_v1.projects.locations.connections.runtimeEntitySchemas.html +++ b/docs/dyn/connectors_v1.projects.locations.connections.runtimeEntitySchemas.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List schema of a runtime entities filtered by entity name.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.endpointAttachments.html b/docs/dyn/connectors_v1.projects.locations.endpointAttachments.html index 117fa6e8ee..e4efe3c0bc 100644 --- a/docs/dyn/connectors_v1.projects.locations.endpointAttachments.html +++ b/docs/dyn/connectors_v1.projects.locations.endpointAttachments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List EndpointAttachments in a given project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.customConnectorVersions.html b/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.customConnectorVersions.html index 16e304e18e..74c86c06e4 100644 --- a/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.customConnectorVersions.html +++ b/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.customConnectorVersions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List CustomConnectorVersions in a given project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1003,17 +1003,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.global_.customConnectors.html b/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.html index 0510db0524..414554faca 100644 --- a/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.html +++ b/docs/dyn/connectors_v1.projects.locations.global_.customConnectors.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List CustomConnectorVersions in a given project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.global_.managedZones.html b/docs/dyn/connectors_v1.projects.locations.global_.managedZones.html index 5cbdae5ca8..3c777d14f8 100644 --- a/docs/dyn/connectors_v1.projects.locations.global_.managedZones.html +++ b/docs/dyn/connectors_v1.projects.locations.global_.managedZones.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

List ManagedZones in a given project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.html b/docs/dyn/connectors_v1.projects.locations.html index 9ac369e9a5..d406acc708 100644 --- a/docs/dyn/connectors_v1.projects.locations.html +++ b/docs/dyn/connectors_v1.projects.locations.html @@ -120,7 +120,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateRegionalSettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v1.projects.locations.operations.html b/docs/dyn/connectors_v1.projects.locations.operations.html index 2a3538ce74..25acf25b03 100644 --- a/docs/dyn/connectors_v1.projects.locations.operations.html +++ b/docs/dyn/connectors_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.providers.connectors.html b/docs/dyn/connectors_v1.projects.locations.providers.connectors.html index 1b35ca30b3..26a65c0445 100644 --- a/docs/dyn/connectors_v1.projects.locations.providers.connectors.html +++ b/docs/dyn/connectors_v1.projects.locations.providers.connectors.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.providers.connectors.versions.eventtypes.html b/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.eventtypes.html index bb63b9cd24..88b5674427 100644 --- a/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.eventtypes.html +++ b/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.eventtypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Event Types in a given Connector Version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.providers.connectors.versions.html b/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.html index 6c22d4f5a7..a675602de4 100644 --- a/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.html +++ b/docs/dyn/connectors_v1.projects.locations.providers.connectors.versions.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Connector Versions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1928,17 +1928,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v1.projects.locations.providers.html b/docs/dyn/connectors_v1.projects.locations.providers.html index 49cc3568da..af81317842 100644 --- a/docs/dyn/connectors_v1.projects.locations.providers.html +++ b/docs/dyn/connectors_v1.projects.locations.providers.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Providers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v2.html b/docs/dyn/connectors_v2.html index e43e089c27..e20cd346a8 100644 --- a/docs/dyn/connectors_v2.html +++ b/docs/dyn/connectors_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/connectors_v2.projects.locations.connections.actions.html b/docs/dyn/connectors_v2.projects.locations.connections.actions.html index 7f1ca25dd4..9e90be0bc3 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.actions.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.actions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Gets the schema of all the actions supported by the connector.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -873,17 +873,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v2.projects.locations.connections.entityTypes.entities.html b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.entities.html index ffdb1ffabb..af1ad64bf2 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.entities.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.entities.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, conditions=None, executionConfig_headers=None, pageSize=None, pageToken=None, sortBy=None, sortOrder=None, x__xgafv=None)

Lists entity rows of a particular entity type contained in the request. Note: 1. Currently, only max of one 'sort_by' column is supported. 2. If no 'sort_by' column is provided, the primary key of the table is used. If zero or more than one primary key is available, we default to the unpaginated list entities logic which only returns the first page. 3. The values of the 'sort_by' columns must uniquely identify an entity row, otherwise undefined behaviors may be observed during pagination. 4. Since transactions are not supported, any updates, inserts or deletes during pagination can lead to stale data being returned or other unexpected behaviors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, executionConfig_headers=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html index e8ab935671..f9b36ab5ab 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists metadata related to all entity types present in the external system.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -524,17 +524,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v2.projects.locations.connections.html b/docs/dyn/connectors_v2.projects.locations.connections.html index 38543c9911..190357767e 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.html @@ -122,7 +122,7 @@

Instance Methods

refreshAccessToken(name, body=None, x__xgafv=None)

RefreshAccessToken exchanges the OAuth refresh token (and other necessary data) for a new access token (and new associated credentials).

- tools_next(previous_request, previous_response)

+ tools_next()

Retrieves the next page of results.

Method Details

@@ -415,17 +415,17 @@

Method Details

- tools_next(previous_request, previous_response) + tools_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)
+        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.
-
+ 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/connectors_v2.projects.locations.connections.resources.html b/docs/dyn/connectors_v2.projects.locations.connections.resources.html index b7e5b4383a..e47af6c36e 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.resources.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.resources.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all available resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/connectors_v2.projects.locations.connections.tools.html b/docs/dyn/connectors_v2.projects.locations.connections.tools.html index 7ba797a4e4..70eba3dd41 100644 --- a/docs/dyn/connectors_v2.projects.locations.connections.tools.html +++ b/docs/dyn/connectors_v2.projects.locations.connections.tools.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, toolNames=None, x__xgafv=None)

Lists all available tools.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -338,17 +338,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenteraiplatform_v1alpha1.html b/docs/dyn/contactcenteraiplatform_v1alpha1.html index 9e06756080..9a33b8695c 100644 --- a/docs/dyn/contactcenteraiplatform_v1alpha1.html +++ b/docs/dyn/contactcenteraiplatform_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.contactCenters.html b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.contactCenters.html index ea2ea8d8b2..a3d88c1661 100644 --- a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.contactCenters.html +++ b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.contactCenters.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ContactCenters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -523,17 +523,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.html b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.html index 02ddfbf4f1..3c51a9a7ad 100644 --- a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.html +++ b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.html @@ -97,7 +97,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

queryContactCenterQuota(parent, x__xgafv=None)

@@ -350,17 +350,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.operations.html b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.operations.html index 83e1f827c9..b663d2aab6 100644 --- a/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/contactcenteraiplatform_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenterinsights_v1.html b/docs/dyn/contactcenterinsights_v1.html index 607e72bf62..d093b517d2 100644 --- a/docs/dyn/contactcenterinsights_v1.html +++ b/docs/dyn/contactcenterinsights_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.analysisRules.html b/docs/dyn/contactcenterinsights_v1.projects.locations.analysisRules.html index 8e5dc996af..30641978ca 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.analysisRules.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.analysisRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists analysis rules.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.assessmentRules.html b/docs/dyn/contactcenterinsights_v1.projects.locations.assessmentRules.html index 39978f723b..0384c1f33f 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.assessmentRules.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.assessmentRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists assessment rules.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.assistantSessions.html b/docs/dyn/contactcenterinsights_v1.projects.locations.assistantSessions.html index ed4ca7ddad..207b5ba082 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.assistantSessions.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.assistantSessions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assistant sessions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

streamChat(name, body=None, x__xgafv=None)

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.html index e8eaf2cfb3..fef581ed25 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Assessments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(name, body=None, x__xgafv=None)

@@ -374,17 +374,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.notes.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.notes.html index 5339df82fc..5b9ebaa50e 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.notes.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.assessments.notes.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List Notes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.feedbackLabels.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.feedbackLabels.html index 7e6755b666..ea385f50c2 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.feedbackLabels.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.feedbackLabels.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List feedback labels.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html index ffaf29dba7..ad68ab3744 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists conversations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1458,17 +1458,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html index 026ab67915..e398e50945 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List AuthorizedViewSets

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -121,7 +121,7 @@

Instance Methods

search(parent, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

SearchAuthorizedViewSets

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -576,17 +576,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.operations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.operations.html index 4054f09d9f..2dd93e2654 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.operations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenterinsights_v1.projects.locations.authorizedViewSets.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.html index e69343252e..02b47ea230 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List AuthorizedViewSets

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.autoLabelingRules.html b/docs/dyn/contactcenterinsights_v1.projects.locations.autoLabelingRules.html index 0e04031b3f..902acd691e 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.autoLabelingRules.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.autoLabelingRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists auto labeling rules.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -247,17 +247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.analyses.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.analyses.html index 491ddec5a1..99ea348e4b 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.analyses.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.analyses.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists analyses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -817,17 +817,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenterinsights_v1.projects.locations.conversations.assessments.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.html index bdb5e943b9..962c05a7e2 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Assessments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(name, body=None, x__xgafv=None)

@@ -374,17 +374,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.notes.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.notes.html index 36ebfc1813..b4f287e9f5 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.notes.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.assessments.notes.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List Notes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.feedbackLabels.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.feedbackLabels.html index 2720b4b297..048a881bfc 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.feedbackLabels.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.feedbackLabels.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List feedback labels.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html index adc0a0e511..7501a0f8dd 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html @@ -125,7 +125,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists conversations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, conversationAutoLabelingUpdateConfig_allowAutoLabelingUpdate=None, updateMask=None, x__xgafv=None)

@@ -2895,17 +2895,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html b/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html index 63ac5c4846..6c325bcb66 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Dashboards.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -683,17 +683,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.feedbackLabels.html b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.feedbackLabels.html index 378eff83b8..d504515f4f 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.feedbackLabels.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.feedbackLabels.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List feedback labels.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html index 5cf96c16ad..4600ad60f2 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists conversations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

sample(parent, body=None, x__xgafv=None)

@@ -1582,17 +1582,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.html b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.html index 0572b19596..9024de3292 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.html @@ -112,10 +112,10 @@

Instance Methods

listAllFeedbackLabels(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all feedback labels by project number.

- listAllFeedbackLabels_next(previous_request, previous_response)

+ listAllFeedbackLabels_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,31 +453,31 @@

Method Details

- listAllFeedbackLabels_next(previous_request, previous_response) + listAllFeedbackLabels_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.html index 6cdb04dfb3..d8ca52126d 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.html @@ -182,7 +182,7 @@

Instance Methods

listAllFeedbackLabels(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all feedback labels by project number.

- listAllFeedbackLabels_next(previous_request, previous_response)

+ listAllFeedbackLabels_next()

Retrieves the next page of results.

queryMetrics(location, body=None, x__xgafv=None)

@@ -581,17 +581,17 @@

Method Details

- listAllFeedbackLabels_next(previous_request, previous_response) + listAllFeedbackLabels_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.operations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.operations.html index 0ac7c3e41b..0ad88578eb 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.operations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/contactcenterinsights_v1.projects.locations.phraseMatchers.html b/docs/dyn/contactcenterinsights_v1.projects.locations.phraseMatchers.html index 1f3df95998..1fa21bcf4e 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.phraseMatchers.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.phraseMatchers.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists phrase matchers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -300,17 +300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.html b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.html index a0b7db2436..134fa0426d 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, qaScorecardSources=None, x__xgafv=None)

Lists QaScorecards.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.html b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.html index a01c1d2bc9..2ab4563cf7 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, qaScorecardSources=None, x__xgafv=None)

Lists all revisions under the parent QaScorecard.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

tuneQaScorecardRevision(parent, body=None, x__xgafv=None)

@@ -306,17 +306,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.qaQuestions.html b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.qaQuestions.html index b1d01e36a3..6d75c9bd48 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.qaQuestions.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.qaScorecards.revisions.qaQuestions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists QaQuestions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.views.html b/docs/dyn/contactcenterinsights_v1.projects.locations.views.html index 46fc69a136..03d65f6f95 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.views.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.views.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/container_v1.html b/docs/dyn/container_v1.html index 9f5ac9d66b..8637dcc04b 100644 --- a/docs/dyn/container_v1.html +++ b/docs/dyn/container_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/container_v1.projects.aggregated.usableSubnetworks.html b/docs/dyn/container_v1.projects.aggregated.usableSubnetworks.html index 93ce956115..33a075e155 100644 --- a/docs/dyn/container_v1.projects.aggregated.usableSubnetworks.html +++ b/docs/dyn/container_v1.projects.aggregated.usableSubnetworks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists subnetworks that are usable for creating clusters in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/container_v1beta1.html b/docs/dyn/container_v1beta1.html index e894376753..20f98ff6f4 100644 --- a/docs/dyn/container_v1beta1.html +++ b/docs/dyn/container_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/container_v1beta1.projects.aggregated.usableSubnetworks.html b/docs/dyn/container_v1beta1.projects.aggregated.usableSubnetworks.html index 626a6235b7..1ca9d50799 100644 --- a/docs/dyn/container_v1beta1.projects.aggregated.usableSubnetworks.html +++ b/docs/dyn/container_v1beta1.projects.aggregated.usableSubnetworks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists subnetworks that can be used for creating clusters in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1.html b/docs/dyn/containeranalysis_v1.html index d3f51c2940..dd49fb7ea5 100644 --- a/docs/dyn/containeranalysis_v1.html +++ b/docs/dyn/containeranalysis_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/containeranalysis_v1.projects.locations.notes.html b/docs/dyn/containeranalysis_v1.projects.locations.notes.html index a8b37ccf2b..9f695ed7e8 100644 --- a/docs/dyn/containeranalysis_v1.projects.locations.notes.html +++ b/docs/dyn/containeranalysis_v1.projects.locations.notes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists notes for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2205,17 +2205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html b/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html index 8274e9d870..094cc60d41 100644 --- a/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists occurrences referencing the specified note. Provider projects can use this method to get all occurrences across consumer projects referencing the specified note.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1073,17 +1073,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1.projects.locations.occurrences.html b/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html index af3a52297f..671c0ec1ae 100644 --- a/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists occurrences for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -6396,17 +6396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1.projects.notes.html b/docs/dyn/containeranalysis_v1.projects.notes.html index 5e05f2a7c4..aaeec8c367 100644 --- a/docs/dyn/containeranalysis_v1.projects.notes.html +++ b/docs/dyn/containeranalysis_v1.projects.notes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists notes for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2205,17 +2205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html index e2ce8ea190..c834ba37bc 100644 --- a/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists occurrences referencing the specified note. Provider projects can use this method to get all occurrences across consumer projects referencing the specified note.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1073,17 +1073,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1.projects.occurrences.html b/docs/dyn/containeranalysis_v1.projects.occurrences.html index 129416df9e..7a03eca853 100644 --- a/docs/dyn/containeranalysis_v1.projects.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.occurrences.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists occurrences for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -6396,17 +6396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1alpha1.html b/docs/dyn/containeranalysis_v1alpha1.html index 0bdc0bae8f..985c7f8778 100644 --- a/docs/dyn/containeranalysis_v1alpha1.html +++ b/docs/dyn/containeranalysis_v1alpha1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.notes.html b/docs/dyn/containeranalysis_v1alpha1.projects.notes.html index dfeaebb698..29c7912e35 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.notes.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.notes.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, name=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all `Notes` for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1620,17 +1620,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html index e036b1714a..2383effd7a 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `Occurrences` referencing the specified `Note`. Use this method to get all occurrences referencing your `Note` across all your customer projects.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1160,17 +1160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1alpha1.projects.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html index b453ccd44e..704e45888e 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, kind=None, name=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists active `Occurrences` for a given project matching the filters.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -4831,17 +4831,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.scanConfigs.html b/docs/dyn/containeranalysis_v1alpha1.projects.scanConfigs.html index a13394c18a..941851f7e6 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.scanConfigs.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.scanConfigs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists scan configurations for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1alpha1.providers.notes.html b/docs/dyn/containeranalysis_v1alpha1.providers.notes.html index a013e3ab9f..9db4deae67 100644 --- a/docs/dyn/containeranalysis_v1alpha1.providers.notes.html +++ b/docs/dyn/containeranalysis_v1alpha1.providers.notes.html @@ -98,7 +98,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Lists all `Notes` for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1620,17 +1620,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html index c6dbd4670b..a95db40f0d 100644 --- a/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `Occurrences` referencing the specified `Note`. Use this method to get all occurrences referencing your `Note` across all your customer projects.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1160,17 +1160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1beta1.html b/docs/dyn/containeranalysis_v1beta1.html index 2191a5a39a..070cd2f8b2 100644 --- a/docs/dyn/containeranalysis_v1beta1.html +++ b/docs/dyn/containeranalysis_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.html b/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.html index 557ae027da..c3b9a5a3b5 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists notes for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2301,17 +2301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.occurrences.html b/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.occurrences.html index ebf454af26..97a427a778 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.locations.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists occurrences referencing the specified note. Provider projects can use this method to get all occurrences across consumer projects referencing the specified note.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -793,17 +793,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1beta1.projects.locations.occurrences.html b/docs/dyn/containeranalysis_v1beta1.projects.locations.occurrences.html index 9fd615671b..9479bc443b 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.locations.occurrences.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.locations.occurrences.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists occurrences for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -4739,17 +4739,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1beta1.projects.notes.html b/docs/dyn/containeranalysis_v1beta1.projects.notes.html index 97be0d2469..2ef040e476 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.notes.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.notes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists notes for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2301,17 +2301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html index ca29ffe33f..606b2138ef 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists occurrences referencing the specified note. Provider projects can use this method to get all occurrences across consumer projects referencing the specified note.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -793,17 +793,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/containeranalysis_v1beta1.projects.occurrences.html b/docs/dyn/containeranalysis_v1beta1.projects.occurrences.html index 2146f7abf9..a6d736a2d5 100644 --- a/docs/dyn/containeranalysis_v1beta1.projects.occurrences.html +++ b/docs/dyn/containeranalysis_v1beta1.projects.occurrences.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists occurrences for the specified project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -4739,17 +4739,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contentwarehouse_v1.html b/docs/dyn/contentwarehouse_v1.html index 945e53efe5..700e5dd09c 100644 --- a/docs/dyn/contentwarehouse_v1.html +++ b/docs/dyn/contentwarehouse_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/contentwarehouse_v1.projects.locations.documentSchemas.html b/docs/dyn/contentwarehouse_v1.projects.locations.documentSchemas.html index 5d13bc9326..538269082d 100644 --- a/docs/dyn/contentwarehouse_v1.projects.locations.documentSchemas.html +++ b/docs/dyn/contentwarehouse_v1.projects.locations.documentSchemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists document schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contentwarehouse_v1.projects.locations.documents.html b/docs/dyn/contentwarehouse_v1.projects.locations.documents.html index 6528c6ddf8..75a73e0e54 100644 --- a/docs/dyn/contentwarehouse_v1.projects.locations.documents.html +++ b/docs/dyn/contentwarehouse_v1.projects.locations.documents.html @@ -103,7 +103,7 @@

Instance Methods

linkedSources(parent, body=None, x__xgafv=None)

Return all source document-links from the document.

- linkedSources_next(previous_request, previous_response)

+ linkedSources_next()

Retrieves the next page of results.

linkedTargets(parent, body=None, x__xgafv=None)

@@ -118,7 +118,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Searches for documents using provided SearchDocumentsRequest. This call only returns documents that the caller has permission to search against.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setAcl(resource, body=None, x__xgafv=None)

@@ -3870,17 +3870,17 @@

Method Details

- linkedSources_next(previous_request, previous_response) + linkedSources_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)
+        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.
-
+ 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. +
@@ -8652,17 +8652,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contentwarehouse_v1.projects.locations.ruleSets.html b/docs/dyn/contentwarehouse_v1.projects.locations.ruleSets.html index cd932b2271..816ed53841 100644 --- a/docs/dyn/contentwarehouse_v1.projects.locations.ruleSets.html +++ b/docs/dyn/contentwarehouse_v1.projects.locations.ruleSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists rulesets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -499,17 +499,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/contentwarehouse_v1.projects.locations.synonymSets.html b/docs/dyn/contentwarehouse_v1.projects.locations.synonymSets.html index 112473eed9..6ba3cd184a 100644 --- a/docs/dyn/contentwarehouse_v1.projects.locations.synonymSets.html +++ b/docs/dyn/contentwarehouse_v1.projects.locations.synonymSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all SynonymSets (for all contexts) for the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/css_v1.accounts.cssProducts.html b/docs/dyn/css_v1.accounts.cssProducts.html index 32f87a2c3f..fdaa2cd6b4 100644 --- a/docs/dyn/css_v1.accounts.cssProducts.html +++ b/docs/dyn/css_v1.accounts.cssProducts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the processed CSS Products in your CSS Center account. The response might contain fewer items than specified by pageSize. Rely on pageToken to determine if there are more items to be requested. After inserting, updating, or deleting a CSS product input, it may take several minutes before the updated processed CSS product can be retrieved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -472,17 +472,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/css_v1.accounts.html b/docs/dyn/css_v1.accounts.html index 183efe8efe..de2f1f3276 100644 --- a/docs/dyn/css_v1.accounts.html +++ b/docs/dyn/css_v1.accounts.html @@ -104,7 +104,7 @@

Instance Methods

listChildAccounts(parent, fullName=None, labelId=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the accounts under the specified CSS account ID, and optionally filters by label ID and account name.

- listChildAccounts_next(previous_request, previous_response)

+ listChildAccounts_next()

Retrieves the next page of results.

updateLabels(name, body=None, x__xgafv=None)

@@ -186,17 +186,17 @@

Method Details

- listChildAccounts_next(previous_request, previous_response) + listChildAccounts_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/css_v1.accounts.labels.html b/docs/dyn/css_v1.accounts.labels.html index ba6cc7fc9c..650c3a4b09 100644 --- a/docs/dyn/css_v1.accounts.labels.html +++ b/docs/dyn/css_v1.accounts.labels.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the labels owned by an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -184,17 +184,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/css_v1.accounts.quotas.html b/docs/dyn/css_v1.accounts.quotas.html index 823b3133d3..1c292ff030 100644 --- a/docs/dyn/css_v1.accounts.quotas.html +++ b/docs/dyn/css_v1.accounts.quotas.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the daily call quota and usage per group for your CSS Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/css_v1.html b/docs/dyn/css_v1.html index f49057c65d..e84ee3786b 100644 --- a/docs/dyn/css_v1.html +++ b/docs/dyn/css_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/curationpartners_v1.curators.curatedPackages.html b/docs/dyn/curationpartners_v1.curators.curatedPackages.html index bbdad42165..e2cfb233fb 100644 --- a/docs/dyn/curationpartners_v1.curators.curatedPackages.html +++ b/docs/dyn/curationpartners_v1.curators.curatedPackages.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists curated packages owned by the specified curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/curationpartners_v1.curators.dataSegments.html b/docs/dyn/curationpartners_v1.curators.dataSegments.html index fe2e5c1dfe..677c3e5c85 100644 --- a/docs/dyn/curationpartners_v1.curators.dataSegments.html +++ b/docs/dyn/curationpartners_v1.curators.dataSegments.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List the data segments owned by a curator.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/curationpartners_v1.curators.reports.html b/docs/dyn/curationpartners_v1.curators.reports.html index 0b2560a1bb..2ed340c7a7 100644 --- a/docs/dyn/curationpartners_v1.curators.reports.html +++ b/docs/dyn/curationpartners_v1.curators.reports.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, skip=None, x__xgafv=None)

Lists `Report` objects.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -552,17 +552,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/curationpartners_v1.curators.reports.results.html b/docs/dyn/curationpartners_v1.curators.reports.results.html index 3b2226aa48..b04cb39cfb 100644 --- a/docs/dyn/curationpartners_v1.curators.reports.results.html +++ b/docs/dyn/curationpartners_v1.curators.reports.results.html @@ -81,7 +81,7 @@

Instance Methods

fetchRows(name, pageSize=None, pageToken=None, x__xgafv=None)

Returns the result rows from a completed report. The caller must have previously called `RunReport` and waited for that operation to complete. The rows will be returned according to the order specified by the `sorts` member of the report definition.

- fetchRows_next(previous_request, previous_response)

+ fetchRows_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- fetchRows_next(previous_request, previous_response) + fetchRows_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)
+        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.
-
+ 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/curationpartners_v1.html b/docs/dyn/curationpartners_v1.html index c8539326ae..f906f097c6 100644 --- a/docs/dyn/curationpartners_v1.html +++ b/docs/dyn/curationpartners_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/curationpartners_v1.mediaPlanners.html b/docs/dyn/curationpartners_v1.mediaPlanners.html index 6cb36a76ff..108f9fd6b5 100644 --- a/docs/dyn/curationpartners_v1.mediaPlanners.html +++ b/docs/dyn/curationpartners_v1.mediaPlanners.html @@ -81,7 +81,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all media planner accounts that the caller has access to. For curators, this will return all media planners that have accepted curator terms. For other accounts, attempting to list media planners will return an error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/customsearch_v1.html b/docs/dyn/customsearch_v1.html index 79926ff2ab..00961804da 100644 --- a/docs/dyn/customsearch_v1.html +++ b/docs/dyn/customsearch_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/databasecenter_v1beta.folders.html b/docs/dyn/databasecenter_v1beta.folders.html index 8b10649d67..ff48fbfebb 100644 --- a/docs/dyn/databasecenter_v1beta.folders.html +++ b/docs/dyn/databasecenter_v1beta.folders.html @@ -78,7 +78,7 @@

Instance Methods

aggregateQueryStats(parent, body=None, x__xgafv=None)

AggregateQueryStats provides database resource query execution statistics.

- aggregateQueryStats_next(previous_request, previous_response)

+ aggregateQueryStats_next()

Retrieves the next page of results.

close()

@@ -185,17 +185,17 @@

Method Details

- aggregateQueryStats_next(previous_request, previous_response) + aggregateQueryStats_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/databasecenter_v1beta.html b/docs/dyn/databasecenter_v1beta.html index 38b80d7f74..b4a65e1653 100644 --- a/docs/dyn/databasecenter_v1beta.html +++ b/docs/dyn/databasecenter_v1beta.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/databasecenter_v1beta.organizations.html b/docs/dyn/databasecenter_v1beta.organizations.html index 374de84e5f..d83d53456b 100644 --- a/docs/dyn/databasecenter_v1beta.organizations.html +++ b/docs/dyn/databasecenter_v1beta.organizations.html @@ -78,7 +78,7 @@

Instance Methods

aggregateQueryStats(parent, body=None, x__xgafv=None)

AggregateQueryStats provides database resource query execution statistics.

- aggregateQueryStats_next(previous_request, previous_response)

+ aggregateQueryStats_next()

Retrieves the next page of results.

close()

@@ -185,17 +185,17 @@

Method Details

- aggregateQueryStats_next(previous_request, previous_response) + aggregateQueryStats_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/databasecenter_v1beta.projects.html b/docs/dyn/databasecenter_v1beta.projects.html index 7aaef40e25..1178a5c03a 100644 --- a/docs/dyn/databasecenter_v1beta.projects.html +++ b/docs/dyn/databasecenter_v1beta.projects.html @@ -78,7 +78,7 @@

Instance Methods

aggregateQueryStats(parent, body=None, x__xgafv=None)

AggregateQueryStats provides database resource query execution statistics.

- aggregateQueryStats_next(previous_request, previous_response)

+ aggregateQueryStats_next()

Retrieves the next page of results.

close()

@@ -185,17 +185,17 @@

Method Details

- aggregateQueryStats_next(previous_request, previous_response) + aggregateQueryStats_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/databasecenter_v1beta.v1beta.html b/docs/dyn/databasecenter_v1beta.v1beta.html index 6d6a5765fd..80548ed444 100644 --- a/docs/dyn/databasecenter_v1beta.v1beta.html +++ b/docs/dyn/databasecenter_v1beta.v1beta.html @@ -78,7 +78,7 @@

Instance Methods

aggregateFleet(baselineDate_day=None, baselineDate_month=None, baselineDate_year=None, filter=None, groupBy=None, orderBy=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

AggregateFleet provides statistics about the fleet grouped by various fields.

- aggregateFleet_next(previous_request, previous_response)

+ aggregateFleet_next()

Retrieves the next page of results.

aggregateIssueStats(body=None, x__xgafv=None)

@@ -90,19 +90,19 @@

Instance Methods

queryDatabaseResourceGroups(body=None, x__xgafv=None)

QueryDatabaseResourceGroups returns paginated results of database groups.

- queryDatabaseResourceGroups_next(previous_request, previous_response)

+ queryDatabaseResourceGroups_next()

Retrieves the next page of results.

queryIssues(body=None, x__xgafv=None)

QueryIssues provides a list of issues and recommendations that a user has access to and that are within the requested scope.

- queryIssues_next(previous_request, previous_response)

+ queryIssues_next()

Retrieves the next page of results.

queryProducts(pageSize=None, pageToken=None, parent=None, x__xgafv=None)

QueryProducts provides a list of all possible products which can be used to filter database resources.

- queryProducts_next(previous_request, previous_response)

+ queryProducts_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- aggregateFleet_next(previous_request, previous_response) + aggregateFleet_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)
+        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.
-
+ 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. +
@@ -671,17 +671,17 @@

Method Details

- queryDatabaseResourceGroups_next(previous_request, previous_response) + queryDatabaseResourceGroups_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)
+        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.
-
+ 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. +
@@ -1150,17 +1150,17 @@

Method Details

- queryIssues_next(previous_request, previous_response) + queryIssues_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)
+        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.
-
+ 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. +
@@ -1196,17 +1196,17 @@

Method Details

- queryProducts_next(previous_request, previous_response) + queryProducts_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)
+        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.
-
+ 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/datacatalog_v1.catalog.html b/docs/dyn/datacatalog_v1.catalog.html index eabf9d1d99..f591b7f9ef 100644 --- a/docs/dyn/datacatalog_v1.catalog.html +++ b/docs/dyn/datacatalog_v1.catalog.html @@ -81,7 +81,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Searches Data Catalog for multiple resources like entries and tags that match a query. This is a [Custom Method] (https://cloud.google.com/apis/design/custom_methods) that doesn't return all information on a resource, only its ID and high level fields. To get more information, you can subsequently call specific get methods. Note: Data Catalog search queries don't guarantee full recall. Results that match your query might not be returned, even in subsequent result pages. Additionally, returned (and not returned) results can vary if you repeat search queries. For more information, see [Data Catalog search syntax] (https://cloud.google.com/data-catalog/docs/how-to/search-reference).

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datacatalog_v1.html b/docs/dyn/datacatalog_v1.html index 7aedcdc9b7..3870244bc9 100644 --- a/docs/dyn/datacatalog_v1.html +++ b/docs/dyn/datacatalog_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.html b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.html index 6a497f1a8b..8faf3aa505 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.html +++ b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists entries. Note: Currently, this method can list only custom entries. To get a list of both custom and automatically created entries, use SearchCatalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyEntryContacts(name, body=None, x__xgafv=None)

@@ -1777,17 +1777,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html index e5cee603b1..946396972e 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html +++ b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists tags assigned to an Entry. The columns in the response are lowercased.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.html b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.html index f65dd25043..36107d9e88 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.html +++ b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists entry groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.tags.html b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.tags.html index 46cf79fb8e..fdd23e0e5d 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.tags.html +++ b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.tags.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists tags assigned to an Entry. The columns in the response are lowercased.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1.projects.locations.operations.html b/docs/dyn/datacatalog_v1.projects.locations.operations.html index f61d392055..340ff6124e 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.operations.html +++ b/docs/dyn/datacatalog_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datacatalog_v1.projects.locations.taxonomies.html b/docs/dyn/datacatalog_v1.projects.locations.taxonomies.html index c853985745..1c52b7330c 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.taxonomies.html +++ b/docs/dyn/datacatalog_v1.projects.locations.taxonomies.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all taxonomies in a project in a particular location that you have a permission to view.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -425,17 +425,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1.projects.locations.taxonomies.policyTags.html b/docs/dyn/datacatalog_v1.projects.locations.taxonomies.policyTags.html index fa2c077798..181ab418e4 100644 --- a/docs/dyn/datacatalog_v1.projects.locations.taxonomies.policyTags.html +++ b/docs/dyn/datacatalog_v1.projects.locations.taxonomies.policyTags.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all policy tags in a taxonomy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.catalog.html b/docs/dyn/datacatalog_v1beta1.catalog.html index 21b8bd6a8d..0745580f3d 100644 --- a/docs/dyn/datacatalog_v1beta1.catalog.html +++ b/docs/dyn/datacatalog_v1beta1.catalog.html @@ -81,7 +81,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Searches Data Catalog for multiple resources like entries, tags that match a query. This is a custom method (https://cloud.google.com/apis/design/custom_methods) and does not return the complete resource, only the resource identifier and high level fields. Clients can subsequently call `Get` methods. Note that Data Catalog search queries do not guarantee full recall. Query results that match your query may not be returned, even in subsequent result pages. Also note that results returned (and not returned) can vary across repeated search queries. See [Data Catalog Search Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) for more information.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -143,17 +143,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datacatalog_v1beta1.html b/docs/dyn/datacatalog_v1beta1.html index c59fc08334..f612dbbff3 100644 --- a/docs/dyn/datacatalog_v1beta1.html +++ b/docs/dyn/datacatalog_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.html b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.html index 1646384016..559fcd044b 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists entries.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -511,17 +511,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.tags.html b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.tags.html index 589606b79d..6e13aa8b46 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.tags.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.entries.tags.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists tags assigned to an Entry. The columns in the response are lowercased.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.html b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.html index eb214cc982..a3e08ee320 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists entry groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.tags.html b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.tags.html index 9f34b26c38..070f015dee 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.tags.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.entryGroups.tags.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists tags assigned to an Entry. The columns in the response are lowercased.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.html b/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.html index 576d9ec07f..38623aad0f 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all taxonomies in a project in a particular location that the caller has permission to view.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.policyTags.html b/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.policyTags.html index 2edcb99b5d..31522b0a59 100644 --- a/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.policyTags.html +++ b/docs/dyn/datacatalog_v1beta1.projects.locations.taxonomies.policyTags.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all policy tags in a taxonomy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.folders.locations.configStoreSettings.html b/docs/dyn/dataflow_v1b3.folders.locations.configStoreSettings.html index f3767bf6d0..94f8152112 100644 --- a/docs/dyn/dataflow_v1b3.folders.locations.configStoreSettings.html +++ b/docs/dyn/dataflow_v1b3.folders.locations.configStoreSettings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ConfigStoreSettings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resolve(name, body=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.html b/docs/dyn/dataflow_v1b3.html index 9932173839..7b28f1b46d 100644 --- a/docs/dyn/dataflow_v1b3.html +++ b/docs/dyn/dataflow_v1b3.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataflow_v1b3.organizations.locations.configStoreSettings.html b/docs/dyn/dataflow_v1b3.organizations.locations.configStoreSettings.html index fa085907f7..bb362bfd68 100644 --- a/docs/dyn/dataflow_v1b3.organizations.locations.configStoreSettings.html +++ b/docs/dyn/dataflow_v1b3.organizations.locations.configStoreSettings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ConfigStoreSettings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resolve(name, body=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.html b/docs/dyn/dataflow_v1b3.projects.jobs.html index 69deae4215..9c46429c6e 100644 --- a/docs/dyn/dataflow_v1b3.projects.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.jobs.html @@ -93,7 +93,7 @@

Instance Methods

aggregated(projectId, filter=None, location=None, name=None, pageSize=None, pageToken=None, regionalFanoutRequested=None, view=None, x__xgafv=None)

List the jobs of a project across all regions. **Note:** This method doesn't support filtering the list of jobs by name. # IAM Permissions Requires the `dataflow.jobs.list` permission on the project.

- aggregated_next(previous_request, previous_response)

+ aggregated_next()

Retrieves the next page of results.

close()

@@ -111,7 +111,7 @@

Instance Methods

list(projectId, filter=None, location=None, name=None, pageSize=None, pageToken=None, regionalFanoutRequested=None, view=None, x__xgafv=None)

List the jobs of a project. To list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, because you can only get the list of jobs that are running in `us-central1`. `projects.locations.jobs.list` and `projects.jobs.list` support filtering the list of jobs by name. Filtering by name isn't supported by `projects.jobs.aggregated`. # IAM Permissions Requires the `dataflow.jobs.list` permission on the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

snapshot(projectId, jobId, body=None, x__xgafv=None)

@@ -516,17 +516,17 @@

Method Details

- aggregated_next(previous_request, previous_response) + aggregated_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)
+        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.
-
+ 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. +
@@ -2083,17 +2083,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.messages.html b/docs/dyn/dataflow_v1b3.projects.jobs.messages.html index 18551fbb08..ae939b9495 100644 --- a/docs/dyn/dataflow_v1b3.projects.jobs.messages.html +++ b/docs/dyn/dataflow_v1b3.projects.jobs.messages.html @@ -81,7 +81,7 @@

Instance Methods

list(projectId, jobId, endTime=None, location=None, minimumImportance=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`. # IAM Permissions Requires the `dataflow.messages.list` permission on the job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataflow_v1b3.projects.locations.configStoreSettings.html b/docs/dyn/dataflow_v1b3.projects.locations.configStoreSettings.html index d77d575e6d..77beb09a1e 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.configStoreSettings.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.configStoreSettings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ConfigStoreSettings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resolve(name, body=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html index a6d7fa0b5f..a6f04d7423 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html @@ -112,7 +112,7 @@

Instance Methods

getExecutionDetails(projectId, location, jobId, pageSize=None, pageToken=None, x__xgafv=None)

Request detailed information about the execution status of the job. EXPERIMENTAL. This API is subject to change or removal without notice. # IAM Permissions Requires the `dataflow.metrics.get` permission on the job.

- getExecutionDetails_next(previous_request, previous_response)

+ getExecutionDetails_next()

Retrieves the next page of results.

getMetrics(projectId, location, jobId, startTime=None, x__xgafv=None)

@@ -121,7 +121,7 @@

Instance Methods

list(projectId, location, filter=None, name=None, pageSize=None, pageToken=None, regionalFanoutRequested=None, view=None, x__xgafv=None)

List the jobs of a project. To list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, because you can only get the list of jobs that are running in `us-central1`. `projects.locations.jobs.list` and `projects.jobs.list` support filtering the list of jobs by name. Filtering by name isn't supported by `projects.jobs.aggregated`. # IAM Permissions Requires the `dataflow.jobs.list` permission on the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

snapshot(projectId, location, jobId, body=None, x__xgafv=None)

@@ -1340,17 +1340,17 @@

Method Details

- getExecutionDetails_next(previous_request, previous_response) + getExecutionDetails_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)
+        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.
-
+ 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. +
@@ -1794,17 +1794,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html index 5bc909971f..0134babc26 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html @@ -81,7 +81,7 @@

Instance Methods

list(projectId, location, jobId, endTime=None, minimumImportance=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Request the job status. To request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`. # IAM Permissions Requires the `dataflow.messages.list` permission on the job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataflow_v1b3.projects.locations.jobs.stages.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.stages.html index 21a9271253..31d913a537 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.jobs.stages.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.stages.html @@ -81,7 +81,7 @@

Instance Methods

getExecutionDetails(projectId, location, jobId, stageId, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Request detailed information about the execution status of a stage of the job. EXPERIMENTAL. This API is subject to change or removal without notice. # IAM Permissions Requires the `dataflow.metrics.get` permission on the job.

- getExecutionDetails_next(previous_request, previous_response)

+ getExecutionDetails_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- getExecutionDetails_next(previous_request, previous_response) + getExecutionDetails_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)
+        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.
-
+ 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/dataform_v1.html b/docs/dyn/dataform_v1.html index 743178dedc..fe0ba7e406 100644 --- a/docs/dyn/dataform_v1.html +++ b/docs/dyn/dataform_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataform_v1.projects.locations.folders.html b/docs/dyn/dataform_v1.projects.locations.folders.html index eb7d4f61ad..ad7d20c032 100644 --- a/docs/dyn/dataform_v1.projects.locations.folders.html +++ b/docs/dyn/dataform_v1.projects.locations.folders.html @@ -102,7 +102,7 @@

Instance Methods

queryFolderContents(folder, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a given Folder.

- queryFolderContents_next(previous_request, previous_response)

+ queryFolderContents_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -440,17 +440,17 @@

Method Details

- queryFolderContents_next(previous_request, previous_response) + queryFolderContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.html b/docs/dyn/dataform_v1.projects.locations.html index 96ea5932ce..77ac2be840 100644 --- a/docs/dyn/dataform_v1.projects.locations.html +++ b/docs/dyn/dataform_v1.projects.locations.html @@ -107,13 +107,13 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

queryUserRootContents(location, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a caller's root folder in a given location. The root folder contains all resources that are created by the user and not contained in any other folder.

- queryUserRootContents_next(previous_request, previous_response)

+ queryUserRootContents_next()

Retrieves the next page of results.

updateConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -302,17 +302,17 @@

Method Details

- queryUserRootContents_next(previous_request, previous_response) + queryUserRootContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.operations.html b/docs/dyn/dataform_v1.projects.locations.operations.html index 9d77b01336..dc4e443d31 100644 --- a/docs/dyn/dataform_v1.projects.locations.operations.html +++ b/docs/dyn/dataform_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataform_v1.projects.locations.repositories.compilationResults.html b/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html index f652ff09b6..76a17c4605 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html @@ -87,13 +87,13 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CompilationResults in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns CompilationResultActions in a given CompilationResult.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -667,17 +667,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dataform_v1.projects.locations.repositories.html b/docs/dyn/dataform_v1.projects.locations.repositories.html index 2f019bb289..8b22911b4c 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.html @@ -118,7 +118,7 @@

Instance Methods

fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None)

Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.

- fetchHistory_next(previous_request, previous_response)

+ fetchHistory_next()

Retrieves the next page of results.

fetchRemoteBranches(name, x__xgafv=None)

@@ -133,7 +133,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Repositories in a given project and location. **Note:** *This method can return repositories not shown in the [Dataform UI](https://console.cloud.google.com/bigquery/dataform)*.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -145,7 +145,7 @@

Instance Methods

queryDirectoryContents(name, commitSha=None, pageSize=None, pageToken=None, path=None, x__xgafv=None)

Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.

- queryDirectoryContents_next(previous_request, previous_response)

+ queryDirectoryContents_next()

Retrieves the next page of results.

readFile(name, commitSha=None, path=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- fetchHistory_next(previous_request, previous_response) + fetchHistory_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)
+        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.
-
+ 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. +
@@ -578,17 +578,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -772,17 +772,17 @@

Method Details

- queryDirectoryContents_next(previous_request, previous_response) + queryDirectoryContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.releaseConfigs.html b/docs/dyn/dataform_v1.projects.locations.repositories.releaseConfigs.html index bf45c46ce4..e93c1dd9b0 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.releaseConfigs.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.releaseConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReleaseConfigs in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html b/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html index 62043c93e3..5520738a2f 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists WorkflowConfigs in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -387,17 +387,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html b/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html index 4aefc791d7..3c1998b9d8 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html @@ -93,13 +93,13 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists WorkflowInvocations in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, pageSize=None, pageToken=None, x__xgafv=None)

Returns WorkflowInvocationActions in a given WorkflowInvocation.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -406,17 +406,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -507,17 +507,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dataform_v1.projects.locations.repositories.workspaces.html b/docs/dyn/dataform_v1.projects.locations.repositories.workspaces.html index 3cde80bea2..37e3882423 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.workspaces.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.workspaces.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Workspaces in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

makeDirectory(workspace, body=None, x__xgafv=None)

@@ -129,7 +129,7 @@

Instance Methods

queryDirectoryContents(workspace, pageSize=None, pageToken=None, path=None, view=None, x__xgafv=None)

Returns the contents of a given Workspace directory.

- queryDirectoryContents_next(previous_request, previous_response)

+ queryDirectoryContents_next()

Retrieves the next page of results.

readFile(workspace, path=None, revision=None, x__xgafv=None)

@@ -147,7 +147,7 @@

Instance Methods

searchFiles(workspace, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Finds the contents of a given Workspace directory by filter.

- searchFiles_next(previous_request, previous_response)

+ searchFiles_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -456,17 +456,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -638,17 +638,17 @@

Method Details

- queryDirectoryContents_next(previous_request, previous_response) + queryDirectoryContents_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)
+        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.
-
+ 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. +
@@ -775,7 +775,7 @@

Method Details

"path": "A String", # File system path relative to the workspace root. }, "file": { # Client-facing representation of a file entry in search results. # Details when search result is a file. - "path": "A String", # File system path relative to the workspace root. + "path": "A String", # File system path relative to the file tree root. }, }, ], @@ -783,17 +783,17 @@

Method Details

- searchFiles_next(previous_request, previous_response) + searchFiles_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1.projects.locations.teamFolders.html b/docs/dyn/dataform_v1.projects.locations.teamFolders.html index c03c69409e..36eab4f589 100644 --- a/docs/dyn/dataform_v1.projects.locations.teamFolders.html +++ b/docs/dyn/dataform_v1.projects.locations.teamFolders.html @@ -99,13 +99,13 @@

Instance Methods

queryContents(teamFolder, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a given TeamFolder.

- queryContents_next(previous_request, previous_response)

+ queryContents_next()

Retrieves the next page of results.

search(location, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns all TeamFolders in a given location that the caller has access to and match the provided filter.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -391,17 +391,17 @@

Method Details

- queryContents_next(previous_request, previous_response) + queryContents_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)
+        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.
-
+ 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. +
@@ -440,17 +440,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.html b/docs/dyn/dataform_v1beta1.html index 2916c7e5d6..96b5039601 100644 --- a/docs/dyn/dataform_v1beta1.html +++ b/docs/dyn/dataform_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataform_v1beta1.projects.locations.folders.html b/docs/dyn/dataform_v1beta1.projects.locations.folders.html index 70d17391ff..4181b7cc4f 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.folders.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.folders.html @@ -102,7 +102,7 @@

Instance Methods

queryFolderContents(folder, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a given Folder.

- queryFolderContents_next(previous_request, previous_response)

+ queryFolderContents_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -441,17 +441,17 @@

Method Details

- queryFolderContents_next(previous_request, previous_response) + queryFolderContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.html b/docs/dyn/dataform_v1beta1.projects.locations.html index d8be3748df..2cf8a1a1e3 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.html @@ -107,13 +107,13 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

queryUserRootContents(location, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a caller's root folder in a given location. The root folder contains all resources that are created by the user and not contained in any other folder.

- queryUserRootContents_next(previous_request, previous_response)

+ queryUserRootContents_next()

Retrieves the next page of results.

updateConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -302,17 +302,17 @@

Method Details

- queryUserRootContents_next(previous_request, previous_response) + queryUserRootContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.operations.html b/docs/dyn/dataform_v1beta1.projects.locations.operations.html index 50df2b413e..a9fa22dcb9 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.operations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataform_v1beta1.projects.locations.repositories.compilationResults.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html index 941491d7a2..d5623ff20f 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html @@ -87,13 +87,13 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CompilationResults in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns CompilationResultActions in a given CompilationResult.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -667,17 +667,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dataform_v1beta1.projects.locations.repositories.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html index b72e8d44bb..3b6d149e3d 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html @@ -121,7 +121,7 @@

Instance Methods

fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None)

Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.

- fetchHistory_next(previous_request, previous_response)

+ fetchHistory_next()

Retrieves the next page of results.

fetchRemoteBranches(name, x__xgafv=None)

@@ -136,7 +136,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Repositories in a given project and location. **Note:** *This method can return repositories not shown in the [Dataform UI](https://console.cloud.google.com/bigquery/dataform)*.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -148,7 +148,7 @@

Instance Methods

queryDirectoryContents(name, commitSha=None, pageSize=None, pageToken=None, path=None, x__xgafv=None)

Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.

- queryDirectoryContents_next(previous_request, previous_response)

+ queryDirectoryContents_next()

Retrieves the next page of results.

readFile(name, commitSha=None, path=None, x__xgafv=None)

@@ -425,17 +425,17 @@

Method Details

- fetchHistory_next(previous_request, previous_response) + fetchHistory_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)
+        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.
-
+ 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. +
@@ -623,17 +623,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -817,17 +817,17 @@

Method Details

- queryDirectoryContents_next(previous_request, previous_response) + queryDirectoryContents_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.releaseConfigs.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.releaseConfigs.html index e229ca0ca4..60330c427a 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.releaseConfigs.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.releaseConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReleaseConfigs in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html index 45b53c06e2..ec3fbdc692 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists WorkflowConfigs in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html index e16cbd96b3..49ee9040cc 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html @@ -93,13 +93,13 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists WorkflowInvocations in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, pageSize=None, pageToken=None, x__xgafv=None)

Returns WorkflowInvocationActions in a given WorkflowInvocation.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -406,17 +406,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -507,17 +507,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dataform_v1beta1.projects.locations.repositories.workspaces.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html index ab060fc615..1dbecbe869 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html @@ -96,7 +96,7 @@

Instance Methods

fetchBranches(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches branches in a Workspace.

- fetchBranches_next(previous_request, previous_response)

+ fetchBranches_next()

Retrieves the next page of results.

fetchCurrentBranch(name, x__xgafv=None)

@@ -123,7 +123,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Workspaces in a given Repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

makeDirectory(workspace, body=None, x__xgafv=None)

@@ -144,7 +144,7 @@

Instance Methods

queryDirectoryContents(workspace, pageSize=None, pageToken=None, path=None, view=None, x__xgafv=None)

Returns the contents of a given Workspace directory.

- queryDirectoryContents_next(previous_request, previous_response)

+ queryDirectoryContents_next()

Retrieves the next page of results.

readFile(workspace, path=None, revision=None, x__xgafv=None)

@@ -162,7 +162,7 @@

Instance Methods

searchFiles(workspace, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Finds the contents of a given Workspace directory by filter.

- searchFiles_next(previous_request, previous_response)

+ searchFiles_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- fetchBranches_next(previous_request, previous_response) + fetchBranches_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)
+        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.
-
+ 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. +
@@ -617,17 +617,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -799,17 +799,17 @@

Method Details

- queryDirectoryContents_next(previous_request, previous_response) + queryDirectoryContents_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)
+        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.
-
+ 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. +
@@ -936,7 +936,7 @@

Method Details

"path": "A String", # File system path relative to the workspace root. }, "file": { # Client-facing representation of a file entry in search results. # Details when search result is a file. - "path": "A String", # File system path relative to the workspace root. + "path": "A String", # File system path relative to the file tree root. }, }, ], @@ -944,17 +944,17 @@

Method Details

- searchFiles_next(previous_request, previous_response) + searchFiles_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html b/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html index 8ff82df609..516d9aaa1d 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html @@ -99,13 +99,13 @@

Instance Methods

queryContents(teamFolder, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the contents of a given TeamFolder.

- queryContents_next(previous_request, previous_response)

+ queryContents_next()

Retrieves the next page of results.

search(location, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns all TeamFolders in a given location that the caller has access to and match the provided filter.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -392,17 +392,17 @@

Method Details

- queryContents_next(previous_request, previous_response) + queryContents_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)
+        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.
-
+ 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. +
@@ -441,17 +441,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datafusion_v1.html b/docs/dyn/datafusion_v1.html index d3f90633d8..fbb02934b9 100644 --- a/docs/dyn/datafusion_v1.html +++ b/docs/dyn/datafusion_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datafusion_v1.projects.locations.html b/docs/dyn/datafusion_v1.projects.locations.html index 9cb5a49d10..967fad366d 100644 --- a/docs/dyn/datafusion_v1.projects.locations.html +++ b/docs/dyn/datafusion_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1.projects.locations.instances.dnsPeerings.html b/docs/dyn/datafusion_v1.projects.locations.instances.dnsPeerings.html index de555a77ff..66de867c3c 100644 --- a/docs/dyn/datafusion_v1.projects.locations.instances.dnsPeerings.html +++ b/docs/dyn/datafusion_v1.projects.locations.instances.dnsPeerings.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DNS peerings for a given resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -179,17 +179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1.projects.locations.instances.html b/docs/dyn/datafusion_v1.projects.locations.instances.html index 81f32bdbd1..09d841d0ae 100644 --- a/docs/dyn/datafusion_v1.projects.locations.instances.html +++ b/docs/dyn/datafusion_v1.projects.locations.instances.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Data Fusion instances in the specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -596,17 +596,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datafusion_v1.projects.locations.operations.html b/docs/dyn/datafusion_v1.projects.locations.operations.html index e9b1fe8763..d6a71b3b57 100644 --- a/docs/dyn/datafusion_v1.projects.locations.operations.html +++ b/docs/dyn/datafusion_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1.projects.locations.versions.html b/docs/dyn/datafusion_v1.projects.locations.versions.html index fb2cfd5135..0a9c6d1da4 100644 --- a/docs/dyn/datafusion_v1.projects.locations.versions.html +++ b/docs/dyn/datafusion_v1.projects.locations.versions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, latestPatchOnly=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists possible versions for Data Fusion instances in the specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -132,17 +132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1beta1.html b/docs/dyn/datafusion_v1beta1.html index 75a0e66266..a30eacb4dc 100644 --- a/docs/dyn/datafusion_v1beta1.html +++ b/docs/dyn/datafusion_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datafusion_v1beta1.projects.locations.html b/docs/dyn/datafusion_v1beta1.projects.locations.html index 9d62fa10e8..5f994c4e0c 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeIamPolicy(resource, body=None, x__xgafv=None)

@@ -174,17 +174,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datafusion_v1beta1.projects.locations.instances.dnsPeerings.html b/docs/dyn/datafusion_v1beta1.projects.locations.instances.dnsPeerings.html index 12e125c717..8ecd842c42 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.instances.dnsPeerings.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.instances.dnsPeerings.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DNS peerings for a given resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -179,17 +179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1beta1.projects.locations.instances.html b/docs/dyn/datafusion_v1beta1.projects.locations.instances.html index 2c78e8b9e6..5c9c0999a4 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.instances.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.instances.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Data Fusion instances in the specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -604,17 +604,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datafusion_v1beta1.projects.locations.instances.namespaces.html b/docs/dyn/datafusion_v1beta1.projects.locations.instances.namespaces.html index 912619886f..8fec45e510 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.instances.namespaces.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.instances.namespaces.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List namespaces in a given instance

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datafusion_v1beta1.projects.locations.operations.html b/docs/dyn/datafusion_v1beta1.projects.locations.operations.html index 5777cf38a9..fd1508fffc 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.operations.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datafusion_v1beta1.projects.locations.versions.html b/docs/dyn/datafusion_v1beta1.projects.locations.versions.html index c1906fdb8a..2d3f51e425 100644 --- a/docs/dyn/datafusion_v1beta1.projects.locations.versions.html +++ b/docs/dyn/datafusion_v1beta1.projects.locations.versions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, latestPatchOnly=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists possible versions for Data Fusion instances in the specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -132,17 +132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datalineage_v1.html b/docs/dyn/datalineage_v1.html index 9aa5f15ab1..143ebca1d8 100644 --- a/docs/dyn/datalineage_v1.html +++ b/docs/dyn/datalineage_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datalineage_v1.projects.locations.html b/docs/dyn/datalineage_v1.projects.locations.html index 0043f77676..ea1f563034 100644 --- a/docs/dyn/datalineage_v1.projects.locations.html +++ b/docs/dyn/datalineage_v1.projects.locations.html @@ -93,7 +93,7 @@

Instance Methods

batchSearchLinkProcesses(parent, body=None, x__xgafv=None)

Retrieve information about LineageProcesses associated with specific links. LineageProcesses are transformation pipelines that result in data flowing from **source** to **target** assets. Links between assets represent this operation. If you have specific link names, you can use this method to verify which LineageProcesses contribute to creating those links. See the SearchLinks method for more information on how to retrieve link name. You can retrieve the LineageProcess information in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.

- batchSearchLinkProcesses_next(previous_request, previous_response)

+ batchSearchLinkProcesses_next()

Retrieves the next page of results.

close()

@@ -108,7 +108,7 @@

Instance Methods

searchLinks(parent, body=None, x__xgafv=None)

Retrieve a list of links connected to a specific asset. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. You can retrieve links in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.

- searchLinks_next(previous_request, previous_response)

+ searchLinks_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- batchSearchLinkProcesses_next(previous_request, previous_response) + batchSearchLinkProcesses_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)
+        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.
-
+ 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. +
@@ -377,17 +377,17 @@

Method Details

- searchLinks_next(previous_request, previous_response) + searchLinks_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)
+        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.
-
+ 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/datalineage_v1.projects.locations.operations.html b/docs/dyn/datalineage_v1.projects.locations.operations.html index a4f57d22be..4564e819a0 100644 --- a/docs/dyn/datalineage_v1.projects.locations.operations.html +++ b/docs/dyn/datalineage_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datalineage_v1.projects.locations.processes.html b/docs/dyn/datalineage_v1.projects.locations.processes.html index 4000142544..fdc4a51281 100644 --- a/docs/dyn/datalineage_v1.projects.locations.processes.html +++ b/docs/dyn/datalineage_v1.projects.locations.processes.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List processes in the given project and location. List order is descending by insertion time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -247,17 +247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datalineage_v1.projects.locations.processes.runs.html b/docs/dyn/datalineage_v1.projects.locations.processes.runs.html index f46f47724f..1804fbd4f3 100644 --- a/docs/dyn/datalineage_v1.projects.locations.processes.runs.html +++ b/docs/dyn/datalineage_v1.projects.locations.processes.runs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists runs in the given project and location. List order is descending by `start_time`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datalineage_v1.projects.locations.processes.runs.lineageEvents.html b/docs/dyn/datalineage_v1.projects.locations.processes.runs.lineageEvents.html index 1b511eee95..edb32b0da0 100644 --- a/docs/dyn/datalineage_v1.projects.locations.processes.runs.lineageEvents.html +++ b/docs/dyn/datalineage_v1.projects.locations.processes.runs.lineageEvents.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists lineage events in the given project and location. The list order is not defined.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.partnerLinks.html b/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html index b9a5b15ac4..ca01f015cf 100644 --- a/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html @@ -87,7 +87,7 @@

Instance Methods

search(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -245,17 +245,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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 index 2c07479dcd..3b9a67fe84 100644 --- a/docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -319,17 +319,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html index 0dcf4a9815..4727181591 100644 --- a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html index b96c2bdf9c..e4fd1841c7 100644 --- a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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 index c09789df94..7be82a5e0f 100644 --- a/docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -402,17 +402,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamanager_v1.html b/docs/dyn/datamanager_v1.html index d69f00d1a4..d9324ad10e 100644 --- a/docs/dyn/datamanager_v1.html +++ b/docs/dyn/datamanager_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datamigration_v1.html b/docs/dyn/datamigration_v1.html index f068846c07..ae49c5ae51 100644 --- a/docs/dyn/datamigration_v1.html +++ b/docs/dyn/datamigration_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html b/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html index c894b7542d..36e337106f 100644 --- a/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html +++ b/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of all connection profiles in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, skipValidation=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1072,17 +1072,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.html b/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.html index e1dd0bc97c..52f50b337d 100644 --- a/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.html +++ b/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.html @@ -104,7 +104,7 @@

Instance Methods

describeDatabaseEntities(conversionWorkspace, commitId=None, filter=None, pageSize=None, pageToken=None, tree=None, uncommitted=None, view=None, x__xgafv=None)

Describes the database entities tree for a specific conversion workspace and a specific tree type. Database entities are not resources like conversion workspaces or mapping rules, and they can't be created, updated or deleted. Instead, they are simple data objects describing the structure of the client database.

- describeDatabaseEntities_next(previous_request, previous_response)

+ describeDatabaseEntities_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -116,7 +116,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists conversion workspaces in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -685,17 +685,17 @@

Method Details

- describeDatabaseEntities_next(previous_request, previous_response) + describeDatabaseEntities_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)
+        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.
-
+ 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. +
@@ -834,17 +834,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.mappingRules.html b/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.mappingRules.html index bbe20f5f93..edb4636b7b 100644 --- a/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.mappingRules.html +++ b/docs/dyn/datamigration_v1.projects.locations.conversionWorkspaces.mappingRules.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the mapping rules for a specific conversion workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -815,17 +815,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datamigration_v1.projects.locations.html b/docs/dyn/datamigration_v1.projects.locations.html index f26e5eb594..26683250b6 100644 --- a/docs/dyn/datamigration_v1.projects.locations.html +++ b/docs/dyn/datamigration_v1.projects.locations.html @@ -106,7 +106,7 @@

Instance Methods

fetchStaticIps(name, fetchReservedPublicIps=None, pageSize=None, pageToken=None, x__xgafv=None)

Fetches a set of static IP addresses that need to be allowlisted by the customer when using the static-IP connectivity method.

- fetchStaticIps_next(previous_request, previous_response)

+ fetchStaticIps_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -115,7 +115,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- fetchStaticIps_next(previous_request, previous_response) + fetchStaticIps_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)
+        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.
-
+ 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. +
@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datamigration_v1.projects.locations.migrationJobs.html b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html index bb10f43e37..fa762624c2 100644 --- a/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html +++ b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html @@ -110,7 +110,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists migration jobs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -912,17 +912,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1.projects.locations.migrationJobs.objects.html b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.objects.html index c41d04d136..5f3cc5a2fa 100644 --- a/docs/dyn/datamigration_v1.projects.locations.migrationJobs.objects.html +++ b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.objects.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list the objects of a specific migration job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, body=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1.projects.locations.operations.html b/docs/dyn/datamigration_v1.projects.locations.operations.html index 366bc3e5e6..a4beca8069 100644 --- a/docs/dyn/datamigration_v1.projects.locations.operations.html +++ b/docs/dyn/datamigration_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datamigration_v1.projects.locations.privateConnections.html b/docs/dyn/datamigration_v1.projects.locations.privateConnections.html index 3171ff77c6..549cd7bf11 100644 --- a/docs/dyn/datamigration_v1.projects.locations.privateConnections.html +++ b/docs/dyn/datamigration_v1.projects.locations.privateConnections.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of private connections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -381,17 +381,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1beta1.html b/docs/dyn/datamigration_v1beta1.html index a68e69d1ac..33ca6de5c6 100644 --- a/docs/dyn/datamigration_v1beta1.html +++ b/docs/dyn/datamigration_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datamigration_v1beta1.projects.locations.connectionProfiles.html b/docs/dyn/datamigration_v1beta1.projects.locations.connectionProfiles.html index 5ecc995a06..72e3c2dd6a 100644 --- a/docs/dyn/datamigration_v1beta1.projects.locations.connectionProfiles.html +++ b/docs/dyn/datamigration_v1beta1.projects.locations.connectionProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a list of all connection profiles in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -494,17 +494,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1beta1.projects.locations.html b/docs/dyn/datamigration_v1beta1.projects.locations.html index b671f350ee..eb81979cfc 100644 --- a/docs/dyn/datamigration_v1beta1.projects.locations.html +++ b/docs/dyn/datamigration_v1beta1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datamigration_v1beta1.projects.locations.migrationJobs.html b/docs/dyn/datamigration_v1beta1.projects.locations.migrationJobs.html index f9e5746580..1447b64b48 100644 --- a/docs/dyn/datamigration_v1beta1.projects.locations.migrationJobs.html +++ b/docs/dyn/datamigration_v1beta1.projects.locations.migrationJobs.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists migration jobs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -472,17 +472,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datamigration_v1beta1.projects.locations.operations.html b/docs/dyn/datamigration_v1beta1.projects.locations.operations.html index 76e46e9639..07aa37f44a 100644 --- a/docs/dyn/datamigration_v1beta1.projects.locations.operations.html +++ b/docs/dyn/datamigration_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datapipelines_v1.html b/docs/dyn/datapipelines_v1.html index d35d6cc033..08126810de 100644 --- a/docs/dyn/datapipelines_v1.html +++ b/docs/dyn/datapipelines_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datapipelines_v1.projects.locations.pipelines.html b/docs/dyn/datapipelines_v1.projects.locations.pipelines.html index f98d12871b..bc548c242f 100644 --- a/docs/dyn/datapipelines_v1.projects.locations.pipelines.html +++ b/docs/dyn/datapipelines_v1.projects.locations.pipelines.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists pipelines. Returns a "FORBIDDEN" error if the caller doesn't have permission to access it.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -587,17 +587,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datapipelines_v1.projects.locations.pipelines.jobs.html b/docs/dyn/datapipelines_v1.projects.locations.pipelines.jobs.html index 80de51b596..31e8dd119b 100644 --- a/docs/dyn/datapipelines_v1.projects.locations.pipelines.jobs.html +++ b/docs/dyn/datapipelines_v1.projects.locations.pipelines.jobs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs for a given pipeline. Throws a "FORBIDDEN" error if the caller doesn't have permission to access it.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -140,17 +140,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.html b/docs/dyn/dataplex_v1.html index 35931512e4..88defc43e4 100644 --- a/docs/dyn/dataplex_v1.html +++ b/docs/dyn/dataplex_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataplex_v1.organizations.locations.encryptionConfigs.html b/docs/dyn/dataplex_v1.organizations.locations.encryptionConfigs.html index 480514aac4..8d5e324848 100644 --- a/docs/dyn/dataplex_v1.organizations.locations.encryptionConfigs.html +++ b/docs/dyn/dataplex_v1.organizations.locations.encryptionConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List EncryptionConfigs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -318,17 +318,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.organizations.locations.operations.html b/docs/dyn/dataplex_v1.organizations.locations.operations.html index 392ae25f39..a7e85735ae 100644 --- a/docs/dyn/dataplex_v1.organizations.locations.operations.html +++ b/docs/dyn/dataplex_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.aspectTypes.html b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html index 4b8853b825..650217cf5c 100644 --- a/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html +++ b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AspectType resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -427,17 +427,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.changeRequests.html b/docs/dyn/dataplex_v1.projects.locations.changeRequests.html index ccaf7da4ba..ee36abde5b 100644 --- a/docs/dyn/dataplex_v1.projects.locations.changeRequests.html +++ b/docs/dyn/dataplex_v1.projects.locations.changeRequests.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ChangeRequests.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1059,17 +1059,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataAttributeBindings.html b/docs/dyn/dataplex_v1.projects.locations.dataAttributeBindings.html index f8d92a20b6..34ef732f25 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataAttributeBindings.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataAttributeBindings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataAttributeBinding resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -352,17 +352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataDomains.bindings.html b/docs/dyn/dataplex_v1.projects.locations.dataDomains.bindings.html index 8fce54a66b..168a0b419e 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataDomains.bindings.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataDomains.bindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataDomainBinding resources under a DataDomain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.dataDomains.html b/docs/dyn/dataplex_v1.projects.locations.dataDomains.html index 69e403b87b..cd89b3aa9a 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataDomains.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataDomains.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataDomain resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -356,17 +356,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataProducts.dataAssets.html b/docs/dyn/dataplex_v1.projects.locations.dataProducts.dataAssets.html index 2405851bb6..592784a0bd 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataProducts.dataAssets.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataProducts.dataAssets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists data assets for a given data product.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataProducts.html b/docs/dyn/dataplex_v1.projects.locations.dataProducts.html index e270bc6f24..8b84811b47 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataProducts.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataProducts.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists data products for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.html index 3ccef8877b..b05fd458ab 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataScans.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataScans.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -2231,17 +2231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html index 320425044d..2200ace6ca 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataScanJobs under the given DataScan.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1432,17 +1432,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.dataTaxonomies.attributes.html b/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.attributes.html index 106af25b8d..60e0c3e967 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.attributes.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.attributes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Data Attribute resources in a DataTaxonomy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.html b/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.html index f8b833a6ad..cea009aa37 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataTaxonomies.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DataTaxonomy resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -327,17 +327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html b/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html index df2ef3a5e1..233357e84b 100644 --- a/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html +++ b/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Entries within an EntryGroup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, aspectKeys=None, body=None, deleteMissingAspects=None, updateMask=None, x__xgafv=None)

@@ -403,17 +403,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryGroups.html b/docs/dyn/dataplex_v1.projects.locations.entryGroups.html index ab17317755..bafa9edfd8 100644 --- a/docs/dyn/dataplex_v1.projects.locations.entryGroups.html +++ b/docs/dyn/dataplex_v1.projects.locations.entryGroups.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists EntryGroup resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -329,17 +329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryTypes.html b/docs/dyn/dataplex_v1.projects.locations.entryTypes.html index f662f781fe..acdaf95146 100644 --- a/docs/dyn/dataplex_v1.projects.locations.entryTypes.html +++ b/docs/dyn/dataplex_v1.projects.locations.entryTypes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists EntryType resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -355,17 +355,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.glossaries.categories.html b/docs/dyn/dataplex_v1.projects.locations.glossaries.categories.html index 3d0b5a1136..26f4169b09 100644 --- a/docs/dyn/dataplex_v1.projects.locations.glossaries.categories.html +++ b/docs/dyn/dataplex_v1.projects.locations.glossaries.categories.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GlossaryCategory resources in a Glossary.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.glossaries.html b/docs/dyn/dataplex_v1.projects.locations.glossaries.html index cf2c812db0..e34b22bda4 100644 --- a/docs/dyn/dataplex_v1.projects.locations.glossaries.html +++ b/docs/dyn/dataplex_v1.projects.locations.glossaries.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Glossary resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -332,17 +332,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.glossaries.terms.html b/docs/dyn/dataplex_v1.projects.locations.glossaries.terms.html index 50996adeea..c6143cf7d0 100644 --- a/docs/dyn/dataplex_v1.projects.locations.glossaries.terms.html +++ b/docs/dyn/dataplex_v1.projects.locations.glossaries.terms.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GlossaryTerm resources in a Glossary.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.html b/docs/dyn/dataplex_v1.projects.locations.html index 4ecd938b70..16d6a89466 100644 --- a/docs/dyn/dataplex_v1.projects.locations.html +++ b/docs/dyn/dataplex_v1.projects.locations.html @@ -164,7 +164,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupContext(name, body=None, x__xgafv=None)

@@ -176,7 +176,7 @@

Instance Methods

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(previous_request, previous_response)

+ lookupEntryLinks_next()

Retrieves the next page of results.

modifyEntry(name, body=None, x__xgafv=None)

@@ -185,7 +185,7 @@

Instance Methods

searchEntries(name, contexts=None, orderBy=None, pageSize=None, pageToken=None, query=None, scope=None, semanticSearch=None, x__xgafv=None)

Searches for Entries matching the given query and scope.

- searchEntries_next(previous_request, previous_response)

+ searchEntries_next()

Retrieves the next page of results.

Method Details

@@ -257,17 +257,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -430,17 +430,17 @@

Method Details

- lookupEntryLinks_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -680,17 +680,17 @@

Method Details

- searchEntries_next(previous_request, previous_response) + searchEntries_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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.actions.html b/docs/dyn/dataplex_v1.projects.locations.lakes.actions.html index 4abbed9917..64b1872f2d 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.actions.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.actions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists action resources in a lake.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.html b/docs/dyn/dataplex_v1.projects.locations.lakes.html index 14cce35680..3ee0cfaaec 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists lake resources in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.html b/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.html index 4a989a9643..ea27b68592 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists tasks under the given lake.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -668,17 +668,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.jobs.html b/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.jobs.html index 695f5a3b5c..e07e684c99 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.jobs.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.tasks.jobs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Jobs under the given task.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.zones.actions.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.actions.html index 0d41a3261f..c5b36f903f 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.actions.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.actions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists action resources in a zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.zones.assets.actions.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.actions.html index 50be98258c..f34dd527ad 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.actions.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.actions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists action resources in an asset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.zones.assets.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.html index 80e41ce95f..74af14d262 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.assets.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists asset resources in a zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -464,17 +464,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html index 3a65403e48..3f86a82ce5 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List metadata entities in a zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, validateOnly=None, x__xgafv=None)

@@ -466,17 +466,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.partitions.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.partitions.html index 16ad20da00..a34de9b934 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.partitions.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.partitions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List metadata partitions of an entity.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.lakes.zones.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.html index 5a2a4db31b..e3cf6a328e 100644 --- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.html +++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists zone resources in a lake.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -414,17 +414,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.metadataFeeds.html b/docs/dyn/dataplex_v1.projects.locations.metadataFeeds.html index 8288b60d36..ac264d90d2 100644 --- a/docs/dyn/dataplex_v1.projects.locations.metadataFeeds.html +++ b/docs/dyn/dataplex_v1.projects.locations.metadataFeeds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a list of MetadataFeeds.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -177,7 +177,7 @@

Method Details

Deletes a MetadataFeed.
 
 Args:
-  name: string, Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/MetadataFeeds/{metadata_feed_id}. (required)
+  name: string, Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/metadataFeeds/{metadata_feed_id}. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -212,7 +212,7 @@ 
Method Details

   
Gets a MetadataFeed.
 
 Args:
-  name: string, Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/MetadataFeeds/{metadata_feed_id}. (required)
+  name: string, Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/metadataFeeds/{metadata_feed_id}. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -312,17 +312,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html b/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html index b8d9e5933e..81618bd743 100644 --- a/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html +++ b/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists metadata jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -436,17 +436,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataplex_v1.projects.locations.operations.html b/docs/dyn/dataplex_v1.projects.locations.operations.html index d740805738..5d9d98a7e3 100644 --- a/docs/dyn/dataplex_v1.projects.locations.operations.html +++ b/docs/dyn/dataplex_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataportability_v1.html b/docs/dyn/dataportability_v1.html index 3cc97bb2b8..33faa44fe4 100644 --- a/docs/dyn/dataportability_v1.html +++ b/docs/dyn/dataportability_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataportability_v1beta.html b/docs/dyn/dataportability_v1beta.html index 84aed04f0c..9fa37b78ba 100644 --- a/docs/dyn/dataportability_v1beta.html +++ b/docs/dyn/dataportability_v1beta.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataproc_v1.html b/docs/dyn/dataproc_v1.html index 0b407962c3..93274a68ba 100644 --- a/docs/dyn/dataproc_v1.html +++ b/docs/dyn/dataproc_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dataproc_v1.projects.locations.autoscalingPolicies.html b/docs/dyn/dataproc_v1.projects.locations.autoscalingPolicies.html index de2fd32886..4a9ea76f08 100644 --- a/docs/dyn/dataproc_v1.projects.locations.autoscalingPolicies.html +++ b/docs/dyn/dataproc_v1.projects.locations.autoscalingPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists autoscaling policies in the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.locations.batches.html b/docs/dyn/dataproc_v1.projects.locations.batches.html index 9ef542d9e4..01640d0e0d 100644 --- a/docs/dyn/dataproc_v1.projects.locations.batches.html +++ b/docs/dyn/dataproc_v1.projects.locations.batches.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists batch workloads.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -790,17 +790,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataproc_v1.projects.locations.batches.sparkApplications.html b/docs/dyn/dataproc_v1.projects.locations.batches.sparkApplications.html index 2b3a88413b..3e9b726778 100644 --- a/docs/dyn/dataproc_v1.projects.locations.batches.sparkApplications.html +++ b/docs/dyn/dataproc_v1.projects.locations.batches.sparkApplications.html @@ -114,52 +114,52 @@

Instance Methods

searchExecutorStageSummary(name, pageSize=None, pageToken=None, parent=None, stageAttemptId=None, stageId=None, x__xgafv=None)

Obtain executor summary with respect to a spark stage attempt.

- searchExecutorStageSummary_next(previous_request, previous_response)

+ searchExecutorStageSummary_next()

Retrieves the next page of results.

searchExecutors(name, executorStatus=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain data corresponding to executors for a Spark Application.

- searchExecutors_next(previous_request, previous_response)

+ searchExecutors_next()

Retrieves the next page of results.

searchJobs(name, jobStatus=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain list of spark jobs corresponding to a Spark Application.

- searchJobs_next(previous_request, previous_response)

+ searchJobs_next()

Retrieves the next page of results.

searchNativeSqlQueries(name, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain data corresponding to Native SQL Queries for a Spark Application.

- searchNativeSqlQueries_next(previous_request, previous_response)

+ searchNativeSqlQueries_next()

Retrieves the next page of results.

searchSqlQueries(name, details=None, pageSize=None, pageToken=None, parent=None, planDescription=None, x__xgafv=None)

Obtain data corresponding to SQL Queries for a Spark Application.

- searchSqlQueries_next(previous_request, previous_response)

+ searchSqlQueries_next()

Retrieves the next page of results.

searchStageAttemptTasks(name, pageSize=None, pageToken=None, parent=None, sortRuntime=None, stageAttemptId=None, stageId=None, taskStatus=None, x__xgafv=None)

Obtain data corresponding to tasks for a spark stage attempt for a Spark Application.

- searchStageAttemptTasks_next(previous_request, previous_response)

+ searchStageAttemptTasks_next()

Retrieves the next page of results.

searchStageAttempts(name, pageSize=None, pageToken=None, parent=None, stageId=None, summaryMetricsMask=None, x__xgafv=None)

Obtain data corresponding to a spark stage attempts for a Spark Application.

- searchStageAttempts_next(previous_request, previous_response)

+ searchStageAttempts_next()

Retrieves the next page of results.

searchStages(name, pageSize=None, pageToken=None, parent=None, stageStatus=None, summaryMetricsMask=None, x__xgafv=None)

Obtain data corresponding to stages for a Spark Application.

- searchStages_next(previous_request, previous_response)

+ searchStages_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

summarizeExecutors(name, parent=None, x__xgafv=None)

@@ -1350,17 +1350,17 @@

Method Details

- searchExecutorStageSummary_next(previous_request, previous_response) + searchExecutorStageSummary_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)
+        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.
-
+ 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. +
@@ -1446,17 +1446,17 @@

Method Details

- searchExecutors_next(previous_request, previous_response) + searchExecutors_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)
+        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.
-
+ 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. +
@@ -1521,17 +1521,17 @@

Method Details

- searchJobs_next(previous_request, previous_response) + searchJobs_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)
+        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.
-
+ 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. +
@@ -1572,17 +1572,17 @@

Method Details

- searchNativeSqlQueries_next(previous_request, previous_response) + searchNativeSqlQueries_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)
+        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.
-
+ 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. +
@@ -1642,17 +1642,17 @@

Method Details

- searchSqlQueries_next(previous_request, previous_response) + searchSqlQueries_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)
+        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.
-
+ 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. +
@@ -1768,17 +1768,17 @@

Method Details

- searchStageAttemptTasks_next(previous_request, previous_response) + searchStageAttemptTasks_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)
+        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.
-
+ 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. +
@@ -2433,17 +2433,17 @@

Method Details

- searchStageAttempts_next(previous_request, previous_response) + searchStageAttempts_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)
+        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.
-
+ 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. +
@@ -3105,31 +3105,31 @@

Method Details

- searchStages_next(previous_request, previous_response) + searchStages_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.locations.operations.html b/docs/dyn/dataproc_v1.projects.locations.operations.html index 54ce7e5ae6..ec25ea14e4 100644 --- a/docs/dyn/dataproc_v1.projects.locations.operations.html +++ b/docs/dyn/dataproc_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dataproc_v1.projects.locations.sessionTemplates.html b/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html index 782ee258bc..7d6cee3d53 100644 --- a/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html +++ b/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists session templates.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -424,17 +424,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.locations.sessions.html b/docs/dyn/dataproc_v1.projects.locations.sessions.html index c54e0bfeb6..27fe0f69c3 100644 --- a/docs/dyn/dataproc_v1.projects.locations.sessions.html +++ b/docs/dyn/dataproc_v1.projects.locations.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists interactive sessions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

terminate(name, body=None, x__xgafv=None)

@@ -563,17 +563,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.locations.sessions.sparkApplications.html b/docs/dyn/dataproc_v1.projects.locations.sessions.sparkApplications.html index 27e2a6771b..0fc0f9ae9b 100644 --- a/docs/dyn/dataproc_v1.projects.locations.sessions.sparkApplications.html +++ b/docs/dyn/dataproc_v1.projects.locations.sessions.sparkApplications.html @@ -111,52 +111,52 @@

Instance Methods

searchExecutorStageSummary(name, pageSize=None, pageToken=None, parent=None, stageAttemptId=None, stageId=None, x__xgafv=None)

Obtain executor summary with respect to a spark stage attempt.

- searchExecutorStageSummary_next(previous_request, previous_response)

+ searchExecutorStageSummary_next()

Retrieves the next page of results.

searchExecutors(name, executorStatus=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain data corresponding to executors for a Spark Application.

- searchExecutors_next(previous_request, previous_response)

+ searchExecutors_next()

Retrieves the next page of results.

searchJobs(name, jobIds=None, jobStatus=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain list of spark jobs corresponding to a Spark Application.

- searchJobs_next(previous_request, previous_response)

+ searchJobs_next()

Retrieves the next page of results.

searchNativeSqlQueries(name, pageSize=None, pageToken=None, parent=None, x__xgafv=None)

Obtain data corresponding to Native SQL Queries for a Spark Application.

- searchNativeSqlQueries_next(previous_request, previous_response)

+ searchNativeSqlQueries_next()

Retrieves the next page of results.

searchSqlQueries(name, details=None, operationIds=None, pageSize=None, pageToken=None, parent=None, planDescription=None, x__xgafv=None)

Obtain data corresponding to SQL Queries for a Spark Application.

- searchSqlQueries_next(previous_request, previous_response)

+ searchSqlQueries_next()

Retrieves the next page of results.

searchStageAttemptTasks(name, pageSize=None, pageToken=None, parent=None, sortRuntime=None, stageAttemptId=None, stageId=None, taskStatus=None, x__xgafv=None)

Obtain data corresponding to tasks for a spark stage attempt for a Spark Application.

- searchStageAttemptTasks_next(previous_request, previous_response)

+ searchStageAttemptTasks_next()

Retrieves the next page of results.

searchStageAttempts(name, pageSize=None, pageToken=None, parent=None, stageId=None, summaryMetricsMask=None, x__xgafv=None)

Obtain data corresponding to a spark stage attempts for a Spark Application.

- searchStageAttempts_next(previous_request, previous_response)

+ searchStageAttempts_next()

Retrieves the next page of results.

searchStages(name, pageSize=None, pageToken=None, parent=None, stageIds=None, stageStatus=None, summaryMetricsMask=None, x__xgafv=None)

Obtain data corresponding to stages for a Spark Application.

- searchStages_next(previous_request, previous_response)

+ searchStages_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

summarizeExecutors(name, parent=None, x__xgafv=None)

@@ -1323,17 +1323,17 @@

Method Details

- searchExecutorStageSummary_next(previous_request, previous_response) + searchExecutorStageSummary_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)
+        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.
-
+ 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. +
@@ -1419,17 +1419,17 @@

Method Details

- searchExecutors_next(previous_request, previous_response) + searchExecutors_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)
+        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.
-
+ 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. +
@@ -1495,17 +1495,17 @@

Method Details

- searchJobs_next(previous_request, previous_response) + searchJobs_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)
+        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.
-
+ 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. +
@@ -1546,17 +1546,17 @@

Method Details

- searchNativeSqlQueries_next(previous_request, previous_response) + searchNativeSqlQueries_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)
+        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.
-
+ 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. +
@@ -1617,17 +1617,17 @@

Method Details

- searchSqlQueries_next(previous_request, previous_response) + searchSqlQueries_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)
+        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.
-
+ 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. +
@@ -1743,17 +1743,17 @@

Method Details

- searchStageAttemptTasks_next(previous_request, previous_response) + searchStageAttemptTasks_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)
+        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.
-
+ 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. +
@@ -2408,17 +2408,17 @@

Method Details

- searchStageAttempts_next(previous_request, previous_response) + searchStageAttempts_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)
+        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.
-
+ 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. +
@@ -3081,31 +3081,31 @@

Method Details

- searchStages_next(previous_request, previous_response) + searchStages_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html b/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html index c92267f58e..4930d5706b 100644 --- a/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html +++ b/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists workflows that match the specified filter in the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -4453,17 +4453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.regions.autoscalingPolicies.html b/docs/dyn/dataproc_v1.projects.regions.autoscalingPolicies.html index 3321236e06..be15d5ffd2 100644 --- a/docs/dyn/dataproc_v1.projects.regions.autoscalingPolicies.html +++ b/docs/dyn/dataproc_v1.projects.regions.autoscalingPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists autoscaling policies in the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -375,17 +375,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.regions.clusters.html b/docs/dyn/dataproc_v1.projects.regions.clusters.html index 32a0571d07..3cc1b2d893 100644 --- a/docs/dyn/dataproc_v1.projects.regions.clusters.html +++ b/docs/dyn/dataproc_v1.projects.regions.clusters.html @@ -104,7 +104,7 @@

Instance Methods

list(projectId, region, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all regions/{region}/clusters in a project alphabetically.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, region, clusterName, body=None, gracefulDecommissionTimeout=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2310,17 +2310,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.regions.jobs.html b/docs/dyn/dataproc_v1.projects.regions.jobs.html index 7faf1171aa..da376d6382 100644 --- a/docs/dyn/dataproc_v1.projects.regions.jobs.html +++ b/docs/dyn/dataproc_v1.projects.regions.jobs.html @@ -93,7 +93,7 @@

Instance Methods

list(projectId, region, clusterName=None, filter=None, jobStateMatcher=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists regions/{region}/jobs in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, region, jobId, body=None, updateMask=None, x__xgafv=None)

@@ -1066,17 +1066,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.regions.operations.html b/docs/dyn/dataproc_v1.projects.regions.operations.html index 388aafb510..afb1de8f87 100644 --- a/docs/dyn/dataproc_v1.projects.regions.operations.html +++ b/docs/dyn/dataproc_v1.projects.regions.operations.html @@ -93,7 +93,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html b/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html index c279b7ee5f..c0751bd252 100644 --- a/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html +++ b/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists workflows that match the specified filter in the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -4453,17 +4453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastore_v1.html b/docs/dyn/datastore_v1.html index 4bd4268c03..dd3f4a4d3c 100644 --- a/docs/dyn/datastore_v1.html +++ b/docs/dyn/datastore_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datastore_v1.projects.indexes.html b/docs/dyn/datastore_v1.projects.indexes.html index f5a56841e4..a2cbd76520 100644 --- a/docs/dyn/datastore_v1.projects.indexes.html +++ b/docs/dyn/datastore_v1.projects.indexes.html @@ -90,7 +90,7 @@

Instance Methods

list(projectId, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the indexes that match the specified filters. Datastore uses an eventually consistent query to fetch the list of indexes and may occasionally return stale results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastore_v1.projects.operations.html b/docs/dyn/datastore_v1.projects.operations.html index 363a7aadca..802f0e94cb 100644 --- a/docs/dyn/datastore_v1.projects.operations.html +++ b/docs/dyn/datastore_v1.projects.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastore_v1beta1.html b/docs/dyn/datastore_v1beta1.html index a046ba0d17..38e314b2a3 100644 --- a/docs/dyn/datastore_v1beta1.html +++ b/docs/dyn/datastore_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datastore_v1beta3.html b/docs/dyn/datastore_v1beta3.html index 1c74f53795..bd96574100 100644 --- a/docs/dyn/datastore_v1beta3.html +++ b/docs/dyn/datastore_v1beta3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datastream_v1.html b/docs/dyn/datastream_v1.html index 156752c739..98a1b35dba 100644 --- a/docs/dyn/datastream_v1.html +++ b/docs/dyn/datastream_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datastream_v1.projects.locations.connectionProfiles.html b/docs/dyn/datastream_v1.projects.locations.connectionProfiles.html index 22565aed0a..63e2c6bb15 100644 --- a/docs/dyn/datastream_v1.projects.locations.connectionProfiles.html +++ b/docs/dyn/datastream_v1.projects.locations.connectionProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list connection profiles created in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1453,17 +1453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastream_v1.projects.locations.html b/docs/dyn/datastream_v1.projects.locations.html index 1c35b4191f..e6301305c8 100644 --- a/docs/dyn/datastream_v1.projects.locations.html +++ b/docs/dyn/datastream_v1.projects.locations.html @@ -101,7 +101,7 @@

Instance Methods

fetchStaticIps(name, pageSize=None, pageToken=None, x__xgafv=None)

The FetchStaticIps API call exposes the static IP addresses used by Datastream.

- fetchStaticIps_next(previous_request, previous_response)

+ fetchStaticIps_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -143,17 +143,17 @@

Method Details

- fetchStaticIps_next(previous_request, previous_response) + fetchStaticIps_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)
+        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.
-
+ 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. +
@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1.projects.locations.operations.html b/docs/dyn/datastream_v1.projects.locations.operations.html index 5291e7e744..af1256a262 100644 --- a/docs/dyn/datastream_v1.projects.locations.operations.html +++ b/docs/dyn/datastream_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1.projects.locations.privateConnections.html b/docs/dyn/datastream_v1.projects.locations.privateConnections.html index 2213d2d1e5..7073e7bdfb 100644 --- a/docs/dyn/datastream_v1.projects.locations.privateConnections.html +++ b/docs/dyn/datastream_v1.projects.locations.privateConnections.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list private connectivity configurations in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -312,17 +312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1.projects.locations.privateConnections.routes.html b/docs/dyn/datastream_v1.projects.locations.privateConnections.routes.html index ebba6ee6dd..69a866ed0e 100644 --- a/docs/dyn/datastream_v1.projects.locations.privateConnections.routes.html +++ b/docs/dyn/datastream_v1.projects.locations.privateConnections.routes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list routes created for a private connectivity configuration in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1.projects.locations.streams.html b/docs/dyn/datastream_v1.projects.locations.streams.html index 33586c3f9a..dc9ea3997a 100644 --- a/docs/dyn/datastream_v1.projects.locations.streams.html +++ b/docs/dyn/datastream_v1.projects.locations.streams.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list streams in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -2600,17 +2600,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastream_v1.projects.locations.streams.objects.html b/docs/dyn/datastream_v1.projects.locations.streams.objects.html index 2d4141c1ed..312c9568f0 100644 --- a/docs/dyn/datastream_v1.projects.locations.streams.objects.html +++ b/docs/dyn/datastream_v1.projects.locations.streams.objects.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list the objects of a specific stream.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(parent, body=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastream_v1alpha1.html b/docs/dyn/datastream_v1alpha1.html index 32fb4ef3b0..eb2e5bdf80 100644 --- a/docs/dyn/datastream_v1alpha1.html +++ b/docs/dyn/datastream_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/datastream_v1alpha1.projects.locations.connectionProfiles.html b/docs/dyn/datastream_v1alpha1.projects.locations.connectionProfiles.html index 6f2528eacc..6ad24d3a8a 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.connectionProfiles.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.connectionProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list connection profiles created in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -553,17 +553,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastream_v1alpha1.projects.locations.html b/docs/dyn/datastream_v1alpha1.projects.locations.html index 8c2681395d..5a750841e2 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.html @@ -101,7 +101,7 @@

Instance Methods

fetchStaticIps(name, pageSize=None, pageToken=None, x__xgafv=None)

The FetchStaticIps API call exposes the static IP addresses used by Datastream.

- fetchStaticIps_next(previous_request, previous_response)

+ fetchStaticIps_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -143,17 +143,17 @@

Method Details

- fetchStaticIps_next(previous_request, previous_response) + fetchStaticIps_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)
+        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.
-
+ 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. +
@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1alpha1.projects.locations.operations.html b/docs/dyn/datastream_v1alpha1.projects.locations.operations.html index 8d14abfceb..725fdc53c7 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1alpha1.projects.locations.privateConnections.html b/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.html index b2c56c72fc..f6a7e04df4 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list private connectivity configurations in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1alpha1.projects.locations.privateConnections.routes.html b/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.routes.html index db3385cba9..0dadceed18 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.routes.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.privateConnections.routes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list routes created for a private connectivity in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/datastream_v1alpha1.projects.locations.streams.html b/docs/dyn/datastream_v1alpha1.projects.locations.streams.html index 50c38cc56a..1ed6df6a7a 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.streams.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.streams.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list streams in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -856,17 +856,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/datastream_v1alpha1.projects.locations.streams.objects.html b/docs/dyn/datastream_v1alpha1.projects.locations.streams.objects.html index 3b59e53b2e..9991af674b 100644 --- a/docs/dyn/datastream_v1alpha1.projects.locations.streams.objects.html +++ b/docs/dyn/datastream_v1alpha1.projects.locations.streams.objects.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Use this method to list the objects of a specific stream.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

startBackfillJob(object, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_alpha.compositeTypes.html b/docs/dyn/deploymentmanager_alpha.compositeTypes.html index 1dc60933f7..f2abdc0a4c 100644 --- a/docs/dyn/deploymentmanager_alpha.compositeTypes.html +++ b/docs/dyn/deploymentmanager_alpha.compositeTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all composite types for Deployment Manager.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, compositeType, body=None, header_bypassBillingFilter=None, x__xgafv=None)

@@ -1045,17 +1045,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_alpha.deployments.html b/docs/dyn/deploymentmanager_alpha.deployments.html index 21acb2fce1..6805d0025d 100644 --- a/docs/dyn/deploymentmanager_alpha.deployments.html +++ b/docs/dyn/deploymentmanager_alpha.deployments.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all deployments for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, deployment, body=None, createPolicy=None, deletePolicy=None, header_bypassBillingFilter=None, preview=None, x__xgafv=None)

@@ -1411,17 +1411,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_alpha.html b/docs/dyn/deploymentmanager_alpha.html index 2fda6232c9..4cbc6b16f4 100644 --- a/docs/dyn/deploymentmanager_alpha.html +++ b/docs/dyn/deploymentmanager_alpha.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/deploymentmanager_alpha.manifests.html b/docs/dyn/deploymentmanager_alpha.manifests.html index 83c9a6064c..0e1ddf3644 100644 --- a/docs/dyn/deploymentmanager_alpha.manifests.html +++ b/docs/dyn/deploymentmanager_alpha.manifests.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all manifests for a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_alpha.operations.html b/docs/dyn/deploymentmanager_alpha.operations.html index 7aee55ffed..845a371945 100644 --- a/docs/dyn/deploymentmanager_alpha.operations.html +++ b/docs/dyn/deploymentmanager_alpha.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all operations for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_alpha.resources.html b/docs/dyn/deploymentmanager_alpha.resources.html index 83d6bb2942..9b628f228a 100644 --- a/docs/dyn/deploymentmanager_alpha.resources.html +++ b/docs/dyn/deploymentmanager_alpha.resources.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resources in a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_alpha.typeProviders.html b/docs/dyn/deploymentmanager_alpha.typeProviders.html index 6d207ebea9..f417c5ed33 100644 --- a/docs/dyn/deploymentmanager_alpha.typeProviders.html +++ b/docs/dyn/deploymentmanager_alpha.typeProviders.html @@ -96,10 +96,10 @@

Instance Methods

listTypes(project, typeProvider, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all the type info for a TypeProvider.

- listTypes_next(previous_request, previous_response)

+ listTypes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, typeProvider, body=None, header_bypassBillingFilter=None, x__xgafv=None)

@@ -1354,31 +1354,31 @@

Method Details

- listTypes_next(previous_request, previous_response) + listTypes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_alpha.types.html b/docs/dyn/deploymentmanager_alpha.types.html index 477ba91a55..8820aa2644 100644 --- a/docs/dyn/deploymentmanager_alpha.types.html +++ b/docs/dyn/deploymentmanager_alpha.types.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resource types for Deployment Manager.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -652,17 +652,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2.deployments.html b/docs/dyn/deploymentmanager_v2.deployments.html index 9328348bc6..6ebab1e937 100644 --- a/docs/dyn/deploymentmanager_v2.deployments.html +++ b/docs/dyn/deploymentmanager_v2.deployments.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all deployments for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, deployment, body=None, createPolicy=None, deletePolicy=None, header_bypassBillingFilter=None, preview=None, x__xgafv=None)

@@ -1332,17 +1332,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_v2.html b/docs/dyn/deploymentmanager_v2.html index a526640064..a580145bac 100644 --- a/docs/dyn/deploymentmanager_v2.html +++ b/docs/dyn/deploymentmanager_v2.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/deploymentmanager_v2.manifests.html b/docs/dyn/deploymentmanager_v2.manifests.html index c762689c02..4b8c524754 100644 --- a/docs/dyn/deploymentmanager_v2.manifests.html +++ b/docs/dyn/deploymentmanager_v2.manifests.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all manifests for a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2.operations.html b/docs/dyn/deploymentmanager_v2.operations.html index cac589b5e8..ed6443c996 100644 --- a/docs/dyn/deploymentmanager_v2.operations.html +++ b/docs/dyn/deploymentmanager_v2.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all operations for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2.resources.html b/docs/dyn/deploymentmanager_v2.resources.html index 0c88be99e4..6d7e18f54e 100644 --- a/docs/dyn/deploymentmanager_v2.resources.html +++ b/docs/dyn/deploymentmanager_v2.resources.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resources in a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -336,17 +336,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2.types.html b/docs/dyn/deploymentmanager_v2.types.html index e153099f8f..f7ff671851 100644 --- a/docs/dyn/deploymentmanager_v2.types.html +++ b/docs/dyn/deploymentmanager_v2.types.html @@ -81,7 +81,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resource types for Deployment Manager.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2beta.compositeTypes.html b/docs/dyn/deploymentmanager_v2beta.compositeTypes.html index 2fdde8ce12..050b9eef7d 100644 --- a/docs/dyn/deploymentmanager_v2beta.compositeTypes.html +++ b/docs/dyn/deploymentmanager_v2beta.compositeTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all composite types for Deployment Manager.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, compositeType, body=None, header_bypassBillingFilter=None, x__xgafv=None)

@@ -1045,17 +1045,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_v2beta.deployments.html b/docs/dyn/deploymentmanager_v2beta.deployments.html index ce7e75f6d7..d8a88fc6eb 100644 --- a/docs/dyn/deploymentmanager_v2beta.deployments.html +++ b/docs/dyn/deploymentmanager_v2beta.deployments.html @@ -96,7 +96,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all deployments for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, deployment, body=None, createPolicy=None, deletePolicy=None, header_bypassBillingFilter=None, preview=None, x__xgafv=None)

@@ -1333,17 +1333,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_v2beta.html b/docs/dyn/deploymentmanager_v2beta.html index 3ca4a5ed96..1bd28f41a6 100644 --- a/docs/dyn/deploymentmanager_v2beta.html +++ b/docs/dyn/deploymentmanager_v2beta.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/deploymentmanager_v2beta.manifests.html b/docs/dyn/deploymentmanager_v2beta.manifests.html index fdc8db5737..6674397220 100644 --- a/docs/dyn/deploymentmanager_v2beta.manifests.html +++ b/docs/dyn/deploymentmanager_v2beta.manifests.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all manifests for a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2beta.operations.html b/docs/dyn/deploymentmanager_v2beta.operations.html index d1968fd5e7..cb94221b19 100644 --- a/docs/dyn/deploymentmanager_v2beta.operations.html +++ b/docs/dyn/deploymentmanager_v2beta.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all operations for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -448,17 +448,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2beta.resources.html b/docs/dyn/deploymentmanager_v2beta.resources.html index c55a980529..a6dfe6a291 100644 --- a/docs/dyn/deploymentmanager_v2beta.resources.html +++ b/docs/dyn/deploymentmanager_v2beta.resources.html @@ -84,7 +84,7 @@

Instance Methods

list(project, deployment, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resources in a given deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -336,17 +336,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/deploymentmanager_v2beta.typeProviders.html b/docs/dyn/deploymentmanager_v2beta.typeProviders.html index ef4dab3059..e230c5a804 100644 --- a/docs/dyn/deploymentmanager_v2beta.typeProviders.html +++ b/docs/dyn/deploymentmanager_v2beta.typeProviders.html @@ -96,10 +96,10 @@

Instance Methods

listTypes(project, typeProvider, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all the type info for a TypeProvider.

- listTypes_next(previous_request, previous_response)

+ listTypes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, typeProvider, body=None, header_bypassBillingFilter=None, x__xgafv=None)

@@ -1333,31 +1333,31 @@

Method Details

- listTypes_next(previous_request, previous_response) + listTypes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/deploymentmanager_v2beta.types.html b/docs/dyn/deploymentmanager_v2beta.types.html index d7a6ca4e88..3b1be71240 100644 --- a/docs/dyn/deploymentmanager_v2beta.types.html +++ b/docs/dyn/deploymentmanager_v2beta.types.html @@ -81,7 +81,7 @@

Instance Methods

list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)

Lists all resource types for Deployment Manager.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -366,17 +366,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/developerconnect_v1.html b/docs/dyn/developerconnect_v1.html index c3d46a7538..3331d04fcc 100644 --- a/docs/dyn/developerconnect_v1.html +++ b/docs/dyn/developerconnect_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.html b/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.html index 0df3fd4be7..91579a2489 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.html +++ b/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.html @@ -92,7 +92,7 @@

Instance Methods

fetchUserRepositories(accountConnector, pageSize=None, pageToken=None, repository=None, x__xgafv=None)

FetchUserRepositories returns a list of UserRepos that are available for an account connector resource.

- fetchUserRepositories_next(previous_request, previous_response)

+ fetchUserRepositories_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AccountConnectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -264,17 +264,17 @@

Method Details

- fetchUserRepositories_next(previous_request, previous_response) + fetchUserRepositories_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)
+        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.
-
+ 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. +
@@ -404,17 +404,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.users.html b/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.users.html index c31694bd35..5817a6459e 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.users.html +++ b/docs/dyn/developerconnect_v1.projects.locations.accountConnectors.users.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Users in a given project, location, and account_connector.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

startOAuthFlow(accountConnector, x__xgafv=None)

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/developerconnect_v1.projects.locations.connections.gitRepositoryLinks.html b/docs/dyn/developerconnect_v1.projects.locations.connections.gitRepositoryLinks.html index 9bbb8049f0..aed156ba5e 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.connections.gitRepositoryLinks.html +++ b/docs/dyn/developerconnect_v1.projects.locations.connections.gitRepositoryLinks.html @@ -87,7 +87,7 @@

Instance Methods

fetchGitRefs(gitRepositoryLink, pageSize=None, pageToken=None, refType=None, x__xgafv=None)

Fetch the list of branches or tags for a given repository.

- fetchGitRefs_next(previous_request, previous_response)

+ fetchGitRefs_next()

Retrieves the next page of results.

fetchReadToken(gitRepositoryLink, body=None, x__xgafv=None)

@@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GitRepositoryLinks in a given project, location, and connection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

processBitbucketCloudWebhook(name, body=None, x__xgafv=None)

@@ -250,17 +250,17 @@

Method Details

- fetchGitRefs_next(previous_request, previous_response) + fetchGitRefs_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)
+        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.
-
+ 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. +
@@ -398,17 +398,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/developerconnect_v1.projects.locations.connections.html b/docs/dyn/developerconnect_v1.projects.locations.connections.html index 64c04a79a0..2642eff33b 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.connections.html +++ b/docs/dyn/developerconnect_v1.projects.locations.connections.html @@ -95,7 +95,7 @@

Instance Methods

fetchLinkableGitRepositories(connection, pageSize=None, pageToken=None, x__xgafv=None)

FetchLinkableGitRepositories returns a list of git repositories from an SCM that are available to be added to a Connection.

- fetchLinkableGitRepositories_next(previous_request, previous_response)

+ fetchLinkableGitRepositories_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connections in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -376,17 +376,17 @@

Method Details

- fetchLinkableGitRepositories_next(previous_request, previous_response) + fetchLinkableGitRepositories_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)
+        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.
-
+ 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. +
@@ -686,17 +686,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/developerconnect_v1.projects.locations.html b/docs/dyn/developerconnect_v1.projects.locations.html index fbb8761f7a..251bc84ce0 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.html +++ b/docs/dyn/developerconnect_v1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/developerconnect_v1.projects.locations.insightsConfigs.deploymentEvents.html b/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.deploymentEvents.html index 6dbbb24100..0c82f1a5d9 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.deploymentEvents.html +++ b/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.deploymentEvents.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Deployment Events in a given insights config.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/developerconnect_v1.projects.locations.insightsConfigs.html b/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.html index 354f721f90..9e68191224 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.html +++ b/docs/dyn/developerconnect_v1.projects.locations.insightsConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InsightsConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, validateOnly=None, x__xgafv=None)

@@ -425,17 +425,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/developerconnect_v1.projects.locations.operations.html b/docs/dyn/developerconnect_v1.projects.locations.operations.html index e36434e4d5..4348e43f3e 100644 --- a/docs/dyn/developerconnect_v1.projects.locations.operations.html +++ b/docs/dyn/developerconnect_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/developerknowledge_v1.documents.html b/docs/dyn/developerknowledge_v1.documents.html index 271f807dde..9e74f1cede 100644 --- a/docs/dyn/developerknowledge_v1.documents.html +++ b/docs/dyn/developerknowledge_v1.documents.html @@ -87,7 +87,7 @@

Instance Methods

searchDocumentChunks(filter=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches for developer knowledge across Google's developer documentation. Returns DocumentChunks based on the user's query. There may be many chunks from the same Document. To retrieve full documents, use DeveloperKnowledge.GetDocument or DeveloperKnowledge.BatchGetDocuments with the DocumentChunk.parent returned in the SearchDocumentChunksResponse.results.

- searchDocumentChunks_next(previous_request, previous_response)

+ searchDocumentChunks_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- searchDocumentChunks_next(previous_request, previous_response) + searchDocumentChunks_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)
+        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.
-
+ 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/developerknowledge_v1.html b/docs/dyn/developerknowledge_v1.html index 2f383a5bda..7117f84c00 100644 --- a/docs/dyn/developerknowledge_v1.html +++ b/docs/dyn/developerknowledge_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/developerknowledge_v1alpha.documents.html b/docs/dyn/developerknowledge_v1alpha.documents.html index 00e6532514..1594d3f571 100644 --- a/docs/dyn/developerknowledge_v1alpha.documents.html +++ b/docs/dyn/developerknowledge_v1alpha.documents.html @@ -87,7 +87,7 @@

Instance Methods

searchDocumentChunks(filter=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Searches for developer knowledge across Google's developer documentation. Returns DocumentChunks based on the user's query. There may be many chunks from the same Document. To retrieve full documents, use DeveloperKnowledge.GetDocument or DeveloperKnowledge.BatchGetDocuments with the DocumentChunk.parent returned in the SearchDocumentChunksResponse.results.

- searchDocumentChunks_next(previous_request, previous_response)

+ searchDocumentChunks_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- searchDocumentChunks_next(previous_request, previous_response) + searchDocumentChunks_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)
+        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.
-
+ 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/developerknowledge_v1alpha.html b/docs/dyn/developerknowledge_v1alpha.html index 68f4c3c9a3..e19c8c79ef 100644 --- a/docs/dyn/developerknowledge_v1alpha.html +++ b/docs/dyn/developerknowledge_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dfareporting_v3_5.html b/docs/dyn/dfareporting_v3_5.html index 54131ea1b5..34f4340970 100644 --- a/docs/dyn/dfareporting_v3_5.html +++ b/docs/dyn/dfareporting_v3_5.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dfareporting_v5.accountUserProfiles.html b/docs/dyn/dfareporting_v5.accountUserProfiles.html index 09ceefc874..89fea020d7 100644 --- a/docs/dyn/dfareporting_v5.accountUserProfiles.html +++ b/docs/dyn/dfareporting_v5.accountUserProfiles.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, active=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, subaccountId=None, userRoleId=None, x__xgafv=None)

Retrieves a list of account user profiles, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -344,17 +344,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.accounts.html b/docs/dyn/dfareporting_v5.accounts.html index 2a244aad16..00bdf74c3a 100644 --- a/docs/dyn/dfareporting_v5.accounts.html +++ b/docs/dyn/dfareporting_v5.accounts.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, active=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves the list of accounts, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.ads.html b/docs/dyn/dfareporting_v5.ads.html index a34df0f39a..2e994507c8 100644 --- a/docs/dyn/dfareporting_v5.ads.html +++ b/docs/dyn/dfareporting_v5.ads.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, active=None, advertiserId=None, archived=None, audienceSegmentIds=None, campaignIds=None, compatibility=None, creativeIds=None, creativeOptimizationConfigurationIds=None, dynamicClickTracker=None, ids=None, landingPageIds=None, maxResults=None, overriddenEventTagId=None, pageToken=None, placementIds=None, remarketingListIds=None, searchString=None, sizeIds=None, sortField=None, sortOrder=None, sslCompliant=None, sslRequired=None, type=None, x__xgafv=None)

Retrieves a list of ads, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -1475,17 +1475,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.advertiserGroups.html b/docs/dyn/dfareporting_v5.advertiserGroups.html index 8ec59a8f98..51a5c6f158 100644 --- a/docs/dyn/dfareporting_v5.advertiserGroups.html +++ b/docs/dyn/dfareporting_v5.advertiserGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of advertiser groups, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.advertiserInvoices.html b/docs/dyn/dfareporting_v5.advertiserInvoices.html index 961c130f86..8357120d37 100644 --- a/docs/dyn/dfareporting_v5.advertiserInvoices.html +++ b/docs/dyn/dfareporting_v5.advertiserInvoices.html @@ -81,7 +81,7 @@

Instance Methods

list(profileId, advertiserId, issueMonth=None, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of invoices for a particular issue month. The api only works if the billing profile invoice level is set to either advertiser or campaign non-consolidated invoice level.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.advertiserLandingPages.html b/docs/dyn/dfareporting_v5.advertiserLandingPages.html index ec7411debd..68f6fb5f32 100644 --- a/docs/dyn/dfareporting_v5.advertiserLandingPages.html +++ b/docs/dyn/dfareporting_v5.advertiserLandingPages.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserIds=None, archived=None, campaignIds=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, subaccountId=None, x__xgafv=None)

Retrieves a list of landing pages.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -277,17 +277,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.advertisers.html b/docs/dyn/dfareporting_v5.advertisers.html index 18508bf47d..3821942fff 100644 --- a/docs/dyn/dfareporting_v5.advertisers.html +++ b/docs/dyn/dfareporting_v5.advertisers.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserGroupIds=None, floodlightConfigurationIds=None, ids=None, includeAdvertisersWithoutGroupsOnly=None, maxResults=None, onlyParent=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, status=None, subaccountId=None, x__xgafv=None)

Retrieves a list of advertisers, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -330,17 +330,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.billingProfiles.html b/docs/dyn/dfareporting_v5.billingProfiles.html index 9d2f6a77c5..7e4afcf939 100644 --- a/docs/dyn/dfareporting_v5.billingProfiles.html +++ b/docs/dyn/dfareporting_v5.billingProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, currency_code=None, ids=None, maxResults=None, name=None, onlySuggestion=None, pageToken=None, sortField=None, sortOrder=None, status=None, subaccountIds=None, x__xgafv=None)

Retrieves a list of billing profiles, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(profileId, body=None, x__xgafv=None)

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.campaignCreativeAssociations.html b/docs/dyn/dfareporting_v5.campaignCreativeAssociations.html index f572ed702b..b97a170e13 100644 --- a/docs/dyn/dfareporting_v5.campaignCreativeAssociations.html +++ b/docs/dyn/dfareporting_v5.campaignCreativeAssociations.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None, x__xgafv=None)

Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.campaigns.html b/docs/dyn/dfareporting_v5.campaigns.html index c1bd5dc0b0..e8ed52af4e 100644 --- a/docs/dyn/dfareporting_v5.campaigns.html +++ b/docs/dyn/dfareporting_v5.campaigns.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserGroupIds=None, advertiserIds=None, archived=None, atLeastOneOptimizationActivity=None, excludedIds=None, ids=None, maxResults=None, overriddenEventTagId=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, subaccountId=None, x__xgafv=None)

Retrieves a list of campaigns, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -648,17 +648,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.changeLogs.html b/docs/dyn/dfareporting_v5.changeLogs.html index 690b0f3c0d..8902457649 100644 --- a/docs/dyn/dfareporting_v5.changeLogs.html +++ b/docs/dyn/dfareporting_v5.changeLogs.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, action=None, ids=None, maxChangeTime=None, maxResults=None, minChangeTime=None, objectIds=None, objectType=None, pageToken=None, searchString=None, userProfileIds=None, x__xgafv=None)

Retrieves a list of change logs. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.contentCategories.html b/docs/dyn/dfareporting_v5.contentCategories.html index bb530afcac..eacffbe5bb 100644 --- a/docs/dyn/dfareporting_v5.contentCategories.html +++ b/docs/dyn/dfareporting_v5.contentCategories.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of content categories, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.creativeFieldValues.html b/docs/dyn/dfareporting_v5.creativeFieldValues.html index 4e5d816345..55588872f3 100644 --- a/docs/dyn/dfareporting_v5.creativeFieldValues.html +++ b/docs/dyn/dfareporting_v5.creativeFieldValues.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, creativeFieldId, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of creative field values, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, creativeFieldId, id, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.creativeFields.html b/docs/dyn/dfareporting_v5.creativeFields.html index 9c6473a8db..731d295d77 100644 --- a/docs/dyn/dfareporting_v5.creativeFields.html +++ b/docs/dyn/dfareporting_v5.creativeFields.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, advertiserIds=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of creative fields, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.creativeGroups.html b/docs/dyn/dfareporting_v5.creativeGroups.html index 8c9b7635cd..8ec6e2fcc1 100644 --- a/docs/dyn/dfareporting_v5.creativeGroups.html +++ b/docs/dyn/dfareporting_v5.creativeGroups.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserIds=None, groupNumber=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of creative groups, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.creatives.html b/docs/dyn/dfareporting_v5.creatives.html index 11148bfa20..3f895e74e9 100644 --- a/docs/dyn/dfareporting_v5.creatives.html +++ b/docs/dyn/dfareporting_v5.creatives.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, active=None, advertiserId=None, archived=None, campaignId=None, companionCreativeIds=None, creativeFieldIds=None, ids=None, maxResults=None, pageToken=None, renderingIds=None, searchString=None, sizeIds=None, sortField=None, sortOrder=None, studioCreativeId=None, types=None, x__xgafv=None)

Retrieves a list of creatives, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -1825,17 +1825,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.dimensionValues.html b/docs/dyn/dfareporting_v5.dimensionValues.html index 2e6af5c906..b5686a282d 100644 --- a/docs/dyn/dfareporting_v5.dimensionValues.html +++ b/docs/dyn/dfareporting_v5.dimensionValues.html @@ -81,7 +81,7 @@

Instance Methods

query(profileId, body=None, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves list of report dimension values for a list of filters.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -140,17 +140,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dfareporting_v5.directorySites.html b/docs/dyn/dfareporting_v5.directorySites.html index c35002fb49..30958b7d94 100644 --- a/docs/dyn/dfareporting_v5.directorySites.html +++ b/docs/dyn/dfareporting_v5.directorySites.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, acceptsInStreamVideoPlacements=None, acceptsInterstitialPlacements=None, acceptsPublisherPaidPlacements=None, active=None, dfpNetworkCode=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of directory sites, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.files.html b/docs/dyn/dfareporting_v5.files.html index 3cdd25d4e7..2fcb25a233 100644 --- a/docs/dyn/dfareporting_v5.files.html +++ b/docs/dyn/dfareporting_v5.files.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, maxResults=None, pageToken=None, scope=None, sortField=None, sortOrder=None, x__xgafv=None)

Lists files for a user profile.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.floodlightActivities.html b/docs/dyn/dfareporting_v5.floodlightActivities.html index 630230e9e1..f8f19bbd9a 100644 --- a/docs/dyn/dfareporting_v5.floodlightActivities.html +++ b/docs/dyn/dfareporting_v5.floodlightActivities.html @@ -93,7 +93,7 @@

Instance Methods

list(profileId, advertiserId=None, floodlightActivityGroupIds=None, floodlightActivityGroupName=None, floodlightActivityGroupTagString=None, floodlightActivityGroupType=None, floodlightConfigurationId=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, tagString=None, x__xgafv=None)

Retrieves a list of floodlight activities, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -549,17 +549,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.floodlightActivityGroups.html b/docs/dyn/dfareporting_v5.floodlightActivityGroups.html index 519367d145..0bd9d9363a 100644 --- a/docs/dyn/dfareporting_v5.floodlightActivityGroups.html +++ b/docs/dyn/dfareporting_v5.floodlightActivityGroups.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserId=None, floodlightConfigurationId=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, type=None, x__xgafv=None)

Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -319,17 +319,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.html b/docs/dyn/dfareporting_v5.html index 59a3755e4c..133aa67a5f 100644 --- a/docs/dyn/dfareporting_v5.html +++ b/docs/dyn/dfareporting_v5.html @@ -413,7 +413,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -422,20 +422,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dfareporting_v5.mobileApps.html b/docs/dyn/dfareporting_v5.mobileApps.html index 4f3557771d..a2022fd297 100644 --- a/docs/dyn/dfareporting_v5.mobileApps.html +++ b/docs/dyn/dfareporting_v5.mobileApps.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, directories=None, ids=None, maxResults=None, pageToken=None, searchString=None, x__xgafv=None)

Retrieves list of available mobile apps.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -163,17 +163,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.placementGroups.html b/docs/dyn/dfareporting_v5.placementGroups.html index 6b4c58cc69..85cddfead7 100644 --- a/docs/dyn/dfareporting_v5.placementGroups.html +++ b/docs/dyn/dfareporting_v5.placementGroups.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, activeStatus=None, advertiserIds=None, campaignIds=None, contentCategoryIds=None, directorySiteIds=None, ids=None, maxEndDate=None, maxResults=None, maxStartDate=None, minEndDate=None, minStartDate=None, pageToken=None, placementGroupType=None, placementStrategyIds=None, pricingTypes=None, searchString=None, siteIds=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of placement groups, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -574,17 +574,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.placementStrategies.html b/docs/dyn/dfareporting_v5.placementStrategies.html index 6428473e9b..0fa51f31c3 100644 --- a/docs/dyn/dfareporting_v5.placementStrategies.html +++ b/docs/dyn/dfareporting_v5.placementStrategies.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of placement strategies, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.placements.html b/docs/dyn/dfareporting_v5.placements.html index 636834004a..08330a9fee 100644 --- a/docs/dyn/dfareporting_v5.placements.html +++ b/docs/dyn/dfareporting_v5.placements.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, activeStatus=None, advertiserIds=None, campaignIds=None, compatibilities=None, contentCategoryIds=None, directorySiteIds=None, groupIds=None, ids=None, maxEndDate=None, maxResults=None, maxStartDate=None, minEndDate=None, minStartDate=None, pageToken=None, paymentSource=None, placementStrategyIds=None, pricingTypes=None, searchString=None, siteIds=None, sizeIds=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of placements, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -1167,17 +1167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.remarketingLists.html b/docs/dyn/dfareporting_v5.remarketingLists.html index 3230468c19..739ea7fcbe 100644 --- a/docs/dyn/dfareporting_v5.remarketingLists.html +++ b/docs/dyn/dfareporting_v5.remarketingLists.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserId, active=None, floodlightActivityId=None, maxResults=None, name=None, pageToken=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of remarketing lists, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -339,17 +339,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.reportData.html b/docs/dyn/dfareporting_v5.reportData.html index 26b91bb82c..a0e6308fd9 100644 --- a/docs/dyn/dfareporting_v5.reportData.html +++ b/docs/dyn/dfareporting_v5.reportData.html @@ -81,7 +81,7 @@

Instance Methods

query(profileId, body=None, x__xgafv=None)

Executes an ad-hoc query and returns structured JSON payload data.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -163,17 +163,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/dfareporting_v5.reports.files.html b/docs/dyn/dfareporting_v5.reports.files.html index b17c6aa89c..aa6f33fd45 100644 --- a/docs/dyn/dfareporting_v5.reports.files.html +++ b/docs/dyn/dfareporting_v5.reports.files.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, reportId, maxResults=None, pageToken=None, sortField=None, sortOrder=None, x__xgafv=None)

Lists files for a report.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.reports.html b/docs/dyn/dfareporting_v5.reports.html index ac665a6ad8..e3a0b995b0 100644 --- a/docs/dyn/dfareporting_v5.reports.html +++ b/docs/dyn/dfareporting_v5.reports.html @@ -100,7 +100,7 @@

Instance Methods

list(profileId, maxResults=None, pageToken=None, scope=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves list of reports.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(profileId, reportId, synchronous=None, x__xgafv=None)

@@ -1420,17 +1420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.sites.html b/docs/dyn/dfareporting_v5.sites.html index 491120c999..598c7631c0 100644 --- a/docs/dyn/dfareporting_v5.sites.html +++ b/docs/dyn/dfareporting_v5.sites.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, acceptsInStreamVideoPlacements=None, acceptsInterstitialPlacements=None, acceptsPublisherPaidPlacements=None, adWordsSite=None, approved=None, campaignIds=None, directorySiteIds=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, subaccountId=None, unmappedSite=None, x__xgafv=None)

Retrieves a list of sites, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -610,17 +610,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.subaccounts.html b/docs/dyn/dfareporting_v5.subaccounts.html index 0938721ddf..df4fa13959 100644 --- a/docs/dyn/dfareporting_v5.subaccounts.html +++ b/docs/dyn/dfareporting_v5.subaccounts.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Gets a list of subaccounts, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.targetableRemarketingLists.html b/docs/dyn/dfareporting_v5.targetableRemarketingLists.html index 00553bb000..805372969c 100644 --- a/docs/dyn/dfareporting_v5.targetableRemarketingLists.html +++ b/docs/dyn/dfareporting_v5.targetableRemarketingLists.html @@ -84,7 +84,7 @@

Instance Methods

list(profileId, advertiserId, active=None, maxResults=None, name=None, pageToken=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dfareporting_v5.targetingTemplates.html b/docs/dyn/dfareporting_v5.targetingTemplates.html index f676cb3ddd..a3ed591f98 100644 --- a/docs/dyn/dfareporting_v5.targetingTemplates.html +++ b/docs/dyn/dfareporting_v5.targetingTemplates.html @@ -87,7 +87,7 @@

Instance Methods

list(profileId, advertiserId=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, x__xgafv=None)

Retrieves a list of targeting templates, optionally filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -838,17 +838,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dfareporting_v5.userRoles.html b/docs/dyn/dfareporting_v5.userRoles.html index 05115d4cdc..8ab1ba922b 100644 --- a/docs/dyn/dfareporting_v5.userRoles.html +++ b/docs/dyn/dfareporting_v5.userRoles.html @@ -90,7 +90,7 @@

Instance Methods

list(profileId, accountUserRoleOnly=None, ids=None, maxResults=None, pageToken=None, searchString=None, sortField=None, sortOrder=None, subaccountId=None, x__xgafv=None)

Retrieves a list of user roles, possibly filtered. This method supports paging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(profileId, id, body=None, x__xgafv=None)

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.html b/docs/dyn/dialogflow_v2.html index d29180b95a..242ed3b640 100644 --- a/docs/dyn/dialogflow_v2.html +++ b/docs/dyn/dialogflow_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dialogflow_v2.projects.agent.entityTypes.html b/docs/dyn/dialogflow_v2.projects.agent.entityTypes.html index 21acdf3a26..64e9ffb909 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.agent.entityTypes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.environments.html b/docs/dyn/dialogflow_v2.projects.agent.environments.html index 1cd01185e9..06e7c95a3c 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.environments.html +++ b/docs/dyn/dialogflow_v2.projects.agent.environments.html @@ -100,13 +100,13 @@

Instance Methods

getHistory(parent, pageSize=None, pageToken=None, x__xgafv=None)

- getHistory_next(previous_request, previous_response)

+ getHistory_next()

Retrieves the next page of results.

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowLoadToDraftAndDiscardChanges=None, body=None, updateMask=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- getHistory_next(previous_request, previous_response) + getHistory_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)
+        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.
-
+ 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. +
@@ -447,17 +447,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.environments.intents.html b/docs/dyn/dialogflow_v2.projects.agent.environments.intents.html index 943c2f662b..d6e40ecc45 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.environments.intents.html +++ b/docs/dyn/dialogflow_v2.projects.agent.environments.intents.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html index 1239f97299..5004479590 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.entityTypes.html b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.entityTypes.html index e4e1a27d0b..8955b3b602 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.html b/docs/dyn/dialogflow_v2.projects.agent.html index 734434ce6e..5b3b05bd49 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.html +++ b/docs/dyn/dialogflow_v2.projects.agent.html @@ -126,7 +126,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, x__xgafv=None)

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

train(parent, body=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.intents.html b/docs/dyn/dialogflow_v2.projects.agent.intents.html index 2185746153..d5e1b1488d 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.intents.html +++ b/docs/dyn/dialogflow_v2.projects.agent.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, intentView=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -1756,17 +1756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.documents.html index 7530845130..3d7feca9ce 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.documents.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -300,17 +300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.html b/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.html index 2bc0cfbc73..51f2ae5c18 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2.projects.agent.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.sessions.contexts.html b/docs/dyn/dialogflow_v2.projects.agent.sessions.contexts.html index 6349c7e2ae..5e0768be2e 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2.projects.agent.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.sessions.entityTypes.html b/docs/dyn/dialogflow_v2.projects.agent.sessions.entityTypes.html index e64032ab09..55a3f2a4a6 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.agent.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.agent.versions.html b/docs/dyn/dialogflow_v2.projects.agent.versions.html index 972da1de6e..fb5688ad9c 100644 --- a/docs/dyn/dialogflow_v2.projects.agent.versions.html +++ b/docs/dyn/dialogflow_v2.projects.agent.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.answerRecords.html b/docs/dyn/dialogflow_v2.projects.answerRecords.html index ae76a07596..34a27ffd85 100644 --- a/docs/dyn/dialogflow_v2.projects.answerRecords.html +++ b/docs/dyn/dialogflow_v2.projects.answerRecords.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -756,17 +756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.conversationDatasets.html b/docs/dyn/dialogflow_v2.projects.conversationDatasets.html index 25fa425924..326a519fed 100644 --- a/docs/dyn/dialogflow_v2.projects.conversationDatasets.html +++ b/docs/dyn/dialogflow_v2.projects.conversationDatasets.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.conversationModels.evaluations.html b/docs/dyn/dialogflow_v2.projects.conversationModels.evaluations.html index 3a8234d458..860d0e1860 100644 --- a/docs/dyn/dialogflow_v2.projects.conversationModels.evaluations.html +++ b/docs/dyn/dialogflow_v2.projects.conversationModels.evaluations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -194,17 +194,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.conversationModels.html b/docs/dyn/dialogflow_v2.projects.conversationModels.html index 6fe1f4a7b0..5a27f3799f 100644 --- a/docs/dyn/dialogflow_v2.projects.conversationModels.html +++ b/docs/dyn/dialogflow_v2.projects.conversationModels.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

undeploy(name, body=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.conversationProfiles.html b/docs/dyn/dialogflow_v2.projects.conversationProfiles.html index 8d4e2c10dd..b156730af3 100644 --- a/docs/dyn/dialogflow_v2.projects.conversationProfiles.html +++ b/docs/dyn/dialogflow_v2.projects.conversationProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1228,17 +1228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.conversations.html b/docs/dyn/dialogflow_v2.projects.conversations.html index a05b7ec0c2..0a2317aeb8 100644 --- a/docs/dyn/dialogflow_v2.projects.conversations.html +++ b/docs/dyn/dialogflow_v2.projects.conversations.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1687,17 +1687,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.conversations.messages.html b/docs/dyn/dialogflow_v2.projects.conversations.messages.html index 934a7acb61..e88ac5bf97 100644 --- a/docs/dyn/dialogflow_v2.projects.conversations.messages.html +++ b/docs/dyn/dialogflow_v2.projects.conversations.messages.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -139,17 +139,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.conversations.participants.html b/docs/dyn/dialogflow_v2.projects.conversations.participants.html index b9c748c677..cf41befb6a 100644 --- a/docs/dyn/dialogflow_v2.projects.conversations.participants.html +++ b/docs/dyn/dialogflow_v2.projects.conversations.participants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1540,17 +1540,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.generators.html b/docs/dyn/dialogflow_v2.projects.generators.html index 2fa946d9b9..671001e62b 100644 --- a/docs/dyn/dialogflow_v2.projects.generators.html +++ b/docs/dyn/dialogflow_v2.projects.generators.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -803,17 +803,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2.projects.knowledgeBases.documents.html index 079bd4f18b..1e01a3575c 100644 --- a/docs/dyn/dialogflow_v2.projects.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2.projects.knowledgeBases.documents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -408,17 +408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.knowledgeBases.html b/docs/dyn/dialogflow_v2.projects.knowledgeBases.html index cd2c9d3522..d304af4cba 100644 --- a/docs/dyn/dialogflow_v2.projects.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2.projects.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.entityTypes.html b/docs/dyn/dialogflow_v2.projects.locations.agent.entityTypes.html index 0405d393d3..2a781eb0d2 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.entityTypes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.html b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.html index 4c01dddff2..b7585d9ab5 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.html @@ -100,13 +100,13 @@

Instance Methods

getHistory(parent, pageSize=None, pageToken=None, x__xgafv=None)

- getHistory_next(previous_request, previous_response)

+ getHistory_next()

Retrieves the next page of results.

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowLoadToDraftAndDiscardChanges=None, body=None, updateMask=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- getHistory_next(previous_request, previous_response) + getHistory_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)
+        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.
-
+ 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. +
@@ -447,17 +447,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.intents.html b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.intents.html index 29de923569..c60c6755c4 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.intents.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.intents.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.agent.environments.users.sessions.contexts.html b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.contexts.html index 1961d3f60c..fc8e9f43d1 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.entityTypes.html b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.entityTypes.html index 943c12e855..b1291179dc 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.html b/docs/dyn/dialogflow_v2.projects.locations.agent.html index 2abd350d3c..bfc2ccc340 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.html @@ -121,7 +121,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, x__xgafv=None)

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

train(parent, body=None, x__xgafv=None)

@@ -366,17 +366,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.intents.html b/docs/dyn/dialogflow_v2.projects.locations.agent.intents.html index 3241ca338b..3c5963a760 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.intents.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, intentView=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -1756,17 +1756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.contexts.html b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.contexts.html index 36ae837e57..96d68d8f54 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.entityTypes.html b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.entityTypes.html index 5e891bf894..1690d2eeb5 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.versions.html b/docs/dyn/dialogflow_v2.projects.locations.agent.versions.html index a106a01a97..5248a9e1bf 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.agent.versions.html +++ b/docs/dyn/dialogflow_v2.projects.locations.agent.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.answerRecords.html b/docs/dyn/dialogflow_v2.projects.locations.answerRecords.html index 3772760af4..a9ce0a3d94 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.answerRecords.html +++ b/docs/dyn/dialogflow_v2.projects.locations.answerRecords.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -756,17 +756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversationDatasets.html b/docs/dyn/dialogflow_v2.projects.locations.conversationDatasets.html index 4b1aa095f3..bfddf1eec9 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversationDatasets.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversationDatasets.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.conversationModels.evaluations.html b/docs/dyn/dialogflow_v2.projects.locations.conversationModels.evaluations.html index cb655da016..786fd5b928 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversationModels.evaluations.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversationModels.evaluations.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.conversationModels.html b/docs/dyn/dialogflow_v2.projects.locations.conversationModels.html index ae4007eff6..5fa6453f87 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversationModels.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversationModels.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

undeploy(name, body=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html b/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html index 74b3a98bbd..7bee720501 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1228,17 +1228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversations.html b/docs/dyn/dialogflow_v2.projects.locations.conversations.html index e4e5794c83..8b22d476ad 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversations.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversations.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1744,17 +1744,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.conversations.messages.html b/docs/dyn/dialogflow_v2.projects.locations.conversations.messages.html index b9c12e935a..e61091c197 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversations.messages.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversations.messages.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -139,17 +139,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.conversations.participants.html b/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html index cb1f284661..b0d2435576 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html +++ b/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1540,17 +1540,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.generators.evaluations.html b/docs/dyn/dialogflow_v2.projects.locations.generators.evaluations.html index 548e12d699..fe6f6cec3a 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.generators.evaluations.html +++ b/docs/dyn/dialogflow_v2.projects.locations.generators.evaluations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1326,17 +1326,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.generators.html b/docs/dyn/dialogflow_v2.projects.locations.generators.html index 31230bdf4b..15aaedd40d 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.generators.html +++ b/docs/dyn/dialogflow_v2.projects.locations.generators.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1073,17 +1073,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.html b/docs/dyn/dialogflow_v2.projects.locations.html index ddd3990907..bddd154ed9 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.html +++ b/docs/dyn/dialogflow_v2.projects.locations.html @@ -163,7 +163,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setAgent(parent, body=None, updateMask=None, x__xgafv=None)

@@ -308,17 +308,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.documents.html index 03283a590a..4d10820e76 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.documents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -408,17 +408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.html b/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.html index 0434b054c8..22003ccb7d 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2.projects.locations.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.operations.html b/docs/dyn/dialogflow_v2.projects.locations.operations.html index d3b2ebac21..f196391f75 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.operations.html +++ b/docs/dyn/dialogflow_v2.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2.projects.locations.sipTrunks.html b/docs/dyn/dialogflow_v2.projects.locations.sipTrunks.html index 600c9d961b..8696d8e21b 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.sipTrunks.html +++ b/docs/dyn/dialogflow_v2.projects.locations.sipTrunks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -327,17 +327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.locations.tools.html b/docs/dyn/dialogflow_v2.projects.locations.tools.html index f0025e1d44..4f83362c3e 100644 --- a/docs/dyn/dialogflow_v2.projects.locations.tools.html +++ b/docs/dyn/dialogflow_v2.projects.locations.tools.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -508,17 +508,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2.projects.operations.html b/docs/dyn/dialogflow_v2.projects.operations.html index 2f3950d4bf..765dcb7d52 100644 --- a/docs/dyn/dialogflow_v2.projects.operations.html +++ b/docs/dyn/dialogflow_v2.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.html b/docs/dyn/dialogflow_v2beta1.html index 1346464dfc..7538ae30ea 100644 --- a/docs/dyn/dialogflow_v2beta1.html +++ b/docs/dyn/dialogflow_v2beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.agent.entityTypes.html index 9c4021b3c2..9b47fe0471 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.entityTypes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html index 292ee549fa..9af033cfca 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html @@ -100,13 +100,13 @@

Instance Methods

getHistory(parent, pageSize=None, pageToken=None, x__xgafv=None)

- getHistory_next(previous_request, previous_response)

+ getHistory_next()

Retrieves the next page of results.

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowLoadToDraftAndDiscardChanges=None, body=None, updateMask=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- getHistory_next(previous_request, previous_response) + getHistory_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)
+        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.
-
+ 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. +
@@ -447,17 +447,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.intents.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.intents.html index 82692d2eca..fe9b557c72 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.intents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.intents.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -463,17 +463,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.agent.environments.users.sessions.contexts.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.contexts.html index 5123c49d70..bb8b8eb2f4 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.entityTypes.html index 509bfe1ca1..eb105a6415 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.html b/docs/dyn/dialogflow_v2beta1.projects.agent.html index 7e6cc12ef7..9d28d5a09f 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.html @@ -126,7 +126,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, x__xgafv=None)

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

train(parent, body=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.intents.html b/docs/dyn/dialogflow_v2beta1.projects.agent.intents.html index a5c2c0c319..92fd308b4d 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.intents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, intentView=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -2362,17 +2362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.documents.html index 51bbabab26..48d9e4f0ad 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.documents.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html index aee53e849e..91f252cf0a 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html index f1b6a5d675..be9a1ad312 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.entityTypes.html index 322596e04d..50dd295337 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.versions.html b/docs/dyn/dialogflow_v2beta1.projects.agent.versions.html index a5c1a9503d..e484fd22c3 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.agent.versions.html +++ b/docs/dyn/dialogflow_v2beta1.projects.agent.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.answerRecords.html b/docs/dyn/dialogflow_v2beta1.projects.answerRecords.html index 7d63b5bac6..f43815357a 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.answerRecords.html +++ b/docs/dyn/dialogflow_v2beta1.projects.answerRecords.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1836,17 +1836,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html index 3db80cf863..8f5c646337 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html +++ b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1200,17 +1200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversations.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.html index 1934606610..1d39d97353 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.conversations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1652,17 +1652,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.conversations.messages.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.messages.html index e18a04c7e2..5211c558f9 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.conversations.messages.html +++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.messages.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -319,17 +319,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.conversations.participants.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html index 4840c14b15..a41b281060 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html +++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -5246,17 +5246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.suggestions.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.suggestions.html index 67788cbd92..f96cb34241 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.suggestions.html +++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.suggestions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

suggestArticles(parent, body=None, x__xgafv=None)

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.generators.html b/docs/dyn/dialogflow_v2beta1.projects.generators.html index a8ebbcbf48..b780ac7b83 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.generators.html +++ b/docs/dyn/dialogflow_v2beta1.projects.generators.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -803,17 +803,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.documents.html index 08b7c8ed63..b4f46fbe4a 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.html b/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.html index f11a00200a..c7973b8f02 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2beta1.projects.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.entityTypes.html index 9e8a76f6a9..137fb2b39d 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.entityTypes.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.html index ae9b9bf8fc..b7067489f4 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.html @@ -100,13 +100,13 @@

Instance Methods

getHistory(parent, pageSize=None, pageToken=None, x__xgafv=None)

- getHistory_next(previous_request, previous_response)

+ getHistory_next()

Retrieves the next page of results.

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowLoadToDraftAndDiscardChanges=None, body=None, updateMask=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- getHistory_next(previous_request, previous_response) + getHistory_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)
+        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.
-
+ 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. +
@@ -447,17 +447,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.intents.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.intents.html index 17fb221c0c..de442dae63 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.intents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.intents.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -463,17 +463,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.contexts.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.contexts.html index dc1ddf19fe..4d8d61019b 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.entityTypes.html index 6ae13b667c..c18f53954e 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.html index 727dcad030..38a9d45e54 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.html @@ -121,7 +121,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, x__xgafv=None)

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

train(parent, body=None, x__xgafv=None)

@@ -366,17 +366,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.intents.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.intents.html index 981be59a26..50eb5a4be6 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.intents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, intentView=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -2362,17 +2362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.contexts.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.contexts.html index 08f1ca7b3c..2b772243d5 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.contexts.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.contexts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.entityTypes.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.entityTypes.html index 4d316af835..451cd662c1 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.versions.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.versions.html index f899b9a3c5..d2fbf322d9 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.versions.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.answerRecords.html b/docs/dyn/dialogflow_v2beta1.projects.locations.answerRecords.html index 42bc3d6b66..7439c93ad0 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.answerRecords.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.answerRecords.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1836,17 +1836,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html index ba142d29f7..92aabb9813 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1200,17 +1200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html index 15b093711e..e89cafd014 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1709,17 +1709,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.locations.conversations.messages.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.messages.html index 99114d624b..2a587d519d 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.messages.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.messages.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -319,17 +319,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.locations.conversations.participants.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html index 30fe30df27..9ebf4a184f 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -5246,17 +5246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.generators.evaluations.html b/docs/dyn/dialogflow_v2beta1.projects.locations.generators.evaluations.html index 36ac25b524..3b15b99d0e 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.generators.evaluations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.generators.evaluations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1326,17 +1326,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.locations.generators.html b/docs/dyn/dialogflow_v2beta1.projects.locations.generators.html index 2535e06cff..f6b096c177 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.generators.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.generators.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1073,17 +1073,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.html b/docs/dyn/dialogflow_v2beta1.projects.locations.html index 4413895327..98e0a7dd73 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.html @@ -158,7 +158,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setAgent(parent, body=None, updateMask=None, x__xgafv=None)

@@ -303,17 +303,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.documents.html b/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.documents.html index 69a06b81b0..17a7b83a91 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.documents.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.html b/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.html index feebe0b0f6..d7439df238 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.knowledgeBases.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.operations.html b/docs/dyn/dialogflow_v2beta1.projects.locations.operations.html index be7a923877..22a76ec86a 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.operations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.locations.phoneNumbers.html b/docs/dyn/dialogflow_v2beta1.projects.locations.phoneNumbers.html index 7023220305..8cd842d9b0 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.phoneNumbers.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.phoneNumbers.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.sipTrunks.html b/docs/dyn/dialogflow_v2beta1.projects.locations.sipTrunks.html index 2aed03f61c..aef305dfe7 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.sipTrunks.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.sipTrunks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -327,17 +327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.tools.html b/docs/dyn/dialogflow_v2beta1.projects.locations.tools.html index a917ccc4bf..036273fe1b 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.tools.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.tools.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -508,17 +508,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v2beta1.projects.operations.html b/docs/dyn/dialogflow_v2beta1.projects.operations.html index 12385985bc..1e7aa029a6 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.operations.html +++ b/docs/dyn/dialogflow_v2beta1.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v2beta1.projects.phoneNumbers.html b/docs/dyn/dialogflow_v2beta1.projects.phoneNumbers.html index 46baba45d3..6e1d9d6a7b 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.phoneNumbers.html +++ b/docs/dyn/dialogflow_v2beta1.projects.phoneNumbers.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.html b/docs/dyn/dialogflow_v3.html index 690470d4ad..687c19c8cd 100644 --- a/docs/dyn/dialogflow_v3.html +++ b/docs/dyn/dialogflow_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.changelogs.html b/docs/dyn/dialogflow_v3.projects.locations.agents.changelogs.html index 7b1ae38a6b..ea913ce26d 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.changelogs.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.changelogs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -153,17 +153,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.agents.entityTypes.html b/docs/dyn/dialogflow_v3.projects.locations.agents.entityTypes.html index 2a3aca7651..c2d4b2c21c 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.entityTypes.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.entityTypes.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.continuousTestResults.html b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.continuousTestResults.html index f544a80b74..e8d4e20f05 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.continuousTestResults.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.continuousTestResults.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.agents.environments.deployments.html b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.deployments.html index 0ebfb7b6fc..6fadd01fe6 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.deployments.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.agents.environments.experiments.html b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.experiments.html index c7df8bd5be..b5370b6b02 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.experiments.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.experiments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -493,17 +493,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.html b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.html index 7a09f21222..32ae7f5bba 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.html @@ -113,13 +113,13 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupEnvironmentHistory(name, pageSize=None, pageToken=None, x__xgafv=None)

- lookupEnvironmentHistory_next(previous_request, previous_response)

+ lookupEnvironmentHistory_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -581,17 +581,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -721,17 +721,17 @@

Method Details

- lookupEnvironmentHistory_next(previous_request, previous_response) + lookupEnvironmentHistory_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.sessions.entityTypes.html b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.sessions.entityTypes.html index 265f08936f..c86b16d04f 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.environments.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.environments.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html index 0ae73040dd..6fdac3f61b 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html @@ -114,7 +114,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -2856,17 +2856,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.pages.html b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.pages.html index b7d258b7ee..49e017e589 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.pages.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.pages.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -4783,17 +4783,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.transitionRouteGroups.html b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.transitionRouteGroups.html index 98f9dc31ff..f7883e3bc8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.transitionRouteGroups.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.transitionRouteGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -931,17 +931,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.versions.html b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.versions.html index c9bebcd9b3..90a8b662d8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.versions.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.versions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

load(name, body=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.generators.html b/docs/dyn/dialogflow_v3.projects.locations.agents.generators.html index 1b1b9ca3a8..ff4dfb7cb8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.generators.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.generators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.html b/docs/dyn/dialogflow_v3.projects.locations.agents.html index 941b9f295c..6583c07fcb 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.html @@ -159,7 +159,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -783,17 +783,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.intents.html b/docs/dyn/dialogflow_v3.projects.locations.agents.intents.html index 7c00cb08fc..ebbd911e99 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.intents.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -410,17 +410,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html index f21374d94a..fc9f6882c8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -424,17 +424,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html index f167a1af87..6608936282 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2010,17 +2010,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html index 275a7b6032..0afb19720a 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

restore(name, body=None, x__xgafv=None)

@@ -2175,17 +2175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.sessions.entityTypes.html b/docs/dyn/dialogflow_v3.projects.locations.agents.sessions.entityTypes.html index 853ab7947c..d404e39053 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html index 79851fd6d2..f33335c793 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -14924,17 +14924,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.results.html b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.results.html index 2fafe67f38..1a235e85b8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.results.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.results.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2681,17 +2681,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.agents.tools.html b/docs/dyn/dialogflow_v3.projects.locations.agents.tools.html index ef6c7897cd..94cc15ad3f 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.tools.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.tools.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.tools.versions.html b/docs/dyn/dialogflow_v3.projects.locations.agents.tools.versions.html index 16a3895e22..8a938c2dc4 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.tools.versions.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.tools.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

restore(name, body=None, x__xgafv=None)

@@ -472,17 +472,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.transitionRouteGroups.html b/docs/dyn/dialogflow_v3.projects.locations.agents.transitionRouteGroups.html index fcc3da26d5..c38959d7e8 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.transitionRouteGroups.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.transitionRouteGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -931,17 +931,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.webhooks.html b/docs/dyn/dialogflow_v3.projects.locations.agents.webhooks.html index 2fd1bfaff0..802d49e6c9 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.webhooks.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.webhooks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -504,17 +504,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.locations.html b/docs/dyn/dialogflow_v3.projects.locations.html index a71351b4b4..b5d6f6ee63 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.html +++ b/docs/dyn/dialogflow_v3.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.operations.html b/docs/dyn/dialogflow_v3.projects.locations.operations.html index 9f6b1c1b70..69cd7de2f7 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.operations.html +++ b/docs/dyn/dialogflow_v3.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3.projects.locations.securitySettings.html b/docs/dyn/dialogflow_v3.projects.locations.securitySettings.html index aae4a5927d..141bfe467e 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.securitySettings.html +++ b/docs/dyn/dialogflow_v3.projects.locations.securitySettings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -271,17 +271,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3.projects.operations.html b/docs/dyn/dialogflow_v3.projects.operations.html index 71d516b2c4..c537bd6e40 100644 --- a/docs/dyn/dialogflow_v3.projects.operations.html +++ b/docs/dyn/dialogflow_v3.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.html b/docs/dyn/dialogflow_v3beta1.html index 80eb4184f2..ffbd954061 100644 --- a/docs/dyn/dialogflow_v3beta1.html +++ b/docs/dyn/dialogflow_v3beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.changelogs.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.changelogs.html index 00c5eb1edc..079b88e327 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.changelogs.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.changelogs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -153,17 +153,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.agents.conversations.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html index 70e452b488..754cabfc00 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -14420,17 +14420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.agents.entityTypes.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.entityTypes.html index 377268d56e..29b8b1f274 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.entityTypes.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.entityTypes.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -368,17 +368,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.continuousTestResults.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.continuousTestResults.html index 2f875e5416..c117a7b6f5 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.continuousTestResults.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.continuousTestResults.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.agents.environments.deployments.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.deployments.html index 472d44a4ea..aac62524bf 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.deployments.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.agents.environments.experiments.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.experiments.html index 9a2853e3bc..a4c26978fa 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.experiments.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.experiments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -493,17 +493,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.html index 09789e61a7..020f6447ce 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.html @@ -113,13 +113,13 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupEnvironmentHistory(name, pageSize=None, pageToken=None, x__xgafv=None)

- lookupEnvironmentHistory_next(previous_request, previous_response)

+ lookupEnvironmentHistory_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -581,17 +581,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -721,17 +721,17 @@

Method Details

- lookupEnvironmentHistory_next(previous_request, previous_response) + lookupEnvironmentHistory_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.entityTypes.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.entityTypes.html index c9b5886fed..764ef0363b 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html index 2a675d8da0..f39d137d9d 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html @@ -114,7 +114,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -2832,17 +2832,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.pages.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.pages.html index 0c49ae45e1..e43800be6a 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.pages.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.pages.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -4735,17 +4735,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.transitionRouteGroups.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.transitionRouteGroups.html index 0d2d1a1d08..6e83269d63 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.transitionRouteGroups.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.transitionRouteGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -923,17 +923,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.versions.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.versions.html index 699574663e..07d7838f61 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.versions.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.versions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

load(name, body=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.generators.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.generators.html index 905ad4acf7..f472da2ffd 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.generators.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.generators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.html index e2397d9655..1e81512ab2 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.html @@ -164,7 +164,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -845,17 +845,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.intents.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.intents.html index d895ae7a1f..985b8da08c 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.intents.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.intents.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, intentView=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -410,17 +410,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.examples.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.examples.html index 4773827ef2..d20bf7e3aa 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.examples.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.examples.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1100,17 +1100,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.html index c105c29833..1fbe2f3618 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2046,17 +2046,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.versions.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.versions.html index 3dd3970880..d0ecf7b129 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.versions.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.playbooks.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

restore(name, body=None, x__xgafv=None)

@@ -2887,17 +2887,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.entityTypes.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.entityTypes.html index 169f4b068e..08c23d973e 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.entityTypes.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.entityTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html index c5d4dbfda7..e697f6d398 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -14784,17 +14784,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.results.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.results.html index 5ca6ca1ae4..aabd55c030 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.results.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.results.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2657,17 +2657,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.agents.tools.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.html index b9aa4387fe..b6dd5c3319 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -627,17 +627,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.versions.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.versions.html index effb08b6e5..11ca9f43dc 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.versions.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.tools.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

restore(name, body=None, x__xgafv=None)

@@ -596,17 +596,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.transitionRouteGroups.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.transitionRouteGroups.html index d1d5a8d42a..161fa583c2 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.transitionRouteGroups.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.transitionRouteGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, languageCode=None, updateMask=None, x__xgafv=None)

@@ -923,17 +923,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.webhooks.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.webhooks.html index 15a6e3dfef..9c05c7a6e6 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.webhooks.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.webhooks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -504,17 +504,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.html b/docs/dyn/dialogflow_v3beta1.projects.locations.html index 0444b2f1ba..7d36f7436b 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.operations.html b/docs/dyn/dialogflow_v3beta1.projects.locations.operations.html index aa184defbd..5dc7c943d7 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.operations.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dialogflow_v3beta1.projects.locations.securitySettings.html b/docs/dyn/dialogflow_v3beta1.projects.locations.securitySettings.html index 3537ad73d8..44a6f38dcf 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.securitySettings.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.securitySettings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -271,17 +271,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dialogflow_v3beta1.projects.operations.html b/docs/dyn/dialogflow_v3beta1.projects.operations.html index 388c5e6831..56abea18d0 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.operations.html +++ b/docs/dyn/dialogflow_v3beta1.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/digitalassetlinks_v1.html b/docs/dyn/digitalassetlinks_v1.html index f704b2c39e..01b6c866ed 100644 --- a/docs/dyn/digitalassetlinks_v1.html +++ b/docs/dyn/digitalassetlinks_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/discovery_v1.html b/docs/dyn/discovery_v1.html index 444dbfc8de..fdc14ecac0 100644 --- a/docs/dyn/discovery_v1.html +++ b/docs/dyn/discovery_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.html b/docs/dyn/discoveryengine_v1.html index e24d331893..e6ae82a5ce 100644 --- a/docs/dyn/discoveryengine_v1.html +++ b/docs/dyn/discoveryengine_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataConnector.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataConnector.operations.html index 75b4af02ea..788cbf4c82 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataConnector.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataConnector.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.documents.html index 185acb571d..3bd8e5dcee 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.operations.html index 5142a3366b..3019c8bc73 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html index 8308a8c49c..0f0b9b53c4 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html index dac465771c..07d3d66692 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -828,17 +828,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html index 1f4b1dbfa3..e3defb4aa0 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html @@ -174,7 +174,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -894,17 +894,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.models.operations.html index c4d5e80ef2..800e3b5595 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.operations.html index 0b00a49ede..2af23b1e87 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.schemas.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.html index 1a094c8c0b..e1073d231a 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.operations.html index 4ce6f69c0b..93b84f27a0 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.schemas.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html index da8de87600..1e13495037 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1168,17 +1168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1404,7 +1404,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1417,7 +1417,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1517,7 +1517,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -2625,31 +2625,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html index b57b585525..c51ec931e9 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1292,17 +1292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html index 40de605eb7..fecf502460 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html @@ -105,7 +105,7 @@

Instance Methods

fetchDomainVerificationStatus(siteSearchEngine, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of target sites with its domain verification status. This method can only be called under data store with BASIC_SITE_SEARCH state at the moment.

- fetchDomainVerificationStatus_next(previous_request, previous_response)

+ fetchDomainVerificationStatus_next()

Retrieves the next page of results.

recrawlUris(siteSearchEngine, body=None, x__xgafv=None)

@@ -283,17 +283,17 @@

Method Details

- fetchDomainVerificationStatus_next(previous_request, previous_response) + fetchDomainVerificationStatus_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.operations.html index b9079809f2..9e42f5935a 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html index 34a1725b44..53757114d1 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html index e2e7bfc07a..29aa270e5a 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html index b2897fad1a..1741f3eda6 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -270,7 +270,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -384,7 +384,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -397,7 +397,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -497,7 +497,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -536,7 +536,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -549,7 +549,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -649,7 +649,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html index be4bac4420..11ea95e992 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html @@ -175,6 +175,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -463,6 +464,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -750,6 +752,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.a2a.v1.tasks.pushNotificationConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.a2a.v1.tasks.pushNotificationConfigs.html index 572c1cdb43..b1d37d0268 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.a2a.v1.tasks.pushNotificationConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.a2a.v1.tasks.pushNotificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(tenant, parent, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of push notifications configured for a task.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.assistants.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html index 129b3bfcb0..462053ad9e 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Assistants under an Engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html index 56856df4bf..bf13c56c79 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html index 3eb371a271..24ff988dd4 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -828,17 +828,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html index 0eeb9254c5..582c7bc713 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html @@ -133,7 +133,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Engines associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -637,17 +637,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.operations.html index 9d7db96de2..f6576016d1 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html index 2046737793..f2256c93c0 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1168,17 +1168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1404,7 +1404,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1417,7 +1417,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1517,7 +1517,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -2625,31 +2625,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html index 379d4d3859..267e62671d 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1292,17 +1292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html index f3af9bb403..7948576dd7 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html @@ -175,6 +175,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -463,6 +464,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -750,6 +752,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.operations.html index ca32d9f5b0..a8366c89b1 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.documents.html index c7ebae8f39..7e1676a761 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.operations.html index 3416c600ea..ae12cd1508 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html index f9718a31f7..325ba7ae6d 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html index 88e88745e0..fea7b6ad8e 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -828,17 +828,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html index 2eebd1ace1..6045cb47e6 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html @@ -169,7 +169,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -886,17 +886,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.models.operations.html index da38d0dbf6..9c44f12534 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.operations.html index b8505e92bb..5c2257648b 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.dataStores.schemas.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.schemas.html index db187091a0..0faef62ba7 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.schemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html index de2fdb4897..ce5b1b1aaa 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1168,17 +1168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1404,7 +1404,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1417,7 +1417,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1517,7 +1517,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -2625,31 +2625,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html index 182ec228f3..a3f9c734eb 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1292,17 +1292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.targetSites.html index 8450302e8a..38aa8aa447 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.targetSites.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -341,17 +341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html index fda56a0ab1..6e1b91943c 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -270,7 +270,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -384,7 +384,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -397,7 +397,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -497,7 +497,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -536,7 +536,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -549,7 +549,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -649,7 +649,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html index 92a38c292a..0b3a30b8cb 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html @@ -175,6 +175,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -463,6 +464,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -750,6 +752,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html index 2528d84efa..63f3b29ca1 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html @@ -101,10 +101,10 @@

Instance Methods

listIdentityMappings(identityMappingStore, pageSize=None, pageToken=None, x__xgafv=None)

Lists Identity Mappings in an Identity Mapping Store.

- listIdentityMappings_next(previous_request, previous_response)

+ listIdentityMappings_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

purgeIdentityMappings(identityMappingStore, body=None, x__xgafv=None)

@@ -365,31 +365,31 @@

Method Details

- listIdentityMappings_next(previous_request, previous_response) + listIdentityMappings_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.operations.html index 7859dfe016..d1f525b640 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.licenseConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.licenseConfigs.html index cff3831c94..24204da724 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.licenseConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.licenseConfigs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the LicenseConfigs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.operations.html b/docs/dyn/discoveryengine_v1.projects.locations.operations.html index 9fad660c14..4c9404bdda 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html index 517a7d143c..5a30217571 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html @@ -154,7 +154,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -167,7 +167,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -267,7 +267,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -338,7 +338,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -351,7 +351,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -451,7 +451,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -490,7 +490,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -503,7 +503,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -603,7 +603,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1.projects.locations.userStores.userLicenses.html b/docs/dyn/discoveryengine_v1.projects.locations.userStores.userLicenses.html index 27409ae414..549c1777ee 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.userStores.userLicenses.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.userStores.userLicenses.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the User Licenses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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.operations.html b/docs/dyn/discoveryengine_v1.projects.operations.html index 346259bd0a..221fc56098 100644 --- a/docs/dyn/discoveryengine_v1.projects.operations.html +++ b/docs/dyn/discoveryengine_v1.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.billingAccounts.billingAccountLicenseConfigs.html b/docs/dyn/discoveryengine_v1alpha.billingAccounts.billingAccountLicenseConfigs.html index 7ec4602787..d9a07d7d8b 100644 --- a/docs/dyn/discoveryengine_v1alpha.billingAccounts.billingAccountLicenseConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.billingAccounts.billingAccountLicenseConfigs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all BillingAccountLicenseConfigs for a given billing account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

retractLicenseConfig(billingAccountLicenseConfig, body=None, x__xgafv=None)

@@ -144,6 +144,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -274,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -332,6 +333,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. diff --git a/docs/dyn/discoveryengine_v1alpha.html b/docs/dyn/discoveryengine_v1alpha.html index 426bbfb595..f2ea7f3f4c 100644 --- a/docs/dyn/discoveryengine_v1alpha.html +++ b/docs/dyn/discoveryengine_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html index 635c40a0ce..61b5c1a5e1 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Authorizations under an Engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.connectorRuns.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.connectorRuns.html index 9987804433..a41e80375c 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.connectorRuns.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.connectorRuns.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the ConnectorRuns of a DataConnector.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataConnector.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.operations.html index d60fba1a03..2d2a785c60 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataConnector.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html index ca132a2536..3abb779ec7 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Chunks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.html index 11ade88440..8df46bc0b4 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -597,17 +597,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.operations.html index 70571d747e..15f409ceea 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html index e8a0ab3370..10ff7ba7c6 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html index 30fea1547f..293c0fb0af 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html index c40072558f..bf485e636e 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html @@ -186,7 +186,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1228,17 +1228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.models.operations.html index 16901374ef..469fd44fad 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.operations.html index e1a2eb315b..00382c7356 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.schemas.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html index 90043545f4..e9fc107d8e 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -305,17 +305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.operations.html index 0e62bdac70..0e40a40aba 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html index 8d55483059..68113f53df 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1627,7 +1627,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1640,7 +1640,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1777,7 +1777,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3257,31 +3257,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html index ec8c196b21..aa58ad780b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1504,17 +1504,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html index a4c9ac89ae..9372efbfbe 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html @@ -105,7 +105,7 @@

Instance Methods

fetchDomainVerificationStatus(siteSearchEngine, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of target sites with its domain verification status. This method can only be called under data store with BASIC_SITE_SEARCH state at the moment.

- fetchDomainVerificationStatus_next(previous_request, previous_response)

+ fetchDomainVerificationStatus_next()

Retrieves the next page of results.

getUriPatternDocumentData(siteSearchEngine, x__xgafv=None)

@@ -289,17 +289,17 @@

Method Details

- fetchDomainVerificationStatus_next(previous_request, previous_response) + fetchDomainVerificationStatus_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.operations.html index f50bee9d25..e2d07c4bf8 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html index 99ea03c524..034ab52053 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html index 131367da81..1116fe9961 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html index b82a9c6dcc..678acf41b5 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -307,7 +307,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -421,7 +421,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -434,7 +434,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -571,7 +571,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -610,7 +610,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -623,7 +623,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -760,7 +760,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html index 8d1717cb15..b9f620ab18 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html @@ -177,6 +177,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -470,6 +471,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -762,6 +764,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.analytics.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.analytics.html index 094eb0f1b1..3c258c268f 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.analytics.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.analytics.html @@ -108,6 +108,11 @@

Method Details

"tableId": "A String", # Required. The table_id of exported BigQuery table. }, }, + "startDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Optional. The earliest date (inclusive), interpreted in the UTC time zone, whose metrics are included in the export. If unset, defaults to 30 days before the current UTC date. The value must be a valid calendar date that is not in the future and not older than 180 days (the source data retention window); otherwise the request fails with `INVALID_ARGUMENT`. + "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. + "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. + "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. + }, } x__xgafv: string, V1 error format. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html index b7a136cb07..9722a2f89e 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Agents under an Assistant which were created by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -420,17 +420,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.cannedQueries.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.cannedQueries.html index 48c7f39376..102af6c907 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.cannedQueries.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.cannedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all CannedQuerys under an Assistant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -305,17 +305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html index 4ee696df9a..b59557d4ab 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Assistants under an Engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.html new file mode 100644 index 0000000000..a25ff20f18 --- /dev/null +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.html @@ -0,0 +1,91 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . collaborativeProjects

+

Instance Methods

+

+ knowledgeSpaces() +

+

Returns the knowledgeSpaces Resource.

+ +

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.html new file mode 100644 index 0000000000..f62120fa20 --- /dev/null +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.html @@ -0,0 +1,91 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . collaborativeProjects . knowledgeSpaces

+

Instance Methods

+

+ operations() +

+

Returns the operations Resource.

+ +

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.operations.html new file mode 100644 index 0000000000..f6bacfcbac --- /dev/null +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.operations.html @@ -0,0 +1,124 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . collaborativeProjects . knowledgeSpaces . operations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(name, x__xgafv=None)

+

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.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(name, x__xgafv=None) + 
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.
+
+Args:
+  name: string, The name of the operation resource. (required)
+  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/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html index 1eab6c91a9..6ead58c828 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html index 9ced93d7b1..98893908a0 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html index cf0befc857..211e4cb76a 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html @@ -84,6 +84,11 @@

Instance Methods

Returns the assistants Resource.

+

+ collaborativeProjects() +

+

Returns the collaborativeProjects Resource.

+

completionConfig()

@@ -144,7 +149,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Engines associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -735,17 +740,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.operations.html index 36a029ae44..6a91d78fb5 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html index 54f6baee12..e0e2cf6000 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1627,7 +1627,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1640,7 +1640,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1777,7 +1777,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3257,31 +3257,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms.html index be3ed47084..05da733add 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, stateFilter=None, x__xgafv=None)

List all AlphaEvolvePrograms in a given experiment that follow the criteria provided in the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.html index bd19cfc15a..60b21a85c1 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.alphaEvolveExperiments.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all AlphaEvolveExperiments in a given session.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resume(name, body=None, x__xgafv=None)

@@ -423,17 +423,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html index c7421bc66a..3046e0946e 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists metadata for all files in the current session.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html index c7f094a70b..ce471b5ed7 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html @@ -110,7 +110,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1519,17 +1519,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html index ff14457a22..e31370f965 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html @@ -177,6 +177,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -470,6 +471,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -762,6 +764,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html index 9d0e7d2e81..c43898fe2a 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html @@ -113,7 +113,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Collections.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1053,17 +1053,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.operations.html index 414d74db52..92069adfdb 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.dataStores.branches.documents.chunks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html index 7f7e176e2d..6eef3b744b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Chunks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.html index 889d412ec9..d7ba7ab738 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -597,17 +597,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.operations.html index 7f045930ae..729d467f3c 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.dataStores.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html index 2204899db9..63f6aa0fe3 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html index 1ea2dedea5..c92b30167c 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html index 700722016c..050523c3dd 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html @@ -181,7 +181,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1220,17 +1220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.models.operations.html index ee4f0c258b..00bfe00118 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.dataStores.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.operations.html index ed2aec7eeb..6230edfb84 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.dataStores.schemas.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html index 6cfc352bae..2be6571b80 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -300,17 +300,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html index 39394d13a0..1f6d6fe369 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1357,17 +1357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1627,7 +1627,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1640,7 +1640,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1777,7 +1777,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3257,31 +3257,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html index 96b0a6cc28..444c896a91 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1504,17 +1504,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.targetSites.html index 594f20f148..6e8306a712 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.targetSites.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -341,17 +341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html index ac90bef85c..385e610325 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -307,7 +307,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -421,7 +421,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -434,7 +434,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -571,7 +571,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -610,7 +610,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -623,7 +623,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -760,7 +760,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html index 7ecee40429..30ed0180cc 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html @@ -177,6 +177,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -470,6 +471,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. @@ -762,6 +764,7 @@

Method Details

"title": "A String", # Optional. Display title of the connector. }, "name": "A String", # The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. + "tag": "A String", # Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on. }, ], "configId": "A String", # Output only. Unique obfuscated identifier of a WidgetConfig. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html index 47e68c3ad9..ae07a95f61 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html @@ -95,10 +95,10 @@

Instance Methods

listResults(evaluation, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of results for a given a Evaluation.

- listResults_next(previous_request, previous_response)

+ listResults_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1173,31 +1173,31 @@

Method Details

- listResults_next(previous_request, previous_response) + listResults_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html index 73b490db6c..fad4edd42b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html @@ -101,10 +101,10 @@

Instance Methods

listIdentityMappings(identityMappingStore, pageSize=None, pageToken=None, x__xgafv=None)

Lists Identity Mappings in an Identity Mapping Store.

- listIdentityMappings_next(previous_request, previous_response)

+ listIdentityMappings_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

purgeIdentityMappings(identityMappingStore, body=None, x__xgafv=None)

@@ -389,31 +389,31 @@

Method Details

- listIdentityMappings_next(previous_request, previous_response) + listIdentityMappings_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.operations.html index 7410c08b96..4dfb945209 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.licenseConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.licenseConfigs.html index d82b1b9f17..baa4528196 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.licenseConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.licenseConfigs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the LicenseConfigs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -128,6 +128,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -184,6 +185,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -246,6 +248,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -313,6 +316,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -344,17 +348,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -387,6 +391,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. @@ -443,6 +448,7 @@

Method Details

"regionCode": "A String", # Optional. The region code used of the user that subscribed to the alert policy. }, "autoRenew": True or False, # Optional. Whether the license config should be auto renewed when it reaches the end date. + "billingAccountLicenseConfig": "A String", # Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set. "earlyTerminated": True or False, # Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. "earlyTerminationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date when the subscription is terminated earlier than the expiration date. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html index 59e85fabce..466b1c6449 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html @@ -100,7 +100,7 @@

Instance Methods

listRecentlyViewed(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the notebooks ordered by last view time.

- listRecentlyViewed_next(previous_request, previous_response)

+ listRecentlyViewed_next()

Retrieves the next page of results.

share(name, body=None, x__xgafv=None)

@@ -538,17 +538,17 @@

Method Details

- listRecentlyViewed_next(previous_request, previous_response) + listRecentlyViewed_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.operations.html index d53afcae71..987b0b87f1 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.sampleQuerySets.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.html index 2924cc4c8d..b8b8d7c09b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of SampleQuerySets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.sampleQueries.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.sampleQueries.html index e700b0ef33..eb4f61c260 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.sampleQueries.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.sampleQuerySets.sampleQueries.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of SampleQuerys.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -329,17 +329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html index 98ad9adee1..a59ea3593f 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html @@ -154,7 +154,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -167,7 +167,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -304,7 +304,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -375,7 +375,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -388,7 +388,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -525,7 +525,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -564,7 +564,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -577,7 +577,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -714,7 +714,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.operations.html index c1bbcd993c..296e7e6e17 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.locations.userStores.userLicenses.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.userLicenses.html index bc5cc68703..705b43e0dd 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.userLicenses.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.userStores.userLicenses.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the User Licenses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1alpha.projects.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.operations.html index a18fd2e9bf..b4e71d737d 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.operations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.html b/docs/dyn/discoveryengine_v1beta.html index 316e060e75..16fd661ae9 100644 --- a/docs/dyn/discoveryengine_v1beta.html +++ b/docs/dyn/discoveryengine_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataConnector.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataConnector.operations.html index 18fc4bb0e5..fc661df805 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataConnector.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataConnector.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.documents.html index 1b0ec5ff10..257cd21f56 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.operations.html index 62ae7ec87d..46c6829a25 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html index f4654bf369..0bb22b2844 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html index bab4896fbb..b764ed075d 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html index fd4787fa29..08263322a0 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html @@ -169,7 +169,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -907,17 +907,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.models.operations.html index d38dcd0de3..123d7949cc 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.operations.html index dbfdb49237..1542399cc8 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.schemas.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.html index 71da821e66..d6a00e785e 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.operations.html index becd613844..4d045f0463 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.schemas.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html index 8a3b2da79a..9aecc3198d 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1247,17 +1247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1501,7 +1501,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1514,7 +1514,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1614,7 +1614,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3086,31 +3086,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html index 988e045165..ef4f345766 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1352,17 +1352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html index 524b9f8a57..41ba775460 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html @@ -105,7 +105,7 @@

Instance Methods

fetchDomainVerificationStatus(siteSearchEngine, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of target sites with its domain verification status. This method can only be called under data store with BASIC_SITE_SEARCH state at the moment.

- fetchDomainVerificationStatus_next(previous_request, previous_response)

+ fetchDomainVerificationStatus_next()

Retrieves the next page of results.

recrawlUris(siteSearchEngine, body=None, x__xgafv=None)

@@ -283,17 +283,17 @@

Method Details

- fetchDomainVerificationStatus_next(previous_request, previous_response) + fetchDomainVerificationStatus_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.operations.html index a7a2cfd02a..c26d0f5953 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html index ff8680dd56..7618186a3e 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html index 542f7d19c4..3619f75589 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html index 145a125dae..0e2a8ad70a 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -270,7 +270,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -384,7 +384,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -397,7 +397,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -497,7 +497,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -536,7 +536,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -549,7 +549,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -649,7 +649,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html index ceb9a5fe66..66e0d12ef8 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Assistants under an Engine.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -380,17 +380,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html index 55e3ddcf49..6ab5f1c9cd 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html index c47c399171..7472166e22 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html index f6f8ce3d11..fe3e8315bc 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html @@ -128,7 +128,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Engines associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -641,17 +641,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.operations.html index c34c45179c..083c318020 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html index 0aa0834e66..c92c3121d8 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1247,17 +1247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1501,7 +1501,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1514,7 +1514,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1614,7 +1614,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3086,31 +3086,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html index 354790c89b..b222236076 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1352,17 +1352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.operations.html index cb5e1958bc..293df54c6e 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.dataStores.branches.documents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.documents.html index d048d0c5c6..9c8ea1464d 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.documents.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.documents.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Documents.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -557,17 +557,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.operations.html index 207f767d79..0d7e7e3c9b 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.dataStores.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html index 5d375f4e34..b83455853c 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html index 8ce5811167..eb319c9d24 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Conversations by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html index 0e77add2a4..3934a70dfc 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html @@ -164,7 +164,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DataStores associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -899,17 +899,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.models.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.models.operations.html index 5c9ea4f1e8..d35e0796a0 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.models.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.models.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.dataStores.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.operations.html index bba8b8001f..92bc06f064 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.dataStores.schemas.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.schemas.html index 8454531f5b..927c7a7985 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.schemas.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.schemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html index 9e23bd7c09..043d2b9ddc 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this dataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -108,10 +108,10 @@

Instance Methods

searchLite(servingConfig, body=None, x__xgafv=None)

Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.

- searchLite_next(previous_request, previous_response)

+ searchLite_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

streamAnswer(servingConfig, body=None, x__xgafv=None)

@@ -1247,17 +1247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1501,7 +1501,7 @@

Method Details

"a_key": "", }, "userEvent": { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. # Required. Context about the user, what they are looking at and what action they took to trigger the Recommend request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.user_pseudo_id or UserEvent.user_info.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.user_pseudo_id to a random unique ID and leave UserEvent.user_info.user_id unset. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -1514,7 +1514,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -1614,7 +1614,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -3086,31 +3086,31 @@

Method Details

- searchLite_next(previous_request, previous_response) + searchLite_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html index d86e3f8487..73e7fd2c38 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Sessions by their parent DataStore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1352,17 +1352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.targetSites.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.targetSites.html index 9b1dad9301..f6fb2532ab 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.targetSites.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.targetSites.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of TargetSites.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -341,17 +341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html index 2776da8b29..fc8db23504 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html @@ -157,7 +157,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -170,7 +170,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -270,7 +270,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -384,7 +384,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -397,7 +397,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -497,7 +497,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -536,7 +536,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -549,7 +549,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -649,7 +649,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html index 53000c2dbc..6f974a174a 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html @@ -95,10 +95,10 @@

Instance Methods

listResults(evaluation, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of results for a given a Evaluation.

- listResults_next(previous_request, previous_response)

+ listResults_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1161,31 +1161,31 @@

Method Details

- listResults_next(previous_request, previous_response) + listResults_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html index d55c615249..0196e9973a 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html @@ -101,10 +101,10 @@

Instance Methods

listIdentityMappings(identityMappingStore, pageSize=None, pageToken=None, x__xgafv=None)

Lists Identity Mappings in an Identity Mapping Store.

- listIdentityMappings_next(previous_request, previous_response)

+ listIdentityMappings_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

purgeIdentityMappings(identityMappingStore, body=None, x__xgafv=None)

@@ -365,31 +365,31 @@

Method Details

- listIdentityMappings_next(previous_request, previous_response) + listIdentityMappings_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.operations.html index ea68218cda..72ada3d6c5 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.licenseConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.licenseConfigs.html index 04da7103ce..d1342de634 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.licenseConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.licenseConfigs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the LicenseConfigs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.operations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.operations.html index a4082bbe49..27482b229a 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.locations.sampleQuerySets.html b/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.html index 03b69678c2..15b6e10dbe 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of SampleQuerySets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.sampleQueries.html b/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.sampleQueries.html index 3bea950ddc..a80c2af105 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.sampleQueries.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.sampleQuerySets.sampleQueries.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of SampleQuerys.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -329,17 +329,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html index e42f1f1901..9834b60b14 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html @@ -154,7 +154,7 @@

Method Details

"inlineSource": { # The inline source for the input config for ImportUserEvents method. # The Inline source for the input content for UserEvents. "userEvents": [ # Required. A list of user events to import. Recommended max of 10k items. { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -167,7 +167,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -267,7 +267,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -338,7 +338,7 @@

Method Details

The object takes the form of: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -351,7 +351,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -451,7 +451,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. @@ -490,7 +490,7 @@

Method Details

An object of the form: { # UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website. - "attributes": { # Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. + "attributes": { # Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways. "a_key": { # A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent. "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of CustomAttribute.text or CustomAttribute.numbers should be set. Otherwise, an `INVALID_ARGUMENT` error is returned. 3.14, @@ -503,7 +503,7 @@

Method Details

"attributionToken": "A String", # Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field. "completionInfo": { # Detailed completion information including completion attribution token and clicked completion info. # CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search. "selectedPosition": 42, # End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0. - "selectedSuggestion": "A String", # End user selected CompleteQueryResponse.QuerySuggestion.suggestion. + "selectedSuggestion": "A String", # Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion. }, "conversionType": "A String", # Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by "-", such as "watch", "good-visit" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc. "dataStore": "A String", # The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted. @@ -603,7 +603,7 @@

Method Details

"searchInfo": { # Detailed search information. # SearchService.Search details related to the event. This field should be set for `search` event. "offset": 42, # An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. "orderBy": "A String", # The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. - "searchQuery": "A String", # The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. + "searchQuery": "A String", # Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned. }, "sessionId": "A String", # A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix. "tagIds": [ # A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.userStores.userLicenses.html b/docs/dyn/discoveryengine_v1beta.projects.locations.userStores.userLicenses.html index c6ee676133..db99172736 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.userStores.userLicenses.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.userStores.userLicenses.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the User Licenses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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_v1beta.projects.operations.html b/docs/dyn/discoveryengine_v1beta.projects.operations.html index 196b488cc2..f3ddaef163 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.operations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.campaigns.html b/docs/dyn/displayvideo_v2.advertisers.campaigns.html index 9a87eb4953..58fd6ff3fb 100644 --- a/docs/dyn/displayvideo_v2.advertisers.campaigns.html +++ b/docs/dyn/displayvideo_v2.advertisers.campaigns.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists campaigns in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, campaigns with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, campaignId, body=None, updateMask=None, x__xgafv=None)

@@ -467,17 +467,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.channels.html b/docs/dyn/displayvideo_v2.advertisers.channels.html index 505de63b79..26eff8b5a4 100644 --- a/docs/dyn/displayvideo_v2.advertisers.channels.html +++ b/docs/dyn/displayvideo_v2.advertisers.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, channelId, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.channels.sites.html b/docs/dyn/displayvideo_v2.advertisers.channels.sites.html index 51cc149f0d..18d50622f3 100644 --- a/docs/dyn/displayvideo_v2.advertisers.channels.sites.html +++ b/docs/dyn/displayvideo_v2.advertisers.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, channelId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.creatives.html b/docs/dyn/displayvideo_v2.advertisers.creatives.html index 7ed67b266e..9ff9f8696c 100644 --- a/docs/dyn/displayvideo_v2.advertisers.creatives.html +++ b/docs/dyn/displayvideo_v2.advertisers.creatives.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists creatives in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, creatives with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, creativeId, body=None, updateMask=None, x__xgafv=None)

@@ -791,17 +791,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.html b/docs/dyn/displayvideo_v2.advertisers.html index 2890890dad..8110cffc33 100644 --- a/docs/dyn/displayvideo_v2.advertisers.html +++ b/docs/dyn/displayvideo_v2.advertisers.html @@ -164,10 +164,10 @@

Instance Methods

listAssignedTargetingOptions(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options of an advertiser across targeting types.

- listAssignedTargetingOptions_next(previous_request, previous_response)

+ listAssignedTargetingOptions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, body=None, updateMask=None, x__xgafv=None)

@@ -482,7 +482,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -795,7 +795,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1263,7 +1263,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1445,31 +1445,31 @@

Method Details

- listAssignedTargetingOptions_next(previous_request, previous_response) + listAssignedTargetingOptions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html b/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html index c1ad894f77..1922bab3ce 100644 --- a/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html +++ b/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insertion orders in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, insertion orders with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, insertionOrderId, body=None, updateMask=None, x__xgafv=None)

@@ -543,17 +543,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.invoices.html b/docs/dyn/displayvideo_v2.advertisers.invoices.html index b5bcd32951..2a9c1b59e7 100644 --- a/docs/dyn/displayvideo_v2.advertisers.invoices.html +++ b/docs/dyn/displayvideo_v2.advertisers.invoices.html @@ -81,7 +81,7 @@

Instance Methods

list(advertiserId, issueMonth=None, loiSapinInvoiceType=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists invoices posted for an advertiser in a given month. Invoices generated by billing profiles with a "Partner" invoice level are not retrievable through this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupInvoiceCurrency(advertiserId, invoiceMonth=None, x__xgafv=None)

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.lineItems.html b/docs/dyn/displayvideo_v2.advertisers.lineItems.html index 61de663f5a..b306f83fc8 100644 --- a/docs/dyn/displayvideo_v2.advertisers.lineItems.html +++ b/docs/dyn/displayvideo_v2.advertisers.lineItems.html @@ -86,7 +86,7 @@

Instance Methods

bulkListAssignedTargetingOptions(advertiserId, filter=None, lineItemIds=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options for multiple line items across targeting types.

- bulkListAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAssignedTargetingOptions_next()

Retrieves the next page of results.

bulkUpdate(advertiserId, body=None, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists line items in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, line items with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, lineItemId, body=None, updateMask=None, x__xgafv=None)

@@ -242,7 +242,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -599,7 +599,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -783,17 +783,17 @@

Method Details

- bulkListAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -2069,17 +2069,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html index 354e46c2f8..35b86620e2 100644 --- a/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, lineItemId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a line item.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -273,7 +273,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -571,7 +571,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1002,7 +1002,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1366,7 +1366,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1548,17 +1548,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.locationLists.assignedLocations.html b/docs/dyn/displayvideo_v2.advertisers.locationLists.assignedLocations.html index 6fa0b8a070..7b37500da3 100644 --- a/docs/dyn/displayvideo_v2.advertisers.locationLists.assignedLocations.html +++ b/docs/dyn/displayvideo_v2.advertisers.locationLists.assignedLocations.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, locationListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations assigned to a location list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.locationLists.html b/docs/dyn/displayvideo_v2.advertisers.locationLists.html index f70cfcedac..1baf4b9000 100644 --- a/docs/dyn/displayvideo_v2.advertisers.locationLists.html +++ b/docs/dyn/displayvideo_v2.advertisers.locationLists.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists location lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, locationListId, body=None, updateMask=None, x__xgafv=None)

@@ -194,17 +194,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.manualTriggers.html b/docs/dyn/displayvideo_v2.advertisers.manualTriggers.html index d6d3ac8266..db07ce4091 100644 --- a/docs/dyn/displayvideo_v2.advertisers.manualTriggers.html +++ b/docs/dyn/displayvideo_v2.advertisers.manualTriggers.html @@ -93,7 +93,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required. **Warning:** Line Items using manual triggers no longer serve in Display & Video 360. This method will sunset on August 1, 2023. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, triggerId, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.html b/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.html index 42cd7881d4..71ab67f4a0 100644 --- a/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.html +++ b/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keyword lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, negativeKeywordListId, body=None, updateMask=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.negativeKeywords.html b/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.negativeKeywords.html index 9909edf826..4ff1a350cf 100644 --- a/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.negativeKeywords.html +++ b/docs/dyn/displayvideo_v2.advertisers.negativeKeywordLists.negativeKeywords.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, negativeKeywordListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keywords in a negative keyword list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, negativeKeywordListId, body=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html index af29e78b5d..082b50bb9f 100644 --- a/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to an advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -272,7 +272,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -570,7 +570,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -999,7 +999,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1362,7 +1362,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1544,17 +1544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.youtubeAdGroupAds.html b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html index cdc21533f9..757104e621 100644 --- a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html +++ b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists YouTube ad group ads.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,15 +123,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, "bumperAd": { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -140,12 +140,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -156,10 +156,10 @@

Method Details

}, "entityStatus": "A String", # The entity status of the ad. "inStreamAd": { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -168,16 +168,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -190,7 +190,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -199,17 +199,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # The resource name of the ad. "nonSkippableAd": { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -218,16 +218,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -238,15 +238,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, "videoPerformanceAd": { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -257,27 +257,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -322,15 +322,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, "bumperAd": { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -339,12 +339,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -355,10 +355,10 @@

Method Details

}, "entityStatus": "A String", # The entity status of the ad. "inStreamAd": { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -367,16 +367,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -389,7 +389,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -398,17 +398,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # The resource name of the ad. "nonSkippableAd": { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -417,16 +417,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -437,15 +437,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, "videoPerformanceAd": { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -456,27 +456,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -487,17 +487,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.youtubeAdGroups.html b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.html index f17282b828..d8e4d05663 100644 --- a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.html +++ b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.html @@ -83,7 +83,7 @@

Instance Methods

bulkListAdGroupAssignedTargetingOptions(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None, youtubeAdGroupIds=None)

Lists assigned targeting options for multiple YouTube ad groups across targeting types. Inherited assigned targeting options are not included.

- bulkListAdGroupAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAdGroupAssignedTargetingOptions_next()

Retrieves the next page of results.

close()

@@ -95,7 +95,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists YouTube ad groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -234,7 +234,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -417,17 +417,17 @@

Method Details

- bulkListAdGroupAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAdGroupAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -550,17 +550,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html index 569406275b..2ebcaac56d 100644 --- a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId, youtubeAdGroupId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a YouTube ad group. Inherited assigned targeting options are not included.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -273,7 +273,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -637,7 +637,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -819,17 +819,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.combinedAudiences.html b/docs/dyn/displayvideo_v2.combinedAudiences.html index 4ed7a0fa5c..7ee7bd63b6 100644 --- a/docs/dyn/displayvideo_v2.combinedAudiences.html +++ b/docs/dyn/displayvideo_v2.combinedAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists combined audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.customBiddingAlgorithms.html b/docs/dyn/displayvideo_v2.customBiddingAlgorithms.html index 1a8738c5a3..090b85b260 100644 --- a/docs/dyn/displayvideo_v2.customBiddingAlgorithms.html +++ b/docs/dyn/displayvideo_v2.customBiddingAlgorithms.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customBiddingAlgorithmId, body=None, updateMask=None, x__xgafv=None)

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.customBiddingAlgorithms.scripts.html b/docs/dyn/displayvideo_v2.customBiddingAlgorithms.scripts.html index baa6c8ceda..f592bb6914 100644 --- a/docs/dyn/displayvideo_v2.customBiddingAlgorithms.scripts.html +++ b/docs/dyn/displayvideo_v2.customBiddingAlgorithms.scripts.html @@ -87,7 +87,7 @@

Instance Methods

list(customBiddingAlgorithmId, advertiserId=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding scripts that belong to the given algorithm. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.customLists.html b/docs/dyn/displayvideo_v2.customLists.html index 54ee368350..67f4fe4687 100644 --- a/docs/dyn/displayvideo_v2.customLists.html +++ b/docs/dyn/displayvideo_v2.customLists.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists custom lists. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.floodlightGroups.floodlightActivities.html b/docs/dyn/displayvideo_v2.floodlightGroups.floodlightActivities.html index 7d2a6f2799..8c9743587d 100644 --- a/docs/dyn/displayvideo_v2.floodlightGroups.floodlightActivities.html +++ b/docs/dyn/displayvideo_v2.floodlightGroups.floodlightActivities.html @@ -84,7 +84,7 @@

Instance Methods

list(floodlightGroupId, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Floodlight activities in a Floodlight group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.googleAudiences.html b/docs/dyn/displayvideo_v2.googleAudiences.html index b458b43c31..0e45e29c2c 100644 --- a/docs/dyn/displayvideo_v2.googleAudiences.html +++ b/docs/dyn/displayvideo_v2.googleAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Google audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.guaranteedOrders.html b/docs/dyn/displayvideo_v2.guaranteedOrders.html index 033801f68b..6a58d72dd0 100644 --- a/docs/dyn/displayvideo_v2.guaranteedOrders.html +++ b/docs/dyn/displayvideo_v2.guaranteedOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists guaranteed orders that are accessible to the current user. The order is defined by the order_by parameter. If a filter by entity_status is not specified, guaranteed orders with entity status `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(guaranteedOrderId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -291,17 +291,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.html b/docs/dyn/displayvideo_v2.html index dd548884c9..998ed54666 100644 --- a/docs/dyn/displayvideo_v2.html +++ b/docs/dyn/displayvideo_v2.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/displayvideo_v2.inventorySourceGroups.assignedInventorySources.html b/docs/dyn/displayvideo_v2.inventorySourceGroups.assignedInventorySources.html index 01abfc50a2..4f92f6a155 100644 --- a/docs/dyn/displayvideo_v2.inventorySourceGroups.assignedInventorySources.html +++ b/docs/dyn/displayvideo_v2.inventorySourceGroups.assignedInventorySources.html @@ -90,7 +90,7 @@

Instance Methods

list(inventorySourceGroupId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory sources assigned to an inventory source group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.inventorySourceGroups.html b/docs/dyn/displayvideo_v2.inventorySourceGroups.html index 88ca349a65..99c7e3a86a 100644 --- a/docs/dyn/displayvideo_v2.inventorySourceGroups.html +++ b/docs/dyn/displayvideo_v2.inventorySourceGroups.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory source groups that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(inventorySourceGroupId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.partners.channels.html b/docs/dyn/displayvideo_v2.partners.channels.html index c823163187..7b27808b95 100644 --- a/docs/dyn/displayvideo_v2.partners.channels.html +++ b/docs/dyn/displayvideo_v2.partners.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(partnerId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(partnerId, channelId, advertiserId=None, body=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.partners.channels.sites.html b/docs/dyn/displayvideo_v2.partners.channels.sites.html index 66bcb95e92..e1d3edec18 100644 --- a/docs/dyn/displayvideo_v2.partners.channels.sites.html +++ b/docs/dyn/displayvideo_v2.partners.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, channelId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(partnerId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v2.partners.html b/docs/dyn/displayvideo_v2.partners.html index 46bd29700d..f71505c82b 100644 --- a/docs/dyn/displayvideo_v2.partners.html +++ b/docs/dyn/displayvideo_v2.partners.html @@ -97,7 +97,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists partners that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -231,7 +231,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -544,7 +544,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -831,17 +831,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html index 51ce499dbb..33c637eb5d 100644 --- a/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a partner.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -272,7 +272,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -570,7 +570,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -999,7 +999,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1362,7 +1362,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1544,17 +1544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.targetingTypes.targetingOptions.html b/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html index a88a13171d..3b82ff521f 100644 --- a/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html +++ b/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html @@ -84,13 +84,13 @@

Instance Methods

list(targetingType, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists targeting options of a given type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(targetingType, body=None, x__xgafv=None)

Searches for targeting options of a given type based on the given search terms.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -465,17 +465,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -680,17 +680,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v2.users.html b/docs/dyn/displayvideo_v2.users.html index b74bd8ba76..d1c714a460 100644 --- a/docs/dyn/displayvideo_v2.users.html +++ b/docs/dyn/displayvideo_v2.users.html @@ -93,7 +93,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The "Try this method" feature does not work for this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(userId, body=None, updateMask=None, x__xgafv=None)

@@ -285,17 +285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html b/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html index 3bd5229640..60492f1a1d 100644 --- a/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html +++ b/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ad group ads.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)

@@ -259,15 +259,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -276,12 +276,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -291,7 +291,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -347,7 +347,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -409,7 +409,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -433,7 +433,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -476,7 +476,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -486,11 +486,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -499,16 +499,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -521,7 +521,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -530,17 +530,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -549,16 +549,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -569,15 +569,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -588,27 +588,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -772,15 +772,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -789,12 +789,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -804,7 +804,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -860,7 +860,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -922,7 +922,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -946,7 +946,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -989,7 +989,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -999,11 +999,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1012,16 +1012,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1034,7 +1034,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1043,17 +1043,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1062,16 +1062,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1082,15 +1082,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -1101,27 +1101,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1312,15 +1312,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1329,12 +1329,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -1344,7 +1344,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -1400,7 +1400,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1462,7 +1462,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1486,7 +1486,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -1529,7 +1529,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1539,11 +1539,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1552,16 +1552,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1574,7 +1574,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1583,17 +1583,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1602,16 +1602,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1622,15 +1622,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -1641,27 +1641,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1838,15 +1838,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1855,12 +1855,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -1870,7 +1870,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -1926,7 +1926,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1988,7 +1988,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2012,7 +2012,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -2055,7 +2055,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2065,11 +2065,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2078,16 +2078,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2100,7 +2100,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2109,17 +2109,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2128,16 +2128,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2148,15 +2148,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -2167,27 +2167,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2199,17 +2199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2371,15 +2371,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2388,12 +2388,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -2403,7 +2403,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -2459,7 +2459,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2521,7 +2521,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2545,7 +2545,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -2588,7 +2588,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2598,11 +2598,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2611,16 +2611,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2633,7 +2633,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2642,17 +2642,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2661,16 +2661,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2681,15 +2681,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -2700,27 +2700,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2885,15 +2885,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2902,12 +2902,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -2917,7 +2917,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -2973,7 +2973,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -3035,7 +3035,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -3059,7 +3059,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -3102,7 +3102,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -3112,11 +3112,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -3125,16 +3125,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -3147,7 +3147,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -3156,17 +3156,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -3175,16 +3175,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -3195,15 +3195,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -3214,27 +3214,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroups.html b/docs/dyn/displayvideo_v3.advertisers.adGroups.html index f1933e25b8..865f5e7be5 100644 --- a/docs/dyn/displayvideo_v3.advertisers.adGroups.html +++ b/docs/dyn/displayvideo_v3.advertisers.adGroups.html @@ -86,7 +86,7 @@

Instance Methods

bulkListAdGroupAssignedTargetingOptions(advertiserId, adGroupIds=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options for multiple ad groups across targeting types. Inherited assigned targeting options are not included.

- bulkListAdGroupAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAdGroupAssignedTargetingOptions_next()

Retrieves the next page of results.

close()

@@ -104,7 +104,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ad groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, adGroupId, body=None, updateMask=None, x__xgafv=None)

@@ -262,7 +262,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -660,7 +660,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -863,17 +863,17 @@

Method Details

- bulkListAdGroupAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAdGroupAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -1235,17 +1235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html index 1b6aa9df79..c49be843f3 100644 --- a/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, adGroupId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to an ad group. Inherited assigned targeting options are not included.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -297,7 +297,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -638,7 +638,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1114,7 +1114,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1522,7 +1522,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1724,17 +1724,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.advertisers.campaigns.html b/docs/dyn/displayvideo_v3.advertisers.campaigns.html index afca6beba5..34e22a2e98 100644 --- a/docs/dyn/displayvideo_v3.advertisers.campaigns.html +++ b/docs/dyn/displayvideo_v3.advertisers.campaigns.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists campaigns in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, campaigns with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, campaignId, body=None, updateMask=None, x__xgafv=None)

@@ -467,17 +467,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.channels.html b/docs/dyn/displayvideo_v3.advertisers.channels.html index 00de72d6f3..2999f20605 100644 --- a/docs/dyn/displayvideo_v3.advertisers.channels.html +++ b/docs/dyn/displayvideo_v3.advertisers.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, channelId, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.channels.sites.html b/docs/dyn/displayvideo_v3.advertisers.channels.sites.html index a5019a7561..7c78934558 100644 --- a/docs/dyn/displayvideo_v3.advertisers.channels.sites.html +++ b/docs/dyn/displayvideo_v3.advertisers.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, channelId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.creatives.html b/docs/dyn/displayvideo_v3.advertisers.creatives.html index 9692b812fc..d436218dbe 100644 --- a/docs/dyn/displayvideo_v3.advertisers.creatives.html +++ b/docs/dyn/displayvideo_v3.advertisers.creatives.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists creatives in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, creatives with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, creativeId, body=None, updateMask=None, x__xgafv=None)

@@ -791,17 +791,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.html b/docs/dyn/displayvideo_v3.advertisers.html index 9f0e5cea4c..bf6d99adc1 100644 --- a/docs/dyn/displayvideo_v3.advertisers.html +++ b/docs/dyn/displayvideo_v3.advertisers.html @@ -159,10 +159,10 @@

Instance Methods

listAssignedTargetingOptions(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options of an advertiser across targeting types.

- listAssignedTargetingOptions_next(previous_request, previous_response)

+ listAssignedTargetingOptions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, body=None, updateMask=None, x__xgafv=None)

@@ -506,7 +506,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -862,7 +862,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1379,7 +1379,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1581,31 +1581,31 @@

Method Details

- listAssignedTargetingOptions_next(previous_request, previous_response) + listAssignedTargetingOptions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html b/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html index b08ba79b1b..0bd5198866 100644 --- a/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html +++ b/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insertion orders in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, insertion orders with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, insertionOrderId, body=None, updateMask=None, x__xgafv=None)

@@ -571,17 +571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.invoices.html b/docs/dyn/displayvideo_v3.advertisers.invoices.html index 8427c92ad8..adb0fe055d 100644 --- a/docs/dyn/displayvideo_v3.advertisers.invoices.html +++ b/docs/dyn/displayvideo_v3.advertisers.invoices.html @@ -81,7 +81,7 @@

Instance Methods

list(advertiserId, issueMonth=None, loiSapinInvoiceType=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists invoices posted for an advertiser in a given month. Invoices generated by billing profiles with a "Partner" invoice level are not retrievable through this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupInvoiceCurrency(advertiserId, invoiceMonth=None, x__xgafv=None)

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.lineItems.html b/docs/dyn/displayvideo_v3.advertisers.lineItems.html index 320398680c..9caf777c26 100644 --- a/docs/dyn/displayvideo_v3.advertisers.lineItems.html +++ b/docs/dyn/displayvideo_v3.advertisers.lineItems.html @@ -86,7 +86,7 @@

Instance Methods

bulkListAssignedTargetingOptions(advertiserId, filter=None, lineItemIds=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options for multiple line items across targeting types.

- bulkListAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAssignedTargetingOptions_next()

Retrieves the next page of results.

bulkUpdate(advertiserId, body=None, x__xgafv=None)

@@ -110,7 +110,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists line items in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, line items with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, lineItemId, body=None, updateMask=None, x__xgafv=None)

@@ -265,7 +265,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -665,7 +665,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -869,17 +869,17 @@

Method Details

- bulkListAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -2155,17 +2155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html index f1c7d4fba3..0de6f922c1 100644 --- a/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, lineItemId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a line item.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -297,7 +297,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -638,7 +638,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1114,7 +1114,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1522,7 +1522,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1724,17 +1724,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.advertisers.locationLists.assignedLocations.html b/docs/dyn/displayvideo_v3.advertisers.locationLists.assignedLocations.html index 513eddaf3f..f99fc0e549 100644 --- a/docs/dyn/displayvideo_v3.advertisers.locationLists.assignedLocations.html +++ b/docs/dyn/displayvideo_v3.advertisers.locationLists.assignedLocations.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, locationListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations assigned to a location list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.advertisers.locationLists.html b/docs/dyn/displayvideo_v3.advertisers.locationLists.html index 43d4349e33..42f9c53424 100644 --- a/docs/dyn/displayvideo_v3.advertisers.locationLists.html +++ b/docs/dyn/displayvideo_v3.advertisers.locationLists.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists location lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, locationListId, body=None, updateMask=None, x__xgafv=None)

@@ -194,17 +194,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.html b/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.html index be2384095b..0b1523bcc3 100644 --- a/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.html +++ b/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keyword lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, negativeKeywordListId, body=None, updateMask=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.negativeKeywords.html b/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.negativeKeywords.html index 1a0ae25c7e..bd35d7c264 100644 --- a/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.negativeKeywords.html +++ b/docs/dyn/displayvideo_v3.advertisers.negativeKeywordLists.negativeKeywords.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, negativeKeywordListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keywords in a negative keyword list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, negativeKeywordListId, body=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html index c2fa926546..d22fd85f2c 100644 --- a/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to an advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,7 +296,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -637,7 +637,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1111,7 +1111,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1518,7 +1518,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.combinedAudiences.html b/docs/dyn/displayvideo_v3.combinedAudiences.html index 09a587437b..8eb3dfd619 100644 --- a/docs/dyn/displayvideo_v3.combinedAudiences.html +++ b/docs/dyn/displayvideo_v3.combinedAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists combined audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.customBiddingAlgorithms.html b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.html index 1101d75b4b..1cd01fec11 100644 --- a/docs/dyn/displayvideo_v3.customBiddingAlgorithms.html +++ b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.html @@ -97,7 +97,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customBiddingAlgorithmId, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.customBiddingAlgorithms.rules.html b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.rules.html index 15e8b71eab..bcabefe698 100644 --- a/docs/dyn/displayvideo_v3.customBiddingAlgorithms.rules.html +++ b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.rules.html @@ -87,7 +87,7 @@

Instance Methods

list(customBiddingAlgorithmId, advertiserId=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists rules resources that belong to the given algorithm. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.customBiddingAlgorithms.scripts.html b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.scripts.html index 5040b7ee94..5c9c8992f2 100644 --- a/docs/dyn/displayvideo_v3.customBiddingAlgorithms.scripts.html +++ b/docs/dyn/displayvideo_v3.customBiddingAlgorithms.scripts.html @@ -87,7 +87,7 @@

Instance Methods

list(customBiddingAlgorithmId, advertiserId=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding scripts that belong to the given algorithm. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.customLists.html b/docs/dyn/displayvideo_v3.customLists.html index 4fc2157967..754bdc0056 100644 --- a/docs/dyn/displayvideo_v3.customLists.html +++ b/docs/dyn/displayvideo_v3.customLists.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists custom lists. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.floodlightGroups.floodlightActivities.html b/docs/dyn/displayvideo_v3.floodlightGroups.floodlightActivities.html index f584a1aac1..7863d39dd1 100644 --- a/docs/dyn/displayvideo_v3.floodlightGroups.floodlightActivities.html +++ b/docs/dyn/displayvideo_v3.floodlightGroups.floodlightActivities.html @@ -84,7 +84,7 @@

Instance Methods

list(floodlightGroupId, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Floodlight activities in a Floodlight group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.googleAudiences.html b/docs/dyn/displayvideo_v3.googleAudiences.html index 292c95af73..5d8de0dd34 100644 --- a/docs/dyn/displayvideo_v3.googleAudiences.html +++ b/docs/dyn/displayvideo_v3.googleAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Google audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.guaranteedOrders.html b/docs/dyn/displayvideo_v3.guaranteedOrders.html index b40053874f..b48265fd70 100644 --- a/docs/dyn/displayvideo_v3.guaranteedOrders.html +++ b/docs/dyn/displayvideo_v3.guaranteedOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists guaranteed orders that are accessible to the current user. The order is defined by the order_by parameter. If a filter by entity_status is not specified, guaranteed orders with entity status `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(guaranteedOrderId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -291,17 +291,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.html b/docs/dyn/displayvideo_v3.html index 6be79750c8..1707148b23 100644 --- a/docs/dyn/displayvideo_v3.html +++ b/docs/dyn/displayvideo_v3.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/displayvideo_v3.inventorySourceGroups.assignedInventorySources.html b/docs/dyn/displayvideo_v3.inventorySourceGroups.assignedInventorySources.html index 6a866543bd..f80509ece7 100644 --- a/docs/dyn/displayvideo_v3.inventorySourceGroups.assignedInventorySources.html +++ b/docs/dyn/displayvideo_v3.inventorySourceGroups.assignedInventorySources.html @@ -90,7 +90,7 @@

Instance Methods

list(inventorySourceGroupId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory sources assigned to an inventory source group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.inventorySourceGroups.html b/docs/dyn/displayvideo_v3.inventorySourceGroups.html index d509676dec..5805b5d20f 100644 --- a/docs/dyn/displayvideo_v3.inventorySourceGroups.html +++ b/docs/dyn/displayvideo_v3.inventorySourceGroups.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory source groups that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(inventorySourceGroupId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.partners.channels.html b/docs/dyn/displayvideo_v3.partners.channels.html index da68d0c563..8b26b530a3 100644 --- a/docs/dyn/displayvideo_v3.partners.channels.html +++ b/docs/dyn/displayvideo_v3.partners.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(partnerId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(partnerId, channelId, advertiserId=None, body=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.partners.channels.sites.html b/docs/dyn/displayvideo_v3.partners.channels.sites.html index 0b615b475c..ac3e80be3a 100644 --- a/docs/dyn/displayvideo_v3.partners.channels.sites.html +++ b/docs/dyn/displayvideo_v3.partners.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, channelId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(partnerId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v3.partners.html b/docs/dyn/displayvideo_v3.partners.html index 0a666febf1..8064e8455f 100644 --- a/docs/dyn/displayvideo_v3.partners.html +++ b/docs/dyn/displayvideo_v3.partners.html @@ -97,7 +97,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists partners that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -254,7 +254,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -610,7 +610,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -923,17 +923,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html index edf125ff47..1be32336ed 100644 --- a/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a partner.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,7 +296,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -637,7 +637,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1111,7 +1111,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1518,7 +1518,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.targetingTypes.targetingOptions.html b/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html index 3b1de218ad..387f1231d1 100644 --- a/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html +++ b/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html @@ -84,13 +84,13 @@

Instance Methods

list(targetingType, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists targeting options of a given type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(targetingType, body=None, x__xgafv=None)

Searches for targeting options of a given type based on the given search terms.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -473,17 +473,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -692,17 +692,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v3.users.html b/docs/dyn/displayvideo_v3.users.html index 2d574a99f7..05773b25a6 100644 --- a/docs/dyn/displayvideo_v3.users.html +++ b/docs/dyn/displayvideo_v3.users.html @@ -93,7 +93,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The "Try this method" feature does not work for this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(userId, body=None, updateMask=None, x__xgafv=None)

@@ -285,17 +285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.adAssets.html b/docs/dyn/displayvideo_v4.advertisers.adAssets.html index fc5e78cd07..6cfa48e674 100644 --- a/docs/dyn/displayvideo_v4.advertisers.adAssets.html +++ b/docs/dyn/displayvideo_v4.advertisers.adAssets.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ad assets under an advertiser ID. Only supports the retrieval of assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, adAssetId, body=None, updateMask=None, x__xgafv=None)

@@ -257,17 +257,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html b/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html index 06c9323d1e..c71fda8d8a 100644 --- a/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html +++ b/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ad group ads.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)

@@ -259,15 +259,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -276,12 +276,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -291,7 +291,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -347,7 +347,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -409,7 +409,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -433,7 +433,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -476,7 +476,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -486,11 +486,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -499,16 +499,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -521,7 +521,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -530,17 +530,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -549,16 +549,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -569,15 +569,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -588,27 +588,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -772,15 +772,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -789,12 +789,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -804,7 +804,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -860,7 +860,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -922,7 +922,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -946,7 +946,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -989,7 +989,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -999,11 +999,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1012,16 +1012,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1034,7 +1034,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1043,17 +1043,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1062,16 +1062,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1082,15 +1082,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -1101,27 +1101,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1312,15 +1312,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1329,12 +1329,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -1344,7 +1344,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -1400,7 +1400,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1462,7 +1462,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1486,7 +1486,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -1529,7 +1529,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1539,11 +1539,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1552,16 +1552,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1574,7 +1574,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1583,17 +1583,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1602,16 +1602,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -1622,15 +1622,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -1641,27 +1641,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -1838,15 +1838,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -1855,12 +1855,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -1870,7 +1870,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -1926,7 +1926,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -1988,7 +1988,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2012,7 +2012,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -2055,7 +2055,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2065,11 +2065,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2078,16 +2078,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2100,7 +2100,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2109,17 +2109,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2128,16 +2128,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2148,15 +2148,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -2167,27 +2167,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2199,17 +2199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2371,15 +2371,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2388,12 +2388,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -2403,7 +2403,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -2459,7 +2459,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2521,7 +2521,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -2545,7 +2545,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -2588,7 +2588,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2598,11 +2598,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2611,16 +2611,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2633,7 +2633,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2642,17 +2642,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2661,16 +2661,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -2681,15 +2681,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -2700,27 +2700,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -2885,15 +2885,15 @@

Method Details

"trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "bumperAd": { # Details for a bumper ad. # Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -2902,12 +2902,12 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, @@ -2917,7 +2917,7 @@

Method Details

"placementId": "A String", # Required. The DCM placement id. "trackingAdId": "A String", # Required. The DCM tracking ad id. }, - "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). + "demandGenCarouselAd": { # Details for a Demand Gen carousel ad. # Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "cards": [ # Required. The list of cards shown on the ad. { # Details for a Demand Gen carousel card. @@ -2973,7 +2973,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenImageAd": { # Details for a Demand Gen image ad. # Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). + "demandGenImageAd": { # Details for a Demand Gen image ad. # Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -3035,7 +3035,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenProductAd": { # Details for a Demand Gen product ad. # Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). + "demandGenProductAd": { # Details for a Demand Gen product ad. # Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `APPLY_NOW` * `BOOK_NOW` * `CONTACT_US` * `DOWNLOAD` * `GET_QUOTE` * `LEARN_MORE` * `SHOP_NOW` * `SIGN_UP` * `SUBSCRIBE` "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. @@ -3059,7 +3059,7 @@

Method Details

"trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. "userSpecifiedTrackingUrl": "A String", # Optional. The tracking URL specified by the user manually. }, - "demandGenVideoAd": { # Details for a Demand Gen video ad. # Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). + "demandGenVideoAd": { # Details for a Demand Gen video ad. # Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). "businessName": "A String", # Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. "callToAction": "A String", # Required. The call-to-action button shown on the ad. The supported values are: * `AUTOMATED` * `LEARN_MORE` * `GET_QUOTE` * `APPLY_NOW` * `SIGN_UP` * `CONTACT_US` * `SUBSCRIBE` * `DOWNLOAD` * `BOOK_NOW` * `SHOP_NOW` * `BUY_NOW` * `DONATE_NOW` * `ORDER_NOW` * `PLAY_NOW` * `SEE_MORE` * `START_NOW` * `VISIT_SITE` * `WATCH_NOW` "companionBanner": { # Meta data of an image asset. # Optional. The companion banner used by this ad. @@ -3102,7 +3102,7 @@

Method Details

"videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -3112,11 +3112,11 @@

Method Details

"creativeId": "A String", # The ID of the source creative. }, "entityStatus": "A String", # Required. The entity status of the ad. - "inStreamAd": { # Details for an in-stream ad. # Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -3125,16 +3125,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -3147,7 +3147,7 @@

Method Details

"companionYoutubeVideos": [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], @@ -3156,17 +3156,17 @@

Method Details

"showChannelArt": True or False, # Whether to show a background or banner that appears at the top of a YouTube page. "video": { # Details of a YouTube video. # The YouTube video used by the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, "videoAspectRatio": "A String", # The aspect ratio of the autoplaying YouTube video on the Masthead. }, "name": "A String", # Output only. The resource name of the ad. - "nonSkippableAd": { # Details for a non-skippable ad. # Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. - "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes. - "actionButtonLabel": "A String", # The text on the call-to-action button. - "actionHeadline": "A String", # The headline of the call-to-action banner. - "companionBanner": { # Meta data of an image asset. # The image which shows next to the video ad. + "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. + "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. + "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. "fullSize": { # Dimensions. # Output only. Metadata for this image at its original size. @@ -3175,16 +3175,16 @@

Method Details

}, "mimeType": "A String", # Output only. MIME type of the image asset. }, - "displayUrl": "A String", # The webpage address that appears with the ad. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "video": { # Details of a YouTube video. # The YouTube video of the ad. + "displayUrl": "A String", # Required. The webpage address that appears with the ad. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "video": { # Details of a YouTube video. # Required. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, }, @@ -3195,15 +3195,15 @@

Method Details

"thumbnail": "A String", # Thumbnail image used in the ad. "video": { # Details of a YouTube video. # The YouTube video the ad promotes. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, }, - "videoPerformanceAd": { # Details for a video performance ad. # Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # The list of text assets shown on the call-to-action button. + "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. "A String", ], - "companionBanners": [ # The list of companion banners used by this ad. + "companionBanners": [ # Optional. The list of companion banners used by this ad. { # Meta data of an image asset. "assetId": "A String", # Required. The unique ID of the asset. "fileSize": "A String", # Output only. File size of the image asset in bytes. @@ -3214,27 +3214,27 @@

Method Details

"mimeType": "A String", # Output only. MIME type of the image asset. }, ], - "customParameters": { # The custom parameters and accompanying values to add to the tracking URL. + "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. "A String", ], - "displayUrlBreadcrumb1": "A String", # The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # The second piece after the domain in the display URL. + "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. "domain": "A String", # Output only. The domain of the display URL. - "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "headlines": [ # The list of headlines shown on the call-to-action banner. + "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. + "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. "A String", ], - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. - "videos": [ # The list of YouTube video assets used by this ad. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. - "unavailableReason": "A String", # The reason why the video data is not available. + "unavailableReason": "A String", # Output only. The reason why the video data is not available. "videoAssetId": "A String", # Required. The YouTube video asset id. This is the adAssetId of an AdAsset resource. }, ], diff --git a/docs/dyn/displayvideo_v4.advertisers.adGroups.html b/docs/dyn/displayvideo_v4.advertisers.adGroups.html index 0a67b1c8c7..856ce03dc5 100644 --- a/docs/dyn/displayvideo_v4.advertisers.adGroups.html +++ b/docs/dyn/displayvideo_v4.advertisers.adGroups.html @@ -91,7 +91,7 @@

Instance Methods

bulkListAssignedTargetingOptions(advertiserId, adGroupIds=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options for multiple ad groups across targeting types. Inherited assigned targeting options are not included.

- bulkListAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAssignedTargetingOptions_next()

Retrieves the next page of results.

close()

@@ -109,7 +109,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ad groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, adGroupId, body=None, updateMask=None, x__xgafv=None)

@@ -267,7 +267,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -665,7 +665,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -868,17 +868,17 @@

Method Details

- bulkListAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -1240,17 +1240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v4.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html index 78933782d9..ae7a2eeeca 100644 --- a/docs/dyn/displayvideo_v4.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v4.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, adGroupId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to an ad group. Inherited assigned targeting options are not included.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -297,7 +297,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -638,7 +638,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1114,7 +1114,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1522,7 +1522,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1724,17 +1724,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.html b/docs/dyn/displayvideo_v4.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.html index 9b7334f55c..a9e268c233 100644 --- a/docs/dyn/displayvideo_v4.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.html +++ b/docs/dyn/displayvideo_v4.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.html @@ -87,7 +87,7 @@

Instance Methods

list(advertiserId, adGroupId, youtubeAssetType, linkedEntity_lineItemId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the YouTube asset associations linked to the given resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.advertisers.campaigns.html b/docs/dyn/displayvideo_v4.advertisers.campaigns.html index 258a075271..d36e87c931 100644 --- a/docs/dyn/displayvideo_v4.advertisers.campaigns.html +++ b/docs/dyn/displayvideo_v4.advertisers.campaigns.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists campaigns in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, campaigns with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, campaignId, body=None, updateMask=None, x__xgafv=None)

@@ -467,17 +467,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.channels.html b/docs/dyn/displayvideo_v4.advertisers.channels.html index 140bb74407..7cfc1cc439 100644 --- a/docs/dyn/displayvideo_v4.advertisers.channels.html +++ b/docs/dyn/displayvideo_v4.advertisers.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, channelId, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.channels.sites.html b/docs/dyn/displayvideo_v4.advertisers.channels.sites.html index b163aea926..45ae4b0272 100644 --- a/docs/dyn/displayvideo_v4.advertisers.channels.sites.html +++ b/docs/dyn/displayvideo_v4.advertisers.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, channelId, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.creatives.html b/docs/dyn/displayvideo_v4.advertisers.creatives.html index e07c71b433..1a7566e001 100644 --- a/docs/dyn/displayvideo_v4.advertisers.creatives.html +++ b/docs/dyn/displayvideo_v4.advertisers.creatives.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists creatives in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, creatives with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, creativeId, body=None, updateMask=None, x__xgafv=None)

@@ -767,17 +767,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.html b/docs/dyn/displayvideo_v4.advertisers.html index 33cd68c4e0..7c4664a649 100644 --- a/docs/dyn/displayvideo_v4.advertisers.html +++ b/docs/dyn/displayvideo_v4.advertisers.html @@ -169,10 +169,10 @@

Instance Methods

listAssignedTargetingOptions(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options of an advertiser across targeting types.

- listAssignedTargetingOptions_next(previous_request, previous_response)

+ listAssignedTargetingOptions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, body=None, updateMask=None, x__xgafv=None)

@@ -516,7 +516,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -872,7 +872,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1389,7 +1389,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1591,31 +1591,31 @@

Method Details

- listAssignedTargetingOptions_next(previous_request, previous_response) + listAssignedTargetingOptions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.insertionOrders.html b/docs/dyn/displayvideo_v4.advertisers.insertionOrders.html index 9fc0badcfb..b93b4d5cf5 100644 --- a/docs/dyn/displayvideo_v4.advertisers.insertionOrders.html +++ b/docs/dyn/displayvideo_v4.advertisers.insertionOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insertion orders in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, insertion orders with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, insertionOrderId, body=None, updateMask=None, x__xgafv=None)

@@ -571,17 +571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.invoices.html b/docs/dyn/displayvideo_v4.advertisers.invoices.html index c6f30a75b9..c29f75639e 100644 --- a/docs/dyn/displayvideo_v4.advertisers.invoices.html +++ b/docs/dyn/displayvideo_v4.advertisers.invoices.html @@ -81,7 +81,7 @@

Instance Methods

list(advertiserId, issueMonth=None, loiSapinInvoiceType=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists invoices posted for an advertiser in a given month. Invoices generated by billing profiles with a "Partner" invoice level are not retrievable through this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookupInvoiceCurrency(advertiserId, invoiceMonth=None, x__xgafv=None)

@@ -177,17 +177,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.lineItems.html b/docs/dyn/displayvideo_v4.advertisers.lineItems.html index 9e8f16b678..108ba559cf 100644 --- a/docs/dyn/displayvideo_v4.advertisers.lineItems.html +++ b/docs/dyn/displayvideo_v4.advertisers.lineItems.html @@ -91,7 +91,7 @@

Instance Methods

bulkListAssignedTargetingOptions(advertiserId, filter=None, lineItemIds=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists assigned targeting options for multiple line items across targeting types.

- bulkListAssignedTargetingOptions_next(previous_request, previous_response)

+ bulkListAssignedTargetingOptions_next()

Retrieves the next page of results.

bulkUpdate(advertiserId, body=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists line items in an advertiser. The order is defined by the order_by parameter. If a filter by entity_status is not specified, line items with `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, lineItemId, body=None, updateMask=None, x__xgafv=None)

@@ -270,7 +270,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -670,7 +670,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -874,17 +874,17 @@

Method Details

- bulkListAssignedTargetingOptions_next(previous_request, previous_response) + bulkListAssignedTargetingOptions_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)
+        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.
-
+ 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. +
@@ -2160,17 +2160,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v4.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html index 0998488441..bd30a7d15e 100644 --- a/docs/dyn/displayvideo_v4.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v4.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, lineItemId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a line item.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -297,7 +297,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -638,7 +638,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1114,7 +1114,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1522,7 +1522,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1724,17 +1724,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.html b/docs/dyn/displayvideo_v4.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.html index c393a39c7c..11d85de87b 100644 --- a/docs/dyn/displayvideo_v4.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.html +++ b/docs/dyn/displayvideo_v4.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.html @@ -87,7 +87,7 @@

Instance Methods

list(advertiserId, lineItemId, youtubeAssetType, linkedEntity_adGroupId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the YouTube asset associations linked to the given resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.advertisers.locationLists.assignedLocations.html b/docs/dyn/displayvideo_v4.advertisers.locationLists.assignedLocations.html index d3f8b4dfb6..acafd36317 100644 --- a/docs/dyn/displayvideo_v4.advertisers.locationLists.assignedLocations.html +++ b/docs/dyn/displayvideo_v4.advertisers.locationLists.assignedLocations.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, locationListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations assigned to a location list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.advertisers.locationLists.html b/docs/dyn/displayvideo_v4.advertisers.locationLists.html index f76214d941..4ba3741c4f 100644 --- a/docs/dyn/displayvideo_v4.advertisers.locationLists.html +++ b/docs/dyn/displayvideo_v4.advertisers.locationLists.html @@ -92,7 +92,7 @@

Instance Methods

list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists location lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, locationListId, body=None, updateMask=None, x__xgafv=None)

@@ -194,17 +194,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.html b/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.html index e40b55b63e..ec4a31b872 100644 --- a/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.html +++ b/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keyword lists based on a given advertiser id.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(advertiserId, negativeKeywordListId, body=None, updateMask=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.negativeKeywords.html b/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.negativeKeywords.html index a4759f19ea..588477c818 100644 --- a/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.negativeKeywords.html +++ b/docs/dyn/displayvideo_v4.advertisers.negativeKeywordLists.negativeKeywords.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, negativeKeywordListId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists negative keywords in a negative keyword list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(advertiserId, negativeKeywordListId, body=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.advertisers.reachForecast.html b/docs/dyn/displayvideo_v4.advertisers.reachForecast.html index fb1c32042e..7b286132b5 100644 --- a/docs/dyn/displayvideo_v4.advertisers.reachForecast.html +++ b/docs/dyn/displayvideo_v4.advertisers.reachForecast.html @@ -93,7 +93,7 @@

Instance Methods

retrievePlannableUserLists(advertiserId, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves first and third party user lists available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.

- retrievePlannableUserLists_next(previous_request, previous_response)

+ retrievePlannableUserLists_next()

Retrieves the next page of results.

Method Details

@@ -415,17 +415,17 @@

Method Details

- retrievePlannableUserLists_next(previous_request, previous_response) + retrievePlannableUserLists_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)
+        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.
-
+ 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/displayvideo_v4.advertisers.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v4.advertisers.targetingTypes.assignedTargetingOptions.html index 90d8f6c557..7d982a712e 100644 --- a/docs/dyn/displayvideo_v4.advertisers.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v4.advertisers.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to an advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,7 +296,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -637,7 +637,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1111,7 +1111,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1518,7 +1518,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.combinedAudiences.html b/docs/dyn/displayvideo_v4.combinedAudiences.html index 4fae55e007..4464411414 100644 --- a/docs/dyn/displayvideo_v4.combinedAudiences.html +++ b/docs/dyn/displayvideo_v4.combinedAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists combined audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.customBiddingAlgorithms.html b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html index e6545b90db..f6d2f0e8c4 100644 --- a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html +++ b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html @@ -97,7 +97,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(customBiddingAlgorithmId, body=None, updateMask=None, x__xgafv=None)

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.rules.html b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.rules.html index 1858f847e0..244849afaf 100644 --- a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.rules.html +++ b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.rules.html @@ -87,7 +87,7 @@

Instance Methods

list(customBiddingAlgorithmId, advertiserId=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists rules resources that belong to the given algorithm. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.customBiddingAlgorithms.scripts.html b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.scripts.html index 1177b65815..6ed0b24a8d 100644 --- a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.scripts.html +++ b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.scripts.html @@ -87,7 +87,7 @@

Instance Methods

list(customBiddingAlgorithmId, advertiserId=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists custom bidding scripts that belong to the given algorithm. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -239,17 +239,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.customLists.html b/docs/dyn/displayvideo_v4.customLists.html index acb3437030..ce40d8438e 100644 --- a/docs/dyn/displayvideo_v4.customLists.html +++ b/docs/dyn/displayvideo_v4.customLists.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists custom lists. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.firstPartyAndPartnerAudiences.html b/docs/dyn/displayvideo_v4.firstPartyAndPartnerAudiences.html index 5d333f3e50..71f3ea6724 100644 --- a/docs/dyn/displayvideo_v4.firstPartyAndPartnerAudiences.html +++ b/docs/dyn/displayvideo_v4.firstPartyAndPartnerAudiences.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists first party and partner audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(firstPartyAndPartnerAudienceId, advertiserId=None, body=None, updateMask=None, x__xgafv=None)

@@ -450,17 +450,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.floodlightGroups.floodlightActivities.html b/docs/dyn/displayvideo_v4.floodlightGroups.floodlightActivities.html index cccef80f3b..9db2dfeee6 100644 --- a/docs/dyn/displayvideo_v4.floodlightGroups.floodlightActivities.html +++ b/docs/dyn/displayvideo_v4.floodlightGroups.floodlightActivities.html @@ -84,7 +84,7 @@

Instance Methods

list(floodlightGroupId, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Floodlight activities in a Floodlight group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -170,17 +170,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.googleAudiences.html b/docs/dyn/displayvideo_v4.googleAudiences.html index 137fe19393..ce6dae88c3 100644 --- a/docs/dyn/displayvideo_v4.googleAudiences.html +++ b/docs/dyn/displayvideo_v4.googleAudiences.html @@ -84,7 +84,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists Google audiences. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.guaranteedOrders.html b/docs/dyn/displayvideo_v4.guaranteedOrders.html index b0d874811f..313909e326 100644 --- a/docs/dyn/displayvideo_v4.guaranteedOrders.html +++ b/docs/dyn/displayvideo_v4.guaranteedOrders.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists guaranteed orders that are accessible to the current user. The order is defined by the order_by parameter. If a filter by entity_status is not specified, guaranteed orders with entity status `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(guaranteedOrderId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -291,17 +291,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.html b/docs/dyn/displayvideo_v4.html index 1916db8741..665812b562 100644 --- a/docs/dyn/displayvideo_v4.html +++ b/docs/dyn/displayvideo_v4.html @@ -158,7 +158,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -167,20 +167,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/displayvideo_v4.inventorySourceGroups.assignedInventorySources.html b/docs/dyn/displayvideo_v4.inventorySourceGroups.assignedInventorySources.html index 18b86e094b..99fcf1e86c 100644 --- a/docs/dyn/displayvideo_v4.inventorySourceGroups.assignedInventorySources.html +++ b/docs/dyn/displayvideo_v4.inventorySourceGroups.assignedInventorySources.html @@ -90,7 +90,7 @@

Instance Methods

list(inventorySourceGroupId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory sources assigned to an inventory source group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.inventorySourceGroups.html b/docs/dyn/displayvideo_v4.inventorySourceGroups.html index 056b2ffcbe..fcc3eaee5c 100644 --- a/docs/dyn/displayvideo_v4.inventorySourceGroups.html +++ b/docs/dyn/displayvideo_v4.inventorySourceGroups.html @@ -95,7 +95,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory source groups that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(inventorySourceGroupId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.inventorySources.html b/docs/dyn/displayvideo_v4.inventorySources.html index a3e108c2c1..850b7f64e0 100644 --- a/docs/dyn/displayvideo_v4.inventorySources.html +++ b/docs/dyn/displayvideo_v4.inventorySources.html @@ -90,7 +90,7 @@

Instance Methods

list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)

Lists inventory sources that are accessible to the current user. The order is defined by the order_by parameter. If a filter by entity_status is not specified, inventory sources with entity status `ENTITY_STATUS_ARCHIVED` will not be included in the results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(inventorySourceId, advertiserId=None, body=None, partnerId=None, updateMask=None, x__xgafv=None)

@@ -485,17 +485,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.partners.channels.html b/docs/dyn/displayvideo_v4.partners.channels.html index ffb07b43f2..31707a7e3e 100644 --- a/docs/dyn/displayvideo_v4.partners.channels.html +++ b/docs/dyn/displayvideo_v4.partners.channels.html @@ -92,7 +92,7 @@

Instance Methods

list(partnerId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists channels for a partner or advertiser.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(partnerId, channelId, advertiserId=None, body=None, updateMask=None, x__xgafv=None)

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.partners.channels.sites.html b/docs/dyn/displayvideo_v4.partners.channels.sites.html index a57b489974..8d540815e0 100644 --- a/docs/dyn/displayvideo_v4.partners.channels.sites.html +++ b/docs/dyn/displayvideo_v4.partners.channels.sites.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, channelId, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sites in a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

replace(partnerId, channelId, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/displayvideo_v4.partners.html b/docs/dyn/displayvideo_v4.partners.html index 3c0f7d1ec6..a50a0f1377 100644 --- a/docs/dyn/displayvideo_v4.partners.html +++ b/docs/dyn/displayvideo_v4.partners.html @@ -97,7 +97,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists partners that are accessible to the current user. The order is defined by the order_by parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -254,7 +254,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -610,7 +610,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -923,17 +923,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.partners.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v4.partners.targetingTypes.assignedTargetingOptions.html index efe719ac03..2642f40f72 100644 --- a/docs/dyn/displayvideo_v4.partners.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v4.partners.targetingTypes.assignedTargetingOptions.html @@ -90,7 +90,7 @@

Instance Methods

list(partnerId, targetingType, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the targeting options assigned to a partner.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,7 +296,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -637,7 +637,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1111,7 +1111,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1518,7 +1518,7 @@

Method Details

}, "deviceTypeDetails": { # Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. # Device Type details. This field will be populated when the targeting_type is `TARGETING_TYPE_DEVICE_TYPE`. "deviceType": "A String", # Required. The display name of the device type. - "youtubeAndPartnersBidMultiplier": 3.14, # Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. + "youtubeAndPartnersBidMultiplier": 3.14, # Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items. }, "digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. # Digital content label details. This field will be populated when the targeting_type is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`. Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded. "excludedContentRatingTier": "A String", # Required. The display name of the digital content label rating tier to be EXCLUDED. **Starting on *October 1, 2026*, this field will only accept the value `CONTENT_RATING_TIER_UNRATED`. All other values will be deprecated and no longer be accepted.** @@ -1720,17 +1720,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.targetingTypes.targetingOptions.html b/docs/dyn/displayvideo_v4.targetingTypes.targetingOptions.html index f1bba765ac..c0e3960621 100644 --- a/docs/dyn/displayvideo_v4.targetingTypes.targetingOptions.html +++ b/docs/dyn/displayvideo_v4.targetingTypes.targetingOptions.html @@ -84,13 +84,13 @@

Instance Methods

list(targetingType, advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists targeting options of a given type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(targetingType, body=None, x__xgafv=None)

Searches for targeting options of a given type based on the given search terms.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -473,17 +473,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -692,17 +692,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/displayvideo_v4.users.html b/docs/dyn/displayvideo_v4.users.html index 23801dcbae..6f8093e22c 100644 --- a/docs/dyn/displayvideo_v4.users.html +++ b/docs/dyn/displayvideo_v4.users.html @@ -93,7 +93,7 @@

Instance Methods

list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The "Try this method" feature does not work for this method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(userId, body=None, updateMask=None, x__xgafv=None)

@@ -285,17 +285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.html b/docs/dyn/dlp_v2.html index 2a6ed464c5..ec9df047f4 100644 --- a/docs/dyn/dlp_v2.html +++ b/docs/dyn/dlp_v2.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dlp_v2.organizations.deidentifyTemplates.html b/docs/dyn/dlp_v2.organizations.deidentifyTemplates.html index 2928d2a950..567c4ad4e0 100644 --- a/docs/dyn/dlp_v2.organizations.deidentifyTemplates.html +++ b/docs/dyn/dlp_v2.organizations.deidentifyTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeidentifyTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates-deid to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -3633,17 +3633,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.inspectTemplates.html b/docs/dyn/dlp_v2.organizations.inspectTemplates.html index e544986d77..420fa61357 100644 --- a/docs/dyn/dlp_v2.organizations.inspectTemplates.html +++ b/docs/dyn/dlp_v2.organizations.inspectTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InspectTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1233,17 +1233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.columnDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.columnDataProfiles.html index e8f70414ed..0a8418a6d8 100644 --- a/docs/dyn/dlp_v2.organizations.locations.columnDataProfiles.html +++ b/docs/dyn/dlp_v2.organizations.locations.columnDataProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists column data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.locations.connections.html b/docs/dyn/dlp_v2.organizations.locations.connections.html index 0092b73731..ae91052999 100644 --- a/docs/dyn/dlp_v2.organizations.locations.connections.html +++ b/docs/dyn/dlp_v2.organizations.locations.connections.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connections in a parent. Use SearchConnections to see all connections within an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

search(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Searches for Connections in a parent.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -473,17 +473,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.locations.deidentifyTemplates.html b/docs/dyn/dlp_v2.organizations.locations.deidentifyTemplates.html index 98e2cf94f9..e218fbe92c 100644 --- a/docs/dyn/dlp_v2.organizations.locations.deidentifyTemplates.html +++ b/docs/dyn/dlp_v2.organizations.locations.deidentifyTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeidentifyTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates-deid to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -3633,17 +3633,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html b/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html index edf821179d..394d6dc2a9 100644 --- a/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html +++ b/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists discovery configurations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1571,17 +1571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html b/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html index b8035a4e34..91d03f3d99 100644 --- a/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html +++ b/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists DlpJobs that match the specified filter in the request. See https://docs.cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://docs.cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -3977,17 +3977,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.locations.fileStoreDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html index 8773d0391b..a22be6c0fc 100644 --- a/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html +++ b/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists file store data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1809,17 +1809,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.locations.inspectTemplates.html b/docs/dyn/dlp_v2.organizations.locations.inspectTemplates.html index a756beff2c..73f7d012f8 100644 --- a/docs/dyn/dlp_v2.organizations.locations.inspectTemplates.html +++ b/docs/dyn/dlp_v2.organizations.locations.inspectTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InspectTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1233,17 +1233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.jobTriggers.html b/docs/dyn/dlp_v2.organizations.locations.jobTriggers.html index c0a89f046c..059571e7bd 100644 --- a/docs/dyn/dlp_v2.organizations.locations.jobTriggers.html +++ b/docs/dyn/dlp_v2.organizations.locations.jobTriggers.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists job triggers. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-job-triggers to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1875,17 +1875,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.projectDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.projectDataProfiles.html index 848964f05e..4b69c8c6b0 100644 --- a/docs/dyn/dlp_v2.organizations.locations.projectDataProfiles.html +++ b/docs/dyn/dlp_v2.organizations.locations.projectDataProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists project data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -184,17 +184,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.locations.storedInfoTypes.html b/docs/dyn/dlp_v2.organizations.locations.storedInfoTypes.html index e3a24b4ea1..2d9f23cf4b 100644 --- a/docs/dyn/dlp_v2.organizations.locations.storedInfoTypes.html +++ b/docs/dyn/dlp_v2.organizations.locations.storedInfoTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists stored infoTypes. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-stored-infotypes to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html index 93c422cef2..feefc3d093 100644 --- a/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html +++ b/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists table data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1695,17 +1695,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.organizations.storedInfoTypes.html b/docs/dyn/dlp_v2.organizations.storedInfoTypes.html index c683a3824d..1f62bc47d9 100644 --- a/docs/dyn/dlp_v2.organizations.storedInfoTypes.html +++ b/docs/dyn/dlp_v2.organizations.storedInfoTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists stored infoTypes. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-stored-infotypes to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.deidentifyTemplates.html b/docs/dyn/dlp_v2.projects.deidentifyTemplates.html index 0342cbb02c..110b2bc92f 100644 --- a/docs/dyn/dlp_v2.projects.deidentifyTemplates.html +++ b/docs/dyn/dlp_v2.projects.deidentifyTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeidentifyTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates-deid to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -3633,17 +3633,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.dlpJobs.html b/docs/dyn/dlp_v2.projects.dlpJobs.html index e46d6e92db..5cfdb79f30 100644 --- a/docs/dyn/dlp_v2.projects.dlpJobs.html +++ b/docs/dyn/dlp_v2.projects.dlpJobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists DlpJobs that match the specified filter in the request. See https://docs.cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://docs.cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -12338,17 +12338,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.inspectTemplates.html b/docs/dyn/dlp_v2.projects.inspectTemplates.html index 5f5d2c9759..b1ff7e766c 100644 --- a/docs/dyn/dlp_v2.projects.inspectTemplates.html +++ b/docs/dyn/dlp_v2.projects.inspectTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InspectTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1233,17 +1233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.jobTriggers.html b/docs/dyn/dlp_v2.projects.jobTriggers.html index e2e42cdf6f..a036fe616d 100644 --- a/docs/dyn/dlp_v2.projects.jobTriggers.html +++ b/docs/dyn/dlp_v2.projects.jobTriggers.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists job triggers. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-job-triggers to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -5756,17 +5756,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.columnDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.columnDataProfiles.html index 9ad9c8857e..081d0e9556 100644 --- a/docs/dyn/dlp_v2.projects.locations.columnDataProfiles.html +++ b/docs/dyn/dlp_v2.projects.locations.columnDataProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists column data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.locations.connections.html b/docs/dyn/dlp_v2.projects.locations.connections.html index 55ba22f062..6d4cccc8e7 100644 --- a/docs/dyn/dlp_v2.projects.locations.connections.html +++ b/docs/dyn/dlp_v2.projects.locations.connections.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connections in a parent. Use SearchConnections to see all connections within an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -99,7 +99,7 @@

Instance Methods

search(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Searches for Connections in a parent.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -473,17 +473,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.locations.contentPolicies.html b/docs/dyn/dlp_v2.projects.locations.contentPolicies.html index f4f0bf9940..c81341ac1d 100644 --- a/docs/dyn/dlp_v2.projects.locations.contentPolicies.html +++ b/docs/dyn/dlp_v2.projects.locations.contentPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ContentPolicies in a parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1458,17 +1458,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.deidentifyTemplates.html b/docs/dyn/dlp_v2.projects.locations.deidentifyTemplates.html index 137aa457c0..22e3c1a50b 100644 --- a/docs/dyn/dlp_v2.projects.locations.deidentifyTemplates.html +++ b/docs/dyn/dlp_v2.projects.locations.deidentifyTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DeidentifyTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates-deid to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -3633,17 +3633,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html b/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html index 343ab43d6a..49da9ddfc2 100644 --- a/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html +++ b/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists discovery configurations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1571,17 +1571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.dlpJobs.html b/docs/dyn/dlp_v2.projects.locations.dlpJobs.html index 69f173b3c1..eab145a57d 100644 --- a/docs/dyn/dlp_v2.projects.locations.dlpJobs.html +++ b/docs/dyn/dlp_v2.projects.locations.dlpJobs.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists DlpJobs that match the specified filter in the request. See https://docs.cloud.google.com/sensitive-data-protection/docs/inspecting-storage and https://docs.cloud.google.com/sensitive-data-protection/docs/compute-risk-analysis to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -12519,17 +12519,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.locations.fileStoreDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html index fb9c38f82a..456443bb49 100644 --- a/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html +++ b/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists file store data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1809,17 +1809,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.locations.inspectTemplates.html b/docs/dyn/dlp_v2.projects.locations.inspectTemplates.html index 9d53e1bf52..ed04fcf46e 100644 --- a/docs/dyn/dlp_v2.projects.locations.inspectTemplates.html +++ b/docs/dyn/dlp_v2.projects.locations.inspectTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists InspectTemplates. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-templates to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -1233,17 +1233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.jobTriggers.html b/docs/dyn/dlp_v2.projects.locations.jobTriggers.html index 5f39f15921..54761fd77b 100644 --- a/docs/dyn/dlp_v2.projects.locations.jobTriggers.html +++ b/docs/dyn/dlp_v2.projects.locations.jobTriggers.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, locationId=None, orderBy=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

Lists job triggers. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-job-triggers to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -5910,17 +5910,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.projectDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.projectDataProfiles.html index 6173f79bb1..263da52aaf 100644 --- a/docs/dyn/dlp_v2.projects.locations.projectDataProfiles.html +++ b/docs/dyn/dlp_v2.projects.locations.projectDataProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists project data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -184,17 +184,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.locations.storedInfoTypes.html b/docs/dyn/dlp_v2.projects.locations.storedInfoTypes.html index 2b96e53347..7676104899 100644 --- a/docs/dyn/dlp_v2.projects.locations.storedInfoTypes.html +++ b/docs/dyn/dlp_v2.projects.locations.storedInfoTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists stored infoTypes. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-stored-infotypes to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html index cd95f97eb7..eb021b8224 100644 --- a/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html +++ b/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists table data profiles for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1695,17 +1695,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dlp_v2.projects.storedInfoTypes.html b/docs/dyn/dlp_v2.projects.storedInfoTypes.html index edc8053a94..0817a366d0 100644 --- a/docs/dyn/dlp_v2.projects.storedInfoTypes.html +++ b/docs/dyn/dlp_v2.projects.storedInfoTypes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, locationId=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists stored infoTypes. See https://docs.cloud.google.com/sensitive-data-protection/docs/creating-stored-infotypes to learn more.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1.changes.html b/docs/dyn/dns_v1.changes.html index bc8922a29a..cb1720eaa1 100644 --- a/docs/dyn/dns_v1.changes.html +++ b/docs/dyn/dns_v1.changes.html @@ -87,7 +87,7 @@

Instance Methods

list(project, managedZone, maxResults=None, pageToken=None, sortBy=None, sortOrder=None, x__xgafv=None)

Enumerates Changes to a ResourceRecordSet collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1290,17 +1290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1.dnsKeys.html b/docs/dyn/dns_v1.dnsKeys.html index 8295cac159..ec4af83231 100644 --- a/docs/dyn/dns_v1.dnsKeys.html +++ b/docs/dyn/dns_v1.dnsKeys.html @@ -84,7 +84,7 @@

Instance Methods

list(project, managedZone, digestType=None, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates DnsKeys to a ResourceRecordSet collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1.html b/docs/dyn/dns_v1.html index ab4f33e804..882ec21056 100644 --- a/docs/dyn/dns_v1.html +++ b/docs/dyn/dns_v1.html @@ -123,7 +123,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -132,20 +132,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dns_v1.managedZoneOperations.html b/docs/dyn/dns_v1.managedZoneOperations.html index 2917833a92..62533036ed 100644 --- a/docs/dyn/dns_v1.managedZoneOperations.html +++ b/docs/dyn/dns_v1.managedZoneOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, managedZone, maxResults=None, pageToken=None, sortBy=None, x__xgafv=None)

Enumerates Operations for the given ManagedZone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -553,17 +553,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1.managedZones.html b/docs/dyn/dns_v1.managedZones.html index 85ee981973..2b6bd1b5c8 100644 --- a/docs/dyn/dns_v1.managedZones.html +++ b/docs/dyn/dns_v1.managedZones.html @@ -93,7 +93,7 @@

Instance Methods

list(project, dnsName=None, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates ManagedZones that have been created but not yet deleted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)

@@ -565,17 +565,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1.policies.html b/docs/dyn/dns_v1.policies.html index d2098776cd..492a8b9e59 100644 --- a/docs/dyn/dns_v1.policies.html +++ b/docs/dyn/dns_v1.policies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all policies associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1.resourceRecordSets.html b/docs/dyn/dns_v1.resourceRecordSets.html index a1d141e2b1..c0d8973013 100644 --- a/docs/dyn/dns_v1.resourceRecordSets.html +++ b/docs/dyn/dns_v1.resourceRecordSets.html @@ -90,7 +90,7 @@

Instance Methods

list(project, managedZone, filter=None, maxResults=None, name=None, pageToken=None, type=None, x__xgafv=None)

Enumerates ResourceRecordSets that you have created but not yet deleted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, managedZone, name, type, body=None, clientOperationId=None, x__xgafv=None)

@@ -734,17 +734,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1.responsePolicies.html b/docs/dyn/dns_v1.responsePolicies.html index 9c5f03d566..1571c19b44 100644 --- a/docs/dyn/dns_v1.responsePolicies.html +++ b/docs/dyn/dns_v1.responsePolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all Response Policies associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, responsePolicy, body=None, clientOperationId=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1.responsePolicyRules.html b/docs/dyn/dns_v1.responsePolicyRules.html index beea5b99b9..54c90688f2 100644 --- a/docs/dyn/dns_v1.responsePolicyRules.html +++ b/docs/dyn/dns_v1.responsePolicyRules.html @@ -90,7 +90,7 @@

Instance Methods

list(project, responsePolicy, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all Response Policy Rules associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, responsePolicy, responsePolicyRule, body=None, clientOperationId=None, x__xgafv=None)

@@ -766,17 +766,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1beta2.changes.html b/docs/dyn/dns_v1beta2.changes.html index 67773a6cc6..7bebbc1305 100644 --- a/docs/dyn/dns_v1beta2.changes.html +++ b/docs/dyn/dns_v1beta2.changes.html @@ -87,7 +87,7 @@

Instance Methods

list(project, managedZone, maxResults=None, pageToken=None, sortBy=None, sortOrder=None, x__xgafv=None)

Enumerates Changes to a ResourceRecordSet collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1810,17 +1810,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1beta2.dnsKeys.html b/docs/dyn/dns_v1beta2.dnsKeys.html index 23726ffbe8..d2022b77cf 100644 --- a/docs/dyn/dns_v1beta2.dnsKeys.html +++ b/docs/dyn/dns_v1beta2.dnsKeys.html @@ -84,7 +84,7 @@

Instance Methods

list(project, managedZone, digestType=None, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates DnsKeys to a ResourceRecordSet collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1beta2.html b/docs/dyn/dns_v1beta2.html index 5c4842d6d3..5578a4f3b8 100644 --- a/docs/dyn/dns_v1beta2.html +++ b/docs/dyn/dns_v1beta2.html @@ -123,7 +123,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -132,20 +132,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/dns_v1beta2.managedZoneOperations.html b/docs/dyn/dns_v1beta2.managedZoneOperations.html index ddee9f0bc1..937709975a 100644 --- a/docs/dyn/dns_v1beta2.managedZoneOperations.html +++ b/docs/dyn/dns_v1beta2.managedZoneOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(project, managedZone, maxResults=None, pageToken=None, sortBy=None, x__xgafv=None)

Enumerates Operations for the given ManagedZone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -553,17 +553,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/dns_v1beta2.managedZones.html b/docs/dyn/dns_v1beta2.managedZones.html index 9053db83d0..a1fe1a8f2d 100644 --- a/docs/dyn/dns_v1beta2.managedZones.html +++ b/docs/dyn/dns_v1beta2.managedZones.html @@ -93,7 +93,7 @@

Instance Methods

list(project, dnsName=None, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates ManagedZones that have been created but not yet deleted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)

@@ -565,17 +565,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1beta2.policies.html b/docs/dyn/dns_v1beta2.policies.html index 693ce8a653..c0f23b8145 100644 --- a/docs/dyn/dns_v1beta2.policies.html +++ b/docs/dyn/dns_v1beta2.policies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all policies associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1beta2.resourceRecordSets.html b/docs/dyn/dns_v1beta2.resourceRecordSets.html index 7e249b5697..aeed9a839f 100644 --- a/docs/dyn/dns_v1beta2.resourceRecordSets.html +++ b/docs/dyn/dns_v1beta2.resourceRecordSets.html @@ -90,7 +90,7 @@

Instance Methods

list(project, managedZone, filter=None, maxResults=None, name=None, pageToken=None, type=None, x__xgafv=None)

Enumerates ResourceRecordSets that you have created but not yet deleted.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, managedZone, name, type, body=None, clientOperationId=None, x__xgafv=None)

@@ -989,17 +989,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1beta2.responsePolicies.html b/docs/dyn/dns_v1beta2.responsePolicies.html index 52c0e224bc..40ba00e32a 100644 --- a/docs/dyn/dns_v1beta2.responsePolicies.html +++ b/docs/dyn/dns_v1beta2.responsePolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(project, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all Response Policies associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, responsePolicy, body=None, clientOperationId=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/dns_v1beta2.responsePolicyRules.html b/docs/dyn/dns_v1beta2.responsePolicyRules.html index 927234bc20..0c42683ae5 100644 --- a/docs/dyn/dns_v1beta2.responsePolicyRules.html +++ b/docs/dyn/dns_v1beta2.responsePolicyRules.html @@ -90,7 +90,7 @@

Instance Methods

list(project, responsePolicy, maxResults=None, pageToken=None, x__xgafv=None)

Enumerates all Response Policy Rules associated with a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, responsePolicy, responsePolicyRule, body=None, clientOperationId=None, x__xgafv=None)

@@ -1026,17 +1026,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/docs_v1.html b/docs/dyn/docs_v1.html index 1174f76f6b..da42c31c44 100644 --- a/docs/dyn/docs_v1.html +++ b/docs/dyn/docs_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/documentai_v1.html b/docs/dyn/documentai_v1.html index 2d5672b9f9..8c21bd91da 100644 --- a/docs/dyn/documentai_v1.html +++ b/docs/dyn/documentai_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/documentai_v1.projects.locations.html b/docs/dyn/documentai_v1.projects.locations.html index 49a7994032..6a0769df6d 100644 --- a/docs/dyn/documentai_v1.projects.locations.html +++ b/docs/dyn/documentai_v1.projects.locations.html @@ -107,7 +107,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1.projects.locations.operations.html b/docs/dyn/documentai_v1.projects.locations.operations.html index da36c1679d..d191f60ef6 100644 --- a/docs/dyn/documentai_v1.projects.locations.operations.html +++ b/docs/dyn/documentai_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1.projects.locations.processorTypes.html b/docs/dyn/documentai_v1.projects.locations.processorTypes.html index 72b5f61051..5a4913cbfe 100644 --- a/docs/dyn/documentai_v1.projects.locations.processorTypes.html +++ b/docs/dyn/documentai_v1.projects.locations.processorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the processor types that exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1.projects.locations.processors.html b/docs/dyn/documentai_v1.projects.locations.processors.html index 43ee3f3216..8cb3e43734 100644 --- a/docs/dyn/documentai_v1.projects.locations.processors.html +++ b/docs/dyn/documentai_v1.projects.locations.processors.html @@ -109,7 +109,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all processors which belong to this project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

process(name, body=None, x__xgafv=None)

@@ -517,17 +517,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.evaluations.html b/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.evaluations.html index a8af208a31..1e257dfa0e 100644 --- a/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.evaluations.html +++ b/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.evaluations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a set of evaluations for a given processor version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -530,17 +530,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1.projects.locations.processors.processorVersions.html b/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.html index b184113408..e390c00fea 100644 --- a/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.html +++ b/docs/dyn/documentai_v1.projects.locations.processors.processorVersions.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all versions of a processor.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

process(name, body=None, x__xgafv=None)

@@ -609,17 +609,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1.projects.locations.schemas.html b/docs/dyn/documentai_v1.projects.locations.schemas.html index 8f1880d568..5489326900 100644 --- a/docs/dyn/documentai_v1.projects.locations.schemas.html +++ b/docs/dyn/documentai_v1.projects.locations.schemas.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1.projects.locations.schemas.schemaVersions.html b/docs/dyn/documentai_v1.projects.locations.schemas.schemaVersions.html index 5163366817..ce1e1c4250 100644 --- a/docs/dyn/documentai_v1.projects.locations.schemas.schemaVersions.html +++ b/docs/dyn/documentai_v1.projects.locations.schemas.schemaVersions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SchemaVersions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1695,17 +1695,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1beta3.html b/docs/dyn/documentai_v1beta3.html index 75930896e9..249fe707c5 100644 --- a/docs/dyn/documentai_v1beta3.html +++ b/docs/dyn/documentai_v1beta3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/documentai_v1beta3.projects.locations.html b/docs/dyn/documentai_v1beta3.projects.locations.html index 4647b06f0c..7fd7fffd0a 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.html @@ -107,7 +107,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -214,17 +214,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1beta3.projects.locations.operations.html b/docs/dyn/documentai_v1beta3.projects.locations.operations.html index fdaa4be900..9d63d8c59b 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.operations.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1beta3.projects.locations.processorTypes.html b/docs/dyn/documentai_v1beta3.projects.locations.processorTypes.html index 2cba591308..2a579eef12 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.processorTypes.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.processorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the processor types that exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1beta3.projects.locations.processors.dataset.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html index 0fe27b26f0..452ff6a0b1 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html @@ -93,7 +93,7 @@

Instance Methods

listDocuments(dataset, body=None, x__xgafv=None)

Returns a list of documents present in the dataset.

- listDocuments_next(previous_request, previous_response)

+ listDocuments_next()

Retrieves the next page of results.

updateDatasetSchema(name, body=None, updateMask=None, x__xgafv=None)

@@ -1528,17 +1528,17 @@

Method Details

- listDocuments_next(previous_request, previous_response) + listDocuments_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.html index 47b22a0f46..a07c05bb88 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.processors.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.html @@ -114,7 +114,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all processors which belong to this project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

process(name, body=None, x__xgafv=None)

@@ -553,17 +553,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.evaluations.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.evaluations.html index b17c995ab0..a49f2b5fd6 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.evaluations.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.evaluations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a set of evaluations for a given processor version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -530,17 +530,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/documentai_v1beta3.projects.locations.processors.processorVersions.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html index 517a9263ac..c9a89adafc 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all versions of a processor.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

process(name, body=None, x__xgafv=None)

@@ -714,17 +714,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.schemas.html b/docs/dyn/documentai_v1beta3.projects.locations.schemas.html index 6c5117d435..dd611517df 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.schemas.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.schemas.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Schemas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.schemas.schemaVersions.html b/docs/dyn/documentai_v1beta3.projects.locations.schemas.schemaVersions.html index 106e6f48bf..fe6e5a34b2 100644 --- a/docs/dyn/documentai_v1beta3.projects.locations.schemas.schemaVersions.html +++ b/docs/dyn/documentai_v1beta3.projects.locations.schemas.schemaVersions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SchemaVersions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1793,17 +1793,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/domains_v1.html b/docs/dyn/domains_v1.html index 81666ff78a..fc099e5f37 100644 --- a/docs/dyn/domains_v1.html +++ b/docs/dyn/domains_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/domains_v1.projects.locations.html b/docs/dyn/domains_v1.projects.locations.html index 59150c6f5d..efdc8a900c 100644 --- a/docs/dyn/domains_v1.projects.locations.html +++ b/docs/dyn/domains_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1.projects.locations.operations.html b/docs/dyn/domains_v1.projects.locations.operations.html index e8e2b2276c..955641e8dd 100644 --- a/docs/dyn/domains_v1.projects.locations.operations.html +++ b/docs/dyn/domains_v1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1.projects.locations.registrations.html b/docs/dyn/domains_v1.projects.locations.registrations.html index 7fb694bd84..c9c46736a0 100644 --- a/docs/dyn/domains_v1.projects.locations.registrations.html +++ b/docs/dyn/domains_v1.projects.locations.registrations.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `Registration` resources in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -129,7 +129,7 @@

Instance Methods

retrieveGoogleDomainsDnsRecords(registration, pageSize=None, pageToken=None, x__xgafv=None)

Lists the DNS records from the Google Domains DNS zone for domains that use the deprecated `google_domains_dns` in the `Registration`'s `dns_settings`.

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response)

+ retrieveGoogleDomainsDnsRecords_next()

Retrieves the next page of results.

retrieveGoogleDomainsForwardingConfig(registration, x__xgafv=None)

@@ -138,7 +138,7 @@

Instance Methods

retrieveImportableDomains(location, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: For more information, see [Cloud Domains feature deprecation](https://cloud.google.com/domains/docs/deprecations/feature-deprecations) Lists domain names from [Google Domains](https://domains.google/) that can be imported to Cloud Domains using the `ImportDomain` method. Since individual users can own domains in Google Domains, the list of domains returned depends on the individual user making the call. Domains already managed by Cloud Domains are not returned.

- retrieveImportableDomains_next(previous_request, previous_response)

+ retrieveImportableDomains_next()

Retrieves the next page of results.

retrieveRegisterParameters(location, domainName=None, x__xgafv=None)

@@ -1077,17 +1077,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1892,17 +1892,17 @@

Method Details

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response) + retrieveGoogleDomainsDnsRecords_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)
+        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.
-
+ 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. +
@@ -1972,17 +1972,17 @@

Method Details

- retrieveImportableDomains_next(previous_request, previous_response) + retrieveImportableDomains_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/domains_v1alpha2.html b/docs/dyn/domains_v1alpha2.html index deb2839246..04b3aaaa3d 100644 --- a/docs/dyn/domains_v1alpha2.html +++ b/docs/dyn/domains_v1alpha2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/domains_v1alpha2.projects.locations.html b/docs/dyn/domains_v1alpha2.projects.locations.html index 4ce937c6fd..1d9cde48ce 100644 --- a/docs/dyn/domains_v1alpha2.projects.locations.html +++ b/docs/dyn/domains_v1alpha2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1alpha2.projects.locations.operations.html b/docs/dyn/domains_v1alpha2.projects.locations.operations.html index 5a2c9674e4..3555469336 100644 --- a/docs/dyn/domains_v1alpha2.projects.locations.operations.html +++ b/docs/dyn/domains_v1alpha2.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1alpha2.projects.locations.registrations.html b/docs/dyn/domains_v1alpha2.projects.locations.registrations.html index 8d8674ab11..dbce9df641 100644 --- a/docs/dyn/domains_v1alpha2.projects.locations.registrations.html +++ b/docs/dyn/domains_v1alpha2.projects.locations.registrations.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `Registration` resources in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -129,7 +129,7 @@

Instance Methods

retrieveGoogleDomainsDnsRecords(registration, pageSize=None, pageToken=None, x__xgafv=None)

Lists the DNS records from the Google Domains DNS zone for domains that use the deprecated `google_domains_dns` in the `Registration`'s `dns_settings`.

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response)

+ retrieveGoogleDomainsDnsRecords_next()

Retrieves the next page of results.

retrieveGoogleDomainsForwardingConfig(registration, x__xgafv=None)

@@ -138,7 +138,7 @@

Instance Methods

retrieveImportableDomains(location, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: For more information, see [Cloud Domains feature deprecation](https://cloud.google.com/domains/docs/deprecations/feature-deprecations) Lists domain names from [Google Domains](https://domains.google/) that can be imported to Cloud Domains using the `ImportDomain` method. Since individual users can own domains in Google Domains, the list of domains returned depends on the individual user making the call. Domains already managed by Cloud Domains are not returned.

- retrieveImportableDomains_next(previous_request, previous_response)

+ retrieveImportableDomains_next()

Retrieves the next page of results.

retrieveRegisterParameters(location, domainName=None, x__xgafv=None)

@@ -1079,17 +1079,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1896,17 +1896,17 @@

Method Details

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response) + retrieveGoogleDomainsDnsRecords_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)
+        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.
-
+ 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. +
@@ -1976,17 +1976,17 @@

Method Details

- retrieveImportableDomains_next(previous_request, previous_response) + retrieveImportableDomains_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/domains_v1beta1.html b/docs/dyn/domains_v1beta1.html index d38f663c65..500ae7cc3e 100644 --- a/docs/dyn/domains_v1beta1.html +++ b/docs/dyn/domains_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/domains_v1beta1.projects.locations.html b/docs/dyn/domains_v1beta1.projects.locations.html index 267005c766..4092bc6deb 100644 --- a/docs/dyn/domains_v1beta1.projects.locations.html +++ b/docs/dyn/domains_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1beta1.projects.locations.operations.html b/docs/dyn/domains_v1beta1.projects.locations.operations.html index 4d96ab7440..4d0db072dc 100644 --- a/docs/dyn/domains_v1beta1.projects.locations.operations.html +++ b/docs/dyn/domains_v1beta1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/domains_v1beta1.projects.locations.registrations.html b/docs/dyn/domains_v1beta1.projects.locations.registrations.html index 5061add15b..563345a363 100644 --- a/docs/dyn/domains_v1beta1.projects.locations.registrations.html +++ b/docs/dyn/domains_v1beta1.projects.locations.registrations.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `Registration` resources in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -129,7 +129,7 @@

Instance Methods

retrieveGoogleDomainsDnsRecords(registration, pageSize=None, pageToken=None, x__xgafv=None)

Lists the DNS records from the Google Domains DNS zone for domains that use the deprecated `google_domains_dns` in the `Registration`'s `dns_settings`.

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response)

+ retrieveGoogleDomainsDnsRecords_next()

Retrieves the next page of results.

retrieveGoogleDomainsForwardingConfig(registration, x__xgafv=None)

@@ -138,7 +138,7 @@

Instance Methods

retrieveImportableDomains(location, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: For more information, see [Cloud Domains feature deprecation](https://cloud.google.com/domains/docs/deprecations/feature-deprecations) Lists domain names from [Google Domains](https://domains.google/) that can be imported to Cloud Domains using the `ImportDomain` method. Since individual users can own domains in Google Domains, the list of domains returned depends on the individual user making the call. Domains already managed by Cloud Domains are not returned.

- retrieveImportableDomains_next(previous_request, previous_response)

+ retrieveImportableDomains_next()

Retrieves the next page of results.

retrieveRegisterParameters(location, domainName=None, x__xgafv=None)

@@ -1077,17 +1077,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1892,17 +1892,17 @@

Method Details

- retrieveGoogleDomainsDnsRecords_next(previous_request, previous_response) + retrieveGoogleDomainsDnsRecords_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)
+        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.
-
+ 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. +
@@ -1972,17 +1972,17 @@

Method Details

- retrieveImportableDomains_next(previous_request, previous_response) + retrieveImportableDomains_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/doubleclickbidmanager_v2.html b/docs/dyn/doubleclickbidmanager_v2.html index b1f4812764..0e2eb5041a 100644 --- a/docs/dyn/doubleclickbidmanager_v2.html +++ b/docs/dyn/doubleclickbidmanager_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/doubleclickbidmanager_v2.queries.html b/docs/dyn/doubleclickbidmanager_v2.queries.html index 41ad17e652..00860cf4b2 100644 --- a/docs/dyn/doubleclickbidmanager_v2.queries.html +++ b/docs/dyn/doubleclickbidmanager_v2.queries.html @@ -95,7 +95,7 @@

Instance Methods

list(orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists queries created by the current user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(queryId, body=None, synchronous=None, x__xgafv=None)

@@ -402,17 +402,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/doubleclickbidmanager_v2.queries.reports.html b/docs/dyn/doubleclickbidmanager_v2.queries.reports.html index 988366a6cf..bad9d55f3f 100644 --- a/docs/dyn/doubleclickbidmanager_v2.queries.reports.html +++ b/docs/dyn/doubleclickbidmanager_v2.queries.reports.html @@ -84,7 +84,7 @@

Instance Methods

list(queryId, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists reports generated by the provided query.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -218,17 +218,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/doubleclicksearch_v2.html b/docs/dyn/doubleclicksearch_v2.html index a68de9b5ea..296eda9dd5 100644 --- a/docs/dyn/doubleclicksearch_v2.html +++ b/docs/dyn/doubleclicksearch_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drive_v2.changes.html b/docs/dyn/drive_v2.changes.html index dc5063691e..96d14f154e 100644 --- a/docs/dyn/drive_v2.changes.html +++ b/docs/dyn/drive_v2.changes.html @@ -87,7 +87,7 @@

Instance Methods

list(driveId=None, includeCorpusRemovals=None, includeDeleted=None, includeItemsFromAllDrives=None, includeLabels=None, includePermissionsForView=None, includeSubscribed=None, includeTeamDriveItems=None, maxResults=None, pageToken=None, spaces=None, startChangeId=None, supportsAllDrives=None, supportsTeamDrives=None, teamDriveId=None, x__xgafv=None)

Lists the changes for a user or shared drive.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

watch(body=None, driveId=None, includeCorpusRemovals=None, includeDeleted=None, includeItemsFromAllDrives=None, includeLabels=None, includePermissionsForView=None, includeSubscribed=None, includeTeamDriveItems=None, maxResults=None, pageToken=None, spaces=None, startChangeId=None, supportsAllDrives=None, supportsTeamDrives=None, teamDriveId=None, x__xgafv=None)

@@ -1183,17 +1183,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v2.children.html b/docs/dyn/drive_v2.children.html index e3780eecf7..d9856640aa 100644 --- a/docs/dyn/drive_v2.children.html +++ b/docs/dyn/drive_v2.children.html @@ -90,7 +90,7 @@

Instance Methods

list(folderId, maxResults=None, orderBy=None, pageToken=None, q=None, x__xgafv=None)

Lists a folder's children.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drive_v2.comments.html b/docs/dyn/drive_v2.comments.html index c5786ca9c1..7a8bd79675 100644 --- a/docs/dyn/drive_v2.comments.html +++ b/docs/dyn/drive_v2.comments.html @@ -90,7 +90,7 @@

Instance Methods

list(fileId, includeDeleted=None, maxResults=None, pageToken=None, updatedMin=None, x__xgafv=None)

Lists a file's comments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(fileId, commentId, body=None, x__xgafv=None)

@@ -385,17 +385,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v2.drives.html b/docs/dyn/drive_v2.drives.html index 3f87d49a7e..28878717c0 100644 --- a/docs/dyn/drive_v2.drives.html +++ b/docs/dyn/drive_v2.drives.html @@ -93,7 +93,7 @@

Instance Methods

list(maxResults=None, pageToken=None, q=None, useDomainAdminAccess=None, x__xgafv=None)

Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](https://developers.google.com/workspace/drive/api/guides/search-shareddrives) guide.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

unhide(driveId, x__xgafv=None)

@@ -431,17 +431,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v2.files.html b/docs/dyn/drive_v2.files.html index b054e4144c..0041c5a4c5 100644 --- a/docs/dyn/drive_v2.files.html +++ b/docs/dyn/drive_v2.files.html @@ -114,10 +114,10 @@

Instance Methods

listLabels(fileId, maxResults=None, pageToken=None, x__xgafv=None)

Lists the labels on a file.

- listLabels_next(previous_request, previous_response)

+ listLabels_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyLabels(fileId, body=None, x__xgafv=None)

@@ -2864,31 +2864,31 @@

Method Details

- listLabels_next(previous_request, previous_response) + listLabels_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v2.html b/docs/dyn/drive_v2.html index be4374ab00..4d9db06fb0 100644 --- a/docs/dyn/drive_v2.html +++ b/docs/dyn/drive_v2.html @@ -148,7 +148,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -157,20 +157,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drive_v2.permissions.html b/docs/dyn/drive_v2.permissions.html index ec59db6ca7..3b6a699432 100644 --- a/docs/dyn/drive_v2.permissions.html +++ b/docs/dyn/drive_v2.permissions.html @@ -79,7 +79,7 @@

Instance Methods

Close httplib2 connections.

delete(fileId, permissionId, enforceExpansiveAccess=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

-

Deletes a permission from a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

+

Deletes a permission from a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

get(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

Gets a permission by ID.

@@ -88,19 +88,19 @@

Instance Methods

Returns the permission ID for an email address.

insert(fileId, body=None, emailMessage=None, enforceExpansiveAccess=None, enforceSingleParent=None, moveToNewOwnersRoot=None, sendNotificationEmails=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

-

Inserts a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

+

Inserts a permission for a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

list(fileId, includePermissionsForView=None, maxResults=None, pageToken=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

Lists a file's or shared drive's permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None)

-

Updates a permission using patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

+

Updates a permission using patch semantics. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

update(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None)

-

Updates a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

+

Updates a permission. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

Method Details

close() @@ -109,7 +109,7 @@

Method Details

delete(fileId, permissionId, enforceExpansiveAccess=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None) - 
Deletes a permission from a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+  
Deletes a permission from a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID for the file or shared drive. (required)
@@ -212,7 +212,7 @@ 
Method Details

 
 

     insert(fileId, body=None, emailMessage=None, enforceExpansiveAccess=None, enforceSingleParent=None, moveToNewOwnersRoot=None, sendNotificationEmails=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)
-  
Inserts a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+  
Inserts a permission for a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID for the file or shared drive. (required)
@@ -404,22 +404,22 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None) - 
Updates a permission using patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+  
Updates a permission using patch semantics. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID for the file or shared drive. (required)
@@ -536,7 +536,7 @@ 
Method Details

 
 

     update(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None)
-  
Updates a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+  
Updates a permission. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID for the file or shared drive. (required)
diff --git a/docs/dyn/drive_v2.replies.html b/docs/dyn/drive_v2.replies.html
index a7c17a2c9e..48fc112409 100644
--- a/docs/dyn/drive_v2.replies.html
+++ b/docs/dyn/drive_v2.replies.html
@@ -90,7 +90,7 @@ 
Instance Methods

   list(fileId, commentId, includeDeleted=None, maxResults=None, pageToken=None, x__xgafv=None)

 
Lists all of the replies to a comment.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 

   patch(fileId, commentId, replyId, body=None, x__xgafv=None)

@@ -268,17 +268,17 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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.
+
diff --git a/docs/dyn/drive_v2.revisions.html b/docs/dyn/drive_v2.revisions.html index b01fe4069b..3d9ca708e5 100644 --- a/docs/dyn/drive_v2.revisions.html +++ b/docs/dyn/drive_v2.revisions.html @@ -87,7 +87,7 @@

Instance Methods

list(fileId, maxResults=None, pageToken=None, x__xgafv=None)

Lists a file's revisions. **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(fileId, revisionId, body=None, x__xgafv=None)

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v2.teamdrives.html b/docs/dyn/drive_v2.teamdrives.html index 6f27ee5cce..8242112f09 100644 --- a/docs/dyn/drive_v2.teamdrives.html +++ b/docs/dyn/drive_v2.teamdrives.html @@ -90,7 +90,7 @@

Instance Methods

list(maxResults=None, pageToken=None, q=None, useDomainAdminAccess=None, x__xgafv=None)

Deprecated: Use `drives.list` instead.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(teamDriveId, body=None, useDomainAdminAccess=None, x__xgafv=None)

@@ -361,17 +361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.accessproposals.html b/docs/dyn/drive_v3.accessproposals.html index 34e6ed4c29..6be7f0357d 100644 --- a/docs/dyn/drive_v3.accessproposals.html +++ b/docs/dyn/drive_v3.accessproposals.html @@ -84,7 +84,7 @@

Instance Methods

list(fileId, pageSize=None, pageToken=None, x__xgafv=None)

List the access proposals on a file. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access). Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resolve(fileId, proposalId, body=None, x__xgafv=None)

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.approvals.html b/docs/dyn/drive_v3.approvals.html index 1526332682..76e47bf193 100644 --- a/docs/dyn/drive_v3.approvals.html +++ b/docs/dyn/drive_v3.approvals.html @@ -96,7 +96,7 @@

Instance Methods

list(fileId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the approvals on a file. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). By default, this method returns a minimal response that may not include the items array. To retrieve approval details, you must explicitly specify the fields you want using the `fields` query parameter. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reassign(fileId, approvalId, body=None, x__xgafv=None)

@@ -446,17 +446,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.changes.html b/docs/dyn/drive_v3.changes.html index d6dafdafdf..2df39ecbae 100644 --- a/docs/dyn/drive_v3.changes.html +++ b/docs/dyn/drive_v3.changes.html @@ -84,7 +84,7 @@

Instance Methods

list(pageToken, driveId=None, includeCorpusRemovals=None, includeItemsFromAllDrives=None, includeLabels=None, includePermissionsForView=None, includeRemoved=None, includeTeamDriveItems=None, pageSize=None, restrictToMyDrive=None, spaces=None, supportsAllDrives=None, supportsTeamDrives=None, teamDriveId=None, x__xgafv=None)

Lists the changes for a user or shared drive. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

watch(pageToken, body=None, driveId=None, includeCorpusRemovals=None, includeItemsFromAllDrives=None, includeLabels=None, includePermissionsForView=None, includeRemoved=None, includeTeamDriveItems=None, pageSize=None, restrictToMyDrive=None, spaces=None, supportsAllDrives=None, supportsTeamDrives=None, teamDriveId=None, x__xgafv=None)

@@ -575,17 +575,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.comments.html b/docs/dyn/drive_v3.comments.html index 0d680ef281..e98e1a5f8f 100644 --- a/docs/dyn/drive_v3.comments.html +++ b/docs/dyn/drive_v3.comments.html @@ -90,7 +90,7 @@

Instance Methods

list(fileId, includeDeleted=None, pageSize=None, pageToken=None, startModifiedTime=None, x__xgafv=None)

Lists a file's comments. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(fileId, commentId, body=None, x__xgafv=None)

@@ -384,17 +384,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.drives.html b/docs/dyn/drive_v3.drives.html index 2d305a02ae..5684784e4c 100644 --- a/docs/dyn/drive_v3.drives.html +++ b/docs/dyn/drive_v3.drives.html @@ -93,7 +93,7 @@

Instance Methods

list(pageSize=None, pageToken=None, q=None, useDomainAdminAccess=None, x__xgafv=None)

Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](https://developers.google.com/workspace/drive/api/guides/search-shareddrives) guide.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

unhide(driveId, x__xgafv=None)

@@ -456,17 +456,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.files.html b/docs/dyn/drive_v3.files.html index a4e2dfc211..c5bf9d13c6 100644 --- a/docs/dyn/drive_v3.files.html +++ b/docs/dyn/drive_v3.files.html @@ -117,10 +117,10 @@

Instance Methods

listLabels(fileId, maxResults=None, pageToken=None, x__xgafv=None)

Lists the labels on a file. For more information, see [List labels on a file](https://developers.google.com/workspace/drive/api/guides/list-labels).

- listLabels_next(previous_request, previous_response)

+ listLabels_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyLabels(fileId, body=None, x__xgafv=None)

@@ -2330,31 +2330,31 @@

Method Details

- listLabels_next(previous_request, previous_response) + listLabels_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.html b/docs/dyn/drive_v3.html index b84df13616..cd1995f7ca 100644 --- a/docs/dyn/drive_v3.html +++ b/docs/dyn/drive_v3.html @@ -148,7 +148,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -157,20 +157,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drive_v3.permissions.html b/docs/dyn/drive_v3.permissions.html index 76930e6498..fcbb5e32b4 100644 --- a/docs/dyn/drive_v3.permissions.html +++ b/docs/dyn/drive_v3.permissions.html @@ -79,10 +79,10 @@

Instance Methods

Close httplib2 connections.

create(fileId, body=None, emailMessage=None, enforceExpansiveAccess=None, enforceSingleParent=None, moveToNewOwnersRoot=None, sendNotificationEmail=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None)

-

Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.

+

Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

delete(fileId, permissionId, enforceExpansiveAccess=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

-

Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.

+

Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

get(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

Gets a permission by ID. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).

@@ -90,11 +90,11 @@

Instance Methods

list(fileId, includePermissionsForView=None, pageSize=None, pageToken=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)

Lists a file's or shared drive's permissions. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None)

-

Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.

+

Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.

Method Details

close() @@ -103,7 +103,7 @@

Method Details

create(fileId, body=None, emailMessage=None, enforceExpansiveAccess=None, enforceSingleParent=None, moveToNewOwnersRoot=None, sendNotificationEmail=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None) - 
Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+  
Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID of the file or shared drive. (required)
@@ -196,7 +196,7 @@ 
Method Details

 
 

     delete(fileId, permissionId, enforceExpansiveAccess=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None, x__xgafv=None)
-  
Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+  
Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID of the file or shared drive. (required)
@@ -325,22 +325,22 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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.
+
update(fileId, permissionId, body=None, enforceExpansiveAccess=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None, x__xgafv=None) - 
Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+  
Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.
 
 Args:
   fileId: string, The ID of the file or shared drive. (required)
diff --git a/docs/dyn/drive_v3.replies.html b/docs/dyn/drive_v3.replies.html
index bce2cc0a43..b812a04acf 100644
--- a/docs/dyn/drive_v3.replies.html
+++ b/docs/dyn/drive_v3.replies.html
@@ -90,7 +90,7 @@ 
Instance Methods

   list(fileId, commentId, includeDeleted=None, pageSize=None, pageToken=None, x__xgafv=None)

 
Lists a comment's replies. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 

   update(fileId, commentId, replyId, body=None, x__xgafv=None)

@@ -271,17 +271,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.revisions.html b/docs/dyn/drive_v3.revisions.html index af7ff378d9..fb6885bb6e 100644 --- a/docs/dyn/drive_v3.revisions.html +++ b/docs/dyn/drive_v3.revisions.html @@ -90,7 +90,7 @@

Instance Methods

list(fileId, pageSize=None, pageToken=None, x__xgafv=None)

Lists a file's revisions. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions). **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(fileId, revisionId, body=None, x__xgafv=None)

@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drive_v3.teamdrives.html b/docs/dyn/drive_v3.teamdrives.html index 13619ea390..bea6a72aa3 100644 --- a/docs/dyn/drive_v3.teamdrives.html +++ b/docs/dyn/drive_v3.teamdrives.html @@ -90,7 +90,7 @@

Instance Methods

list(pageSize=None, pageToken=None, q=None, useDomainAdminAccess=None, x__xgafv=None)

Deprecated: Use `drives.list` instead.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(teamDriveId, body=None, useDomainAdminAccess=None, x__xgafv=None)

@@ -381,17 +381,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/driveactivity_v2.activity.html b/docs/dyn/driveactivity_v2.activity.html index 63d764ccc4..f15302ab63 100644 --- a/docs/dyn/driveactivity_v2.activity.html +++ b/docs/dyn/driveactivity_v2.activity.html @@ -81,7 +81,7 @@

Instance Methods

query(body=None, x__xgafv=None)

Query past activity in Google Drive.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -1147,17 +1147,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/driveactivity_v2.html b/docs/dyn/driveactivity_v2.html index aa6009713c..0aa9eeb0b9 100644 --- a/docs/dyn/driveactivity_v2.html +++ b/docs/dyn/driveactivity_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drivelabels_v2.html b/docs/dyn/drivelabels_v2.html index 739c8014b6..17b8cabeec 100644 --- a/docs/dyn/drivelabels_v2.html +++ b/docs/dyn/drivelabels_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drivelabels_v2.labels.html b/docs/dyn/drivelabels_v2.labels.html index 1e0e725788..dc3a0edfec 100644 --- a/docs/dyn/drivelabels_v2.labels.html +++ b/docs/dyn/drivelabels_v2.labels.html @@ -114,7 +114,7 @@

Instance Methods

list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)

List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(name, body=None, x__xgafv=None)

@@ -2645,17 +2645,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drivelabels_v2.labels.locks.html b/docs/dyn/drivelabels_v2.labels.locks.html index 729642002e..e7b0847899 100644 --- a/docs/dyn/drivelabels_v2.labels.locks.html +++ b/docs/dyn/drivelabels_v2.labels.locks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the label locks on a label.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2.labels.permissions.html b/docs/dyn/drivelabels_v2.labels.permissions.html index 4cd35f1c09..b9783dc444 100644 --- a/docs/dyn/drivelabels_v2.labels.permissions.html +++ b/docs/dyn/drivelabels_v2.labels.permissions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)

Lists a label's permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2.labels.revisions.locks.html b/docs/dyn/drivelabels_v2.labels.revisions.locks.html index 6704406208..d2dd64e48f 100644 --- a/docs/dyn/drivelabels_v2.labels.revisions.locks.html +++ b/docs/dyn/drivelabels_v2.labels.revisions.locks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the label locks on a label.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2.labels.revisions.permissions.html b/docs/dyn/drivelabels_v2.labels.revisions.permissions.html index b991fcffa8..ecd9435b7c 100644 --- a/docs/dyn/drivelabels_v2.labels.revisions.permissions.html +++ b/docs/dyn/drivelabels_v2.labels.revisions.permissions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)

Lists a label's permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2beta.html b/docs/dyn/drivelabels_v2beta.html index 06194b75f5..81aaf2307f 100644 --- a/docs/dyn/drivelabels_v2beta.html +++ b/docs/dyn/drivelabels_v2beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/drivelabels_v2beta.labels.html b/docs/dyn/drivelabels_v2beta.labels.html index 72e13c49c2..64c509989f 100644 --- a/docs/dyn/drivelabels_v2beta.labels.html +++ b/docs/dyn/drivelabels_v2beta.labels.html @@ -114,7 +114,7 @@

Instance Methods

list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)

List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(name, body=None, x__xgafv=None)

@@ -2645,17 +2645,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/drivelabels_v2beta.labels.locks.html b/docs/dyn/drivelabels_v2beta.labels.locks.html index 07befd79eb..d5306fa561 100644 --- a/docs/dyn/drivelabels_v2beta.labels.locks.html +++ b/docs/dyn/drivelabels_v2beta.labels.locks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the label locks on a label.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2beta.labels.permissions.html b/docs/dyn/drivelabels_v2beta.labels.permissions.html index eead10fd98..3c3ed65d19 100644 --- a/docs/dyn/drivelabels_v2beta.labels.permissions.html +++ b/docs/dyn/drivelabels_v2beta.labels.permissions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)

Lists a label's permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2beta.labels.revisions.locks.html b/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html index faedf31163..8b36209a1d 100644 --- a/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html +++ b/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the label locks on a label.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/drivelabels_v2beta.labels.revisions.permissions.html b/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html index a55fd68be6..92eef70d71 100644 --- a/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html +++ b/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)

Lists a label's permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/essentialcontacts_v1.folders.contacts.html b/docs/dyn/essentialcontacts_v1.folders.contacts.html index f8cfd9e466..d84a4a1064 100644 --- a/docs/dyn/essentialcontacts_v1.folders.contacts.html +++ b/docs/dyn/essentialcontacts_v1.folders.contacts.html @@ -81,7 +81,7 @@

Instance Methods

compute(parent, notificationCategories=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.

- compute_next(previous_request, previous_response)

+ compute_next()

Retrieves the next page of results.

create(parent, body=None, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the contacts that have been set on a resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -155,17 +155,17 @@

Method Details

- compute_next(previous_request, previous_response) + compute_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)
+        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.
-
+ 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. +
@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/essentialcontacts_v1.html b/docs/dyn/essentialcontacts_v1.html index 32728facab..4ef35494fb 100644 --- a/docs/dyn/essentialcontacts_v1.html +++ b/docs/dyn/essentialcontacts_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/essentialcontacts_v1.organizations.contacts.html b/docs/dyn/essentialcontacts_v1.organizations.contacts.html index 742df150d1..aaef8dffcc 100644 --- a/docs/dyn/essentialcontacts_v1.organizations.contacts.html +++ b/docs/dyn/essentialcontacts_v1.organizations.contacts.html @@ -81,7 +81,7 @@

Instance Methods

compute(parent, notificationCategories=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.

- compute_next(previous_request, previous_response)

+ compute_next()

Retrieves the next page of results.

create(parent, body=None, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the contacts that have been set on a resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -155,17 +155,17 @@

Method Details

- compute_next(previous_request, previous_response) + compute_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)
+        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.
-
+ 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. +
@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/essentialcontacts_v1.projects.contacts.html b/docs/dyn/essentialcontacts_v1.projects.contacts.html index 8be4964095..f0982e7d8b 100644 --- a/docs/dyn/essentialcontacts_v1.projects.contacts.html +++ b/docs/dyn/essentialcontacts_v1.projects.contacts.html @@ -81,7 +81,7 @@

Instance Methods

compute(parent, notificationCategories=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.

- compute_next(previous_request, previous_response)

+ compute_next()

Retrieves the next page of results.

create(parent, body=None, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the contacts that have been set on a resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -155,17 +155,17 @@

Method Details

- compute_next(previous_request, previous_response) + compute_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)
+        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.
-
+ 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. +
@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.html b/docs/dyn/eventarc_v1.html index 624a66de88..9e7705abd6 100644 --- a/docs/dyn/eventarc_v1.html +++ b/docs/dyn/eventarc_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/eventarc_v1.projects.locations.channelConnections.html b/docs/dyn/eventarc_v1.projects.locations.channelConnections.html index 284fadce21..92f0eebb97 100644 --- a/docs/dyn/eventarc_v1.projects.locations.channelConnections.html +++ b/docs/dyn/eventarc_v1.projects.locations.channelConnections.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List channel connections.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -306,17 +306,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.channels.html b/docs/dyn/eventarc_v1.projects.locations.channels.html index 194fc16b3c..7fdde7be8d 100644 --- a/docs/dyn/eventarc_v1.projects.locations.channels.html +++ b/docs/dyn/eventarc_v1.projects.locations.channels.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List channels.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.enrollments.html b/docs/dyn/eventarc_v1.projects.locations.enrollments.html index e8c5a98e53..eb1f6434b5 100644 --- a/docs/dyn/eventarc_v1.projects.locations.enrollments.html +++ b/docs/dyn/eventarc_v1.projects.locations.enrollments.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List Enrollments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -333,17 +333,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.googleApiSources.html b/docs/dyn/eventarc_v1.projects.locations.googleApiSources.html index 03c24e2e45..9cf9b8032b 100644 --- a/docs/dyn/eventarc_v1.projects.locations.googleApiSources.html +++ b/docs/dyn/eventarc_v1.projects.locations.googleApiSources.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List GoogleApiSources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -363,17 +363,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.html b/docs/dyn/eventarc_v1.projects.locations.html index e0d00cdca4..2f65d21016 100644 --- a/docs/dyn/eventarc_v1.projects.locations.html +++ b/docs/dyn/eventarc_v1.projects.locations.html @@ -132,7 +132,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateGoogleChannelConfig(name, body=None, updateMask=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.messageBuses.html b/docs/dyn/eventarc_v1.projects.locations.messageBuses.html index b3fb3a3ea2..6fb60176e7 100644 --- a/docs/dyn/eventarc_v1.projects.locations.messageBuses.html +++ b/docs/dyn/eventarc_v1.projects.locations.messageBuses.html @@ -96,10 +96,10 @@

Instance Methods

listEnrollments(parent, pageSize=None, pageToken=None, x__xgafv=None)

List message bus enrollments.

- listEnrollments_next(previous_request, previous_response)

+ listEnrollments_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -369,31 +369,31 @@

Method Details

- listEnrollments_next(previous_request, previous_response) + listEnrollments_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.operations.html b/docs/dyn/eventarc_v1.projects.locations.operations.html index 695fcc80eb..4cc4641220 100644 --- a/docs/dyn/eventarc_v1.projects.locations.operations.html +++ b/docs/dyn/eventarc_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/eventarc_v1.projects.locations.pipelines.html b/docs/dyn/eventarc_v1.projects.locations.pipelines.html index 839276598a..45ef0cc3b3 100644 --- a/docs/dyn/eventarc_v1.projects.locations.pipelines.html +++ b/docs/dyn/eventarc_v1.projects.locations.pipelines.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List pipelines.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -507,17 +507,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/eventarc_v1.projects.locations.providers.html b/docs/dyn/eventarc_v1.projects.locations.providers.html index 64dac1ab02..bab1c02365 100644 --- a/docs/dyn/eventarc_v1.projects.locations.providers.html +++ b/docs/dyn/eventarc_v1.projects.locations.providers.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List providers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/eventarc_v1.projects.locations.triggers.html b/docs/dyn/eventarc_v1.projects.locations.triggers.html index d562afd425..aa79d4cfe4 100644 --- a/docs/dyn/eventarc_v1.projects.locations.triggers.html +++ b/docs/dyn/eventarc_v1.projects.locations.triggers.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List triggers.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -456,17 +456,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/factchecktools_v1alpha1.claims.html b/docs/dyn/factchecktools_v1alpha1.claims.html index 9c87eff4b4..216649204d 100644 --- a/docs/dyn/factchecktools_v1alpha1.claims.html +++ b/docs/dyn/factchecktools_v1alpha1.claims.html @@ -81,13 +81,13 @@

Instance Methods

imageSearch(imageUri=None, languageCode=None, offset=None, pageSize=None, pageToken=None, x__xgafv=None)

Search through fact-checked claims using an image as the query.

- imageSearch_next(previous_request, previous_response)

+ imageSearch_next()

Retrieves the next page of results.

search(languageCode=None, maxAgeDays=None, offset=None, pageSize=None, pageToken=None, query=None, reviewPublisherSiteFilter=None, x__xgafv=None)

Search through fact-checked claims.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -141,17 +141,17 @@

Method Details

- imageSearch_next(previous_request, previous_response) + imageSearch_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)
+        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.
-
+ 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. +
@@ -200,17 +200,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/factchecktools_v1alpha1.html b/docs/dyn/factchecktools_v1alpha1.html index f1d35f2034..22eef9894d 100644 --- a/docs/dyn/factchecktools_v1alpha1.html +++ b/docs/dyn/factchecktools_v1alpha1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/factchecktools_v1alpha1.pages.html b/docs/dyn/factchecktools_v1alpha1.pages.html index 9571aa8dcb..b4b464f2b2 100644 --- a/docs/dyn/factchecktools_v1alpha1.pages.html +++ b/docs/dyn/factchecktools_v1alpha1.pages.html @@ -90,7 +90,7 @@

Instance Methods

list(offset=None, organization=None, pageSize=None, pageToken=None, url=None, x__xgafv=None)

List the `ClaimReview` markup pages for a specific URL or for an organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/fcm_v1.html b/docs/dyn/fcm_v1.html index 5c03ae7c61..9e7642eb96 100644 --- a/docs/dyn/fcm_v1.html +++ b/docs/dyn/fcm_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/fcm_v1.projects.registrations.topicSubscriptions.html b/docs/dyn/fcm_v1.projects.registrations.topicSubscriptions.html index edf34f7a29..0d8b402d1a 100644 --- a/docs/dyn/fcm_v1.projects.registrations.topicSubscriptions.html +++ b/docs/dyn/fcm_v1.projects.registrations.topicSubscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists TopicSubscriptions for a given app instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -201,17 +201,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/fcmdata_v1beta1.html b/docs/dyn/fcmdata_v1beta1.html index 68866b6376..650d7a3dbc 100644 --- a/docs/dyn/fcmdata_v1beta1.html +++ b/docs/dyn/fcmdata_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/fcmdata_v1beta1.projects.androidApps.deliveryData.html b/docs/dyn/fcmdata_v1beta1.projects.androidApps.deliveryData.html index 78fa0d5a77..b7672a20a8 100644 --- a/docs/dyn/fcmdata_v1beta1.projects.androidApps.deliveryData.html +++ b/docs/dyn/fcmdata_v1beta1.projects.androidApps.deliveryData.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List aggregate delivery data for the given Android application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -153,17 +153,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/file_v1.html b/docs/dyn/file_v1.html index ca7d66afa9..f42057d50c 100644 --- a/docs/dyn/file_v1.html +++ b/docs/dyn/file_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/file_v1.projects.locations.backups.html b/docs/dyn/file_v1.projects.locations.backups.html index 7ea8d591a2..798450ec68 100644 --- a/docs/dyn/file_v1.projects.locations.backups.html +++ b/docs/dyn/file_v1.projects.locations.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1.projects.locations.html b/docs/dyn/file_v1.projects.locations.html index 19966fd727..48b76d75f3 100644 --- a/docs/dyn/file_v1.projects.locations.html +++ b/docs/dyn/file_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/file_v1.projects.locations.instances.html b/docs/dyn/file_v1.projects.locations.instances.html index 07fb25c239..59eedbdcd6 100644 --- a/docs/dyn/file_v1.projects.locations.instances.html +++ b/docs/dyn/file_v1.projects.locations.instances.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instances in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -554,17 +554,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1.projects.locations.instances.snapshots.html b/docs/dyn/file_v1.projects.locations.instances.snapshots.html index f0b6ec0aa0..692db121c1 100644 --- a/docs/dyn/file_v1.projects.locations.instances.snapshots.html +++ b/docs/dyn/file_v1.projects.locations.instances.snapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all snapshots in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1.projects.locations.operations.html b/docs/dyn/file_v1.projects.locations.operations.html index 8ada23aa2e..0db9fcc2e6 100644 --- a/docs/dyn/file_v1.projects.locations.operations.html +++ b/docs/dyn/file_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/file_v1beta1.html b/docs/dyn/file_v1beta1.html index b92fe07185..3dc543519d 100644 --- a/docs/dyn/file_v1beta1.html +++ b/docs/dyn/file_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/file_v1beta1.projects.locations.backups.html b/docs/dyn/file_v1beta1.projects.locations.backups.html index 426fe92581..e821112abb 100644 --- a/docs/dyn/file_v1beta1.projects.locations.backups.html +++ b/docs/dyn/file_v1beta1.projects.locations.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1beta1.projects.locations.html b/docs/dyn/file_v1beta1.projects.locations.html index cbb7192f14..0590e5e71b 100644 --- a/docs/dyn/file_v1beta1.projects.locations.html +++ b/docs/dyn/file_v1beta1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/file_v1beta1.projects.locations.instances.html b/docs/dyn/file_v1beta1.projects.locations.instances.html index dc6f2e137b..13267b9232 100644 --- a/docs/dyn/file_v1beta1.projects.locations.instances.html +++ b/docs/dyn/file_v1beta1.projects.locations.instances.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instances in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -607,17 +607,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.shares.html b/docs/dyn/file_v1beta1.projects.locations.instances.shares.html index 321cb221b4..d31c265cb4 100644 --- a/docs/dyn/file_v1beta1.projects.locations.instances.shares.html +++ b/docs/dyn/file_v1beta1.projects.locations.instances.shares.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all shares for a specified instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -305,17 +305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.snapshots.html b/docs/dyn/file_v1beta1.projects.locations.instances.snapshots.html index e07cfa93e9..4ecd0411e2 100644 --- a/docs/dyn/file_v1beta1.projects.locations.instances.snapshots.html +++ b/docs/dyn/file_v1beta1.projects.locations.instances.snapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists all snapshots in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1beta1.projects.locations.operations.html b/docs/dyn/file_v1beta1.projects.locations.operations.html index 2a041c03f0..907fde5252 100644 --- a/docs/dyn/file_v1beta1.projects.locations.operations.html +++ b/docs/dyn/file_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/file_v1beta1.projects.locations.volumePools.html b/docs/dyn/file_v1beta1.projects.locations.volumePools.html index 8f14f566e2..dcdc3135fb 100644 --- a/docs/dyn/file_v1beta1.projects.locations.volumePools.html +++ b/docs/dyn/file_v1beta1.projects.locations.volumePools.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all volume pools in a project for either a specified location or for all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html b/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html index b17160ecef..c51d5f828f 100644 --- a/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html +++ b/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all volumes for a specified volume pool.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -230,17 +230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebase_v1beta1.availableProjects.html b/docs/dyn/firebase_v1beta1.availableProjects.html index a394dbd74d..31f0fa4ca6 100644 --- a/docs/dyn/firebase_v1beta1.availableProjects.html +++ b/docs/dyn/firebase_v1beta1.availableProjects.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists each [Google Cloud `Project`](https://cloud.google.com/resource-manager/reference/rest/v1/projects) that can have Firebase resources added and Firebase services enabled. A Project will only be listed if: - The caller has sufficient [Google IAM](https://cloud.google.com/iam) permissions to call AddFirebase. - The Project is not already a FirebaseProject. - The Project is not in an Organization which has policies that prevent Firebase resources from being added.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebase_v1beta1.html b/docs/dyn/firebase_v1beta1.html index 4d35bc1d0a..f916c85fa9 100644 --- a/docs/dyn/firebase_v1beta1.html +++ b/docs/dyn/firebase_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebase_v1beta1.projects.androidApps.html b/docs/dyn/firebase_v1beta1.projects.androidApps.html index 917061ed23..9f34fa22ac 100644 --- a/docs/dyn/firebase_v1beta1.projects.androidApps.html +++ b/docs/dyn/firebase_v1beta1.projects.androidApps.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each AndroidApp associated with the specified FirebaseProject. The elements are returned in no particular order, but will be a consistent view of the Apps when additional requests are made with a `pageToken`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebase_v1beta1.projects.availableLocations.html b/docs/dyn/firebase_v1beta1.projects.availableLocations.html index db1ad3276f..b566058762 100644 --- a/docs/dyn/firebase_v1beta1.projects.availableLocations.html +++ b/docs/dyn/firebase_v1beta1.projects.availableLocations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

**DECOMMISSIONED.** **If called, this endpoint will return a 404 error.** _Instead, use the applicable resource-specific REST API (or associated documentation, as needed) to determine valid locations for each resource used in your Project._ Lists the valid ["locations for default Google Cloud resources"](https://firebase.google.com/docs/projects/locations#default-cloud-location) for the specified Project (including a FirebaseProject). One of these locations can be selected as the Project's location for default Google Cloud resources, which is the geographical location where the Project's resources associated with Google App Engine (such as the default Cloud Firestore instance) will be provisioned by default. However, if the location for default Google Cloud resources has already been set for the Project, then this setting cannot be changed. This call checks for any possible [location restrictions](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) for the specified Project and, thus, might return a subset of all possible locations. To list all locations (regardless of any restrictions), call the endpoint without specifying a unique project identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call `ListAvailableLocations` with a specified project, a member must be at minimum a Viewer of the Project. Calls without a specified project do not require any specific project permissions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebase_v1beta1.projects.html b/docs/dyn/firebase_v1beta1.projects.html index 46ccb0b51b..723b31460a 100644 --- a/docs/dyn/firebase_v1beta1.projects.html +++ b/docs/dyn/firebase_v1beta1.projects.html @@ -121,7 +121,7 @@

Instance Methods

list(pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each FirebaseProject accessible to the caller. The elements are returned in no particular order, but they will be a consistent view of the Projects when additional requests are made with a `pageToken`. This method is eventually consistent with Project mutations, which means newly provisioned Projects and recent modifications to existing Projects might not be reflected in the set of Projects. The list will include only ACTIVE Projects. Use GetFirebaseProject for consistent reads as well as for additional Project details.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -133,7 +133,7 @@

Instance Methods

searchApps(parent, filter=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all available Apps for the specified FirebaseProject. This is a convenience method. Typically, interaction with an App should be done using the platform-specific service, but some tool use-cases require a summary of all known Apps (such as for App selector interfaces).

- searchApps_next(previous_request, previous_response)

+ searchApps_next()

Retrieves the next page of results.

Method Details

@@ -352,17 +352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -481,17 +481,17 @@

Method Details

- searchApps_next(previous_request, previous_response) + searchApps_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)
+        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.
-
+ 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/firebase_v1beta1.projects.iosApps.html b/docs/dyn/firebase_v1beta1.projects.iosApps.html index a4b57aa4e0..100ecb1502 100644 --- a/docs/dyn/firebase_v1beta1.projects.iosApps.html +++ b/docs/dyn/firebase_v1beta1.projects.iosApps.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each IosApp associated with the specified FirebaseProject. The elements are returned in no particular order, but will be a consistent view of the Apps when additional requests are made with a `pageToken`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebase_v1beta1.projects.webApps.html b/docs/dyn/firebase_v1beta1.projects.webApps.html index aae1b0353a..274082d523 100644 --- a/docs/dyn/firebase_v1beta1.projects.webApps.html +++ b/docs/dyn/firebase_v1beta1.projects.webApps.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each WebApp associated with the specified FirebaseProject. The elements are returned in no particular order, but will be a consistent view of the Apps when additional requests are made with a `pageToken`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1.html b/docs/dyn/firebaseappcheck_v1.html index 1973d44e1f..f78b97394f 100644 --- a/docs/dyn/firebaseappcheck_v1.html +++ b/docs/dyn/firebaseappcheck_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseappcheck_v1.projects.apps.debugTokens.html b/docs/dyn/firebaseappcheck_v1.projects.apps.debugTokens.html index 373ae8da25..a093fa80df 100644 --- a/docs/dyn/firebaseappcheck_v1.projects.apps.debugTokens.html +++ b/docs/dyn/firebaseappcheck_v1.projects.apps.debugTokens.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all DebugTokens for the specified app. For security reasons, the `token` field is never populated in the response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1.projects.services.html b/docs/dyn/firebaseappcheck_v1.projects.services.html index 308c5c04e2..87aff81931 100644 --- a/docs/dyn/firebaseappcheck_v1.projects.services.html +++ b/docs/dyn/firebaseappcheck_v1.projects.services.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Service configurations for the specified project. Only Services which were explicitly configured using UpdateService or BatchUpdateServices will be returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1.projects.services.resourcePolicies.html b/docs/dyn/firebaseappcheck_v1.projects.services.resourcePolicies.html index 60361e1b4d..a65b867e09 100644 --- a/docs/dyn/firebaseappcheck_v1.projects.services.resourcePolicies.html +++ b/docs/dyn/firebaseappcheck_v1.projects.services.resourcePolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ResourcePolicy configurations for the specified project and service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1beta.html b/docs/dyn/firebaseappcheck_v1beta.html index dd16fc0269..45230a9ce2 100644 --- a/docs/dyn/firebaseappcheck_v1beta.html +++ b/docs/dyn/firebaseappcheck_v1beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.apps.debugTokens.html b/docs/dyn/firebaseappcheck_v1beta.projects.apps.debugTokens.html index d470ecdaf8..ad4d62f1ef 100644 --- a/docs/dyn/firebaseappcheck_v1beta.projects.apps.debugTokens.html +++ b/docs/dyn/firebaseappcheck_v1beta.projects.apps.debugTokens.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all DebugTokens for the specified app. For security reasons, the `token` field is never populated in the response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.html index 030cf70990..9b054d79c8 100644 --- a/docs/dyn/firebaseappcheck_v1beta.projects.services.html +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Service configurations for the specified project. Only Services which were explicitly configured using UpdateService or BatchUpdateServices will be returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html index b5b25b03d3..0944c7e506 100644 --- a/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ResourcePolicy configurations for the specified project and service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappdistribution_v1.html b/docs/dyn/firebaseappdistribution_v1.html index 6b4cac2a14..69b70a2404 100644 --- a/docs/dyn/firebaseappdistribution_v1.html +++ b/docs/dyn/firebaseappdistribution_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html index c5685833e9..02e56a8c23 100644 --- a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html +++ b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists feedback reports. By default, sorts by `createTime` in descending order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseappdistribution_v1.projects.apps.releases.html b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html index 96c37c3fbc..ba8ff46924 100644 --- a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html +++ b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists releases. By default, sorts by `createTime` in descending order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.operations.html b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.operations.html index 435b5251e0..2c0326168c 100644 --- a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.operations.html +++ b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.groups.html b/docs/dyn/firebaseappdistribution_v1.projects.groups.html index 8c0e1c70b5..831db39d8e 100644 --- a/docs/dyn/firebaseappdistribution_v1.projects.groups.html +++ b/docs/dyn/firebaseappdistribution_v1.projects.groups.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.testers.html b/docs/dyn/firebaseappdistribution_v1.projects.testers.html index 13683ee9f3..2c26da1701 100644 --- a/docs/dyn/firebaseappdistribution_v1.projects.testers.html +++ b/docs/dyn/firebaseappdistribution_v1.projects.testers.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists testers and their resource ids.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -198,17 +198,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.html b/docs/dyn/firebaseappdistribution_v1alpha.html index 9ee710a055..189bd58194 100644 --- a/docs/dyn/firebaseappdistribution_v1alpha.html +++ b/docs/dyn/firebaseappdistribution_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.releases.tests.html b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.releases.tests.html index 830eed4a33..f6e88d69f8 100644 --- a/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.releases.tests.html +++ b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.releases.tests.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List results for automated tests run on release.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -830,17 +830,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseappdistribution_v1alpha.projects.apps.testCases.html b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html index d2d78469f6..aa9101dde1 100644 --- a/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html +++ b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List test cases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, x__xgafv=None)

@@ -399,17 +399,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseapphosting_v1.html b/docs/dyn/firebaseapphosting_v1.html index 730ced3f3f..8c5e3a92f2 100644 --- a/docs/dyn/firebaseapphosting_v1.html +++ b/docs/dyn/firebaseapphosting_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.builds.html b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.builds.html index 108e2c3fa0..f1f3e783d0 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.builds.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.builds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists builds in a given project, location, and backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -521,17 +521,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1.projects.locations.backends.domains.html b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.domains.html index 779d467cd5..1e60ff1971 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.domains.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.domains.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists domains of a backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.html b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.html index 9bdfc26d53..72c03bf453 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.html @@ -110,7 +110,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists backends in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -350,17 +350,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.rollouts.html b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.rollouts.html index 24b880b552..fb35d53cec 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.backends.rollouts.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.backends.rollouts.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists rollouts for a backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1.projects.locations.html b/docs/dyn/firebaseapphosting_v1.projects.locations.html index 1f4152a355..e38785e1b8 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1.projects.locations.operations.html b/docs/dyn/firebaseapphosting_v1.projects.locations.operations.html index 2b337b0438..430ad3fd1a 100644 --- a/docs/dyn/firebaseapphosting_v1.projects.locations.operations.html +++ b/docs/dyn/firebaseapphosting_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1beta.html b/docs/dyn/firebaseapphosting_v1beta.html index 68bdde8869..83a34f406a 100644 --- a/docs/dyn/firebaseapphosting_v1beta.html +++ b/docs/dyn/firebaseapphosting_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.builds.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.builds.html index b5924ae5c1..eb0b56b85e 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.builds.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.builds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists builds in a given project, location, and backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -626,17 +626,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1beta.projects.locations.backends.domains.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.domains.html index ac25f0d082..8d01a66bbe 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.domains.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.domains.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists domains of a backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -518,17 +518,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.html index 76bc0b6fff..3f5f62325c 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.html @@ -110,7 +110,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists backends in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -398,17 +398,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.rollouts.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.rollouts.html index 551912ad19..b9850b76a0 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.rollouts.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.backends.rollouts.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists rollouts for a backend.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1beta.projects.locations.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.html index 9fccacc258..c6d9aafada 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseapphosting_v1beta.projects.locations.operations.html b/docs/dyn/firebaseapphosting_v1beta.projects.locations.operations.html index 7d32cf7318..9d62c2e875 100644 --- a/docs/dyn/firebaseapphosting_v1beta.projects.locations.operations.html +++ b/docs/dyn/firebaseapphosting_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasecrashlytics_v1alpha.html b/docs/dyn/firebasecrashlytics_v1alpha.html index 62f899f9e0..07924ae8cb 100644 --- a/docs/dyn/firebasecrashlytics_v1alpha.html +++ b/docs/dyn/firebasecrashlytics_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.events.html b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.events.html index a00dd07ffa..ad9281460a 100644 --- a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.events.html +++ b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.events.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter_browser_displayNames=None, filter_device_displayNames=None, filter_device_formFactors=None, filter_interval_endTime=None, filter_interval_startTime=None, filter_issue_content=None, filter_issue_errorTypes=None, filter_issue_id=None, filter_issue_signals=None, filter_issue_state=None, filter_issue_states=None, filter_issue_variantId=None, filter_operatingSystem_displayNames=None, filter_version_displayNames=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

List the events for an issue matching filter criteria, sorted in descending order by timestamp.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -579,17 +579,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasecrashlytics_v1alpha.projects.apps.issues.notes.html b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.issues.notes.html index c8def0baf0..76dc929bd7 100644 --- a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.issues.notes.html +++ b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.issues.notes.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all notes for a certain issue, sorted in descending order by timestamp.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasecrashlytics_v1alpha.projects.apps.reports.html b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html index 79d4ce0393..814bac921a 100644 --- a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html +++ b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html @@ -81,7 +81,7 @@

Instance Methods

get(name, filter_browser_displayNames=None, filter_device_displayNames=None, filter_device_formFactors=None, filter_interval_endTime=None, filter_interval_startTime=None, filter_issue_content=None, filter_issue_errorTypes=None, filter_issue_id=None, filter_issue_signals=None, filter_issue_state=None, filter_issue_states=None, filter_issue_variantId=None, filter_operatingSystem_displayNames=None, filter_version_displayNames=None, granularity=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a report with its computed results.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

list(parent, x__xgafv=None)

@@ -252,17 +252,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedatabase_v1beta.html b/docs/dyn/firebasedatabase_v1beta.html index 53ec45675c..6fc2263083 100644 --- a/docs/dyn/firebasedatabase_v1beta.html +++ b/docs/dyn/firebasedatabase_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasedatabase_v1beta.projects.locations.instances.html b/docs/dyn/firebasedatabase_v1beta.projects.locations.instances.html index 857e439b37..380e6616ba 100644 --- a/docs/dyn/firebasedatabase_v1beta.projects.locations.instances.html +++ b/docs/dyn/firebasedatabase_v1beta.projects.locations.instances.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each DatabaseInstance associated with the specified parent project. The list items are returned in no particular order, but will be a consistent view of the database instances when additional requests are made with a `pageToken`. The resulting list contains instances in any STATE. The list results may be stale by a few seconds. Use GetDatabaseInstance for consistent reads.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reenable(name, body=None, x__xgafv=None)

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1.html b/docs/dyn/firebasedataconnect_v1.html index 4d8241b77e..8f030e8b25 100644 --- a/docs/dyn/firebasedataconnect_v1.html +++ b/docs/dyn/firebasedataconnect_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasedataconnect_v1.projects.locations.html b/docs/dyn/firebasedataconnect_v1.projects.locations.html index 0d45b7ced6..3beb884c06 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasedataconnect_v1.projects.locations.operations.html b/docs/dyn/firebasedataconnect_v1.projects.locations.operations.html index aa60351c39..bcf48c4197 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.operations.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasedataconnect_v1.projects.locations.services.connectors.html b/docs/dyn/firebasedataconnect_v1.projects.locations.services.connectors.html index 136f8b3d09..c4204e83f5 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.services.connectors.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.services.connectors.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -627,17 +627,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1.projects.locations.services.html b/docs/dyn/firebasedataconnect_v1.projects.locations.services.html index 82973430ad..795b5984bc 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.services.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.services.html @@ -115,7 +115,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Services in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -911,17 +911,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html b/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html index 503d989830..077bf77d6a 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Schemas in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1beta.html b/docs/dyn/firebasedataconnect_v1beta.html index b9824b6cf8..2007b945d5 100644 --- a/docs/dyn/firebasedataconnect_v1beta.html +++ b/docs/dyn/firebasedataconnect_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasedataconnect_v1beta.projects.locations.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.html index 61bb5876cb..33fc8f62eb 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasedataconnect_v1beta.projects.locations.operations.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.operations.html index 0b1c241122..46ee2f891b 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.operations.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasedataconnect_v1beta.projects.locations.services.connectors.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.connectors.html index 72f3d2b91b..5aa0c3a10d 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.connectors.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.connectors.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Connectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -627,17 +627,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html index 90223a7fc7..02229dadd5 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html @@ -115,7 +115,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Services in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -911,17 +911,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html index e517053bda..b7a0f12ef2 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Schemas in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasedynamiclinks_v1.html b/docs/dyn/firebasedynamiclinks_v1.html index 96b9d74cc5..d54e999b1f 100644 --- a/docs/dyn/firebasedynamiclinks_v1.html +++ b/docs/dyn/firebasedynamiclinks_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasehosting_v1.html b/docs/dyn/firebasehosting_v1.html index 72f2daad8a..594c7535e8 100644 --- a/docs/dyn/firebasehosting_v1.html +++ b/docs/dyn/firebasehosting_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasehosting_v1.operations.html b/docs/dyn/firebasehosting_v1.operations.html index f89b45934d..abc8d27430 100644 --- a/docs/dyn/firebasehosting_v1.operations.html +++ b/docs/dyn/firebasehosting_v1.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.html b/docs/dyn/firebasehosting_v1beta1.html index a9e92db0fc..458b1187f0 100644 --- a/docs/dyn/firebasehosting_v1beta1.html +++ b/docs/dyn/firebasehosting_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.html index 450d53169d..c5d8163525 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the channels for the specified site. All sites have a default `live` channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -529,17 +529,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.releases.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.releases.html index 73b678dfef..96d4203d7d 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.releases.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.channels.releases.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the releases that have been created for the specified site or channel. When used to list releases for a site, this list includes releases for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -452,17 +452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.projects.sites.customDomains.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.html index ed99efdc3c..0e92966483 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists each `CustomDomain` associated with the specified parent Hosting site. Returns `CustomDomain`s in a consistent, but undefined, order to facilitate pagination.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -223,7 +223,7 @@

Method Details

"labels": { # Labels used for extra metadata and/or filtering. "a_key": "A String", }, - "name": "A String", # Output only. The fully-qualified name of the `CustomDomain`. + "name": "A String", # Identifier. The fully-qualified name of the `CustomDomain`. "ownershipState": "A String", # Output only. The `OwnershipState` of the domain name this `CustomDomain` refers to. "reconciling": True or False, # Output only. A field that, if true, indicates that Hosting's systems are attmepting to make the custom domain's state match your preferred state. This is most frequently `true` when initially provisioning a `CustomDomain` after a `CreateCustomDomain` request or when creating a new SSL certificate to match an updated `cert_preference` after an `UpdateCustomDomain` request. "redirectTarget": "A String", # A domain name that this `CustomDomain` should direct traffic towards. If specified, Hosting will respond to requests against this custom domain with an HTTP 301 code, and route traffic to the specified `redirect_target` instead. @@ -465,7 +465,7 @@

Method Details

"labels": { # Labels used for extra metadata and/or filtering. "a_key": "A String", }, - "name": "A String", # Output only. The fully-qualified name of the `CustomDomain`. + "name": "A String", # Identifier. The fully-qualified name of the `CustomDomain`. "ownershipState": "A String", # Output only. The `OwnershipState` of the domain name this `CustomDomain` refers to. "reconciling": True or False, # Output only. A field that, if true, indicates that Hosting's systems are attmepting to make the custom domain's state match your preferred state. This is most frequently `true` when initially provisioning a `CustomDomain` after a `CreateCustomDomain` request or when creating a new SSL certificate to match an updated `cert_preference` after an `UpdateCustomDomain` request. "redirectTarget": "A String", # A domain name that this `CustomDomain` should direct traffic towards. If specified, Hosting will respond to requests against this custom domain with an HTTP 301 code, and route traffic to the specified `redirect_target` instead. @@ -644,7 +644,7 @@

Method Details

"labels": { # Labels used for extra metadata and/or filtering. "a_key": "A String", }, - "name": "A String", # Output only. The fully-qualified name of the `CustomDomain`. + "name": "A String", # Identifier. The fully-qualified name of the `CustomDomain`. "ownershipState": "A String", # Output only. The `OwnershipState` of the domain name this `CustomDomain` refers to. "reconciling": True or False, # Output only. A field that, if true, indicates that Hosting's systems are attmepting to make the custom domain's state match your preferred state. This is most frequently `true` when initially provisioning a `CustomDomain` after a `CreateCustomDomain` request or when creating a new SSL certificate to match an updated `cert_preference` after an `UpdateCustomDomain` request. "redirectTarget": "A String", # A domain name that this `CustomDomain` should direct traffic towards. If specified, Hosting will respond to requests against this custom domain with an HTTP 301 code, and route traffic to the specified `redirect_target` instead. @@ -703,17 +703,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -721,7 +721,7 @@

Method Details

Updates the specified `CustomDomain`.
 
 Args:
-  name: string, Output only. The fully-qualified name of the `CustomDomain`. (required)
+  name: string, Identifier. The fully-qualified name of the `CustomDomain`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -830,7 +830,7 @@ 
Method Details

   "labels": { # Labels used for extra metadata and/or filtering.
     "a_key": "A String",
   },
-  "name": "A String", # Output only. The fully-qualified name of the `CustomDomain`.
+  "name": "A String", # Identifier. The fully-qualified name of the `CustomDomain`.
   "ownershipState": "A String", # Output only. The `OwnershipState` of the domain name this `CustomDomain` refers to.
   "reconciling": True or False, # Output only. A field that, if true, indicates that Hosting's systems are attmepting to make the custom domain's state match your preferred state. This is most frequently `true` when initially provisioning a `CustomDomain` after a `CreateCustomDomain` request or when creating a new SSL certificate to match an updated `cert_preference` after an `UpdateCustomDomain` request.
   "redirectTarget": "A String", # A domain name that this `CustomDomain` should direct traffic towards. If specified, Hosting will respond to requests against this custom domain with an HTTP 301 code, and route traffic to the specified `redirect_target` instead.
diff --git a/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.operations.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.operations.html
index 2dc7849f05..f18c2c1d3f 100644
--- a/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.operations.html
+++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.customDomains.operations.html
@@ -84,7 +84,7 @@ 
Instance Methods

   list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

 
Lists operations that match the specified filter in the request.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 
Method Details

 

@@ -175,17 +175,17 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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/firebasehosting_v1beta1.projects.sites.domains.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.domains.html index 68172ae4c4..f1c1c2eb12 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.domains.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.domains.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.projects.sites.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.html index a0937dd1cc..095cadf73a 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.html @@ -118,7 +118,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists each Hosting Site associated with the specified parent Firebase project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.projects.sites.releases.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.releases.html index 002c09e0c3..6b4d59f0d4 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.releases.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.releases.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the releases that have been created for the specified site or channel. When used to list releases for a site, this list includes releases for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -452,17 +452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.projects.sites.versions.files.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.files.html index 73002cfc52..007da58e8a 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.files.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.files.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, status=None, x__xgafv=None)

Lists the remaining files to be uploaded for the specified version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.projects.sites.versions.html b/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.html index 297edf3e35..2a8f4a3d93 100644 --- a/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.html +++ b/docs/dyn/firebasehosting_v1beta1.projects.sites.versions.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the versions that have been created for the specified site. This list includes versions for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -502,17 +502,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.sites.channels.html b/docs/dyn/firebasehosting_v1beta1.sites.channels.html index e956951b11..891a9bb2de 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.channels.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.channels.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the channels for the specified site. All sites have a default `live` channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -529,17 +529,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.sites.channels.releases.html b/docs/dyn/firebasehosting_v1beta1.sites.channels.releases.html index 7b018cb7a2..6d909d6ee7 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.channels.releases.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.channels.releases.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the releases that have been created for the specified site or channel. When used to list releases for a site, this list includes releases for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -452,17 +452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.sites.domains.html b/docs/dyn/firebasehosting_v1beta1.sites.domains.html index f5d18eddda..de0c29dc78 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.domains.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.domains.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebasehosting_v1beta1.sites.releases.html b/docs/dyn/firebasehosting_v1beta1.sites.releases.html index ec98fa7c6b..8dd0d6a66c 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.releases.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.releases.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the releases that have been created for the specified site or channel. When used to list releases for a site, this list includes releases for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -452,17 +452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.sites.versions.files.html b/docs/dyn/firebasehosting_v1beta1.sites.versions.files.html index 7d54394403..15e846dae4 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.versions.files.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.versions.files.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, status=None, x__xgafv=None)

Lists the remaining files to be uploaded for the specified version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasehosting_v1beta1.sites.versions.html b/docs/dyn/firebasehosting_v1beta1.sites.versions.html index 93d2ceac1f..88c5ce3563 100644 --- a/docs/dyn/firebasehosting_v1beta1.sites.versions.html +++ b/docs/dyn/firebasehosting_v1beta1.sites.versions.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the versions that have been created for the specified site. This list includes versions for both the default `live` channel and any active preview channels for the specified site.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -502,17 +502,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseml_v1.html b/docs/dyn/firebaseml_v1.html index 3a257a7214..e5e487fd20 100644 --- a/docs/dyn/firebaseml_v1.html +++ b/docs/dyn/firebaseml_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseml_v1.operations.html b/docs/dyn/firebaseml_v1.operations.html index dbf6783b6f..ef3049d021 100644 --- a/docs/dyn/firebaseml_v1.operations.html +++ b/docs/dyn/firebaseml_v1.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebaseml_v1beta2.html b/docs/dyn/firebaseml_v1beta2.html index 3d80586459..849163815a 100644 --- a/docs/dyn/firebaseml_v1beta2.html +++ b/docs/dyn/firebaseml_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaseml_v1beta2.projects.models.html b/docs/dyn/firebaseml_v1beta2.projects.models.html index 679faf5e21..ca5813e08b 100644 --- a/docs/dyn/firebaseml_v1beta2.projects.models.html +++ b/docs/dyn/firebaseml_v1beta2.projects.models.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the models

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -371,17 +371,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaseml_v2beta.html b/docs/dyn/firebaseml_v2beta.html index 645ba3e3b3..c13b588696 100644 --- a/docs/dyn/firebaseml_v2beta.html +++ b/docs/dyn/firebaseml_v2beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaserules_v1.html b/docs/dyn/firebaserules_v1.html index fbe321401d..5117085e98 100644 --- a/docs/dyn/firebaserules_v1.html +++ b/docs/dyn/firebaserules_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebaserules_v1.projects.releases.html b/docs/dyn/firebaserules_v1.projects.releases.html index aa6d52e140..626978888c 100644 --- a/docs/dyn/firebaserules_v1.projects.releases.html +++ b/docs/dyn/firebaserules_v1.projects.releases.html @@ -93,7 +93,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List the `Release` values for a project. This list may optionally be filtered by `Release` name, `Ruleset` name, `TestSuite` name, or any combination thereof.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firebaserules_v1.projects.rulesets.html b/docs/dyn/firebaserules_v1.projects.rulesets.html index 4e9ea5507b..6a98e8c7a2 100644 --- a/docs/dyn/firebaserules_v1.projects.rulesets.html +++ b/docs/dyn/firebaserules_v1.projects.rulesets.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List `Ruleset` metadata only and optionally filter the results by `Ruleset` name. The full `Source` contents of a `Ruleset` may be retrieved with GetRuleset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firebasestorage_v1beta.html b/docs/dyn/firebasestorage_v1beta.html index 7aaee510a4..6c183b81de 100644 --- a/docs/dyn/firebasestorage_v1beta.html +++ b/docs/dyn/firebasestorage_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firebasestorage_v1beta.projects.buckets.html b/docs/dyn/firebasestorage_v1beta.projects.buckets.html index d6d0dadf77..1358883a31 100644 --- a/docs/dyn/firebasestorage_v1beta.projects.buckets.html +++ b/docs/dyn/firebasestorage_v1beta.projects.buckets.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the linked storage buckets for a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeFirebase(bucket, body=None, x__xgafv=None)

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firestore_v1.html b/docs/dyn/firestore_v1.html index ce341e6270..8684bf071b 100644 --- a/docs/dyn/firestore_v1.html +++ b/docs/dyn/firestore_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firestore_v1.projects.databases.collectionGroups.fields.html b/docs/dyn/firestore_v1.projects.databases.collectionGroups.fields.html index cd023fcf55..e079d3559a 100644 --- a/docs/dyn/firestore_v1.projects.databases.collectionGroups.fields.html +++ b/docs/dyn/firestore_v1.projects.databases.collectionGroups.fields.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the field configuration and metadata for this database. Currently, FirestoreAdmin.ListFields only supports listing fields that have been explicitly overridden. To issue this query, call FirestoreAdmin.ListFields with the filter set to `indexConfig.usesAncestorConfig:false` or `ttlConfig:*`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firestore_v1.projects.databases.collectionGroups.indexes.html b/docs/dyn/firestore_v1.projects.databases.collectionGroups.indexes.html index 2e73d5cd11..b217268850 100644 --- a/docs/dyn/firestore_v1.projects.databases.collectionGroups.indexes.html +++ b/docs/dyn/firestore_v1.projects.databases.collectionGroups.indexes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists composite indexes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firestore_v1.projects.databases.documents.html b/docs/dyn/firestore_v1.projects.databases.documents.html index 82fd63c177..cb53f7ba64 100644 --- a/docs/dyn/firestore_v1.projects.databases.documents.html +++ b/docs/dyn/firestore_v1.projects.databases.documents.html @@ -108,16 +108,16 @@

Instance Methods

listCollectionIds(parent, body=None, x__xgafv=None)

Lists all the collection IDs underneath a document.

- listCollectionIds_next(previous_request, previous_response)

+ listCollectionIds_next()

Retrieves the next page of results.

listDocuments(parent, collectionId, mask_fieldPaths=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, recursive=None, requestOptions_requestTags=None, showMissing=None, transaction=None, x__xgafv=None)

Lists documents.

- listDocuments_next(previous_request, previous_response)

+ listDocuments_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

listen(database, body=None, x__xgafv=None)

@@ -126,7 +126,7 @@

Instance Methods

partitionQuery(parent, body=None, x__xgafv=None)

Partitions a query by returning partition cursors that can be used to run the query in parallel. The returned partition cursors are split points that can be used by RunQuery as starting/end points for the query results.

- partitionQuery_next(previous_request, previous_response)

+ partitionQuery_next()

Retrieves the next page of results.

patch(name, body=None, currentDocument_exists=None, currentDocument_updateTime=None, mask_fieldPaths=None, requestOptions_requestTags=None, updateMask_fieldPaths=None, x__xgafv=None)

@@ -1785,17 +1785,17 @@

Method Details

- listCollectionIds_next(previous_request, previous_response) + listCollectionIds_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)
+        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.
-
+ 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. +
@@ -1885,31 +1885,31 @@

Method Details

- listDocuments_next(previous_request, previous_response) + listDocuments_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2667,17 +2667,17 @@

Method Details

- partitionQuery_next(previous_request, previous_response) + partitionQuery_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firestore_v1.projects.databases.operations.html b/docs/dyn/firestore_v1.projects.databases.operations.html index cf2437d1e3..d98679dd1b 100644 --- a/docs/dyn/firestore_v1.projects.databases.operations.html +++ b/docs/dyn/firestore_v1.projects.databases.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firestore_v1.projects.locations.html b/docs/dyn/firestore_v1.projects.locations.html index b6f279743f..ec53e859a9 100644 --- a/docs/dyn/firestore_v1.projects.locations.html +++ b/docs/dyn/firestore_v1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firestore_v1beta1.html b/docs/dyn/firestore_v1beta1.html index 852ad0471f..e0a7c23420 100644 --- a/docs/dyn/firestore_v1beta1.html +++ b/docs/dyn/firestore_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firestore_v1beta1.projects.databases.documents.html b/docs/dyn/firestore_v1beta1.projects.databases.documents.html index 1e844ba03c..e7ba73a70d 100644 --- a/docs/dyn/firestore_v1beta1.projects.databases.documents.html +++ b/docs/dyn/firestore_v1beta1.projects.databases.documents.html @@ -108,16 +108,16 @@

Instance Methods

listCollectionIds(parent, body=None, x__xgafv=None)

Lists all the collection IDs underneath a document.

- listCollectionIds_next(previous_request, previous_response)

+ listCollectionIds_next()

Retrieves the next page of results.

listDocuments(parent, collectionId, mask_fieldPaths=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, recursive=None, requestOptions_requestTags=None, showMissing=None, transaction=None, x__xgafv=None)

Lists documents.

- listDocuments_next(previous_request, previous_response)

+ listDocuments_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

listen(database, body=None, x__xgafv=None)

@@ -126,7 +126,7 @@

Instance Methods

partitionQuery(parent, body=None, x__xgafv=None)

Partitions a query by returning partition cursors that can be used to run the query in parallel. The returned partition cursors are split points that can be used by RunQuery as starting/end points for the query results.

- partitionQuery_next(previous_request, previous_response)

+ partitionQuery_next()

Retrieves the next page of results.

patch(name, body=None, currentDocument_exists=None, currentDocument_updateTime=None, mask_fieldPaths=None, requestOptions_requestTags=None, updateMask_fieldPaths=None, x__xgafv=None)

@@ -1785,17 +1785,17 @@

Method Details

- listCollectionIds_next(previous_request, previous_response) + listCollectionIds_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)
+        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.
-
+ 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. +
@@ -1885,31 +1885,31 @@

Method Details

- listDocuments_next(previous_request, previous_response) + listDocuments_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2667,17 +2667,17 @@

Method Details

- partitionQuery_next(previous_request, previous_response) + partitionQuery_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firestore_v1beta1.projects.databases.indexes.html b/docs/dyn/firestore_v1beta1.projects.databases.indexes.html index 3c0f390473..a75202eee7 100644 --- a/docs/dyn/firestore_v1beta1.projects.databases.indexes.html +++ b/docs/dyn/firestore_v1beta1.projects.databases.indexes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the indexes that match the specified filters.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/firestore_v1beta2.html b/docs/dyn/firestore_v1beta2.html index 59f982c431..0886e18519 100644 --- a/docs/dyn/firestore_v1beta2.html +++ b/docs/dyn/firestore_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.fields.html b/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.fields.html index ebcccd7d3f..61d1b78955 100644 --- a/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.fields.html +++ b/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.fields.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the field configuration and metadata for this database. Currently, FirestoreAdmin.ListFields only supports listing fields that have been explicitly overridden. To issue this query, call FirestoreAdmin.ListFields with the filter set to `indexConfig.usesAncestorConfig:false`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -180,17 +180,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.indexes.html b/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.indexes.html index 64b9dc2581..f1995e76ec 100644 --- a/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.indexes.html +++ b/docs/dyn/firestore_v1beta2.projects.databases.collectionGroups.indexes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists composite indexes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/fitness_v1.html b/docs/dyn/fitness_v1.html index 3cced9814d..41864b3bdb 100644 --- a/docs/dyn/fitness_v1.html +++ b/docs/dyn/fitness_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/fitness_v1.users.dataSources.dataPointChanges.html b/docs/dyn/fitness_v1.users.dataSources.dataPointChanges.html index 05b0d8cfca..3d012ba970 100644 --- a/docs/dyn/fitness_v1.users.dataSources.dataPointChanges.html +++ b/docs/dyn/fitness_v1.users.dataSources.dataPointChanges.html @@ -81,7 +81,7 @@

Instance Methods

list(userId, dataSourceId, limit=None, pageToken=None, x__xgafv=None)

Queries for user's data point changes for a particular data source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -165,17 +165,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/fitness_v1.users.dataSources.datasets.html b/docs/dyn/fitness_v1.users.dataSources.datasets.html index ca5e83afec..e8ab25ea14 100644 --- a/docs/dyn/fitness_v1.users.dataSources.datasets.html +++ b/docs/dyn/fitness_v1.users.dataSources.datasets.html @@ -84,13 +84,13 @@

Instance Methods

get(userId, dataSourceId, datasetId, limit=None, pageToken=None, x__xgafv=None)

Returns a dataset containing all data points whose start and end times overlap with the specified range of the dataset minimum start time and maximum end time. Specifically, any data point whose start time is less than or equal to the dataset end time and whose end time is greater than or equal to the dataset start time.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

patch(userId, dataSourceId, datasetId, body=None, x__xgafv=None)

Adds data points to a dataset. The dataset need not be previously created. All points within the given dataset will be returned with subsquent calls to retrieve this dataset. Data points can belong to more than one dataset. This method does not use patch semantics: the data points provided are merely inserted, with no existing data replaced.

- patch_next(previous_request, previous_response)

+ patch_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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. +
@@ -266,17 +266,17 @@

Method Details

- patch_next(previous_request, previous_response) + patch_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)
+        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.
-
+ 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/fitness_v1.users.sessions.html b/docs/dyn/fitness_v1.users.sessions.html index c8140025b1..d2d26bdf36 100644 --- a/docs/dyn/fitness_v1.users.sessions.html +++ b/docs/dyn/fitness_v1.users.sessions.html @@ -84,7 +84,7 @@

Instance Methods

list(userId, activityType=None, endTime=None, includeDeleted=None, pageToken=None, startTime=None, x__xgafv=None)

Lists sessions previously created.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(userId, sessionId, body=None, x__xgafv=None)

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/forms_v1.forms.responses.html b/docs/dyn/forms_v1.forms.responses.html index e483b2c426..2d4feadf70 100644 --- a/docs/dyn/forms_v1.forms.responses.html +++ b/docs/dyn/forms_v1.forms.responses.html @@ -84,7 +84,7 @@

Instance Methods

list(formId, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List a form's responses.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -230,17 +230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/forms_v1.html b/docs/dyn/forms_v1.html index d412b61b0d..afaec01fb0 100644 --- a/docs/dyn/forms_v1.html +++ b/docs/dyn/forms_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ftp_v1.html b/docs/dyn/ftp_v1.html index 6b4874bf46..c04c21737a 100644 --- a/docs/dyn/ftp_v1.html +++ b/docs/dyn/ftp_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ftp_v1.projects.locations.html b/docs/dyn/ftp_v1.projects.locations.html index d8fff75934..e58750e014 100644 --- a/docs/dyn/ftp_v1.projects.locations.html +++ b/docs/dyn/ftp_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ftp_v1.projects.locations.operations.html b/docs/dyn/ftp_v1.projects.locations.operations.html index 56f1710b8e..a70eca44e8 100644 --- a/docs/dyn/ftp_v1.projects.locations.operations.html +++ b/docs/dyn/ftp_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ftp_v1.projects.locations.servers.html b/docs/dyn/ftp_v1.projects.locations.servers.html index cd84b4c00e..99bca0d2c1 100644 --- a/docs/dyn/ftp_v1.projects.locations.servers.html +++ b/docs/dyn/ftp_v1.projects.locations.servers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Servers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -378,17 +378,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ftp_v1.projects.locations.servers.users.html b/docs/dyn/ftp_v1.projects.locations.servers.users.html index 9c3ae8e073..c1ae78061e 100644 --- a/docs/dyn/ftp_v1.projects.locations.servers.users.html +++ b/docs/dyn/ftp_v1.projects.locations.servers.users.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Users in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ftp_v1alpha.html b/docs/dyn/ftp_v1alpha.html index e2c9b06e03..b33f8fd052 100644 --- a/docs/dyn/ftp_v1alpha.html +++ b/docs/dyn/ftp_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ftp_v1alpha.projects.locations.html b/docs/dyn/ftp_v1alpha.projects.locations.html index 9beef565b8..37479e6e27 100644 --- a/docs/dyn/ftp_v1alpha.projects.locations.html +++ b/docs/dyn/ftp_v1alpha.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ftp_v1alpha.projects.locations.operations.html b/docs/dyn/ftp_v1alpha.projects.locations.operations.html index 48b5edc8a1..49005cbbe2 100644 --- a/docs/dyn/ftp_v1alpha.projects.locations.operations.html +++ b/docs/dyn/ftp_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ftp_v1alpha.projects.locations.servers.html b/docs/dyn/ftp_v1alpha.projects.locations.servers.html index d250a81d1c..1777b89e18 100644 --- a/docs/dyn/ftp_v1alpha.projects.locations.servers.html +++ b/docs/dyn/ftp_v1alpha.projects.locations.servers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Servers in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -378,17 +378,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ftp_v1alpha.projects.locations.servers.users.html b/docs/dyn/ftp_v1alpha.projects.locations.servers.users.html index a5fbce4af3..b26e76bb10 100644 --- a/docs/dyn/ftp_v1alpha.projects.locations.servers.users.html +++ b/docs/dyn/ftp_v1alpha.projects.locations.servers.users.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Users in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -311,17 +311,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gamesConfiguration_v1configuration.achievementConfigurations.html b/docs/dyn/gamesConfiguration_v1configuration.achievementConfigurations.html index 52c31f4eb3..855868c444 100644 --- a/docs/dyn/gamesConfiguration_v1configuration.achievementConfigurations.html +++ b/docs/dyn/gamesConfiguration_v1configuration.achievementConfigurations.html @@ -90,7 +90,7 @@

Instance Methods

list(applicationId, maxResults=None, pageToken=None, x__xgafv=None)

Returns a list of the achievement configurations in this application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(achievementId, body=None, x__xgafv=None)

@@ -415,17 +415,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gamesConfiguration_v1configuration.html b/docs/dyn/gamesConfiguration_v1configuration.html index 10f633d512..efecce3d3f 100644 --- a/docs/dyn/gamesConfiguration_v1configuration.html +++ b/docs/dyn/gamesConfiguration_v1configuration.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gamesConfiguration_v1configuration.leaderboardConfigurations.html b/docs/dyn/gamesConfiguration_v1configuration.leaderboardConfigurations.html index 1bade498cf..d952800f5f 100644 --- a/docs/dyn/gamesConfiguration_v1configuration.leaderboardConfigurations.html +++ b/docs/dyn/gamesConfiguration_v1configuration.leaderboardConfigurations.html @@ -90,7 +90,7 @@

Instance Methods

list(applicationId, maxResults=None, pageToken=None, x__xgafv=None)

Returns a list of the leaderboard configurations in this application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(leaderboardId, body=None, x__xgafv=None)

@@ -863,17 +863,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gamesManagement_v1management.applications.html b/docs/dyn/gamesManagement_v1management.applications.html index a31fba8a57..60f1246230 100644 --- a/docs/dyn/gamesManagement_v1management.applications.html +++ b/docs/dyn/gamesManagement_v1management.applications.html @@ -81,7 +81,7 @@

Instance Methods

listHidden(applicationId, maxResults=None, pageToken=None, x__xgafv=None)

Get the list of players hidden from the given application. This method is only available to user accounts for your developer console.

- listHidden_next(previous_request, previous_response)

+ listHidden_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- listHidden_next(previous_request, previous_response) + listHidden_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)
+        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.
-
+ 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/gamesManagement_v1management.html b/docs/dyn/gamesManagement_v1management.html index 17c3f92a51..db16836716 100644 --- a/docs/dyn/gamesManagement_v1management.html +++ b/docs/dyn/gamesManagement_v1management.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/games_v1.achievementDefinitions.html b/docs/dyn/games_v1.achievementDefinitions.html index 285a6c119a..304969082d 100644 --- a/docs/dyn/games_v1.achievementDefinitions.html +++ b/docs/dyn/games_v1.achievementDefinitions.html @@ -81,7 +81,7 @@

Instance Methods

list(language=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists all the achievement definitions for your application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -130,17 +130,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/games_v1.achievements.html b/docs/dyn/games_v1.achievements.html index 93e2e0155a..fcdf5b688d 100644 --- a/docs/dyn/games_v1.achievements.html +++ b/docs/dyn/games_v1.achievements.html @@ -84,7 +84,7 @@

Instance Methods

list(playerId, language=None, maxResults=None, pageToken=None, state=None, x__xgafv=None)

Lists the progress for all your application's achievements for the currently authenticated player.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reveal(achievementId, x__xgafv=None)

@@ -168,17 +168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/games_v1.events.html b/docs/dyn/games_v1.events.html index 8cfb0de6eb..453e99d83b 100644 --- a/docs/dyn/games_v1.events.html +++ b/docs/dyn/games_v1.events.html @@ -81,13 +81,13 @@

Instance Methods

listByPlayer(language=None, maxResults=None, pageToken=None, x__xgafv=None)

Returns a list showing the current progress on events in this application for the currently authenticated user.

- listByPlayer_next(previous_request, previous_response)

+ listByPlayer_next()

Retrieves the next page of results.

listDefinitions(language=None, maxResults=None, pageToken=None, x__xgafv=None)

Returns a list of the event definitions in this application.

- listDefinitions_next(previous_request, previous_response)

+ listDefinitions_next()

Retrieves the next page of results.

record(body=None, language=None, x__xgafv=None)

@@ -130,17 +130,17 @@

Method Details

- listByPlayer_next(previous_request, previous_response) + listByPlayer_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)
+        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.
-
+ 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. +
@@ -183,17 +183,17 @@

Method Details

- listDefinitions_next(previous_request, previous_response) + listDefinitions_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/games_v1.html b/docs/dyn/games_v1.html index 15f2755cdf..0e04e876a3 100644 --- a/docs/dyn/games_v1.html +++ b/docs/dyn/games_v1.html @@ -148,7 +148,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -157,20 +157,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/games_v1.leaderboards.html b/docs/dyn/games_v1.leaderboards.html index 4457c0a8ba..075b16acb5 100644 --- a/docs/dyn/games_v1.leaderboards.html +++ b/docs/dyn/games_v1.leaderboards.html @@ -84,7 +84,7 @@

Instance Methods

list(language=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists all the leaderboard metadata for your application.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/games_v1.metagame.html b/docs/dyn/games_v1.metagame.html index 990447f27f..877b1281b8 100644 --- a/docs/dyn/games_v1.metagame.html +++ b/docs/dyn/games_v1.metagame.html @@ -84,7 +84,7 @@

Instance Methods

listCategoriesByPlayer(playerId, collection, language=None, maxResults=None, pageToken=None, x__xgafv=None)

List play data aggregated per category for the player corresponding to `playerId`.

- listCategoriesByPlayer_next(previous_request, previous_response)

+ listCategoriesByPlayer_next()

Retrieves the next page of results.

Method Details

@@ -153,17 +153,17 @@

Method Details

- listCategoriesByPlayer_next(previous_request, previous_response) + listCategoriesByPlayer_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)
+        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.
-
+ 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/games_v1.players.html b/docs/dyn/games_v1.players.html index 8e9c16ee5b..cd91818eed 100644 --- a/docs/dyn/games_v1.players.html +++ b/docs/dyn/games_v1.players.html @@ -90,7 +90,7 @@

Instance Methods

list(collection, language=None, maxResults=None, pageToken=None, x__xgafv=None)

Get the collection of players for the currently authenticated user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/games_v1.scores.html b/docs/dyn/games_v1.scores.html index 7852e42017..513dc0a506 100644 --- a/docs/dyn/games_v1.scores.html +++ b/docs/dyn/games_v1.scores.html @@ -81,7 +81,7 @@

Instance Methods

get(playerId, leaderboardId, timeSpan, includeRankType=None, language=None, maxResults=None, pageToken=None, x__xgafv=None)

Get high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. `NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'.

- get_next(previous_request, previous_response)

+ get_next()

Retrieves the next page of results.

list(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, x__xgafv=None)

@@ -90,10 +90,10 @@

Instance Methods

listWindow(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, resultsAbove=None, returnTopIfAbsent=None, x__xgafv=None)

Lists the scores in a leaderboard around (and including) a player's score.

- listWindow_next(previous_request, previous_response)

+ listWindow_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

submit(leaderboardId, score, language=None, scoreTag=None, x__xgafv=None)

@@ -214,17 +214,17 @@

Method Details

- get_next(previous_request, previous_response) + get_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)
+        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.
-
+ 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. +
@@ -496,31 +496,31 @@

Method Details

- listWindow_next(previous_request, previous_response) + listWindow_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/games_v1.snapshots.html b/docs/dyn/games_v1.snapshots.html index f5f5ebf2a7..782c946d03 100644 --- a/docs/dyn/games_v1.snapshots.html +++ b/docs/dyn/games_v1.snapshots.html @@ -84,7 +84,7 @@

Instance Methods

list(playerId, language=None, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of snapshots created by your application for the player corresponding to the player ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -173,17 +173,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkebackup_v1.html b/docs/dyn/gkebackup_v1.html index f5e917afa9..aa5b8fe836 100644 --- a/docs/dyn/gkebackup_v1.html +++ b/docs/dyn/gkebackup_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupChannels.backupPlanBindings.html b/docs/dyn/gkebackup_v1.projects.locations.backupChannels.backupPlanBindings.html index abdad1d3cc..fcd3b16f2b 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupChannels.backupPlanBindings.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupChannels.backupPlanBindings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists BackupPlanBindings in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -221,17 +221,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkebackup_v1.projects.locations.backupChannels.html b/docs/dyn/gkebackup_v1.projects.locations.backupChannels.html index 94d4d591e9..26bf965c04 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupChannels.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupChannels.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists BackupChannels in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html index afbcf59c47..b452740c27 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the Backups for a given BackupPlan.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -512,17 +512,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.volumeBackups.html b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.volumeBackups.html index bcbd6a3dc5..fcce8368c3 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.volumeBackups.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.volumeBackups.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the VolumeBackups for a given Backup.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html index 7ede1533d5..d6402e7e50 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists BackupPlans in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -571,17 +571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.html b/docs/dyn/gkebackup_v1.projects.locations.html index 87a9e722a4..f7d5b79cf2 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.html +++ b/docs/dyn/gkebackup_v1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkebackup_v1.projects.locations.operations.html b/docs/dyn/gkebackup_v1.projects.locations.operations.html index ad9b892205..e3ff94c12f 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.operations.html +++ b/docs/dyn/gkebackup_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkebackup_v1.projects.locations.restoreChannels.html b/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.html index 453585f42c..35399cc1bf 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.html +++ b/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists RestoreChannels in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.restorePlanBindings.html b/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.restorePlanBindings.html index 35a8f4ea03..5608472262 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.restorePlanBindings.html +++ b/docs/dyn/gkebackup_v1.projects.locations.restoreChannels.restorePlanBindings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists RestorePlanBindings in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkebackup_v1.projects.locations.restorePlans.html b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.html index 62f64c8fe5..2bef837f87 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.restorePlans.html +++ b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists RestorePlans in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -668,17 +668,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.html b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.html index ea312ad6b1..6fd9e57196 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.html +++ b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Restores for a given RestorePlan.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -786,17 +786,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.volumeRestores.html b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.volumeRestores.html index 88abc25d2d..4a1e480c23 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.volumeRestores.html +++ b/docs/dyn/gkebackup_v1.projects.locations.restorePlans.restores.volumeRestores.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the VolumeRestores for a given Restore.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.html b/docs/dyn/gkehub_v1.html index 2e1099981b..6582e41d26 100644 --- a/docs/dyn/gkehub_v1.html +++ b/docs/dyn/gkehub_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v1.organizations.locations.fleets.html b/docs/dyn/gkehub_v1.organizations.locations.fleets.html index 1eb0868bfe..96752cf0e0 100644 --- a/docs/dyn/gkehub_v1.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1.organizations.locations.fleets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1.projects.locations.features.html b/docs/dyn/gkehub_v1.projects.locations.features.html index 0318e9ea1e..9e5baffc78 100644 --- a/docs/dyn/gkehub_v1.projects.locations.features.html +++ b/docs/dyn/gkehub_v1.projects.locations.features.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Features in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -3193,17 +3193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.fleets.html b/docs/dyn/gkehub_v1.projects.locations.fleets.html index d281d4e440..7a97a6a635 100644 --- a/docs/dyn/gkehub_v1.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1.projects.locations.fleets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.html b/docs/dyn/gkehub_v1.projects.locations.html index 8a8a6c9a11..0f52f2d1fc 100644 --- a/docs/dyn/gkehub_v1.projects.locations.html +++ b/docs/dyn/gkehub_v1.projects.locations.html @@ -119,7 +119,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1.projects.locations.memberships.bindings.html b/docs/dyn/gkehub_v1.projects.locations.memberships.bindings.html index fee6b7533e..bbbe845222 100644 --- a/docs/dyn/gkehub_v1.projects.locations.memberships.bindings.html +++ b/docs/dyn/gkehub_v1.projects.locations.memberships.bindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.memberships.html b/docs/dyn/gkehub_v1.projects.locations.memberships.html index 193341be98..d37f4346b3 100644 --- a/docs/dyn/gkehub_v1.projects.locations.memberships.html +++ b/docs/dyn/gkehub_v1.projects.locations.memberships.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -582,17 +582,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.memberships.rbacrolebindings.html b/docs/dyn/gkehub_v1.projects.locations.memberships.rbacrolebindings.html index d4c1ade866..455062fa59 100644 --- a/docs/dyn/gkehub_v1.projects.locations.memberships.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1.projects.locations.memberships.rbacrolebindings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Membership RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.operations.html b/docs/dyn/gkehub_v1.projects.locations.operations.html index 6b3dd3186d..7a1b6abac1 100644 --- a/docs/dyn/gkehub_v1.projects.locations.operations.html +++ b/docs/dyn/gkehub_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1.projects.locations.rolloutSequences.html b/docs/dyn/gkehub_v1.projects.locations.rolloutSequences.html index a8071903b2..3138e06c52 100644 --- a/docs/dyn/gkehub_v1.projects.locations.rolloutSequences.html +++ b/docs/dyn/gkehub_v1.projects.locations.rolloutSequences.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollout sequences.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.rollouts.html b/docs/dyn/gkehub_v1.projects.locations.rollouts.html index 50dfbebce8..0bb875810c 100644 --- a/docs/dyn/gkehub_v1.projects.locations.rollouts.html +++ b/docs/dyn/gkehub_v1.projects.locations.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollouts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.scopes.html b/docs/dyn/gkehub_v1.projects.locations.scopes.html index 04ad518602..e7125e29e7 100644 --- a/docs/dyn/gkehub_v1.projects.locations.scopes.html +++ b/docs/dyn/gkehub_v1.projects.locations.scopes.html @@ -106,16 +106,16 @@

Instance Methods

listMemberships(scopeName, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships bound to a Scope. The response includes relevant Memberships from all regions.

- listMemberships_next(previous_request, previous_response)

+ listMemberships_next()

Retrieves the next page of results.

listPermitted(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists permitted Scopes.

- listPermitted_next(previous_request, previous_response)

+ listPermitted_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- listMemberships_next(previous_request, previous_response) + listMemberships_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)
+        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.
-
+ 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. +
@@ -508,31 +508,31 @@

Method Details

- listPermitted_next(previous_request, previous_response) + listPermitted_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.scopes.namespaces.html b/docs/dyn/gkehub_v1.projects.locations.scopes.namespaces.html index 5954ca5297..2acad5fc31 100644 --- a/docs/dyn/gkehub_v1.projects.locations.scopes.namespaces.html +++ b/docs/dyn/gkehub_v1.projects.locations.scopes.namespaces.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists fleet namespaces.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1.projects.locations.scopes.rbacrolebindings.html b/docs/dyn/gkehub_v1.projects.locations.scopes.rbacrolebindings.html index 2ad08dc490..f360f9d7f8 100644 --- a/docs/dyn/gkehub_v1.projects.locations.scopes.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1.projects.locations.scopes.rbacrolebindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Scope RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.html b/docs/dyn/gkehub_v1alpha.html index eef8699fba..9acca57bc7 100644 --- a/docs/dyn/gkehub_v1alpha.html +++ b/docs/dyn/gkehub_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html b/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html index 7e01cd77dc..0b1fc48496 100644 --- a/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1alpha.projects.locations.features.html b/docs/dyn/gkehub_v1alpha.projects.locations.features.html index 360432fe3c..8d16aeadac 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.features.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.features.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Features in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -3637,17 +3637,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html b/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html index 10349b5bba..bce60dff66 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.html b/docs/dyn/gkehub_v1alpha.projects.locations.html index 8ed05dd17d..3f3cd01519 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.html @@ -119,7 +119,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1alpha.projects.locations.memberships.bindings.html b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.bindings.html index 2e04e18f45..768e4387c9 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.bindings.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.bindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html index bd4d17d31b..4d150659c5 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html @@ -112,10 +112,10 @@

Instance Methods

listAdmin(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships of admin clusters in a given project and location. **This method is only used internally**.

- listAdmin_next(previous_request, previous_response)

+ listAdmin_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -732,31 +732,31 @@

Method Details

- listAdmin_next(previous_request, previous_response) + listAdmin_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.rbacrolebindings.html b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.rbacrolebindings.html index 67e2a882fe..9442e3dc9c 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.rbacrolebindings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Membership RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.operations.html b/docs/dyn/gkehub_v1alpha.projects.locations.operations.html index 102b4a5b99..d57543a658 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.operations.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1alpha.projects.locations.rolloutSequences.html b/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html index 8df0234d88..056e8e63bf 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollout sequences.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html b/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html index 38ed9d5ec7..97c9d40cf4 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollouts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.html b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.html index 819cb77c23..4206e1eef4 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.html @@ -106,16 +106,16 @@

Instance Methods

listMemberships(scopeName, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships bound to a Scope. The response includes relevant Memberships from all regions.

- listMemberships_next(previous_request, previous_response)

+ listMemberships_next()

Retrieves the next page of results.

listPermitted(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists permitted Scopes.

- listPermitted_next(previous_request, previous_response)

+ listPermitted_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- listMemberships_next(previous_request, previous_response) + listMemberships_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)
+        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.
-
+ 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. +
@@ -508,31 +508,31 @@

Method Details

- listPermitted_next(previous_request, previous_response) + listPermitted_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.namespaces.html b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.namespaces.html index ea4846bc95..db97c5f330 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.namespaces.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.namespaces.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists fleet namespaces.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.rbacrolebindings.html b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.rbacrolebindings.html index 87e6c47146..fef41cb4fb 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.scopes.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.scopes.rbacrolebindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Scope RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.html b/docs/dyn/gkehub_v1beta.html index d7dc49420b..79a6ecce12 100644 --- a/docs/dyn/gkehub_v1beta.html +++ b/docs/dyn/gkehub_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html b/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html index d1be82f8fd..197fd9afe3 100644 --- a/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1beta.projects.locations.features.html b/docs/dyn/gkehub_v1beta.projects.locations.features.html index c2f07bde95..a47e82cb38 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.features.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.features.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Features in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -3265,17 +3265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.fleets.html b/docs/dyn/gkehub_v1beta.projects.locations.fleets.html index 9b9ba80bf8..c0cf63d1fa 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.fleets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all fleets within an organization or a project that the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.html b/docs/dyn/gkehub_v1beta.projects.locations.html index 3edc92cb70..1fabfb91e9 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.html @@ -119,7 +119,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1beta.projects.locations.memberships.bindings.html b/docs/dyn/gkehub_v1beta.projects.locations.memberships.bindings.html index 9147f79648..b631c40a50 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.memberships.bindings.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.memberships.bindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.memberships.html b/docs/dyn/gkehub_v1beta.projects.locations.memberships.html index 6857b1d8e6..6977cc96db 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.memberships.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.memberships.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -582,17 +582,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.memberships.rbacrolebindings.html b/docs/dyn/gkehub_v1beta.projects.locations.memberships.rbacrolebindings.html index 553dc78be9..a96a08677f 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.memberships.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.memberships.rbacrolebindings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Membership RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.operations.html b/docs/dyn/gkehub_v1beta.projects.locations.operations.html index e7145bcad8..3f85727cf6 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.operations.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1beta.projects.locations.rolloutSequences.html b/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html index bea275756d..902493029f 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollout sequences.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html b/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html index 2342d4e554..dc9b6b2a27 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the list of all rollouts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.scopes.html b/docs/dyn/gkehub_v1beta.projects.locations.scopes.html index 7b8fef3775..b89898d24d 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.scopes.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.scopes.html @@ -106,16 +106,16 @@

Instance Methods

listMemberships(scopeName, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships bound to a Scope. The response includes relevant Memberships from all regions.

- listMemberships_next(previous_request, previous_response)

+ listMemberships_next()

Retrieves the next page of results.

listPermitted(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists permitted Scopes.

- listPermitted_next(previous_request, previous_response)

+ listPermitted_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -455,17 +455,17 @@

Method Details

- listMemberships_next(previous_request, previous_response) + listMemberships_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)
+        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.
-
+ 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. +
@@ -508,31 +508,31 @@

Method Details

- listPermitted_next(previous_request, previous_response) + listPermitted_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.scopes.namespaces.html b/docs/dyn/gkehub_v1beta.projects.locations.scopes.namespaces.html index 21d28ed851..90d3de53fc 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.scopes.namespaces.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.scopes.namespaces.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists fleet namespaces.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.scopes.rbacrolebindings.html b/docs/dyn/gkehub_v1beta.projects.locations.scopes.rbacrolebindings.html index 5bc6dc4c4b..22d3528455 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.scopes.rbacrolebindings.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.scopes.rbacrolebindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Scope RBACRoleBindings.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta1.html b/docs/dyn/gkehub_v1beta1.html index 0160232043..793abd8ec9 100644 --- a/docs/dyn/gkehub_v1beta1.html +++ b/docs/dyn/gkehub_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v1beta1.projects.locations.html b/docs/dyn/gkehub_v1beta1.projects.locations.html index 8ada8c1e1f..5a44689e47 100644 --- a/docs/dyn/gkehub_v1beta1.projects.locations.html +++ b/docs/dyn/gkehub_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v1beta1.projects.locations.memberships.html b/docs/dyn/gkehub_v1beta1.projects.locations.memberships.html index 055082e964..9ee8e1a42a 100644 --- a/docs/dyn/gkehub_v1beta1.projects.locations.memberships.html +++ b/docs/dyn/gkehub_v1beta1.projects.locations.memberships.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Memberships in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -604,17 +604,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v1beta1.projects.locations.operations.html b/docs/dyn/gkehub_v1beta1.projects.locations.operations.html index 5be946b94e..9d2d48139e 100644 --- a/docs/dyn/gkehub_v1beta1.projects.locations.operations.html +++ b/docs/dyn/gkehub_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2.html b/docs/dyn/gkehub_v2.html index ce0764f0e8..939ccdc160 100644 --- a/docs/dyn/gkehub_v2.html +++ b/docs/dyn/gkehub_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v2.projects.locations.html b/docs/dyn/gkehub_v2.projects.locations.html index 5a3d12b093..49bf2317a7 100644 --- a/docs/dyn/gkehub_v2.projects.locations.html +++ b/docs/dyn/gkehub_v2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2.projects.locations.memberships.features.html index b529e0a19f..bbac5fcaa6 100644 --- a/docs/dyn/gkehub_v2.projects.locations.memberships.features.html +++ b/docs/dyn/gkehub_v2.projects.locations.memberships.features.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipFeatures in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2101,17 +2101,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v2.projects.locations.operations.html b/docs/dyn/gkehub_v2.projects.locations.operations.html index 6353989b14..edb0d3fd79 100644 --- a/docs/dyn/gkehub_v2.projects.locations.operations.html +++ b/docs/dyn/gkehub_v2.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2alpha.html b/docs/dyn/gkehub_v2alpha.html index bc21240e26..3a0936d753 100644 --- a/docs/dyn/gkehub_v2alpha.html +++ b/docs/dyn/gkehub_v2alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v2alpha.projects.locations.html b/docs/dyn/gkehub_v2alpha.projects.locations.html index 997d3623b5..63b44c8a32 100644 --- a/docs/dyn/gkehub_v2alpha.projects.locations.html +++ b/docs/dyn/gkehub_v2alpha.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2alpha.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html index 0b3e8c128a..93b61f619d 100644 --- a/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html +++ b/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipFeatures in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2101,17 +2101,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v2alpha.projects.locations.operations.html b/docs/dyn/gkehub_v2alpha.projects.locations.operations.html index 6bad8b16f2..06e2c449fa 100644 --- a/docs/dyn/gkehub_v2alpha.projects.locations.operations.html +++ b/docs/dyn/gkehub_v2alpha.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2beta.html b/docs/dyn/gkehub_v2beta.html index 5ccfe20c4c..040ccbbeda 100644 --- a/docs/dyn/gkehub_v2beta.html +++ b/docs/dyn/gkehub_v2beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkehub_v2beta.projects.locations.html b/docs/dyn/gkehub_v2beta.projects.locations.html index 437c332d1e..6443dc81d3 100644 --- a/docs/dyn/gkehub_v2beta.projects.locations.html +++ b/docs/dyn/gkehub_v2beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkehub_v2beta.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html index 104ed543f3..fa09b020ce 100644 --- a/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html +++ b/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists MembershipFeatures in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2101,17 +2101,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkehub_v2beta.projects.locations.operations.html b/docs/dyn/gkehub_v2beta.projects.locations.operations.html index b0b0a6b067..0f02f2ece0 100644 --- a/docs/dyn/gkehub_v2beta.projects.locations.operations.html +++ b/docs/dyn/gkehub_v2beta.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.html b/docs/dyn/gkeonprem_v1.html index 2d75622405..956c008aad 100644 --- a/docs/dyn/gkeonprem_v1.html +++ b/docs/dyn/gkeonprem_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.html index 60966b4150..f0dc839109 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, allowMissing=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists bare metal admin clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -986,17 +986,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.operations.html index 760262234c..4e1f0266e4 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalAdminClusters.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.html index ef58205e91..a6b8a410e4 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists bare metal node pools in a given project, location and bare metal cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, allowMissing=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -533,17 +533,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.operations.html index f3e6942765..2da4d3f29c 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.bareMetalNodePools.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.bareMetalClusters.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.html index 0e35bfde3d..a64ee0a300 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, allowMissing=None, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists bare metal clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, allowMissing=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1193,17 +1193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.operations.html index 7fb0592670..3d95f7efe1 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.bareMetalClusters.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.html b/docs/dyn/gkeonprem_v1.projects.locations.html index f4bb8a2780..53761b05ee 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.operations.html index aad34fd7d0..b238ebd450 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.vmwareAdminClusters.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.html index a95132693a..13afded892 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, allowMissing=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists VMware admin clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, skipValidations=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1029,17 +1029,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.operations.html index cee80cd3ad..9439e27d35 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareAdminClusters.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.vmwareClusters.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.html index 684009f13b..715a5f674e 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, allowMissing=None, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists VMware Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, skipValidations=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.operations.html index 710de5b89a..47ff7a67c5 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.html index 854dba2dd4..1c355225ea 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists VMware node pools in a given project, location and VMWare cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -544,17 +544,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.operations.html b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.operations.html index 5527944be0..aa3e9669af 100644 --- a/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.operations.html +++ b/docs/dyn/gkeonprem_v1.projects.locations.vmwareClusters.vmwareNodePools.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmail_v1.html b/docs/dyn/gmail_v1.html index f52c50112c..e0eb9e54bc 100644 --- a/docs/dyn/gmail_v1.html +++ b/docs/dyn/gmail_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gmail_v1.users.drafts.html b/docs/dyn/gmail_v1.users.drafts.html index e10b8c61bc..3be74a5aa2 100644 --- a/docs/dyn/gmail_v1.users.drafts.html +++ b/docs/dyn/gmail_v1.users.drafts.html @@ -90,7 +90,7 @@

Instance Methods

list(userId, includeSpamTrash=None, maxResults=None, pageToken=None, q=None, x__xgafv=None)

Lists the drafts in the user's mailbox. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

send(userId, body=None, media_body=None, media_mime_type=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmail_v1.users.history.html b/docs/dyn/gmail_v1.users.history.html index 36f1dedbfb..249018fd6f 100644 --- a/docs/dyn/gmail_v1.users.history.html +++ b/docs/dyn/gmail_v1.users.history.html @@ -81,7 +81,7 @@

Instance Methods

list(userId, historyTypes=None, labelId=None, maxResults=None, pageToken=None, startHistoryId=None, x__xgafv=None)

Lists the history of all changes to the given mailbox. History results are returned in chronological order (increasing `historyId`). For more information, see [Synchronize clients with Gmail](https://developers.google.com/workspace/gmail/api/guides/sync).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -359,17 +359,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmail_v1.users.messages.html b/docs/dyn/gmail_v1.users.messages.html index b0ff323212..cc885653d8 100644 --- a/docs/dyn/gmail_v1.users.messages.html +++ b/docs/dyn/gmail_v1.users.messages.html @@ -104,7 +104,7 @@

Instance Methods

list(userId, includeSpamTrash=None, labelIds=None, maxResults=None, pageToken=None, q=None, x__xgafv=None)

Lists the messages in the user's mailbox. For more information, see [List Gmail messages](https://developers.google.com/workspace/gmail/api/guides/list-messages).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modify(userId, id, body=None, x__xgafv=None)

@@ -562,17 +562,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmail_v1.users.settings.cse.identities.html b/docs/dyn/gmail_v1.users.settings.cse.identities.html index 006f06210a..c94416a51f 100644 --- a/docs/dyn/gmail_v1.users.settings.cse.identities.html +++ b/docs/dyn/gmail_v1.users.settings.cse.identities.html @@ -90,7 +90,7 @@

Instance Methods

list(userId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the client-side encrypted identities for an authenticated user. For administrators managing identities and keypairs for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.settings.basic` scope. For users managing their own identities and keypairs, requests require [hardware key encryption](https://support.google.com/a/answer/14153163) turned on and configured.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(userId, emailAddress, body=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmail_v1.users.settings.cse.keypairs.html b/docs/dyn/gmail_v1.users.settings.cse.keypairs.html index f5a2c61fd2..efe981c81a 100644 --- a/docs/dyn/gmail_v1.users.settings.cse.keypairs.html +++ b/docs/dyn/gmail_v1.users.settings.cse.keypairs.html @@ -93,7 +93,7 @@

Instance Methods

list(userId, pageSize=None, pageToken=None, x__xgafv=None)

Lists client-side encryption key pairs for an authenticated user. For administrators managing identities and keypairs for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.settings.basic` scope. For users managing their own identities and keypairs, requests require [hardware key encryption](https://support.google.com/a/answer/14153163) turned on and configured.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

obliterate(userId, keyPairId, body=None, x__xgafv=None)

@@ -347,17 +347,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmail_v1.users.threads.html b/docs/dyn/gmail_v1.users.threads.html index a440e09710..34ba87017c 100644 --- a/docs/dyn/gmail_v1.users.threads.html +++ b/docs/dyn/gmail_v1.users.threads.html @@ -87,7 +87,7 @@

Instance Methods

list(userId, includeSpamTrash=None, labelIds=None, maxResults=None, pageToken=None, q=None, x__xgafv=None)

Lists the threads in the user's mailbox. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modify(userId, id, body=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmailpostmastertools_v1.domains.html b/docs/dyn/gmailpostmastertools_v1.domains.html index 448ec5c89e..f8851465eb 100644 --- a/docs/dyn/gmailpostmastertools_v1.domains.html +++ b/docs/dyn/gmailpostmastertools_v1.domains.html @@ -89,7 +89,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains that have been registered by the client. The order of domains in the response is unspecified and non-deterministic. Newly created domains will not necessarily be added to the end of this list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmailpostmastertools_v1.domains.trafficStats.html b/docs/dyn/gmailpostmastertools_v1.domains.trafficStats.html index 761e85ed44..2944b87e1d 100644 --- a/docs/dyn/gmailpostmastertools_v1.domains.trafficStats.html +++ b/docs/dyn/gmailpostmastertools_v1.domains.trafficStats.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)

List traffic statistics for all available days. Returns PERMISSION_DENIED if user does not have permission to access TrafficStats for the domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmailpostmastertools_v1.html b/docs/dyn/gmailpostmastertools_v1.html index a9670557e6..a096a57793 100644 --- a/docs/dyn/gmailpostmastertools_v1.html +++ b/docs/dyn/gmailpostmastertools_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gmailpostmastertools_v1beta1.domains.html b/docs/dyn/gmailpostmastertools_v1beta1.domains.html index cee7aa463d..06ef24b991 100644 --- a/docs/dyn/gmailpostmastertools_v1beta1.domains.html +++ b/docs/dyn/gmailpostmastertools_v1beta1.domains.html @@ -89,7 +89,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists the domains that have been registered by the client. The order of domains in the response is unspecified and non-deterministic. Newly created domains will not necessarily be added to the end of this list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmailpostmastertools_v1beta1.domains.trafficStats.html b/docs/dyn/gmailpostmastertools_v1beta1.domains.trafficStats.html index 90bb2003ac..adaa4b9a7c 100644 --- a/docs/dyn/gmailpostmastertools_v1beta1.domains.trafficStats.html +++ b/docs/dyn/gmailpostmastertools_v1beta1.domains.trafficStats.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)

List traffic statistics for all available days. Returns PERMISSION_DENIED if user does not have permission to access TrafficStats for the domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/gmailpostmastertools_v1beta1.html b/docs/dyn/gmailpostmastertools_v1beta1.html index a39f2cc6dc..5e6155c6c9 100644 --- a/docs/dyn/gmailpostmastertools_v1beta1.html +++ b/docs/dyn/gmailpostmastertools_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/gmailpostmastertools_v2.domains.domainStats.html b/docs/dyn/gmailpostmastertools_v2.domains.domainStats.html index ca9cbca4dd..ae579ab906 100644 --- a/docs/dyn/gmailpostmastertools_v2.domains.domainStats.html +++ b/docs/dyn/gmailpostmastertools_v2.domains.domainStats.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, body=None, x__xgafv=None)

Retrieves a list of domain statistics for a given domain and time period. Returns statistics only for dates where data is available. Returns PERMISSION_DENIED if you don't have permission to access DomainStats for the domain.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -177,17 +177,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/gmailpostmastertools_v2.domains.html b/docs/dyn/gmailpostmastertools_v2.domains.html index 31318b021f..ec324b48ce 100644 --- a/docs/dyn/gmailpostmastertools_v2.domains.html +++ b/docs/dyn/gmailpostmastertools_v2.domains.html @@ -106,7 +106,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of all domains registered by you, along with their corresponding metadata. The order of domains in the response is unspecified and non-deterministic. Newly registered domains will not necessarily be added to the end of this list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

verify(name, body=None, x__xgafv=None)

@@ -320,17 +320,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmailpostmastertools_v2.domains.users.html b/docs/dyn/gmailpostmastertools_v2.domains.users.html index 3a1fa820a6..f2cbfbbacf 100644 --- a/docs/dyn/gmailpostmastertools_v2.domains.users.html +++ b/docs/dyn/gmailpostmastertools_v2.domains.users.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

[Developer Preview](https://developers.google.com/workspace/preview): Lists the users that have access to a domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/gmailpostmastertools_v2.html b/docs/dyn/gmailpostmastertools_v2.html index bd03eebd7b..f5777c9181 100644 --- a/docs/dyn/gmailpostmastertools_v2.html +++ b/docs/dyn/gmailpostmastertools_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/groupsmigration_v1.html b/docs/dyn/groupsmigration_v1.html index 74266052cb..a55623b508 100644 --- a/docs/dyn/groupsmigration_v1.html +++ b/docs/dyn/groupsmigration_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/groupssettings_v1.html b/docs/dyn/groupssettings_v1.html index 88ee837276..0fa2af5228 100644 --- a/docs/dyn/groupssettings_v1.html +++ b/docs/dyn/groupssettings_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/health_v4.html b/docs/dyn/health_v4.html index 8be556beff..71842e7582 100644 --- a/docs/dyn/health_v4.html +++ b/docs/dyn/health_v4.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/health_v4.projects.subscribers.html b/docs/dyn/health_v4.projects.subscribers.html index 891b6162a6..bcb30d0f7d 100644 --- a/docs/dyn/health_v4.projects.subscribers.html +++ b/docs/dyn/health_v4.projects.subscribers.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all subscribers registered within the owned Google Cloud Project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/health_v4.projects.subscribers.subscriptions.html b/docs/dyn/health_v4.projects.subscribers.subscriptions.html index f14835a7e1..c70b91cd2d 100644 --- a/docs/dyn/health_v4.projects.subscribers.subscriptions.html +++ b/docs/dyn/health_v4.projects.subscribers.subscriptions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all active subscriptions for a given subscriber. This can be filtered, for example, by user or data type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -182,17 +182,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/health_v4.users.dataTypes.dataPoints.html b/docs/dyn/health_v4.users.dataTypes.dataPoints.html index 0ecc9adafe..d1486ab9fc 100644 --- a/docs/dyn/health_v4.users.dataTypes.dataPoints.html +++ b/docs/dyn/health_v4.users.dataTypes.dataPoints.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Query user health and fitness data points.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -108,13 +108,13 @@

Instance Methods

reconcile(parent, dataSourceFamily=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Reconcile data points from multiple data sources into a single data stream.

- reconcile_next(previous_request, previous_response)

+ reconcile_next()

Retrieves the next page of results.

rollUp(parent, body=None, x__xgafv=None)

Roll up data points over physical time intervals for supported data types.

- rollUp_next(previous_request, previous_response)

+ rollUp_next()

Retrieves the next page of results.

Method Details

@@ -209,7 +209,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -323,7 +323,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -393,7 +393,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -418,7 +418,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -457,7 +457,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -485,15 +485,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -532,7 +532,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -582,7 +582,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -780,7 +780,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -827,19 +827,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -848,7 +848,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -863,11 +863,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -876,7 +876,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -904,7 +904,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -925,7 +925,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -946,7 +946,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -1141,11 +1141,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -1187,7 +1187,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -1198,11 +1198,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -1227,7 +1227,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1286,7 +1286,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1429,7 +1429,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1575,7 +1575,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -1596,7 +1596,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, } @@ -1639,7 +1639,7 @@

Method Details

The object takes the form of: { # Request to roll up data points by civil time intervals. - "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. "pageSize": 42, # Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. "pageToken": "A String", # Optional. The `next_page_token` from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified. "range": { # Counterpart of google.type.Interval, but using CivilDateTime. # Required. Closed-open range of data points that will be rolled up. The start time must be aligned with the aggregation window. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days. @@ -1927,7 +1927,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -2041,7 +2041,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2111,7 +2111,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -2136,7 +2136,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2175,7 +2175,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -2203,15 +2203,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -2250,7 +2250,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -2300,7 +2300,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -2498,7 +2498,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2545,19 +2545,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -2566,7 +2566,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2581,11 +2581,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2594,7 +2594,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -2622,7 +2622,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2643,7 +2643,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2664,7 +2664,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -2859,11 +2859,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -2905,7 +2905,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2916,11 +2916,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2945,7 +2945,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3004,7 +3004,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3147,7 +3147,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3293,7 +3293,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -3314,7 +3314,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }
@@ -3372,7 +3372,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -3486,7 +3486,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3556,7 +3556,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -3581,7 +3581,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3620,7 +3620,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -3648,15 +3648,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -3695,7 +3695,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -3745,7 +3745,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -3943,7 +3943,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3990,19 +3990,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -4011,7 +4011,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4026,11 +4026,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4039,7 +4039,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -4067,7 +4067,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4088,7 +4088,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4109,7 +4109,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -4304,11 +4304,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -4350,7 +4350,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4361,11 +4361,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4390,7 +4390,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4449,7 +4449,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4592,7 +4592,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4738,7 +4738,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -4759,7 +4759,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }, ], @@ -4768,17 +4768,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -4824,7 +4824,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -4938,7 +4938,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5008,7 +5008,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -5033,7 +5033,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5072,7 +5072,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -5100,15 +5100,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -5147,7 +5147,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -5197,7 +5197,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -5395,7 +5395,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5442,19 +5442,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -5463,7 +5463,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5478,11 +5478,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5491,7 +5491,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -5519,7 +5519,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5540,7 +5540,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5561,7 +5561,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -5756,11 +5756,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -5802,7 +5802,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5813,11 +5813,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5842,7 +5842,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5901,7 +5901,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6044,7 +6044,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6190,7 +6190,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -6211,7 +6211,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, } @@ -6250,7 +6250,7 @@

Method Details

Args: parent: string, Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. (required) - dataSourceFamily: string, Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + dataSourceFamily: string, Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. filter: string, Optional. Filter expression based on https://aip.dev/160. A time range, either physical or civil, can be specified. See the ListDataPointsRequest.filter for the supported fields and syntax. pageSize: integer, Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. For `exercise` and `sleep` the default page size is 25. The maximum page size for `exercise` and `sleep` is 25. pageToken: string, Optional. The `next_page_token` from a previous request, if any. @@ -6298,7 +6298,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -6412,7 +6412,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6482,7 +6482,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -6507,7 +6507,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6546,7 +6546,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -6574,15 +6574,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -6621,7 +6621,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataPointName": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. @@ -6658,7 +6658,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "exercise": { # An exercise that stores information about a physical activity. # Data for points in the `exercise` session data type collection. "activeDuration": "A String", # Optional. Duration excluding pauses. @@ -6807,7 +6807,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6842,7 +6842,7 @@

Method Details

}, }, "heartRate": { # A heart rate measurement. # Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -6870,7 +6870,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6891,7 +6891,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6912,7 +6912,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -6950,11 +6950,11 @@

Method Details

}, "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -6996,7 +6996,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -7007,16 +7007,16 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7075,7 +7075,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7218,7 +7218,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7342,7 +7342,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -7363,7 +7363,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }, ], @@ -7372,17 +7372,17 @@

Method Details

- reconcile_next(previous_request, previous_response) + reconcile_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)
+        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.
-
+ 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. +
@@ -7395,7 +7395,7 @@

Method Details

The object takes the form of: { # Request to roll up data points by physical time intervals. - "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. "pageSize": 42, # Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. "pageToken": "A String", # Optional. The next_page_token from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified. "range": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. Closed-open range of data points that will be rolled up. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days. @@ -7543,17 +7543,17 @@

Method Details

- rollUp_next(previous_request, previous_response) + rollUp_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)
+        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.
-
+ 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/health_v4.users.html b/docs/dyn/health_v4.users.html index eb74ef474e..80e6fbe844 100644 --- a/docs/dyn/health_v4.users.html +++ b/docs/dyn/health_v4.users.html @@ -177,7 +177,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. + "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` } @@ -204,7 +204,7 @@

Method Details

"glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings. "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings. "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported. - "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. + "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported. "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported. "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings. @@ -221,7 +221,7 @@

Method Details

Updates the user's profile details.
 
 Args:
-  name: string, Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. (required)
+  name: string, Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -234,7 +234,7 @@ 
Method Details

     "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
     "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
   },
-  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
   "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
 }
@@ -257,7 +257,7 @@ 
Method Details

     "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
     "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
   },
-  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
   "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
 }
@@ -268,7 +268,7 @@

Method Details

Updates the user's settings details.
 
 Args:
-  name: string, Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. (required)
+  name: string, Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -279,7 +279,7 @@ 
Method Details

   "glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported.
-  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported.
   "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported.
   "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
@@ -306,7 +306,7 @@ 
Method Details

   "glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported.
-  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported.
   "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported.
   "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
diff --git a/docs/dyn/health_v4.users.pairedDevices.html b/docs/dyn/health_v4.users.pairedDevices.html
index 5b3c4c444d..edebdda7cd 100644
--- a/docs/dyn/health_v4.users.pairedDevices.html
+++ b/docs/dyn/health_v4.users.pairedDevices.html
@@ -84,7 +84,7 @@ 
Instance Methods

   list(parent, pageSize=None, pageToken=None, x__xgafv=None)

 
Returns the user's list of paired 1P trackers and smartwatches.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 
Method Details

 

@@ -156,17 +156,17 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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/health_v4beta.html b/docs/dyn/health_v4beta.html index ed55503d1e..946a345b91 100644 --- a/docs/dyn/health_v4beta.html +++ b/docs/dyn/health_v4beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/health_v4beta.projects.subscribers.html b/docs/dyn/health_v4beta.projects.subscribers.html index 4058b3431f..35c0200749 100644 --- a/docs/dyn/health_v4beta.projects.subscribers.html +++ b/docs/dyn/health_v4beta.projects.subscribers.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all subscribers registered within the owned Google Cloud Project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -238,17 +238,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/health_v4beta.projects.subscribers.subscriptions.html b/docs/dyn/health_v4beta.projects.subscribers.subscriptions.html index 9a54d6f3ab..aff889f545 100644 --- a/docs/dyn/health_v4beta.projects.subscribers.subscriptions.html +++ b/docs/dyn/health_v4beta.projects.subscribers.subscriptions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all active subscriptions for a given subscriber. This can be filtered, for example, by user or data type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -182,17 +182,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html b/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html index 3f3606ca86..8a2f6a9084 100644 --- a/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html +++ b/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Query user health and fitness data points.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -108,13 +108,13 @@

Instance Methods

reconcile(parent, dataSourceFamily=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Reconcile data points from multiple data sources into a single data stream.

- reconcile_next(previous_request, previous_response)

+ reconcile_next()

Retrieves the next page of results.

rollUp(parent, body=None, x__xgafv=None)

Roll up data points over physical time intervals for supported data types.

- rollUp_next(previous_request, previous_response)

+ rollUp_next()

Retrieves the next page of results.

Method Details

@@ -209,7 +209,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -323,7 +323,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -393,7 +393,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -418,7 +418,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -457,7 +457,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -485,15 +485,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -532,7 +532,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -582,7 +582,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -780,7 +780,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -827,19 +827,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -848,7 +848,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -863,11 +863,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -876,7 +876,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -904,7 +904,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -925,7 +925,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -946,7 +946,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -1141,11 +1141,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -1187,7 +1187,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -1198,11 +1198,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -1227,7 +1227,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1286,7 +1286,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1429,7 +1429,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -1575,7 +1575,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -1596,7 +1596,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, } @@ -1639,7 +1639,7 @@

Method Details

The object takes the form of: { # Request to roll up data points by civil time intervals. - "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. "pageSize": 42, # Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. "pageToken": "A String", # Optional. The `next_page_token` from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified. "range": { # Counterpart of google.type.Interval, but using CivilDateTime. # Required. Closed-open range of data points that will be rolled up. The start time must be aligned with the aggregation window. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days. @@ -1927,7 +1927,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -2041,7 +2041,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2111,7 +2111,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -2136,7 +2136,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2175,7 +2175,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -2203,15 +2203,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -2250,7 +2250,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -2300,7 +2300,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -2498,7 +2498,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2545,19 +2545,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -2566,7 +2566,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2581,11 +2581,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2594,7 +2594,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -2622,7 +2622,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2643,7 +2643,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -2664,7 +2664,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -2859,11 +2859,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -2905,7 +2905,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2916,11 +2916,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -2945,7 +2945,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3004,7 +3004,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3147,7 +3147,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3293,7 +3293,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -3314,7 +3314,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }
@@ -3372,7 +3372,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -3486,7 +3486,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3556,7 +3556,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -3581,7 +3581,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3620,7 +3620,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -3648,15 +3648,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -3695,7 +3695,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -3745,7 +3745,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -3943,7 +3943,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -3990,19 +3990,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -4011,7 +4011,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4026,11 +4026,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4039,7 +4039,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -4067,7 +4067,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4088,7 +4088,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4109,7 +4109,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -4304,11 +4304,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -4350,7 +4350,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4361,11 +4361,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -4390,7 +4390,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4449,7 +4449,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4592,7 +4592,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -4738,7 +4738,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -4759,7 +4759,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }, ], @@ -4768,17 +4768,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -4824,7 +4824,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Optional. Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -4938,7 +4938,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Optional. Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5008,7 +5008,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Optional. Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -5033,7 +5033,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Optional. Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5072,7 +5072,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Optional. Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -5100,15 +5100,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Optional. Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Optional. Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -5147,7 +5147,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataSource": { # Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it). # Optional. Data source information for the metric @@ -5197,7 +5197,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "electrocardiogram": { # Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review. # Optional. Data for points in the `electrocardiogram` session data type collection. "beatsPerMinuteAvg": "A String", # Optional. Average heart rate recorded during ECG reading in beats per minute. @@ -5395,7 +5395,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Optional. Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5442,19 +5442,19 @@

Method Details

"description": "A String", # Optional. The description of the food. "displayName": "A String", # Required. The display name of the food. "energyAvg": { # Represents the energy quantity. # Optional. Value representing the average energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. Value representing the energy from fat of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMax": { # Represents the energy quantity. # Optional. Value representing the maximum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyMin": { # Represents the energy quantity. # Optional. Value representing the minimum energy of the food for the default serving. - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "languageCode": "A String", # Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code. @@ -5463,7 +5463,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5478,11 +5478,11 @@

Method Details

}, ], "totalCarbohydrate": { # Represents the weight quantity. # Optional. Value representing the total carbohydrate of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. Value representing the total fat of the food for the default serving. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5491,7 +5491,7 @@

Method Details

"pluralDisplayName": "A String", # Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). }, "heartRate": { # A heart rate measurement. # Optional. Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -5519,7 +5519,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5540,7 +5540,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Optional. Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5561,7 +5561,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Optional. Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -5756,11 +5756,11 @@

Method Details

"name": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Optional. Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -5802,7 +5802,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5813,11 +5813,11 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -5842,7 +5842,7 @@

Method Details

}, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Optional. Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -5901,7 +5901,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Optional. Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6044,7 +6044,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Optional. Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6190,7 +6190,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Optional. Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -6211,7 +6211,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, } @@ -6250,7 +6250,7 @@

Method Details

Args: parent: string, Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. (required) - dataSourceFamily: string, Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + dataSourceFamily: string, Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. filter: string, Optional. Filter expression based on https://aip.dev/160. A time range, either physical or civil, can be specified. See the ListDataPointsRequest.filter for the supported fields and syntax. pageSize: integer, Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. For `exercise` and `sleep` the default page size is 25. The maximum page size for `exercise` and `sleep` is 25. pageToken: string, Optional. The `next_page_token` from a previous request, if any. @@ -6298,7 +6298,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. + "kcal": 3.14, # Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`. }, "activeMinutes": { # Record of active minutes in a given time interval. # Data for points in the `active-minutes` interval data type collection. "activeMinutesByActivityLevel": [ # Required. Active minutes by activity level. At most one record per activity level is allowed. @@ -6412,7 +6412,7 @@

Method Details

}, }, "altitude": { # Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters. # Data for points in the `altitude` interval data type collection. - "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. + "gainMillimeters": "A String", # Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6482,7 +6482,7 @@

Method Details

"kcal": 3.14, # Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval. }, "bloodGlucose": { # Represents a blood glucose level measurement. LINT: LEGACY_NAMES # Data for points in the `blood-glucose` sample data type collection. - "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. + "bloodGlucoseMilligramsPerDeciliter": 3.14, # Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`. "mealType": "A String", # Optional. Meal type of the measurement. "measurementSource": "A String", # Optional. Source of the measurement. "measurementTiming": "A String", # Optional. Timing of the measurement. @@ -6507,7 +6507,7 @@

Method Details

"specimen": "A String", # Optional. Type of body fluid used to measure the blood glucose. }, "bodyFat": { # Body fat measurement. # Data for points in the `body-fat` sample data type collection. - "percentage": 3.14, # Required. Body fat percentage, in range [0, 100]. + "percentage": 3.14, # Required. Body fat percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which body fat was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6546,7 +6546,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. + "temperatureCelsius": 3.14, # Required. The core body temperature in Celsius. Must be in the range `[0, 100]`. }, "dailyHeartRateVariability": { # Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds` # Data for points in the `daily-heart-rate-variability` daily data type collection. "averageHeartRateVariabilityMilliseconds": 3.14, # Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats. @@ -6574,15 +6574,15 @@

Method Details

], }, "dailyOxygenSaturation": { # A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep. # Data for points in the `daily-oxygen-saturation` daily data type collection. - "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. + "averagePercentage": 3.14, # Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Date (in user's timezone) of the daily oxygen saturation record. "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. + "lowerBoundPercentage": 3.14, # Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. "standardDeviationPercentage": 3.14, # Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days. - "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. + "upperBoundPercentage": 3.14, # Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`. }, "dailyRespiratoryRate": { # A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep. # Data for points in the `daily-respiratory-rate` daily data type collection. "breathsPerMinute": 3.14, # Required. The average number of breaths taken per minute. @@ -6621,7 +6621,7 @@

Method Details

"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, "estimated": True or False, # Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation. - "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. "vo2MaxCovariance": 3.14, # Optional. The covariance of the VO2 max value. }, "dataPointName": "A String", # Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. @@ -6658,7 +6658,7 @@

Method Details

"startTime": "A String", # Required. Observed interval start time. "startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, - "millimeters": "A String", # Required. Distance in millimeters over the observed interval. + "millimeters": "A String", # Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`. }, "exercise": { # An exercise that stores information about a physical activity. # Data for points in the `exercise` session data type collection. "activeDuration": "A String", # Optional. Duration excluding pauses. @@ -6807,7 +6807,7 @@

Method Details

"updateTime": "A String", # Output only. This is the timestamp of the last update to the exercise. }, "floors": { # Gained elevation measured in floors over the time interval # Data for points in the `floors` interval data type collection. - "count": "A String", # Required. Number of floors in the recorded interval + "count": "A String", # Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6842,7 +6842,7 @@

Method Details

}, }, "heartRate": { # A heart rate measurement. # Data for points in the `heart-rate` sample data type collection. - "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. + "beatsPerMinute": "A String", # Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`. "metadata": { # Heart rate metadata. # Optional. Metadata about the heart rate sample. "motionContext": "A String", # Optional. Indicates the user’s level of activity when the heart rate sample was measured "sensorLocation": "A String", # Optional. Indicates the location of the sensor that measured the heart rate. @@ -6870,7 +6870,7 @@

Method Details

"highFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz). "lowFrequencyPower": 3.14, # Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz). }, - "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. + "rootMeanSquareOfSuccessiveDifferencesMilliseconds": 3.14, # Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time of the heart rate variability measurement. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6891,7 +6891,7 @@

Method Details

"standardDeviationMilliseconds": 3.14, # Optional. The standard deviation of the heart rate variability measurement. }, "height": { # Body height measurement. # Data for points in the `height` sample data type collection. - "heightMillimeters": "A String", # Required. Height of the user in millimeters. + "heightMillimeters": "A String", # Required. Height of the user in millimeters. Must be in the range `[0, 3000]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the height was recorded. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -6912,7 +6912,7 @@

Method Details

}, "hydrationLog": { # Holds information about a user logged hydration. # Data for points in the `hydration-log` session data type collection. "amountConsumed": { # Represents the volume quantity. # Required. Amount of liquid (ex. water) consumed. - "milliliters": 3.14, # Required. Value representing the volume in milliliters. + "milliliters": 3.14, # Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters. }, "interval": { # Represents a time interval of session data point, which bundles multiple observed metrics together. # Required. Observed interval. @@ -6950,11 +6950,11 @@

Method Details

}, "nutritionLog": { # Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable. # Data for points in the `nutrition-log` session data type collection. "energy": { # Represents the energy quantity. # Optional. The total energy of the food, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "energyFromFat": { # Represents the energy quantity. # Optional. The energy from fat, measured in kilocalories (`kcal`). - "kcal": 3.14, # Required. The energy value in kilocalories. + "kcal": 3.14, # Required. The energy value in kilocalories. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "food": "A String", # Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead. @@ -6996,7 +6996,7 @@

Method Details

{ # Represents the quantity of a nutrient. "nutrient": "A String", # Required. The nutrient type. "quantity": { # Represents the weight quantity. # Required. The quantity of the nutrient, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, @@ -7007,16 +7007,16 @@

Method Details

"foodMeasurementUnitDisplayName": "A String", # Output only. Legacy measurement unit for serving size in singular form (e.g. "piece", "gram"). }, "totalCarbohydrate": { # Represents the weight quantity. # Optional. The total carbohydrate content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, "totalFat": { # Represents the weight quantity. # Optional. The total fat content, measured in grams. - "grams": 3.14, # Required. The weight value in grams. + "grams": 3.14, # Required. The weight value in grams. Must be in the range `[0, 100000]`. "userProvidedUnit": "A String", # Optional. Value representing the user provided unit. }, }, "oxygenSaturation": { # Captures the user's instantaneous oxygen saturation percentage (SpO2). # Data for points in the `oxygen-saturation` sample data type collection. - "percentage": 3.14, # Required. The oxygen saturation percentage. Valid values are from 0 to 100. + "percentage": 3.14, # Required. The oxygen saturation percentage. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which oxygen saturation was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7075,7 +7075,7 @@

Method Details

}, }, "runVo2Max": { # VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min. # Data for points in the `run-vo2-max` sample data type collection. - "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. + "runVo2Max": 3.14, # Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`. "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which the metric was measured. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7218,7 +7218,7 @@

Method Details

"updateTime": "A String", # Output only. Last update time of this sleep observation. }, "steps": { # Step count over the time interval. # Data for points in the `steps` interval data type collection. - "count": "A String", # Required. Number of steps in the recorded interval. + "count": "A String", # Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`. "interval": { # Represents a time interval of an observed data point. # Required. Observed interval. "civilEndTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Calendar date. @@ -7342,7 +7342,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. + "vo2Max": 3.14, # Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`. }, "weight": { # Body weight measurement. # Data for points in the `weight` sample data type collection. "notes": "A String", # Optional. Standard free-form notes captured at manual logging. @@ -7363,7 +7363,7 @@

Method Details

"physicalTime": "A String", # Required. The time of the observation. "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). }, - "weightGrams": 3.14, # Required. Weight of a user in grams. + "weightGrams": 3.14, # Required. Weight of a user in grams. Must be in the range `[0, 1000000]`. }, }, ], @@ -7372,17 +7372,17 @@

Method Details

- reconcile_next(previous_request, previous_response) + reconcile_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)
+        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.
-
+ 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. +
@@ -7395,7 +7395,7 @@

Method Details

The object takes the form of: { # Request to roll up data points by physical time intervals. - "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. + "dataSourceFamily": "A String", # Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. "pageSize": 42, # Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. "pageToken": "A String", # Optional. The next_page_token from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified. "range": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. Closed-open range of data points that will be rolled up. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days. @@ -7543,17 +7543,17 @@

Method Details

- rollUp_next(previous_request, previous_response) + rollUp_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)
+        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.
-
+ 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/health_v4beta.users.html b/docs/dyn/health_v4beta.users.html index 81182898c4..59a4927492 100644 --- a/docs/dyn/health_v4beta.users.html +++ b/docs/dyn/health_v4beta.users.html @@ -177,7 +177,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. + "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` } @@ -204,7 +204,7 @@

Method Details

"glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings. "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings. "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported. - "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. + "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported. "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported. "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings. @@ -221,7 +221,7 @@

Method Details

Updates the user's profile details.
 
 Args:
-  name: string, Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. (required)
+  name: string, Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -234,7 +234,7 @@ 
Method Details

     "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
     "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
   },
-  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
   "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
 }
@@ -257,7 +257,7 @@ 
Method Details

     "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
     "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
   },
-  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "userConfiguredRunningStrideLengthMm": 42, # Optional. The user's user configured running stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
   "userConfiguredWalkingStrideLengthMm": 42, # Optional. The user's user configured walking stride length, in millimeters. The user must consent to the following access scope to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`
 }
@@ -268,7 +268,7 @@

Method Details

Updates the user's settings details.
 
 Args:
-  name: string, Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. (required)
+  name: string, Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -279,7 +279,7 @@ 
Method Details

   "glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported.
-  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported.
   "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported.
   "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
@@ -306,7 +306,7 @@ 
Method Details

   "glucoseUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "heightUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
   "languageLocale": "A String", # Optional. The locale defined in the user's account settings. Updates to this field are currently not supported.
-  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.
+  "name": "A String", # Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.
   "strideLengthRunningType": "A String", # Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported.
   "strideLengthWalkingType": "A String", # Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported.
   "swimUnit": "A String", # Optional. The measurement unit defined in the user's account settings.
diff --git a/docs/dyn/health_v4beta.users.pairedDevices.html b/docs/dyn/health_v4beta.users.pairedDevices.html
index 05c991fb36..c8a07265c8 100644
--- a/docs/dyn/health_v4beta.users.pairedDevices.html
+++ b/docs/dyn/health_v4beta.users.pairedDevices.html
@@ -84,7 +84,7 @@ 
Instance Methods

   list(parent, pageSize=None, pageToken=None, x__xgafv=None)

 
Returns the user's list of paired 1P trackers and smartwatches.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 
Method Details

 

@@ -156,17 +156,17 @@ 
Method Details

 

 
 

-    list_next(previous_request, previous_response)
+    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)
+        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.
-

+        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/healthcare_v1.html b/docs/dyn/healthcare_v1.html index 72531cc280..b6ce141f16 100644 --- a/docs/dyn/healthcare_v1.html +++ b/docs/dyn/healthcare_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.attributeDefinitions.html b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.attributeDefinitions.html index dc4b3cff28..4f3658ca93 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.attributeDefinitions.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.attributeDefinitions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Attribute definitions in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consentArtifacts.html b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consentArtifacts.html index 7a569ee174..5319c1627e 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consentArtifacts.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consentArtifacts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Consent artifacts in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -365,17 +365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/healthcare_v1.projects.locations.datasets.consentStores.consents.html b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consents.html index 1866619475..74dd968665 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consents.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.consents.html @@ -99,10 +99,10 @@

Instance Methods

listRevisions(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the revisions of the specified Consent in reverse chronological order.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -451,31 +451,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.html index 0ad2222a42..c0110d086c 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.html @@ -110,7 +110,7 @@

Instance Methods

evaluateUserConsents(consentStore, body=None, x__xgafv=None)

Evaluates the user's Consents for all matching User data mappings. Note: User data mappings are indexed asynchronously, which can cause a slight delay between the time mappings are created or updated and when they are included in EvaluateUserConsents results.

- evaluateUserConsents_next(previous_request, previous_response)

+ evaluateUserConsents_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the consent stores in the specified dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -289,17 +289,17 @@

Method Details

- evaluateUserConsents_next(previous_request, previous_response) + evaluateUserConsents_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)
+        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.
-
+ 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. +
@@ -407,17 +407,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.userDataMappings.html b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.userDataMappings.html index 7d1076ba86..a63446a0a4 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.userDataMappings.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.consentStores.userDataMappings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the User data mappings in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html index 29ad710c05..4f4ec8307e 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html @@ -115,7 +115,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the DICOM stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -658,17 +658,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html index bb3adea0ab..5b56e11c27 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html @@ -130,7 +130,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the FHIR stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1440,17 +1440,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.html index 2ab17262f1..830fac2a6a 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the HL7v2 stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -681,17 +681,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.messages.html b/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.messages.html index 215fca10cb..69fe69d8ea 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.messages.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.hl7V2Stores.messages.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all the messages in the given HL7v2 store with support for filtering. Note: HL7v2 messages are indexed asynchronously, so there might be a slight delay between the time a message is created and when it can be found through a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.html b/docs/dyn/healthcare_v1.projects.locations.datasets.html index 022e7e4a82..78e8e9fa9a 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.html @@ -126,7 +126,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the health datasets in the current project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -451,17 +451,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.operations.html b/docs/dyn/healthcare_v1.projects.locations.datasets.operations.html index 65ef0d29f8..ce38a0e58d 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.operations.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/healthcare_v1.projects.locations.html b/docs/dyn/healthcare_v1.projects.locations.html index 07369218c9..c490a3af78 100644 --- a/docs/dyn/healthcare_v1.projects.locations.html +++ b/docs/dyn/healthcare_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/healthcare_v1beta1.html b/docs/dyn/healthcare_v1beta1.html index 16a04a47ad..658f2bec50 100644 --- a/docs/dyn/healthcare_v1beta1.html +++ b/docs/dyn/healthcare_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.attributeDefinitions.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.attributeDefinitions.html index 6405bf5890..df743163fc 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.attributeDefinitions.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.attributeDefinitions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Attribute definitions in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consentArtifacts.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consentArtifacts.html index 8af467a4c3..3a73d17fc6 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consentArtifacts.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consentArtifacts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Consent artifacts in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -365,17 +365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/healthcare_v1beta1.projects.locations.datasets.consentStores.consents.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consents.html index da96125600..20fd7e0d21 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consents.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.consents.html @@ -99,10 +99,10 @@

Instance Methods

listRevisions(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the revisions of the specified Consent in reverse chronological order.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -451,31 +451,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.html index 420fcdaa53..6ed4a277f1 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.html @@ -110,7 +110,7 @@

Instance Methods

evaluateUserConsents(consentStore, body=None, x__xgafv=None)

Evaluates the user's Consents for all matching User data mappings. Note: User data mappings are indexed asynchronously, which can cause a slight delay between the time mappings are created or updated and when they are included in EvaluateUserConsents results.

- evaluateUserConsents_next(previous_request, previous_response)

+ evaluateUserConsents_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the consent stores in the specified dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -289,17 +289,17 @@

Method Details

- evaluateUserConsents_next(previous_request, previous_response) + evaluateUserConsents_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)
+        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.
-
+ 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. +
@@ -407,17 +407,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.userDataMappings.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.userDataMappings.html index 8fcd131633..08500de8ee 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.userDataMappings.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.consentStores.userDataMappings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the User data mappings in the specified consent store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html index 92e80ad4c4..035165033e 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html @@ -115,7 +115,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the DICOM stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -799,17 +799,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html index 7578a5b407..63c4311412 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html @@ -142,7 +142,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the FHIR stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2323,17 +2323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.html index b34d8c0bf0..84396f0818 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the HL7v2 stores in the given dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -697,17 +697,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.messages.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.messages.html index bfb80464a2..06033faa31 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.messages.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.hl7V2Stores.messages.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all the messages in the given HL7v2 store with support for filtering. Note: HL7v2 messages are indexed asynchronously, so there might be a slight delay between the time a message is created and when it can be found through a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -483,17 +483,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.html index 1a6d46da2c..b934752f20 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.html @@ -126,7 +126,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the health datasets in the current project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -579,17 +579,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.operations.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.operations.html index 786d3ddc83..569895685f 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.operations.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/healthcare_v1beta1.projects.locations.html b/docs/dyn/healthcare_v1beta1.projects.locations.html index a6d7a91fbb..a1770fa17f 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/homegraph_v1.html b/docs/dyn/homegraph_v1.html index 4b65ec936e..d4aafbcd92 100644 --- a/docs/dyn/homegraph_v1.html +++ b/docs/dyn/homegraph_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/hypercomputecluster_v1.html b/docs/dyn/hypercomputecluster_v1.html index 9fd12ce143..3b85f2f88a 100644 --- a/docs/dyn/hypercomputecluster_v1.html +++ b/docs/dyn/hypercomputecluster_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/hypercomputecluster_v1.projects.locations.clusters.html b/docs/dyn/hypercomputecluster_v1.projects.locations.clusters.html index ad53775123..c48a1d43f2 100644 --- a/docs/dyn/hypercomputecluster_v1.projects.locations.clusters.html +++ b/docs/dyn/hypercomputecluster_v1.projects.locations.clusters.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -748,17 +748,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/hypercomputecluster_v1.projects.locations.html b/docs/dyn/hypercomputecluster_v1.projects.locations.html index b83b7069a7..07eb13eee5 100644 --- a/docs/dyn/hypercomputecluster_v1.projects.locations.html +++ b/docs/dyn/hypercomputecluster_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/hypercomputecluster_v1.projects.locations.operations.html b/docs/dyn/hypercomputecluster_v1.projects.locations.operations.html index 1b606c0ad7..3170fec279 100644 --- a/docs/dyn/hypercomputecluster_v1.projects.locations.operations.html +++ b/docs/dyn/hypercomputecluster_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/iam_v1.html b/docs/dyn/iam_v1.html index c070ca71f9..9450f4da5c 100644 --- a/docs/dyn/iam_v1.html +++ b/docs/dyn/iam_v1.html @@ -108,7 +108,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -117,20 +117,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/iam_v1.locations.workforcePools.html b/docs/dyn/iam_v1.locations.workforcePools.html index ed1f8a329c..0f35e4ca5e 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.html +++ b/docs/dyn/iam_v1.locations.workforcePools.html @@ -108,7 +108,7 @@

Instance Methods

list(location, pageSize=None, pageToken=None, parent=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkforcePools under the specified parent. If `show_deleted` is set to `true`, then deleted pools are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -355,17 +355,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.html b/docs/dyn/iam_v1.locations.workforcePools.providers.html index be9101c028..4a1146a5a4 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.providers.html +++ b/docs/dyn/iam_v1.locations.workforcePools.providers.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkforcePoolProviders in a WorkforcePool. If `show_deleted` is set to `true`, then deleted providers are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -424,17 +424,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.keys.html b/docs/dyn/iam_v1.locations.workforcePools.providers.keys.html index 99c6330fde..b82c3c16e1 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.providers.keys.html +++ b/docs/dyn/iam_v1.locations.workforcePools.providers.keys.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkforcePoolProviderKeys in a WorkforcePoolProvider. If `show_deleted` is set to `true`, then deleted keys are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

undelete(name, body=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html index 1de90e20ad..16bd2ce13c 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html +++ b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Gemini Enterprise only. Lists all non-deleted WorkforcePoolProviderScimTenants in a WorkforcePoolProvider. If `show_deleted` is set to `true`, then deleted SCIM tenants are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html index 0d8c2d58bb..fdd262f632 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html +++ b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Gemini Enterprise only. Lists all non-deleted WorkforcePoolProviderScimTokenss in a WorkforcePoolProviderScimTenant. If `show_deleted` is set to `true`, then deleted SCIM tokens are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.organizations.roles.html b/docs/dyn/iam_v1.organizations.roles.html index 3bfe8fd105..add143c038 100644 --- a/docs/dyn/iam_v1.organizations.roles.html +++ b/docs/dyn/iam_v1.organizations.roles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, view=None, x__xgafv=None)

Lists every predefined Role that IAM supports, or every custom role that is defined for an organization or project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.permissions.html b/docs/dyn/iam_v1.permissions.html index 27cf472f7a..537084f68a 100644 --- a/docs/dyn/iam_v1.permissions.html +++ b/docs/dyn/iam_v1.permissions.html @@ -81,7 +81,7 @@

Instance Methods

queryTestablePermissions(body=None, x__xgafv=None)

Lists every permission that you can test on a resource. A permission is testable if you can check whether a principal has that permission on the resource.

- queryTestablePermissions_next(previous_request, previous_response)

+ queryTestablePermissions_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- queryTestablePermissions_next(previous_request, previous_response) + queryTestablePermissions_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)
+        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.
-
+ 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/iam_v1.projects.locations.oauthClients.html b/docs/dyn/iam_v1.projects.locations.oauthClients.html index 0514789a25..d9394f4ade 100644 --- a/docs/dyn/iam_v1.projects.locations.oauthClients.html +++ b/docs/dyn/iam_v1.projects.locations.oauthClients.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted OauthClients in a project. If `show_deleted` is set to `true`, then deleted OauthClients are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.html index 7485d0eb0a..051eb00eca 100644 --- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.html +++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.html @@ -114,10 +114,10 @@

Instance Methods

listAttestationRules(resource, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all AttestationRule on a WorkloadIdentityPoolManagedIdentity.

- listAttestationRules_next(previous_request, previous_response)

+ listAttestationRules_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -208,7 +208,7 @@

Method Details

"keyAlgorithm": "A String", # Optional. Key algorithm to use when generating the key pair. This key pair will be used to create the certificate. If not specified, this will default to ECDSA_P256. "lifetime": "A String", # Optional. Lifetime of the workload certificates issued by the CA pool. Must be between 24 hours and 30 days. If not specified, this will be defaulted to 24 hours. "rotationWindowPercentage": 42, # Optional. Rotation window percentage, the percentage of remaining lifetime after which certificate rotation is initiated. Must be between 50 and 80. If no value is specified, rotation window percentage is defaulted to 50. - "useDefaultSharedCa": True or False, # Optional. If set to true, the trust domain will utilize the GCP-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. + "useDefaultSharedCa": True or False, # Optional. Determines whether the trust domain utilizes the Google Cloud-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. }, "inlineTrustConfig": { # Defines configuration for extending trust to additional trust domains. By establishing trust with another domain, the current domain will recognize and accept certificates issued by entities within the trusted domains. Note that a trust domain automatically trusts itself, eliminating the need for explicit configuration. # Optional. Represents config to add additional trusted trust domains. "additionalTrustBundles": { # Optional. Maps specific trust domains (e.g., "example.com") to their corresponding TrustStore, which contain the trusted root certificates for that domain. There can be a maximum of 10 trust domain entries in this map. Note that a trust domain automatically trusts itself and don't need to be specified here. If however, this WorkloadIdentityPool's trust domain contains any trust anchors in the additional_trust_bundles map, those trust anchors will be *appended to* the trust bundle automatically derived from your InlineCertificateIssuanceConfig's ca_pools. @@ -223,7 +223,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, }, @@ -323,7 +323,7 @@

Method Details

"keyAlgorithm": "A String", # Optional. Key algorithm to use when generating the key pair. This key pair will be used to create the certificate. If not specified, this will default to ECDSA_P256. "lifetime": "A String", # Optional. Lifetime of the workload certificates issued by the CA pool. Must be between 24 hours and 30 days. If not specified, this will be defaulted to 24 hours. "rotationWindowPercentage": 42, # Optional. Rotation window percentage, the percentage of remaining lifetime after which certificate rotation is initiated. Must be between 50 and 80. If no value is specified, rotation window percentage is defaulted to 50. - "useDefaultSharedCa": True or False, # Optional. If set to true, the trust domain will utilize the GCP-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. + "useDefaultSharedCa": True or False, # Optional. Determines whether the trust domain utilizes the Google Cloud-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. }, "inlineTrustConfig": { # Defines configuration for extending trust to additional trust domains. By establishing trust with another domain, the current domain will recognize and accept certificates issued by entities within the trusted domains. Note that a trust domain automatically trusts itself, eliminating the need for explicit configuration. # Optional. Represents config to add additional trusted trust domains. "additionalTrustBundles": { # Optional. Maps specific trust domains (e.g., "example.com") to their corresponding TrustStore, which contain the trusted root certificates for that domain. There can be a maximum of 10 trust domain entries in this map. Note that a trust domain automatically trusts itself and don't need to be specified here. If however, this WorkloadIdentityPool's trust domain contains any trust anchors in the additional_trust_bundles map, those trust anchors will be *appended to* the trust bundle automatically derived from your InlineCertificateIssuanceConfig's ca_pools. @@ -338,7 +338,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, }, @@ -436,7 +436,7 @@

Method Details

"keyAlgorithm": "A String", # Optional. Key algorithm to use when generating the key pair. This key pair will be used to create the certificate. If not specified, this will default to ECDSA_P256. "lifetime": "A String", # Optional. Lifetime of the workload certificates issued by the CA pool. Must be between 24 hours and 30 days. If not specified, this will be defaulted to 24 hours. "rotationWindowPercentage": 42, # Optional. Rotation window percentage, the percentage of remaining lifetime after which certificate rotation is initiated. Must be between 50 and 80. If no value is specified, rotation window percentage is defaulted to 50. - "useDefaultSharedCa": True or False, # Optional. If set to true, the trust domain will utilize the GCP-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. + "useDefaultSharedCa": True or False, # Optional. Determines whether the trust domain utilizes the Google Cloud-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. }, "inlineTrustConfig": { # Defines configuration for extending trust to additional trust domains. By establishing trust with another domain, the current domain will recognize and accept certificates issued by entities within the trusted domains. Note that a trust domain automatically trusts itself, eliminating the need for explicit configuration. # Optional. Represents config to add additional trusted trust domains. "additionalTrustBundles": { # Optional. Maps specific trust domains (e.g., "example.com") to their corresponding TrustStore, which contain the trusted root certificates for that domain. There can be a maximum of 10 trust domain entries in this map. Note that a trust domain automatically trusts itself and don't need to be specified here. If however, this WorkloadIdentityPool's trust domain contains any trust anchors in the additional_trust_bundles map, those trust anchors will be *appended to* the trust bundle automatically derived from your InlineCertificateIssuanceConfig's ca_pools. @@ -451,7 +451,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, }, @@ -491,31 +491,31 @@

Method Details

- listAttestationRules_next(previous_request, previous_response) + listAttestationRules_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -539,7 +539,7 @@

Method Details

"keyAlgorithm": "A String", # Optional. Key algorithm to use when generating the key pair. This key pair will be used to create the certificate. If not specified, this will default to ECDSA_P256. "lifetime": "A String", # Optional. Lifetime of the workload certificates issued by the CA pool. Must be between 24 hours and 30 days. If not specified, this will be defaulted to 24 hours. "rotationWindowPercentage": 42, # Optional. Rotation window percentage, the percentage of remaining lifetime after which certificate rotation is initiated. Must be between 50 and 80. If no value is specified, rotation window percentage is defaulted to 50. - "useDefaultSharedCa": True or False, # Optional. If set to true, the trust domain will utilize the GCP-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. + "useDefaultSharedCa": True or False, # Optional. Determines whether the trust domain utilizes the Google Cloud-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates. }, "inlineTrustConfig": { # Defines configuration for extending trust to additional trust domains. By establishing trust with another domain, the current domain will recognize and accept certificates issued by entities within the trusted domains. Note that a trust domain automatically trusts itself, eliminating the need for explicit configuration. # Optional. Represents config to add additional trusted trust domains. "additionalTrustBundles": { # Optional. Maps specific trust domains (e.g., "example.com") to their corresponding TrustStore, which contain the trusted root certificates for that domain. There can be a maximum of 10 trust domain entries in this map. Note that a trust domain automatically trusts itself and don't need to be specified here. If however, this WorkloadIdentityPool's trust domain contains any trust anchors in the additional_trust_bundles map, those trust anchors will be *appended to* the trust bundle automatically derived from your InlineCertificateIssuanceConfig's ca_pools. @@ -554,7 +554,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, }, diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.html index bb63c90b22..2b5661a98e 100644 --- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.html +++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkloadIdentityPoolNamespaces in a workload identity pool. If `show_deleted` is set to `true`, then deleted namespaces are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.managedIdentities.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.managedIdentities.html index 15ca6f3bb6..420a5249e9 100644 --- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.managedIdentities.html +++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.namespaces.managedIdentities.html @@ -106,10 +106,10 @@

Instance Methods

listAttestationRules(resource, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all AttestationRule on a WorkloadIdentityPoolManagedIdentity.

- listAttestationRules_next(previous_request, previous_response)

+ listAttestationRules_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -337,31 +337,31 @@

Method Details

- listAttestationRules_next(previous_request, previous_response) + listAttestationRules_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html index 3d52f29a11..362411a1b6 100644 --- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html +++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkloadIdentityPoolProviders in a WorkloadIdentityPool. If `show_deleted` is set to `true`, then deleted providers are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -124,7 +124,7 @@

Method Details

The object takes the form of: { # A configuration for an external identity provider. - "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credential are accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` + "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ``` "a_key": "A String", }, @@ -159,7 +159,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, } @@ -244,7 +244,7 @@

Method Details

An object of the form: { # A configuration for an external identity provider. - "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credential are accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` + "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ``` "a_key": "A String", }, @@ -279,7 +279,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, } @@ -306,7 +306,7 @@

Method Details

"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. "workloadIdentityPoolProviders": [ # A list of providers. { # A configuration for an external identity provider. - "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credential are accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` + "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ``` "a_key": "A String", }, @@ -341,7 +341,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, }, @@ -350,17 +350,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -373,7 +373,7 @@

Method Details

The object takes the form of: { # A configuration for an external identity provider. - "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credential are accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` + "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ``` "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ``` "a_key": "A String", }, @@ -408,7 +408,7 @@

Method Details

"pemCertificate": "A String", # PEM certificate of the PKI used for validation. Must only contain one ca certificate (either root or intermediate cert). }, ], - "trustDefaultSharedCa": True or False, # Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. + "trustDefaultSharedCa": True or False, # Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource. }, }, } diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.keys.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.keys.html index 29c45d4d93..106b8b87aa 100644 --- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.keys.html +++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.keys.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists all non-deleted WorkloadIdentityPoolProviderKeys in a project. If show_deleted is set to `true`, then deleted pools are also listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

undelete(name, body=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.projects.roles.html b/docs/dyn/iam_v1.projects.roles.html index fdcb685059..960ed63a90 100644 --- a/docs/dyn/iam_v1.projects.roles.html +++ b/docs/dyn/iam_v1.projects.roles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, view=None, x__xgafv=None)

Lists every predefined Role that IAM supports, or every custom role that is defined for an organization or project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.projects.serviceAccounts.html b/docs/dyn/iam_v1.projects.serviceAccounts.html index f7a547c542..6110a55e1f 100644 --- a/docs/dyn/iam_v1.projects.serviceAccounts.html +++ b/docs/dyn/iam_v1.projects.serviceAccounts.html @@ -104,7 +104,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists every ServiceAccount that belongs to a specific project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -354,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v1.roles.html b/docs/dyn/iam_v1.roles.html index 7508171563..267f340910 100644 --- a/docs/dyn/iam_v1.roles.html +++ b/docs/dyn/iam_v1.roles.html @@ -84,13 +84,13 @@

Instance Methods

list(pageSize=None, pageToken=None, parent=None, showDeleted=None, view=None, x__xgafv=None)

Lists every predefined Role that IAM supports, or every custom role that is defined for an organization or project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

queryGrantableRoles(body=None, x__xgafv=None)

Lists roles that can be granted on a Google Cloud resource. A role is grantable if the IAM policy for the resource can contain bindings to the role.

- queryGrantableRoles_next(previous_request, previous_response)

+ queryGrantableRoles_next()

Retrieves the next page of results.

Method Details

@@ -165,17 +165,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -220,17 +220,17 @@

Method Details

- queryGrantableRoles_next(previous_request, previous_response) + queryGrantableRoles_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)
+        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.
-
+ 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/iam_v2.html b/docs/dyn/iam_v2.html index 520afc98d1..609f7ff8ed 100644 --- a/docs/dyn/iam_v2.html +++ b/docs/dyn/iam_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/iam_v2.policies.html b/docs/dyn/iam_v2.policies.html index eca100aa9b..b129f1099d 100644 --- a/docs/dyn/iam_v2.policies.html +++ b/docs/dyn/iam_v2.policies.html @@ -95,7 +95,7 @@

Instance Methods

listPolicies(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the policies of the specified kind that are attached to a resource. The response lists only policy metadata. In particular, policy rules are omitted.

- listPolicies_next(previous_request, previous_response)

+ listPolicies_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -336,17 +336,17 @@

Method Details

- listPolicies_next(previous_request, previous_response) + listPolicies_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iam_v2beta.html b/docs/dyn/iam_v2beta.html index d6c13cdb66..b24e13fbbd 100644 --- a/docs/dyn/iam_v2beta.html +++ b/docs/dyn/iam_v2beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/iam_v2beta.policies.html b/docs/dyn/iam_v2beta.policies.html index a6edf4fb72..0cc3691496 100644 --- a/docs/dyn/iam_v2beta.policies.html +++ b/docs/dyn/iam_v2beta.policies.html @@ -95,7 +95,7 @@

Instance Methods

listPolicies(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the policies of the specified kind that are attached to a resource. The response lists only policy metadata. In particular, policy rules are omitted.

- listPolicies_next(previous_request, previous_response)

+ listPolicies_next()

Retrieves the next page of results.

update(name, body=None, x__xgafv=None)

@@ -336,17 +336,17 @@

Method Details

- listPolicies_next(previous_request, previous_response) + listPolicies_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iamcredentials_v1.html b/docs/dyn/iamcredentials_v1.html index 6ca8916856..749a6c1797 100644 --- a/docs/dyn/iamcredentials_v1.html +++ b/docs/dyn/iamcredentials_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/iap_v1.html b/docs/dyn/iap_v1.html index 635c5f3954..09eb5a8d3d 100644 --- a/docs/dyn/iap_v1.html +++ b/docs/dyn/iap_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/iap_v1.projects.brands.identityAwareProxyClients.html b/docs/dyn/iap_v1.projects.brands.identityAwareProxyClients.html index 76505b2cca..5cf53fc36c 100644 --- a/docs/dyn/iap_v1.projects.brands.identityAwareProxyClients.html +++ b/docs/dyn/iap_v1.projects.brands.identityAwareProxyClients.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing clients for the brand.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

resetSecret(name, body=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/iap_v1beta1.html b/docs/dyn/iap_v1beta1.html index e78f1b3679..14f2e687f4 100644 --- a/docs/dyn/iap_v1beta1.html +++ b/docs/dyn/iap_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/identitytoolkit_v1.html b/docs/dyn/identitytoolkit_v1.html index efc27e17d5..776277bb09 100644 --- a/docs/dyn/identitytoolkit_v1.html +++ b/docs/dyn/identitytoolkit_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/identitytoolkit_v1.projects.accounts.html b/docs/dyn/identitytoolkit_v1.projects.accounts.html index a24fbfb75a..a7b2f72a7c 100644 --- a/docs/dyn/identitytoolkit_v1.projects.accounts.html +++ b/docs/dyn/identitytoolkit_v1.projects.accounts.html @@ -84,7 +84,7 @@

Instance Methods

batchGet(targetProjectId, delegatedProjectNumber=None, maxResults=None, nextPageToken=None, tenantId=None, x__xgafv=None)

Download account information for all accounts on the project in a paginated manner. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).. Furthermore, additional permissions are needed to get password hash, password salt, and password version from accounts; otherwise these fields are redacted.

- batchGet_next(previous_request, previous_response)

+ batchGet_next()

Retrieves the next page of results.

close()

@@ -330,17 +330,17 @@

Method Details

- batchGet_next(previous_request, previous_response) + batchGet_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v1.projects.tenants.accounts.html b/docs/dyn/identitytoolkit_v1.projects.tenants.accounts.html index b4e09af914..90e7163f0e 100644 --- a/docs/dyn/identitytoolkit_v1.projects.tenants.accounts.html +++ b/docs/dyn/identitytoolkit_v1.projects.tenants.accounts.html @@ -84,7 +84,7 @@

Instance Methods

batchGet(targetProjectId, tenantId, delegatedProjectNumber=None, maxResults=None, nextPageToken=None, x__xgafv=None)

Download account information for all accounts on the project in a paginated manner. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).. Furthermore, additional permissions are needed to get password hash, password salt, and password version from accounts; otherwise these fields are redacted.

- batchGet_next(previous_request, previous_response)

+ batchGet_next()

Retrieves the next page of results.

close()

@@ -332,17 +332,17 @@

Method Details

- batchGet_next(previous_request, previous_response) + batchGet_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.defaultSupportedIdps.html b/docs/dyn/identitytoolkit_v2.defaultSupportedIdps.html index a1da91014a..6694c80dbf 100644 --- a/docs/dyn/identitytoolkit_v2.defaultSupportedIdps.html +++ b/docs/dyn/identitytoolkit_v2.defaultSupportedIdps.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

List all default supported Idps.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -116,17 +116,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/identitytoolkit_v2.html b/docs/dyn/identitytoolkit_v2.html index 871db49c75..1f764a032b 100644 --- a/docs/dyn/identitytoolkit_v2.html +++ b/docs/dyn/identitytoolkit_v2.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/identitytoolkit_v2.projects.defaultSupportedIdpConfigs.html b/docs/dyn/identitytoolkit_v2.projects.defaultSupportedIdpConfigs.html index a762193cef..748b7c1a74 100644 --- a/docs/dyn/identitytoolkit_v2.projects.defaultSupportedIdpConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.defaultSupportedIdpConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all default supported Idp configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.inboundSamlConfigs.html b/docs/dyn/identitytoolkit_v2.projects.inboundSamlConfigs.html index 2c580fee71..96d7ea060c 100644 --- a/docs/dyn/identitytoolkit_v2.projects.inboundSamlConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.inboundSamlConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all inbound SAML configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.oauthIdpConfigs.html b/docs/dyn/identitytoolkit_v2.projects.oauthIdpConfigs.html index 75df7556e2..96e0996429 100644 --- a/docs/dyn/identitytoolkit_v2.projects.oauthIdpConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.oauthIdpConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all Oidc Idp configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.tenants.defaultSupportedIdpConfigs.html b/docs/dyn/identitytoolkit_v2.projects.tenants.defaultSupportedIdpConfigs.html index d3d4a67bc2..0eedca1e0a 100644 --- a/docs/dyn/identitytoolkit_v2.projects.tenants.defaultSupportedIdpConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.tenants.defaultSupportedIdpConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all default supported Idp configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.tenants.html b/docs/dyn/identitytoolkit_v2.projects.tenants.html index 0a43b9528d..e7299fea9a 100644 --- a/docs/dyn/identitytoolkit_v2.projects.tenants.html +++ b/docs/dyn/identitytoolkit_v2.projects.tenants.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List tenants under the given agent project. Requires read permission on the Agent project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -691,17 +691,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.tenants.inboundSamlConfigs.html b/docs/dyn/identitytoolkit_v2.projects.tenants.inboundSamlConfigs.html index ec503a909f..db3b17ca27 100644 --- a/docs/dyn/identitytoolkit_v2.projects.tenants.inboundSamlConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.tenants.inboundSamlConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all inbound SAML configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v2.projects.tenants.oauthIdpConfigs.html b/docs/dyn/identitytoolkit_v2.projects.tenants.oauthIdpConfigs.html index 65f72c487d..dd8eacbcc7 100644 --- a/docs/dyn/identitytoolkit_v2.projects.tenants.oauthIdpConfigs.html +++ b/docs/dyn/identitytoolkit_v2.projects.tenants.oauthIdpConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all Oidc Idp configurations for an Identity Toolkit project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/identitytoolkit_v3.html b/docs/dyn/identitytoolkit_v3.html index 7cadfb98c9..a0d1549119 100644 --- a/docs/dyn/identitytoolkit_v3.html +++ b/docs/dyn/identitytoolkit_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/identitytoolkit_v3.relyingparty.html b/docs/dyn/identitytoolkit_v3.relyingparty.html index 2fb6ca3947..610af8c8f4 100644 --- a/docs/dyn/identitytoolkit_v3.relyingparty.html +++ b/docs/dyn/identitytoolkit_v3.relyingparty.html @@ -87,7 +87,7 @@

Instance Methods

downloadAccount(body=None)

Batch download user accounts.

- downloadAccount_next(previous_request, previous_response)

+ downloadAccount_next()

Retrieves the next page of results.

emailLinkSignin(body=None)

@@ -279,17 +279,17 @@

Method Details

- downloadAccount_next(previous_request, previous_response) + downloadAccount_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ids_v1.html b/docs/dyn/ids_v1.html index 98e07c26db..58fa665386 100644 --- a/docs/dyn/ids_v1.html +++ b/docs/dyn/ids_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ids_v1.projects.locations.endpoints.html b/docs/dyn/ids_v1.projects.locations.endpoints.html index ad81ecbcf4..2ccf1c05a4 100644 --- a/docs/dyn/ids_v1.projects.locations.endpoints.html +++ b/docs/dyn/ids_v1.projects.locations.endpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Endpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ids_v1.projects.locations.html b/docs/dyn/ids_v1.projects.locations.html index f759e3a158..9829e81c87 100644 --- a/docs/dyn/ids_v1.projects.locations.html +++ b/docs/dyn/ids_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ids_v1.projects.locations.operations.html b/docs/dyn/ids_v1.projects.locations.operations.html index e921c1dc20..d09b9d3044 100644 --- a/docs/dyn/ids_v1.projects.locations.operations.html +++ b/docs/dyn/ids_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/index.md b/docs/dyn/index.md index 7ac878b956..2a2282e96f 100644 --- a/docs/dyn/index.md +++ b/docs/dyn/index.md @@ -427,6 +427,7 @@ ## compute * [alpha](http://googleapis.github.io/google-api-python-client/docs/dyn/compute_alpha.html) * [beta](http://googleapis.github.io/google-api-python-client/docs/dyn/compute_beta.html) +* [preview](http://googleapis.github.io/google-api-python-client/docs/dyn/compute_preview.html) * [v1](http://googleapis.github.io/google-api-python-client/docs/dyn/compute_v1.html) @@ -557,6 +558,10 @@ * [v1alpha](http://googleapis.github.io/google-api-python-client/docs/dyn/developerknowledge_v1alpha.html) +## devicerun +* [v1alpha](http://googleapis.github.io/google-api-python-client/docs/dyn/devicerun_v1alpha.html) + + ## dfareporting * [v3.5](http://googleapis.github.io/google-api-python-client/docs/dyn/dfareporting_v3_5.html) * [v5](http://googleapis.github.io/google-api-python-client/docs/dyn/dfareporting_v5.html) diff --git a/docs/dyn/indexing_v3.html b/docs/dyn/indexing_v3.html index 81b9507076..618297e100 100644 --- a/docs/dyn/indexing_v3.html +++ b/docs/dyn/indexing_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/jobs_v3.html b/docs/dyn/jobs_v3.html index cc643f516c..6cb944ef08 100644 --- a/docs/dyn/jobs_v3.html +++ b/docs/dyn/jobs_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/jobs_v3.projects.companies.html b/docs/dyn/jobs_v3.projects.companies.html index 4054cf7723..10eb16ebe6 100644 --- a/docs/dyn/jobs_v3.projects.companies.html +++ b/docs/dyn/jobs_v3.projects.companies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, requireOpenJobs=None, x__xgafv=None)

Lists all companies associated with the service account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/jobs_v3.projects.jobs.html b/docs/dyn/jobs_v3.projects.jobs.html index c9285b60b3..5fb6a1ee99 100644 --- a/docs/dyn/jobs_v3.projects.jobs.html +++ b/docs/dyn/jobs_v3.projects.jobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, jobView=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs by filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -105,10 +105,10 @@

Instance Methods

searchForAlert(parent, body=None, x__xgafv=None)

Searches for jobs using the provided SearchJobsRequest. This API call is intended for the use case of targeting passive job seekers (for example, job seekers who have signed up to receive email alerts about potential job opportunities), and has different algorithmic adjustments that are targeted to passive job seekers. This call constrains the visibility of jobs present in the database, and only returns jobs the caller has permission to search against.

- searchForAlert_next(previous_request, previous_response)

+ searchForAlert_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1935,31 +1935,31 @@

Method Details

- searchForAlert_next(previous_request, previous_response) + searchForAlert_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/jobs_v3p1beta1.html b/docs/dyn/jobs_v3p1beta1.html index 12654c49cf..8db56c6610 100644 --- a/docs/dyn/jobs_v3p1beta1.html +++ b/docs/dyn/jobs_v3p1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/jobs_v3p1beta1.projects.companies.html b/docs/dyn/jobs_v3p1beta1.projects.companies.html index 448ae5d705..cf538324b9 100644 --- a/docs/dyn/jobs_v3p1beta1.projects.companies.html +++ b/docs/dyn/jobs_v3p1beta1.projects.companies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, requireOpenJobs=None, x__xgafv=None)

Lists all companies associated with the service account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/jobs_v3p1beta1.projects.jobs.html b/docs/dyn/jobs_v3p1beta1.projects.jobs.html index 48fa30d53d..6e618df7ae 100644 --- a/docs/dyn/jobs_v3p1beta1.projects.jobs.html +++ b/docs/dyn/jobs_v3p1beta1.projects.jobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, jobView=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs by filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -105,10 +105,10 @@

Instance Methods

searchForAlert(parent, body=None, x__xgafv=None)

Searches for jobs using the provided SearchJobsRequest. This API call is intended for the use case of targeting passive job seekers (for example, job seekers who have signed up to receive email alerts about potential job opportunities), and has different algorithmic adjustments that are targeted to passive job seekers. This call constrains the visibility of jobs present in the database, and only returns jobs the caller has permission to search against.

- searchForAlert_next(previous_request, previous_response)

+ searchForAlert_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1975,31 +1975,31 @@

Method Details

- searchForAlert_next(previous_request, previous_response) + searchForAlert_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/jobs_v4.html b/docs/dyn/jobs_v4.html index 499b983b55..72bd9cc9d9 100644 --- a/docs/dyn/jobs_v4.html +++ b/docs/dyn/jobs_v4.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/jobs_v4.projects.tenants.companies.html b/docs/dyn/jobs_v4.projects.tenants.companies.html index f489b838ca..91eaf67a7e 100644 --- a/docs/dyn/jobs_v4.projects.tenants.companies.html +++ b/docs/dyn/jobs_v4.projects.tenants.companies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, requireOpenJobs=None, x__xgafv=None)

Lists all companies associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -355,17 +355,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/jobs_v4.projects.tenants.html b/docs/dyn/jobs_v4.projects.tenants.html index 841ca2b59a..2974a90cb5 100644 --- a/docs/dyn/jobs_v4.projects.tenants.html +++ b/docs/dyn/jobs_v4.projects.tenants.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all tenants associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/jobs_v4.projects.tenants.jobs.html b/docs/dyn/jobs_v4.projects.tenants.jobs.html index 3582258b2e..c2f0971b36 100644 --- a/docs/dyn/jobs_v4.projects.tenants.jobs.html +++ b/docs/dyn/jobs_v4.projects.tenants.jobs.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, jobView=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs by filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -111,10 +111,10 @@

Instance Methods

searchForAlert(parent, body=None, x__xgafv=None)

Searches for jobs using the provided SearchJobsRequest. This API call is intended for the use case of targeting passive job seekers (for example, job seekers who have signed up to receive email alerts about potential job opportunities), it has different algorithmic adjustments that are designed to specifically target passive job seekers. This call constrains the visibility of jobs present in the database, and only returns jobs the caller has permission to search against.

- searchForAlert_next(previous_request, previous_response)

+ searchForAlert_next()

Retrieves the next page of results.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -1200,17 +1200,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -2227,31 +2227,31 @@

Method Details

- searchForAlert_next(previous_request, previous_response) + searchForAlert_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)
+        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.
-
+ 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. +
- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/keep_v1.html b/docs/dyn/keep_v1.html index 5a39ded628..fabde36439 100644 --- a/docs/dyn/keep_v1.html +++ b/docs/dyn/keep_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/keep_v1.notes.html b/docs/dyn/keep_v1.notes.html index 06427305d2..d8ff999dea 100644 --- a/docs/dyn/keep_v1.notes.html +++ b/docs/dyn/keep_v1.notes.html @@ -95,7 +95,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists notes. Every list call returns a page of results with `page_size` as the upper bound of returned items. A `page_size` of zero allows the server to choose the upper bound. The ListNotesResponse contains at most `page_size` entries. If there are more things left to list, it provides a `next_page_token` value. (Page tokens are opaque values.) To get the next page of results, copy the result's `next_page_token` into the next request's `page_token`. Repeat until the `next_page_token` returned with a page of results is empty. ListNotes return consistent results in the face of concurrent changes, or signals that it cannot with an ABORTED error.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -380,17 +380,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/kgsearch_v1.html b/docs/dyn/kgsearch_v1.html index 0bf24de69a..8c6e8703d7 100644 --- a/docs/dyn/kgsearch_v1.html +++ b/docs/dyn/kgsearch_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/kmsinventory_v1.html b/docs/dyn/kmsinventory_v1.html index cdc69c1371..24f7a6d027 100644 --- a/docs/dyn/kmsinventory_v1.html +++ b/docs/dyn/kmsinventory_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/kmsinventory_v1.organizations.protectedResources.html b/docs/dyn/kmsinventory_v1.organizations.protectedResources.html index 974a8810b3..ccec9a8d53 100644 --- a/docs/dyn/kmsinventory_v1.organizations.protectedResources.html +++ b/docs/dyn/kmsinventory_v1.organizations.protectedResources.html @@ -81,7 +81,7 @@

Instance Methods

search(scope, cryptoKey=None, pageSize=None, pageToken=None, resourceTypes=None, x__xgafv=None)

Returns metadata about the resources protected by the given Cloud KMS CryptoKey in the given Cloud organization/project.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/kmsinventory_v1.projects.cryptoKeys.html b/docs/dyn/kmsinventory_v1.projects.cryptoKeys.html index d70b81c6de..efd735577f 100644 --- a/docs/dyn/kmsinventory_v1.projects.cryptoKeys.html +++ b/docs/dyn/kmsinventory_v1.projects.cryptoKeys.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns cryptographic keys managed by Cloud KMS in a given Cloud project. Note that this data is sourced from snapshots, meaning it may not completely reflect the actual state of key metadata at call time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -173,17 +173,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/kmsinventory_v1.projects.protectedResources.html b/docs/dyn/kmsinventory_v1.projects.protectedResources.html index 77cfcd9fd8..0452e8bbc4 100644 --- a/docs/dyn/kmsinventory_v1.projects.protectedResources.html +++ b/docs/dyn/kmsinventory_v1.projects.protectedResources.html @@ -81,7 +81,7 @@

Instance Methods

search(scope, cryptoKey=None, pageSize=None, pageToken=None, resourceTypes=None, x__xgafv=None)

Returns metadata about the resources protected by the given Cloud KMS CryptoKey in the given Cloud organization/project.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/language_v1.html b/docs/dyn/language_v1.html index 10f69f53a6..7134a70160 100644 --- a/docs/dyn/language_v1.html +++ b/docs/dyn/language_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/language_v1beta2.html b/docs/dyn/language_v1beta2.html index de09995f35..727b6070c1 100644 --- a/docs/dyn/language_v1beta2.html +++ b/docs/dyn/language_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/language_v2.html b/docs/dyn/language_v2.html index 01ff0dc25a..2a1ce4072f 100644 --- a/docs/dyn/language_v2.html +++ b/docs/dyn/language_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/libraryagent_v1.html b/docs/dyn/libraryagent_v1.html index ba0e6c05a1..492ce936b6 100644 --- a/docs/dyn/libraryagent_v1.html +++ b/docs/dyn/libraryagent_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/libraryagent_v1.shelves.books.html b/docs/dyn/libraryagent_v1.shelves.books.html index 83479becf9..1e4a6ee41f 100644 --- a/docs/dyn/libraryagent_v1.shelves.books.html +++ b/docs/dyn/libraryagent_v1.shelves.books.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists books in a shelf. The order is unspecified but deterministic. Newly created books will not necessarily be added to the end of this list. Returns NOT_FOUND if the shelf does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

return_(name, x__xgafv=None)

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/libraryagent_v1.shelves.html b/docs/dyn/libraryagent_v1.shelves.html index 0926163a4f..2a258d5a0d 100644 --- a/docs/dyn/libraryagent_v1.shelves.html +++ b/docs/dyn/libraryagent_v1.shelves.html @@ -89,7 +89,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists shelves. The order is unspecified but deterministic. Newly created shelves will not necessarily be added to the end of this list.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -144,17 +144,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/licensing_v1.html b/docs/dyn/licensing_v1.html index 1c112d3b90..d12112ef11 100644 --- a/docs/dyn/licensing_v1.html +++ b/docs/dyn/licensing_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/licensing_v1.licenseAssignments.html b/docs/dyn/licensing_v1.licenseAssignments.html index 2bb2d28408..dd0ef4a9de 100644 --- a/docs/dyn/licensing_v1.licenseAssignments.html +++ b/docs/dyn/licensing_v1.licenseAssignments.html @@ -93,10 +93,10 @@

Instance Methods

listForProductAndSku(productId, skuId, customerId, maxResults=None, pageToken=None, x__xgafv=None)

List all users assigned licenses for a specific product SKU.

- listForProductAndSku_next(previous_request, previous_response)

+ listForProductAndSku_next()

Retrieves the next page of results.

- listForProduct_next(previous_request, previous_response)

+ listForProduct_next()

Retrieves the next page of results.

patch(productId, skuId, userId, body=None, x__xgafv=None)

@@ -266,31 +266,31 @@

Method Details

- listForProductAndSku_next(previous_request, previous_response) + listForProductAndSku_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)
+        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.
-
+ 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. +
- listForProduct_next(previous_request, previous_response) + listForProduct_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/localservices_v1.accountReports.html b/docs/dyn/localservices_v1.accountReports.html index ce253ac7b5..6788bdbed1 100644 --- a/docs/dyn/localservices_v1.accountReports.html +++ b/docs/dyn/localservices_v1.accountReports.html @@ -81,7 +81,7 @@

Instance Methods

search(endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, query=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)

Get account reports containing aggregate account data of all linked GLS accounts. Caller needs to provide their manager customer id and the associated auth credential that allows them read permissions on their linked accounts.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -140,17 +140,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/localservices_v1.detailedLeadReports.html b/docs/dyn/localservices_v1.detailedLeadReports.html index e86032a642..569c3f6dec 100644 --- a/docs/dyn/localservices_v1.detailedLeadReports.html +++ b/docs/dyn/localservices_v1.detailedLeadReports.html @@ -81,7 +81,7 @@

Instance Methods

search(endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, query=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)

Get detailed lead reports containing leads that have been received by all linked GLS accounts. Caller needs to provide their manager customer id and the associated auth credential that allows them read permissions on their linked accounts.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/localservices_v1.html b/docs/dyn/localservices_v1.html index a6d2b39001..81c07be35f 100644 --- a/docs/dyn/localservices_v1.html +++ b/docs/dyn/localservices_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/logging_v2.billingAccounts.exclusions.html b/docs/dyn/logging_v2.billingAccounts.exclusions.html index 88873c95fb..76b86f3b5b 100644 --- a/docs/dyn/logging_v2.billingAccounts.exclusions.html +++ b/docs/dyn/logging_v2.billingAccounts.exclusions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the exclusions on the _Default sink in a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.billingAccounts.locations.buckets.html b/docs/dyn/logging_v2.billingAccounts.locations.buckets.html index 208b220091..3898576276 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.buckets.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.buckets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log buckets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.billingAccounts.locations.buckets.links.html b/docs/dyn/logging_v2.billingAccounts.locations.buckets.links.html index 9372517d8b..2caf9e3ffe 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.buckets.links.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.buckets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists links.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.locations.buckets.views.html b/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.html index 04ec751a3a..a333fd120c 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.logs.html b/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.logs.html index d303e182cf..36fe7cc835 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.logs.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.buckets.views.logs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.locations.html b/docs/dyn/logging_v2.billingAccounts.locations.html index eac989cbb2..2f20bcc69f 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.locations.operations.html b/docs/dyn/logging_v2.billingAccounts.locations.operations.html index 9a54da5eb5..5c2d622e1f 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.operations.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.locations.recentQueries.html b/docs/dyn/logging_v2.billingAccounts.locations.recentQueries.html index edba1113ef..a78d518a32 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.recentQueries.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.recentQueries.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the RecentQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.locations.savedQueries.html b/docs/dyn/logging_v2.billingAccounts.locations.savedQueries.html index 63ea4c7d16..c7038a5476 100644 --- a/docs/dyn/logging_v2.billingAccounts.locations.savedQueries.html +++ b/docs/dyn/logging_v2.billingAccounts.locations.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the SavedQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.billingAccounts.logs.html b/docs/dyn/logging_v2.billingAccounts.logs.html index 2e0f5ea403..1421a0d490 100644 --- a/docs/dyn/logging_v2.billingAccounts.logs.html +++ b/docs/dyn/logging_v2.billingAccounts.logs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.billingAccounts.sinks.html b/docs/dyn/logging_v2.billingAccounts.sinks.html index 32cae872bc..64a6c16863 100644 --- a/docs/dyn/logging_v2.billingAccounts.sinks.html +++ b/docs/dyn/logging_v2.billingAccounts.sinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sinks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(sinkName, body=None, customWriterIdentity=None, uniqueWriterIdentity=None, updateMask=None, x__xgafv=None)

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.entries.html b/docs/dyn/logging_v2.entries.html index 6e33af38b2..feb3ee17e0 100644 --- a/docs/dyn/logging_v2.entries.html +++ b/docs/dyn/logging_v2.entries.html @@ -84,7 +84,7 @@

Instance Methods

list(body=None, x__xgafv=None)

Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Routing overview (https://docs.cloud.google.com/logging/docs/routing/overview).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

tail(body=None, x__xgafv=None)

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.exclusions.html b/docs/dyn/logging_v2.exclusions.html index a83578e349..6b7a6ab646 100644 --- a/docs/dyn/logging_v2.exclusions.html +++ b/docs/dyn/logging_v2.exclusions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the exclusions on the _Default sink in a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.exclusions.html b/docs/dyn/logging_v2.folders.exclusions.html index 4304a83b97..878cbdcf2e 100644 --- a/docs/dyn/logging_v2.folders.exclusions.html +++ b/docs/dyn/logging_v2.folders.exclusions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the exclusions on the _Default sink in a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.locations.buckets.html b/docs/dyn/logging_v2.folders.locations.buckets.html index 1e3390f6bd..fd16ffa162 100644 --- a/docs/dyn/logging_v2.folders.locations.buckets.html +++ b/docs/dyn/logging_v2.folders.locations.buckets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log buckets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.locations.buckets.links.html b/docs/dyn/logging_v2.folders.locations.buckets.links.html index 4377f2563c..3549eb9a77 100644 --- a/docs/dyn/logging_v2.folders.locations.buckets.links.html +++ b/docs/dyn/logging_v2.folders.locations.buckets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists links.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.locations.buckets.views.html b/docs/dyn/logging_v2.folders.locations.buckets.views.html index 86a5b437fe..cfef926d70 100644 --- a/docs/dyn/logging_v2.folders.locations.buckets.views.html +++ b/docs/dyn/logging_v2.folders.locations.buckets.views.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.locations.buckets.views.logs.html b/docs/dyn/logging_v2.folders.locations.buckets.views.logs.html index cdf620e89f..4859057209 100644 --- a/docs/dyn/logging_v2.folders.locations.buckets.views.logs.html +++ b/docs/dyn/logging_v2.folders.locations.buckets.views.logs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.locations.html b/docs/dyn/logging_v2.folders.locations.html index f7654478b6..e39940b57d 100644 --- a/docs/dyn/logging_v2.folders.locations.html +++ b/docs/dyn/logging_v2.folders.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.locations.logScopes.html b/docs/dyn/logging_v2.folders.locations.logScopes.html index 6524610655..cd74477113 100644 --- a/docs/dyn/logging_v2.folders.locations.logScopes.html +++ b/docs/dyn/logging_v2.folders.locations.logScopes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log scopes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.locations.operations.html b/docs/dyn/logging_v2.folders.locations.operations.html index 722b985e9f..6b0d0783be 100644 --- a/docs/dyn/logging_v2.folders.locations.operations.html +++ b/docs/dyn/logging_v2.folders.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.locations.recentQueries.html b/docs/dyn/logging_v2.folders.locations.recentQueries.html index 2d4d362f36..f08addeb6c 100644 --- a/docs/dyn/logging_v2.folders.locations.recentQueries.html +++ b/docs/dyn/logging_v2.folders.locations.recentQueries.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the RecentQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.locations.savedQueries.html b/docs/dyn/logging_v2.folders.locations.savedQueries.html index d5875d9d04..88b15cb44e 100644 --- a/docs/dyn/logging_v2.folders.locations.savedQueries.html +++ b/docs/dyn/logging_v2.folders.locations.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the SavedQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.folders.logs.html b/docs/dyn/logging_v2.folders.logs.html index ffa96eeb5c..469e8c929f 100644 --- a/docs/dyn/logging_v2.folders.logs.html +++ b/docs/dyn/logging_v2.folders.logs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.folders.sinks.html b/docs/dyn/logging_v2.folders.sinks.html index c55be54a7b..0678135541 100644 --- a/docs/dyn/logging_v2.folders.sinks.html +++ b/docs/dyn/logging_v2.folders.sinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sinks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(sinkName, body=None, customWriterIdentity=None, uniqueWriterIdentity=None, updateMask=None, x__xgafv=None)

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.html b/docs/dyn/logging_v2.html index d67fca1fe9..7b9a2fea46 100644 --- a/docs/dyn/logging_v2.html +++ b/docs/dyn/logging_v2.html @@ -133,7 +133,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -142,20 +142,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/logging_v2.locations.buckets.html b/docs/dyn/logging_v2.locations.buckets.html index e365212764..132cfbf176 100644 --- a/docs/dyn/logging_v2.locations.buckets.html +++ b/docs/dyn/logging_v2.locations.buckets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log buckets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.locations.buckets.links.html b/docs/dyn/logging_v2.locations.buckets.links.html index d4af408579..eeb7d34c33 100644 --- a/docs/dyn/logging_v2.locations.buckets.links.html +++ b/docs/dyn/logging_v2.locations.buckets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists links.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.locations.buckets.views.html b/docs/dyn/logging_v2.locations.buckets.views.html index 48820bbf5e..2579b0058f 100644 --- a/docs/dyn/logging_v2.locations.buckets.views.html +++ b/docs/dyn/logging_v2.locations.buckets.views.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.locations.html b/docs/dyn/logging_v2.locations.html index 402a93a8d5..67d0556be5 100644 --- a/docs/dyn/logging_v2.locations.html +++ b/docs/dyn/logging_v2.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.locations.operations.html b/docs/dyn/logging_v2.locations.operations.html index 8d3e88d15f..a8eabaab08 100644 --- a/docs/dyn/logging_v2.locations.operations.html +++ b/docs/dyn/logging_v2.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.logs.html b/docs/dyn/logging_v2.logs.html index 2ae23cd5d6..4b668cabbf 100644 --- a/docs/dyn/logging_v2.logs.html +++ b/docs/dyn/logging_v2.logs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.monitoredResourceDescriptors.html b/docs/dyn/logging_v2.monitoredResourceDescriptors.html index 6b3e47cb22..e0b8d19c52 100644 --- a/docs/dyn/logging_v2.monitoredResourceDescriptors.html +++ b/docs/dyn/logging_v2.monitoredResourceDescriptors.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists the descriptors for monitored resource types used by Logging.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.exclusions.html b/docs/dyn/logging_v2.organizations.exclusions.html index dbf7b76e57..bf969bcffe 100644 --- a/docs/dyn/logging_v2.organizations.exclusions.html +++ b/docs/dyn/logging_v2.organizations.exclusions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the exclusions on the _Default sink in a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.organizations.locations.buckets.html b/docs/dyn/logging_v2.organizations.locations.buckets.html index 82a49a8bd4..be70e51864 100644 --- a/docs/dyn/logging_v2.organizations.locations.buckets.html +++ b/docs/dyn/logging_v2.organizations.locations.buckets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log buckets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.organizations.locations.buckets.links.html b/docs/dyn/logging_v2.organizations.locations.buckets.links.html index 443acda582..037231068e 100644 --- a/docs/dyn/logging_v2.organizations.locations.buckets.links.html +++ b/docs/dyn/logging_v2.organizations.locations.buckets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists links.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.locations.buckets.views.html b/docs/dyn/logging_v2.organizations.locations.buckets.views.html index 7f6f631109..1ef839c4a9 100644 --- a/docs/dyn/logging_v2.organizations.locations.buckets.views.html +++ b/docs/dyn/logging_v2.organizations.locations.buckets.views.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.organizations.locations.buckets.views.logs.html b/docs/dyn/logging_v2.organizations.locations.buckets.views.logs.html index 06fce3784a..2c8fc431c4 100644 --- a/docs/dyn/logging_v2.organizations.locations.buckets.views.logs.html +++ b/docs/dyn/logging_v2.organizations.locations.buckets.views.logs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.locations.html b/docs/dyn/logging_v2.organizations.locations.html index 6aa4d6bfb6..dc90b9fdb8 100644 --- a/docs/dyn/logging_v2.organizations.locations.html +++ b/docs/dyn/logging_v2.organizations.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.locations.logScopes.html b/docs/dyn/logging_v2.organizations.locations.logScopes.html index 0ebb4985cd..86c996389d 100644 --- a/docs/dyn/logging_v2.organizations.locations.logScopes.html +++ b/docs/dyn/logging_v2.organizations.locations.logScopes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log scopes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.organizations.locations.operations.html b/docs/dyn/logging_v2.organizations.locations.operations.html index 2ab573c716..aa87099ec5 100644 --- a/docs/dyn/logging_v2.organizations.locations.operations.html +++ b/docs/dyn/logging_v2.organizations.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.locations.recentQueries.html b/docs/dyn/logging_v2.organizations.locations.recentQueries.html index 2beaddadf3..53d7475ca9 100644 --- a/docs/dyn/logging_v2.organizations.locations.recentQueries.html +++ b/docs/dyn/logging_v2.organizations.locations.recentQueries.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the RecentQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.locations.savedQueries.html b/docs/dyn/logging_v2.organizations.locations.savedQueries.html index 40c78d51b3..a584585bed 100644 --- a/docs/dyn/logging_v2.organizations.locations.savedQueries.html +++ b/docs/dyn/logging_v2.organizations.locations.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the SavedQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.organizations.logs.html b/docs/dyn/logging_v2.organizations.logs.html index fd35454a87..620ff02bb6 100644 --- a/docs/dyn/logging_v2.organizations.logs.html +++ b/docs/dyn/logging_v2.organizations.logs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.organizations.sinks.html b/docs/dyn/logging_v2.organizations.sinks.html index be0a409b73..dfa8cccb0b 100644 --- a/docs/dyn/logging_v2.organizations.sinks.html +++ b/docs/dyn/logging_v2.organizations.sinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sinks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(sinkName, body=None, customWriterIdentity=None, uniqueWriterIdentity=None, updateMask=None, x__xgafv=None)

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.exclusions.html b/docs/dyn/logging_v2.projects.exclusions.html index 8794cd6545..bf2c381558 100644 --- a/docs/dyn/logging_v2.projects.exclusions.html +++ b/docs/dyn/logging_v2.projects.exclusions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the exclusions on the _Default sink in a parent resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.locations.buckets.html b/docs/dyn/logging_v2.projects.locations.buckets.html index af7dbf9bbd..921ca347da 100644 --- a/docs/dyn/logging_v2.projects.locations.buckets.html +++ b/docs/dyn/logging_v2.projects.locations.buckets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log buckets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.locations.buckets.links.html b/docs/dyn/logging_v2.projects.locations.buckets.links.html index 1542dc5bfb..768c8402bf 100644 --- a/docs/dyn/logging_v2.projects.locations.buckets.links.html +++ b/docs/dyn/logging_v2.projects.locations.buckets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists links.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.locations.buckets.views.html b/docs/dyn/logging_v2.projects.locations.buckets.views.html index 413a59b8c7..0bd6e8144b 100644 --- a/docs/dyn/logging_v2.projects.locations.buckets.views.html +++ b/docs/dyn/logging_v2.projects.locations.buckets.views.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists views on a log bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.locations.buckets.views.logs.html b/docs/dyn/logging_v2.projects.locations.buckets.views.logs.html index 79c8766173..d671ca9e27 100644 --- a/docs/dyn/logging_v2.projects.locations.buckets.views.logs.html +++ b/docs/dyn/logging_v2.projects.locations.buckets.views.logs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.locations.html b/docs/dyn/logging_v2.projects.locations.html index a260a07c58..5d57ca0124 100644 --- a/docs/dyn/logging_v2.projects.locations.html +++ b/docs/dyn/logging_v2.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.locations.logScopes.html b/docs/dyn/logging_v2.projects.locations.logScopes.html index 2ce4ccdd86..1fdc7fa566 100644 --- a/docs/dyn/logging_v2.projects.locations.logScopes.html +++ b/docs/dyn/logging_v2.projects.locations.logScopes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists log scopes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.locations.operations.html b/docs/dyn/logging_v2.projects.locations.operations.html index 40cf7c4799..c799b9df07 100644 --- a/docs/dyn/logging_v2.projects.locations.operations.html +++ b/docs/dyn/logging_v2.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.locations.recentQueries.html b/docs/dyn/logging_v2.projects.locations.recentQueries.html index 796bd0eb3e..06116fa47c 100644 --- a/docs/dyn/logging_v2.projects.locations.recentQueries.html +++ b/docs/dyn/logging_v2.projects.locations.recentQueries.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the RecentQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.locations.savedQueries.html b/docs/dyn/logging_v2.projects.locations.savedQueries.html index 7305fb9603..3ee71b95c1 100644 --- a/docs/dyn/logging_v2.projects.locations.savedQueries.html +++ b/docs/dyn/logging_v2.projects.locations.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the SavedQueries that were created by the user making the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -800,17 +800,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.logs.html b/docs/dyn/logging_v2.projects.logs.html index fd8cc01e2e..1b6082cf0e 100644 --- a/docs/dyn/logging_v2.projects.logs.html +++ b/docs/dyn/logging_v2.projects.logs.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, resourceNames=None, x__xgafv=None)

Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/logging_v2.projects.metrics.html b/docs/dyn/logging_v2.projects.metrics.html index aceae6a1b3..58f03eef79 100644 --- a/docs/dyn/logging_v2.projects.metrics.html +++ b/docs/dyn/logging_v2.projects.metrics.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists logs-based metrics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(metricName, body=None, x__xgafv=None)

@@ -419,17 +419,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.projects.sinks.html b/docs/dyn/logging_v2.projects.sinks.html index ff4bed928e..de627a87f8 100644 --- a/docs/dyn/logging_v2.projects.sinks.html +++ b/docs/dyn/logging_v2.projects.sinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sinks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(sinkName, body=None, customWriterIdentity=None, uniqueWriterIdentity=None, updateMask=None, x__xgafv=None)

@@ -297,17 +297,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/logging_v2.sinks.html b/docs/dyn/logging_v2.sinks.html index 8c8af3dcdc..5088d4269e 100644 --- a/docs/dyn/logging_v2.sinks.html +++ b/docs/dyn/logging_v2.sinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sinks.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(sinkName, body=None, customWriterIdentity=None, uniqueWriterIdentity=None, updateMask=None, x__xgafv=None)

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/looker_v1.html b/docs/dyn/looker_v1.html index 176bea5605..e9a8d9b156 100644 --- a/docs/dyn/looker_v1.html +++ b/docs/dyn/looker_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/looker_v1.projects.locations.html b/docs/dyn/looker_v1.projects.locations.html index adceb2b9a0..f075f0a091 100644 --- a/docs/dyn/looker_v1.projects.locations.html +++ b/docs/dyn/looker_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/looker_v1.projects.locations.instances.backups.html b/docs/dyn/looker_v1.projects.locations.instances.backups.html index 0ef99d611c..76f9618ac5 100644 --- a/docs/dyn/looker_v1.projects.locations.instances.backups.html +++ b/docs/dyn/looker_v1.projects.locations.instances.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List backups of Looker instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/looker_v1.projects.locations.instances.html b/docs/dyn/looker_v1.projects.locations.instances.html index 06ceaf007c..2e871abd66 100644 --- a/docs/dyn/looker_v1.projects.locations.instances.html +++ b/docs/dyn/looker_v1.projects.locations.instances.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -772,17 +772,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/looker_v1.projects.locations.operations.html b/docs/dyn/looker_v1.projects.locations.operations.html index 03d164a72d..ad93556673 100644 --- a/docs/dyn/looker_v1.projects.locations.operations.html +++ b/docs/dyn/looker_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1.html b/docs/dyn/managedidentities_v1.html index 3b0cc8b1d5..36ed609cbb 100644 --- a/docs/dyn/managedidentities_v1.html +++ b/docs/dyn/managedidentities_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.backups.html b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.backups.html index d1d189c3ef..0009114773 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.backups.html +++ b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Backup in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.html b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.html index 0861485981..e52e60889e 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.html +++ b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.html @@ -127,7 +127,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists domains in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -760,17 +760,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.sqlIntegrations.html b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.sqlIntegrations.html index bd3c04721f..1582b15a0a 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.global_.domains.sqlIntegrations.html +++ b/docs/dyn/managedidentities_v1.projects.locations.global_.domains.sqlIntegrations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SqlIntegrations in a given domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1.projects.locations.global_.operations.html b/docs/dyn/managedidentities_v1.projects.locations.global_.operations.html index fbf1a9cdc0..e18ca24cbd 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.global_.operations.html +++ b/docs/dyn/managedidentities_v1.projects.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1.projects.locations.global_.peerings.html b/docs/dyn/managedidentities_v1.projects.locations.global_.peerings.html index f395df7552..f705cdd229 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.global_.peerings.html +++ b/docs/dyn/managedidentities_v1.projects.locations.global_.peerings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Peerings in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1.projects.locations.html b/docs/dyn/managedidentities_v1.projects.locations.html index 23482f9d9b..3620d9e3b8 100644 --- a/docs/dyn/managedidentities_v1.projects.locations.html +++ b/docs/dyn/managedidentities_v1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1alpha1.html b/docs/dyn/managedidentities_v1alpha1.html index eef2dba58a..dfebaddcf2 100644 --- a/docs/dyn/managedidentities_v1alpha1.html +++ b/docs/dyn/managedidentities_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.backups.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.backups.html index 4aa8a4b043..6acb28b5e7 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.backups.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Backup in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.html index bf5e3a7fa0..a12273cb8b 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.html @@ -127,7 +127,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Domains in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -761,17 +761,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.sqlIntegrations.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.sqlIntegrations.html index 232753e147..f50dd79b3a 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.sqlIntegrations.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.domains.sqlIntegrations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SQLIntegrations in a given domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1alpha1.projects.locations.global_.operations.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.operations.html index d8faf4cc71..65ccb5e1e2 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.operations.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1alpha1.projects.locations.global_.peerings.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.peerings.html index 6aee3f43cb..5121b8005e 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.peerings.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.global_.peerings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Peerings in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1alpha1.projects.locations.html b/docs/dyn/managedidentities_v1alpha1.projects.locations.html index 2016f69649..854825b536 100644 --- a/docs/dyn/managedidentities_v1alpha1.projects.locations.html +++ b/docs/dyn/managedidentities_v1alpha1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1beta1.html b/docs/dyn/managedidentities_v1beta1.html index 93fb9417ba..a50d60eb15 100644 --- a/docs/dyn/managedidentities_v1beta1.html +++ b/docs/dyn/managedidentities_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.backups.html b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.backups.html index afcacf2412..6ecf6e4d90 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.backups.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Backup in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.html b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.html index aba656e811..4191c40749 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.html @@ -127,7 +127,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists domains in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -761,17 +761,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.sqlIntegrations.html b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.sqlIntegrations.html index d68d919ac2..66e10a9487 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.sqlIntegrations.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.domains.sqlIntegrations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SqlIntegrations in a given domain.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1beta1.projects.locations.global_.operations.html b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.operations.html index 36ab1d1761..79c18f5a91 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.operations.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedidentities_v1beta1.projects.locations.global_.peerings.html b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.peerings.html index e7128f016b..9ce3e367aa 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.global_.peerings.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.global_.peerings.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Peerings in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedidentities_v1beta1.projects.locations.html b/docs/dyn/managedidentities_v1beta1.projects.locations.html index d30f62adfe..dc69b1ee1c 100644 --- a/docs/dyn/managedidentities_v1beta1.projects.locations.html +++ b/docs/dyn/managedidentities_v1beta1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedkafka_v1.html b/docs/dyn/managedkafka_v1.html index cd5f895d02..69404dec0e 100644 --- a/docs/dyn/managedkafka_v1.html +++ b/docs/dyn/managedkafka_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/managedkafka_v1.projects.locations.clusters.acls.html b/docs/dyn/managedkafka_v1.projects.locations.clusters.acls.html index 1e13e146e0..a16895f6a1 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.clusters.acls.html +++ b/docs/dyn/managedkafka_v1.projects.locations.clusters.acls.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the acls in a given cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.clusters.consumerGroups.html b/docs/dyn/managedkafka_v1.projects.locations.clusters.consumerGroups.html index 43ee3aded1..d01c0f5f82 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.clusters.consumerGroups.html +++ b/docs/dyn/managedkafka_v1.projects.locations.clusters.consumerGroups.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the consumer groups in a given cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -188,17 +188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.clusters.html b/docs/dyn/managedkafka_v1.projects.locations.clusters.html index f242cd8dad..d6c474b559 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.clusters.html +++ b/docs/dyn/managedkafka_v1.projects.locations.clusters.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -453,17 +453,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.clusters.topics.html b/docs/dyn/managedkafka_v1.projects.locations.clusters.topics.html index 76e9eb877c..1ba4219ccc 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.clusters.topics.html +++ b/docs/dyn/managedkafka_v1.projects.locations.clusters.topics.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the topics in a given cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.connectClusters.connectors.html b/docs/dyn/managedkafka_v1.projects.locations.connectClusters.connectors.html index 8b88fbd8ce..d4e6c5cc3e 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.connectClusters.connectors.html +++ b/docs/dyn/managedkafka_v1.projects.locations.connectClusters.connectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the connectors in a given Connect cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.connectClusters.html b/docs/dyn/managedkafka_v1.projects.locations.connectClusters.html index 42b2b0c197..6029234239 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.connectClusters.html +++ b/docs/dyn/managedkafka_v1.projects.locations.connectClusters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Kafka Connect clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -339,17 +339,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/managedkafka_v1.projects.locations.html b/docs/dyn/managedkafka_v1.projects.locations.html index 139a854dc9..1427b7aca5 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.html +++ b/docs/dyn/managedkafka_v1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/managedkafka_v1.projects.locations.operations.html b/docs/dyn/managedkafka_v1.projects.locations.operations.html index 577397b893..75763783e7 100644 --- a/docs/dyn/managedkafka_v1.projects.locations.operations.html +++ b/docs/dyn/managedkafka_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/manufacturers_v1.accounts.languages.productCertifications.html b/docs/dyn/manufacturers_v1.accounts.languages.productCertifications.html index 3815eb61e0..a4b6cecf24 100644 --- a/docs/dyn/manufacturers_v1.accounts.languages.productCertifications.html +++ b/docs/dyn/manufacturers_v1.accounts.languages.productCertifications.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists product certifications from a specified certification body. This method can only be called by certification bodies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -272,17 +272,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/manufacturers_v1.accounts.products.html b/docs/dyn/manufacturers_v1.accounts.products.html index c34896cec6..2fe2fb5569 100644 --- a/docs/dyn/manufacturers_v1.accounts.products.html +++ b/docs/dyn/manufacturers_v1.accounts.products.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, include=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the products in a Manufacturer Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(parent, name, body=None, x__xgafv=None)

@@ -726,17 +726,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/manufacturers_v1.html b/docs/dyn/manufacturers_v1.html index 3ef1dc477d..47fe736f43 100644 --- a/docs/dyn/manufacturers_v1.html +++ b/docs/dyn/manufacturers_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/marketingplatformadmin_v1alpha.html b/docs/dyn/marketingplatformadmin_v1alpha.html index c1c5533f16..0fe2446664 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/marketingplatformadmin_v1alpha.organizations.adminAccessBindings.html b/docs/dyn/marketingplatformadmin_v1alpha.organizations.adminAccessBindings.html index 759bd48726..cbfbf61df1 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.organizations.adminAccessBindings.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.organizations.adminAccessBindings.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of admin access bindings in the specified GMP organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/marketingplatformadmin_v1alpha.organizations.analyticsAccountLinks.html b/docs/dyn/marketingplatformadmin_v1alpha.organizations.analyticsAccountLinks.html index 1e23084927..ad68ac84ce 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.organizations.analyticsAccountLinks.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.organizations.analyticsAccountLinks.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Google Analytics accounts link to the specified Google Marketing Platform organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setPropertyServiceLevel(analyticsAccountLink, body=None, x__xgafv=None)

@@ -178,17 +178,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/marketingplatformadmin_v1alpha.organizations.html b/docs/dyn/marketingplatformadmin_v1alpha.organizations.html index ce2be3d71e..837c2a79aa 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.organizations.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.organizations.html @@ -102,7 +102,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of organizations that the user has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reportPropertyUsage(organization, body=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.html b/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.html index 746b3ded39..6781789234 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of user groups in the specified GMP organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.members.html b/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.members.html index 4714f254db..9be3e0ac4d 100644 --- a/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.members.html +++ b/docs/dyn/marketingplatformadmin_v1alpha.organizations.userGroups.members.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of members in the specified user group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/meet_v2.conferenceRecords.html b/docs/dyn/meet_v2.conferenceRecords.html index 4a0f219d5c..06eb0cde3e 100644 --- a/docs/dyn/meet_v2.conferenceRecords.html +++ b/docs/dyn/meet_v2.conferenceRecords.html @@ -104,7 +104,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the conference records. By default, ordered by start time and in descending order. For more information, see [Work with conferences](https://developers.google.com/workspace/meet/api/guides/conferences).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.participants.html b/docs/dyn/meet_v2.conferenceRecords.participants.html index e42956a2b8..6163020546 100644 --- a/docs/dyn/meet_v2.conferenceRecords.participants.html +++ b/docs/dyn/meet_v2.conferenceRecords.participants.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the participants in a conference record. By default, ordered by join time and in descending order. This API supports `fields` as standard parameters like every other API. However, when the `fields` request parameter is omitted, this API defaults to `'participants/*, next_page_token'`. For more information, see [Work with participants](https://developers.google.com/workspace/meet/api/guides/participants).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.participants.participantSessions.html b/docs/dyn/meet_v2.conferenceRecords.participants.participantSessions.html index b4f441efef..1698706369 100644 --- a/docs/dyn/meet_v2.conferenceRecords.participants.participantSessions.html +++ b/docs/dyn/meet_v2.conferenceRecords.participants.participantSessions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the participant sessions of a participant in a conference record. By default, ordered by join time and in descending order. This API supports `fields` as standard parameters like every other API. However, when the `fields` request parameter is omitted this API defaults to `'participantsessions/*, next_page_token'`. For more information, see [Work with participants](https://developers.google.com/workspace/meet/api/guides/participants).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -143,17 +143,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.recordings.html b/docs/dyn/meet_v2.conferenceRecords.recordings.html index df93e40356..07238d8c49 100644 --- a/docs/dyn/meet_v2.conferenceRecords.recordings.html +++ b/docs/dyn/meet_v2.conferenceRecords.recordings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the recording resources from the conference record. By default, ordered by start time and in ascending order. For more information, see [Work with artifacts](https://developers.google.com/workspace/meet/api/guides/artifacts).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.smartNotes.html b/docs/dyn/meet_v2.conferenceRecords.smartNotes.html index a50b9507c0..dcd9007625 100644 --- a/docs/dyn/meet_v2.conferenceRecords.smartNotes.html +++ b/docs/dyn/meet_v2.conferenceRecords.smartNotes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the set of smart notes from the conference record. By default, ordered by start time and in ascending order. For more information, see [Work with artifacts](https://developers.google.com/workspace/meet/api/guides/artifacts).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.transcripts.entries.html b/docs/dyn/meet_v2.conferenceRecords.transcripts.entries.html index a5f9e612c2..3184e0b70a 100644 --- a/docs/dyn/meet_v2.conferenceRecords.transcripts.entries.html +++ b/docs/dyn/meet_v2.conferenceRecords.transcripts.entries.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the structured transcript entries per transcript. By default, ordered by start time and in ascending order. For more information, see [Work with artifacts](https://developers.google.com/workspace/meet/api/guides/artifacts). Note: The transcript entries returned by the Google Meet API might not match the transcription found in the Google Docs transcript file. This can occur when 1) we have interleaved speakers within milliseconds, or 2) the Google Docs transcript file is modified after generation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.conferenceRecords.transcripts.html b/docs/dyn/meet_v2.conferenceRecords.transcripts.html index 1606fe189e..1378fa87b2 100644 --- a/docs/dyn/meet_v2.conferenceRecords.transcripts.html +++ b/docs/dyn/meet_v2.conferenceRecords.transcripts.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the set of transcripts from the conference record. By default, ordered by start time and in ascending order. For more information, see [Work with artifacts](https://developers.google.com/workspace/meet/api/guides/artifacts).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/meet_v2.html b/docs/dyn/meet_v2.html index b0a0d41a41..eca7c53c58 100644 --- a/docs/dyn/meet_v2.html +++ b/docs/dyn/meet_v2.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/meet_v2.spaces.members.html b/docs/dyn/meet_v2.spaces.members.html index 4773a2beab..db800ab5ce 100644 --- a/docs/dyn/meet_v2.spaces.members.html +++ b/docs/dyn/meet_v2.spaces.members.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists members. For more information, see [Manage meeting space members](https://developers.google.com/workspace/meet/api/guides/meeting-space-members). This API supports the `fields` parameter in [SystemParameterContext](https://cloud.google.com/apis/docs/system-parameters). When the `fields` parameter is omitted this API response will default to "name,email,role,user".

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/memcache_v1.html b/docs/dyn/memcache_v1.html index d16d08fe63..b6eb44e8ad 100644 --- a/docs/dyn/memcache_v1.html +++ b/docs/dyn/memcache_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/memcache_v1.projects.locations.html b/docs/dyn/memcache_v1.projects.locations.html index 114574b433..680e6a02ea 100644 --- a/docs/dyn/memcache_v1.projects.locations.html +++ b/docs/dyn/memcache_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/memcache_v1.projects.locations.instances.html b/docs/dyn/memcache_v1.projects.locations.instances.html index dfde36a64b..16aa7467b6 100644 --- a/docs/dyn/memcache_v1.projects.locations.instances.html +++ b/docs/dyn/memcache_v1.projects.locations.instances.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Instances in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -556,17 +556,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/memcache_v1.projects.locations.operations.html b/docs/dyn/memcache_v1.projects.locations.operations.html index c9ec7ddb43..dad53f8346 100644 --- a/docs/dyn/memcache_v1.projects.locations.operations.html +++ b/docs/dyn/memcache_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/memcache_v1beta2.html b/docs/dyn/memcache_v1beta2.html index e6dbbee96c..98ad5b60e6 100644 --- a/docs/dyn/memcache_v1beta2.html +++ b/docs/dyn/memcache_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/memcache_v1beta2.projects.locations.html b/docs/dyn/memcache_v1beta2.projects.locations.html index bad5e65473..f9a7233bc5 100644 --- a/docs/dyn/memcache_v1beta2.projects.locations.html +++ b/docs/dyn/memcache_v1beta2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/memcache_v1beta2.projects.locations.instances.html b/docs/dyn/memcache_v1beta2.projects.locations.instances.html index 79e7dcedbe..2d51a714b3 100644 --- a/docs/dyn/memcache_v1beta2.projects.locations.instances.html +++ b/docs/dyn/memcache_v1beta2.projects.locations.instances.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Instances in a given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -581,17 +581,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/memcache_v1beta2.projects.locations.operations.html b/docs/dyn/memcache_v1beta2.projects.locations.operations.html index d75f2f3e84..d9851f52fd 100644 --- a/docs/dyn/memcache_v1beta2.projects.locations.operations.html +++ b/docs/dyn/memcache_v1beta2.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1.accounts.gbpAccounts.html b/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html index ed2abc10fd..7223a2e7cf 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List the GBP accounts for a given merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1.accounts.html b/docs/dyn/merchantapi_accounts_v1.accounts.html index f2729a269f..ef843dc81f 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.html @@ -186,10 +186,10 @@

Instance Methods

listSubaccounts(provider, pageSize=None, pageToken=None, x__xgafv=None)

List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful `accounts.list` method. This method will produce the same results as calling `ListsAccounts` with the following filter: `relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))`

- listSubaccounts_next(previous_request, previous_response)

+ listSubaccounts_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -444,31 +444,31 @@

Method Details

- listSubaccounts_next(previous_request, previous_response) + listSubaccounts_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.issues.html b/docs/dyn/merchantapi_accounts_v1.accounts.issues.html index 77e4fcf6ee..72fa5db9e5 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.issues.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.issues.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, timeZone=None, x__xgafv=None)

Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1.accounts.omnichannelSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html index 4544c3a697..652c3e1654 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the omnichannel settings for a given merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html index 29f2b9f924..f721ad4cd7 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html @@ -81,7 +81,7 @@

Instance Methods

find(parent, pageSize=None, pageToken=None, x__xgafv=None)

Find the LFP provider candidates in a given country.

- find_next(previous_request, previous_response)

+ find_next()

Retrieves the next page of results.

linkLfpProvider(name, body=None, x__xgafv=None)

@@ -121,17 +121,17 @@

Method Details

- find_next(previous_request, previous_response) + find_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html b/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html index f2f9952a9b..2ea0e319a0 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all existing return policies for a given business.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -408,17 +408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1.accounts.programs.html b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html index 7dfca0005b..7540948508 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.programs.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all programs for the account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1.accounts.regions.html b/docs/dyn/merchantapi_accounts_v1.accounts.regions.html index 301e041deb..b5cb4c998b 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.regions.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.regions.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the regions in your Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -513,17 +513,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html b/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html index 161523b0e4..73e085d559 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List account relationships for the specified account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.services.html b/docs/dyn/merchantapi_accounts_v1.accounts.services.html index 866a453953..9acb4e2df2 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.services.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.services.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List account services for the specified accounts. Supports filtering.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

propose(parent, body=None, x__xgafv=None)

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.users.html b/docs/dyn/merchantapi_accounts_v1.accounts.users.html index c89a80d370..d6bc3cbd74 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.users.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.users.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all users of a Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1.html b/docs/dyn/merchantapi_accounts_v1.html index d3d4e1bfa3..4cd0c79d48 100644 --- a/docs/dyn/merchantapi_accounts_v1.html +++ b/docs/dyn/merchantapi_accounts_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.gbpAccounts.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.gbpAccounts.html index 9a4efeccea..c7361d2a01 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.gbpAccounts.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.gbpAccounts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List the GBP accounts for a given merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1beta.accounts.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.html index 2283325f35..b053a1244c 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.html @@ -186,10 +186,10 @@

Instance Methods

listSubaccounts(provider, pageSize=None, pageToken=None, x__xgafv=None)

List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful `accounts.list` method. This method will produce the same results as calling `ListsAccounts` with the following filter: `relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))`

- listSubaccounts_next(previous_request, previous_response)

+ listSubaccounts_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -457,31 +457,31 @@

Method Details

- listSubaccounts_next(previous_request, previous_response) + listSubaccounts_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.issues.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.issues.html index 99d4925e71..c027234a7c 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.issues.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.issues.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, languageCode=None, pageSize=None, pageToken=None, timeZone=None, x__xgafv=None)

Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html index 4bbf2a581c..a8c1514043 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all the omnichannel settings for a given merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.lfpProviders.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.lfpProviders.html index 55e2a6fea7..c6fb13a228 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.lfpProviders.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.lfpProviders.html @@ -81,7 +81,7 @@

Instance Methods

find(parent, pageSize=None, pageToken=None, x__xgafv=None)

Find the LFP provider candidates in a given country.

- find_next(previous_request, previous_response)

+ find_next()

Retrieves the next page of results.

linkLfpProvider(name, body=None, x__xgafv=None)

@@ -121,17 +121,17 @@

Method Details

- find_next(previous_request, previous_response) + find_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.onlineReturnPolicies.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.onlineReturnPolicies.html index 490a0ef422..e173f6d77f 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.onlineReturnPolicies.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.onlineReturnPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all existing return policies for a given business.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -411,17 +411,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html index b7a76d4781..64f8a00a5a 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all programs for the account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_accounts_v1beta.accounts.regions.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.regions.html index 3d356c2212..7199e2b8b6 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.regions.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.regions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the regions in your Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.relationships.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.relationships.html index 4656f003ae..b2ff2a36af 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.relationships.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.relationships.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List account relationships for the specified account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.services.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.services.html index 7dfaf31f2f..88c7376132 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.services.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.services.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List account services for the specified accounts. Supports filtering.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

propose(parent, body=None, x__xgafv=None)

@@ -232,17 +232,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.users.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.users.html index dada847283..77d3c0a9ab 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.users.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.users.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all users of a Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_accounts_v1beta.html b/docs/dyn/merchantapi_accounts_v1beta.html index 0743f5d471..61649c2dd5 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.html +++ b/docs/dyn/merchantapi_accounts_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html b/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html index 4124a8de55..3c1bfa6737 100644 --- a/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html +++ b/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Retrieves the list of conversion sources the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_conversions_v1.html b/docs/dyn/merchantapi_conversions_v1.html index 156cc4d433..960272c9d2 100644 --- a/docs/dyn/merchantapi_conversions_v1.html +++ b/docs/dyn/merchantapi_conversions_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_conversions_v1beta.accounts.conversionSources.html b/docs/dyn/merchantapi_conversions_v1beta.accounts.conversionSources.html index e2074ecaaf..f4b458c4c6 100644 --- a/docs/dyn/merchantapi_conversions_v1beta.accounts.conversionSources.html +++ b/docs/dyn/merchantapi_conversions_v1beta.accounts.conversionSources.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Retrieves the list of conversion sources the caller has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -323,17 +323,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_conversions_v1beta.html b/docs/dyn/merchantapi_conversions_v1beta.html index 3af1a0e156..d912df40c1 100644 --- a/docs/dyn/merchantapi_conversions_v1beta.html +++ b/docs/dyn/merchantapi_conversions_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html index f9c1724355..3f465241d5 100644 --- a/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html +++ b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the configurations for data sources for the given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_datasources_v1.html b/docs/dyn/merchantapi_datasources_v1.html index fc720fa5a1..9c513e646c 100644 --- a/docs/dyn/merchantapi_datasources_v1.html +++ b/docs/dyn/merchantapi_datasources_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html index 20159ba911..b8086c3637 100644 --- a/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html +++ b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the configurations for data sources for the given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -515,17 +515,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_datasources_v1beta.html b/docs/dyn/merchantapi_datasources_v1beta.html index 7ae49c4c41..a40a54157c 100644 --- a/docs/dyn/merchantapi_datasources_v1beta.html +++ b/docs/dyn/merchantapi_datasources_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html b/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html index b45abada16..717056f599 100644 --- a/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html +++ b/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_inventories_v1.accounts.products.regionalInventories.html b/docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html index bbbbbbbdd1..106266f90b 100644 --- a/docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html +++ b/docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_inventories_v1.html b/docs/dyn/merchantapi_inventories_v1.html index f7f632338a..6f950506c5 100644 --- a/docs/dyn/merchantapi_inventories_v1.html +++ b/docs/dyn/merchantapi_inventories_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_inventories_v1beta.accounts.products.localInventories.html b/docs/dyn/merchantapi_inventories_v1beta.accounts.products.localInventories.html index 450db0a8dc..b8ab0756c3 100644 --- a/docs/dyn/merchantapi_inventories_v1beta.accounts.products.localInventories.html +++ b/docs/dyn/merchantapi_inventories_v1beta.accounts.products.localInventories.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_inventories_v1beta.accounts.products.regionalInventories.html b/docs/dyn/merchantapi_inventories_v1beta.accounts.products.regionalInventories.html index db29213793..afea6e4be0 100644 --- a/docs/dyn/merchantapi_inventories_v1beta.accounts.products.regionalInventories.html +++ b/docs/dyn/merchantapi_inventories_v1beta.accounts.products.regionalInventories.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -241,17 +241,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_inventories_v1beta.html b/docs/dyn/merchantapi_inventories_v1beta.html index 0fe9b57472..7dfa928615 100644 --- a/docs/dyn/merchantapi_inventories_v1beta.html +++ b/docs/dyn/merchantapi_inventories_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html b/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html index 3471594182..7f0f4dcdd3 100644 --- a/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html +++ b/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `AggregateProductStatuses` resources for your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. This method can only be accessed by standalone accounts and sub-accounts of an advanced account. To retrieve product statuses for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.aggregateProductStatuses.list` for each sub-account individually.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_issueresolution_v1.html b/docs/dyn/merchantapi_issueresolution_v1.html index c969de7051..2cfa69be2f 100644 --- a/docs/dyn/merchantapi_issueresolution_v1.html +++ b/docs/dyn/merchantapi_issueresolution_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_issueresolution_v1beta.accounts.aggregateProductStatuses.html b/docs/dyn/merchantapi_issueresolution_v1beta.accounts.aggregateProductStatuses.html index 3dfeede82d..4c801821c6 100644 --- a/docs/dyn/merchantapi_issueresolution_v1beta.accounts.aggregateProductStatuses.html +++ b/docs/dyn/merchantapi_issueresolution_v1beta.accounts.aggregateProductStatuses.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the `AggregateProductStatuses` resources for your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. This method can only be accessed by standalone accounts and sub-accounts of an advanced account. To retrieve product statuses for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.aggregateProductStatuses.list` for each sub-account individually.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_issueresolution_v1beta.html b/docs/dyn/merchantapi_issueresolution_v1beta.html index c3790d07c9..47b19e54a8 100644 --- a/docs/dyn/merchantapi_issueresolution_v1beta.html +++ b/docs/dyn/merchantapi_issueresolution_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_lfp_v1.accounts.lfpStores.html b/docs/dyn/merchantapi_lfp_v1.accounts.lfpStores.html index b58c1af4f7..4b431a6f0d 100644 --- a/docs/dyn/merchantapi_lfp_v1.accounts.lfpStores.html +++ b/docs/dyn/merchantapi_lfp_v1.accounts.lfpStores.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, targetAccount=None, x__xgafv=None)

Lists the stores of the target merchant, specified by the filter in `ListLfpStoresRequest`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_lfp_v1.html b/docs/dyn/merchantapi_lfp_v1.html index 2cbb019ba1..55e2c37cf3 100644 --- a/docs/dyn/merchantapi_lfp_v1.html +++ b/docs/dyn/merchantapi_lfp_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html b/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html index 1618e63b1c..5ee960e04e 100644 --- a/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html +++ b/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, targetAccount=None, x__xgafv=None)

Lists the stores of the target merchant, specified by the filter in `ListLfpStoresRequest`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_lfp_v1beta.html b/docs/dyn/merchantapi_lfp_v1beta.html index 96dfae10c9..d9104d89ec 100644 --- a/docs/dyn/merchantapi_lfp_v1beta.html +++ b/docs/dyn/merchantapi_lfp_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_loyaltycustomers_v1.accounts.loyaltyCustomers.html b/docs/dyn/merchantapi_loyaltycustomers_v1.accounts.loyaltyCustomers.html index 07f27af94b..21d4120b3c 100644 --- a/docs/dyn/merchantapi_loyaltycustomers_v1.accounts.loyaltyCustomers.html +++ b/docs/dyn/merchantapi_loyaltycustomers_v1.accounts.loyaltyCustomers.html @@ -79,7 +79,7 @@

Instance Methods

Close httplib2 connections.

manage(parent, body=None, x__xgafv=None)

-

Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.

+

Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. For more information on how to use this method, see [Overview of the loyalty customer match service](/merchant/api/guides/loyalty/customer-match-service). **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.

Method Details

close() @@ -88,7 +88,7 @@

Method Details

manage(parent, body=None, x__xgafv=None) - 
Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.
+  
Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. For more information on how to use this method, see [Overview of the loyalty customer match service](/merchant/api/guides/loyalty/customer-match-service). **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.
 
 Args:
   parent: string, Required. The parent account where this loyalty customer will be handled. Format: `accounts/{account}` (required)
diff --git a/docs/dyn/merchantapi_loyaltycustomers_v1.html b/docs/dyn/merchantapi_loyaltycustomers_v1.html
index 9dcc72aae6..05ce6c9fb0 100644
--- a/docs/dyn/merchantapi_loyaltycustomers_v1.html
+++ b/docs/dyn/merchantapi_loyaltycustomers_v1.html
@@ -83,7 +83,7 @@ 
Instance Methods

   close()

 
Close httplib2 connections.

 

-  new_batch_http_request(callback=None)

+  new_batch_http_request()

 
Create a BatchHttpRequest object based on the discovery document.

 
Method Details

 

@@ -92,20 +92,20 @@ 
Method Details

 

 
 

-    new_batch_http_request(callback=None)
+    new_batch_http_request()
   
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-

+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+
\ No newline at end of file diff --git a/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html b/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html index 770b196faa..f4b976e04d 100644 --- a/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html +++ b/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets all the notification subscriptions for a merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_notifications_v1.html b/docs/dyn/merchantapi_notifications_v1.html index f45437beb6..17c598c77d 100644 --- a/docs/dyn/merchantapi_notifications_v1.html +++ b/docs/dyn/merchantapi_notifications_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_notifications_v1beta.accounts.notificationsubscriptions.html b/docs/dyn/merchantapi_notifications_v1beta.accounts.notificationsubscriptions.html index d803793033..df754849f4 100644 --- a/docs/dyn/merchantapi_notifications_v1beta.accounts.notificationsubscriptions.html +++ b/docs/dyn/merchantapi_notifications_v1beta.accounts.notificationsubscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Gets all the notification subscriptions for a merchant.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -207,17 +207,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/merchantapi_notifications_v1beta.html b/docs/dyn/merchantapi_notifications_v1beta.html index 2525b05090..4f18146fd6 100644 --- a/docs/dyn/merchantapi_notifications_v1beta.html +++ b/docs/dyn/merchantapi_notifications_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_ordertracking_v1.html b/docs/dyn/merchantapi_ordertracking_v1.html index 851d450e08..3fc92ebb6d 100644 --- a/docs/dyn/merchantapi_ordertracking_v1.html +++ b/docs/dyn/merchantapi_ordertracking_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_ordertracking_v1beta.html b/docs/dyn/merchantapi_ordertracking_v1beta.html index d8a4c66fa3..54a1d79008 100644 --- a/docs/dyn/merchantapi_ordertracking_v1beta.html +++ b/docs/dyn/merchantapi_ordertracking_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_products_v1.accounts.productInputs.html b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html index 961443f9aa..b244c099c4 100644 --- a/docs/dyn/merchantapi_products_v1.accounts.productInputs.html +++ b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html @@ -341,7 +341,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -643,9 +643,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, @@ -885,7 +886,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -1187,9 +1188,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, @@ -1430,7 +1432,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -1732,9 +1734,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, @@ -1975,7 +1978,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -2277,9 +2280,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, diff --git a/docs/dyn/merchantapi_products_v1.accounts.products.html b/docs/dyn/merchantapi_products_v1.accounts.products.html index 9c277c9c90..24c1c34dd5 100644 --- a/docs/dyn/merchantapi_products_v1.accounts.products.html +++ b/docs/dyn/merchantapi_products_v1.accounts.products.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -341,7 +341,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -643,9 +643,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, @@ -944,7 +945,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -1246,9 +1247,10 @@

Method Details

], "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle. "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information. - "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle. - "duration": "A String", # The warranty duration in months. - "mileage": { # The mileage of the vehicle. # The warranty mileage. + "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product. + "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field. + "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`. + "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles). "unit": "A String", # The unit of the mileage. "value": "A String", # The distance value. }, @@ -1296,17 +1298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_products_v1.html b/docs/dyn/merchantapi_products_v1.html index e732cc1318..9edbea5c28 100644 --- a/docs/dyn/merchantapi_products_v1.html +++ b/docs/dyn/merchantapi_products_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html b/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html index 432c5b6a66..4015217998 100644 --- a/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html +++ b/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html @@ -241,7 +241,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -568,7 +568,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -896,7 +896,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -1224,7 +1224,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). diff --git a/docs/dyn/merchantapi_products_v1beta.accounts.products.html b/docs/dyn/merchantapi_products_v1beta.accounts.products.html index d8d81ceb06..812ea416d7 100644 --- a/docs/dyn/merchantapi_products_v1beta.accounts.products.html +++ b/docs/dyn/merchantapi_products_v1beta.accounts.products.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -228,7 +228,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -614,7 +614,7 @@

Method Details

"ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. }, "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. - { # A message that represents loyalty program. + { # A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs). "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases. "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). @@ -862,17 +862,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_products_v1beta.html b/docs/dyn/merchantapi_products_v1beta.html index 04c364dc9b..2469762c49 100644 --- a/docs/dyn/merchantapi_products_v1beta.html +++ b/docs/dyn/merchantapi_products_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html b/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html index 747e68bc84..c1185dcb63 100644 --- a/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html +++ b/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -722,17 +722,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_promotions_v1.html b/docs/dyn/merchantapi_promotions_v1.html index c2627d7069..6d8f15a188 100644 --- a/docs/dyn/merchantapi_promotions_v1.html +++ b/docs/dyn/merchantapi_promotions_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html b/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html index ff4040871b..94227698d9 100644 --- a/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html +++ b/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -722,17 +722,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_promotions_v1beta.html b/docs/dyn/merchantapi_promotions_v1beta.html index 75026104f7..c556665f9d 100644 --- a/docs/dyn/merchantapi_promotions_v1beta.html +++ b/docs/dyn/merchantapi_promotions_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_quota_v1.accounts.limits.html b/docs/dyn/merchantapi_quota_v1.accounts.limits.html index 447c53cca8..55d45d0990 100644 --- a/docs/dyn/merchantapi_quota_v1.accounts.limits.html +++ b/docs/dyn/merchantapi_quota_v1.accounts.limits.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the limits of an account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -147,17 +147,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_quota_v1.accounts.quotas.html b/docs/dyn/merchantapi_quota_v1.accounts.quotas.html index a20a611cbc..c696b23d98 100644 --- a/docs/dyn/merchantapi_quota_v1.accounts.quotas.html +++ b/docs/dyn/merchantapi_quota_v1.accounts.quotas.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the daily call quota and usage per group for your Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_quota_v1.html b/docs/dyn/merchantapi_quota_v1.html index 0ffcfbf0ef..c6e2b7b53c 100644 --- a/docs/dyn/merchantapi_quota_v1.html +++ b/docs/dyn/merchantapi_quota_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_quota_v1beta.accounts.quotas.html b/docs/dyn/merchantapi_quota_v1beta.accounts.quotas.html index b9bc5d7c3c..9cbe722090 100644 --- a/docs/dyn/merchantapi_quota_v1beta.accounts.quotas.html +++ b/docs/dyn/merchantapi_quota_v1beta.accounts.quotas.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the daily call quota and usage per group for your Merchant Center account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_quota_v1beta.html b/docs/dyn/merchantapi_quota_v1beta.html index bde45bef80..72e24342f7 100644 --- a/docs/dyn/merchantapi_quota_v1beta.html +++ b/docs/dyn/merchantapi_quota_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_reports_v1.accounts.reports.html b/docs/dyn/merchantapi_reports_v1.accounts.reports.html index bbbe0f25eb..88e5c15687 100644 --- a/docs/dyn/merchantapi_reports_v1.accounts.reports.html +++ b/docs/dyn/merchantapi_reports_v1.accounts.reports.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -178,7 +178,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. + "domain": "A String", # Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. @@ -195,7 +195,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. + "domain": "A String", # Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. @@ -398,17 +398,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_reports_v1.html b/docs/dyn/merchantapi_reports_v1.html index c01ed97064..bf2aefd915 100644 --- a/docs/dyn/merchantapi_reports_v1.html +++ b/docs/dyn/merchantapi_reports_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html b/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html index 3847c482af..06f8bdfcec 100644 --- a/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html +++ b/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, body=None, x__xgafv=None)

Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -178,7 +178,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. + "domain": "A String", # Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. @@ -195,7 +195,7 @@

Method Details

"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. }, - "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. + "domain": "A String", # Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. @@ -398,17 +398,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_reports_v1beta.html b/docs/dyn/merchantapi_reports_v1beta.html index 334cd06260..88b0d4c62a 100644 --- a/docs/dyn/merchantapi_reports_v1beta.html +++ b/docs/dyn/merchantapi_reports_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/merchantapi_reviews_v1beta.accounts.merchantReviews.html b/docs/dyn/merchantapi_reviews_v1beta.accounts.merchantReviews.html index d55f82da10..86cae54e88 100644 --- a/docs/dyn/merchantapi_reviews_v1beta.accounts.merchantReviews.html +++ b/docs/dyn/merchantapi_reviews_v1beta.accounts.merchantReviews.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists merchant reviews.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -389,17 +389,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_reviews_v1beta.accounts.productReviews.html b/docs/dyn/merchantapi_reviews_v1beta.accounts.productReviews.html index c503fb69ed..c5550daa85 100644 --- a/docs/dyn/merchantapi_reviews_v1beta.accounts.productReviews.html +++ b/docs/dyn/merchantapi_reviews_v1beta.accounts.productReviews.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists product reviews.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -541,17 +541,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/merchantapi_reviews_v1beta.html b/docs/dyn/merchantapi_reviews_v1beta.html index 46ea7f022f..e655744b44 100644 --- a/docs/dyn/merchantapi_reviews_v1beta.html +++ b/docs/dyn/merchantapi_reviews_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/metastore_v1.html b/docs/dyn/metastore_v1.html index 65e3d8e05d..c8a61b9c38 100644 --- a/docs/dyn/metastore_v1.html +++ b/docs/dyn/metastore_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/metastore_v1.projects.locations.federations.html b/docs/dyn/metastore_v1.projects.locations.federations.html index 96c09361ab..db3f5daed2 100644 --- a/docs/dyn/metastore_v1.projects.locations.federations.html +++ b/docs/dyn/metastore_v1.projects.locations.federations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists federations in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1.projects.locations.html b/docs/dyn/metastore_v1.projects.locations.html index dfb4b7e663..0ea87d9308 100644 --- a/docs/dyn/metastore_v1.projects.locations.html +++ b/docs/dyn/metastore_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1.projects.locations.operations.html b/docs/dyn/metastore_v1.projects.locations.operations.html index 239ebdf52e..b1be969775 100644 --- a/docs/dyn/metastore_v1.projects.locations.operations.html +++ b/docs/dyn/metastore_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1.projects.locations.services.backups.html b/docs/dyn/metastore_v1.projects.locations.services.backups.html index 41a11d5e65..100181664a 100644 --- a/docs/dyn/metastore_v1.projects.locations.services.backups.html +++ b/docs/dyn/metastore_v1.projects.locations.services.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists backups in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -164,6 +164,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -380,6 +386,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -584,6 +596,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -676,17 +694,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1.projects.locations.services.html b/docs/dyn/metastore_v1.projects.locations.services.html index 164c975b03..c9948586c3 100644 --- a/docs/dyn/metastore_v1.projects.locations.services.html +++ b/docs/dyn/metastore_v1.projects.locations.services.html @@ -128,7 +128,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists services in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

moveTableToDatabase(service, body=None, x__xgafv=None)

@@ -380,6 +380,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -630,6 +636,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -825,6 +837,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -914,17 +932,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1023,6 +1041,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. diff --git a/docs/dyn/metastore_v1.projects.locations.services.metadataImports.html b/docs/dyn/metastore_v1.projects.locations.services.metadataImports.html index 2c44e19836..93661348d1 100644 --- a/docs/dyn/metastore_v1.projects.locations.services.metadataImports.html +++ b/docs/dyn/metastore_v1.projects.locations.services.metadataImports.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists imports in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1.projects.locations.services.migrationExecutions.html b/docs/dyn/metastore_v1.projects.locations.services.migrationExecutions.html index 7f5b1e9005..c83291353c 100644 --- a/docs/dyn/metastore_v1.projects.locations.services.migrationExecutions.html +++ b/docs/dyn/metastore_v1.projects.locations.services.migrationExecutions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists migration executions on a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1alpha.html b/docs/dyn/metastore_v1alpha.html index 11cf4a5eb8..5fa2955d36 100644 --- a/docs/dyn/metastore_v1alpha.html +++ b/docs/dyn/metastore_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/metastore_v1alpha.projects.locations.federations.html b/docs/dyn/metastore_v1alpha.projects.locations.federations.html index ca5a7f2a59..ab1a3dbe32 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.federations.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.federations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists federations in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1alpha.projects.locations.html b/docs/dyn/metastore_v1alpha.projects.locations.html index 66944ea1ff..a10df6b438 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1alpha.projects.locations.operations.html b/docs/dyn/metastore_v1alpha.projects.locations.operations.html index e272b14294..43d2a7b83c 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.operations.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1alpha.projects.locations.services.backups.html b/docs/dyn/metastore_v1alpha.projects.locations.services.backups.html index f6fcd0104f..40c3d36828 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.services.backups.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.services.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists backups in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -171,6 +171,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -415,6 +421,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -647,6 +659,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -763,17 +781,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1alpha.projects.locations.services.html b/docs/dyn/metastore_v1alpha.projects.locations.services.html index c331e01c17..05ef193314 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.services.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.services.html @@ -128,7 +128,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists services in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

moveTableToDatabase(service, body=None, x__xgafv=None)

@@ -387,6 +387,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -665,6 +671,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -888,6 +900,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -1001,17 +1019,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1114,6 +1132,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. diff --git a/docs/dyn/metastore_v1alpha.projects.locations.services.metadataImports.html b/docs/dyn/metastore_v1alpha.projects.locations.services.metadataImports.html index 064caf3dc9..331fe35b75 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.services.metadataImports.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.services.metadataImports.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists imports in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1alpha.projects.locations.services.migrationExecutions.html b/docs/dyn/metastore_v1alpha.projects.locations.services.migrationExecutions.html index 20b0c67951..76056f102e 100644 --- a/docs/dyn/metastore_v1alpha.projects.locations.services.migrationExecutions.html +++ b/docs/dyn/metastore_v1alpha.projects.locations.services.migrationExecutions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists migration executions on a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1beta.html b/docs/dyn/metastore_v1beta.html index 2794132d02..8f65ca491c 100644 --- a/docs/dyn/metastore_v1beta.html +++ b/docs/dyn/metastore_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/metastore_v1beta.projects.locations.federations.html b/docs/dyn/metastore_v1beta.projects.locations.federations.html index 52fe58e635..b509c8b3bb 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.federations.html +++ b/docs/dyn/metastore_v1beta.projects.locations.federations.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists federations in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1beta.projects.locations.html b/docs/dyn/metastore_v1beta.projects.locations.html index 6e90007be7..595b2c9b4f 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.html +++ b/docs/dyn/metastore_v1beta.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: Global locations: If name is empty, the method lists the public locations available to all projects. Project-specific locations: If name follows the format projects/{project}, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project.For gRPC and client library implementations, the resource name is passed as the name field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1beta.projects.locations.operations.html b/docs/dyn/metastore_v1beta.projects.locations.operations.html index 94f4afdfb3..f46864a20a 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.operations.html +++ b/docs/dyn/metastore_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/metastore_v1beta.projects.locations.services.backups.html b/docs/dyn/metastore_v1beta.projects.locations.services.backups.html index 3ed0647a97..bd1138112f 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.services.backups.html +++ b/docs/dyn/metastore_v1beta.projects.locations.services.backups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists backups in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -171,6 +171,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -415,6 +421,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -647,6 +659,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -763,17 +781,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1beta.projects.locations.services.html b/docs/dyn/metastore_v1beta.projects.locations.services.html index bc9ff39d68..516d931b25 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.services.html +++ b/docs/dyn/metastore_v1beta.projects.locations.services.html @@ -128,7 +128,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists services in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

moveTableToDatabase(service, body=None, x__xgafv=None)

@@ -387,6 +387,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -665,6 +671,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -888,6 +900,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. @@ -1001,17 +1019,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1114,6 +1132,12 @@

Method Details

"labels": { # User-defined labels for the metastore service. "a_key": "A String", }, + "lakehouseProxyConfig": { # Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS. # Output only. The Lakehouse proxy routing configuration for the metastore service. + "catalog": "A String", # Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}. + "namespaces": [ # Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list. + "A String", + ], + }, "maintenanceWindow": { # Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service. # Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type. "dayOfWeek": "A String", # Optional. The day of week, when the window starts. "hourOfDay": 42, # Optional. The hour of day (0-23) when the window starts. diff --git a/docs/dyn/metastore_v1beta.projects.locations.services.metadataImports.html b/docs/dyn/metastore_v1beta.projects.locations.services.metadataImports.html index d44e4a7029..c5d96f8e3d 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.services.metadataImports.html +++ b/docs/dyn/metastore_v1beta.projects.locations.services.metadataImports.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists imports in a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/metastore_v1beta.projects.locations.services.migrationExecutions.html b/docs/dyn/metastore_v1beta.projects.locations.services.migrationExecutions.html index a041262b33..f0d83006a2 100644 --- a/docs/dyn/metastore_v1beta.projects.locations.services.migrationExecutions.html +++ b/docs/dyn/metastore_v1beta.projects.locations.services.migrationExecutions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists migration executions on a service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.html b/docs/dyn/migrationcenter_v1.html index f37622fb7d..b76d3004e3 100644 --- a/docs/dyn/migrationcenter_v1.html +++ b/docs/dyn/migrationcenter_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/migrationcenter_v1.projects.locations.assets.html b/docs/dyn/migrationcenter_v1.projects.locations.assets.html index cdb8e92cc9..3122f27f0b 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.assets.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.assets.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showHidden=None, view=None, x__xgafv=None)

Lists all the assets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2352,17 +2352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.assetsExportJobs.html b/docs/dyn/migrationcenter_v1.projects.locations.assetsExportJobs.html index 67a1366e89..0dee8d7897 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.assetsExportJobs.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.assetsExportJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the assets export jobs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -430,17 +430,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.discoveryClients.html b/docs/dyn/migrationcenter_v1.projects.locations.discoveryClients.html index e8cf3debd0..09e498cf33 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.discoveryClients.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.discoveryClients.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the discovery clients in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.groups.html b/docs/dyn/migrationcenter_v1.projects.locations.groups.html index 27bea74d2e..ecf32584f2 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.groups.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.groups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all groups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.html b/docs/dyn/migrationcenter_v1.projects.locations.html index dea5a52f84..89e0cfdadd 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.html @@ -137,7 +137,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSettings(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.importJobs.html b/docs/dyn/migrationcenter_v1.projects.locations.importJobs.html index 20ab7a0145..89b8ec3565 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.importJobs.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.importJobs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all import jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -575,17 +575,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.importJobs.importDataFiles.html b/docs/dyn/migrationcenter_v1.projects.locations.importJobs.importDataFiles.html index b981344ffd..29e32d0d18 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.importJobs.importDataFiles.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.importJobs.importDataFiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List import data files.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.operations.html b/docs/dyn/migrationcenter_v1.projects.locations.operations.html index f647c3e922..a73803141d 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.operations.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.preferenceSets.html b/docs/dyn/migrationcenter_v1.projects.locations.preferenceSets.html index bd9aba6d53..53a9ebd6b5 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.preferenceSets.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.preferenceSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the preference sets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -354,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1.projects.locations.relations.html b/docs/dyn/migrationcenter_v1.projects.locations.relations.html index 8d0cc3d7f9..adc81052e3 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.relations.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.relations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the relations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.reportConfigs.html b/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.html index 101fbbf504..4266bd4df7 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReportConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.reportConfigs.reports.html b/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.reports.html index b9bdece837..c15eeba8dc 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.reports.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.reportConfigs.reports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Reports in a given ReportConfig.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -988,17 +988,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.sources.errorFrames.html b/docs/dyn/migrationcenter_v1.projects.locations.sources.errorFrames.html index 37a50843ae..495bd1922d 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.sources.errorFrames.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.sources.errorFrames.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all error frames in a given source and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1009,17 +1009,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1.projects.locations.sources.html b/docs/dyn/migrationcenter_v1.projects.locations.sources.html index 58e0606714..7c829a3c43 100644 --- a/docs/dyn/migrationcenter_v1.projects.locations.sources.html +++ b/docs/dyn/migrationcenter_v1.projects.locations.sources.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the sources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.html b/docs/dyn/migrationcenter_v1alpha1.html index 1df343dfba..f6f9692ce5 100644 --- a/docs/dyn/migrationcenter_v1alpha1.html +++ b/docs/dyn/migrationcenter_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assets.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assets.html index 5ca9fea5d0..10d2cb75b8 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assets.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assets.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, showHidden=None, view=None, x__xgafv=None)

Lists all the assets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -4648,17 +4648,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html index 1782944f31..13c50f5ce8 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the assets export jobs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -430,17 +430,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.discoveryClients.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.discoveryClients.html index 4f19c32bfb..cf18c112e4 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.discoveryClients.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.discoveryClients.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the discovery clients in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -331,17 +331,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.groups.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.groups.html index f7ad78941c..1fe5ccf4e0 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.groups.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.groups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all groups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.html index cfb634d808..7710c4b13e 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.html @@ -137,7 +137,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSettings(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.html index 54054f664c..27c9f8449b 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all import jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -632,17 +632,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.importDataFiles.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.importDataFiles.html index 868fd3ab0c..23777d8055 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.importDataFiles.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.importJobs.importDataFiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List import data files.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.operations.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.operations.html index 445b44dab6..aab048ea89 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.preferenceSets.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.preferenceSets.html index 261b3b17aa..c6e5e526cc 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.preferenceSets.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.preferenceSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the preference sets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -675,17 +675,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.relations.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.relations.html index 567d666b7a..f17eb10ea9 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.relations.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.relations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the relations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.reportConfigs.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.html index e5aa79a30f..c1dd757c8b 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReportConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.html index cae8d9fcac..21a5a998d1 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Reports in a given ReportConfig.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2496,17 +2496,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.reportExportJobs.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.reportExportJobs.html index 463e4bd00d..4f82276a6b 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.reportExportJobs.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.reportConfigs.reports.reportExportJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the report export jobs for a given report.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.errorFrames.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.errorFrames.html index a37ab3375d..1ea0284169 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.errorFrames.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.errorFrames.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all error frames in a given source and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -2025,17 +2025,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/migrationcenter_v1alpha1.projects.locations.sources.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.html index 6a2582cd11..973c4797d0 100644 --- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.html +++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.sources.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the sources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ml_v1.html b/docs/dyn/ml_v1.html index 9a9036bd28..b11539c224 100644 --- a/docs/dyn/ml_v1.html +++ b/docs/dyn/ml_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ml_v1.projects.jobs.html b/docs/dyn/ml_v1.projects.jobs.html index 3d84c419b1..cdb1aad5f0 100644 --- a/docs/dyn/ml_v1.projects.jobs.html +++ b/docs/dyn/ml_v1.projects.jobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the jobs in the project. If there are no jobs that match the request parameters, the list request returns an empty response body: {}.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1091,17 +1091,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ml_v1.projects.locations.html b/docs/dyn/ml_v1.projects.locations.html index ae937866ab..739b8b3bde 100644 --- a/docs/dyn/ml_v1.projects.locations.html +++ b/docs/dyn/ml_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List all locations that provides at least one type of CMLE capability.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ml_v1.projects.models.html b/docs/dyn/ml_v1.projects.models.html index 75729952c3..273bce5793 100644 --- a/docs/dyn/ml_v1.projects.models.html +++ b/docs/dyn/ml_v1.projects.models.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the models in a project. Each project can contain multiple models, and each model can have multiple versions. If there are no models that match the request parameters, the list request returns an empty response body: {}.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -635,17 +635,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ml_v1.projects.models.versions.html b/docs/dyn/ml_v1.projects.models.versions.html index b06538d2e5..d4f111ae97 100644 --- a/docs/dyn/ml_v1.projects.models.versions.html +++ b/docs/dyn/ml_v1.projects.models.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Gets basic information about all the versions of a model. If you expect that a model has many versions, or if you need to handle only a limited number of results at a time, you can request that the list be retrieved in batches (called pages). If there are no versions that match the request parameters, the list request returns an empty response body: {}.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -462,17 +462,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ml_v1.projects.operations.html b/docs/dyn/ml_v1.projects.operations.html index bc497cfc5a..1362984790 100644 --- a/docs/dyn/ml_v1.projects.operations.html +++ b/docs/dyn/ml_v1.projects.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v1.html b/docs/dyn/monitoring_v1.html index 7288a4c995..2510aa1c34 100644 --- a/docs/dyn/monitoring_v1.html +++ b/docs/dyn/monitoring_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/monitoring_v1.projects.dashboards.html b/docs/dyn/monitoring_v1.projects.dashboards.html index 6cb436a345..735652496d 100644 --- a/docs/dyn/monitoring_v1.projects.dashboards.html +++ b/docs/dyn/monitoring_v1.projects.dashboards.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing dashboards.This method requires the monitoring.dashboards.list permission on the specified project. For more information, see Cloud Identity and Access Management (https://cloud.google.com/iam).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, validateOnly=None, x__xgafv=None)

@@ -16312,17 +16312,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.folders.timeSeries.html b/docs/dyn/monitoring_v3.folders.timeSeries.html index 3f8a5ac51d..ffe9f9ef27 100644 --- a/docs/dyn/monitoring_v3.folders.timeSeries.html +++ b/docs/dyn/monitoring_v3.folders.timeSeries.html @@ -81,7 +81,7 @@

Instance Methods

list(name, aggregation_alignmentPeriod=None, aggregation_crossSeriesReducer=None, aggregation_groupByFields=None, aggregation_perSeriesAligner=None, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, secondaryAggregation_alignmentPeriod=None, secondaryAggregation_crossSeriesReducer=None, secondaryAggregation_groupByFields=None, secondaryAggregation_perSeriesAligner=None, view=None, x__xgafv=None)

Lists time series that match a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.html b/docs/dyn/monitoring_v3.html index 12c1117a59..f5fa619b84 100644 --- a/docs/dyn/monitoring_v3.html +++ b/docs/dyn/monitoring_v3.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/monitoring_v3.organizations.timeSeries.html b/docs/dyn/monitoring_v3.organizations.timeSeries.html index d81838fb3d..77c8a67194 100644 --- a/docs/dyn/monitoring_v3.organizations.timeSeries.html +++ b/docs/dyn/monitoring_v3.organizations.timeSeries.html @@ -81,7 +81,7 @@

Instance Methods

list(name, aggregation_alignmentPeriod=None, aggregation_crossSeriesReducer=None, aggregation_groupByFields=None, aggregation_perSeriesAligner=None, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, secondaryAggregation_alignmentPeriod=None, secondaryAggregation_crossSeriesReducer=None, secondaryAggregation_groupByFields=None, secondaryAggregation_perSeriesAligner=None, view=None, x__xgafv=None)

Lists time series that match a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -294,17 +294,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.alertPolicies.html b/docs/dyn/monitoring_v3.projects.alertPolicies.html index 0c5c833a75..f427100e4a 100644 --- a/docs/dyn/monitoring_v3.projects.alertPolicies.html +++ b/docs/dyn/monitoring_v3.projects.alertPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing alerting policies for the workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -858,17 +858,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.projects.alerts.html b/docs/dyn/monitoring_v3.projects.alerts.html index 23c9127ad8..aa3cac2bb8 100644 --- a/docs/dyn/monitoring_v3.projects.alerts.html +++ b/docs/dyn/monitoring_v3.projects.alerts.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing alerts for the metrics scope of the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.groups.html b/docs/dyn/monitoring_v3.projects.groups.html index f2bfa091af..634709cf13 100644 --- a/docs/dyn/monitoring_v3.projects.groups.html +++ b/docs/dyn/monitoring_v3.projects.groups.html @@ -95,7 +95,7 @@

Instance Methods

list(name, ancestorsOfGroup=None, childrenOfGroup=None, descendantsOfGroup=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(name, body=None, validateOnly=None, x__xgafv=None)

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.projects.groups.members.html b/docs/dyn/monitoring_v3.projects.groups.members.html index 1fd5db1559..e895edd594 100644 --- a/docs/dyn/monitoring_v3.projects.groups.members.html +++ b/docs/dyn/monitoring_v3.projects.groups.members.html @@ -81,7 +81,7 @@

Instance Methods

list(name, filter=None, interval_endTime=None, interval_startTime=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the monitored resources that are members of a group.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.metricDescriptors.html b/docs/dyn/monitoring_v3.projects.metricDescriptors.html index 5f1fe20e09..1151223c4f 100644 --- a/docs/dyn/monitoring_v3.projects.metricDescriptors.html +++ b/docs/dyn/monitoring_v3.projects.metricDescriptors.html @@ -90,7 +90,7 @@

Instance Methods

list(name, activeOnly=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists metric descriptors that match a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.monitoredResourceDescriptors.html b/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html index ebe45c69d5..75e6944c87 100644 --- a/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html +++ b/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists monitored resource descriptors that match a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.notificationChannelDescriptors.html b/docs/dyn/monitoring_v3.projects.notificationChannelDescriptors.html index fc299c4ff9..af1a2b7732 100644 --- a/docs/dyn/monitoring_v3.projects.notificationChannelDescriptors.html +++ b/docs/dyn/monitoring_v3.projects.notificationChannelDescriptors.html @@ -84,7 +84,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/monitoring_v3.projects.notificationChannels.html b/docs/dyn/monitoring_v3.projects.notificationChannels.html index eab1103bb4..32c9655189 100644 --- a/docs/dyn/monitoring_v3.projects.notificationChannels.html +++ b/docs/dyn/monitoring_v3.projects.notificationChannels.html @@ -93,7 +93,7 @@

Instance Methods

list(name, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the notification channels that have been created for the project. To list the types of notification channels that are supported, use the ListNotificationChannelDescriptors method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -315,17 +315,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.projects.snoozes.html b/docs/dyn/monitoring_v3.projects.snoozes.html index 09fbdc79e9..3ec6f4f533 100644 --- a/docs/dyn/monitoring_v3.projects.snoozes.html +++ b/docs/dyn/monitoring_v3.projects.snoozes.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Snoozes associated with a project. Can optionally pass in filter, which specifies predicates to match Snoozes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -215,17 +215,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.projects.timeSeries.html b/docs/dyn/monitoring_v3.projects.timeSeries.html index 0190a64255..690ca69f83 100644 --- a/docs/dyn/monitoring_v3.projects.timeSeries.html +++ b/docs/dyn/monitoring_v3.projects.timeSeries.html @@ -87,13 +87,13 @@

Instance Methods

list(name, aggregation_alignmentPeriod=None, aggregation_crossSeriesReducer=None, aggregation_groupByFields=None, aggregation_perSeriesAligner=None, filter=None, interval_endTime=None, interval_startTime=None, orderBy=None, pageSize=None, pageToken=None, secondaryAggregation_alignmentPeriod=None, secondaryAggregation_crossSeriesReducer=None, secondaryAggregation_groupByFields=None, secondaryAggregation_perSeriesAligner=None, view=None, x__xgafv=None)

Lists time series that match a filter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

query(name, body=None, x__xgafv=None)

Queries time series by using Monitoring Query Language (MQL). We recommend using PromQL instead of MQL. For more information about the status of MQL, see the MQL deprecation notice (https://cloud.google.com/stackdriver/docs/deprecations/mql).

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -518,17 +518,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -655,17 +655,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/monitoring_v3.projects.uptimeCheckConfigs.html b/docs/dyn/monitoring_v3.projects.uptimeCheckConfigs.html index 7f02f697c2..217be5449f 100644 --- a/docs/dyn/monitoring_v3.projects.uptimeCheckConfigs.html +++ b/docs/dyn/monitoring_v3.projects.uptimeCheckConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing valid Uptime check configurations for the project (leaving out any invalid configurations).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -553,17 +553,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.services.html b/docs/dyn/monitoring_v3.services.html index 45a116915f..a017a082eb 100644 --- a/docs/dyn/monitoring_v3.services.html +++ b/docs/dyn/monitoring_v3.services.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Services for this Metrics Scope.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -446,17 +446,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.services.serviceLevelObjectives.html b/docs/dyn/monitoring_v3.services.serviceLevelObjectives.html index e80813dc2c..850b11ede4 100644 --- a/docs/dyn/monitoring_v3.services.serviceLevelObjectives.html +++ b/docs/dyn/monitoring_v3.services.serviceLevelObjectives.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List the ServiceLevelObjectives for the given Service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -563,17 +563,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/monitoring_v3.uptimeCheckIps.html b/docs/dyn/monitoring_v3.uptimeCheckIps.html index 5c20d1b4f5..41ae3babc3 100644 --- a/docs/dyn/monitoring_v3.uptimeCheckIps.html +++ b/docs/dyn/monitoring_v3.uptimeCheckIps.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of IP addresses that checkers run from.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/mybusinessaccountmanagement_v1.accounts.html b/docs/dyn/mybusinessaccountmanagement_v1.accounts.html index c98f5a9d6b..45a8b34b58 100644 --- a/docs/dyn/mybusinessaccountmanagement_v1.accounts.html +++ b/docs/dyn/mybusinessaccountmanagement_v1.accounts.html @@ -97,7 +97,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, parentAccount=None, x__xgafv=None)

Lists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management rights.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/mybusinessaccountmanagement_v1.html b/docs/dyn/mybusinessaccountmanagement_v1.html index 01e9c4e496..c63a1eb32b 100644 --- a/docs/dyn/mybusinessaccountmanagement_v1.html +++ b/docs/dyn/mybusinessaccountmanagement_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html b/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html index 0ff70255c7..fd0c51b9c4 100644 --- a/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html +++ b/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Lists the locations for the specified account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -817,17 +817,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/mybusinessbusinessinformation_v1.attributes.html b/docs/dyn/mybusinessbusinessinformation_v1.attributes.html index 3e5e073d55..83dfb7e61a 100644 --- a/docs/dyn/mybusinessbusinessinformation_v1.attributes.html +++ b/docs/dyn/mybusinessbusinessinformation_v1.attributes.html @@ -81,7 +81,7 @@

Instance Methods

list(categoryName=None, languageCode=None, pageSize=None, pageToken=None, parent=None, regionCode=None, showAll=None, x__xgafv=None)

Returns the list of attributes that would be available for a location with the given primary category and country.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/mybusinessbusinessinformation_v1.categories.html b/docs/dyn/mybusinessbusinessinformation_v1.categories.html index 9e88b30de4..7bd489e522 100644 --- a/docs/dyn/mybusinessbusinessinformation_v1.categories.html +++ b/docs/dyn/mybusinessbusinessinformation_v1.categories.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, languageCode=None, pageSize=None, pageToken=None, regionCode=None, view=None, x__xgafv=None)

Returns a list of business categories. Search will match the category name but not the category ID. Search only matches the front of a category name (that is, 'food' may return 'Food Court' but not 'Fast Food Restaurant').

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -184,17 +184,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/mybusinessbusinessinformation_v1.html b/docs/dyn/mybusinessbusinessinformation_v1.html index 5d813f9a78..2361fa06f7 100644 --- a/docs/dyn/mybusinessbusinessinformation_v1.html +++ b/docs/dyn/mybusinessbusinessinformation_v1.html @@ -108,7 +108,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -117,20 +117,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinesslodging_v1.html b/docs/dyn/mybusinesslodging_v1.html index 1ab5202cc9..747b260323 100644 --- a/docs/dyn/mybusinesslodging_v1.html +++ b/docs/dyn/mybusinesslodging_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinessnotifications_v1.html b/docs/dyn/mybusinessnotifications_v1.html index 94179cee9c..ae000bf786 100644 --- a/docs/dyn/mybusinessnotifications_v1.html +++ b/docs/dyn/mybusinessnotifications_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinessplaceactions_v1.html b/docs/dyn/mybusinessplaceactions_v1.html index dc23866580..6810212d4d 100644 --- a/docs/dyn/mybusinessplaceactions_v1.html +++ b/docs/dyn/mybusinessplaceactions_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinessplaceactions_v1.locations.placeActionLinks.html b/docs/dyn/mybusinessplaceactions_v1.locations.placeActionLinks.html index e26a4084a2..b8eeda95a7 100644 --- a/docs/dyn/mybusinessplaceactions_v1.locations.placeActionLinks.html +++ b/docs/dyn/mybusinessplaceactions_v1.locations.placeActionLinks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the place action links for the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/mybusinessplaceactions_v1.placeActionTypeMetadata.html b/docs/dyn/mybusinessplaceactions_v1.placeActionTypeMetadata.html index b80767cf08..1622142758 100644 --- a/docs/dyn/mybusinessplaceactions_v1.placeActionTypeMetadata.html +++ b/docs/dyn/mybusinessplaceactions_v1.placeActionTypeMetadata.html @@ -81,7 +81,7 @@

Instance Methods

list(filter=None, languageCode=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of available place action types for a location or country.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -118,17 +118,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/mybusinessverifications_v1.html b/docs/dyn/mybusinessverifications_v1.html index 50ee4a2c7c..136fdd18ce 100644 --- a/docs/dyn/mybusinessverifications_v1.html +++ b/docs/dyn/mybusinessverifications_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/mybusinessverifications_v1.locations.verifications.html b/docs/dyn/mybusinessverifications_v1.locations.verifications.html index d1bc89f380..24a131ac45 100644 --- a/docs/dyn/mybusinessverifications_v1.locations.verifications.html +++ b/docs/dyn/mybusinessverifications_v1.locations.verifications.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List verifications of a location, ordered by create time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -155,17 +155,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1.html b/docs/dyn/netapp_v1.html index ec6c56af0c..8f43ab24a3 100644 --- a/docs/dyn/netapp_v1.html +++ b/docs/dyn/netapp_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/netapp_v1.projects.locations.activeDirectories.html b/docs/dyn/netapp_v1.projects.locations.activeDirectories.html index 38b578fafa..090de7e67a 100644 --- a/docs/dyn/netapp_v1.projects.locations.activeDirectories.html +++ b/docs/dyn/netapp_v1.projects.locations.activeDirectories.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists active directories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -317,17 +317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.backupPolicies.html b/docs/dyn/netapp_v1.projects.locations.backupPolicies.html index ea6124457f..af481a6795 100644 --- a/docs/dyn/netapp_v1.projects.locations.backupPolicies.html +++ b/docs/dyn/netapp_v1.projects.locations.backupPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all available backup policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.backupVaults.backups.html b/docs/dyn/netapp_v1.projects.locations.backupVaults.backups.html index d1322fc1c7..42105d155d 100644 --- a/docs/dyn/netapp_v1.projects.locations.backupVaults.backups.html +++ b/docs/dyn/netapp_v1.projects.locations.backupVaults.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all backups for a backupVault.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -293,17 +293,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.backupVaults.html b/docs/dyn/netapp_v1.projects.locations.backupVaults.html index 97a37b3b02..028830bef4 100644 --- a/docs/dyn/netapp_v1.projects.locations.backupVaults.html +++ b/docs/dyn/netapp_v1.projects.locations.backupVaults.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all available backup vaults.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.hostGroups.html b/docs/dyn/netapp_v1.projects.locations.hostGroups.html index 1a5e9454e3..809580dc62 100644 --- a/docs/dyn/netapp_v1.projects.locations.hostGroups.html +++ b/docs/dyn/netapp_v1.projects.locations.hostGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of host groups in a `location`. Use `-` as location to list host groups across all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.html b/docs/dyn/netapp_v1.projects.locations.html index 1bf3875d94..d8b967556f 100644 --- a/docs/dyn/netapp_v1.projects.locations.html +++ b/docs/dyn/netapp_v1.projects.locations.html @@ -124,7 +124,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1.projects.locations.kmsConfigs.html b/docs/dyn/netapp_v1.projects.locations.kmsConfigs.html index afc3571449..4c03f4ad97 100644 --- a/docs/dyn/netapp_v1.projects.locations.kmsConfigs.html +++ b/docs/dyn/netapp_v1.projects.locations.kmsConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all KMS configs owned by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.operations.html b/docs/dyn/netapp_v1.projects.locations.operations.html index ba69237da4..43e9e6de43 100644 --- a/docs/dyn/netapp_v1.projects.locations.operations.html +++ b/docs/dyn/netapp_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1.projects.locations.storagePools.backupConfigs.html b/docs/dyn/netapp_v1.projects.locations.storagePools.backupConfigs.html index f2dcaba7a1..0dd524d7c4 100644 --- a/docs/dyn/netapp_v1.projects.locations.storagePools.backupConfigs.html +++ b/docs/dyn/netapp_v1.projects.locations.storagePools.backupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists backup configurations for all volumes in an ONTAP-mode Storage Pool.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1.projects.locations.storagePools.html b/docs/dyn/netapp_v1.projects.locations.storagePools.html index 1ddb45a3d9..ebfac2ff1f 100644 --- a/docs/dyn/netapp_v1.projects.locations.storagePools.html +++ b/docs/dyn/netapp_v1.projects.locations.storagePools.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all storage pools owned by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.volumes.html b/docs/dyn/netapp_v1.projects.locations.volumes.html index 0f2fc12ff5..c1a024c8bf 100644 --- a/docs/dyn/netapp_v1.projects.locations.volumes.html +++ b/docs/dyn/netapp_v1.projects.locations.volumes.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Volumes in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -851,17 +851,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.volumes.quotaRules.html b/docs/dyn/netapp_v1.projects.locations.volumes.quotaRules.html index dd47ecb95e..110dda7e72 100644 --- a/docs/dyn/netapp_v1.projects.locations.volumes.quotaRules.html +++ b/docs/dyn/netapp_v1.projects.locations.volumes.quotaRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all quota rules in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.volumes.replications.html b/docs/dyn/netapp_v1.projects.locations.volumes.replications.html index 3db223780c..ec95903aef 100644 --- a/docs/dyn/netapp_v1.projects.locations.volumes.replications.html +++ b/docs/dyn/netapp_v1.projects.locations.volumes.replications.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all replications for a volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -442,17 +442,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1.projects.locations.volumes.snapshots.html b/docs/dyn/netapp_v1.projects.locations.volumes.snapshots.html index 91321de603..e00da08c67 100644 --- a/docs/dyn/netapp_v1.projects.locations.volumes.snapshots.html +++ b/docs/dyn/netapp_v1.projects.locations.volumes.snapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all snapshots for a volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.html b/docs/dyn/netapp_v1beta1.html index 568e4350b8..f2c5071d91 100644 --- a/docs/dyn/netapp_v1beta1.html +++ b/docs/dyn/netapp_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/netapp_v1beta1.projects.locations.activeDirectories.html b/docs/dyn/netapp_v1beta1.projects.locations.activeDirectories.html index 4275b88f02..167b36e0de 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.activeDirectories.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.activeDirectories.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists active directories.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -317,17 +317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.backupPolicies.html b/docs/dyn/netapp_v1beta1.projects.locations.backupPolicies.html index 2675de3ab2..e4face7633 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.backupPolicies.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.backupPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all available backup policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.backups.html b/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.backups.html index 7891d9f3d7..5229c99606 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.backups.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all backups for a backupVault.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -293,17 +293,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.html b/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.html index 6961801a20..9d96316ef1 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.backupVaults.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all available backup vaults.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.hostGroups.html b/docs/dyn/netapp_v1beta1.projects.locations.hostGroups.html index e9f6c8e70e..5e1e028e5f 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.hostGroups.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.hostGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of host groups in a `location`. Use `-` as location to list host groups across all locations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.html b/docs/dyn/netapp_v1beta1.projects.locations.html index 5b382beb5e..d8579e80ca 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.html @@ -124,7 +124,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1beta1.projects.locations.kmsConfigs.html b/docs/dyn/netapp_v1beta1.projects.locations.kmsConfigs.html index b61502e021..add345472b 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.kmsConfigs.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.kmsConfigs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all KMS configs owned by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.operations.html b/docs/dyn/netapp_v1beta1.projects.locations.operations.html index fd5524037b..2f7fce88b3 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.operations.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1beta1.projects.locations.storagePools.backupConfigs.html b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.backupConfigs.html index 7375bad31b..8adf783f93 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.storagePools.backupConfigs.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.backupConfigs.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists backup configurations for all volumes in an ONTAP-mode Storage Pool.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/netapp_v1beta1.projects.locations.storagePools.html b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html index 48fc7e7f78..53d4945401 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all storage pools owned by the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.volumes.html b/docs/dyn/netapp_v1beta1.projects.locations.volumes.html index 19f356237f..44fa35ff8a 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.volumes.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.volumes.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Volumes in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -851,17 +851,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.volumes.quotaRules.html b/docs/dyn/netapp_v1beta1.projects.locations.volumes.quotaRules.html index bd3c5380fa..a5a38c75ae 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.volumes.quotaRules.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.volumes.quotaRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of all quota rules in a location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.volumes.replications.html b/docs/dyn/netapp_v1beta1.projects.locations.volumes.replications.html index 8a4f68312f..9131dabf4d 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.volumes.replications.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.volumes.replications.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all replications for a volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -442,17 +442,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/netapp_v1beta1.projects.locations.volumes.snapshots.html b/docs/dyn/netapp_v1beta1.projects.locations.volumes.snapshots.html index 6c6724d084..2536feddc6 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.volumes.snapshots.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.volumes.snapshots.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns descriptions of all snapshots for a volume.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.html b/docs/dyn/networkconnectivity_v1.html index 3018a76062..b4ef8b507e 100644 --- a/docs/dyn/networkconnectivity_v1.html +++ b/docs/dyn/networkconnectivity_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.automatedDnsRecords.html b/docs/dyn/networkconnectivity_v1.projects.locations.automatedDnsRecords.html index 091aab115b..8f95e73a8d 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.automatedDnsRecords.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.automatedDnsRecords.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AutomatedDnsRecords in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -327,17 +327,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.global_.hubs.groups.html b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.groups.html index 002ef9c529..3966fdcebc 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.groups.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.groups.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists groups in a given hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.html b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.html index ff359101c7..dc8c5493bf 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.html @@ -112,10 +112,10 @@

Instance Methods

listSpokes(name, filter=None, orderBy=None, pageSize=None, pageToken=None, spokeLocations=None, view=None, x__xgafv=None)

Lists the Network Connectivity Center spokes associated with a specified hub and location. The list includes both spokes that are attached to the hub and spokes that have been proposed but not yet accepted.

- listSpokes_next(previous_request, previous_response)

+ listSpokes_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -124,7 +124,7 @@

Instance Methods

queryStatus(name, filter=None, groupBy=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Query the Private Service Connect propagation status of a Network Connectivity Center hub.

- queryStatus_next(previous_request, previous_response)

+ queryStatus_next()

Retrieves the next page of results.

rejectSpoke(name, body=None, x__xgafv=None)

@@ -697,31 +697,31 @@

Method Details

- listSpokes_next(previous_request, previous_response) + listSpokes_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -848,17 +848,17 @@

Method Details

- queryStatus_next(previous_request, previous_response) + queryStatus_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.html b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.html index 6402459541..cb7715a6b9 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists route tables in a given hub.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.routes.html b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.routes.html index 085dcf8aed..b52387cfeb 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.routes.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.global_.hubs.routeTables.routes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists routes in a given route table.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.global_.policyBasedRoutes.html b/docs/dyn/networkconnectivity_v1.projects.locations.global_.policyBasedRoutes.html index 71d0b95590..93938cfe9c 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.global_.policyBasedRoutes.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.global_.policyBasedRoutes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists policy-based routes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -391,17 +391,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.html b/docs/dyn/networkconnectivity_v1.projects.locations.html index a91ea5b21e..98627f6db8 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.html @@ -162,7 +162,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.internalRanges.html b/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html index 5c92ede610..42284cf117 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists internal ranges in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -385,17 +385,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.destinations.html b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.destinations.html index 867d74cb3f..89109bf634 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.destinations.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.destinations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the `Destination` resources in a specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -309,17 +309,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.html b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.html index c685209492..bddfe89d08 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists the `MulticloudDataTransferConfig` resources in a specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -299,17 +299,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferSupportedServices.html b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferSupportedServices.html index 006c308d6a..7354dcc3c5 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferSupportedServices.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.multicloudDataTransferSupportedServices.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the services in the project for a region that are supported for Data Transfer Essentials.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.operations.html b/docs/dyn/networkconnectivity_v1.projects.locations.operations.html index dd9a0837e6..0ffed57857 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.operations.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.pscAuthorizationPolicies.html b/docs/dyn/networkconnectivity_v1.projects.locations.pscAuthorizationPolicies.html index 5a5fc57bde..fa5f2b2e34 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.pscAuthorizationPolicies.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.pscAuthorizationPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists PscAuthorizationPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.regionalEndpoints.html b/docs/dyn/networkconnectivity_v1.projects.locations.regionalEndpoints.html index 1dc9ecf1f5..7e41c8f4b5 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.regionalEndpoints.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.regionalEndpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists RegionalEndpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.remoteTransportProfiles.html b/docs/dyn/networkconnectivity_v1.projects.locations.remoteTransportProfiles.html index 1cf477c338..58788da294 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.remoteTransportProfiles.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.remoteTransportProfiles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists RemoteTransportProfiles in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -169,17 +169,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.serviceClasses.html b/docs/dyn/networkconnectivity_v1.projects.locations.serviceClasses.html index 5a5038beaa..e6ee9285f0 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.serviceClasses.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.serviceClasses.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceClasses in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionMaps.html b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionMaps.html index dc6dee9369..ab41f023fd 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionMaps.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionMaps.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceConnectionMaps in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -491,17 +491,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionPolicies.html b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionPolicies.html index a254b8c68d..525d9ebfdb 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionPolicies.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceConnectionPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -429,17 +429,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionTokens.html b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionTokens.html index 34b4f18148..fcbe8632c5 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionTokens.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.serviceConnectionTokens.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceConnectionTokens in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1.projects.locations.spokes.gatewayAdvertisedRoutes.html b/docs/dyn/networkconnectivity_v1.projects.locations.spokes.gatewayAdvertisedRoutes.html index 7a3454830c..aaff2a5227 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.spokes.gatewayAdvertisedRoutes.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.spokes.gatewayAdvertisedRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List GatewayAdvertisedRoutes

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.spokes.html b/docs/dyn/networkconnectivity_v1.projects.locations.spokes.html index 7a8dc587e4..9462bf8064 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.spokes.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.spokes.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Network Connectivity Center spokes in a specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -684,17 +684,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.transports.html b/docs/dyn/networkconnectivity_v1.projects.locations.transports.html index 27c0f8eec1..5e0a2703ef 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.transports.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.transports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Transports in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1alpha1.html b/docs/dyn/networkconnectivity_v1alpha1.html index 9cb959c343..f46ff5d694 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.html +++ b/docs/dyn/networkconnectivity_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.global_.hubs.html b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.global_.hubs.html index 7300305420..850c873ecc 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.global_.hubs.html +++ b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.global_.hubs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Network Connectivity Center hubs associated with a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -322,17 +322,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.html b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.html index bdf17457c6..cc926b7ea1 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.html +++ b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1alpha1.projects.locations.internalRanges.html b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.internalRanges.html index 128fc069ac..cd9b27457b 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.internalRanges.html +++ b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.internalRanges.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists internal ranges in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.operations.html b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.operations.html index 33572bdf24..aeac0edd27 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkconnectivity_v1alpha1.projects.locations.spokes.html b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.spokes.html index 02f7a205d9..672092bd87 100644 --- a/docs/dyn/networkconnectivity_v1alpha1.projects.locations.spokes.html +++ b/docs/dyn/networkconnectivity_v1alpha1.projects.locations.spokes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Network Connectivity Center spokes in a specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -355,17 +355,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkmanagement_v1.html b/docs/dyn/networkmanagement_v1.html index bd908793a7..211ae6aad6 100644 --- a/docs/dyn/networkmanagement_v1.html +++ b/docs/dyn/networkmanagement_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkmanagement_v1.organizations.locations.global_.operations.html b/docs/dyn/networkmanagement_v1.organizations.locations.global_.operations.html index 9ae6eea725..5073469254 100644 --- a/docs/dyn/networkmanagement_v1.organizations.locations.global_.operations.html +++ b/docs/dyn/networkmanagement_v1.organizations.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.organizations.locations.html b/docs/dyn/networkmanagement_v1.organizations.locations.html index f4cbdaa226..2c8b8972ed 100644 --- a/docs/dyn/networkmanagement_v1.organizations.locations.html +++ b/docs/dyn/networkmanagement_v1.organizations.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.organizations.locations.vpcFlowLogsConfigs.html b/docs/dyn/networkmanagement_v1.organizations.locations.vpcFlowLogsConfigs.html index f81861d302..10a1a30247 100644 --- a/docs/dyn/networkmanagement_v1.organizations.locations.vpcFlowLogsConfigs.html +++ b/docs/dyn/networkmanagement_v1.organizations.locations.vpcFlowLogsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all `VpcFlowLogsConfigs` in a given organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html index 2d5348ef2a..5e7177b683 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Connectivity Tests owned by a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2954,17 +2954,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkmanagement_v1.projects.locations.global_.operations.html b/docs/dyn/networkmanagement_v1.projects.locations.global_.operations.html index 4a6b138d1e..39b93ef15c 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.global_.operations.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.html b/docs/dyn/networkmanagement_v1.projects.locations.html index 5e5c99f740..c3c8b0ca12 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.networkMonitoringProviders.html b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.html index 9992049c0f..686a1aa1d6 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists NetworkMonitoringProviders for a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -310,17 +310,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html index 28cee46108..c6a22f524b 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists MonitoringPoints for a given network monitoring provider.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -345,17 +345,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.networkMonitoringProviders.networkPaths.html b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.networkPaths.html index 9e5ae07e96..529862fe16 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.networkPaths.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.networkPaths.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists NetworkPaths for a given network monitoring provider.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.networkMonitoringProviders.webPaths.html b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.webPaths.html index da85a48c52..fd96cd1422 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.webPaths.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.webPaths.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists WebPaths for a given network monitoring provider.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1.projects.locations.vpcFlowLogsConfigs.html b/docs/dyn/networkmanagement_v1.projects.locations.vpcFlowLogsConfigs.html index 8afdee9084..befb623387 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.vpcFlowLogsConfigs.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.vpcFlowLogsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all `VpcFlowLogsConfigs` in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -99,13 +99,13 @@

Instance Methods

queryOrgVpcFlowLogsConfigs(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

QueryOrgVpcFlowLogsConfigs returns a list of all organization-level VPC Flow Logs configurations applicable to the specified project.

- queryOrgVpcFlowLogsConfigs_next(previous_request, previous_response)

+ queryOrgVpcFlowLogsConfigs_next()

Retrieves the next page of results.

showEffectiveFlowLogsConfigs(parent, filter=None, pageSize=None, pageToken=None, resource=None, x__xgafv=None)

ShowEffectiveFlowLogsConfigs returns a list of all VPC Flow Logs configurations applicable to a specified resource.

- showEffectiveFlowLogsConfigs_next(previous_request, previous_response)

+ showEffectiveFlowLogsConfigs_next()

Retrieves the next page of results.

Method Details

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -429,17 +429,17 @@

Method Details

- queryOrgVpcFlowLogsConfigs_next(previous_request, previous_response) + queryOrgVpcFlowLogsConfigs_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)
+        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.
-
+ 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. +
@@ -488,17 +488,17 @@

Method Details

- showEffectiveFlowLogsConfigs_next(previous_request, previous_response) + showEffectiveFlowLogsConfigs_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)
+        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.
-
+ 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/networkmanagement_v1beta1.html b/docs/dyn/networkmanagement_v1beta1.html index 16a6806881..70b5277fcd 100644 --- a/docs/dyn/networkmanagement_v1beta1.html +++ b/docs/dyn/networkmanagement_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkmanagement_v1beta1.organizations.locations.global_.operations.html b/docs/dyn/networkmanagement_v1beta1.organizations.locations.global_.operations.html index df78eaf2f5..b8523f6876 100644 --- a/docs/dyn/networkmanagement_v1beta1.organizations.locations.global_.operations.html +++ b/docs/dyn/networkmanagement_v1beta1.organizations.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1beta1.organizations.locations.html b/docs/dyn/networkmanagement_v1beta1.organizations.locations.html index c30df96693..d0ec391464 100644 --- a/docs/dyn/networkmanagement_v1beta1.organizations.locations.html +++ b/docs/dyn/networkmanagement_v1beta1.organizations.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1beta1.organizations.locations.vpcFlowLogsConfigs.html b/docs/dyn/networkmanagement_v1beta1.organizations.locations.vpcFlowLogsConfigs.html index 7bf2625da6..a0473d6d3b 100644 --- a/docs/dyn/networkmanagement_v1beta1.organizations.locations.vpcFlowLogsConfigs.html +++ b/docs/dyn/networkmanagement_v1beta1.organizations.locations.vpcFlowLogsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all `VpcFlowLogsConfigs` in a given organization.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -290,17 +290,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html index 68327dacea..cdfd74fbe8 100644 --- a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html +++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Connectivity Tests owned by a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2960,17 +2960,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.operations.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.operations.html index d37deeda70..18e65eb129 100644 --- a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.operations.html +++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1beta1.projects.locations.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.html index f227780334..92ea24fcfd 100644 --- a/docs/dyn/networkmanagement_v1beta1.projects.locations.html +++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkmanagement_v1beta1.projects.locations.vpcFlowLogsConfigs.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.vpcFlowLogsConfigs.html index fb9cb7f2ba..477150bb3e 100644 --- a/docs/dyn/networkmanagement_v1beta1.projects.locations.vpcFlowLogsConfigs.html +++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.vpcFlowLogsConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all `VpcFlowLogsConfigs` in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -99,13 +99,13 @@

Instance Methods

queryOrgVpcFlowLogsConfigs(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

QueryOrgVpcFlowLogsConfigs returns a list of all organization-level VPC Flow Logs configurations applicable to the specified project.

- queryOrgVpcFlowLogsConfigs_next(previous_request, previous_response)

+ queryOrgVpcFlowLogsConfigs_next()

Retrieves the next page of results.

showEffectiveFlowLogsConfigs(parent, filter=None, pageSize=None, pageToken=None, resource=None, x__xgafv=None)

ShowEffectiveFlowLogsConfigs returns a list of all VPC Flow Logs configurations applicable to a specified resource.

- showEffectiveFlowLogsConfigs_next(previous_request, previous_response)

+ showEffectiveFlowLogsConfigs_next()

Retrieves the next page of results.

Method Details

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -429,17 +429,17 @@

Method Details

- queryOrgVpcFlowLogsConfigs_next(previous_request, previous_response) + queryOrgVpcFlowLogsConfigs_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)
+        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.
-
+ 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. +
@@ -488,17 +488,17 @@

Method Details

- showEffectiveFlowLogsConfigs_next(previous_request, previous_response) + showEffectiveFlowLogsConfigs_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)
+        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.
-
+ 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/networksecurity_v1.html b/docs/dyn/networksecurity_v1.html index cfc7695c2b..73535fd961 100644 --- a/docs/dyn/networksecurity_v1.html +++ b/docs/dyn/networksecurity_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networksecurity_v1.organizations.locations.addressGroups.html b/docs/dyn/networksecurity_v1.organizations.locations.addressGroups.html index 73f4a0f8b6..6dd4b2e50d 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.addressGroups.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.addressGroups.html @@ -99,10 +99,10 @@

Instance Methods

listReferences(addressGroup, pageSize=None, pageToken=None, x__xgafv=None)

Lists references of an address group.

- listReferences_next(previous_request, previous_response)

+ listReferences_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -410,31 +410,31 @@

Method Details

- listReferences_next(previous_request, previous_response) + listReferences_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.organizations.locations.firewallEndpoints.html b/docs/dyn/networksecurity_v1.organizations.locations.firewallEndpoints.html index f450810333..b95bac56c1 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.firewallEndpoints.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.firewallEndpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists FirewallEndpoints in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.organizations.locations.html b/docs/dyn/networksecurity_v1.organizations.locations.html index 1b227f65e3..c68d0d2954 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.organizations.locations.operations.html b/docs/dyn/networksecurity_v1.organizations.locations.operations.html index d3b44b7da7..f287a92ffd 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.operations.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.organizations.locations.securityProfileGroups.html b/docs/dyn/networksecurity_v1.organizations.locations.securityProfileGroups.html index 7d7eb412d3..d4d792fb1a 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.securityProfileGroups.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.securityProfileGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfileGroups in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.organizations.locations.securityProfiles.html b/docs/dyn/networksecurity_v1.organizations.locations.securityProfiles.html index ef10101e4d..82caacf1bd 100644 --- a/docs/dyn/networksecurity_v1.organizations.locations.securityProfiles.html +++ b/docs/dyn/networksecurity_v1.organizations.locations.securityProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfiles in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.addressGroups.html b/docs/dyn/networksecurity_v1.projects.locations.addressGroups.html index d31f813821..ee540ad8c6 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.addressGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.addressGroups.html @@ -102,10 +102,10 @@

Instance Methods

listReferences(addressGroup, pageSize=None, pageToken=None, x__xgafv=None)

Lists references of an address group.

- listReferences_next(previous_request, previous_response)

+ listReferences_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -464,31 +464,31 @@

Method Details

- listReferences_next(previous_request, previous_response) + listReferences_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.authorizationPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.authorizationPolicies.html index f37408350c..07903d8feb 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.authorizationPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.authorizationPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists AuthorizationPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -396,17 +396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html index a776613831..eac2623a46 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AuthzPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1648,17 +1648,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html b/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html index 057337add2..fc56674a08 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html +++ b/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists BackendAuthenticationConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html index ec8c56ecd3..8a2cbff561 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ClientTlsPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.dnsThreatDetectors.html b/docs/dyn/networksecurity_v1.projects.locations.dnsThreatDetectors.html index 4b4ca4ae7c..12c04e99a3 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.dnsThreatDetectors.html +++ b/docs/dyn/networksecurity_v1.projects.locations.dnsThreatDetectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DnsThreatDetectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.firewallEndpointAssociations.html b/docs/dyn/networksecurity_v1.projects.locations.firewallEndpointAssociations.html index fc8f50f604..491151e3d9 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.firewallEndpointAssociations.html +++ b/docs/dyn/networksecurity_v1.projects.locations.firewallEndpointAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Associations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.firewallEndpoints.html b/docs/dyn/networksecurity_v1.projects.locations.firewallEndpoints.html index acb3c6da49..c9a4a6be69 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.firewallEndpoints.html +++ b/docs/dyn/networksecurity_v1.projects.locations.firewallEndpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists FirewallEndpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.html index 50daca1c63..0aed5e949a 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists GatewaySecurityPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -245,17 +245,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.rules.html b/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.rules.html index 395ba05689..47e08d139e 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.rules.html +++ b/docs/dyn/networksecurity_v1.projects.locations.gatewaySecurityPolicies.rules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists GatewaySecurityPolicyRules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.html b/docs/dyn/networksecurity_v1.projects.locations.html index 2d5f9dc274..ab03dfc70e 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.html +++ b/docs/dyn/networksecurity_v1.projects.locations.html @@ -209,7 +209,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.projects.locations.interceptDeploymentGroups.html b/docs/dyn/networksecurity_v1.projects.locations.interceptDeploymentGroups.html index f86a32fedb..f1c3269edb 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.interceptDeploymentGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.interceptDeploymentGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployment groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.interceptDeployments.html b/docs/dyn/networksecurity_v1.projects.locations.interceptDeployments.html index 0358ef8f6a..a1a76c9e98 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.interceptDeployments.html +++ b/docs/dyn/networksecurity_v1.projects.locations.interceptDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroupAssociations.html b/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroupAssociations.html index c56ef439c5..eebe4939e4 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroupAssociations.html +++ b/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroupAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists associations in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroups.html b/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroups.html index 1a35b79329..562a6bab66 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.interceptEndpointGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists endpoint groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.mirroringDeploymentGroups.html b/docs/dyn/networksecurity_v1.projects.locations.mirroringDeploymentGroups.html index b28e451eaf..b376be5a90 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.mirroringDeploymentGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.mirroringDeploymentGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployment groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.mirroringDeployments.html b/docs/dyn/networksecurity_v1.projects.locations.mirroringDeployments.html index d0cf099be3..d934d812f7 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.mirroringDeployments.html +++ b/docs/dyn/networksecurity_v1.projects.locations.mirroringDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroupAssociations.html b/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroupAssociations.html index 7c4567e6b2..82f8e0c609 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroupAssociations.html +++ b/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroupAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists associations in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroups.html b/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroups.html index e2abc14f94..9cba8e8ce1 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.mirroringEndpointGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists endpoint groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.operations.html b/docs/dyn/networksecurity_v1.projects.locations.operations.html index 186f0003c3..13e64e19f0 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.operations.html +++ b/docs/dyn/networksecurity_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.projects.locations.sacAttachments.html b/docs/dyn/networksecurity_v1.projects.locations.sacAttachments.html index e9cfcfe2e1..8686e8c02a 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.sacAttachments.html +++ b/docs/dyn/networksecurity_v1.projects.locations.sacAttachments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SACAttachments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.projects.locations.sacRealms.html b/docs/dyn/networksecurity_v1.projects.locations.sacRealms.html index caea23415c..02310a599b 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.sacRealms.html +++ b/docs/dyn/networksecurity_v1.projects.locations.sacRealms.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SACRealms in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1.projects.locations.securityProfileGroups.html b/docs/dyn/networksecurity_v1.projects.locations.securityProfileGroups.html index 0f805138ef..62c1e4fc2c 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.securityProfileGroups.html +++ b/docs/dyn/networksecurity_v1.projects.locations.securityProfileGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfileGroups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.securityProfiles.html b/docs/dyn/networksecurity_v1.projects.locations.securityProfiles.html index d7b3d30fe5..e19ca06e70 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.securityProfiles.html +++ b/docs/dyn/networksecurity_v1.projects.locations.securityProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfiles in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html index 1a41c989bd..7acae640a1 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists ServerTlsPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -373,17 +373,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.tlsInspectionPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.tlsInspectionPolicies.html index 9917f37d4c..213d895c5f 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.tlsInspectionPolicies.html +++ b/docs/dyn/networksecurity_v1.projects.locations.tlsInspectionPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists TlsInspectionPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1.projects.locations.urlLists.html b/docs/dyn/networksecurity_v1.projects.locations.urlLists.html index 6febbbbf16..16e5db4052 100644 --- a/docs/dyn/networksecurity_v1.projects.locations.urlLists.html +++ b/docs/dyn/networksecurity_v1.projects.locations.urlLists.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists UrlLists in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.html b/docs/dyn/networksecurity_v1beta1.html index 385ced6b38..69329bdedf 100644 --- a/docs/dyn/networksecurity_v1beta1.html +++ b/docs/dyn/networksecurity_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networksecurity_v1beta1.organizations.locations.addressGroups.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.addressGroups.html index de27f7832a..ebdf206653 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.addressGroups.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.addressGroups.html @@ -99,10 +99,10 @@

Instance Methods

listReferences(addressGroup, pageSize=None, pageToken=None, x__xgafv=None)

Lists references of an address group.

- listReferences_next(previous_request, previous_response)

+ listReferences_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -410,31 +410,31 @@

Method Details

- listReferences_next(previous_request, previous_response) + listReferences_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.html index f557204e63..e694172817 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists FirewallEndpoints in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -349,17 +349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests.html index 210f8d7399..dac95efe67 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.firewallEndpoints.wildfireVerdictChangeRequests.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists WildfireVerdictChangeRequests in a given Firewall Endpoint in an organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.organizations.locations.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.html index 711bba5b45..82e8f843fb 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.organizations.locations.operations.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.operations.html index 1e1e20780e..8456c54d6e 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.operations.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.organizations.locations.securityProfileGroups.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfileGroups.html index 378fced392..0da785ca48 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfileGroups.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfileGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfileGroups in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfiles.html b/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfiles.html index 84cf9949e7..a5336235a4 100644 --- a/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfiles.html +++ b/docs/dyn/networksecurity_v1beta1.organizations.locations.securityProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfiles in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -586,17 +586,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.addressGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.addressGroups.html index 5ff84d0d91..f45afd62e8 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.addressGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.addressGroups.html @@ -102,10 +102,10 @@

Instance Methods

listReferences(addressGroup, pageSize=None, pageToken=None, x__xgafv=None)

Lists references of an address group.

- listReferences_next(previous_request, previous_response)

+ listReferences_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -464,31 +464,31 @@

Method Details

- listReferences_next(previous_request, previous_response) + listReferences_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.authorizationPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.authorizationPolicies.html index edf1c8860f..e0e6a99ff6 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.authorizationPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.authorizationPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists AuthorizationPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -396,17 +396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html index 505ec14eff..f1305c53bc 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists AuthzPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1648,17 +1648,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.backendAuthenticationConfigs.html b/docs/dyn/networksecurity_v1beta1.projects.locations.backendAuthenticationConfigs.html index 91a3b54838..2094cf1009 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.backendAuthenticationConfigs.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.backendAuthenticationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists BackendAuthenticationConfigs in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -259,17 +259,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.clientTlsPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.clientTlsPolicies.html index 5950120221..42b71e1008 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.clientTlsPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.clientTlsPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ClientTlsPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html index 8d21d141b3..4935cc03fc 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DnsThreatDetectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpointAssociations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpointAssociations.html index fb988abddf..0df0685731 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpointAssociations.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpointAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Associations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.html b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.html index c772e06615..e1053f5653 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists FirewallEndpoints in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -349,17 +349,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests.html b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests.html index fd247bb6a2..c97fa27863 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.firewallEndpoints.wildfireVerdictChangeRequests.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists WildfireVerdictChangeRequests in a given Firewall Endpoint in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.html index 37b57146af..6acd5d7cfc 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists GatewaySecurityPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -245,17 +245,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.rules.html b/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.rules.html index e3b3ef90d7..529dde64aa 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.rules.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.gatewaySecurityPolicies.rules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists GatewaySecurityPolicyRules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.html index 683a9a51c0..babbfafee6 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.html @@ -209,7 +209,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -281,17 +281,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.projects.locations.interceptDeploymentGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeploymentGroups.html index f7d042d4eb..71fd7fe618 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeploymentGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeploymentGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployment groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeployments.html b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeployments.html index a08e5c52ef..6a32dbc752 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeployments.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroupAssociations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroupAssociations.html index 2fd4491ad5..7ab2e5e4e9 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroupAssociations.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroupAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists associations in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroups.html index 08107d30eb..39c8e51364 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.interceptEndpointGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists endpoint groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeploymentGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeploymentGroups.html index 97e0f813ac..917d6cfbc5 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeploymentGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeploymentGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployment groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeployments.html b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeployments.html index 0774d9d88b..4c3bb3210a 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeployments.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -262,17 +262,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroupAssociations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroupAssociations.html index 53f73af261..93b4b2f6a2 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroupAssociations.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroupAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists associations in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroups.html index 7f10b7e84d..5ce822a67f 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.mirroringEndpointGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists endpoint groups in a given project and location. See https://google.aip.dev/132.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -313,17 +313,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.operations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.operations.html index 9fca909124..b2ad0ab4c2 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.operations.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.projects.locations.sacAttachments.html b/docs/dyn/networksecurity_v1beta1.projects.locations.sacAttachments.html index 6a39818006..aefd0000a4 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.sacAttachments.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.sacAttachments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SACAttachments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -272,17 +272,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.projects.locations.sacRealms.html b/docs/dyn/networksecurity_v1beta1.projects.locations.sacRealms.html index 7f9683aa92..f646464270 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.sacRealms.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.sacRealms.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SACRealms in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networksecurity_v1beta1.projects.locations.securityProfileGroups.html b/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfileGroups.html index d072b0a1f6..2b2e94c692 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfileGroups.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfileGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfileGroups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfiles.html b/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfiles.html index dc3b534934..8e0a3d8818 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfiles.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.securityProfiles.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecurityProfiles in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -586,17 +586,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html index 295c525d6f..72a83e33af 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists ServerTlsPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -373,17 +373,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.tlsInspectionPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.tlsInspectionPolicies.html index 9377574eaa..1ea3cdf40e 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.tlsInspectionPolicies.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.tlsInspectionPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists TlsInspectionPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.urlLists.html b/docs/dyn/networksecurity_v1beta1.projects.locations.urlLists.html index e6fa1389a3..1b38a4bf53 100644 --- a/docs/dyn/networksecurity_v1beta1.projects.locations.urlLists.html +++ b/docs/dyn/networksecurity_v1beta1.projects.locations.urlLists.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists UrlLists in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -246,17 +246,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.html b/docs/dyn/networkservices_v1.html index e37cab9bb0..c8b4f6d888 100644 --- a/docs/dyn/networkservices_v1.html +++ b/docs/dyn/networkservices_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkservices_v1.projects.locations.agentConnectivityTemplates.html b/docs/dyn/networkservices_v1.projects.locations.agentConnectivityTemplates.html index fe4005785e..fb5b73b5f4 100644 --- a/docs/dyn/networkservices_v1.projects.locations.agentConnectivityTemplates.html +++ b/docs/dyn/networkservices_v1.projects.locations.agentConnectivityTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists AgentConnectivityTemplates in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.agentGateways.html b/docs/dyn/networkservices_v1.projects.locations.agentGateways.html index 8de5eb48a5..0bdc8a96ba 100644 --- a/docs/dyn/networkservices_v1.projects.locations.agentGateways.html +++ b/docs/dyn/networkservices_v1.projects.locations.agentGateways.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists AgentGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.authzExtensions.html b/docs/dyn/networkservices_v1.projects.locations.authzExtensions.html index 4fa549a4df..fe27d2d323 100644 --- a/docs/dyn/networkservices_v1.projects.locations.authzExtensions.html +++ b/docs/dyn/networkservices_v1.projects.locations.authzExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `AuthzExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.endpointPolicies.html b/docs/dyn/networkservices_v1.projects.locations.endpointPolicies.html index b8d175a5ce..f47e788172 100644 --- a/docs/dyn/networkservices_v1.projects.locations.endpointPolicies.html +++ b/docs/dyn/networkservices_v1.projects.locations.endpointPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists EndpointPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -307,17 +307,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.extensionBindings.html b/docs/dyn/networkservices_v1.projects.locations.extensionBindings.html index 23b34fe0b6..010bdcbe86 100644 --- a/docs/dyn/networkservices_v1.projects.locations.extensionBindings.html +++ b/docs/dyn/networkservices_v1.projects.locations.extensionBindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `ExtensionBinding` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -577,17 +577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.gateways.html b/docs/dyn/networkservices_v1.projects.locations.gateways.html index ab32f17074..cc9876432a 100644 --- a/docs/dyn/networkservices_v1.projects.locations.gateways.html +++ b/docs/dyn/networkservices_v1.projects.locations.gateways.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Gateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -314,17 +314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.gateways.routeViews.html b/docs/dyn/networkservices_v1.projects.locations.gateways.routeViews.html index 2bb94d9c17..8fe9eef72f 100644 --- a/docs/dyn/networkservices_v1.projects.locations.gateways.routeViews.html +++ b/docs/dyn/networkservices_v1.projects.locations.gateways.routeViews.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists RouteViews

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1.projects.locations.grpcRoutes.html b/docs/dyn/networkservices_v1.projects.locations.grpcRoutes.html index 9f2d850c6f..3857a9717f 100644 --- a/docs/dyn/networkservices_v1.projects.locations.grpcRoutes.html +++ b/docs/dyn/networkservices_v1.projects.locations.grpcRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists GrpcRoutes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -427,17 +427,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.html b/docs/dyn/networkservices_v1.projects.locations.html index af70e8ec4e..12a084ddcd 100644 --- a/docs/dyn/networkservices_v1.projects.locations.html +++ b/docs/dyn/networkservices_v1.projects.locations.html @@ -204,7 +204,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -276,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1.projects.locations.httpRoutes.html b/docs/dyn/networkservices_v1.projects.locations.httpRoutes.html index dc0db6e940..feb1d29c7b 100644 --- a/docs/dyn/networkservices_v1.projects.locations.httpRoutes.html +++ b/docs/dyn/networkservices_v1.projects.locations.httpRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists HttpRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -807,17 +807,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.lbEdgeExtensions.html b/docs/dyn/networkservices_v1.projects.locations.lbEdgeExtensions.html index 51f8c1edbe..3ff2800969 100644 --- a/docs/dyn/networkservices_v1.projects.locations.lbEdgeExtensions.html +++ b/docs/dyn/networkservices_v1.projects.locations.lbEdgeExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbEdgeExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.lbRouteExtensions.html b/docs/dyn/networkservices_v1.projects.locations.lbRouteExtensions.html index e5e7a02b87..81f9064590 100644 --- a/docs/dyn/networkservices_v1.projects.locations.lbRouteExtensions.html +++ b/docs/dyn/networkservices_v1.projects.locations.lbRouteExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbRouteExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -367,17 +367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.lbTrafficExtensions.html b/docs/dyn/networkservices_v1.projects.locations.lbTrafficExtensions.html index ced9f68a63..eb1607262b 100644 --- a/docs/dyn/networkservices_v1.projects.locations.lbTrafficExtensions.html +++ b/docs/dyn/networkservices_v1.projects.locations.lbTrafficExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbTrafficExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -367,17 +367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.meshes.html b/docs/dyn/networkservices_v1.projects.locations.meshes.html index ff5381bedf..a3e114b374 100644 --- a/docs/dyn/networkservices_v1.projects.locations.meshes.html +++ b/docs/dyn/networkservices_v1.projects.locations.meshes.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Meshes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.meshes.routeViews.html b/docs/dyn/networkservices_v1.projects.locations.meshes.routeViews.html index 416b0e4828..69c0f3f284 100644 --- a/docs/dyn/networkservices_v1.projects.locations.meshes.routeViews.html +++ b/docs/dyn/networkservices_v1.projects.locations.meshes.routeViews.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists RouteViews

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1.projects.locations.multicastConsumerAssociations.html b/docs/dyn/networkservices_v1.projects.locations.multicastConsumerAssociations.html index aeaf7dd696..61f6c0053a 100644 --- a/docs/dyn/networkservices_v1.projects.locations.multicastConsumerAssociations.html +++ b/docs/dyn/networkservices_v1.projects.locations.multicastConsumerAssociations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists multicast consumer associations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.multicastGroupConsumerActivations.html b/docs/dyn/networkservices_v1.projects.locations.multicastGroupConsumerActivations.html index 34411fdda7..54ec89a31f 100644 --- a/docs/dyn/networkservices_v1.projects.locations.multicastGroupConsumerActivations.html +++ b/docs/dyn/networkservices_v1.projects.locations.multicastGroupConsumerActivations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists multicast group consumer activations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.operations.html b/docs/dyn/networkservices_v1.projects.locations.operations.html index 94df1e3709..6b3c26315f 100644 --- a/docs/dyn/networkservices_v1.projects.locations.operations.html +++ b/docs/dyn/networkservices_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1.projects.locations.producerExtensions.html b/docs/dyn/networkservices_v1.projects.locations.producerExtensions.html index d3020bf8f1..7ee02bc841 100644 --- a/docs/dyn/networkservices_v1.projects.locations.producerExtensions.html +++ b/docs/dyn/networkservices_v1.projects.locations.producerExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `ProducerExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1.projects.locations.serviceBindings.html b/docs/dyn/networkservices_v1.projects.locations.serviceBindings.html index 5805d1985f..187f1faaa5 100644 --- a/docs/dyn/networkservices_v1.projects.locations.serviceBindings.html +++ b/docs/dyn/networkservices_v1.projects.locations.serviceBindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceBinding in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -252,17 +252,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.serviceLbPolicies.html b/docs/dyn/networkservices_v1.projects.locations.serviceLbPolicies.html index 50a72c2eb1..9ad4956587 100644 --- a/docs/dyn/networkservices_v1.projects.locations.serviceLbPolicies.html +++ b/docs/dyn/networkservices_v1.projects.locations.serviceLbPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceLbPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.tcpRoutes.html b/docs/dyn/networkservices_v1.projects.locations.tcpRoutes.html index 037dd39cb7..6b913a42f8 100644 --- a/docs/dyn/networkservices_v1.projects.locations.tcpRoutes.html +++ b/docs/dyn/networkservices_v1.projects.locations.tcpRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists TcpRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -328,17 +328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.tlsRoutes.html b/docs/dyn/networkservices_v1.projects.locations.tlsRoutes.html index 9aaca2170b..e631609f9c 100644 --- a/docs/dyn/networkservices_v1.projects.locations.tlsRoutes.html +++ b/docs/dyn/networkservices_v1.projects.locations.tlsRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists TlsRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.html b/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.html index 244011a099..23f38f9c26 100644 --- a/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.html +++ b/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `WasmPlugin` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.versions.html b/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.versions.html index 083bd98021..7461375422 100644 --- a/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.versions.html +++ b/docs/dyn/networkservices_v1.projects.locations.wasmPlugins.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `WasmPluginVersion` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.html b/docs/dyn/networkservices_v1beta1.html index 0f1783c42a..30e508c372 100644 --- a/docs/dyn/networkservices_v1beta1.html +++ b/docs/dyn/networkservices_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.agentConnectivityTemplates.html b/docs/dyn/networkservices_v1beta1.projects.locations.agentConnectivityTemplates.html index ffa56efcfe..55ec677eb3 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.agentConnectivityTemplates.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.agentConnectivityTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists AgentConnectivityTemplates in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.agentGateways.html b/docs/dyn/networkservices_v1beta1.projects.locations.agentGateways.html index ccc27451b9..b82d1305fb 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.agentGateways.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.agentGateways.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists AgentGateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -357,17 +357,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.authzExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.authzExtensions.html index 1e85009430..45bc97cafd 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.authzExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.authzExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `AuthzExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.cdnEdgeExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.cdnEdgeExtensions.html index 0a6889ab5d..6b978dc44a 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.cdnEdgeExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.cdnEdgeExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `CdnEdgeExtensions` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.endpointPolicies.html b/docs/dyn/networkservices_v1beta1.projects.locations.endpointPolicies.html index f5bb6341c0..ec0c6ea23f 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.endpointPolicies.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.endpointPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists EndpointPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -310,17 +310,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.extensionBindings.html b/docs/dyn/networkservices_v1beta1.projects.locations.extensionBindings.html index 12a2dbe362..a16108fa56 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.extensionBindings.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.extensionBindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `ExtensionBinding` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -577,17 +577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.gateways.html b/docs/dyn/networkservices_v1beta1.projects.locations.gateways.html index dbe73f7caf..b39163614c 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.gateways.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.gateways.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Gateways in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -314,17 +314,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.gateways.routeViews.html b/docs/dyn/networkservices_v1beta1.projects.locations.gateways.routeViews.html index 29c4a27246..d1f58ffd2f 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.gateways.routeViews.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.gateways.routeViews.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists RouteViews

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.projects.locations.grpcRoutes.html b/docs/dyn/networkservices_v1beta1.projects.locations.grpcRoutes.html index 3311f1ea90..ba8c2412ce 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.grpcRoutes.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.grpcRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists GrpcRoutes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -427,17 +427,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.html b/docs/dyn/networkservices_v1beta1.projects.locations.html index 3618dc1cb5..cb130553fc 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.html @@ -189,7 +189,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.projects.locations.httpRoutes.html b/docs/dyn/networkservices_v1beta1.projects.locations.httpRoutes.html index bddbc033c3..b9b21ccaa9 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.httpRoutes.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.httpRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists HttpRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -807,17 +807,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.lbEdgeExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.lbEdgeExtensions.html index 76929cc76d..3c6ee3ba34 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.lbEdgeExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.lbEdgeExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbEdgeExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -361,17 +361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.lbRouteExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.lbRouteExtensions.html index 121cc79843..b5c275cc15 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.lbRouteExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.lbRouteExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbRouteExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html index 7dc24b0dda..ff2626d004 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbTcpExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -361,17 +361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.lbTrafficExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.lbTrafficExtensions.html index 627f266b74..07d2b57dcf 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.lbTrafficExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.lbTrafficExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `LbTrafficExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.meshes.html b/docs/dyn/networkservices_v1beta1.projects.locations.meshes.html index 4a6de762b9..7f720c70f0 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.meshes.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.meshes.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists Meshes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.meshes.routeViews.html b/docs/dyn/networkservices_v1beta1.projects.locations.meshes.routeViews.html index fd6d83c25e..c546daa9ef 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.meshes.routeViews.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.meshes.routeViews.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists RouteViews

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.projects.locations.operations.html b/docs/dyn/networkservices_v1beta1.projects.locations.operations.html index 96de15c185..29b32a478e 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.operations.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.projects.locations.producerExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.producerExtensions.html index 816885fe22..dc5b040f60 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.producerExtensions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.producerExtensions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `ProducerExtension` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/networkservices_v1beta1.projects.locations.serviceBindings.html b/docs/dyn/networkservices_v1beta1.projects.locations.serviceBindings.html index f48a0e323f..138a5fad4a 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.serviceBindings.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.serviceBindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceBinding in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -252,17 +252,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.serviceLbPolicies.html b/docs/dyn/networkservices_v1beta1.projects.locations.serviceLbPolicies.html index a63e46cd0f..4daf660636 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.serviceLbPolicies.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.serviceLbPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ServiceLbPolicies in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.tcpRoutes.html b/docs/dyn/networkservices_v1beta1.projects.locations.tcpRoutes.html index 5ec8d005c8..ffe4f3d58b 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.tcpRoutes.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.tcpRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists TcpRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -328,17 +328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.tlsRoutes.html b/docs/dyn/networkservices_v1beta1.projects.locations.tlsRoutes.html index cf57e02811..b99a737d13 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.tlsRoutes.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.tlsRoutes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists TlsRoute in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.html b/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.html index a8cf59b8a1..2993ef8f21 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `WasmPlugin` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.versions.html b/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.versions.html index dd6a7966ca..f98b624c6d 100644 --- a/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.versions.html +++ b/docs/dyn/networkservices_v1beta1.projects.locations.wasmPlugins.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `WasmPluginVersion` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v1.html b/docs/dyn/notebooks_v1.html index e7d165e84d..ff96f80ff7 100644 --- a/docs/dyn/notebooks_v1.html +++ b/docs/dyn/notebooks_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/notebooks_v1.projects.locations.environments.html b/docs/dyn/notebooks_v1.projects.locations.environments.html index 2177f0f479..40947ebe7f 100644 --- a/docs/dyn/notebooks_v1.projects.locations.environments.html +++ b/docs/dyn/notebooks_v1.projects.locations.environments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists environments in a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -264,17 +264,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v1.projects.locations.executions.html b/docs/dyn/notebooks_v1.projects.locations.executions.html index 36816cae4a..a99d874733 100644 --- a/docs/dyn/notebooks_v1.projects.locations.executions.html +++ b/docs/dyn/notebooks_v1.projects.locations.executions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists executions in a given project and location

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -335,17 +335,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v1.projects.locations.html b/docs/dyn/notebooks_v1.projects.locations.html index d596598ebc..7489cd73d3 100644 --- a/docs/dyn/notebooks_v1.projects.locations.html +++ b/docs/dyn/notebooks_v1.projects.locations.html @@ -114,7 +114,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v1.projects.locations.instances.html b/docs/dyn/notebooks_v1.projects.locations.instances.html index 96823b76d5..d3404dbbc9 100644 --- a/docs/dyn/notebooks_v1.projects.locations.instances.html +++ b/docs/dyn/notebooks_v1.projects.locations.instances.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrate(name, body=None, x__xgafv=None)

@@ -752,17 +752,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/notebooks_v1.projects.locations.operations.html b/docs/dyn/notebooks_v1.projects.locations.operations.html index 50e3331861..9160429bb0 100644 --- a/docs/dyn/notebooks_v1.projects.locations.operations.html +++ b/docs/dyn/notebooks_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v1.projects.locations.runtimes.html b/docs/dyn/notebooks_v1.projects.locations.runtimes.html index 3e97a5d8ec..3472beda65 100644 --- a/docs/dyn/notebooks_v1.projects.locations.runtimes.html +++ b/docs/dyn/notebooks_v1.projects.locations.runtimes.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Runtimes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrate(name, body=None, x__xgafv=None)

@@ -709,17 +709,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/notebooks_v1.projects.locations.schedules.html b/docs/dyn/notebooks_v1.projects.locations.schedules.html index 2175772d14..9fa1e364c6 100644 --- a/docs/dyn/notebooks_v1.projects.locations.schedules.html +++ b/docs/dyn/notebooks_v1.projects.locations.schedules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists schedules in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

trigger(name, body=None, x__xgafv=None)

@@ -461,17 +461,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/notebooks_v2.html b/docs/dyn/notebooks_v2.html index 2c704379c6..cf607004b5 100644 --- a/docs/dyn/notebooks_v2.html +++ b/docs/dyn/notebooks_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/notebooks_v2.projects.locations.html b/docs/dyn/notebooks_v2.projects.locations.html index 1f0947e50e..74f1296d7d 100644 --- a/docs/dyn/notebooks_v2.projects.locations.html +++ b/docs/dyn/notebooks_v2.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/notebooks_v2.projects.locations.instances.html b/docs/dyn/notebooks_v2.projects.locations.instances.html index 7ba8969c52..f07149d550 100644 --- a/docs/dyn/notebooks_v2.projects.locations.instances.html +++ b/docs/dyn/notebooks_v2.projects.locations.instances.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -858,17 +858,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/notebooks_v2.projects.locations.operations.html b/docs/dyn/notebooks_v2.projects.locations.operations.html index 7775363bd6..ae2c2db44a 100644 --- a/docs/dyn/notebooks_v2.projects.locations.operations.html +++ b/docs/dyn/notebooks_v2.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oauth2_v2.html b/docs/dyn/oauth2_v2.html index 0ea1ccf676..4a1bb49633 100644 --- a/docs/dyn/oauth2_v2.html +++ b/docs/dyn/oauth2_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

tokeninfo(access_token=None, id_token=None)

@@ -95,20 +95,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
diff --git a/docs/dyn/observability_v1.folders.locations.html b/docs/dyn/observability_v1.folders.locations.html index db5b81295f..1530527af6 100644 --- a/docs/dyn/observability_v1.folders.locations.html +++ b/docs/dyn/observability_v1.folders.locations.html @@ -92,7 +92,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -189,17 +189,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/observability_v1.folders.locations.operations.html b/docs/dyn/observability_v1.folders.locations.operations.html index be828aaaf7..9a16ff21e3 100644 --- a/docs/dyn/observability_v1.folders.locations.operations.html +++ b/docs/dyn/observability_v1.folders.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/observability_v1.html b/docs/dyn/observability_v1.html index 5704a11e2a..29c789fd38 100644 --- a/docs/dyn/observability_v1.html +++ b/docs/dyn/observability_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/observability_v1.organizations.locations.html b/docs/dyn/observability_v1.organizations.locations.html index ae27f4b869..ebc54bcc19 100644 --- a/docs/dyn/observability_v1.organizations.locations.html +++ b/docs/dyn/observability_v1.organizations.locations.html @@ -92,7 +92,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -189,17 +189,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/observability_v1.organizations.locations.operations.html b/docs/dyn/observability_v1.organizations.locations.operations.html index ad0c41957c..356dae4475 100644 --- a/docs/dyn/observability_v1.organizations.locations.operations.html +++ b/docs/dyn/observability_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/observability_v1.projects.locations.buckets.datasets.html b/docs/dyn/observability_v1.projects.locations.buckets.datasets.html index 8cb6691240..90070db38e 100644 --- a/docs/dyn/observability_v1.projects.locations.buckets.datasets.html +++ b/docs/dyn/observability_v1.projects.locations.buckets.datasets.html @@ -94,7 +94,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

List datasets of a bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -159,17 +159,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/observability_v1.projects.locations.buckets.datasets.links.html b/docs/dyn/observability_v1.projects.locations.buckets.datasets.links.html index fdaffad071..115288f8d8 100644 --- a/docs/dyn/observability_v1.projects.locations.buckets.datasets.links.html +++ b/docs/dyn/observability_v1.projects.locations.buckets.datasets.links.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List links of a dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/observability_v1.projects.locations.buckets.datasets.views.html b/docs/dyn/observability_v1.projects.locations.buckets.datasets.views.html index 71971ceacb..c07b59d4ef 100644 --- a/docs/dyn/observability_v1.projects.locations.buckets.datasets.views.html +++ b/docs/dyn/observability_v1.projects.locations.buckets.datasets.views.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List views of a dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/observability_v1.projects.locations.buckets.html b/docs/dyn/observability_v1.projects.locations.buckets.html index b8a4cc9de6..c48f9450b7 100644 --- a/docs/dyn/observability_v1.projects.locations.buckets.html +++ b/docs/dyn/observability_v1.projects.locations.buckets.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

List buckets of a project in a particular location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/observability_v1.projects.locations.html b/docs/dyn/observability_v1.projects.locations.html index 23a52bed06..92a045d736 100644 --- a/docs/dyn/observability_v1.projects.locations.html +++ b/docs/dyn/observability_v1.projects.locations.html @@ -107,7 +107,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSettings(name, body=None, updateMask=None, x__xgafv=None)

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/observability_v1.projects.locations.operations.html b/docs/dyn/observability_v1.projects.locations.operations.html index 4e32799d60..c4bd256319 100644 --- a/docs/dyn/observability_v1.projects.locations.operations.html +++ b/docs/dyn/observability_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/observability_v1.projects.locations.traceScopes.html b/docs/dyn/observability_v1.projects.locations.traceScopes.html index 458cb1398c..a8c9c17e97 100644 --- a/docs/dyn/observability_v1.projects.locations.traceScopes.html +++ b/docs/dyn/observability_v1.projects.locations.traceScopes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List TraceScopes of a project in a particular location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ondemandscanning_v1.html b/docs/dyn/ondemandscanning_v1.html index 761f456a5e..4ef2c2386e 100644 --- a/docs/dyn/ondemandscanning_v1.html +++ b/docs/dyn/ondemandscanning_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ondemandscanning_v1.projects.locations.operations.html b/docs/dyn/ondemandscanning_v1.projects.locations.operations.html index ce978c2b14..b070d67abc 100644 --- a/docs/dyn/ondemandscanning_v1.projects.locations.operations.html +++ b/docs/dyn/ondemandscanning_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ondemandscanning_v1.projects.locations.scans.html b/docs/dyn/ondemandscanning_v1.projects.locations.scans.html index ef3812a1d3..73b0fb0027 100644 --- a/docs/dyn/ondemandscanning_v1.projects.locations.scans.html +++ b/docs/dyn/ondemandscanning_v1.projects.locations.scans.html @@ -160,7 +160,7 @@

Method Details

"source": "A String", }, ], - "layerDetails": { # Details about the layer a package was found in. + "layerDetails": { # Details about the layer a package was found in. # Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted. "baseImages": [ # The base images the layer is found within. { # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. diff --git a/docs/dyn/ondemandscanning_v1.projects.locations.scans.vulnerabilities.html b/docs/dyn/ondemandscanning_v1.projects.locations.scans.vulnerabilities.html index 6c4c9f5f26..ceb4795bee 100644 --- a/docs/dyn/ondemandscanning_v1.projects.locations.scans.vulnerabilities.html +++ b/docs/dyn/ondemandscanning_v1.projects.locations.scans.vulnerabilities.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists vulnerabilities resulting from a successfully completed scan.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1072,17 +1072,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/ondemandscanning_v1beta1.html b/docs/dyn/ondemandscanning_v1beta1.html index 8eab9588d7..9a9dac4664 100644 --- a/docs/dyn/ondemandscanning_v1beta1.html +++ b/docs/dyn/ondemandscanning_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/ondemandscanning_v1beta1.projects.locations.operations.html b/docs/dyn/ondemandscanning_v1beta1.projects.locations.operations.html index 79dc002e98..eb53b0341f 100644 --- a/docs/dyn/ondemandscanning_v1beta1.projects.locations.operations.html +++ b/docs/dyn/ondemandscanning_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, timeout=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html index de9ad41895..57eb0aefbe 100644 --- a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html +++ b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html @@ -159,7 +159,7 @@

Method Details

"source": "A String", }, ], - "layerDetails": { # Details about the layer a package was found in. + "layerDetails": { # Details about the layer a package was found in. # Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted. "baseImages": [ # The base images the layer is found within. { # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. diff --git a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.vulnerabilities.html b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.vulnerabilities.html index cda68993c3..c555aeedca 100644 --- a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.vulnerabilities.html +++ b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.vulnerabilities.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists vulnerabilities resulting from a successfully completed scan.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1072,17 +1072,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.html b/docs/dyn/oracledatabase_v1.html index 690e8f16ac..1715df561b 100644 --- a/docs/dyn/oracledatabase_v1.html +++ b/docs/dyn/oracledatabase_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseBackups.html b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseBackups.html index 79659c6bca..7e8ed183f2 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseBackups.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseBackups.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the long-term and automatic backups of an Autonomous Database.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -144,17 +144,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.autonomousDatabaseCharacterSets.html b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseCharacterSets.html index 08080e1a7e..29d8f56e17 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseCharacterSets.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabaseCharacterSets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Autonomous Database Character Sets in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.autonomousDatabases.html b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html index b0352f93d5..52938afd7b 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Autonomous Databases in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -893,17 +893,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDbVersions.html b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDbVersions.html index 0bca0d34d1..e38914d278 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDbVersions.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDbVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the available Autonomous Database versions for a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.dbServers.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.dbServers.html index 030f69c79a..2c7e1fd661 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.dbServers.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.dbServers.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the database servers of an Exadata Infrastructure instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html index cb72b0bf4e..1bb0ad19f1 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Exadata Infrastructures in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -483,17 +483,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.cloudVmClusters.dbNodes.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.dbNodes.html index f87b8c5c7d..345e4180e6 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.dbNodes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.dbNodes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the database nodes of a VM Cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.cloudVmClusters.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html index b3643fb8be..d804311538 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the VM Clusters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -441,17 +441,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.databaseCharacterSets.html b/docs/dyn/oracledatabase_v1.projects.locations.databaseCharacterSets.html index 4c0694f2e5..80301653ef 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.databaseCharacterSets.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.databaseCharacterSets.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List DatabaseCharacterSets for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.databases.html b/docs/dyn/oracledatabase_v1.projects.locations.databases.html index 5f91bed44b..5b414889e3 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.databases.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.databases.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Databases for the given project, location and DbSystem.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.dbSystemInitialStorageSizes.html b/docs/dyn/oracledatabase_v1.projects.locations.dbSystemInitialStorageSizes.html index 1596376aae..013fbfff64 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.dbSystemInitialStorageSizes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.dbSystemInitialStorageSizes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DbSystemInitialStorageSizes for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -132,17 +132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.dbSystemShapes.html b/docs/dyn/oracledatabase_v1.projects.locations.dbSystemShapes.html index f9543e3d32..ba794c7b70 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.dbSystemShapes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.dbSystemShapes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the database system shapes available for the project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -131,17 +131,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.dbSystems.html b/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html index 69202ac8a2..ecb0162cf7 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the DbSystems for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -490,17 +490,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.dbVersions.html b/docs/dyn/oracledatabase_v1.projects.locations.dbVersions.html index 766b698c1f..3f09f7d354 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.dbVersions.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.dbVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List DbVersions for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.entitlements.html b/docs/dyn/oracledatabase_v1.projects.locations.entitlements.html index 11db64e866..4fa11905ac 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.entitlements.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.entitlements.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the entitlements in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.exadbVmClusters.dbNodes.html b/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.dbNodes.html index 121155af6a..b39c9d9604 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.dbNodes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.dbNodes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the database nodes of a VM Cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -127,17 +127,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.exadbVmClusters.html b/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.html index 25ec63e7f9..ef54ebf9fd 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.exadbVmClusters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Exadb (Exascale) VM Clusters for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -378,17 +378,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html b/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html index 6fb23d6a4a..34bb542aff 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the ExascaleDB Storage Vaults for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -328,17 +328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.giVersions.html b/docs/dyn/oracledatabase_v1.projects.locations.giVersions.html index d8d8045fc4..aa26ee3808 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.giVersions.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.giVersions.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the valid Oracle Grid Infrastructure (GI) versions for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -123,17 +123,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.giVersions.minorVersions.html b/docs/dyn/oracledatabase_v1.projects.locations.giVersions.minorVersions.html index ef44abad89..dafb2b0e3d 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.giVersions.minorVersions.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.giVersions.minorVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the valid minor versions for the given project, location, gi version and shape family.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html index ded77f493c..dc8917a047 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GoldengateConnectionAssignments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

test(name, body=None, x__xgafv=None)

@@ -271,17 +271,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionTypes.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionTypes.html index 37b3f6ac7e..419b47d866 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionTypes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionTypes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GoldengateConnectionTypes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateConnections.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html index 97889a6ff4..a513bbd96d 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the GoldengateConnections for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1408,17 +1408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateDeploymentEnvironments.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentEnvironments.html index 48855c99bd..85e462fd34 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentEnvironments.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentEnvironments.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists GoldengateDeploymentEnvironments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateDeploymentTypes.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentTypes.html index 825397efec..082dd5fb80 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentTypes.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentTypes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GoldenGateDeploymentTypes in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -139,17 +139,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateDeploymentVersions.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentVersions.html index 1caad66e7b..1476c289fd 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentVersions.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeploymentVersions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists GoldengateDeploymentVersions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.goldengateDeployments.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html index 9e83df0434..c75ca18f03 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the GoldengateDeployments for the given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

start(name, body=None, x__xgafv=None)

@@ -571,17 +571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.html b/docs/dyn/oracledatabase_v1.projects.locations.html index 9e2b2e87ad..89cb817f99 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.html @@ -214,7 +214,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.odbNetworks.html b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.html index a767bf4e57..0aedff476a 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the ODB Networks in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html index 76204f7024..a53dc2da82 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the ODB Subnets in a given ODB Network.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.operations.html b/docs/dyn/oracledatabase_v1.projects.locations.operations.html index 59305717ee..2e05784106 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.operations.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oracledatabase_v1.projects.locations.pluggableDatabases.html b/docs/dyn/oracledatabase_v1.projects.locations.pluggableDatabases.html index dc8bb4c53f..84dcf58054 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.pluggableDatabases.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.pluggableDatabases.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the PluggableDatabases for the given project, location and Container Database.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/orgpolicy_v2.folders.constraints.html b/docs/dyn/orgpolicy_v2.folders.constraints.html index ed230400d2..42e4647749 100644 --- a/docs/dyn/orgpolicy_v2.folders.constraints.html +++ b/docs/dyn/orgpolicy_v2.folders.constraints.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists constraints that could be applied on the specified resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/orgpolicy_v2.folders.policies.html b/docs/dyn/orgpolicy_v2.folders.policies.html index 364106257e..4bcdcab45c 100644 --- a/docs/dyn/orgpolicy_v2.folders.policies.html +++ b/docs/dyn/orgpolicy_v2.folders.policies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all of the policies that exist on a particular resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -684,17 +684,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/orgpolicy_v2.html b/docs/dyn/orgpolicy_v2.html index 114495f08f..bf87a02ea7 100644 --- a/docs/dyn/orgpolicy_v2.html +++ b/docs/dyn/orgpolicy_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/orgpolicy_v2.organizations.constraints.html b/docs/dyn/orgpolicy_v2.organizations.constraints.html index a538afb4f9..17a2e25a56 100644 --- a/docs/dyn/orgpolicy_v2.organizations.constraints.html +++ b/docs/dyn/orgpolicy_v2.organizations.constraints.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists constraints that could be applied on the specified resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/orgpolicy_v2.organizations.customConstraints.html b/docs/dyn/orgpolicy_v2.organizations.customConstraints.html index 3a3d144690..646c2b4f0e 100644 --- a/docs/dyn/orgpolicy_v2.organizations.customConstraints.html +++ b/docs/dyn/orgpolicy_v2.organizations.customConstraints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all of the custom constraints that exist on a particular organization resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -235,17 +235,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/orgpolicy_v2.organizations.policies.html b/docs/dyn/orgpolicy_v2.organizations.policies.html index b07972b1a1..d6e86e6852 100644 --- a/docs/dyn/orgpolicy_v2.organizations.policies.html +++ b/docs/dyn/orgpolicy_v2.organizations.policies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all of the policies that exist on a particular resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -684,17 +684,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/orgpolicy_v2.projects.constraints.html b/docs/dyn/orgpolicy_v2.projects.constraints.html index 368695dc44..83e793fc28 100644 --- a/docs/dyn/orgpolicy_v2.projects.constraints.html +++ b/docs/dyn/orgpolicy_v2.projects.constraints.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists constraints that could be applied on the specified resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/orgpolicy_v2.projects.policies.html b/docs/dyn/orgpolicy_v2.projects.policies.html index 13f4c88481..66e07b7732 100644 --- a/docs/dyn/orgpolicy_v2.projects.policies.html +++ b/docs/dyn/orgpolicy_v2.projects.policies.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves all of the policies that exist on a particular resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -684,17 +684,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1.html b/docs/dyn/osconfig_v1.html index cd63f61337..77692402e0 100644 --- a/docs/dyn/osconfig_v1.html +++ b/docs/dyn/osconfig_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/osconfig_v1.projects.locations.instances.inventories.html b/docs/dyn/osconfig_v1.projects.locations.instances.inventories.html index b0172c393d..cc20e4cb01 100644 --- a/docs/dyn/osconfig_v1.projects.locations.instances.inventories.html +++ b/docs/dyn/osconfig_v1.projects.locations.instances.inventories.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List inventory data for all VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -469,17 +469,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1.projects.locations.instances.osPolicyAssignments.reports.html b/docs/dyn/osconfig_v1.projects.locations.instances.osPolicyAssignments.reports.html index a88f5a2a6a..a596d6b99c 100644 --- a/docs/dyn/osconfig_v1.projects.locations.instances.osPolicyAssignments.reports.html +++ b/docs/dyn/osconfig_v1.projects.locations.instances.osPolicyAssignments.reports.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List OS policy assignment reports for all Compute Engine VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -193,17 +193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1.projects.locations.instances.vulnerabilityReports.html b/docs/dyn/osconfig_v1.projects.locations.instances.vulnerabilityReports.html index d57c4414a9..0d848c77a4 100644 --- a/docs/dyn/osconfig_v1.projects.locations.instances.vulnerabilityReports.html +++ b/docs/dyn/osconfig_v1.projects.locations.instances.vulnerabilityReports.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List vulnerability reports for all VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1.projects.locations.osPolicyAssignments.html b/docs/dyn/osconfig_v1.projects.locations.osPolicyAssignments.html index b8d588075c..fb34a53838 100644 --- a/docs/dyn/osconfig_v1.projects.locations.osPolicyAssignments.html +++ b/docs/dyn/osconfig_v1.projects.locations.osPolicyAssignments.html @@ -98,10 +98,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, x__xgafv=None)

List the OS policy assignment revisions for a given OS policy assignment.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1148,31 +1148,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1.projects.patchDeployments.html b/docs/dyn/osconfig_v1.projects.patchDeployments.html index 0bc984cecf..4b6a3e9cd4 100644 --- a/docs/dyn/osconfig_v1.projects.patchDeployments.html +++ b/docs/dyn/osconfig_v1.projects.patchDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Get a page of OS Config patch deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -870,17 +870,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1.projects.patchJobs.html b/docs/dyn/osconfig_v1.projects.patchJobs.html index 5740c27902..c24b0b7271 100644 --- a/docs/dyn/osconfig_v1.projects.patchJobs.html +++ b/docs/dyn/osconfig_v1.projects.patchJobs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of patch jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -971,17 +971,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1.projects.patchJobs.instanceDetails.html b/docs/dyn/osconfig_v1.projects.patchJobs.instanceDetails.html index d470c45b0f..5009e08914 100644 --- a/docs/dyn/osconfig_v1.projects.patchJobs.instanceDetails.html +++ b/docs/dyn/osconfig_v1.projects.patchJobs.instanceDetails.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of instance details for a given patch job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1alpha.html b/docs/dyn/osconfig_v1alpha.html index 1d279ffe85..d5d609899e 100644 --- a/docs/dyn/osconfig_v1alpha.html +++ b/docs/dyn/osconfig_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/osconfig_v1alpha.projects.locations.instanceOSPoliciesCompliances.html b/docs/dyn/osconfig_v1alpha.projects.locations.instanceOSPoliciesCompliances.html index c7eae2152f..8104457e9d 100644 --- a/docs/dyn/osconfig_v1alpha.projects.locations.instanceOSPoliciesCompliances.html +++ b/docs/dyn/osconfig_v1alpha.projects.locations.instanceOSPoliciesCompliances.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Deprecated: Use ListOSPolicyAssignmentReports instead. List OS policies compliance data for all Compute Engine VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -197,17 +197,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1alpha.projects.locations.instances.inventories.html b/docs/dyn/osconfig_v1alpha.projects.locations.instances.inventories.html index 8530a960da..2b7794b8c0 100644 --- a/docs/dyn/osconfig_v1alpha.projects.locations.instances.inventories.html +++ b/docs/dyn/osconfig_v1alpha.projects.locations.instances.inventories.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

List inventory data for all VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -469,17 +469,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1alpha.projects.locations.instances.osPolicyAssignments.reports.html b/docs/dyn/osconfig_v1alpha.projects.locations.instances.osPolicyAssignments.reports.html index 9d0ed0bcc9..59cdabfdb6 100644 --- a/docs/dyn/osconfig_v1alpha.projects.locations.instances.osPolicyAssignments.reports.html +++ b/docs/dyn/osconfig_v1alpha.projects.locations.instances.osPolicyAssignments.reports.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List OS policy assignment reports for all Compute Engine VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -193,17 +193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1alpha.projects.locations.instances.vulnerabilityReports.html b/docs/dyn/osconfig_v1alpha.projects.locations.instances.vulnerabilityReports.html index 7fe9648dda..c4a2bff531 100644 --- a/docs/dyn/osconfig_v1alpha.projects.locations.instances.vulnerabilityReports.html +++ b/docs/dyn/osconfig_v1alpha.projects.locations.instances.vulnerabilityReports.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List vulnerability reports for all VM instances in the specified zone.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1alpha.projects.locations.osPolicyAssignments.html b/docs/dyn/osconfig_v1alpha.projects.locations.osPolicyAssignments.html index d2a7c3a791..beddfcbc4c 100644 --- a/docs/dyn/osconfig_v1alpha.projects.locations.osPolicyAssignments.html +++ b/docs/dyn/osconfig_v1alpha.projects.locations.osPolicyAssignments.html @@ -98,10 +98,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, x__xgafv=None)

List the OS policy assignment revisions for a given OS policy assignment.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1176,31 +1176,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1beta.html b/docs/dyn/osconfig_v1beta.html index 946508134b..4b36918f5b 100644 --- a/docs/dyn/osconfig_v1beta.html +++ b/docs/dyn/osconfig_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/osconfig_v1beta.projects.guestPolicies.html b/docs/dyn/osconfig_v1beta.projects.guestPolicies.html index 88f5634fc3..20c27761e6 100644 --- a/docs/dyn/osconfig_v1beta.projects.guestPolicies.html +++ b/docs/dyn/osconfig_v1beta.projects.guestPolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Get a page of OS Config guest policies.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -932,17 +932,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1beta.projects.patchDeployments.html b/docs/dyn/osconfig_v1beta.projects.patchDeployments.html index 520eb6457c..0cff17f537 100644 --- a/docs/dyn/osconfig_v1beta.projects.patchDeployments.html +++ b/docs/dyn/osconfig_v1beta.projects.patchDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Get a page of OS Config patch deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -870,17 +870,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v1beta.projects.patchJobs.html b/docs/dyn/osconfig_v1beta.projects.patchJobs.html index a0150df6e6..8c64cf82ef 100644 --- a/docs/dyn/osconfig_v1beta.projects.patchJobs.html +++ b/docs/dyn/osconfig_v1beta.projects.patchJobs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of patch jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -971,17 +971,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v1beta.projects.patchJobs.instanceDetails.html b/docs/dyn/osconfig_v1beta.projects.patchJobs.instanceDetails.html index dc8810b00c..d47f8aa0b9 100644 --- a/docs/dyn/osconfig_v1beta.projects.patchJobs.instanceDetails.html +++ b/docs/dyn/osconfig_v1beta.projects.patchJobs.instanceDetails.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of instance details for a given patch job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2.folders.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2.folders.locations.global_.policyOrchestrators.html index 2ad1fda316..da96e386e9 100644 --- a/docs/dyn/osconfig_v2.folders.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2.folders.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent folder resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2.folders.locations.operations.html b/docs/dyn/osconfig_v2.folders.locations.operations.html index 2554bc4dc0..2e523ad5b0 100644 --- a/docs/dyn/osconfig_v2.folders.locations.operations.html +++ b/docs/dyn/osconfig_v2.folders.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2.html b/docs/dyn/osconfig_v2.html index 136d1b0927..2e4ed4b6ef 100644 --- a/docs/dyn/osconfig_v2.html +++ b/docs/dyn/osconfig_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/osconfig_v2.organizations.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2.organizations.locations.global_.policyOrchestrators.html index c3856ef861..ca9428adae 100644 --- a/docs/dyn/osconfig_v2.organizations.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2.organizations.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent organization resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2.organizations.locations.operations.html b/docs/dyn/osconfig_v2.organizations.locations.operations.html index ddc3387e2e..dd4291cb30 100644 --- a/docs/dyn/osconfig_v2.organizations.locations.operations.html +++ b/docs/dyn/osconfig_v2.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2.projects.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2.projects.locations.global_.policyOrchestrators.html index 698673fd1b..006405b984 100644 --- a/docs/dyn/osconfig_v2.projects.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2.projects.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent project resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2.projects.locations.operations.html b/docs/dyn/osconfig_v2.projects.locations.operations.html index 3ccaed33a0..861e4bc47c 100644 --- a/docs/dyn/osconfig_v2.projects.locations.operations.html +++ b/docs/dyn/osconfig_v2.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2beta.folders.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2beta.folders.locations.global_.policyOrchestrators.html index e733731241..453a6aca7f 100644 --- a/docs/dyn/osconfig_v2beta.folders.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2beta.folders.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent folder resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2beta.folders.locations.operations.html b/docs/dyn/osconfig_v2beta.folders.locations.operations.html index 80e2b701c4..97a8ead73f 100644 --- a/docs/dyn/osconfig_v2beta.folders.locations.operations.html +++ b/docs/dyn/osconfig_v2beta.folders.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2beta.html b/docs/dyn/osconfig_v2beta.html index 196a62e456..826208d10c 100644 --- a/docs/dyn/osconfig_v2beta.html +++ b/docs/dyn/osconfig_v2beta.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/osconfig_v2beta.organizations.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2beta.organizations.locations.global_.policyOrchestrators.html index 03e6817261..32513006f6 100644 --- a/docs/dyn/osconfig_v2beta.organizations.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2beta.organizations.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent organization resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2beta.organizations.locations.operations.html b/docs/dyn/osconfig_v2beta.organizations.locations.operations.html index 7401389b87..5e723c57fa 100644 --- a/docs/dyn/osconfig_v2beta.organizations.locations.operations.html +++ b/docs/dyn/osconfig_v2beta.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/osconfig_v2beta.projects.locations.global_.policyOrchestrators.html b/docs/dyn/osconfig_v2beta.projects.locations.global_.policyOrchestrators.html index a233eb20f9..b27786c51d 100644 --- a/docs/dyn/osconfig_v2beta.projects.locations.global_.policyOrchestrators.html +++ b/docs/dyn/osconfig_v2beta.projects.locations.global_.policyOrchestrators.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the policy orchestrators under the given parent project resource.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1115,17 +1115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/osconfig_v2beta.projects.locations.operations.html b/docs/dyn/osconfig_v2beta.projects.locations.operations.html index fdf506d3a6..40143ff914 100644 --- a/docs/dyn/osconfig_v2beta.projects.locations.operations.html +++ b/docs/dyn/osconfig_v2beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/oslogin_v1.html b/docs/dyn/oslogin_v1.html index d8ab30ad5b..c11e31a442 100644 --- a/docs/dyn/oslogin_v1.html +++ b/docs/dyn/oslogin_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/oslogin_v1alpha.html b/docs/dyn/oslogin_v1alpha.html index 624ab8ae12..2c9a4ad93e 100644 --- a/docs/dyn/oslogin_v1alpha.html +++ b/docs/dyn/oslogin_v1alpha.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/oslogin_v1beta.html b/docs/dyn/oslogin_v1beta.html index 7113b313a7..f9888e543f 100644 --- a/docs/dyn/oslogin_v1beta.html +++ b/docs/dyn/oslogin_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pagespeedonline_v5.html b/docs/dyn/pagespeedonline_v5.html index ee5539f590..2aad03cf8a 100644 --- a/docs/dyn/pagespeedonline_v5.html +++ b/docs/dyn/pagespeedonline_v5.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/parallelstore_v1.html b/docs/dyn/parallelstore_v1.html index 04e76ba695..b95abf8d1c 100644 --- a/docs/dyn/parallelstore_v1.html +++ b/docs/dyn/parallelstore_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/parallelstore_v1.projects.locations.html b/docs/dyn/parallelstore_v1.projects.locations.html index 51c0a4eeea..5860fcc61d 100644 --- a/docs/dyn/parallelstore_v1.projects.locations.html +++ b/docs/dyn/parallelstore_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/parallelstore_v1.projects.locations.instances.html b/docs/dyn/parallelstore_v1.projects.locations.instances.html index 849d5c016d..0f00e8833c 100644 --- a/docs/dyn/parallelstore_v1.projects.locations.instances.html +++ b/docs/dyn/parallelstore_v1.projects.locations.instances.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -400,17 +400,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/parallelstore_v1.projects.locations.operations.html b/docs/dyn/parallelstore_v1.projects.locations.operations.html index 17afe5c096..33b6ca43b9 100644 --- a/docs/dyn/parallelstore_v1.projects.locations.operations.html +++ b/docs/dyn/parallelstore_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/parallelstore_v1beta.html b/docs/dyn/parallelstore_v1beta.html index bc26a02a9a..da472f84f8 100644 --- a/docs/dyn/parallelstore_v1beta.html +++ b/docs/dyn/parallelstore_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/parallelstore_v1beta.projects.locations.html b/docs/dyn/parallelstore_v1beta.projects.locations.html index 02f8a4794c..cadd6a9949 100644 --- a/docs/dyn/parallelstore_v1beta.projects.locations.html +++ b/docs/dyn/parallelstore_v1beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/parallelstore_v1beta.projects.locations.instances.html b/docs/dyn/parallelstore_v1beta.projects.locations.instances.html index 5948350c7b..05729bb9c8 100644 --- a/docs/dyn/parallelstore_v1beta.projects.locations.instances.html +++ b/docs/dyn/parallelstore_v1beta.projects.locations.instances.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -400,17 +400,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/parallelstore_v1beta.projects.locations.operations.html b/docs/dyn/parallelstore_v1beta.projects.locations.operations.html index d0d67fb2e9..6cdc4dce7d 100644 --- a/docs/dyn/parallelstore_v1beta.projects.locations.operations.html +++ b/docs/dyn/parallelstore_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/parametermanager_v1.html b/docs/dyn/parametermanager_v1.html index 7ed8f27e5b..20ae81e3e4 100644 --- a/docs/dyn/parametermanager_v1.html +++ b/docs/dyn/parametermanager_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/parametermanager_v1.projects.locations.html b/docs/dyn/parametermanager_v1.projects.locations.html index 5e974be231..63518a50cb 100644 --- a/docs/dyn/parametermanager_v1.projects.locations.html +++ b/docs/dyn/parametermanager_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/parametermanager_v1.projects.locations.parameters.html b/docs/dyn/parametermanager_v1.projects.locations.parameters.html index 3b94cf160b..578d1db6e7 100644 --- a/docs/dyn/parametermanager_v1.projects.locations.parameters.html +++ b/docs/dyn/parametermanager_v1.projects.locations.parameters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Parameters in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -260,17 +260,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/parametermanager_v1.projects.locations.parameters.versions.html b/docs/dyn/parametermanager_v1.projects.locations.parameters.versions.html index 7113173479..7ec7003cee 100644 --- a/docs/dyn/parametermanager_v1.projects.locations.parameters.versions.html +++ b/docs/dyn/parametermanager_v1.projects.locations.parameters.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ParameterVersions in a given project, location, and parameter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -243,17 +243,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/parametermanager_v1.projects.locations.templates.html b/docs/dyn/parametermanager_v1.projects.locations.templates.html index cdafa3ad60..d84959fd18 100644 --- a/docs/dyn/parametermanager_v1.projects.locations.templates.html +++ b/docs/dyn/parametermanager_v1.projects.locations.templates.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Templates in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/parametermanager_v1.projects.locations.templates.versions.html b/docs/dyn/parametermanager_v1.projects.locations.templates.versions.html index 7f905cbb20..59b845367b 100644 --- a/docs/dyn/parametermanager_v1.projects.locations.templates.versions.html +++ b/docs/dyn/parametermanager_v1.projects.locations.templates.versions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TemplateVersions in a given project, location, and template.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/paymentsresellersubscription_v1.html b/docs/dyn/paymentsresellersubscription_v1.html index babbf29e3e..bd6f8244f8 100644 --- a/docs/dyn/paymentsresellersubscription_v1.html +++ b/docs/dyn/paymentsresellersubscription_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/paymentsresellersubscription_v1.partners.products.html b/docs/dyn/paymentsresellersubscription_v1.partners.products.html index 19ae1f7bd0..bd94e94f2f 100644 --- a/docs/dyn/paymentsresellersubscription_v1.partners.products.html +++ b/docs/dyn/paymentsresellersubscription_v1.partners.products.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Currently, it doesn't support **YouTube** products. Retrieves the products that can be resold by the partner. It should be authenticated with a service account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -151,17 +151,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/paymentsresellersubscription_v1.partners.promotions.html b/docs/dyn/paymentsresellersubscription_v1.partners.promotions.html index d828748421..135073ff79 100644 --- a/docs/dyn/paymentsresellersubscription_v1.partners.promotions.html +++ b/docs/dyn/paymentsresellersubscription_v1.partners.promotions.html @@ -81,13 +81,13 @@

Instance Methods

findEligible(parent, body=None, x__xgafv=None)

Currently, it is only enabled for **YouTube**. Finds eligible promotions for the current user. The API requires user authorization via OAuth. The bare minimum oauth scope `openid` is sufficient, which will skip the consent screen.

- findEligible_next(previous_request, previous_response)

+ findEligible_next()

Retrieves the next page of results.

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Currently, it doesn't support **YouTube** promotions. Retrieves the promotions, such as free trial, that can be used by the partner. It should be authenticated with a service account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- findEligible_next(previous_request, previous_response) + findEligible_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)
+        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.
-
+ 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. +
@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/people_v1.contactGroups.html b/docs/dyn/people_v1.contactGroups.html index 34cbc34e7f..8dbb3cd629 100644 --- a/docs/dyn/people_v1.contactGroups.html +++ b/docs/dyn/people_v1.contactGroups.html @@ -98,7 +98,7 @@

Instance Methods

list(groupFields=None, pageSize=None, pageToken=None, syncToken=None, x__xgafv=None)

List all contact groups owned by the authenticated user. Members of the contact groups are not populated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(resourceName, body=None, x__xgafv=None)

@@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/people_v1.html b/docs/dyn/people_v1.html index efda6051be..e87d0c5194 100644 --- a/docs/dyn/people_v1.html +++ b/docs/dyn/people_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/people_v1.otherContacts.html b/docs/dyn/people_v1.otherContacts.html index 1822b8f304..610338f971 100644 --- a/docs/dyn/people_v1.otherContacts.html +++ b/docs/dyn/people_v1.otherContacts.html @@ -84,7 +84,7 @@

Instance Methods

list(pageSize=None, pageToken=None, readMask=None, requestSyncToken=None, sources=None, syncToken=None, x__xgafv=None)

List all "Other contacts", that is contacts that are not in a contact group. "Other contacts" are typically auto created contacts from interactions. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an [google.rpc.ErrorInfo](https://cloud.google.com/apis/design/errors#error_info) with reason "EXPIRED_SYNC_TOKEN". In the case of such an error clients should make a full sync request without a `sync_token`. The first page of a full sync request has an additional quota. If the quota is exceeded, a 429 error will be returned. This quota is fixed and can not be increased. When the `sync_token` is specified, resources deleted since the last sync will be returned as a person with `PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is specified, all other request parameters must match the first call. Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases. See example usage at [List the user's other contacts that have changed](/people/v1/other-contacts#list_the_users_other_contacts_that_have_changed).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(pageSize=None, query=None, readMask=None, x__xgafv=None)

@@ -1913,17 +1913,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/people_v1.people.connections.html b/docs/dyn/people_v1.people.connections.html index 76ba1f21dc..466dc30ad3 100644 --- a/docs/dyn/people_v1.people.connections.html +++ b/docs/dyn/people_v1.people.connections.html @@ -81,7 +81,7 @@

Instance Methods

list(resourceName, pageSize=None, pageToken=None, personFields=None, requestMask_includeField=None, requestSyncToken=None, sortOrder=None, sources=None, syncToken=None, x__xgafv=None)

Provides a list of the authenticated user's contacts. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an [google.rpc.ErrorInfo](https://cloud.google.com/apis/design/errors#error_info) with reason "EXPIRED_SYNC_TOKEN". In the case of such an error clients should make a full sync request without a `sync_token`. The first page of a full sync request has an additional quota. If the quota is exceeded, a 429 error will be returned. This quota is fixed and can not be increased. When the `sync_token` is specified, resources deleted since the last sync will be returned as a person with `PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is specified, all other request parameters must match the first call. Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases. See example usage at [List the user's contacts that have changed](/people/v1/contacts#list_the_users_contacts_that_have_changed).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1011,17 +1011,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/people_v1.people.html b/docs/dyn/people_v1.people.html index 7cb9d03442..946bec49b7 100644 --- a/docs/dyn/people_v1.people.html +++ b/docs/dyn/people_v1.people.html @@ -110,7 +110,7 @@

Instance Methods

listDirectoryPeople(mergeSources=None, pageSize=None, pageToken=None, readMask=None, requestSyncToken=None, sources=None, syncToken=None, x__xgafv=None)

Provides a list of domain profiles and domain contacts in the authenticated user's domain directory. When the `sync_token` is specified, resources deleted since the last sync will be returned as a person with `PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is specified, all other request parameters must match the first call. Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases. See example usage at [List the directory people that have changed](/people/v1/directory#list_the_directory_people_that_have_changed).

- listDirectoryPeople_next(previous_request, previous_response)

+ listDirectoryPeople_next()

Retrieves the next page of results.

searchContacts(pageSize=None, query=None, readMask=None, sources=None, x__xgafv=None)

@@ -119,7 +119,7 @@

Instance Methods

searchDirectoryPeople(mergeSources=None, pageSize=None, pageToken=None, query=None, readMask=None, sources=None, x__xgafv=None)

Provides a list of domain profiles and domain contacts in the authenticated user's domain directory that match the search query.

- searchDirectoryPeople_next(previous_request, previous_response)

+ searchDirectoryPeople_next()

Retrieves the next page of results.

updateContact(resourceName, body=None, personFields=None, sources=None, updatePersonFields=None, x__xgafv=None)

@@ -9204,17 +9204,17 @@

Method Details

- listDirectoryPeople_next(previous_request, previous_response) + listDirectoryPeople_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)
+        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.
-
+ 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. +
@@ -11039,17 +11039,17 @@

Method Details

- searchDirectoryPeople_next(previous_request, previous_response) + searchDirectoryPeople_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/places_v1.html b/docs/dyn/places_v1.html index 891b6af01c..dd28435c21 100644 --- a/docs/dyn/places_v1.html +++ b/docs/dyn/places_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/places_v1.places.html b/docs/dyn/places_v1.places.html index 399b3e0f55..54cc90698f 100644 --- a/docs/dyn/places_v1.places.html +++ b/docs/dyn/places_v1.places.html @@ -95,7 +95,7 @@

Instance Methods

searchText(body=None, x__xgafv=None)

Text query based place search.

- searchText_next(previous_request, previous_response)

+ searchText_next()

Retrieves the next page of results.

Method Details

@@ -2531,17 +2531,17 @@

Method Details

- searchText_next(previous_request, previous_response) + searchText_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)
+        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.
-
+ 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/playcustomapp_v1.html b/docs/dyn/playcustomapp_v1.html index 9c199437bc..3c0b40d460 100644 --- a/docs/dyn/playcustomapp_v1.html +++ b/docs/dyn/playcustomapp_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/playdeveloperreporting_v1alpha1.anomalies.html b/docs/dyn/playdeveloperreporting_v1alpha1.anomalies.html index 2bf00e2379..29f8b2f298 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.anomalies.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.anomalies.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists anomalies in any of the datasets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.apps.html b/docs/dyn/playdeveloperreporting_v1alpha1.apps.html index c4359394de..dced0d5aa1 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.apps.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.apps.html @@ -84,7 +84,7 @@

Instance Methods

search(pageSize=None, pageToken=None, x__xgafv=None)

Searches for Apps accessible by the user.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.html b/docs/dyn/playdeveloperreporting_v1alpha1.html index 1aa9496230..f965acddb7 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anonrssandswapmemoryusage.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anonrssandswapmemoryusage.html index e48a0bdaf6..7d851c06bc 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anonrssandswapmemoryusage.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anonrssandswapmemoryusage.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.anrrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anrrate.html index f84d0c9fa0..82c2f1c1f1 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anrrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.anrrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.bitmapmemoryusage.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.bitmapmemoryusage.html index 92a0e26e89..f3dc5a5db2 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.bitmapmemoryusage.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.bitmapmemoryusage.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.crashrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.crashrate.html index 4d506956e2..6ae1a70655 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.crashrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.crashrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.errors.counts.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.counts.html index b329d48ea8..f0d2102264 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.counts.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.counts.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metrics set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -241,17 +241,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.errors.issues.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.issues.html index 6d16541710..37ded4eddf 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.issues.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.issues.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, filter=None, interval_endTime_day=None, interval_endTime_hours=None, interval_endTime_minutes=None, interval_endTime_month=None, interval_endTime_nanos=None, interval_endTime_seconds=None, interval_endTime_timeZone_id=None, interval_endTime_timeZone_version=None, interval_endTime_utcOffset=None, interval_endTime_year=None, interval_startTime_day=None, interval_startTime_hours=None, interval_startTime_minutes=None, interval_startTime_month=None, interval_startTime_nanos=None, interval_startTime_seconds=None, interval_startTime_timeZone_id=None, interval_startTime_timeZone_version=None, interval_startTime_utcOffset=None, interval_startTime_year=None, orderBy=None, pageSize=None, pageToken=None, sampleErrorReportLimit=None, x__xgafv=None)

Searches all error issues in which reports have been grouped.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.errors.reports.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.reports.html index 105a45d69f..6b056682b4 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.reports.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.errors.reports.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, filter=None, interval_endTime_day=None, interval_endTime_hours=None, interval_endTime_minutes=None, interval_endTime_month=None, interval_endTime_nanos=None, interval_endTime_seconds=None, interval_endTime_timeZone_id=None, interval_endTime_timeZone_version=None, interval_endTime_utcOffset=None, interval_endTime_year=None, interval_startTime_day=None, interval_startTime_hours=None, interval_startTime_minutes=None, interval_startTime_month=None, interval_startTime_nanos=None, interval_startTime_seconds=None, interval_startTime_timeZone_id=None, interval_startTime_timeZone_version=None, interval_startTime_utcOffset=None, interval_startTime_year=None, pageSize=None, pageToken=None, x__xgafv=None)

Searches all error reports received for an app.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -156,17 +156,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.excessivewakeuprate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.excessivewakeuprate.html index a2af92a717..69238d578a 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.excessivewakeuprate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.excessivewakeuprate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.lmkrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.lmkrate.html index 825d396247..5bee74119a 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.lmkrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.lmkrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.slowrenderingrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowrenderingrate.html index d6114bf993..a91d57f433 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowrenderingrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowrenderingrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.slowstartrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowstartrate.html index 5ab3ae8ada..1bf1498a34 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowstartrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.slowstartrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1alpha1.vitals.stuckbackgroundwakelockrate.html b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.stuckbackgroundwakelockrate.html index a5202780ab..63584a99f3 100644 --- a/docs/dyn/playdeveloperreporting_v1alpha1.vitals.stuckbackgroundwakelockrate.html +++ b/docs/dyn/playdeveloperreporting_v1alpha1.vitals.stuckbackgroundwakelockrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.anomalies.html b/docs/dyn/playdeveloperreporting_v1beta1.anomalies.html index 2bb86da146..bed3798e58 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.anomalies.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.anomalies.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists anomalies in any of the datasets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.apps.html b/docs/dyn/playdeveloperreporting_v1beta1.apps.html index 4bb0549137..8167d650fa 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.apps.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.apps.html @@ -84,7 +84,7 @@

Instance Methods

search(pageSize=None, pageToken=None, x__xgafv=None)

Searches for Apps accessible by the user.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -152,17 +152,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.html b/docs/dyn/playdeveloperreporting_v1beta1.html index ab2540a78f..8754004998 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/playdeveloperreporting_v1beta1.vitals.anonrssandswapmemoryusage.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.anonrssandswapmemoryusage.html index 75b8a26390..e90e5245d4 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.anonrssandswapmemoryusage.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.anonrssandswapmemoryusage.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.anrrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.anrrate.html index 0703038e15..b36d085c04 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.anrrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.anrrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.bitmapmemoryusage.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.bitmapmemoryusage.html index fceeeebefc..22921d0020 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.bitmapmemoryusage.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.bitmapmemoryusage.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.crashrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.crashrate.html index be9957d12a..712465aa76 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.crashrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.crashrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.errors.counts.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.counts.html index baa0aacc98..a148a61db0 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.counts.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.counts.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metrics set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -241,17 +241,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.errors.issues.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.issues.html index 06e309d25f..3c40ab0cdf 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.issues.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.issues.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, filter=None, interval_endTime_day=None, interval_endTime_hours=None, interval_endTime_minutes=None, interval_endTime_month=None, interval_endTime_nanos=None, interval_endTime_seconds=None, interval_endTime_timeZone_id=None, interval_endTime_timeZone_version=None, interval_endTime_utcOffset=None, interval_endTime_year=None, interval_startTime_day=None, interval_startTime_hours=None, interval_startTime_minutes=None, interval_startTime_month=None, interval_startTime_nanos=None, interval_startTime_seconds=None, interval_startTime_timeZone_id=None, interval_startTime_timeZone_version=None, interval_startTime_utcOffset=None, interval_startTime_year=None, orderBy=None, pageSize=None, pageToken=None, sampleErrorReportLimit=None, x__xgafv=None)

Searches all error issues in which reports have been grouped.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.errors.reports.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.reports.html index f1043f0538..9bd8cbda3f 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.reports.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.errors.reports.html @@ -81,7 +81,7 @@

Instance Methods

search(parent, filter=None, interval_endTime_day=None, interval_endTime_hours=None, interval_endTime_minutes=None, interval_endTime_month=None, interval_endTime_nanos=None, interval_endTime_seconds=None, interval_endTime_timeZone_id=None, interval_endTime_timeZone_version=None, interval_endTime_utcOffset=None, interval_endTime_year=None, interval_startTime_day=None, interval_startTime_hours=None, interval_startTime_minutes=None, interval_startTime_month=None, interval_startTime_nanos=None, interval_startTime_seconds=None, interval_startTime_timeZone_id=None, interval_startTime_timeZone_version=None, interval_startTime_utcOffset=None, interval_startTime_year=None, pageSize=None, pageToken=None, x__xgafv=None)

Searches all error reports received for an app.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -156,17 +156,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.excessivewakeuprate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.excessivewakeuprate.html index 1ce0adad02..324c77c772 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.excessivewakeuprate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.excessivewakeuprate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.lmkrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.lmkrate.html index 6c3c63d113..eded86f9f1 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.lmkrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.lmkrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.slowrenderingrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowrenderingrate.html index 93621486ff..1d234c2a7a 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowrenderingrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowrenderingrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.slowstartrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowstartrate.html index dc412da86e..edd1210280 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowstartrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.slowstartrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playdeveloperreporting_v1beta1.vitals.stuckbackgroundwakelockrate.html b/docs/dyn/playdeveloperreporting_v1beta1.vitals.stuckbackgroundwakelockrate.html index 267d0dc740..60279292b2 100644 --- a/docs/dyn/playdeveloperreporting_v1beta1.vitals.stuckbackgroundwakelockrate.html +++ b/docs/dyn/playdeveloperreporting_v1beta1.vitals.stuckbackgroundwakelockrate.html @@ -84,7 +84,7 @@

Instance Methods

query(name, body=None, x__xgafv=None)

Queries the metrics in the metric set.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -242,17 +242,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/playgrouping_v1alpha1.html b/docs/dyn/playgrouping_v1alpha1.html index 75dad71219..692c8eb351 100644 --- a/docs/dyn/playgrouping_v1alpha1.html +++ b/docs/dyn/playgrouping_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/playintegrity_v1.html b/docs/dyn/playintegrity_v1.html index 0a5bb19c53..d04b6287ee 100644 --- a/docs/dyn/playintegrity_v1.html +++ b/docs/dyn/playintegrity_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policyanalyzer_v1.folders.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1.folders.locations.activityTypes.activities.html index 4d776ef62b..08e5ff91b0 100644 --- a/docs/dyn/policyanalyzer_v1.folders.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1.folders.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on Google Cloud resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policyanalyzer_v1.html b/docs/dyn/policyanalyzer_v1.html index 423025df28..f8d37e7140 100644 --- a/docs/dyn/policyanalyzer_v1.html +++ b/docs/dyn/policyanalyzer_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policyanalyzer_v1.organizations.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1.organizations.locations.activityTypes.activities.html index 4d405db109..658d06641c 100644 --- a/docs/dyn/policyanalyzer_v1.organizations.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1.organizations.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on Google Cloud resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policyanalyzer_v1.projects.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1.projects.locations.activityTypes.activities.html index ef7827b4ab..16ee91bc86 100644 --- a/docs/dyn/policyanalyzer_v1.projects.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1.projects.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on Google Cloud resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policyanalyzer_v1beta1.folders.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1beta1.folders.locations.activityTypes.activities.html index ccb2db7368..77ff961b74 100644 --- a/docs/dyn/policyanalyzer_v1beta1.folders.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1beta1.folders.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on GCP resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policyanalyzer_v1beta1.html b/docs/dyn/policyanalyzer_v1beta1.html index 0cfec8829f..dd92da37e8 100644 --- a/docs/dyn/policyanalyzer_v1beta1.html +++ b/docs/dyn/policyanalyzer_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policyanalyzer_v1beta1.organizations.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1beta1.organizations.locations.activityTypes.activities.html index c862ffe2ac..9fe6bcb730 100644 --- a/docs/dyn/policyanalyzer_v1beta1.organizations.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1beta1.organizations.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on GCP resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policyanalyzer_v1beta1.projects.locations.activityTypes.activities.html b/docs/dyn/policyanalyzer_v1beta1.projects.locations.activityTypes.activities.html index 461166ff4c..c66d7a6520 100644 --- a/docs/dyn/policyanalyzer_v1beta1.projects.locations.activityTypes.activities.html +++ b/docs/dyn/policyanalyzer_v1beta1.projects.locations.activityTypes.activities.html @@ -81,7 +81,7 @@

Instance Methods

query(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Queries policy activities on GCP resources.

- query_next(previous_request, previous_response)

+ query_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- query_next(previous_request, previous_response) + query_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)
+        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.
-
+ 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/policysimulator_v1.folders.locations.replays.operations.html b/docs/dyn/policysimulator_v1.folders.locations.replays.operations.html index 915af9cfa2..df1e39f37f 100644 --- a/docs/dyn/policysimulator_v1.folders.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1.folders.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.folders.locations.replays.results.html b/docs/dyn/policysimulator_v1.folders.locations.replays.results.html index 7ef6240fac..35481d2042 100644 --- a/docs/dyn/policysimulator_v1.folders.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1.folders.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.html b/docs/dyn/policysimulator_v1.html index 09402f9faa..fc9f888d13 100644 --- a/docs/dyn/policysimulator_v1.html +++ b/docs/dyn/policysimulator_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policysimulator_v1.operations.html b/docs/dyn/policysimulator_v1.operations.html index 7d207c92a6..ecf9d5c921 100644 --- a/docs/dyn/policysimulator_v1.operations.html +++ b/docs/dyn/policysimulator_v1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.html b/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.html index 2bb1a2f32a..870c4399fe 100644 --- a/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.html +++ b/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListOrgPolicyViolationsPreviews lists each OrgPolicyViolationsPreview in an organization. Each OrgPolicyViolationsPreview is available for at least 7 days.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -602,17 +602,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html b/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html index 5c96fed983..ba3cea8239 100644 --- a/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html +++ b/docs/dyn/policysimulator_v1.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListOrgPolicyViolations lists the OrgPolicyViolations that are present in an OrgPolicyViolationsPreview.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.organizations.locations.replays.operations.html b/docs/dyn/policysimulator_v1.organizations.locations.replays.operations.html index 914d83c757..8e7b420b22 100644 --- a/docs/dyn/policysimulator_v1.organizations.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1.organizations.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.organizations.locations.replays.results.html b/docs/dyn/policysimulator_v1.organizations.locations.replays.results.html index a8891b517e..d7cb2a889c 100644 --- a/docs/dyn/policysimulator_v1.organizations.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1.organizations.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.projects.locations.replays.operations.html b/docs/dyn/policysimulator_v1.projects.locations.replays.operations.html index c318a107af..ce6adaaec3 100644 --- a/docs/dyn/policysimulator_v1.projects.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1.projects.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1.projects.locations.replays.results.html b/docs/dyn/policysimulator_v1.projects.locations.replays.results.html index 84d8ac31d2..655105b283 100644 --- a/docs/dyn/policysimulator_v1.projects.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1.projects.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1alpha.folders.locations.replays.operations.html b/docs/dyn/policysimulator_v1alpha.folders.locations.replays.operations.html index 1d9f27d221..9e88bb4373 100644 --- a/docs/dyn/policysimulator_v1alpha.folders.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1alpha.folders.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1alpha.html b/docs/dyn/policysimulator_v1alpha.html index aa2a34417a..9aa9b3ac78 100644 --- a/docs/dyn/policysimulator_v1alpha.html +++ b/docs/dyn/policysimulator_v1alpha.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policysimulator_v1alpha.operations.html b/docs/dyn/policysimulator_v1alpha.operations.html index d84169994a..724b1a25da 100644 --- a/docs/dyn/policysimulator_v1alpha.operations.html +++ b/docs/dyn/policysimulator_v1alpha.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1alpha.organizations.locations.replays.operations.html b/docs/dyn/policysimulator_v1alpha.organizations.locations.replays.operations.html index fbe01fef39..1e23dd3864 100644 --- a/docs/dyn/policysimulator_v1alpha.organizations.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1alpha.organizations.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1alpha.projects.locations.replays.operations.html b/docs/dyn/policysimulator_v1alpha.projects.locations.replays.operations.html index fea2e42212..e02be0726f 100644 --- a/docs/dyn/policysimulator_v1alpha.projects.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1alpha.projects.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.folders.locations.replays.html b/docs/dyn/policysimulator_v1beta.folders.locations.replays.html index 198d544c78..12e365a0d5 100644 --- a/docs/dyn/policysimulator_v1beta.folders.locations.replays.html +++ b/docs/dyn/policysimulator_v1beta.folders.locations.replays.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists each Replay in a project, folder, or organization. Each `Replay` is available for at least 7 days.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -352,17 +352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.folders.locations.replays.operations.html b/docs/dyn/policysimulator_v1beta.folders.locations.replays.operations.html index 6967162f5a..19a3c0f424 100644 --- a/docs/dyn/policysimulator_v1beta.folders.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1beta.folders.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.folders.locations.replays.results.html b/docs/dyn/policysimulator_v1beta.folders.locations.replays.results.html index 84c06a986c..c8f137b2d9 100644 --- a/docs/dyn/policysimulator_v1beta.folders.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1beta.folders.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.html b/docs/dyn/policysimulator_v1beta.html index 49942be02d..334b225d54 100644 --- a/docs/dyn/policysimulator_v1beta.html +++ b/docs/dyn/policysimulator_v1beta.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policysimulator_v1beta.operations.html b/docs/dyn/policysimulator_v1beta.operations.html index 82e7f32aaa..18bf6395f0 100644 --- a/docs/dyn/policysimulator_v1beta.operations.html +++ b/docs/dyn/policysimulator_v1beta.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.html b/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.html index 189c0581ed..7b21d38bb3 100644 --- a/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.html +++ b/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListOrgPolicyViolationsPreviews lists each OrgPolicyViolationsPreview in an organization. Each OrgPolicyViolationsPreview is available for at least 7 days.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -783,17 +783,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html b/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html index a8efb22b9f..208ab7a7aa 100644 --- a/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html +++ b/docs/dyn/policysimulator_v1beta.organizations.locations.orgPolicyViolationsPreviews.orgPolicyViolations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListOrgPolicyViolations lists the OrgPolicyViolations that are present in an OrgPolicyViolationsPreview.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -146,17 +146,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.organizations.locations.replays.html b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.html index 63da23e5b3..5d1c4dc8ff 100644 --- a/docs/dyn/policysimulator_v1beta.organizations.locations.replays.html +++ b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists each Replay in a project, folder, or organization. Each `Replay` is available for at least 7 days.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -352,17 +352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.organizations.locations.replays.operations.html b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.operations.html index 12547d566f..e925a64dd6 100644 --- a/docs/dyn/policysimulator_v1beta.organizations.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.organizations.locations.replays.results.html b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.results.html index 10cef41b34..2105e6b2e4 100644 --- a/docs/dyn/policysimulator_v1beta.organizations.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1beta.organizations.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.projects.locations.replays.html b/docs/dyn/policysimulator_v1beta.projects.locations.replays.html index 0d767bf763..63c3f14483 100644 --- a/docs/dyn/policysimulator_v1beta.projects.locations.replays.html +++ b/docs/dyn/policysimulator_v1beta.projects.locations.replays.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists each Replay in a project, folder, or organization. Each `Replay` is available for at least 7 days.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -352,17 +352,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.projects.locations.replays.operations.html b/docs/dyn/policysimulator_v1beta.projects.locations.replays.operations.html index 57e7692e02..cea11cc010 100644 --- a/docs/dyn/policysimulator_v1beta.projects.locations.replays.operations.html +++ b/docs/dyn/policysimulator_v1beta.projects.locations.replays.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policysimulator_v1beta.projects.locations.replays.results.html b/docs/dyn/policysimulator_v1beta.projects.locations.replays.results.html index 66827c91af..faf51cacaa 100644 --- a/docs/dyn/policysimulator_v1beta.projects.locations.replays.results.html +++ b/docs/dyn/policysimulator_v1beta.projects.locations.replays.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the results of running a Replay.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -287,17 +287,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/policytroubleshooter_v1.html b/docs/dyn/policytroubleshooter_v1.html index f6ba21f5fa..f34d58fe22 100644 --- a/docs/dyn/policytroubleshooter_v1.html +++ b/docs/dyn/policytroubleshooter_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policytroubleshooter_v1beta.html b/docs/dyn/policytroubleshooter_v1beta.html index 8547065427..12d9abe936 100644 --- a/docs/dyn/policytroubleshooter_v1beta.html +++ b/docs/dyn/policytroubleshooter_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policytroubleshooter_v3.html b/docs/dyn/policytroubleshooter_v3.html index 38b0aef61a..1bac822811 100644 --- a/docs/dyn/policytroubleshooter_v3.html +++ b/docs/dyn/policytroubleshooter_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/policytroubleshooter_v3beta.html b/docs/dyn/policytroubleshooter_v3beta.html index f563b6f93f..c51ece9c6e 100644 --- a/docs/dyn/policytroubleshooter_v3beta.html +++ b/docs/dyn/policytroubleshooter_v3beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pollen_v1.forecast.html b/docs/dyn/pollen_v1.forecast.html index f7df7d936e..8276d34d00 100644 --- a/docs/dyn/pollen_v1.forecast.html +++ b/docs/dyn/pollen_v1.forecast.html @@ -81,7 +81,7 @@

Instance Methods

lookup(days=None, languageCode=None, location_latitude=None, location_longitude=None, pageSize=None, pageToken=None, plantsDescription=None, x__xgafv=None)

Returns up to 5 days of daily pollen information in more than 65 countries, up to 1km resolution.

- lookup_next(previous_request, previous_response)

+ lookup_next()

Retrieves the next page of results.

Method Details

@@ -178,17 +178,17 @@

Method Details

- lookup_next(previous_request, previous_response) + lookup_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)
+        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.
-
+ 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/pollen_v1.html b/docs/dyn/pollen_v1.html index abe0a444e6..50f3dcbbb3 100644 --- a/docs/dyn/pollen_v1.html +++ b/docs/dyn/pollen_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/privateca_v1.html b/docs/dyn/privateca_v1.html index 0a65ba4830..7ddbbc6588 100644 --- a/docs/dyn/privateca_v1.html +++ b/docs/dyn/privateca_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.certificateRevocationLists.html b/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.certificateRevocationLists.html index e5c23725cd..040ffe49dd 100644 --- a/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.certificateRevocationLists.html +++ b/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.certificateRevocationLists.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CertificateRevocationLists.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.html b/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.html index 8ab8573b3b..bcdec95bc6 100644 --- a/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.html +++ b/docs/dyn/privateca_v1.projects.locations.caPools.certificateAuthorities.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CertificateAuthorities.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1454,17 +1454,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/privateca_v1.projects.locations.caPools.certificates.html b/docs/dyn/privateca_v1.projects.locations.caPools.certificates.html index b7a3c3a7bf..ebac573ec6 100644 --- a/docs/dyn/privateca_v1.projects.locations.caPools.certificates.html +++ b/docs/dyn/privateca_v1.projects.locations.caPools.certificates.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Certificates.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -1470,17 +1470,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/privateca_v1.projects.locations.caPools.html b/docs/dyn/privateca_v1.projects.locations.caPools.html index 7c10b65ae6..e514594e7b 100644 --- a/docs/dyn/privateca_v1.projects.locations.caPools.html +++ b/docs/dyn/privateca_v1.projects.locations.caPools.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CaPools.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -743,17 +743,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/privateca_v1.projects.locations.certificateTemplates.html b/docs/dyn/privateca_v1.projects.locations.certificateTemplates.html index 8a4f5491b5..11cba54c9c 100644 --- a/docs/dyn/privateca_v1.projects.locations.certificateTemplates.html +++ b/docs/dyn/privateca_v1.projects.locations.certificateTemplates.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists CertificateTemplates.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -622,17 +622,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/privateca_v1.projects.locations.html b/docs/dyn/privateca_v1.projects.locations.html index 7c6b093fb1..33804d158d 100644 --- a/docs/dyn/privateca_v1.projects.locations.html +++ b/docs/dyn/privateca_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/privateca_v1.projects.locations.operations.html b/docs/dyn/privateca_v1.projects.locations.operations.html index 1d76c63262..1de7fd74f4 100644 --- a/docs/dyn/privateca_v1.projects.locations.operations.html +++ b/docs/dyn/privateca_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/privateca_v1beta1.html b/docs/dyn/privateca_v1beta1.html index bc20e0db41..4336298264 100644 --- a/docs/dyn/privateca_v1beta1.html +++ b/docs/dyn/privateca_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/privateca_v1beta1.projects.locations.html b/docs/dyn/privateca_v1beta1.projects.locations.html index 1c78af2e1c..d14c3f238b 100644 --- a/docs/dyn/privateca_v1beta1.projects.locations.html +++ b/docs/dyn/privateca_v1beta1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/privateca_v1beta1.projects.locations.operations.html b/docs/dyn/privateca_v1beta1.projects.locations.operations.html index b26ec98693..14481b516e 100644 --- a/docs/dyn/privateca_v1beta1.projects.locations.operations.html +++ b/docs/dyn/privateca_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.customers.deployments.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.devices.html index 99a381c086..995472d552 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.customers.deployments.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.html index b3bb0e5649..6c78450c52 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.deployments.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.devices.html index 24e7b2a903..31c6cfc24f 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.devices.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -901,17 +901,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.html index 330f5dbe08..9795f16c1b 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.html @@ -105,7 +105,7 @@

Instance Methods

listLegacyOrganizations(x__xgafv=None)

Returns a list of legacy organizations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrateOrganization(body=None, x__xgafv=None)

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.deployments.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.deployments.html index 5b02b9117b..3d4f4ab4a4 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.deployments.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.customers.nodes.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.devices.html index 35df66c413..ffb9654005 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.customers.nodes.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.html index 07a64984c9..5fb030be5e 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.nodes.html b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.nodes.html index 6ae10478c2..0d1538f532 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.nodes.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.customers.nodes.nodes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.html b/docs/dyn/prod_tt_sasportal_v1alpha1.html index 83090da900..32bffdf1a1 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.devices.html index 66c6455de9..dbc17d5a8a 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.nodes.deployments.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.html index 5cd3c0e8a5..39cd1ac70e 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.deployments.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.devices.html index c4a89090c9..44cd76af68 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.devices.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -901,17 +901,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.deployments.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.deployments.html index b0f51d6174..f5c2cbcbb9 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.deployments.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.nodes.nodes.devices.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.devices.html index a7ef93aa6d..d548c46f9f 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.devices.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/prod_tt_sasportal_v1alpha1.nodes.nodes.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.html index c75245097e..06a8619e5d 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.nodes.html b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.nodes.html index 4e802858c8..b70f990c09 100644 --- a/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.nodes.html +++ b/docs/dyn/prod_tt_sasportal_v1alpha1.nodes.nodes.nodes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/publicca_v1.html b/docs/dyn/publicca_v1.html index 43e3667183..09427754a0 100644 --- a/docs/dyn/publicca_v1.html +++ b/docs/dyn/publicca_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/publicca_v1alpha1.html b/docs/dyn/publicca_v1alpha1.html index 89a54dd82c..b45f38fbf9 100644 --- a/docs/dyn/publicca_v1alpha1.html +++ b/docs/dyn/publicca_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/publicca_v1beta1.html b/docs/dyn/publicca_v1beta1.html index 59196359aa..23d25fb5c8 100644 --- a/docs/dyn/publicca_v1beta1.html +++ b/docs/dyn/publicca_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pubsub_v1.html b/docs/dyn/pubsub_v1.html index d5d3094ed8..1b196c80a9 100644 --- a/docs/dyn/pubsub_v1.html +++ b/docs/dyn/pubsub_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pubsub_v1.projects.schemas.html b/docs/dyn/pubsub_v1.projects.schemas.html index 8a7509cbf0..3ab2412046 100644 --- a/docs/dyn/pubsub_v1.projects.schemas.html +++ b/docs/dyn/pubsub_v1.projects.schemas.html @@ -102,10 +102,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all schema revisions for the named schema.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

rollback(name, body=None, x__xgafv=None)

@@ -407,31 +407,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1.projects.snapshots.html b/docs/dyn/pubsub_v1.projects.snapshots.html index eb7cd90e04..303e5678bd 100644 --- a/docs/dyn/pubsub_v1.projects.snapshots.html +++ b/docs/dyn/pubsub_v1.projects.snapshots.html @@ -93,7 +93,7 @@

Instance Methods

list(project, pageSize=None, pageToken=None, x__xgafv=None)

Lists the existing snapshots. Snapshots are used in [Seek]( https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1.projects.subscriptions.html b/docs/dyn/pubsub_v1.projects.subscriptions.html index 1ace669007..d9e1d40b3e 100644 --- a/docs/dyn/pubsub_v1.projects.subscriptions.html +++ b/docs/dyn/pubsub_v1.projects.subscriptions.html @@ -99,7 +99,7 @@

Instance Methods

list(project, pageSize=None, pageToken=None, x__xgafv=None)

Lists matching subscriptions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAckDeadline(subscription, body=None, x__xgafv=None)

@@ -706,17 +706,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1.projects.topics.html b/docs/dyn/pubsub_v1.projects.topics.html index bd285548f2..5d93c02292 100644 --- a/docs/dyn/pubsub_v1.projects.topics.html +++ b/docs/dyn/pubsub_v1.projects.topics.html @@ -103,7 +103,7 @@

Instance Methods

list(project, pageSize=None, pageToken=None, x__xgafv=None)

Lists matching topics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body, x__xgafv=None)

@@ -628,17 +628,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1.projects.topics.snapshots.html b/docs/dyn/pubsub_v1.projects.topics.snapshots.html index 542efd1d0e..a9e602153c 100644 --- a/docs/dyn/pubsub_v1.projects.topics.snapshots.html +++ b/docs/dyn/pubsub_v1.projects.topics.snapshots.html @@ -81,7 +81,7 @@

Instance Methods

list(topic, pageSize=None, pageToken=None, x__xgafv=None)

Lists the names of the snapshots on this topic. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -114,17 +114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsub_v1.projects.topics.subscriptions.html b/docs/dyn/pubsub_v1.projects.topics.subscriptions.html index 6f585e7ef9..032caa5538 100644 --- a/docs/dyn/pubsub_v1.projects.topics.subscriptions.html +++ b/docs/dyn/pubsub_v1.projects.topics.subscriptions.html @@ -81,7 +81,7 @@

Instance Methods

list(topic, pageSize=None, pageToken=None, x__xgafv=None)

Lists the names of the attached subscriptions on this topic.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -114,17 +114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsub_v1beta1a.html b/docs/dyn/pubsub_v1beta1a.html index a8a366baad..61a4e76ac1 100644 --- a/docs/dyn/pubsub_v1beta1a.html +++ b/docs/dyn/pubsub_v1beta1a.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pubsub_v1beta1a.subscriptions.html b/docs/dyn/pubsub_v1beta1a.subscriptions.html index 91feb3a64f..96ea524061 100644 --- a/docs/dyn/pubsub_v1beta1a.subscriptions.html +++ b/docs/dyn/pubsub_v1beta1a.subscriptions.html @@ -93,7 +93,7 @@

Instance Methods

list(maxResults=None, pageToken=None, query=None, x__xgafv=None)

Lists matching subscriptions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAckDeadline(body=None, x__xgafv=None)

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1beta1a.topics.html b/docs/dyn/pubsub_v1beta1a.topics.html index 4f00cb41a1..ada518b57c 100644 --- a/docs/dyn/pubsub_v1beta1a.topics.html +++ b/docs/dyn/pubsub_v1beta1a.topics.html @@ -90,7 +90,7 @@

Instance Methods

list(maxResults=None, pageToken=None, query=None, x__xgafv=None)

Lists matching topics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(body=None, x__xgafv=None)

@@ -193,17 +193,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1beta2.html b/docs/dyn/pubsub_v1beta2.html index 88ae08d32a..ecb0de47b6 100644 --- a/docs/dyn/pubsub_v1beta2.html +++ b/docs/dyn/pubsub_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html index 23a88777b1..ec66dcce51 100644 --- a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html +++ b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html @@ -96,7 +96,7 @@

Instance Methods

list(project, pageSize=None, pageToken=None, x__xgafv=None)

Lists matching subscriptions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

modifyAckDeadline(subscription, body=None, x__xgafv=None)

@@ -319,17 +319,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1beta2.projects.topics.html b/docs/dyn/pubsub_v1beta2.projects.topics.html index 16dfd93d5d..48be46cad3 100644 --- a/docs/dyn/pubsub_v1beta2.projects.topics.html +++ b/docs/dyn/pubsub_v1beta2.projects.topics.html @@ -98,7 +98,7 @@

Instance Methods

list(project, pageSize=None, pageToken=None, x__xgafv=None)

Lists matching topics.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

publish(topic, body=None, x__xgafv=None)

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html b/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html index 4cf54639a7..55c4173cbd 100644 --- a/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html +++ b/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html @@ -81,7 +81,7 @@

Instance Methods

list(topic, pageSize=None, pageToken=None, x__xgafv=None)

Lists the name of the subscriptions for this topic.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -114,17 +114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsublite_v1.admin.projects.locations.operations.html b/docs/dyn/pubsublite_v1.admin.projects.locations.operations.html index de58c7baa7..b561eda31c 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.operations.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsublite_v1.admin.projects.locations.reservations.html b/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.html index 653b0e2ef3..839604482b 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of reservations for the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -201,17 +201,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.topics.html b/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.topics.html index 442c6b8b3a..9b8d3556b5 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.topics.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.reservations.topics.html @@ -81,7 +81,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists the topics attached to the specified reservation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -114,17 +114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsublite_v1.admin.projects.locations.subscriptions.html b/docs/dyn/pubsublite_v1.admin.projects.locations.subscriptions.html index 1364c621b5..00b4b9de7d 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.subscriptions.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.subscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of subscriptions for the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsublite_v1.admin.projects.locations.topics.html b/docs/dyn/pubsublite_v1.admin.projects.locations.topics.html index cbe2e0014c..9f61b12ce5 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.topics.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.topics.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of topics for the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/pubsublite_v1.admin.projects.locations.topics.subscriptions.html b/docs/dyn/pubsublite_v1.admin.projects.locations.topics.subscriptions.html index 9f3e715fe4..8478fc5bb6 100644 --- a/docs/dyn/pubsublite_v1.admin.projects.locations.topics.subscriptions.html +++ b/docs/dyn/pubsublite_v1.admin.projects.locations.topics.subscriptions.html @@ -81,7 +81,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists the subscriptions attached to the specified topic.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -114,17 +114,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsublite_v1.cursor.projects.locations.subscriptions.cursors.html b/docs/dyn/pubsublite_v1.cursor.projects.locations.subscriptions.cursors.html index 01651e49ec..4087d6e502 100644 --- a/docs/dyn/pubsublite_v1.cursor.projects.locations.subscriptions.cursors.html +++ b/docs/dyn/pubsublite_v1.cursor.projects.locations.subscriptions.cursors.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all committed cursor information for a subscription.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/pubsublite_v1.html b/docs/dyn/pubsublite_v1.html index 2b1d25615e..c3a3b46779 100644 --- a/docs/dyn/pubsublite_v1.html +++ b/docs/dyn/pubsublite_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/rapidmigrationassessment_v1.html b/docs/dyn/rapidmigrationassessment_v1.html index 07c53666bc..2af3525650 100644 --- a/docs/dyn/rapidmigrationassessment_v1.html +++ b/docs/dyn/rapidmigrationassessment_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/rapidmigrationassessment_v1.projects.locations.collectors.html b/docs/dyn/rapidmigrationassessment_v1.projects.locations.collectors.html index eb15068a02..7375932427 100644 --- a/docs/dyn/rapidmigrationassessment_v1.projects.locations.collectors.html +++ b/docs/dyn/rapidmigrationassessment_v1.projects.locations.collectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Collectors in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/rapidmigrationassessment_v1.projects.locations.html b/docs/dyn/rapidmigrationassessment_v1.projects.locations.html index 5f9e128348..bfd5aed3c2 100644 --- a/docs/dyn/rapidmigrationassessment_v1.projects.locations.html +++ b/docs/dyn/rapidmigrationassessment_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/rapidmigrationassessment_v1.projects.locations.operations.html b/docs/dyn/rapidmigrationassessment_v1.projects.locations.operations.html index 1b0a2532fd..72bfeaae32 100644 --- a/docs/dyn/rapidmigrationassessment_v1.projects.locations.operations.html +++ b/docs/dyn/rapidmigrationassessment_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/readerrevenuesubscriptionlinking_v1.html b/docs/dyn/readerrevenuesubscriptionlinking_v1.html index f943e8eadb..a7b119b461 100644 --- a/docs/dyn/readerrevenuesubscriptionlinking_v1.html +++ b/docs/dyn/readerrevenuesubscriptionlinking_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/realtimebidding_v1.bidders.creatives.html b/docs/dyn/realtimebidding_v1.bidders.creatives.html index 0826f2629a..33974726af 100644 --- a/docs/dyn/realtimebidding_v1.bidders.creatives.html +++ b/docs/dyn/realtimebidding_v1.bidders.creatives.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists creatives as they are at the time of the initial request. This call may take multiple hours to complete. For large, paginated requests, this method returns a snapshot of creatives at the time of request for the first page. `lastStatusUpdate` and `creativeServingDecision` may be outdated for creatives on sequential pages. We recommend [Google Cloud Pub/Sub](//cloud.google.com/pubsub/docs/overview) to view the latest status.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

watch(parent, body=None, x__xgafv=None)

@@ -556,17 +556,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/realtimebidding_v1.bidders.endpoints.html b/docs/dyn/realtimebidding_v1.bidders.endpoints.html index b458abe394..91742f2dba 100644 --- a/docs/dyn/realtimebidding_v1.bidders.endpoints.html +++ b/docs/dyn/realtimebidding_v1.bidders.endpoints.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the bidder's endpoints.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/realtimebidding_v1.bidders.html b/docs/dyn/realtimebidding_v1.bidders.html index 02fc5ce06d..58be56a120 100644 --- a/docs/dyn/realtimebidding_v1.bidders.html +++ b/docs/dyn/realtimebidding_v1.bidders.html @@ -104,7 +104,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists all the bidder accounts that belong to the caller.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -165,17 +165,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/realtimebidding_v1.bidders.pretargetingConfigs.html b/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html index 6dfdfec908..cf5cba3984 100644 --- a/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html +++ b/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all pretargeting configurations for a single bidder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1055,17 +1055,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/realtimebidding_v1.bidders.publisherConnections.html b/docs/dyn/realtimebidding_v1.bidders.publisherConnections.html index c3676812a6..58f454171d 100644 --- a/docs/dyn/realtimebidding_v1.bidders.publisherConnections.html +++ b/docs/dyn/realtimebidding_v1.bidders.publisherConnections.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists publisher connections for a given bidder.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/realtimebidding_v1.buyers.creatives.html b/docs/dyn/realtimebidding_v1.buyers.creatives.html index 41a428d8d6..0e02624a5c 100644 --- a/docs/dyn/realtimebidding_v1.buyers.creatives.html +++ b/docs/dyn/realtimebidding_v1.buyers.creatives.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists creatives as they are at the time of the initial request. This call may take multiple hours to complete. For large, paginated requests, this method returns a snapshot of creatives at the time of request for the first page. `lastStatusUpdate` and `creativeServingDecision` may be outdated for creatives on sequential pages. We recommend [Google Cloud Pub/Sub](//cloud.google.com/pubsub/docs/overview) to view the latest status.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -2367,17 +2367,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/realtimebidding_v1.buyers.html b/docs/dyn/realtimebidding_v1.buyers.html index 0eb65de075..1718cde609 100644 --- a/docs/dyn/realtimebidding_v1.buyers.html +++ b/docs/dyn/realtimebidding_v1.buyers.html @@ -97,7 +97,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists all buyer account information the calling buyer user or service account is permissioned to manage.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -183,17 +183,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/realtimebidding_v1.buyers.userLists.html b/docs/dyn/realtimebidding_v1.buyers.userLists.html index ec424e5087..4eead24ccf 100644 --- a/docs/dyn/realtimebidding_v1.buyers.userLists.html +++ b/docs/dyn/realtimebidding_v1.buyers.userLists.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the user lists visible to the current user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

open(name, body=None, x__xgafv=None)

@@ -305,17 +305,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/realtimebidding_v1.html b/docs/dyn/realtimebidding_v1.html index 393b6dc4d7..65ac40ad19 100644 --- a/docs/dyn/realtimebidding_v1.html +++ b/docs/dyn/realtimebidding_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/recaptchaenterprise_v1.html b/docs/dyn/recaptchaenterprise_v1.html index 2e5c495e52..7a7601ca9d 100644 --- a/docs/dyn/recaptchaenterprise_v1.html +++ b/docs/dyn/recaptchaenterprise_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html b/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html index 93608f3102..81dd95e4d4 100644 --- a/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html +++ b/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns the list of all firewall policies that belong to a project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -282,17 +282,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recaptchaenterprise_v1.projects.keys.html b/docs/dyn/recaptchaenterprise_v1.projects.keys.html index 345b082029..4d0808955b 100644 --- a/docs/dyn/recaptchaenterprise_v1.projects.keys.html +++ b/docs/dyn/recaptchaenterprise_v1.projects.keys.html @@ -102,10 +102,10 @@

Instance Methods

listIpOverrides(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all IP overrides for a key.

- listIpOverrides_next(previous_request, previous_response)

+ listIpOverrides_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrate(name, body=None, x__xgafv=None)

@@ -583,31 +583,31 @@

Method Details

- listIpOverrides_next(previous_request, previous_response) + listIpOverrides_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroupmemberships.html b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroupmemberships.html index 705e56439c..68c71b3988 100644 --- a/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroupmemberships.html +++ b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroupmemberships.html @@ -81,7 +81,7 @@

Instance Methods

search(project, body=None, x__xgafv=None)

Search group memberships related to a given account.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -126,17 +126,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recaptchaenterprise_v1.projects.relatedaccountgroups.html b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.html index 4e0f4336e5..1c7d8c57e1 100644 --- a/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.html +++ b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List groups of related accounts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recaptchaenterprise_v1.projects.relatedaccountgroups.memberships.html b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.memberships.html index fb08393f37..26a5ae9a2e 100644 --- a/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.memberships.html +++ b/docs/dyn/recaptchaenterprise_v1.projects.relatedaccountgroups.memberships.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Get memberships in a group of related accounts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -118,17 +118,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommendationengine_v1beta1.html b/docs/dyn/recommendationengine_v1beta1.html index 8ae368f237..f7e4aca74a 100644 --- a/docs/dyn/recommendationengine_v1beta1.html +++ b/docs/dyn/recommendationengine_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.catalogItems.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.catalogItems.html index f786090b2d..72174bb002 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.catalogItems.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.catalogItems.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of catalog items.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -624,17 +624,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.operations.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.operations.html index 017d43713d..113f98dc91 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.operations.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.placements.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.placements.html index 6c86cfc7e6..f28bfb56cd 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.placements.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.placements.html @@ -81,7 +81,7 @@

Instance Methods

predict(name, body=None, x__xgafv=None)

Makes a recommendation prediction. If using API Key based authentication, the API Key must be registered using the PredictionApiKeyRegistry service. [Learn more](https://cloud.google.com/recommendations-ai/docs/setting-up#register-key).

- predict_next(previous_request, previous_response)

+ predict_next()

Retrieves the next page of results.

Method Details

@@ -228,17 +228,17 @@

Method Details

- predict_next(previous_request, previous_response) + predict_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)
+        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.
-
+ 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/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.predictionApiKeyRegistrations.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.predictionApiKeyRegistrations.html index 6616b4c22a..571c41c499 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.predictionApiKeyRegistrations.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.predictionApiKeyRegistrations.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List the registered apiKeys for use with predict method.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -168,17 +168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.userEvents.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.userEvents.html index 19490a775c..af2a1c7455 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.userEvents.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.eventStores.userEvents.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Gets a list of user events within a time range, with potential filtering. The method does not list unjoined user events. Unjoined user event definition: when a user event is ingested from Recommendations AI User Event APIs, the catalog item included in the user event is connected with the current catalog. If a catalog item of the ingested event is not in the current catalog, it could lead to degraded model quality. This is called an unjoined event.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

purge(parent, body=None, x__xgafv=None)

@@ -456,17 +456,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.html index ed5c8ffc3a..f0d877ecd9 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the catalog configurations associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -140,17 +140,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.operations.html b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.operations.html index f8f1eca29f..599f71c4f0 100644 --- a/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.operations.html +++ b/docs/dyn/recommendationengine_v1beta1.projects.locations.catalogs.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1.billingAccounts.locations.insightTypes.insights.html b/docs/dyn/recommender_v1.billingAccounts.locations.insightTypes.insights.html index 3ebddabd9a..6815a4ccce 100644 --- a/docs/dyn/recommender_v1.billingAccounts.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1.billingAccounts.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.billingAccounts.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1.billingAccounts.locations.recommenders.recommendations.html index 6ac5623a10..2177501864 100644 --- a/docs/dyn/recommender_v1.billingAccounts.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1.billingAccounts.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.folders.locations.insightTypes.insights.html b/docs/dyn/recommender_v1.folders.locations.insightTypes.insights.html index 177672b50c..5f0ed0b160 100644 --- a/docs/dyn/recommender_v1.folders.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1.folders.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.folders.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1.folders.locations.recommenders.recommendations.html index b6aa7f2567..eead6ab89e 100644 --- a/docs/dyn/recommender_v1.folders.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1.folders.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.html b/docs/dyn/recommender_v1.html index e85071ce6e..2529307cf0 100644 --- a/docs/dyn/recommender_v1.html +++ b/docs/dyn/recommender_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/recommender_v1.organizations.locations.insightTypes.insights.html b/docs/dyn/recommender_v1.organizations.locations.insightTypes.insights.html index 357d4d1e9b..e55e9d3cfe 100644 --- a/docs/dyn/recommender_v1.organizations.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1.organizations.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.organizations.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1.organizations.locations.recommenders.recommendations.html index 9fce1d3ce0..9434f0b6a7 100644 --- a/docs/dyn/recommender_v1.organizations.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1.organizations.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.projects.locations.insightTypes.insights.html b/docs/dyn/recommender_v1.projects.locations.insightTypes.insights.html index 680da69fbf..ffb80102ec 100644 --- a/docs/dyn/recommender_v1.projects.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1.projects.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1.projects.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1.projects.locations.recommenders.recommendations.html index 685ed4f137..a9b88e2763 100644 --- a/docs/dyn/recommender_v1.projects.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1.projects.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -393,17 +393,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.billingAccounts.locations.html b/docs/dyn/recommender_v1beta1.billingAccounts.locations.html index 18859f875e..8cf59f73d0 100644 --- a/docs/dyn/recommender_v1beta1.billingAccounts.locations.html +++ b/docs/dyn/recommender_v1beta1.billingAccounts.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations with recommendations or insights.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1beta1.billingAccounts.locations.insightTypes.insights.html b/docs/dyn/recommender_v1beta1.billingAccounts.locations.insightTypes.insights.html index 182b3cd032..cf2dc0717e 100644 --- a/docs/dyn/recommender_v1beta1.billingAccounts.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1beta1.billingAccounts.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.billingAccounts.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1beta1.billingAccounts.locations.recommenders.recommendations.html index bf00a0abbf..e5adc708b6 100644 --- a/docs/dyn/recommender_v1beta1.billingAccounts.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1beta1.billingAccounts.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -397,17 +397,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.folders.locations.html b/docs/dyn/recommender_v1beta1.folders.locations.html index 7a05c0439a..52d7bc2d27 100644 --- a/docs/dyn/recommender_v1beta1.folders.locations.html +++ b/docs/dyn/recommender_v1beta1.folders.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations with recommendations or insights.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1beta1.folders.locations.insightTypes.insights.html b/docs/dyn/recommender_v1beta1.folders.locations.insightTypes.insights.html index c3991b5b4a..b37dd294de 100644 --- a/docs/dyn/recommender_v1beta1.folders.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1beta1.folders.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.folders.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1beta1.folders.locations.recommenders.recommendations.html index 50021aa813..970e6cb332 100644 --- a/docs/dyn/recommender_v1beta1.folders.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1beta1.folders.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -397,17 +397,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.html b/docs/dyn/recommender_v1beta1.html index 9b7fce151b..53f45865b4 100644 --- a/docs/dyn/recommender_v1beta1.html +++ b/docs/dyn/recommender_v1beta1.html @@ -108,7 +108,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -117,20 +117,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/recommender_v1beta1.insightTypes.html b/docs/dyn/recommender_v1beta1.insightTypes.html index 1c87e5e0a0..452261e47c 100644 --- a/docs/dyn/recommender_v1beta1.insightTypes.html +++ b/docs/dyn/recommender_v1beta1.insightTypes.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists available InsightTypes. No IAM permissions are required.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1beta1.organizations.locations.html b/docs/dyn/recommender_v1beta1.organizations.locations.html index 0091acd775..4e84422618 100644 --- a/docs/dyn/recommender_v1beta1.organizations.locations.html +++ b/docs/dyn/recommender_v1beta1.organizations.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations with recommendations or insights.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1beta1.organizations.locations.insightTypes.insights.html b/docs/dyn/recommender_v1beta1.organizations.locations.insightTypes.insights.html index 47bc89506a..329be8a0a2 100644 --- a/docs/dyn/recommender_v1beta1.organizations.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1beta1.organizations.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.organizations.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1beta1.organizations.locations.recommenders.recommendations.html index 3cbb0819dc..27715c4ebc 100644 --- a/docs/dyn/recommender_v1beta1.organizations.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1beta1.organizations.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -397,17 +397,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.projects.locations.html b/docs/dyn/recommender_v1beta1.projects.locations.html index 36d82da705..c87d8bfe38 100644 --- a/docs/dyn/recommender_v1beta1.projects.locations.html +++ b/docs/dyn/recommender_v1beta1.projects.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists locations with recommendations or insights.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/recommender_v1beta1.projects.locations.insightTypes.insights.html b/docs/dyn/recommender_v1beta1.projects.locations.insightTypes.insights.html index c9f3de6066..369039281b 100644 --- a/docs/dyn/recommender_v1beta1.projects.locations.insightTypes.insights.html +++ b/docs/dyn/recommender_v1beta1.projects.locations.insightTypes.insights.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAccepted(name, body=None, x__xgafv=None)

@@ -190,17 +190,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.projects.locations.recommenders.recommendations.html b/docs/dyn/recommender_v1beta1.projects.locations.recommenders.recommendations.html index 106b4665e0..ba38e80260 100644 --- a/docs/dyn/recommender_v1beta1.projects.locations.recommenders.recommendations.html +++ b/docs/dyn/recommender_v1beta1.projects.locations.recommenders.recommendations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markClaimed(name, body=None, x__xgafv=None)

@@ -397,17 +397,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/recommender_v1beta1.recommenders.html b/docs/dyn/recommender_v1beta1.recommenders.html index 8cc07763d0..31e99dedd0 100644 --- a/docs/dyn/recommender_v1beta1.recommenders.html +++ b/docs/dyn/recommender_v1beta1.recommenders.html @@ -81,7 +81,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists all available Recommenders. No IAM permissions are required.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -115,17 +115,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.html b/docs/dyn/redis_v1.html index 59198ec541..d20f0013cd 100644 --- a/docs/dyn/redis_v1.html +++ b/docs/dyn/redis_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/redis_v1.projects.locations.aclPolicies.html b/docs/dyn/redis_v1.projects.locations.aclPolicies.html index d763aa3214..1183f5ed55 100644 --- a/docs/dyn/redis_v1.projects.locations.aclPolicies.html +++ b/docs/dyn/redis_v1.projects.locations.aclPolicies.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ACL policies owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1.projects.locations.aclPolicies.revisions.html b/docs/dyn/redis_v1.projects.locations.aclPolicies.revisions.html index 5d0934a148..6847e5e5cf 100644 --- a/docs/dyn/redis_v1.projects.locations.aclPolicies.revisions.html +++ b/docs/dyn/redis_v1.projects.locations.aclPolicies.revisions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ACL policy revisions in a given ACL policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.backupCollections.backups.html b/docs/dyn/redis_v1.projects.locations.backupCollections.backups.html index d190c1f09f..738e84be69 100644 --- a/docs/dyn/redis_v1.projects.locations.backupCollections.backups.html +++ b/docs/dyn/redis_v1.projects.locations.backupCollections.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups owned by a backup collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.backupCollections.html b/docs/dyn/redis_v1.projects.locations.backupCollections.html index 0cf12370af..9b08176c0d 100644 --- a/docs/dyn/redis_v1.projects.locations.backupCollections.html +++ b/docs/dyn/redis_v1.projects.locations.backupCollections.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backup collections owned by a consumer project in either the specified location (region) or all locations. If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.clusters.html b/docs/dyn/redis_v1.projects.locations.clusters.html index 78d3ea5728..59f1c68381 100644 --- a/docs/dyn/redis_v1.projects.locations.clusters.html +++ b/docs/dyn/redis_v1.projects.locations.clusters.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Redis clusters owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.authTokens.html b/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.authTokens.html index 281b2f8189..8fed9080d8 100644 --- a/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.authTokens.html +++ b/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.authTokens.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the auth tokens for a specific token auth user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.clusters.tokenAuthUsers.html b/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.html index 6fe136f1a8..b137ea90aa 100644 --- a/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.html +++ b/docs/dyn/redis_v1.projects.locations.clusters.tokenAuthUsers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the token auth users for a token based auth enabled cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.html b/docs/dyn/redis_v1.projects.locations.html index 9b4f2b994a..f2611f155f 100644 --- a/docs/dyn/redis_v1.projects.locations.html +++ b/docs/dyn/redis_v1.projects.locations.html @@ -112,7 +112,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1.projects.locations.instances.html b/docs/dyn/redis_v1.projects.locations.instances.html index 6644cf2863..74238cf8d5 100644 --- a/docs/dyn/redis_v1.projects.locations.instances.html +++ b/docs/dyn/redis_v1.projects.locations.instances.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Redis instances owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -657,17 +657,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1.projects.locations.operations.html b/docs/dyn/redis_v1.projects.locations.operations.html index 82ced9bc14..fdbaf9a4c9 100644 --- a/docs/dyn/redis_v1.projects.locations.operations.html +++ b/docs/dyn/redis_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.html b/docs/dyn/redis_v1beta1.html index 7a6ba1a2f1..64fedc9d9b 100644 --- a/docs/dyn/redis_v1beta1.html +++ b/docs/dyn/redis_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.html b/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.html index 63fbef4d1d..644d155c9a 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.html +++ b/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ACL policies owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -316,17 +316,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.revisions.html b/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.revisions.html index 128a840712..4556cb581e 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.revisions.html +++ b/docs/dyn/redis_v1beta1.projects.locations.aclPolicies.revisions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ACL policy revisions in a given ACL policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -205,17 +205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.backupCollections.backups.html b/docs/dyn/redis_v1beta1.projects.locations.backupCollections.backups.html index d8cbb6438c..0767833815 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.backupCollections.backups.html +++ b/docs/dyn/redis_v1beta1.projects.locations.backupCollections.backups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups owned by a backup collection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -279,17 +279,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.backupCollections.html b/docs/dyn/redis_v1beta1.projects.locations.backupCollections.html index 50ec091b6f..3ab01ab8ae 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.backupCollections.html +++ b/docs/dyn/redis_v1beta1.projects.locations.backupCollections.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backup collections owned by a consumer project in either the specified location (region) or all locations. If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -162,17 +162,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.clusters.html b/docs/dyn/redis_v1beta1.projects.locations.clusters.html index dbca33ac28..665d5a5336 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.clusters.html +++ b/docs/dyn/redis_v1beta1.projects.locations.clusters.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Redis clusters owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -981,17 +981,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.authTokens.html b/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.authTokens.html index 33763305ba..34eee29e87 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.authTokens.html +++ b/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.authTokens.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the auth tokens for a specific token auth user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.html b/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.html index 8d9ba9e3a3..a2d871e3ec 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.html +++ b/docs/dyn/redis_v1beta1.projects.locations.clusters.tokenAuthUsers.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the token auth users for a token based auth enabled cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.html b/docs/dyn/redis_v1beta1.projects.locations.html index f07ae18242..8d0b091763 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.html +++ b/docs/dyn/redis_v1beta1.projects.locations.html @@ -112,7 +112,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/redis_v1beta1.projects.locations.instances.html b/docs/dyn/redis_v1beta1.projects.locations.instances.html index d84275de34..336caca19c 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.instances.html +++ b/docs/dyn/redis_v1beta1.projects.locations.instances.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Redis instances owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -657,17 +657,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/redis_v1beta1.projects.locations.operations.html b/docs/dyn/redis_v1beta1.projects.locations.operations.html index b4c39fb173..ec79667511 100644 --- a/docs/dyn/redis_v1beta1.projects.locations.operations.html +++ b/docs/dyn/redis_v1beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/reseller_v1.html b/docs/dyn/reseller_v1.html index 877399bb80..b2519aa1d4 100644 --- a/docs/dyn/reseller_v1.html +++ b/docs/dyn/reseller_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/reseller_v1.subscriptions.html b/docs/dyn/reseller_v1.subscriptions.html index bbcc95a88c..e4fe52b814 100644 --- a/docs/dyn/reseller_v1.subscriptions.html +++ b/docs/dyn/reseller_v1.subscriptions.html @@ -102,7 +102,7 @@

Instance Methods

list(customerAuthToken=None, customerId=None, customerNamePrefix=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists of subscriptions managed by the reseller. The list can be all subscriptions, all of a customer's subscriptions, or all of a customer's transferable subscriptions. Optionally, this method can filter the response by a `customerNamePrefix`. For more information, see [manage subscriptions](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_subscriptions).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

startPaidService(customerId, subscriptionId, x__xgafv=None)

@@ -660,17 +660,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2.html b/docs/dyn/retail_v2.html index e276e5da12..6dc081e994 100644 --- a/docs/dyn/retail_v2.html +++ b/docs/dyn/retail_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html index 1b0f6af62e..c3025cdfc1 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Gets a list of Products.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -1228,17 +1228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.controls.html b/docs/dyn/retail_v2.projects.locations.catalogs.controls.html index cc1346b48b..02c5eb3e5e 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.controls.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent Catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -577,17 +577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.html b/docs/dyn/retail_v2.projects.locations.catalogs.html index 3211e059a8..c249b32a89 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.html @@ -157,7 +157,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Catalogs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -550,17 +550,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.models.html b/docs/dyn/retail_v2.projects.locations.catalogs.models.html index 674f62309e..b8a1a325f1 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.models.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.models.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the models linked to this event store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -289,17 +289,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.operations.html b/docs/dyn/retail_v2.projects.locations.catalogs.operations.html index 7db90d12e5..3468c8182d 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.operations.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html index 90b6227c00..0dff6b70dd 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.placements.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html @@ -87,7 +87,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -1108,17 +1108,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html index fdc85d0d27..b1eac47411 100644 --- a/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html +++ b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -111,7 +111,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -566,17 +566,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1659,17 +1659,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2.projects.locations.operations.html b/docs/dyn/retail_v2.projects.locations.operations.html index 1bdc23b8e6..f5916f513f 100644 --- a/docs/dyn/retail_v2.projects.locations.operations.html +++ b/docs/dyn/retail_v2.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2.projects.operations.html b/docs/dyn/retail_v2.projects.operations.html index ad04cbbf8f..77c8f787a8 100644 --- a/docs/dyn/retail_v2.projects.operations.html +++ b/docs/dyn/retail_v2.projects.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2alpha.html b/docs/dyn/retail_v2alpha.html index eca2550ddb..131b878f72 100644 --- a/docs/dyn/retail_v2alpha.html +++ b/docs/dyn/retail_v2alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html index 4ba0df2fa1..7a673921b6 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, requireTotalSize=None, x__xgafv=None)

Gets a list of Products.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -1293,17 +1293,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.controls.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.controls.html index 7e3d9f0ee4..1f9bea0b39 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.controls.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent Catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -577,17 +577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.html index c636684e5d..09aaf15d64 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.html @@ -162,7 +162,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Catalogs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -443,6 +443,7 @@

Method Details

"tableId": "A String", # Required. The BigQuery table to copy the data from with a length limit of 1,024 characters. }, }, + "enableAgentPrompts": True or False, # Optional. If set to true, the conversational shopping agent prompts will be served. Default value is false. "lastAllowlistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest allowlist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastDenylistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest denylist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastSuggestionsImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest suggestion terms list import. Can use GetOperation API method to retrieve the latest state of the Long Running Operation. @@ -607,17 +608,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -890,6 +891,7 @@

Method Details

"tableId": "A String", # Required. The BigQuery table to copy the data from with a length limit of 1,024 characters. }, }, + "enableAgentPrompts": True or False, # Optional. If set to true, the conversational shopping agent prompts will be served. Default value is false. "lastAllowlistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest allowlist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastDenylistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest denylist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastSuggestionsImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest suggestion terms list import. Can use GetOperation API method to retrieve the latest state of the Long Running Operation. @@ -952,6 +954,7 @@

Method Details

"tableId": "A String", # Required. The BigQuery table to copy the data from with a length limit of 1,024 characters. }, }, + "enableAgentPrompts": True or False, # Optional. If set to true, the conversational shopping agent prompts will be served. Default value is false. "lastAllowlistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest allowlist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastDenylistImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest denylist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation. "lastSuggestionsImportOperation": "A String", # Output only. Name of the LRO corresponding to the latest suggestion terms list import. Can use GetOperation API method to retrieve the latest state of the Long Running Operation. diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.models.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.models.html index 38a6386713..061940b3ec 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.models.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.models.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the models linked to this event store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -340,17 +340,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.operations.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.operations.html index 8856f984aa..cf579c0623 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.operations.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2alpha.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html index 99248bad22..adaaee410a 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html @@ -87,7 +87,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -1217,17 +1217,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2alpha.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html index 6a21cbb946..aac4f91cce 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html +++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -111,7 +111,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -566,17 +566,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1768,17 +1768,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2alpha.projects.locations.operations.html b/docs/dyn/retail_v2alpha.projects.locations.operations.html index a7814b89f9..f834963e17 100644 --- a/docs/dyn/retail_v2alpha.projects.locations.operations.html +++ b/docs/dyn/retail_v2alpha.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2alpha.projects.operations.html b/docs/dyn/retail_v2alpha.projects.operations.html index e6bdbd162e..f757517b9c 100644 --- a/docs/dyn/retail_v2alpha.projects.operations.html +++ b/docs/dyn/retail_v2alpha.projects.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2beta.html b/docs/dyn/retail_v2beta.html index 9594a5b33b..85e58fbb38 100644 --- a/docs/dyn/retail_v2beta.html +++ b/docs/dyn/retail_v2beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html index 69eb0acd5a..8b3f37df4d 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html @@ -102,7 +102,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

Gets a list of Products.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

@@ -1283,17 +1283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.controls.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.controls.html index 4ef61240ae..f00f937617 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.controls.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.controls.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Controls by their parent Catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -577,17 +577,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.html index 41eb04bd53..e5842cf456 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.html @@ -157,7 +157,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the Catalogs associated with the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -571,17 +571,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.models.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.models.html index 239703408d..25e79df205 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.models.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.models.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the models linked to this event store.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -289,17 +289,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.operations.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.operations.html index 31c9c83e06..5004e74a8a 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.operations.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2beta.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html index 38b2d87be2..9b92789605 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html @@ -87,7 +87,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -1108,17 +1108,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2beta.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html index 41999ad107..91b0b531f0 100644 --- a/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html +++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all ServingConfigs linked to this catalog.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -111,7 +111,7 @@

Instance Methods

search(placement, body=None, x__xgafv=None)

Performs a search. This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -566,17 +566,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1659,17 +1659,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2beta.projects.locations.operations.html b/docs/dyn/retail_v2beta.projects.locations.operations.html index d0286916b5..30f6dac785 100644 --- a/docs/dyn/retail_v2beta.projects.locations.operations.html +++ b/docs/dyn/retail_v2beta.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/retail_v2beta.projects.operations.html b/docs/dyn/retail_v2beta.projects.operations.html index 10f3fd0403..3ada471e22 100644 --- a/docs/dyn/retail_v2beta.projects.operations.html +++ b/docs/dyn/retail_v2beta.projects.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v1.html b/docs/dyn/run_v1.html index 9c0d348ea2..e0c1029fab 100644 --- a/docs/dyn/run_v1.html +++ b/docs/dyn/run_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/run_v1.namespaces.authorizeddomains.html b/docs/dyn/run_v1.namespaces.authorizeddomains.html index 3a845b2d7a..8e80940d28 100644 --- a/docs/dyn/run_v1.namespaces.authorizeddomains.html +++ b/docs/dyn/run_v1.namespaces.authorizeddomains.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List authorized domains.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v1.namespaces.configurations.html b/docs/dyn/run_v1.namespaces.configurations.html index e3f4ce36c3..5bea3ceddc 100644 --- a/docs/dyn/run_v1.namespaces.configurations.html +++ b/docs/dyn/run_v1.namespaces.configurations.html @@ -107,7 +107,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of resource, in this case always "Configuration". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Configuration, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -141,7 +141,7 @@

Method Details

"spec": { # ConfigurationSpec holds the desired state of the Configuration (from the client). # Spec holds the desired state of the Configuration (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Template holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -462,7 +462,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of resource, in this case always "Configuration". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Configuration, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -496,7 +496,7 @@

Method Details

"spec": { # ConfigurationSpec holds the desired state of the Configuration (from the client). # Spec holds the desired state of the Configuration (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Template holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.domainmappings.html b/docs/dyn/run_v1.namespaces.domainmappings.html index 159a367f59..1b8c957522 100644 --- a/docs/dyn/run_v1.namespaces.domainmappings.html +++ b/docs/dyn/run_v1.namespaces.domainmappings.html @@ -108,7 +108,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -181,7 +181,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -305,7 +305,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -394,7 +394,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.executions.html b/docs/dyn/run_v1.namespaces.executions.html index f93ec5685f..8d69017c14 100644 --- a/docs/dyn/run_v1.namespaces.executions.html +++ b/docs/dyn/run_v1.namespaces.executions.html @@ -114,7 +114,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -478,7 +478,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -803,7 +803,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.instances.html b/docs/dyn/run_v1.namespaces.instances.html index 65150085d0..dfe343355a 100644 --- a/docs/dyn/run_v1.namespaces.instances.html +++ b/docs/dyn/run_v1.namespaces.instances.html @@ -117,7 +117,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -414,7 +414,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -762,7 +762,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1075,7 +1075,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1384,7 +1384,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1681,7 +1681,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1991,7 +1991,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2301,7 +2301,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.jobs.html b/docs/dyn/run_v1.namespaces.jobs.html index 0fa33d498d..52e4bca91e 100644 --- a/docs/dyn/run_v1.namespaces.jobs.html +++ b/docs/dyn/run_v1.namespaces.jobs.html @@ -114,7 +114,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -150,7 +150,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -461,7 +461,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -497,7 +497,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -859,7 +859,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -895,7 +895,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1222,7 +1222,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1258,7 +1258,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1581,7 +1581,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1617,7 +1617,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1928,7 +1928,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1964,7 +1964,7 @@

Method Details

"startExecutionToken": "A String", # A unique string used as a suffix for creating a new execution. The Job will become ready when the execution is successfully started. The sum of job name and token length must be fewer than 63 characters. "template": { # ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. # Optional. Describes the execution that will be created when running a job. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Optional metadata for this Execution, including labels and annotations. The following annotation keys set properties of the created execution: * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2325,7 +2325,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.revisions.html b/docs/dyn/run_v1.namespaces.revisions.html index 393bf7ac18..b77aecf5a5 100644 --- a/docs/dyn/run_v1.namespaces.revisions.html +++ b/docs/dyn/run_v1.namespaces.revisions.html @@ -155,7 +155,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case "Revision". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Revision, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -476,7 +476,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case "Revision". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Revision, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.routes.html b/docs/dyn/run_v1.namespaces.routes.html index 88e105def4..605ffd7e14 100644 --- a/docs/dyn/run_v1.namespaces.routes.html +++ b/docs/dyn/run_v1.namespaces.routes.html @@ -107,7 +107,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case always "Route". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Route, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -208,7 +208,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case always "Route". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Route, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.services.html b/docs/dyn/run_v1.namespaces.services.html index 4483a75cbc..9e873de37d 100644 --- a/docs/dyn/run_v1.namespaces.services.html +++ b/docs/dyn/run_v1.namespaces.services.html @@ -111,7 +111,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -145,7 +145,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -474,7 +474,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -508,7 +508,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -888,7 +888,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -922,7 +922,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1267,7 +1267,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1301,7 +1301,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1642,7 +1642,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1676,7 +1676,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2005,7 +2005,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2039,7 +2039,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.tasks.html b/docs/dyn/run_v1.namespaces.tasks.html index 0686d264b9..0115ad2729 100644 --- a/docs/dyn/run_v1.namespaces.tasks.html +++ b/docs/dyn/run_v1.namespaces.tasks.html @@ -107,7 +107,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -435,7 +435,7 @@

Method Details

"apiVersion": "A String", # Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. "kind": "A String", # Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional. Standard object's metadata. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.namespaces.workerpools.html b/docs/dyn/run_v1.namespaces.workerpools.html index 9b92e8d13f..296a75206c 100644 --- a/docs/dyn/run_v1.namespaces.workerpools.html +++ b/docs/dyn/run_v1.namespaces.workerpools.html @@ -111,7 +111,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -152,7 +152,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -464,7 +464,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -505,7 +505,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -865,7 +865,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -906,7 +906,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1230,7 +1230,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1271,7 +1271,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1595,7 +1595,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1636,7 +1636,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1948,7 +1948,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "run.googleapis.com/v1". "kind": "A String", # The kind of resource. It must be "WorkerPool". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this WorkerPool, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in WorkerPool.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/description` - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1989,7 +1989,7 @@

Method Details

], "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.projects.authorizeddomains.html b/docs/dyn/run_v1.projects.authorizeddomains.html index e220026c30..b02e2744ba 100644 --- a/docs/dyn/run_v1.projects.authorizeddomains.html +++ b/docs/dyn/run_v1.projects.authorizeddomains.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List authorized domains.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v1.projects.locations.authorizeddomains.html b/docs/dyn/run_v1.projects.locations.authorizeddomains.html index 9053d51915..e0563d56a2 100644 --- a/docs/dyn/run_v1.projects.locations.authorizeddomains.html +++ b/docs/dyn/run_v1.projects.locations.authorizeddomains.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List authorized domains.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -117,17 +117,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v1.projects.locations.configurations.html b/docs/dyn/run_v1.projects.locations.configurations.html index 0b5a4c6832..5243b651b4 100644 --- a/docs/dyn/run_v1.projects.locations.configurations.html +++ b/docs/dyn/run_v1.projects.locations.configurations.html @@ -107,7 +107,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of resource, in this case always "Configuration". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Configuration, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -141,7 +141,7 @@

Method Details

"spec": { # ConfigurationSpec holds the desired state of the Configuration (from the client). # Spec holds the desired state of the Configuration (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Template holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -462,7 +462,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of resource, in this case always "Configuration". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Configuration, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -496,7 +496,7 @@

Method Details

"spec": { # ConfigurationSpec holds the desired state of the Configuration (from the client). # Spec holds the desired state of the Configuration (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Template holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.projects.locations.domainmappings.html b/docs/dyn/run_v1.projects.locations.domainmappings.html index c3b6cb38d5..b89b867d73 100644 --- a/docs/dyn/run_v1.projects.locations.domainmappings.html +++ b/docs/dyn/run_v1.projects.locations.domainmappings.html @@ -108,7 +108,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -181,7 +181,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -305,7 +305,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -394,7 +394,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "domains.cloudrun.com/v1". "kind": "A String", # The kind of resource, in this case "DomainMapping". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this BuildTemplate. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.projects.locations.html b/docs/dyn/run_v1.projects.locations.html index 80f95e2432..56a6d655c5 100644 --- a/docs/dyn/run_v1.projects.locations.html +++ b/docs/dyn/run_v1.projects.locations.html @@ -131,7 +131,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v1.projects.locations.operations.html b/docs/dyn/run_v1.projects.locations.operations.html index 71e1a1b83d..a3b2271053 100644 --- a/docs/dyn/run_v1.projects.locations.operations.html +++ b/docs/dyn/run_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v1.projects.locations.revisions.html b/docs/dyn/run_v1.projects.locations.revisions.html index d70daef461..8678181c22 100644 --- a/docs/dyn/run_v1.projects.locations.revisions.html +++ b/docs/dyn/run_v1.projects.locations.revisions.html @@ -155,7 +155,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case "Revision". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Revision, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -476,7 +476,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case "Revision". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Revision, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.projects.locations.routes.html b/docs/dyn/run_v1.projects.locations.routes.html index 42aa75d263..b9245cea88 100644 --- a/docs/dyn/run_v1.projects.locations.routes.html +++ b/docs/dyn/run_v1.projects.locations.routes.html @@ -107,7 +107,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case always "Route". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Route, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -208,7 +208,7 @@

Method Details

"apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1". "kind": "A String", # The kind of this resource, in this case always "Route". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Route, including name, namespace, labels, and annotations. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v1.projects.locations.services.html b/docs/dyn/run_v1.projects.locations.services.html index 9f0b5379dc..fa6ac6041e 100644 --- a/docs/dyn/run_v1.projects.locations.services.html +++ b/docs/dyn/run_v1.projects.locations.services.html @@ -120,7 +120,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -154,7 +154,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -483,7 +483,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -517,7 +517,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -897,7 +897,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -931,7 +931,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1324,7 +1324,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1358,7 +1358,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1699,7 +1699,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -1733,7 +1733,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2062,7 +2062,7 @@

Method Details

"apiVersion": "A String", # The API version for this call. It must be "serving.knative.dev/v1". "kind": "A String", # The kind of resource. It must be "Service". "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Metadata associated with this Service, including name, namespace, labels, and annotations. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/base-images` * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/default-url-disabled` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run @@ -2096,7 +2096,7 @@

Method Details

"spec": { # ServiceSpec holds the desired state of the Route (from the client), which is used to manipulate the underlying Route and Configuration(s). # Holds the desired state of the Service (from the client). "template": { # RevisionTemplateSpec describes the data a revision should have when created from a template. # Holds the latest specification for the Revision to be stamped out. "metadata": { # google.cloud.run.meta.v1.ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. # Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. - "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. + "annotations": { # Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance. "a_key": "A String", }, "clusterName": "A String", # Not supported by Cloud Run diff --git a/docs/dyn/run_v2.html b/docs/dyn/run_v2.html index 1061ba6d67..5f67ef121a 100644 --- a/docs/dyn/run_v2.html +++ b/docs/dyn/run_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/run_v2.projects.locations.instances.html b/docs/dyn/run_v2.projects.locations.instances.html index 3c9b95cd1b..e3a58b8986 100644 --- a/docs/dyn/run_v2.projects.locations.instances.html +++ b/docs/dyn/run_v2.projects.locations.instances.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Instances. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1081,17 +1081,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v2.projects.locations.jobs.executions.html b/docs/dyn/run_v2.projects.locations.jobs.executions.html index 681d5a870f..a73b7e2e75 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.executions.html +++ b/docs/dyn/run_v2.projects.locations.jobs.executions.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Executions from a Job. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -765,17 +765,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v2.projects.locations.jobs.executions.tasks.html b/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html index 8234ae65d0..ab3e808b50 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html +++ b/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Tasks from an Execution of a Job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -643,17 +643,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v2.projects.locations.jobs.html b/docs/dyn/run_v2.projects.locations.jobs.html index cce939fe82..7f94c19a5d 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.html +++ b/docs/dyn/run_v2.projects.locations.jobs.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Jobs. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, validateOnly=None, x__xgafv=None)

@@ -1128,17 +1128,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v2.projects.locations.operations.html b/docs/dyn/run_v2.projects.locations.operations.html index e76cc4a80d..f6f72d9bc8 100644 --- a/docs/dyn/run_v2.projects.locations.operations.html +++ b/docs/dyn/run_v2.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v2.projects.locations.services.html b/docs/dyn/run_v2.projects.locations.services.html index 398a84d206..acf79ffde7 100644 --- a/docs/dyn/run_v2.projects.locations.services.html +++ b/docs/dyn/run_v2.projects.locations.services.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Services. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, forceNewRevision=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1299,17 +1299,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v2.projects.locations.services.revisions.html b/docs/dyn/run_v2.projects.locations.services.revisions.html index 50228d9aa5..800e1085b6 100644 --- a/docs/dyn/run_v2.projects.locations.services.revisions.html +++ b/docs/dyn/run_v2.projects.locations.services.revisions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -722,17 +722,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/run_v2.projects.locations.workerPools.html b/docs/dyn/run_v2.projects.locations.workerPools.html index d94786ce16..b906cd0668 100644 --- a/docs/dyn/run_v2.projects.locations.workerPools.html +++ b/docs/dyn/run_v2.projects.locations.workerPools.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists WorkerPools. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, forceNewRevision=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1143,17 +1143,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/run_v2.projects.locations.workerPools.revisions.html b/docs/dyn/run_v2.projects.locations.workerPools.revisions.html index 009d6a2b3a..bdd6a34e05 100644 --- a/docs/dyn/run_v2.projects.locations.workerPools.revisions.html +++ b/docs/dyn/run_v2.projects.locations.workerPools.revisions.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -683,17 +683,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/runtimeconfig_v1.html b/docs/dyn/runtimeconfig_v1.html index 36d5586c1c..b8679b4619 100644 --- a/docs/dyn/runtimeconfig_v1.html +++ b/docs/dyn/runtimeconfig_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/runtimeconfig_v1.operations.html b/docs/dyn/runtimeconfig_v1.operations.html index 0c0f53488d..33369f50a0 100644 --- a/docs/dyn/runtimeconfig_v1.operations.html +++ b/docs/dyn/runtimeconfig_v1.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/runtimeconfig_v1beta1.html b/docs/dyn/runtimeconfig_v1beta1.html index 2b2e3fc289..43db9c8f98 100644 --- a/docs/dyn/runtimeconfig_v1beta1.html +++ b/docs/dyn/runtimeconfig_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.html index 26bfbffcb8..67ec210d9b 100644 --- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.html +++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.html @@ -108,7 +108,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the RuntimeConfig resources within project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html index 65073ee65c..844889ffa9 100644 --- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html +++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, returnValues=None, x__xgafv=None)

Lists variables within given a configuration, matching any provided filters. This only lists variable names, not the values, unless `return_values` is true, in which case only variables that user has IAM permission to GetVariable will be returned.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(resource, body=None, x__xgafv=None)

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html index 242cea674c..61a0c03f81 100644 --- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html +++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List waiters within the given configuration.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(resource, body=None, x__xgafv=None)

@@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.html b/docs/dyn/saasservicemgmt_v1.html index 511c4571dd..d4d9f81d63 100644 --- a/docs/dyn/saasservicemgmt_v1.html +++ b/docs/dyn/saasservicemgmt_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.html b/docs/dyn/saasservicemgmt_v1.projects.locations.html index f141f765db..b932b877a4 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.html @@ -124,7 +124,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/saasservicemgmt_v1.projects.locations.releases.html b/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html index 0621909f20..023bf79cbe 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of releases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -370,17 +370,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.rolloutKinds.html b/docs/dyn/saasservicemgmt_v1.projects.locations.rolloutKinds.html index 144459f3fe..71f97731ff 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.rolloutKinds.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.rolloutKinds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of rollout kinds.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html b/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html index beb8cfcf5a..1dc152384c 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of rollouts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html b/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html index 35b9bc4ff8..ff083da45f 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of saas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -338,17 +338,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.tenants.html b/docs/dyn/saasservicemgmt_v1.projects.locations.tenants.html index 686a670916..6778aee2be 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.tenants.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.tenants.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of tenants.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html b/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html index dcec582e04..8e6dbdde63 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit kinds.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -402,17 +402,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html b/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html index fd4d02ff5f..e8da957c99 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit operations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.units.html b/docs/dyn/saasservicemgmt_v1.projects.locations.units.html index d3ae2f44a1..d7ab3fea96 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.units.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.units.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of units.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -478,17 +478,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.html b/docs/dyn/saasservicemgmt_v1beta1.html index 9dd84fa122..dd752e1c0e 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.html +++ b/docs/dyn/saasservicemgmt_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagAttributes.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagAttributes.html index 8379afcfbe..f8231af508 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagAttributes.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagAttributes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of flag attributes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagReleases.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagReleases.html index c46c5ea288..7176801086 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagReleases.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagReleases.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of flag releases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html index 1918519494..deccff9039 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of flag revisions.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -666,17 +666,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html index 359b743919..9ffe66e962 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of flags.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -462,17 +462,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.html index b543c0da05..970289e7dc 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.html @@ -159,7 +159,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -231,17 +231,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/saasservicemgmt_v1beta1.projects.locations.releases.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html index 63aa446e2c..4829c0eb6c 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of releases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -406,17 +406,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rolloutKinds.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rolloutKinds.html index 994b6a2ec7..1d32a35206 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rolloutKinds.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rolloutKinds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of rollout kinds.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -298,17 +298,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html index 4a98914736..6bfdfee456 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of rollouts.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html index 5544b27a24..faf42e221e 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of saas.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -362,17 +362,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saasReleases.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saasReleases.html index 0e22dd7ac4..11da80367e 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saasReleases.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saasReleases.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of saas releases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.tenants.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.tenants.html index a4d2d2d0f4..9a3ad454e6 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.tenants.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.tenants.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of tenants.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -250,17 +250,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroupOperations.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroupOperations.html index b064df3286..eb6e217232 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroupOperations.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroupOperations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit group operations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroups.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroups.html index 958b626976..1c8a922577 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroups.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitGroups.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit groups.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html index a0e038af20..8321d722ab 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit kinds.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -462,17 +462,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html index 0183c4131c..27dc811785 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of unit operations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.units.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.units.html index a1b1483131..65be4a55e2 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.units.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.units.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Retrieve a collection of units.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -490,17 +490,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/safebrowsing_v4.html b/docs/dyn/safebrowsing_v4.html index 12f0ba86e0..700b30c926 100644 --- a/docs/dyn/safebrowsing_v4.html +++ b/docs/dyn/safebrowsing_v4.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/safebrowsing_v5.hashLists.html b/docs/dyn/safebrowsing_v5.hashLists.html index f5dcc50ebe..a37a395d38 100644 --- a/docs/dyn/safebrowsing_v5.hashLists.html +++ b/docs/dyn/safebrowsing_v5.hashLists.html @@ -84,7 +84,7 @@

Instance Methods

list(pageSize=None, pageToken=None, x__xgafv=None)

Lists hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need. This is a standard List method as defined by https://google.aip.dev/132 and the HTTP method is GET.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -240,17 +240,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/safebrowsing_v5.html b/docs/dyn/safebrowsing_v5.html index c12056adae..0c4b484547 100644 --- a/docs/dyn/safebrowsing_v5.html +++ b/docs/dyn/safebrowsing_v5.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/sasportal_v1alpha1.customers.deployments.devices.html b/docs/dyn/sasportal_v1alpha1.customers.deployments.devices.html index d39bc74c0e..c8ce9308f7 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.deployments.devices.html +++ b/docs/dyn/sasportal_v1alpha1.customers.deployments.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.customers.deployments.html b/docs/dyn/sasportal_v1alpha1.customers.deployments.html index 62a17c86ad..38ff2b5e55 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.deployments.html +++ b/docs/dyn/sasportal_v1alpha1.customers.deployments.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.customers.devices.html b/docs/dyn/sasportal_v1alpha1.customers.devices.html index 653b7ae97e..ed6797f9a0 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.devices.html +++ b/docs/dyn/sasportal_v1alpha1.customers.devices.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -901,17 +901,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.customers.html b/docs/dyn/sasportal_v1alpha1.customers.html index 9c1156c541..c96f6d8db3 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.html +++ b/docs/dyn/sasportal_v1alpha1.customers.html @@ -105,7 +105,7 @@

Instance Methods

listLegacyOrganizations(x__xgafv=None)

Returns a list of legacy organizations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrateOrganization(body=None, x__xgafv=None)

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.customers.nodes.deployments.html b/docs/dyn/sasportal_v1alpha1.customers.nodes.deployments.html index bf9064097f..9b336b4e4d 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.nodes.deployments.html +++ b/docs/dyn/sasportal_v1alpha1.customers.nodes.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.customers.nodes.devices.html b/docs/dyn/sasportal_v1alpha1.customers.nodes.devices.html index e347b6c71f..61b05c015f 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.nodes.devices.html +++ b/docs/dyn/sasportal_v1alpha1.customers.nodes.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.customers.nodes.html b/docs/dyn/sasportal_v1alpha1.customers.nodes.html index 947044926d..a7005da19b 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.nodes.html +++ b/docs/dyn/sasportal_v1alpha1.customers.nodes.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.customers.nodes.nodes.html b/docs/dyn/sasportal_v1alpha1.customers.nodes.nodes.html index 38bb2d916a..daa18888e7 100644 --- a/docs/dyn/sasportal_v1alpha1.customers.nodes.nodes.html +++ b/docs/dyn/sasportal_v1alpha1.customers.nodes.nodes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.html b/docs/dyn/sasportal_v1alpha1.html index 12c65e29e1..2164423bd5 100644 --- a/docs/dyn/sasportal_v1alpha1.html +++ b/docs/dyn/sasportal_v1alpha1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/sasportal_v1alpha1.nodes.deployments.devices.html b/docs/dyn/sasportal_v1alpha1.nodes.deployments.devices.html index 43e2d56c5b..41a9f38108 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.deployments.devices.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.deployments.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.nodes.deployments.html b/docs/dyn/sasportal_v1alpha1.nodes.deployments.html index 4e708dd03f..7e63141831 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.deployments.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.deployments.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -185,17 +185,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.nodes.devices.html b/docs/dyn/sasportal_v1alpha1.nodes.devices.html index f781b57437..21ff718941 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.devices.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.devices.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -901,17 +901,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.nodes.nodes.deployments.html b/docs/dyn/sasportal_v1alpha1.nodes.nodes.deployments.html index 2c21d7a0af..6a818caa12 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.nodes.deployments.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.nodes.deployments.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists deployments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.nodes.nodes.devices.html b/docs/dyn/sasportal_v1alpha1.nodes.nodes.devices.html index 23163aa95e..9768a86f47 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.nodes.devices.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.nodes.devices.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists devices under a node or customer.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -712,17 +712,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sasportal_v1alpha1.nodes.nodes.html b/docs/dyn/sasportal_v1alpha1.nodes.nodes.html index 5c503e42e8..b33ed9e053 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.nodes.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.nodes.html @@ -105,7 +105,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sasportal_v1alpha1.nodes.nodes.nodes.html b/docs/dyn/sasportal_v1alpha1.nodes.nodes.nodes.html index 158874d235..bfa44c9641 100644 --- a/docs/dyn/sasportal_v1alpha1.nodes.nodes.nodes.html +++ b/docs/dyn/sasportal_v1alpha1.nodes.nodes.nodes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -158,17 +158,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/script_v1.html b/docs/dyn/script_v1.html index 89482b9013..9f2a041918 100644 --- a/docs/dyn/script_v1.html +++ b/docs/dyn/script_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/script_v1.processes.html b/docs/dyn/script_v1.processes.html index a7b46c53f8..23835cbb6e 100644 --- a/docs/dyn/script_v1.processes.html +++ b/docs/dyn/script_v1.processes.html @@ -84,10 +84,10 @@

Instance Methods

listScriptProcesses(pageSize=None, pageToken=None, scriptId=None, scriptProcessFilter_deploymentId=None, scriptProcessFilter_endTime=None, scriptProcessFilter_functionName=None, scriptProcessFilter_startTime=None, scriptProcessFilter_statuses=None, scriptProcessFilter_types=None, scriptProcessFilter_userAccessLevels=None, x__xgafv=None)

List information about a script's executed processes, such as process type and current status.

- listScriptProcesses_next(previous_request, previous_response)

+ listScriptProcesses_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -233,31 +233,31 @@

Method Details

- listScriptProcesses_next(previous_request, previous_response) + listScriptProcesses_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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/script_v1.projects.deployments.html b/docs/dyn/script_v1.projects.deployments.html index 8912d97491..3440ac12d8 100644 --- a/docs/dyn/script_v1.projects.deployments.html +++ b/docs/dyn/script_v1.projects.deployments.html @@ -90,7 +90,7 @@

Instance Methods

list(scriptId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the deployments of an Apps Script project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(scriptId, deploymentId, body=None, x__xgafv=None)

@@ -292,17 +292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/script_v1.projects.versions.html b/docs/dyn/script_v1.projects.versions.html index 3eb6287708..af85ff45ca 100644 --- a/docs/dyn/script_v1.projects.versions.html +++ b/docs/dyn/script_v1.projects.versions.html @@ -87,7 +87,7 @@

Instance Methods

list(scriptId, pageSize=None, pageToken=None, x__xgafv=None)

List the versions of a script project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -180,17 +180,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/searchads360_v0.customers.searchAds360.html b/docs/dyn/searchads360_v0.customers.searchAds360.html index 8f87145129..e444190f42 100644 --- a/docs/dyn/searchads360_v0.customers.searchAds360.html +++ b/docs/dyn/searchads360_v0.customers.searchAds360.html @@ -81,7 +81,7 @@

Instance Methods

search(customerId, body=None, x__xgafv=None)

Returns all rows that match the search query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [ChangeEventError]() [ChangeStatusError]() [ClickViewError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -2666,17 +2666,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/searchads360_v0.html b/docs/dyn/searchads360_v0.html index 3694d35239..de6193b828 100644 --- a/docs/dyn/searchads360_v0.html +++ b/docs/dyn/searchads360_v0.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/searchads360_v0.searchAds360Fields.html b/docs/dyn/searchads360_v0.searchAds360Fields.html index 273e44eacc..8714418fdc 100644 --- a/docs/dyn/searchads360_v0.searchAds360Fields.html +++ b/docs/dyn/searchads360_v0.searchAds360Fields.html @@ -84,7 +84,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Returns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details). List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/searchads360_v23.customers.batchJobs.html b/docs/dyn/searchads360_v23.customers.batchJobs.html index 376ad4bd52..c25b378018 100644 --- a/docs/dyn/searchads360_v23.customers.batchJobs.html +++ b/docs/dyn/searchads360_v23.customers.batchJobs.html @@ -84,7 +84,7 @@

Instance Methods

listResults(resourceName, pageSize=None, pageToken=None, responseContentType=None, x__xgafv=None)

Returns the results of the batch job. The job must be done. Supports standard list paging. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [BatchJobError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

- listResults_next(previous_request, previous_response)

+ listResults_next()

Retrieves the next page of results.

mutate(customerId, body=None, x__xgafv=None)

@@ -22726,17 +22726,17 @@

Method Details

- listResults_next(previous_request, previous_response) + listResults_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/searchads360_v23.customers.campaignDrafts.html b/docs/dyn/searchads360_v23.customers.campaignDrafts.html index 92a1cd9ea5..49181a1493 100644 --- a/docs/dyn/searchads360_v23.customers.campaignDrafts.html +++ b/docs/dyn/searchads360_v23.customers.campaignDrafts.html @@ -81,7 +81,7 @@

Instance Methods

listAsyncErrors(resourceName, pageSize=None, pageToken=None, x__xgafv=None)

Returns all errors that occurred during CampaignDraft promote. Throws an error if called before campaign draft is promoted. Supports standard list paging. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

- listAsyncErrors_next(previous_request, previous_response)

+ listAsyncErrors_next()

Retrieves the next page of results.

mutate(customerId, body=None, x__xgafv=None)

@@ -128,17 +128,17 @@

Method Details

- listAsyncErrors_next(previous_request, previous_response) + listAsyncErrors_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/searchads360_v23.customers.experiments.html b/docs/dyn/searchads360_v23.customers.experiments.html index d65e53555f..317ec3abfd 100644 --- a/docs/dyn/searchads360_v23.customers.experiments.html +++ b/docs/dyn/searchads360_v23.customers.experiments.html @@ -87,7 +87,7 @@

Instance Methods

listExperimentAsyncErrors(resourceName, pageSize=None, pageToken=None, x__xgafv=None)

Returns all errors that occurred during the last Experiment update (either scheduling or promotion). Supports standard list paging. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

- listExperimentAsyncErrors_next(previous_request, previous_response)

+ listExperimentAsyncErrors_next()

Retrieves the next page of results.

mutate(customerId, body=None, x__xgafv=None)

@@ -193,17 +193,17 @@

Method Details

- listExperimentAsyncErrors_next(previous_request, previous_response) + listExperimentAsyncErrors_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/searchads360_v23.customers.html b/docs/dyn/searchads360_v23.customers.html index bfddd86718..6b01cff12c 100644 --- a/docs/dyn/searchads360_v23.customers.html +++ b/docs/dyn/searchads360_v23.customers.html @@ -573,7 +573,7 @@

Instance Methods

generateKeywordIdeas(customerId, body=None, x__xgafv=None)

Returns a list of keyword ideas. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [CollectionSizeError]() [HeaderError]() [InternalError]() [KeywordPlanIdeaError]() [QuotaError]() [RequestError]()

- generateKeywordIdeas_next(previous_request, previous_response)

+ generateKeywordIdeas_next()

Retrieves the next page of results.

generateReachForecast(customerId, body=None, x__xgafv=None)

@@ -2359,17 +2359,17 @@

Method Details

- generateKeywordIdeas_next(previous_request, previous_response) + generateKeywordIdeas_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/searchads360_v23.customers.searchAds360.html b/docs/dyn/searchads360_v23.customers.searchAds360.html index 2378786ee0..e0ce4c9141 100644 --- a/docs/dyn/searchads360_v23.customers.searchAds360.html +++ b/docs/dyn/searchads360_v23.customers.searchAds360.html @@ -84,7 +84,7 @@

Instance Methods

search(customerId, body=None, x__xgafv=None)

Returns all rows that match the search query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [ChangeEventError]() [ChangeStatusError]() [ClickViewError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -111818,17 +111818,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/searchads360_v23.html b/docs/dyn/searchads360_v23.html index 688f622352..f55a2b25bb 100644 --- a/docs/dyn/searchads360_v23.html +++ b/docs/dyn/searchads360_v23.html @@ -113,7 +113,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -122,20 +122,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/searchads360_v23.searchAds360Fields.html b/docs/dyn/searchads360_v23.searchAds360Fields.html index 69e4d6f0df..a4e65e4b4a 100644 --- a/docs/dyn/searchads360_v23.searchAds360Fields.html +++ b/docs/dyn/searchads360_v23.searchAds360Fields.html @@ -84,7 +84,7 @@

Instance Methods

search(body=None, x__xgafv=None)

Returns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details). List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -191,17 +191,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/searchconsole_v1.html b/docs/dyn/searchconsole_v1.html index 384d507930..b8ea199164 100644 --- a/docs/dyn/searchconsole_v1.html +++ b/docs/dyn/searchconsole_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/secretmanager_v1.html b/docs/dyn/secretmanager_v1.html index fa042e34fd..f06ad8de9e 100644 --- a/docs/dyn/secretmanager_v1.html +++ b/docs/dyn/secretmanager_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/secretmanager_v1.projects.locations.html b/docs/dyn/secretmanager_v1.projects.locations.html index bf7401a6d6..1ac8dc4425 100644 --- a/docs/dyn/secretmanager_v1.projects.locations.html +++ b/docs/dyn/secretmanager_v1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1.projects.locations.secrets.html b/docs/dyn/secretmanager_v1.projects.locations.secrets.html index 7551828c6f..cf7b8d3147 100644 --- a/docs/dyn/secretmanager_v1.projects.locations.secrets.html +++ b/docs/dyn/secretmanager_v1.projects.locations.secrets.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Secrets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -629,17 +629,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/secretmanager_v1.projects.locations.secrets.versions.html b/docs/dyn/secretmanager_v1.projects.locations.secrets.versions.html index 300fd69d1e..cbb4726d3d 100644 --- a/docs/dyn/secretmanager_v1.projects.locations.secrets.versions.html +++ b/docs/dyn/secretmanager_v1.projects.locations.secrets.versions.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecretVersions. This call does not return secret data.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1.projects.secrets.html b/docs/dyn/secretmanager_v1.projects.secrets.html index a61613d4bd..4efe7010ba 100644 --- a/docs/dyn/secretmanager_v1.projects.secrets.html +++ b/docs/dyn/secretmanager_v1.projects.secrets.html @@ -104,7 +104,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Secrets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -629,17 +629,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/secretmanager_v1.projects.secrets.versions.html b/docs/dyn/secretmanager_v1.projects.secrets.versions.html index 9cb8685aea..c62356c5ba 100644 --- a/docs/dyn/secretmanager_v1.projects.secrets.versions.html +++ b/docs/dyn/secretmanager_v1.projects.secrets.versions.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecretVersions. This call does not return secret data.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1beta1.html b/docs/dyn/secretmanager_v1beta1.html index 3d2e933a9b..49b9f0d4d3 100644 --- a/docs/dyn/secretmanager_v1beta1.html +++ b/docs/dyn/secretmanager_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/secretmanager_v1beta1.projects.locations.html b/docs/dyn/secretmanager_v1beta1.projects.locations.html index 73d8baa5ea..c0f83e2134 100644 --- a/docs/dyn/secretmanager_v1beta1.projects.locations.html +++ b/docs/dyn/secretmanager_v1beta1.projects.locations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -156,17 +156,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1beta1.projects.secrets.html b/docs/dyn/secretmanager_v1beta1.projects.secrets.html index 5e2ffd7ae5..223d1ae4b5 100644 --- a/docs/dyn/secretmanager_v1beta1.projects.secrets.html +++ b/docs/dyn/secretmanager_v1beta1.projects.secrets.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Secrets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -361,17 +361,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/secretmanager_v1beta1.projects.secrets.versions.html b/docs/dyn/secretmanager_v1beta1.projects.secrets.versions.html index 961a61545f..dc26858f99 100644 --- a/docs/dyn/secretmanager_v1beta1.projects.secrets.versions.html +++ b/docs/dyn/secretmanager_v1beta1.projects.secrets.versions.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecretVersions. This call does not return secret data.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1beta2.html b/docs/dyn/secretmanager_v1beta2.html index fa617a4732..7befb4016a 100644 --- a/docs/dyn/secretmanager_v1beta2.html +++ b/docs/dyn/secretmanager_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/secretmanager_v1beta2.projects.locations.html b/docs/dyn/secretmanager_v1beta2.projects.locations.html index af9e9c0279..a9119d8ea8 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.locations.html +++ b/docs/dyn/secretmanager_v1beta2.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1beta2.projects.locations.secrets.html b/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.html index c9a7ab7e2a..07013f1898 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.html +++ b/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Secrets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -499,17 +499,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.versions.html b/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.versions.html index 22fe6cfbf9..5b03791277 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.versions.html +++ b/docs/dyn/secretmanager_v1beta2.projects.locations.secrets.versions.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecretVersions. This call does not return secret data.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/secretmanager_v1beta2.projects.secrets.html b/docs/dyn/secretmanager_v1beta2.projects.secrets.html index a4aa5cfb12..e439a35b78 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.secrets.html +++ b/docs/dyn/secretmanager_v1beta2.projects.secrets.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Secrets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -499,17 +499,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/secretmanager_v1beta2.projects.secrets.versions.html b/docs/dyn/secretmanager_v1beta2.projects.secrets.versions.html index 095bc93d34..85d5f6a33a 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.secrets.versions.html +++ b/docs/dyn/secretmanager_v1beta2.projects.secrets.versions.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists SecretVersions. This call does not return secret data.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -383,17 +383,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securesourcemanager_v1.html b/docs/dyn/securesourcemanager_v1.html index 8b9101efdc..81fae6df7d 100644 --- a/docs/dyn/securesourcemanager_v1.html +++ b/docs/dyn/securesourcemanager_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.html b/docs/dyn/securesourcemanager_v1.projects.locations.html index 390c039774..df1293fbd8 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.html @@ -99,7 +99,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -171,17 +171,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securesourcemanager_v1.projects.locations.instances.html b/docs/dyn/securesourcemanager_v1.projects.locations.instances.html index 9103693e5d..011b97ef8a 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.instances.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.instances.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Instances in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.operations.html b/docs/dyn/securesourcemanager_v1.projects.locations.operations.html index fe87427386..268e243273 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.operations.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -219,17 +219,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securesourcemanager_v1.projects.locations.repositories.branchRules.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.branchRules.html index 2be1b336a8..e7e93c108a 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.branchRules.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.branchRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

ListBranchRules lists branch rules in a given repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -286,17 +286,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.hooks.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.hooks.html index 93478be644..d20d5c0384 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.hooks.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.hooks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists hooks in a given repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.html index ae9a7d4494..8448d7d078 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.html @@ -110,7 +110,7 @@

Instance Methods

fetchTree(repository, pageSize=None, pageToken=None, recursive=None, ref=None, x__xgafv=None)

Fetches a tree from a repository.

- fetchTree_next(previous_request, previous_response)

+ fetchTree_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

list(parent, filter=None, instance=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Repositories in a given project and location. The instance field is required in the query parameter for requests using the securesourcemanager.googleapis.com endpoint.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -291,17 +291,17 @@

Method Details

- fetchTree_next(previous_request, previous_response) + fetchTree_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)
+        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.
-
+ 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. +
@@ -438,17 +438,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.html index c63e4c3e0f..cf937bcabe 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists issues in a repository.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

open(name, body=None, x__xgafv=None)

@@ -292,17 +292,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.issueComments.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.issueComments.html index e12bb27f07..0a5387f203 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.issueComments.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.issues.issueComments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists comments in an issue.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -233,17 +233,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.html index 95d62ac491..1dec3ec7f3 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.html @@ -95,10 +95,10 @@

Instance Methods

listFileDiffs(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists a pull request's file diffs.

- listFileDiffs_next(previous_request, previous_response)

+ listFileDiffs_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

merge(name, body=None, x__xgafv=None)

@@ -310,31 +310,31 @@

Method Details

- listFileDiffs_next(previous_request, previous_response) + listFileDiffs_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.pullRequestComments.html b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.pullRequestComments.html index 511be9d9b5..557b220eb7 100644 --- a/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.pullRequestComments.html +++ b/docs/dyn/securesourcemanager_v1.projects.locations.repositories.pullRequests.pullRequestComments.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists pull request comments.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -366,17 +366,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.assets.html b/docs/dyn/securitycenter_v1.folders.assets.html index f4ebdc929b..c11a41b533 100644 --- a/docs/dyn/securitycenter_v1.folders.assets.html +++ b/docs/dyn/securitycenter_v1.folders.assets.html @@ -81,13 +81,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSecurityMarks(name, body=None, startTime=None, updateMask=None, x__xgafv=None)

@@ -140,17 +140,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.bigQueryExports.html b/docs/dyn/securitycenter_v1.folders.bigQueryExports.html index d90d528382..44bf4262a4 100644 --- a/docs/dyn/securitycenter_v1.folders.bigQueryExports.html +++ b/docs/dyn/securitycenter_v1.folders.bigQueryExports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.customModules.html b/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.customModules.html index 197aeb6c0b..89737e6c7a 100644 --- a/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -278,31 +278,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.effectiveCustomModules.html index 8906d523fb..7975dc9a5f 100644 --- a/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.folders.eventThreatDetectionSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.folders.muteConfigs.html b/docs/dyn/securitycenter_v1.folders.muteConfigs.html index c9063eb7ca..86a1fb6049 100644 --- a/docs/dyn/securitycenter_v1.folders.muteConfigs.html +++ b/docs/dyn/securitycenter_v1.folders.muteConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.notificationConfigs.html b/docs/dyn/securitycenter_v1.folders.notificationConfigs.html index 1114d434b4..21fa7ba68a 100644 --- a/docs/dyn/securitycenter_v1.folders.notificationConfigs.html +++ b/docs/dyn/securitycenter_v1.folders.notificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html index 12c41b4d5e..0e79083cc9 100644 --- a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -401,31 +401,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html index 9919cd4d0c..eb54e5d1a8 100644 --- a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.folders.sources.findings.html b/docs/dyn/securitycenter_v1.folders.sources.findings.html index d9bc579db1..9698e22d73 100644 --- a/docs/dyn/securitycenter_v1.folders.sources.findings.html +++ b/docs/dyn/securitycenter_v1.folders.sources.findings.html @@ -86,13 +86,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -154,17 +154,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -1166,17 +1166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.folders.sources.html b/docs/dyn/securitycenter_v1.folders.sources.html index a11a8c21ec..3120c37893 100644 --- a/docs/dyn/securitycenter_v1.folders.sources.html +++ b/docs/dyn/securitycenter_v1.folders.sources.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.html b/docs/dyn/securitycenter_v1.html index cdc4196bf3..d93a6d88e3 100644 --- a/docs/dyn/securitycenter_v1.html +++ b/docs/dyn/securitycenter_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/securitycenter_v1.organizations.assets.html b/docs/dyn/securitycenter_v1.organizations.assets.html index a02c6d111e..8fdfd60344 100644 --- a/docs/dyn/securitycenter_v1.organizations.assets.html +++ b/docs/dyn/securitycenter_v1.organizations.assets.html @@ -81,13 +81,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

runDiscovery(parent, body=None, x__xgafv=None)

@@ -143,17 +143,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -227,17 +227,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.attackPaths.html b/docs/dyn/securitycenter_v1.organizations.attackPaths.html index 58657f8f0f..c5bb5c40ff 100644 --- a/docs/dyn/securitycenter_v1.organizations.attackPaths.html +++ b/docs/dyn/securitycenter_v1.organizations.attackPaths.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.bigQueryExports.html b/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html index e5b7129518..094309b122 100644 --- a/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html +++ b/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.customModules.html b/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.customModules.html index 57ff7ef61f..7cbf9363fe 100644 --- a/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -278,31 +278,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.effectiveCustomModules.html index 02124eb8a5..911cea0c59 100644 --- a/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.organizations.eventThreatDetectionSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.muteConfigs.html b/docs/dyn/securitycenter_v1.organizations.muteConfigs.html index ae399143ea..869eeac196 100644 --- a/docs/dyn/securitycenter_v1.organizations.muteConfigs.html +++ b/docs/dyn/securitycenter_v1.organizations.muteConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.notificationConfigs.html b/docs/dyn/securitycenter_v1.organizations.notificationConfigs.html index 745e2c0ae2..ab9b4d7839 100644 --- a/docs/dyn/securitycenter_v1.organizations.notificationConfigs.html +++ b/docs/dyn/securitycenter_v1.organizations.notificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.operations.html b/docs/dyn/securitycenter_v1.organizations.operations.html index 22cde18792..c9d583207b 100644 --- a/docs/dyn/securitycenter_v1.organizations.operations.html +++ b/docs/dyn/securitycenter_v1.organizations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.resourceValueConfigs.html b/docs/dyn/securitycenter_v1.organizations.resourceValueConfigs.html index c7d9367461..18f0cd1ac2 100644 --- a/docs/dyn/securitycenter_v1.organizations.resourceValueConfigs.html +++ b/docs/dyn/securitycenter_v1.organizations.resourceValueConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html index ce0e7341ee..a098473664 100644 --- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -401,31 +401,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html index 97e86d5ec8..7c0819530c 100644 --- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.simulations.attackExposureResults.attackPaths.html b/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.attackPaths.html index 3c84fbb56e..b1e795f073 100644 --- a/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.attackPaths.html +++ b/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.attackPaths.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.simulations.attackExposureResults.valuedResources.html b/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.valuedResources.html index 20c1ac475a..0869d5a02b 100644 --- a/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.valuedResources.html +++ b/docs/dyn/securitycenter_v1.organizations.simulations.attackExposureResults.valuedResources.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.simulations.attackPaths.html b/docs/dyn/securitycenter_v1.organizations.simulations.attackPaths.html index 8d4aa23362..ba12d24cfd 100644 --- a/docs/dyn/securitycenter_v1.organizations.simulations.attackPaths.html +++ b/docs/dyn/securitycenter_v1.organizations.simulations.attackPaths.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.simulations.valuedResources.attackPaths.html b/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.attackPaths.html index 63c9eaa60f..c20d31c4b3 100644 --- a/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.attackPaths.html +++ b/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.attackPaths.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -149,17 +149,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.simulations.valuedResources.html b/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.html index 4adcf852de..18dea063af 100644 --- a/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.html +++ b/docs/dyn/securitycenter_v1.organizations.simulations.valuedResources.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.organizations.sources.findings.html b/docs/dyn/securitycenter_v1.organizations.sources.findings.html index aa09b070cf..86af3b7c3b 100644 --- a/docs/dyn/securitycenter_v1.organizations.sources.findings.html +++ b/docs/dyn/securitycenter_v1.organizations.sources.findings.html @@ -89,13 +89,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -1864,17 +1864,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -2876,17 +2876,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.sources.html b/docs/dyn/securitycenter_v1.organizations.sources.html index 694a8aa887..822878fc09 100644 --- a/docs/dyn/securitycenter_v1.organizations.sources.html +++ b/docs/dyn/securitycenter_v1.organizations.sources.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -252,17 +252,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.organizations.valuedResources.html b/docs/dyn/securitycenter_v1.organizations.valuedResources.html index 8da36b2f95..e935447da9 100644 --- a/docs/dyn/securitycenter_v1.organizations.valuedResources.html +++ b/docs/dyn/securitycenter_v1.organizations.valuedResources.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.projects.assets.html b/docs/dyn/securitycenter_v1.projects.assets.html index a1c3feb068..78d589dc66 100644 --- a/docs/dyn/securitycenter_v1.projects.assets.html +++ b/docs/dyn/securitycenter_v1.projects.assets.html @@ -81,13 +81,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

updateSecurityMarks(name, body=None, startTime=None, updateMask=None, x__xgafv=None)

@@ -140,17 +140,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.bigQueryExports.html b/docs/dyn/securitycenter_v1.projects.bigQueryExports.html index 5bbbd76b2c..50f24448a0 100644 --- a/docs/dyn/securitycenter_v1.projects.bigQueryExports.html +++ b/docs/dyn/securitycenter_v1.projects.bigQueryExports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -220,17 +220,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.customModules.html b/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.customModules.html index 6c95778d9a..d87ee602f4 100644 --- a/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -278,31 +278,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.effectiveCustomModules.html index 48f7800a79..914c434eb7 100644 --- a/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.projects.eventThreatDetectionSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -154,17 +154,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.projects.muteConfigs.html b/docs/dyn/securitycenter_v1.projects.muteConfigs.html index 2c83881ee0..9e49a9a66c 100644 --- a/docs/dyn/securitycenter_v1.projects.muteConfigs.html +++ b/docs/dyn/securitycenter_v1.projects.muteConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -224,17 +224,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.notificationConfigs.html b/docs/dyn/securitycenter_v1.projects.notificationConfigs.html index d3584fe30d..95843828cd 100644 --- a/docs/dyn/securitycenter_v1.projects.notificationConfigs.html +++ b/docs/dyn/securitycenter_v1.projects.notificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html index d242ec69cc..7b61ba5457 100644 --- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html @@ -93,10 +93,10 @@

Instance Methods

listDescendant(parent, pageSize=None, pageToken=None, x__xgafv=None)

- listDescendant_next(previous_request, previous_response)

+ listDescendant_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -401,31 +401,31 @@

Method Details

- listDescendant_next(previous_request, previous_response) + listDescendant_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html index 7a98f28e2f..ffe572b621 100644 --- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html +++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -202,17 +202,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1.projects.sources.findings.html b/docs/dyn/securitycenter_v1.projects.sources.findings.html index 8fee3aa82f..324b9b2f66 100644 --- a/docs/dyn/securitycenter_v1.projects.sources.findings.html +++ b/docs/dyn/securitycenter_v1.projects.sources.findings.html @@ -86,13 +86,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -154,17 +154,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -1166,17 +1166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1.projects.sources.html b/docs/dyn/securitycenter_v1.projects.sources.html index efb4b8e8ee..3c8c3935ee 100644 --- a/docs/dyn/securitycenter_v1.projects.sources.html +++ b/docs/dyn/securitycenter_v1.projects.sources.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1beta1.html b/docs/dyn/securitycenter_v1beta1.html index ab6b0df507..04e17168bd 100644 --- a/docs/dyn/securitycenter_v1beta1.html +++ b/docs/dyn/securitycenter_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/securitycenter_v1beta1.organizations.assets.html b/docs/dyn/securitycenter_v1beta1.organizations.assets.html index 3ccd8670c6..de52a51662 100644 --- a/docs/dyn/securitycenter_v1beta1.organizations.assets.html +++ b/docs/dyn/securitycenter_v1beta1.organizations.assets.html @@ -81,13 +81,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, compareDuration=None, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

runDiscovery(parent, body=None, x__xgafv=None)

@@ -142,17 +142,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -212,17 +212,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1beta1.organizations.operations.html b/docs/dyn/securitycenter_v1beta1.organizations.operations.html index 4d1a75c42b..a42e5addb5 100644 --- a/docs/dyn/securitycenter_v1beta1.organizations.operations.html +++ b/docs/dyn/securitycenter_v1beta1.organizations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securitycenter_v1beta1.organizations.sources.findings.html b/docs/dyn/securitycenter_v1beta1.organizations.sources.findings.html index 58c0ff832d..40a80d9ca3 100644 --- a/docs/dyn/securitycenter_v1beta1.organizations.sources.findings.html +++ b/docs/dyn/securitycenter_v1beta1.organizations.sources.findings.html @@ -84,13 +84,13 @@

Instance Methods

group(parent, body=None, x__xgafv=None)

- group_next(previous_request, previous_response)

+ group_next()

Retrieves the next page of results.

list(parent, fieldMask=None, filter=None, orderBy=None, pageSize=None, pageToken=None, readTime=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -206,17 +206,17 @@

Method Details

- group_next(previous_request, previous_response) + group_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)
+        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.
-
+ 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. +
@@ -268,17 +268,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1beta1.organizations.sources.html b/docs/dyn/securitycenter_v1beta1.organizations.sources.html index 2363631514..488e1f0a1f 100644 --- a/docs/dyn/securitycenter_v1beta1.organizations.sources.html +++ b/docs/dyn/securitycenter_v1beta1.organizations.sources.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -248,17 +248,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securitycenter_v1beta2.html b/docs/dyn/securitycenter_v1beta2.html index be5e827a42..1761cd8549 100644 --- a/docs/dyn/securitycenter_v1beta2.html +++ b/docs/dyn/securitycenter_v1beta2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/securityposture_v1.html b/docs/dyn/securityposture_v1.html index a2cb4135ae..7667e0f498 100644 --- a/docs/dyn/securityposture_v1.html +++ b/docs/dyn/securityposture_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/securityposture_v1.organizations.locations.html b/docs/dyn/securityposture_v1.organizations.locations.html index 667534df86..9b6c465e77 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.html +++ b/docs/dyn/securityposture_v1.organizations.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securityposture_v1.organizations.locations.operations.html b/docs/dyn/securityposture_v1.organizations.locations.operations.html index 700a7bbe7f..3867d2eb49 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.operations.html +++ b/docs/dyn/securityposture_v1.organizations.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securityposture_v1.organizations.locations.postureDeployments.html b/docs/dyn/securityposture_v1.organizations.locations.postureDeployments.html index c4a166cb1b..7b57317b2f 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.postureDeployments.html +++ b/docs/dyn/securityposture_v1.organizations.locations.postureDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists every PostureDeployment in a project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securityposture_v1.organizations.locations.postureTemplates.html b/docs/dyn/securityposture_v1.organizations.locations.postureTemplates.html index 17f2b93bcc..1d4d71298f 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.postureTemplates.html +++ b/docs/dyn/securityposture_v1.organizations.locations.postureTemplates.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists every PostureTemplate in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -422,17 +422,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/securityposture_v1.organizations.locations.postures.html b/docs/dyn/securityposture_v1.organizations.locations.postures.html index 12910ce1b1..d7cd4d7744 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.postures.html +++ b/docs/dyn/securityposture_v1.organizations.locations.postures.html @@ -96,10 +96,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists all revisions of a single Posture.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, revisionId=None, updateMask=None, x__xgafv=None)

@@ -901,31 +901,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/securityposture_v1.organizations.locations.reports.html b/docs/dyn/securityposture_v1.organizations.locations.reports.html index e5c76cdacf..51926fba02 100644 --- a/docs/dyn/securityposture_v1.organizations.locations.reports.html +++ b/docs/dyn/securityposture_v1.organizations.locations.reports.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists every Report in a given organization and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceconsumermanagement_v1.html b/docs/dyn/serviceconsumermanagement_v1.html index 94a40c0920..75e459072f 100644 --- a/docs/dyn/serviceconsumermanagement_v1.html +++ b/docs/dyn/serviceconsumermanagement_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/serviceconsumermanagement_v1.operations.html b/docs/dyn/serviceconsumermanagement_v1.operations.html index 9149348f24..84066adcd4 100644 --- a/docs/dyn/serviceconsumermanagement_v1.operations.html +++ b/docs/dyn/serviceconsumermanagement_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceconsumermanagement_v1.services.html b/docs/dyn/serviceconsumermanagement_v1.services.html index 95c7696d6c..a08fa6cafa 100644 --- a/docs/dyn/serviceconsumermanagement_v1.services.html +++ b/docs/dyn/serviceconsumermanagement_v1.services.html @@ -86,7 +86,7 @@

Instance Methods

search(parent, pageSize=None, pageToken=None, query=None, x__xgafv=None)

Search tenancy units for a managed service.

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -134,17 +134,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceconsumermanagement_v1.services.tenancyUnits.html b/docs/dyn/serviceconsumermanagement_v1.services.tenancyUnits.html index 6592635519..dbd7d68e06 100644 --- a/docs/dyn/serviceconsumermanagement_v1.services.tenancyUnits.html +++ b/docs/dyn/serviceconsumermanagement_v1.services.tenancyUnits.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Find the tenancy unit for a managed service and service consumer. This method shouldn't be used in a service producer's runtime path, for example to find the tenant project number when creating VMs. Service producers must persist the tenant project's information after the project is created.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeProject(name, body=None, x__xgafv=None)

@@ -452,17 +452,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/serviceconsumermanagement_v1beta1.html b/docs/dyn/serviceconsumermanagement_v1beta1.html index c78d4a7b59..86779e50c8 100644 --- a/docs/dyn/serviceconsumermanagement_v1beta1.html +++ b/docs/dyn/serviceconsumermanagement_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.html b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.html index 2e1b9ece0d..f14d227426 100644 --- a/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.html +++ b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Retrieves a summary of all quota information about this consumer that is visible to the service producer, for each quota metric defined by the service. Each metric includes information about all of its defined limits. Each limit includes the limit configuration (quota unit, preciseness, default value), the current effective limit value, and all of the overrides applied to the limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -536,17 +536,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerOverrides.html b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerOverrides.html index 31092b4899..754fd35615 100644 --- a/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerOverrides.html +++ b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerOverrides.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all producer overrides on this limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceJustification=None, forceOnly=None, updateMask=None, x__xgafv=None)

@@ -230,17 +230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerQuotaPolicies.html b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerQuotaPolicies.html index 013bc1889a..e293832cc5 100644 --- a/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerQuotaPolicies.html +++ b/docs/dyn/serviceconsumermanagement_v1beta1.services.consumerQuotaMetrics.limits.producerQuotaPolicies.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all producer policies created at current consumer node for a limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceJustification=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -222,17 +222,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/servicecontrol_v1.html b/docs/dyn/servicecontrol_v1.html index 8e213fbec7..917c7df068 100644 --- a/docs/dyn/servicecontrol_v1.html +++ b/docs/dyn/servicecontrol_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicecontrol_v2.html b/docs/dyn/servicecontrol_v2.html index a6571d54f1..84df7c7cf9 100644 --- a/docs/dyn/servicecontrol_v2.html +++ b/docs/dyn/servicecontrol_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicedirectory_v1.html b/docs/dyn/servicedirectory_v1.html index 0e4130edc8..82c409fdb9 100644 --- a/docs/dyn/servicedirectory_v1.html +++ b/docs/dyn/servicedirectory_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicedirectory_v1.projects.locations.html b/docs/dyn/servicedirectory_v1.projects.locations.html index 7f2e669510..e28445fd8b 100644 --- a/docs/dyn/servicedirectory_v1.projects.locations.html +++ b/docs/dyn/servicedirectory_v1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/servicedirectory_v1.projects.locations.namespaces.html b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.html index 741534ff0c..fda351a8ed 100644 --- a/docs/dyn/servicedirectory_v1.projects.locations.namespaces.html +++ b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all namespaces.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -128,7 +128,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format. } @@ -145,7 +145,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format. }
@@ -186,7 +186,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format. }
@@ -258,7 +258,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format. }, ], @@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -285,7 +285,7 @@

Method Details

Updates a namespace.
 
 Args:
-  name: string, Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. (required)
+  name: string, Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -293,7 +293,7 @@ 
Method Details

   "labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
+  "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
   "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format.
 }
 
@@ -310,7 +310,7 @@ 
Method Details

   "labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
+  "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
   "uid": "A String", # Output only. The globally unique identifier of the namespace in the UUID4 format.
 }
diff --git a/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.endpoints.html b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.endpoints.html index 134a2d49b2..8be37f5e7d 100644 --- a/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.endpoints.html +++ b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.endpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all endpoints.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -115,7 +115,7 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. @@ -135,7 +135,7 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. @@ -179,7 +179,7 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. @@ -211,7 +211,7 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. @@ -222,17 +222,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -240,7 +240,7 @@

Method Details

Updates an endpoint.
 
 Args:
-  name: string, Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. (required)
+  name: string, Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -249,7 +249,7 @@ 
Method Details

   "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+  "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
   "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
   "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
   "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
@@ -269,7 +269,7 @@ 
Method Details

   "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+  "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
   "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
   "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
   "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
diff --git a/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.html b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.html
index c486c279a7..c7979b73be 100644
--- a/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.html
+++ b/docs/dyn/servicedirectory_v1.projects.locations.namespaces.services.html
@@ -98,7 +98,7 @@ 
Instance Methods

   list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

 
Lists all services belonging to a namespace.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 

   patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -137,13 +137,13 @@ 
Method Details

       "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
     },
   ],
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format.
 }
 
@@ -166,13 +166,13 @@ 
Method Details

       "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
     },
   ],
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format.
 }
@@ -219,13 +219,13 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. }, ], - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format. } @@ -304,13 +304,13 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. }, ], - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format. }, ], @@ -318,17 +318,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -336,7 +336,7 @@

Method Details

Updates a service.
 
 Args:
-  name: string, Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. (required)
+  name: string, Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -350,13 +350,13 @@ 
Method Details

       "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
     },
   ],
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format.
 }
 
@@ -379,13 +379,13 @@ 
Method Details

       "annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified.
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format.
     },
   ],
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format.
 }
@@ -423,13 +423,13 @@

Method Details

"annotations": { # Optional. Annotations for the endpoint. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 512 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/) Annotations that fails to meet these requirements are rejected. Note: This field is equivalent to the `metadata` field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, we also check to make sure that you have the servicedirectory.networks.attach permission on the project specified. "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. The globally unique identifier of the endpoint in the UUID4 format. }, ], - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. The globally unique identifier of the service in the UUID4 format. }, } diff --git a/docs/dyn/servicedirectory_v1beta1.html b/docs/dyn/servicedirectory_v1beta1.html index 5e46261952..f98748302e 100644 --- a/docs/dyn/servicedirectory_v1beta1.html +++ b/docs/dyn/servicedirectory_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicedirectory_v1beta1.projects.locations.html b/docs/dyn/servicedirectory_v1beta1.projects.locations.html index 6701078430..2256dfff15 100644 --- a/docs/dyn/servicedirectory_v1beta1.projects.locations.html +++ b/docs/dyn/servicedirectory_v1beta1.projects.locations.html @@ -89,7 +89,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/servicedirectory_v1beta1.projects.locations.namespaces.html b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.html index 8338f9ac4d..53f32bd1cb 100644 --- a/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.html +++ b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all namespaces.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -134,7 +134,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace. "updateTime": "A String", # Output only. The timestamp when the namespace was last updated. } @@ -153,7 +153,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace. "updateTime": "A String", # Output only. The timestamp when the namespace was last updated. } @@ -196,7 +196,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace. "updateTime": "A String", # Output only. The timestamp when the namespace was last updated. } @@ -270,7 +270,7 @@

Method Details

"labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. + "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace. "updateTime": "A String", # Output only. The timestamp when the namespace was last updated. }, @@ -280,17 +280,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -298,7 +298,7 @@

Method Details

Updates a namespace.
 
 Args:
-  name: string, Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. (required)
+  name: string, Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -307,7 +307,7 @@ 
Method Details

   "labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
+  "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace.
   "updateTime": "A String", # Output only. The timestamp when the namespace was last updated.
 }
@@ -326,7 +326,7 @@ 
Method Details

   "labels": { # Optional. Resource labels associated with this namespace. No more than 64 user labels can be associated with a given resource. Label keys and values can be no longer than 63 characters.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
+  "name": "A String", # Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this namespace.
   "updateTime": "A String", # Output only. The timestamp when the namespace was last updated.
 }
diff --git a/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.endpoints.html b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.endpoints.html index 2556350e30..ffa2ae816b 100644 --- a/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.endpoints.html +++ b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.endpoints.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all endpoints.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -116,7 +116,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -138,7 +138,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -184,7 +184,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -218,7 +218,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -230,17 +230,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -248,7 +248,7 @@

Method Details

Updates an endpoint.
 
 Args:
-  name: string, Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. (required)
+  name: string, Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -258,7 +258,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+  "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
   "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
   "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
@@ -280,7 +280,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+  "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
   "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
   "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
diff --git a/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.html b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.html
index 8af16dda0e..1e44e8e667 100644
--- a/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.html
+++ b/docs/dyn/servicedirectory_v1beta1.projects.locations.namespaces.services.html
@@ -98,7 +98,7 @@ 
Instance Methods

   list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

 
Lists all services belonging to a namespace.

 

-  list_next(previous_request, previous_response)

+  list_next()

 
Retrieves the next page of results.

 

   patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -136,7 +136,7 @@ 
Method Details

       "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
@@ -146,7 +146,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service.
   "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
 }
@@ -169,7 +169,7 @@ 
Method Details

       "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
@@ -179,7 +179,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service.
   "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
 }
@@ -226,7 +226,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -236,7 +236,7 @@

Method Details

"metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service. "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp. } @@ -315,7 +315,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -325,7 +325,7 @@

Method Details

"metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service. "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp. }, @@ -334,17 +334,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -352,7 +352,7 @@

Method Details

Updates a service.
 
 Args:
-  name: string, Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. (required)
+  name: string, Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -365,7 +365,7 @@ 
Method Details

       "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
@@ -375,7 +375,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service.
   "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
 }
@@ -398,7 +398,7 @@ 
Method Details

       "metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
         "a_key": "A String",
       },
-      "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+      "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
       "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions).
       "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`.
       "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint.
@@ -408,7 +408,7 @@ 
Method Details

   "metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory.
     "a_key": "A String",
   },
-  "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
+  "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.
   "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service.
   "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
 }
@@ -446,7 +446,7 @@

Method Details

"metadata": { # Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. + "name": "A String", # Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`. "network": "A String", # Immutable. The Google Compute Engine network (VPC) of the endpoint in the format `projects//locations/global/networks/*`. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). "port": 42, # Optional. Service Directory rejects values outside of `[0, 65535]`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this endpoint. @@ -456,7 +456,7 @@

Method Details

"metadata": { # Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the `annotations` field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. "a_key": "A String", }, - "name": "A String", # Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. + "name": "A String", # Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`. "uid": "A String", # Output only. A globally unique identifier (in UUID4 format) for this service. "updateTime": "A String", # Output only. The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp. }, diff --git a/docs/dyn/servicemanagement_v1.html b/docs/dyn/servicemanagement_v1.html index f0b8a3d893..c0a64fa177 100644 --- a/docs/dyn/servicemanagement_v1.html +++ b/docs/dyn/servicemanagement_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicemanagement_v1.operations.html b/docs/dyn/servicemanagement_v1.operations.html index 73f523678c..fde99d820c 100644 --- a/docs/dyn/servicemanagement_v1.operations.html +++ b/docs/dyn/servicemanagement_v1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists service operations that match the specified filter in the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/servicemanagement_v1.services.configs.html b/docs/dyn/servicemanagement_v1.services.configs.html index ab998f6c95..5831a56458 100644 --- a/docs/dyn/servicemanagement_v1.services.configs.html +++ b/docs/dyn/servicemanagement_v1.services.configs.html @@ -87,7 +87,7 @@

Instance Methods

list(serviceName, pageSize=None, pageToken=None, x__xgafv=None)

Lists the history of the service configuration for a managed service, from the newest to the oldest.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

submit(serviceName, body=None, x__xgafv=None)

@@ -3011,17 +3011,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/servicemanagement_v1.services.html b/docs/dyn/servicemanagement_v1.services.html index 6d2d386f95..e6de21fad3 100644 --- a/docs/dyn/servicemanagement_v1.services.html +++ b/docs/dyn/servicemanagement_v1.services.html @@ -114,7 +114,7 @@

Instance Methods

list(consumerId=None, pageSize=None, pageToken=None, producerProjectId=None, x__xgafv=None)

Lists managed services. Returns all public services. For authenticated users, also returns all services the calling user has "servicemanagement.services.get" permission for.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -1101,17 +1101,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/servicemanagement_v1.services.rollouts.html b/docs/dyn/servicemanagement_v1.services.rollouts.html index bf978aaf85..1f0a78bfa1 100644 --- a/docs/dyn/servicemanagement_v1.services.rollouts.html +++ b/docs/dyn/servicemanagement_v1.services.rollouts.html @@ -87,7 +87,7 @@

Instance Methods

list(serviceName, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -218,17 +218,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/servicenetworking_v1.html b/docs/dyn/servicenetworking_v1.html index 239ab2ac98..131090a810 100644 --- a/docs/dyn/servicenetworking_v1.html +++ b/docs/dyn/servicenetworking_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/servicenetworking_v1.operations.html b/docs/dyn/servicenetworking_v1.operations.html index 14a58e1bec..eec813a77f 100644 --- a/docs/dyn/servicenetworking_v1.operations.html +++ b/docs/dyn/servicenetworking_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/servicenetworking_v1beta.html b/docs/dyn/servicenetworking_v1beta.html index 256e17fb39..e185f561c9 100644 --- a/docs/dyn/servicenetworking_v1beta.html +++ b/docs/dyn/servicenetworking_v1beta.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/serviceusage_v1.html b/docs/dyn/serviceusage_v1.html index 98b06d1598..b10d237cc8 100644 --- a/docs/dyn/serviceusage_v1.html +++ b/docs/dyn/serviceusage_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/serviceusage_v1.operations.html b/docs/dyn/serviceusage_v1.operations.html index e82dcdb639..b74a9c7209 100644 --- a/docs/dyn/serviceusage_v1.operations.html +++ b/docs/dyn/serviceusage_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceusage_v1.services.html b/docs/dyn/serviceusage_v1.services.html index 3c875c2507..cf95654bb9 100644 --- a/docs/dyn/serviceusage_v1.services.html +++ b/docs/dyn/serviceusage_v1.services.html @@ -96,7 +96,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all services available to the specified project, and the current state of those services with respect to the project. The list includes all public services, all services for which the calling user has the `servicemanagement.services.bind` permission, and all services that have already been enabled on the project. The list can be filtered to only include services in a specific state, for example to only include services enabled on the project. WARNING: If you need to query enabled services frequently or across an organization, you should use [Cloud Asset Inventory API](https://cloud.google.com/asset-inventory/docs/apis), which provides higher throughput and richer filtering capability.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -924,17 +924,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceusage_v1beta1.html b/docs/dyn/serviceusage_v1beta1.html index ba9b3e4ed0..e5ee97ca8e 100644 --- a/docs/dyn/serviceusage_v1beta1.html +++ b/docs/dyn/serviceusage_v1beta1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/serviceusage_v1beta1.operations.html b/docs/dyn/serviceusage_v1beta1.operations.html index 690b481e65..ad7b48cba7 100644 --- a/docs/dyn/serviceusage_v1beta1.operations.html +++ b/docs/dyn/serviceusage_v1beta1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceusage_v1beta1.services.consumerQuotaMetrics.html b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.html index adbe8595f2..ea19c8067f 100644 --- a/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.html +++ b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Retrieves a summary of all quota information visible to the service consumer, organized by service metric. Each metric includes information about all of its defined limits. Each limit includes the limit configuration (quota unit, preciseness, default value), the current effective limit value, and all of the overrides applied to the limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -543,17 +543,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.adminOverrides.html b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.adminOverrides.html index 1249bb5690..34b465bcd7 100644 --- a/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.adminOverrides.html +++ b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.adminOverrides.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all admin overrides on this limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceOnly=None, updateMask=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.consumerOverrides.html b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.consumerOverrides.html index e669d94259..bf8177e182 100644 --- a/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.consumerOverrides.html +++ b/docs/dyn/serviceusage_v1beta1.services.consumerQuotaMetrics.limits.consumerOverrides.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all consumer overrides on this limit.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, force=None, forceOnly=None, updateMask=None, x__xgafv=None)

@@ -228,17 +228,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/serviceusage_v1beta1.services.html b/docs/dyn/serviceusage_v1beta1.services.html index a212b7713c..07e792c866 100644 --- a/docs/dyn/serviceusage_v1beta1.services.html +++ b/docs/dyn/serviceusage_v1beta1.services.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all services available to the specified project, and the current state of those services with respect to the project. The list includes all public services, all services for which the calling user has the `servicemanagement.services.bind` permission, and all services that have already been enabled on the project. The list can be filtered to only include services in a specific state, for example to only include services enabled on the project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -731,17 +731,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sheets_v4.html b/docs/dyn/sheets_v4.html index 1a6c08527a..04f7aea7ca 100644 --- a/docs/dyn/sheets_v4.html +++ b/docs/dyn/sheets_v4.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/siteVerification_v1.html b/docs/dyn/siteVerification_v1.html index 2bbce02a14..a125c234f5 100644 --- a/docs/dyn/siteVerification_v1.html +++ b/docs/dyn/siteVerification_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/slides_v1.html b/docs/dyn/slides_v1.html index 792d8ee9a4..84c8150484 100644 --- a/docs/dyn/slides_v1.html +++ b/docs/dyn/slides_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/smartdevicemanagement_v1.html b/docs/dyn/smartdevicemanagement_v1.html index 8bd560afdd..b783d818a7 100644 --- a/docs/dyn/smartdevicemanagement_v1.html +++ b/docs/dyn/smartdevicemanagement_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/solar_v1.html b/docs/dyn/solar_v1.html index aa2411a66e..3e024ad1e8 100644 --- a/docs/dyn/solar_v1.html +++ b/docs/dyn/solar_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/spanner_v1.html b/docs/dyn/spanner_v1.html index 2104dc4c6f..7279e41c55 100644 --- a/docs/dyn/spanner_v1.html +++ b/docs/dyn/spanner_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/spanner_v1.projects.instanceConfigOperations.html b/docs/dyn/spanner_v1.projects.instanceConfigOperations.html index 7dffd8a62f..e23b146ef8 100644 --- a/docs/dyn/spanner_v1.projects.instanceConfigOperations.html +++ b/docs/dyn/spanner_v1.projects.instanceConfigOperations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the user-managed instance configuration long-running operations in the given project. An instance configuration operation has a name of the form `projects//instanceConfigs//operations/`. The long-running operation metadata field type `metadata.type_url` describes the type of the metadata. Operations returned include those that have completed/failed/canceled within the last 7 days, and pending operations. Operations returned are ordered by `operation.metadata.value.start_time` in descending order starting from the most recently started operation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instanceConfigs.html b/docs/dyn/spanner_v1.projects.instanceConfigs.html index a2b843f297..a6f3c9c45c 100644 --- a/docs/dyn/spanner_v1.projects.instanceConfigs.html +++ b/docs/dyn/spanner_v1.projects.instanceConfigs.html @@ -100,7 +100,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the supported instance configurations for a given project. Returns both Google-managed configurations and user-managed configurations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -310,17 +310,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instanceConfigs.operations.html b/docs/dyn/spanner_v1.projects.instanceConfigs.operations.html index 60ade21ab5..8c4b26f23b 100644 --- a/docs/dyn/spanner_v1.projects.instanceConfigs.operations.html +++ b/docs/dyn/spanner_v1.projects.instanceConfigs.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instanceConfigs.ssdCaches.operations.html b/docs/dyn/spanner_v1.projects.instanceConfigs.ssdCaches.operations.html index a47e5fb2a9..59e00b03f3 100644 --- a/docs/dyn/spanner_v1.projects.instanceConfigs.ssdCaches.operations.html +++ b/docs/dyn/spanner_v1.projects.instanceConfigs.ssdCaches.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.backupOperations.html b/docs/dyn/spanner_v1.projects.instances.backupOperations.html index 1fba5ba298..397260eccb 100644 --- a/docs/dyn/spanner_v1.projects.instances.backupOperations.html +++ b/docs/dyn/spanner_v1.projects.instances.backupOperations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the backup long-running operations in the given instance. A backup operation has a name of the form `projects//instances//backups//operations/`. The long-running operation metadata field type `metadata.type_url` describes the type of the metadata. Operations returned include those that have completed/failed/canceled within the last 7 days, and pending operations. Operations returned are ordered by `operation.metadata.value.progress.start_time` in descending order starting from the most recently started operation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.backups.html b/docs/dyn/spanner_v1.projects.instances.backups.html index 1672b87118..a6fa6c5ef0 100644 --- a/docs/dyn/spanner_v1.projects.instances.backups.html +++ b/docs/dyn/spanner_v1.projects.instances.backups.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists completed and pending backups. Backups returned are ordered by `create_time` in descending order, starting from the most recent `create_time`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -493,17 +493,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.backups.operations.html b/docs/dyn/spanner_v1.projects.instances.backups.operations.html index 2f46d111fe..57f35d3bc1 100644 --- a/docs/dyn/spanner_v1.projects.instances.backups.operations.html +++ b/docs/dyn/spanner_v1.projects.instances.backups.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.databaseOperations.html b/docs/dyn/spanner_v1.projects.instances.databaseOperations.html index 5e1d0630b2..803ea60e00 100644 --- a/docs/dyn/spanner_v1.projects.instances.databaseOperations.html +++ b/docs/dyn/spanner_v1.projects.instances.databaseOperations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists database longrunning-operations. A database operation has a name of the form `projects//instances//databases//operations/`. The long-running operation metadata field type `metadata.type_url` describes the type of the metadata. Operations returned include those that have completed/failed/canceled within the last 7 days, and pending operations.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -133,17 +133,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.databases.backupSchedules.html b/docs/dyn/spanner_v1.projects.instances.databases.backupSchedules.html index f9050e88da..bb282c329a 100644 --- a/docs/dyn/spanner_v1.projects.instances.databases.backupSchedules.html +++ b/docs/dyn/spanner_v1.projects.instances.databases.backupSchedules.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the backup schedules for the database.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -324,17 +324,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.databases.databaseRoles.html b/docs/dyn/spanner_v1.projects.instances.databases.databaseRoles.html index 4b4032106d..11ed8f68a6 100644 --- a/docs/dyn/spanner_v1.projects.instances.databases.databaseRoles.html +++ b/docs/dyn/spanner_v1.projects.instances.databases.databaseRoles.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Cloud Spanner database roles.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

testIamPermissions(resource, body=None, x__xgafv=None)

@@ -119,17 +119,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.databases.html b/docs/dyn/spanner_v1.projects.instances.databases.html index 8d3ec65c7d..da47587de0 100644 --- a/docs/dyn/spanner_v1.projects.instances.databases.html +++ b/docs/dyn/spanner_v1.projects.instances.databases.html @@ -125,7 +125,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Cloud Spanner databases.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -724,17 +724,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.databases.operations.html b/docs/dyn/spanner_v1.projects.instances.databases.operations.html index 89b4750dab..0cfb1b3504 100644 --- a/docs/dyn/spanner_v1.projects.instances.databases.operations.html +++ b/docs/dyn/spanner_v1.projects.instances.databases.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.databases.sessions.html b/docs/dyn/spanner_v1.projects.instances.databases.sessions.html index dc2dcd14a9..a52f9c2d1d 100644 --- a/docs/dyn/spanner_v1.projects.instances.databases.sessions.html +++ b/docs/dyn/spanner_v1.projects.instances.databases.sessions.html @@ -117,7 +117,7 @@

Instance Methods

list(database, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all sessions in a given database.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

partitionQuery(session, body=None, x__xgafv=None)

@@ -1417,17 +1417,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.html b/docs/dyn/spanner_v1.projects.instances.html index e1b90dfc14..ad439c15ed 100644 --- a/docs/dyn/spanner_v1.projects.instances.html +++ b/docs/dyn/spanner_v1.projects.instances.html @@ -128,7 +128,7 @@

Instance Methods

list(parent, filter=None, instanceDeadline=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instances in the given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(name, body=None, x__xgafv=None)

@@ -492,17 +492,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.instancePartitionOperations.html b/docs/dyn/spanner_v1.projects.instances.instancePartitionOperations.html index 345eddcfdd..977ca7642b 100644 --- a/docs/dyn/spanner_v1.projects.instances.instancePartitionOperations.html +++ b/docs/dyn/spanner_v1.projects.instances.instancePartitionOperations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, instancePartitionDeadline=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists instance partition long-running operations in the given instance. An instance partition operation has a name of the form `projects//instances//instancePartitions//operations/`. The long-running operation metadata field type `metadata.type_url` describes the type of the metadata. Operations returned include those that have completed/failed/canceled within the last 7 days, and pending operations. Operations returned are ordered by `operation.metadata.value.start_time` in descending order starting from the most recently started operation. Authorization requires `spanner.instancePartitionOperations.list` permission on the resource parent.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -137,17 +137,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.instancePartitions.html b/docs/dyn/spanner_v1.projects.instances.instancePartitions.html index b44897922b..038f226ae1 100644 --- a/docs/dyn/spanner_v1.projects.instances.instancePartitions.html +++ b/docs/dyn/spanner_v1.projects.instances.instancePartitions.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, instancePartitionDeadline=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all instance partitions for the given instance.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -358,17 +358,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/spanner_v1.projects.instances.instancePartitions.operations.html b/docs/dyn/spanner_v1.projects.instances.instancePartitions.operations.html index 42aab4e3a8..5ba2b404e0 100644 --- a/docs/dyn/spanner_v1.projects.instances.instancePartitions.operations.html +++ b/docs/dyn/spanner_v1.projects.instances.instancePartitions.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.projects.instances.operations.html b/docs/dyn/spanner_v1.projects.instances.operations.html index e7b078593a..82237f81a2 100644 --- a/docs/dyn/spanner_v1.projects.instances.operations.html +++ b/docs/dyn/spanner_v1.projects.instances.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/spanner_v1.scans.html b/docs/dyn/spanner_v1.scans.html index bea2701c81..5aead6fb48 100644 --- a/docs/dyn/spanner_v1.scans.html +++ b/docs/dyn/spanner_v1.scans.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Return available scans given a Database-specific resource name.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -301,17 +301,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/speech_v1.html b/docs/dyn/speech_v1.html index 30a813381a..0b28224b07 100644 --- a/docs/dyn/speech_v1.html +++ b/docs/dyn/speech_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/speech_v1.operations.html b/docs/dyn/speech_v1.operations.html index 5d84ebce07..ce6163cc45 100644 --- a/docs/dyn/speech_v1.operations.html +++ b/docs/dyn/speech_v1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/speech_v1.projects.locations.customClasses.html b/docs/dyn/speech_v1.projects.locations.customClasses.html index 613e7e8b5f..df734712ba 100644 --- a/docs/dyn/speech_v1.projects.locations.customClasses.html +++ b/docs/dyn/speech_v1.projects.locations.customClasses.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List custom classes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/speech_v1.projects.locations.phraseSets.html b/docs/dyn/speech_v1.projects.locations.phraseSets.html index e0bf90fe00..0b4aabb01f 100644 --- a/docs/dyn/speech_v1.projects.locations.phraseSets.html +++ b/docs/dyn/speech_v1.projects.locations.phraseSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List phrase sets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/speech_v1p1beta1.html b/docs/dyn/speech_v1p1beta1.html index 3d7de598be..ff96775946 100644 --- a/docs/dyn/speech_v1p1beta1.html +++ b/docs/dyn/speech_v1p1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/speech_v1p1beta1.operations.html b/docs/dyn/speech_v1p1beta1.operations.html index 6c37186b33..fcf0a67b72 100644 --- a/docs/dyn/speech_v1p1beta1.operations.html +++ b/docs/dyn/speech_v1p1beta1.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(filter=None, name=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/speech_v1p1beta1.projects.locations.customClasses.html b/docs/dyn/speech_v1p1beta1.projects.locations.customClasses.html index 7f159c08c1..13a64bfd38 100644 --- a/docs/dyn/speech_v1p1beta1.projects.locations.customClasses.html +++ b/docs/dyn/speech_v1p1beta1.projects.locations.customClasses.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List custom classes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -266,17 +266,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/speech_v1p1beta1.projects.locations.phraseSets.html b/docs/dyn/speech_v1p1beta1.projects.locations.phraseSets.html index 5a5c26c6a8..354684f641 100644 --- a/docs/dyn/speech_v1p1beta1.projects.locations.phraseSets.html +++ b/docs/dyn/speech_v1p1beta1.projects.locations.phraseSets.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List phrase sets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1.Backups.html b/docs/dyn/sqladmin_v1.Backups.html index 1e051b4da6..b119ee7e4e 100644 --- a/docs/dyn/sqladmin_v1.Backups.html +++ b/docs/dyn/sqladmin_v1.Backups.html @@ -87,7 +87,7 @@

Instance Methods

ListBackups(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups associated with the project.

- ListBackups_next(previous_request, previous_response)

+ ListBackups_next()

Retrieves the next page of results.

UpdateBackup(name, body=None, updateMask=None, x__xgafv=None)

@@ -1866,17 +1866,17 @@

Method Details

- ListBackups_next(previous_request, previous_response) + ListBackups_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1.backupRuns.html b/docs/dyn/sqladmin_v1.backupRuns.html index b2bd87f725..8bd2313ae1 100644 --- a/docs/dyn/sqladmin_v1.backupRuns.html +++ b/docs/dyn/sqladmin_v1.backupRuns.html @@ -90,7 +90,7 @@

Instance Methods

list(project, instance, maxResults=None, pageToken=None, x__xgafv=None)

Lists all backup runs associated with the project or a given instance and configuration in the reverse chronological order of the backup initiation time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -604,17 +604,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sqladmin_v1.blueGreenDeployments.html b/docs/dyn/sqladmin_v1.blueGreenDeployments.html index fc7545f8bc..23b0437f47 100644 --- a/docs/dyn/sqladmin_v1.blueGreenDeployments.html +++ b/docs/dyn/sqladmin_v1.blueGreenDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists blue-green deployments under a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

switchover(name, body=None, x__xgafv=None)

@@ -687,17 +687,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1.html b/docs/dyn/sqladmin_v1.html index 152a5d5995..38adaede64 100644 --- a/docs/dyn/sqladmin_v1.html +++ b/docs/dyn/sqladmin_v1.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/sqladmin_v1.instances.html b/docs/dyn/sqladmin_v1.instances.html index 97131f9c32..f8a138d426 100644 --- a/docs/dyn/sqladmin_v1.instances.html +++ b/docs/dyn/sqladmin_v1.instances.html @@ -138,7 +138,7 @@

Instance Methods

listServerCas(project, instance, location=None, x__xgafv=None)

Lists all of the trusted Certificate Authorities (CAs) for the specified instance. There can be up to three CAs listed: the CA that was used to sign the certificate that is currently in use, a CA that has been added but not yet used to sign a certificate, and a CA used to sign a certificate that has previously rotated out.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, instance, body=None, location=None, reconcilePscNetworking=None, reconcilePscNetworkingForce=None, x__xgafv=None)

@@ -4285,17 +4285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1.operations.html b/docs/dyn/sqladmin_v1.operations.html index 932bfecf6a..9fa053b098 100644 --- a/docs/dyn/sqladmin_v1.operations.html +++ b/docs/dyn/sqladmin_v1.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, instance=None, location=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists all instance operations that have been performed on the given Cloud SQL instance in the reverse chronological order of the start time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -484,17 +484,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sqladmin_v1beta4.backupRuns.html b/docs/dyn/sqladmin_v1beta4.backupRuns.html index 7ec35c13d0..a3d635f046 100644 --- a/docs/dyn/sqladmin_v1beta4.backupRuns.html +++ b/docs/dyn/sqladmin_v1beta4.backupRuns.html @@ -90,7 +90,7 @@

Instance Methods

list(project, instance, maxResults=None, pageToken=None, x__xgafv=None)

Lists all backup runs associated with the project or a given instance and configuration in the reverse chronological order of the backup initiation time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -604,17 +604,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sqladmin_v1beta4.backups.html b/docs/dyn/sqladmin_v1beta4.backups.html index fc1e68688d..9d3e8201c4 100644 --- a/docs/dyn/sqladmin_v1beta4.backups.html +++ b/docs/dyn/sqladmin_v1beta4.backups.html @@ -90,7 +90,7 @@

Instance Methods

listBackups(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all backups associated with the project.

- listBackups_next(previous_request, previous_response)

+ listBackups_next()

Retrieves the next page of results.

updateBackup(name, body=None, updateMask=None, x__xgafv=None)

@@ -1871,17 +1871,17 @@

Method Details

- listBackups_next(previous_request, previous_response) + listBackups_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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html b/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html index 1b231760ef..2e97319cc5 100644 --- a/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html +++ b/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists blue-green deployments under a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

switchover(name, body=None, x__xgafv=None)

@@ -864,17 +864,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1beta4.html b/docs/dyn/sqladmin_v1beta4.html index e473becbdd..5e2ae2fb06 100644 --- a/docs/dyn/sqladmin_v1beta4.html +++ b/docs/dyn/sqladmin_v1beta4.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html index 1e8f61d974..a4bd1124a0 100644 --- a/docs/dyn/sqladmin_v1beta4.instances.html +++ b/docs/dyn/sqladmin_v1beta4.instances.html @@ -138,7 +138,7 @@

Instance Methods

listServerCas(project, instance, location=None, x__xgafv=None)

Lists all of the trusted Certificate Authorities (CAs) for the specified instance. There can be up to three CAs listed: the CA that was used to sign the certificate that is currently in use, a CA that has been added but not yet used to sign a certificate, and a CA used to sign a certificate that has previously rotated out.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(project, instance, body=None, location=None, reconcilePscNetworking=None, reconcilePscNetworkingForce=None, x__xgafv=None)

@@ -4285,17 +4285,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/sqladmin_v1beta4.operations.html b/docs/dyn/sqladmin_v1beta4.operations.html index 8bf6be6391..e7fe3d4b45 100644 --- a/docs/dyn/sqladmin_v1beta4.operations.html +++ b/docs/dyn/sqladmin_v1beta4.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(project, instance=None, location=None, maxResults=None, pageToken=None, x__xgafv=None)

Lists all instance operations that have been performed on the given Cloud SQL instance in the reverse chronological order of the start time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -484,17 +484,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storage_v1.anywhereCaches.html b/docs/dyn/storage_v1.anywhereCaches.html index ba8e90dd51..aa8428b052 100644 --- a/docs/dyn/storage_v1.anywhereCaches.html +++ b/docs/dyn/storage_v1.anywhereCaches.html @@ -90,7 +90,7 @@

Instance Methods

list(bucket, pageSize=None, pageToken=None)

Returns a list of Anywhere Cache instances of the bucket matching the criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(bucket, anywhereCacheId)

@@ -251,17 +251,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.buckets.html b/docs/dyn/storage_v1.buckets.html index 1961cab100..cfaa2ea5b2 100644 --- a/docs/dyn/storage_v1.buckets.html +++ b/docs/dyn/storage_v1.buckets.html @@ -96,7 +96,7 @@

Instance Methods

list(project, maxResults=None, pageToken=None, prefix=None, projection=None, returnPartialSuccess=None, softDeleted=None, userProject=None)

Retrieves a list of buckets for a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lockRetentionPolicy(bucket, ifMetagenerationMatch, userProject=None)

@@ -1179,17 +1179,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.folders.html b/docs/dyn/storage_v1.folders.html index 7cc74c807e..4c836f1048 100644 --- a/docs/dyn/storage_v1.folders.html +++ b/docs/dyn/storage_v1.folders.html @@ -93,7 +93,7 @@

Instance Methods

list(bucket, delimiter=None, endOffset=None, pageSize=None, pageToken=None, prefix=None, startOffset=None)

Retrieves a list of folders matching the criteria. Only applicable to buckets with hierarchical namespace enabled.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

rename(bucket, sourceFolder, destinationFolder, ifSourceMetagenerationMatch=None, ifSourceMetagenerationNotMatch=None)

@@ -261,17 +261,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.html b/docs/dyn/storage_v1.html index f7064893e0..ea822f1ce2 100644 --- a/docs/dyn/storage_v1.html +++ b/docs/dyn/storage_v1.html @@ -143,7 +143,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -152,20 +152,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/storage_v1.managedFolders.html b/docs/dyn/storage_v1.managedFolders.html index 8e5bceee41..5fbf390110 100644 --- a/docs/dyn/storage_v1.managedFolders.html +++ b/docs/dyn/storage_v1.managedFolders.html @@ -93,7 +93,7 @@

Instance Methods

list(bucket, pageSize=None, pageToken=None, prefix=None)

Lists managed folders in the given bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(bucket, managedFolder, body=None, userProject=None)

@@ -302,17 +302,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.objects.html b/docs/dyn/storage_v1.objects.html index 34b7f505fb..5de58dba93 100644 --- a/docs/dyn/storage_v1.objects.html +++ b/docs/dyn/storage_v1.objects.html @@ -105,7 +105,7 @@

Instance Methods

list(bucket, delimiter=None, endOffset=None, filter=None, includeFoldersAsPrefixes=None, includeTrailingDelimiter=None, matchGlob=None, maxResults=None, pageToken=None, prefix=None, projection=None, softDeleted=None, startOffset=None, userProject=None, versions=None)

Retrieves a list of objects matching the criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(bucket, sourceObject, destinationObject, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, ifSourceGenerationMatch=None, ifSourceGenerationNotMatch=None, ifSourceMetagenerationMatch=None, ifSourceMetagenerationNotMatch=None, projection=None, userProject=None)

@@ -1188,17 +1188,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.operations.html b/docs/dyn/storage_v1.operations.html index 2b30b76e5e..6f5a96357f 100644 --- a/docs/dyn/storage_v1.operations.html +++ b/docs/dyn/storage_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(bucket, filter=None, pageSize=None, pageToken=None)

Lists operations that match the specified filter in the request.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -203,17 +203,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storage_v1.projects.hmacKeys.html b/docs/dyn/storage_v1.projects.hmacKeys.html index fc740d05ce..3044aace0e 100644 --- a/docs/dyn/storage_v1.projects.hmacKeys.html +++ b/docs/dyn/storage_v1.projects.hmacKeys.html @@ -90,7 +90,7 @@

Instance Methods

list(projectId, maxResults=None, pageToken=None, serviceAccountEmail=None, showDeletedKeys=None, userProject=None)

Retrieves a list of HMAC keys matching the criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(projectId, accessId, body=None, userProject=None)

@@ -204,17 +204,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storage_v1.rapidCaches.html b/docs/dyn/storage_v1.rapidCaches.html index 5c68c5660b..5ebf209f14 100644 --- a/docs/dyn/storage_v1.rapidCaches.html +++ b/docs/dyn/storage_v1.rapidCaches.html @@ -90,7 +90,7 @@

Instance Methods

list(bucket, pageSize=None, pageToken=None)

Returns a list of Rapid Cache instances of the bucket.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(bucket, rapidCacheId, body=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storagebatchoperations_v1.html b/docs/dyn/storagebatchoperations_v1.html index 1f010e2b47..aa6d1e6ecb 100644 --- a/docs/dyn/storagebatchoperations_v1.html +++ b/docs/dyn/storagebatchoperations_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/storagebatchoperations_v1.projects.locations.html b/docs/dyn/storagebatchoperations_v1.projects.locations.html index 5844e23f2a..9118d2a9b3 100644 --- a/docs/dyn/storagebatchoperations_v1.projects.locations.html +++ b/docs/dyn/storagebatchoperations_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storagebatchoperations_v1.projects.locations.jobs.bucketOperations.html b/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.bucketOperations.html index 2372cfea5c..9add3f40bb 100644 --- a/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.bucketOperations.html +++ b/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.bucketOperations.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists BucketOperations in a given project and job.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storagebatchoperations_v1.projects.locations.jobs.html b/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.html index f681e5560f..b40d14b3c2 100644 --- a/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.html +++ b/docs/dyn/storagebatchoperations_v1.projects.locations.jobs.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Jobs in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -636,17 +636,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storagebatchoperations_v1.projects.locations.operations.html b/docs/dyn/storagebatchoperations_v1.projects.locations.operations.html index 7752ae63ad..998d891fc9 100644 --- a/docs/dyn/storagebatchoperations_v1.projects.locations.operations.html +++ b/docs/dyn/storagebatchoperations_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/storagetransfer_v1.html b/docs/dyn/storagetransfer_v1.html index 270fd33870..d34d1d3911 100644 --- a/docs/dyn/storagetransfer_v1.html +++ b/docs/dyn/storagetransfer_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/storagetransfer_v1.projects.agentPools.html b/docs/dyn/storagetransfer_v1.projects.agentPools.html index d7aae426b4..b4a3a5797c 100644 --- a/docs/dyn/storagetransfer_v1.projects.agentPools.html +++ b/docs/dyn/storagetransfer_v1.projects.agentPools.html @@ -90,7 +90,7 @@

Instance Methods

list(projectId, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists agent pools.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -213,17 +213,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storagetransfer_v1.transferJobs.html b/docs/dyn/storagetransfer_v1.transferJobs.html index 3a7ce45236..ebec9e66db 100644 --- a/docs/dyn/storagetransfer_v1.transferJobs.html +++ b/docs/dyn/storagetransfer_v1.transferJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(filter, pageSize=None, pageToken=None, x__xgafv=None)

Lists transfer jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(jobName, body=None, x__xgafv=None)

@@ -1015,17 +1015,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/storagetransfer_v1.transferOperations.html b/docs/dyn/storagetransfer_v1.transferOperations.html index 21ea2b7aa3..f7d1452e22 100644 --- a/docs/dyn/storagetransfer_v1.transferOperations.html +++ b/docs/dyn/storagetransfer_v1.transferOperations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists transfer operations. Operations are ordered by their creation time in reverse chronological order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

pause(name, body=None, x__xgafv=None)

@@ -208,17 +208,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/streetviewpublish_v1.html b/docs/dyn/streetviewpublish_v1.html index 816c1345a8..ebe9ad78b3 100644 --- a/docs/dyn/streetviewpublish_v1.html +++ b/docs/dyn/streetviewpublish_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/streetviewpublish_v1.photoSequences.html b/docs/dyn/streetviewpublish_v1.photoSequences.html index 1b716344a3..be1fb00e65 100644 --- a/docs/dyn/streetviewpublish_v1.photoSequences.html +++ b/docs/dyn/streetviewpublish_v1.photoSequences.html @@ -81,7 +81,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all the PhotoSequences that belong to the user, in descending CreatePhotoSequence timestamp order.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -132,17 +132,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/streetviewpublish_v1.photos.html b/docs/dyn/streetviewpublish_v1.photos.html index 4e80177187..3f03a50558 100644 --- a/docs/dyn/streetviewpublish_v1.photos.html +++ b/docs/dyn/streetviewpublish_v1.photos.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, languageCode=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists all the Photos that belong to the user. > Note: Recently created photos that are still being indexed are not returned in the response.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -425,17 +425,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/sts_v1.html b/docs/dyn/sts_v1.html index 0023f688b3..65c8777a2f 100644 --- a/docs/dyn/sts_v1.html +++ b/docs/dyn/sts_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.openid.html b/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.openid.html index b44fb38416..bd437576f6 100644 --- a/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.openid.html +++ b/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.openid.html @@ -79,7 +79,7 @@

Instance Methods

Close httplib2 connections.

getJwks(name, x__xgafv=None)

-

Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).

+

Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).

Method Details

close() @@ -88,10 +88,10 @@

Method Details

getJwks(name, x__xgafv=None) - 
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).
+  
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).
 
 Args:
-  name: string, Required. The name of the pool whose JWKS needs to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog' (required)
+  name: string, Required. The name of the pool whose JWKs need to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog' (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -101,8 +101,8 @@ 
Method Details

   An object of the form:
 
     { # Response message for GetJwks.
-  "keys": [ # The JWKS for this OP.
-    { # A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle
+  "keys": [ # The JWKs for this OP.
+    { # A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle.
       "alg": "A String", # Algorithm intended for use with the key. Currently "RS256".
       "e": "A String", # Exponent value for kty="RSA".
       "kid": "A String", # Key ID.
diff --git a/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.well_known.html b/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.well_known.html
index 4d479a9c37..b092d841f8 100644
--- a/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.well_known.html
+++ b/docs/dyn/sts_v1.organizations.locations.workloadIdentityPools.well_known.html
@@ -100,17 +100,17 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse
+    { # Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse.
   "authorization_endpoint": "A String", # URL pointing to an authorization endpoint under this issuer. Note: Currently this endpoint returns a 404.
-  "id_token_signing_alg_values_supported": [ # JSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT [JWT]. Note: Currently always "["RS256"]".
+  "id_token_signing_alg_values_supported": [ # JSON array that contains a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT. Supported value: `RS256`.
     "A String",
   ],
   "issuer": "A String", # URL using the https scheme with no query or fragment components that the OP asserts as its issuer identifier.
-  "jwks_uri": "A String", # URL of the OP's JWK Set [JWK] document, which MUST use the https scheme.
-  "response_types_supported": [ # JSON array containing a list of the OAuth 2.0 response_type values that this OP supports. Note: Currently always "["id_token"]".
+  "jwks_uri": "A String", # URL of the OP's JWK Set document, which MUST use the https scheme.
+  "response_types_supported": [ # JSON array that contains a list of the OAuth 2.0 response_type values that this OP supports. Supported value: `id_token`.
     "A String",
   ],
-  "subject_types_supported": [ # JSON array containing a list of the subject identifier types that this OP supports. Note: Currently always "["public"]".
+  "subject_types_supported": [ # JSON array that contains a list of the subject identifier types that this OP supports. Supported value: `public`.
     "A String",
   ],
   "token_endpoint": "A String", # URL pointing to a token endpoint under this issuer. Note: Currently this endpoint returns a 404.
diff --git a/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.openid.html b/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.openid.html
index 5812a1df13..10a69cf8a3 100644
--- a/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.openid.html
+++ b/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.openid.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   getJwks(name, x__xgafv=None)

-
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).

+
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).

 
Method Details

 

     close()
@@ -88,10 +88,10 @@ 
Method Details

 
 

     getJwks(name, x__xgafv=None)
-  
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).
+  
Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).
 
 Args:
-  name: string, Required. The name of the pool whose JWKS needs to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog' (required)
+  name: string, Required. The name of the pool whose JWKs need to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog' (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -101,8 +101,8 @@ 
Method Details

   An object of the form:
 
     { # Response message for GetJwks.
-  "keys": [ # The JWKS for this OP.
-    { # A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle
+  "keys": [ # The JWKs for this OP.
+    { # A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle.
       "alg": "A String", # Algorithm intended for use with the key. Currently "RS256".
       "e": "A String", # Exponent value for kty="RSA".
       "kid": "A String", # Key ID.
diff --git a/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.well_known.html b/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.well_known.html
index 04d0b95c0e..18b51aefbb 100644
--- a/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.well_known.html
+++ b/docs/dyn/sts_v1.projects.locations.workloadIdentityPools.well_known.html
@@ -100,17 +100,17 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse
+    { # Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse.
   "authorization_endpoint": "A String", # URL pointing to an authorization endpoint under this issuer. Note: Currently this endpoint returns a 404.
-  "id_token_signing_alg_values_supported": [ # JSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT [JWT]. Note: Currently always "["RS256"]".
+  "id_token_signing_alg_values_supported": [ # JSON array that contains a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT. Supported value: `RS256`.
     "A String",
   ],
   "issuer": "A String", # URL using the https scheme with no query or fragment components that the OP asserts as its issuer identifier.
-  "jwks_uri": "A String", # URL of the OP's JWK Set [JWK] document, which MUST use the https scheme.
-  "response_types_supported": [ # JSON array containing a list of the OAuth 2.0 response_type values that this OP supports. Note: Currently always "["id_token"]".
+  "jwks_uri": "A String", # URL of the OP's JWK Set document, which MUST use the https scheme.
+  "response_types_supported": [ # JSON array that contains a list of the OAuth 2.0 response_type values that this OP supports. Supported value: `id_token`.
     "A String",
   ],
-  "subject_types_supported": [ # JSON array containing a list of the subject identifier types that this OP supports. Note: Currently always "["public"]".
+  "subject_types_supported": [ # JSON array that contains a list of the subject identifier types that this OP supports. Supported value: `public`.
     "A String",
   ],
   "token_endpoint": "A String", # URL pointing to a token endpoint under this issuer. Note: Currently this endpoint returns a 404.
diff --git a/docs/dyn/sts_v1beta.html b/docs/dyn/sts_v1beta.html
index 114efe1d66..321b233edc 100644
--- a/docs/dyn/sts_v1beta.html
+++ b/docs/dyn/sts_v1beta.html
@@ -83,7 +83,7 @@ 
Instance Methods

   close()

 
Close httplib2 connections.

 

-  new_batch_http_request(callback=None)

+  new_batch_http_request()

 
Create a BatchHttpRequest object based on the discovery document.

 
Method Details

 

@@ -92,20 +92,20 @@ 
Method Details

 

 
 

-    new_batch_http_request(callback=None)
+    new_batch_http_request()
   
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-

+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

 

 
 
\ No newline at end of file
diff --git a/docs/dyn/tagmanager_v1.html b/docs/dyn/tagmanager_v1.html
index 08dd6310a6..c172de4ff9 100644
--- a/docs/dyn/tagmanager_v1.html
+++ b/docs/dyn/tagmanager_v1.html
@@ -83,7 +83,7 @@ 
Instance Methods

   close()

 
Close httplib2 connections.

 

-  new_batch_http_request(callback=None)

+  new_batch_http_request()

 
Create a BatchHttpRequest object based on the discovery document.

 
Method Details

 

@@ -92,20 +92,20 @@ 
Method Details

 

 
 

-    new_batch_http_request(callback=None)
+    new_batch_http_request()
   
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-

+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+
\ No newline at end of file diff --git a/docs/dyn/tagmanager_v2.accounts.containers.environments.html b/docs/dyn/tagmanager_v2.accounts.containers.environments.html index c43afa76eb..b16943b553 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.environments.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.environments.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Environments of a GTM Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reauthorize(path, body=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.html b/docs/dyn/tagmanager_v2.accounts.containers.html index 0f8b9a865b..f484676493 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.html @@ -118,7 +118,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all Containers that belongs to a GTM Account.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

lookup(destinationId=None, tagId=None, x__xgafv=None)

@@ -423,17 +423,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.version_headers.html b/docs/dyn/tagmanager_v2.accounts.containers.version_headers.html index 4b54f27ccb..0a9519007d 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.version_headers.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.version_headers.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, includeDeleted=None, pageToken=None, x__xgafv=None)

Lists all Container Versions of a GTM Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -164,17 +164,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tagmanager_v2.accounts.containers.workspaces.built_in_variables.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.built_in_variables.html index cc31713c9c..e3e0d1c5c2 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.built_in_variables.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.built_in_variables.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all the enabled Built-In Variables of a GTM Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, type=None, x__xgafv=None)

@@ -408,17 +408,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.clients.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.clients.html index 45f522f9c0..88c3a727ba 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.clients.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.clients.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Clients of a GTM container workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.folders.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.folders.html index 1320cce8a7..9cfff5fdcc 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.folders.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.folders.html @@ -87,7 +87,7 @@

Instance Methods

entities(path, pageToken=None, x__xgafv=None)

List all entities in a GTM Folder.

- entities_next(previous_request, previous_response)

+ entities_next()

Retrieves the next page of results.

get(path, x__xgafv=None)

@@ -96,7 +96,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Folders of a Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move_entities_to_folder(path, body=None, tagId=None, triggerId=None, variableId=None, x__xgafv=None)

@@ -661,17 +661,17 @@

Method Details

- entities_next(previous_request, previous_response) + entities_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)
+        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.
-
+ 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. +
@@ -735,17 +735,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.gtag_config.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.gtag_config.html index 06aae9f782..b44f086c61 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.gtag_config.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.gtag_config.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all Google tag configs in a Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(path, body=None, fingerprint=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.html index 025dc1aba6..a6017f140e 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.html @@ -149,7 +149,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all Workspaces that belong to a GTM Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

quick_preview(path, x__xgafv=None)

@@ -4241,17 +4241,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.tags.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.tags.html index cb9ff73a16..2063a0fb1d 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.tags.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.tags.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Tags of a Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -536,17 +536,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.templates.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.templates.html index 6e72d0aa2b..06227b572d 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.templates.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.templates.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Templates of a GTM container workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -304,17 +304,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.transformations.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.transformations.html index 37f96fbf08..bf1ddc9ea8 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.transformations.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.transformations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Transformations of a GTM container workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.triggers.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.triggers.html index e5b559f896..d1b52bc343 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.triggers.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.triggers.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Triggers of a Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -1328,17 +1328,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.variables.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.variables.html index ea02c26983..1a30874023 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.variables.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.variables.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Variables of a Container.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -528,17 +528,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.zones.html b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.zones.html index 90f25291d2..af818d1f89 100644 --- a/docs/dyn/tagmanager_v2.accounts.containers.workspaces.zones.html +++ b/docs/dyn/tagmanager_v2.accounts.containers.workspaces.zones.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

Lists all GTM Zones of a GTM container workspace.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

revert(path, fingerprint=None, x__xgafv=None)

@@ -364,17 +364,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.html b/docs/dyn/tagmanager_v2.accounts.html index 0e15a7ecd2..93e3b2eae8 100644 --- a/docs/dyn/tagmanager_v2.accounts.html +++ b/docs/dyn/tagmanager_v2.accounts.html @@ -94,7 +94,7 @@

Instance Methods

list(includeGoogleTags=None, pageToken=None, x__xgafv=None)

Lists all GTM Accounts that a user has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(path, body=None, fingerprint=None, x__xgafv=None)

@@ -168,17 +168,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.accounts.user_permissions.html b/docs/dyn/tagmanager_v2.accounts.user_permissions.html index 9c65ba23f3..ef253cabcd 100644 --- a/docs/dyn/tagmanager_v2.accounts.user_permissions.html +++ b/docs/dyn/tagmanager_v2.accounts.user_permissions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageToken=None, x__xgafv=None)

List all users that have access to the account along with Account and Container user access granted to each of them.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(path, body=None, x__xgafv=None)

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tagmanager_v2.html b/docs/dyn/tagmanager_v2.html index 4c5da425a8..30136fced9 100644 --- a/docs/dyn/tagmanager_v2.html +++ b/docs/dyn/tagmanager_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tasks_v1.html b/docs/dyn/tasks_v1.html index 135fbe3772..895634c7f3 100644 --- a/docs/dyn/tasks_v1.html +++ b/docs/dyn/tasks_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tasks_v1.tasklists.html b/docs/dyn/tasks_v1.tasklists.html index db7d8f4ead..dca9dc22a9 100644 --- a/docs/dyn/tasks_v1.tasklists.html +++ b/docs/dyn/tasks_v1.tasklists.html @@ -90,7 +90,7 @@

Instance Methods

list(maxResults=None, pageToken=None, x__xgafv=None)

Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(tasklist, body=None, x__xgafv=None)

@@ -209,17 +209,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tasks_v1.tasks.html b/docs/dyn/tasks_v1.tasks.html index 02b01a66f1..a6077ddbfc 100644 --- a/docs/dyn/tasks_v1.tasks.html +++ b/docs/dyn/tasks_v1.tasks.html @@ -93,7 +93,7 @@

Instance Methods

list(tasklist, completedMax=None, completedMin=None, dueMax=None, dueMin=None, maxResults=None, pageToken=None, showAssigned=None, showCompleted=None, showDeleted=None, showHidden=None, updatedMin=None, x__xgafv=None)

Returns all tasks in the specified task list. Doesn't return assigned tasks by default (from Docs, Chat Spaces). A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

move(tasklist, task, destinationTasklist=None, parent=None, previous=None, x__xgafv=None)

@@ -351,17 +351,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/testing_v1.html b/docs/dyn/testing_v1.html index d0a6d481c3..a06421e51f 100644 --- a/docs/dyn/testing_v1.html +++ b/docs/dyn/testing_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/testing_v1.projects.deviceSessions.html b/docs/dyn/testing_v1.projects.deviceSessions.html index fc91167774..c04b85f666 100644 --- a/docs/dyn/testing_v1.projects.deviceSessions.html +++ b/docs/dyn/testing_v1.projects.deviceSessions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

GET /v1/projects/{project_id}/deviceSessions Lists device Sessions owned by the project user.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -278,17 +278,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/texttospeech_v1.html b/docs/dyn/texttospeech_v1.html index dabaf177c0..c1ffb9a891 100644 --- a/docs/dyn/texttospeech_v1.html +++ b/docs/dyn/texttospeech_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/texttospeech_v1.projects.locations.operations.html b/docs/dyn/texttospeech_v1.projects.locations.operations.html index 585724f9a7..5fa1c311f3 100644 --- a/docs/dyn/texttospeech_v1.projects.locations.operations.html +++ b/docs/dyn/texttospeech_v1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/texttospeech_v1beta1.html b/docs/dyn/texttospeech_v1beta1.html index 0c083b1736..fe050728b3 100644 --- a/docs/dyn/texttospeech_v1beta1.html +++ b/docs/dyn/texttospeech_v1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/texttospeech_v1beta1.projects.locations.operations.html b/docs/dyn/texttospeech_v1beta1.projects.locations.operations.html index 9e9a03fb14..d45cd46454 100644 --- a/docs/dyn/texttospeech_v1beta1.projects.locations.operations.html +++ b/docs/dyn/texttospeech_v1beta1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/threatintelligence_v1beta.html b/docs/dyn/threatintelligence_v1beta.html index beb7eb475e..95cfe801f6 100644 --- a/docs/dyn/threatintelligence_v1beta.html +++ b/docs/dyn/threatintelligence_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/threatintelligence_v1beta.projects.alerts.html b/docs/dyn/threatintelligence_v1beta.projects.alerts.html index a9202082c6..58fed83c51 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.alerts.html +++ b/docs/dyn/threatintelligence_v1beta.projects.alerts.html @@ -107,7 +107,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of alerts that meet the filter criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

notActionable(name, body=None, x__xgafv=None)

@@ -164,10 +164,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -312,10 +398,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -488,10 +660,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -630,10 +888,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -766,10 +1110,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -927,10 +1357,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -1034,17 +1550,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1086,10 +1602,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -1228,10 +1830,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -1370,10 +2058,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -1512,10 +2286,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. @@ -1654,10 +2514,96 @@

Method Details

"severity": "A String", # Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "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": { # A detailed object for a Domain or URL alert. # Domain Monitoring alert detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "initialAccessBroker": { # Captures the specific details of InitialAccessBroker (IAB) alert. # Initial Access Broker alert detail type. - "discoveryDocumentIds": [ # Required. Array of ids to accommodate multiple discovery documents + "discoveryDocumentIds": [ # Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents. "A String", ], + "discoveryDocuments": [ # Output only. New structured metadata payload. + { # Replaces the raw string ID to hold associated metadata. + "documentId": "A String", # Output only. The identifier of the discovery document. + "documentType": "A String", # Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`). + }, + ], "severity": "A String", # Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL` }, "insiderThreat": { # Captures the specific details of InsiderThreat alert. # Insider Threat alert detail type. diff --git a/docs/dyn/threatintelligence_v1beta.projects.configurations.html b/docs/dyn/threatintelligence_v1beta.projects.configurations.html index 399f6f4e7b..51f2b3d434 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.configurations.html +++ b/docs/dyn/threatintelligence_v1beta.projects.configurations.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of configurations that meet the filter criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

upsert(parent, body=None, publishTime=None, x__xgafv=None)

@@ -320,6 +320,13 @@

Method Details

}, ], }, + "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. + }, + ], + }, "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 score for the alert. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0]. @@ -570,6 +577,13 @@

Method Details

}, ], }, + "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. + }, + ], + }, "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 score for the alert. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0]. @@ -598,17 +612,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -826,6 +840,13 @@

Method Details

}, ], }, + "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. + }, + ], + }, "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 score for the alert. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0]. diff --git a/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html b/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html index 09ec50c956..3095c0b89a 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html +++ b/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List configuration revisions that meet the filter criteria.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -319,6 +319,13 @@

Method Details

}, ], }, + "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. + }, + ], + }, "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 score for the alert. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Ex: 7.0. Valid range is [0.0, 10.0]. @@ -347,17 +354,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/threatintelligence_v1beta.projects.findings.html b/docs/dyn/threatintelligence_v1beta.projects.findings.html index 50582d7534..3a1ae147f7 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.findings.html +++ b/docs/dyn/threatintelligence_v1beta.projects.findings.html @@ -84,13 +84,13 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Get a list of findings that meet the filter criteria. The `parent` field in ListFindingsRequest should have the format: projects/{project}

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

search(parent, orderBy=None, pageSize=None, pageToken=None, query=None, x__xgafv=None)

SearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for alerts" using functions such as `has_alert` in the query string. The `parent` field in SearchFindingsRequest should have the format: projects/{project} Example to search for findings for a specific issue: `has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")`

- search_next(previous_request, previous_response)

+ search_next()

Retrieves the next page of results.

Method Details

@@ -131,6 +131,86 @@

Method Details

"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. + "domainMonitoring": { # A detailed object for a Domain or URL finding. # Domain Monitoring finding detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "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. @@ -260,6 +340,86 @@

Method Details

"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. + "domainMonitoring": { # A detailed object for a Domain or URL finding. # Domain Monitoring finding detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "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. @@ -354,17 +514,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -406,6 +566,86 @@

Method Details

"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. + "domainMonitoring": { # A detailed object for a Domain or URL finding. # Domain Monitoring finding detail type. + "dnsDetails": { # The DNS details of the domain. # Optional. The DNS details of the domain or URL. + "dnsRecords": [ # Optional. The DNS records of the domain. + { # The DNS record of the domain. + "asnHosting": "A String", # Optional. The ASN hosting the domain. + "asnRegionCode": "A String", # Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes. + "ipRegionCode": "A String", # Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes. + "recordData": "A String", # Optional. The value of the DNS record. + "resolvedIp": "A String", # Optional. The resolved IP address. + "ttl": 42, # Optional. The TTL of the DNS record. + "type": "A String", # Optional. The type of the DNS record. + }, + ], + "retrievalTime": "A String", # Optional. The time the DNS details were retrieved. + }, + "domainDetails": { # Details specific to a monitored domain. # Details specific to a monitored domain. + "domain": "A String", # Required. The domain name to match against. + }, + "gtiDetails": { # The GTI details of the domain. # Optional. The GTI details of the domain or URL. + "avDetections": { # Details about the detection vendors. # Optional. Detection counts across vendor feeds. + "detectedVendorCount": 42, # Optional. Number of vendors that detected the threat. + "totalVendorCount": 42, # Optional. Total number of vendors. + }, + "domainPermutation": "A String", # Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph). + "gtiDomainUri": "A String", # Optional. The GTI link for the domain. + "gtiScore": 42, # Optional. The GTI score of the domain. The threat score is a number between 0 and 100. + "threatClassification": "A String", # Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring). + "verdict": "A String", # Output only. The verdict of the domain. + }, + "infrastructure": { # Core infrastructure observations associated with the URL or Domain. # Optional. The infrastructure of the domain or URL. + "certificateDetails": { # Details regarding the SSL certificate configuration. # Optional. SSL certificate details. + "issuer": "A String", # Optional. The SSL certificate issuer. + "subjectAlternativeNames": [ # Optional. The SSL subject alternative names. + "A String", + ], + }, + "urlResponse": "A String", # Optional. The raw URL response string. + }, + "matchedDomain": "A String", # Optional. The matched domain. + "protectedBrand": "A String", # The protected brand name that triggered the alert. + "protectedDomain": { # Details specific to a monitored domain. # The protected domain that triggered the alert. + "domain": "A String", # Required. The domain name to match against. + }, + "registrationDetails": { # Extracted WHOIS and DNS registration details of the domain. # Optional. Extracted WHOIS and DNS registration details. + "expireTime": "A String", # Optional. The specific timestamp when the current domain registration expires. + "privateRegistration": True or False, # Optional. Indicates whether private registration is enabled on the WHOIS record. + "registrantCountry": "A String", # Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes + "registrar": "A String", # Optional. The registrar where the domain was registered (e.g., NameCheap). + "registrationTime": "A String", # Optional. The specific timestamp when the domain registration was created. + }, + "relationships": { # Related entities and domains observed for the target. # Optional. The relationships of the domain or URL. + "relatedUrls": [ # Optional. Related URLs associated with the domain. + "A String", + ], + "siblingDomains": [ # Optional. Sibling domains sharing the same IP address. + "A String", + ], + "subdomains": [ # Optional. Subdomains associated with the target domain or URL. + "A String", + ], + }, + "threatAttributionDetails": { # Threat attribution information (actor, campaign, etc.). # Optional. The threat attribution details of the domain or URL. + "actors": [ # Optional. The threat actors associated with the target. + "A String", + ], + "collections": [ # Optional. The threat collections detected. + "A String", + ], + "malware": [ # Optional. The malware associated with the threat. + "A String", + ], + }, + "urlDetails": { # Details specific to a monitored URL. # Details specific to a monitored URL. + "url": "A String", # Required. The URL to match against. + }, + "whoisDetails": { # The whois details of the domain. # Optional. The whois details of the domain or URL. + "retrievalTime": "A String", # Optional. The time the whois details were retrieved. + "whois": "A String", # Optional. The whois details of the domain. + }, + }, "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. @@ -500,17 +740,17 @@

Method Details

- search_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/toolresults_v1beta3.html b/docs/dyn/toolresults_v1beta3.html index d9fa862783..bbc470b652 100644 --- a/docs/dyn/toolresults_v1beta3.html +++ b/docs/dyn/toolresults_v1beta3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/toolresults_v1beta3.projects.histories.executions.environments.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.environments.html index 1799140ddd..3cb4bdf4e5 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.environments.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.environments.html @@ -84,7 +84,7 @@

Instance Methods

list(projectId, historyId, executionId, pageSize=None, pageToken=None, x__xgafv=None)

Lists Environments for a given Execution. The Environments are sorted by display name. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing Execution does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -398,17 +398,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/toolresults_v1beta3.projects.histories.executions.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.html index a23e75c60a..a99e2ec1b4 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.html @@ -102,7 +102,7 @@

Instance Methods

list(projectId, historyId, pageSize=None, pageToken=None, x__xgafv=None)

Lists Executions for a given History. The executions are sorted by creation_time in descending order. The execution_id key will be used to order the executions with the same creation_time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing History does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, historyId, executionId, body=None, requestId=None, x__xgafv=None)

@@ -546,17 +546,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.html index 5d99071ec3..55669668db 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.html @@ -113,7 +113,7 @@

Instance Methods

list(projectId, historyId, executionId, pageSize=None, pageToken=None, x__xgafv=None)

Lists Steps for a given Execution. The steps are sorted by creation_time in descending order. The step_id key will be used to order the steps with the same creation_time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if an argument in the request happens to be invalid; e.g. if an attempt is made to list the children of a nonexistent Step - NOT_FOUND - if the containing Execution does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(projectId, historyId, executionId, stepId, body=None, requestId=None, x__xgafv=None)

@@ -1027,17 +1027,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.perfSampleSeries.samples.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.perfSampleSeries.samples.html index 85f72532e7..60d3d4a388 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.perfSampleSeries.samples.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.perfSampleSeries.samples.html @@ -84,7 +84,7 @@

Instance Methods

list(projectId, historyId, executionId, stepId, sampleSeriesId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Performance Samples of a given Sample Series - The list results are sorted by timestamps ascending - The default page size is 500 samples; and maximum size allowed 5000 - The response token indicates the last returned PerfSample timestamp - When the results size exceeds the page size, submit a subsequent request including the page token to return the rest of the samples up to the page limit May return any of the following canonical error codes: - OUT_OF_RANGE - The specified request page_token is out of valid range - NOT_FOUND - The containing PerfSampleSeries does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -173,17 +173,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/toolresults_v1beta3.projects.histories.executions.steps.testCases.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.testCases.html index 581f309f1c..5d72407660 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.testCases.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.testCases.html @@ -84,7 +84,7 @@

Instance Methods

list(projectId, historyId, executionId, stepId, pageSize=None, pageToken=None, x__xgafv=None)

Lists Test Cases attached to a Step. Experimental test cases API. Still in active development. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing Step does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -225,17 +225,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/toolresults_v1beta3.projects.histories.executions.steps.thumbnails.html b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.thumbnails.html index c3e66f1fa6..6a132614c6 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.thumbnails.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.executions.steps.thumbnails.html @@ -81,7 +81,7 @@

Instance Methods

list(projectId, historyId, executionId, stepId, pageSize=None, pageToken=None, x__xgafv=None)

Lists thumbnails of images attached to a step. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read from the project, or from any of the images - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the step does not exist, or if any of the images do not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -148,17 +148,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/toolresults_v1beta3.projects.histories.html b/docs/dyn/toolresults_v1beta3.projects.histories.html index 2f3a7510ed..8ee7d7a7c7 100644 --- a/docs/dyn/toolresults_v1beta3.projects.histories.html +++ b/docs/dyn/toolresults_v1beta3.projects.histories.html @@ -92,7 +92,7 @@

Instance Methods

list(projectId, filterByName=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Histories for a given Project. The histories are sorted by modification time in descending order. The history_id key will be used to order the history with the same modification time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the History does not exist

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -187,17 +187,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1.html b/docs/dyn/tpu_v1.html index 04ffbf872d..f5b162c79e 100644 --- a/docs/dyn/tpu_v1.html +++ b/docs/dyn/tpu_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tpu_v1.projects.locations.acceleratorTypes.html b/docs/dyn/tpu_v1.projects.locations.acceleratorTypes.html index 0f06b21db0..a3dc7911aa 100644 --- a/docs/dyn/tpu_v1.projects.locations.acceleratorTypes.html +++ b/docs/dyn/tpu_v1.projects.locations.acceleratorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists accelerator types supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1.projects.locations.html b/docs/dyn/tpu_v1.projects.locations.html index 920e016fe7..16cf53de68 100644 --- a/docs/dyn/tpu_v1.projects.locations.html +++ b/docs/dyn/tpu_v1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1.projects.locations.nodes.html b/docs/dyn/tpu_v1.projects.locations.nodes.html index ba17e4ce9d..d6d6344bd3 100644 --- a/docs/dyn/tpu_v1.projects.locations.nodes.html +++ b/docs/dyn/tpu_v1.projects.locations.nodes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reimage(name, body=None, x__xgafv=None)

@@ -339,17 +339,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v1.projects.locations.operations.html b/docs/dyn/tpu_v1.projects.locations.operations.html index 7e8e18a68e..148570b133 100644 --- a/docs/dyn/tpu_v1.projects.locations.operations.html +++ b/docs/dyn/tpu_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1.projects.locations.tensorflowVersions.html b/docs/dyn/tpu_v1.projects.locations.tensorflowVersions.html index cdf99c8284..0f505c078a 100644 --- a/docs/dyn/tpu_v1.projects.locations.tensorflowVersions.html +++ b/docs/dyn/tpu_v1.projects.locations.tensorflowVersions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

List TensorFlow versions supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1alpha1.html b/docs/dyn/tpu_v1alpha1.html index 604ae3b045..a35d0c8c04 100644 --- a/docs/dyn/tpu_v1alpha1.html +++ b/docs/dyn/tpu_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tpu_v1alpha1.projects.locations.acceleratorTypes.html b/docs/dyn/tpu_v1alpha1.projects.locations.acceleratorTypes.html index 8e58c7e914..718f57e7e0 100644 --- a/docs/dyn/tpu_v1alpha1.projects.locations.acceleratorTypes.html +++ b/docs/dyn/tpu_v1alpha1.projects.locations.acceleratorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists accelerator types supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1alpha1.projects.locations.html b/docs/dyn/tpu_v1alpha1.projects.locations.html index c1b6d5216e..1a90bf7a1a 100644 --- a/docs/dyn/tpu_v1alpha1.projects.locations.html +++ b/docs/dyn/tpu_v1alpha1.projects.locations.html @@ -104,7 +104,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -176,17 +176,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1alpha1.projects.locations.nodes.html b/docs/dyn/tpu_v1alpha1.projects.locations.nodes.html index 2f6eb148ed..b31de96fa5 100644 --- a/docs/dyn/tpu_v1alpha1.projects.locations.nodes.html +++ b/docs/dyn/tpu_v1alpha1.projects.locations.nodes.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reimage(name, body=None, x__xgafv=None)

@@ -341,17 +341,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v1alpha1.projects.locations.operations.html b/docs/dyn/tpu_v1alpha1.projects.locations.operations.html index 2c9ae7f812..2e70fd78cb 100644 --- a/docs/dyn/tpu_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/tpu_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v1alpha1.projects.locations.tensorflowVersions.html b/docs/dyn/tpu_v1alpha1.projects.locations.tensorflowVersions.html index 3cb724ef8f..c69bbf8afe 100644 --- a/docs/dyn/tpu_v1alpha1.projects.locations.tensorflowVersions.html +++ b/docs/dyn/tpu_v1alpha1.projects.locations.tensorflowVersions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TensorFlow versions supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2.html b/docs/dyn/tpu_v2.html index 45b13669a5..aa50f69955 100644 --- a/docs/dyn/tpu_v2.html +++ b/docs/dyn/tpu_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tpu_v2.projects.locations.acceleratorTypes.html b/docs/dyn/tpu_v2.projects.locations.acceleratorTypes.html index 5b1ac005fd..642051e5ad 100644 --- a/docs/dyn/tpu_v2.projects.locations.acceleratorTypes.html +++ b/docs/dyn/tpu_v2.projects.locations.acceleratorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists accelerator types supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2.projects.locations.html b/docs/dyn/tpu_v2.projects.locations.html index c30835f5eb..4b18563962 100644 --- a/docs/dyn/tpu_v2.projects.locations.html +++ b/docs/dyn/tpu_v2.projects.locations.html @@ -112,7 +112,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2.projects.locations.nodes.html b/docs/dyn/tpu_v2.projects.locations.nodes.html index 008985fdd6..13301e428c 100644 --- a/docs/dyn/tpu_v2.projects.locations.nodes.html +++ b/docs/dyn/tpu_v2.projects.locations.nodes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -552,17 +552,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v2.projects.locations.operations.html b/docs/dyn/tpu_v2.projects.locations.operations.html index 465c1cebda..567ad84464 100644 --- a/docs/dyn/tpu_v2.projects.locations.operations.html +++ b/docs/dyn/tpu_v2.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2.projects.locations.queuedResources.html b/docs/dyn/tpu_v2.projects.locations.queuedResources.html index 24b82b6b51..58d66ef61a 100644 --- a/docs/dyn/tpu_v2.projects.locations.queuedResources.html +++ b/docs/dyn/tpu_v2.projects.locations.queuedResources.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists queued resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

reset(name, body=None, x__xgafv=None)

@@ -687,17 +687,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v2.projects.locations.runtimeVersions.html b/docs/dyn/tpu_v2.projects.locations.runtimeVersions.html index fb5caa8c43..3260539a74 100644 --- a/docs/dyn/tpu_v2.projects.locations.runtimeVersions.html +++ b/docs/dyn/tpu_v2.projects.locations.runtimeVersions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists runtime versions supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2alpha1.html b/docs/dyn/tpu_v2alpha1.html index b2c6842f91..7596b435ed 100644 --- a/docs/dyn/tpu_v2alpha1.html +++ b/docs/dyn/tpu_v2alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/tpu_v2alpha1.projects.locations.acceleratorTypes.html b/docs/dyn/tpu_v2alpha1.projects.locations.acceleratorTypes.html index 9d480d3a62..b39a3d4ee6 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.acceleratorTypes.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.acceleratorTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists accelerator types supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -157,17 +157,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2alpha1.projects.locations.html b/docs/dyn/tpu_v2alpha1.projects.locations.html index f5e597c21d..2d7f34f70f 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.html @@ -117,7 +117,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

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(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2alpha1.projects.locations.nodes.html b/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html index 870ff6ba7c..0cc1d6c3e9 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -599,17 +599,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v2alpha1.projects.locations.operations.html b/docs/dyn/tpu_v2alpha1.projects.locations.operations.html index d4daa7d7b2..9be96b9d6a 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.operations.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -217,17 +217,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2alpha1.projects.locations.queuedResources.html b/docs/dyn/tpu_v2alpha1.projects.locations.queuedResources.html index eb00ee4d05..5db40708e7 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.queuedResources.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.queuedResources.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists queued resources.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

performMaintenanceQueuedResource(name, body=None, x__xgafv=None)

@@ -791,17 +791,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/tpu_v2alpha1.projects.locations.reservations.html b/docs/dyn/tpu_v2alpha1.projects.locations.reservations.html index 8258eb5fdc..7fbd291aeb 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.reservations.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.reservations.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Retrieves the reservations for the given project in the given location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -129,17 +129,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/tpu_v2alpha1.projects.locations.runtimeVersions.html b/docs/dyn/tpu_v2alpha1.projects.locations.runtimeVersions.html index a1f06a9a80..ece229b040 100644 --- a/docs/dyn/tpu_v2alpha1.projects.locations.runtimeVersions.html +++ b/docs/dyn/tpu_v2alpha1.projects.locations.runtimeVersions.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists runtime versions supported by this API.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -145,17 +145,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/trafficdirector_v2.html b/docs/dyn/trafficdirector_v2.html index 9bdbce9e49..d2ed56347a 100644 --- a/docs/dyn/trafficdirector_v2.html +++ b/docs/dyn/trafficdirector_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/trafficdirector_v3.html b/docs/dyn/trafficdirector_v3.html index a227783ff3..b3f6b378f2 100644 --- a/docs/dyn/trafficdirector_v3.html +++ b/docs/dyn/trafficdirector_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/transcoder_v1.html b/docs/dyn/transcoder_v1.html index 41d930b483..0b852ab27f 100644 --- a/docs/dyn/transcoder_v1.html +++ b/docs/dyn/transcoder_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/transcoder_v1.projects.locations.jobTemplates.html b/docs/dyn/transcoder_v1.projects.locations.jobTemplates.html index 884c95fc5b..e51956d5c6 100644 --- a/docs/dyn/transcoder_v1.projects.locations.jobTemplates.html +++ b/docs/dyn/transcoder_v1.projects.locations.jobTemplates.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists job templates in the specified region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1427,17 +1427,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/transcoder_v1.projects.locations.jobs.html b/docs/dyn/transcoder_v1.projects.locations.jobs.html index 25dcb462be..2467eee402 100644 --- a/docs/dyn/transcoder_v1.projects.locations.jobs.html +++ b/docs/dyn/transcoder_v1.projects.locations.jobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs in the specified region.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1510,17 +1510,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v2.html b/docs/dyn/translate_v2.html index 7be1357884..8a7455fe17 100644 --- a/docs/dyn/translate_v2.html +++ b/docs/dyn/translate_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/translate_v3.html b/docs/dyn/translate_v3.html index c3210eda09..19a9b8063e 100644 --- a/docs/dyn/translate_v3.html +++ b/docs/dyn/translate_v3.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.adaptiveMtSentences.html b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.adaptiveMtSentences.html index b0d3a5fc7a..f04bce740c 100644 --- a/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.adaptiveMtSentences.html +++ b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.adaptiveMtSentences.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all AdaptiveMtSentences under a given file/dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.html b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.html index bbb439eade..ddf32c004d 100644 --- a/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.html +++ b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtFiles.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all AdaptiveMtFiles associated to an AdaptiveMtDataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtSentences.html b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtSentences.html index 0b786118c2..87c95eefe2 100644 --- a/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtSentences.html +++ b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.adaptiveMtSentences.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists all AdaptiveMtSentences under a given file/dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.adaptiveMtDatasets.html b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.html index af738387b6..53c051fc09 100644 --- a/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.html +++ b/docs/dyn/translate_v3.projects.locations.adaptiveMtDatasets.html @@ -103,7 +103,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all Adaptive MT datasets for which the caller has read permission.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -265,17 +265,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.datasets.examples.html b/docs/dyn/translate_v3.projects.locations.datasets.examples.html index 446b68b019..9ae9dfc282 100644 --- a/docs/dyn/translate_v3.projects.locations.datasets.examples.html +++ b/docs/dyn/translate_v3.projects.locations.datasets.examples.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists sentence pairs in the dataset.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.datasets.html b/docs/dyn/translate_v3.projects.locations.datasets.html index 2e0ced3067..327a21d405 100644 --- a/docs/dyn/translate_v3.projects.locations.datasets.html +++ b/docs/dyn/translate_v3.projects.locations.datasets.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists datasets.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -356,17 +356,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.glossaries.glossaryEntries.html b/docs/dyn/translate_v3.projects.locations.glossaries.glossaryEntries.html index d1dadbd5bb..b5535cb580 100644 --- a/docs/dyn/translate_v3.projects.locations.glossaries.glossaryEntries.html +++ b/docs/dyn/translate_v3.projects.locations.glossaries.glossaryEntries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List the entries for the glossary.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

@@ -267,17 +267,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/translate_v3.projects.locations.glossaries.html b/docs/dyn/translate_v3.projects.locations.glossaries.html index 8b21d03b42..7b6cfd7f6e 100644 --- a/docs/dyn/translate_v3.projects.locations.glossaries.html +++ b/docs/dyn/translate_v3.projects.locations.glossaries.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -284,17 +284,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/translate_v3.projects.locations.html b/docs/dyn/translate_v3.projects.locations.html index 2ebe4bf924..39d1eb446a 100644 --- a/docs/dyn/translate_v3.projects.locations.html +++ b/docs/dyn/translate_v3.projects.locations.html @@ -124,7 +124,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

refineText(parent, body=None, x__xgafv=None)

@@ -483,17 +483,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/translate_v3.projects.locations.models.html b/docs/dyn/translate_v3.projects.locations.models.html index 6a36550339..6a60ef0ae3 100644 --- a/docs/dyn/translate_v3.projects.locations.models.html +++ b/docs/dyn/translate_v3.projects.locations.models.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists models.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -249,17 +249,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3.projects.locations.operations.html b/docs/dyn/translate_v3.projects.locations.operations.html index 63f0ca2af5..49fa29787b 100644 --- a/docs/dyn/translate_v3.projects.locations.operations.html +++ b/docs/dyn/translate_v3.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/translate_v3beta1.html b/docs/dyn/translate_v3beta1.html index db249e76fa..43088b880f 100644 --- a/docs/dyn/translate_v3beta1.html +++ b/docs/dyn/translate_v3beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/translate_v3beta1.projects.locations.glossaries.html b/docs/dyn/translate_v3beta1.projects.locations.glossaries.html index bfbd5d3faf..d3ab9429c9 100644 --- a/docs/dyn/translate_v3beta1.projects.locations.glossaries.html +++ b/docs/dyn/translate_v3beta1.projects.locations.glossaries.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/translate_v3beta1.projects.locations.html b/docs/dyn/translate_v3beta1.projects.locations.html index 022e8054a6..c0fcae3d27 100644 --- a/docs/dyn/translate_v3beta1.projects.locations.html +++ b/docs/dyn/translate_v3beta1.projects.locations.html @@ -106,7 +106,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

refineText(parent, body=None, x__xgafv=None)

@@ -396,17 +396,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/translate_v3beta1.projects.locations.operations.html b/docs/dyn/translate_v3beta1.projects.locations.operations.html index 6b614a5d0d..ab0b75c2aa 100644 --- a/docs/dyn/translate_v3beta1.projects.locations.operations.html +++ b/docs/dyn/translate_v3beta1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

wait(name, body=None, x__xgafv=None)

@@ -226,17 +226,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/travelimpactmodel_v1.html b/docs/dyn/travelimpactmodel_v1.html index 19fa987e7c..64c4a456ff 100644 --- a/docs/dyn/travelimpactmodel_v1.html +++ b/docs/dyn/travelimpactmodel_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vault_v1.html b/docs/dyn/vault_v1.html index bb40c3ca10..262abcabde 100644 --- a/docs/dyn/vault_v1.html +++ b/docs/dyn/vault_v1.html @@ -88,7 +88,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -97,20 +97,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vault_v1.matters.exports.html b/docs/dyn/vault_v1.matters.exports.html index 9eb52e6081..260c11aef0 100644 --- a/docs/dyn/vault_v1.matters.exports.html +++ b/docs/dyn/vault_v1.matters.exports.html @@ -90,7 +90,7 @@

Instance Methods

list(matterId, pageSize=None, pageToken=None, x__xgafv=None)

Lists details about the exports in the specified matter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -718,17 +718,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vault_v1.matters.holds.html b/docs/dyn/vault_v1.matters.holds.html index 6b7b53859a..25a09a5069 100644 --- a/docs/dyn/vault_v1.matters.holds.html +++ b/docs/dyn/vault_v1.matters.holds.html @@ -98,7 +98,7 @@

Instance Methods

list(matterId, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists the holds in a matter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)

@@ -441,17 +441,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vault_v1.matters.html b/docs/dyn/vault_v1.matters.html index 0d5954f62a..50413df838 100644 --- a/docs/dyn/vault_v1.matters.html +++ b/docs/dyn/vault_v1.matters.html @@ -111,7 +111,7 @@

Instance Methods

list(pageSize=None, pageToken=None, state=None, view=None, x__xgafv=None)

Lists matters the requestor has access to.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

removePermissions(matterId, body=None, x__xgafv=None)

@@ -473,17 +473,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vault_v1.matters.savedQueries.html b/docs/dyn/vault_v1.matters.savedQueries.html index 53fa1a88f3..61270f828b 100644 --- a/docs/dyn/vault_v1.matters.savedQueries.html +++ b/docs/dyn/vault_v1.matters.savedQueries.html @@ -90,7 +90,7 @@

Instance Methods

list(matterId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the saved queries in a matter.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -526,17 +526,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vault_v1.operations.html b/docs/dyn/vault_v1.operations.html index 90084a11f6..25161d0ba4 100644 --- a/docs/dyn/vault_v1.operations.html +++ b/docs/dyn/vault_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/verifiedaccess_v1.html b/docs/dyn/verifiedaccess_v1.html index dd9b782db2..c8e19c0b93 100644 --- a/docs/dyn/verifiedaccess_v1.html +++ b/docs/dyn/verifiedaccess_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/verifiedaccess_v2.html b/docs/dyn/verifiedaccess_v2.html index 29fd974795..94464a2308 100644 --- a/docs/dyn/verifiedaccess_v2.html +++ b/docs/dyn/verifiedaccess_v2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/versionhistory_v1.html b/docs/dyn/versionhistory_v1.html index a1dc9286f5..c4637f78d3 100644 --- a/docs/dyn/versionhistory_v1.html +++ b/docs/dyn/versionhistory_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/versionhistory_v1.platforms.channels.html b/docs/dyn/versionhistory_v1.platforms.channels.html index 1d533f1f6f..cbb68a7f38 100644 --- a/docs/dyn/versionhistory_v1.platforms.channels.html +++ b/docs/dyn/versionhistory_v1.platforms.channels.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of channels that are available for a given platform.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -122,17 +122,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/versionhistory_v1.platforms.channels.versions.html b/docs/dyn/versionhistory_v1.platforms.channels.versions.html index fef06e6640..8d24ac98cf 100644 --- a/docs/dyn/versionhistory_v1.platforms.channels.versions.html +++ b/docs/dyn/versionhistory_v1.platforms.channels.versions.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of version for the given platform/channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -124,17 +124,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/versionhistory_v1.platforms.channels.versions.releases.html b/docs/dyn/versionhistory_v1.platforms.channels.versions.releases.html index 44178a069d..038ac803e3 100644 --- a/docs/dyn/versionhistory_v1.platforms.channels.versions.releases.html +++ b/docs/dyn/versionhistory_v1.platforms.channels.versions.releases.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of releases of the given version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -134,17 +134,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/versionhistory_v1.platforms.html b/docs/dyn/versionhistory_v1.platforms.html index 29c996aa6f..0c89d3a17b 100644 --- a/docs/dyn/versionhistory_v1.platforms.html +++ b/docs/dyn/versionhistory_v1.platforms.html @@ -86,7 +86,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns list of platforms that are available for a given product. The resource "product" has no resource name in its name.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -122,17 +122,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/videointelligence_v1.html b/docs/dyn/videointelligence_v1.html index db3423218e..69abe2bde2 100644 --- a/docs/dyn/videointelligence_v1.html +++ b/docs/dyn/videointelligence_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/videointelligence_v1.projects.locations.operations.html b/docs/dyn/videointelligence_v1.projects.locations.operations.html index 7f50f85399..b40d9b6497 100644 --- a/docs/dyn/videointelligence_v1.projects.locations.operations.html +++ b/docs/dyn/videointelligence_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/videointelligence_v1beta2.html b/docs/dyn/videointelligence_v1beta2.html index f5230a7a48..3ec2ab8c08 100644 --- a/docs/dyn/videointelligence_v1beta2.html +++ b/docs/dyn/videointelligence_v1beta2.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/videointelligence_v1p1beta1.html b/docs/dyn/videointelligence_v1p1beta1.html index 256625286c..9ab084dfb7 100644 --- a/docs/dyn/videointelligence_v1p1beta1.html +++ b/docs/dyn/videointelligence_v1p1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/videointelligence_v1p2beta1.html b/docs/dyn/videointelligence_v1p2beta1.html index 112a56888f..dd28f099c1 100644 --- a/docs/dyn/videointelligence_v1p2beta1.html +++ b/docs/dyn/videointelligence_v1p2beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/videointelligence_v1p3beta1.html b/docs/dyn/videointelligence_v1p3beta1.html index 99d590a137..f6d336b2ea 100644 --- a/docs/dyn/videointelligence_v1p3beta1.html +++ b/docs/dyn/videointelligence_v1p3beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vision_v1.html b/docs/dyn/vision_v1.html index 92f6cf9df7..c5ed60479b 100644 --- a/docs/dyn/vision_v1.html +++ b/docs/dyn/vision_v1.html @@ -103,7 +103,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -112,20 +112,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vision_v1.operations.html b/docs/dyn/vision_v1.operations.html index 2a2b2610f6..e6a0a63be1 100644 --- a/docs/dyn/vision_v1.operations.html +++ b/docs/dyn/vision_v1.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vision_v1.projects.locations.productSets.html b/docs/dyn/vision_v1.projects.locations.productSets.html index 6ad3fb7675..5ea61af26e 100644 --- a/docs/dyn/vision_v1.projects.locations.productSets.html +++ b/docs/dyn/vision_v1.projects.locations.productSets.html @@ -101,7 +101,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ProductSets in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100, or less than 1.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -321,17 +321,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vision_v1.projects.locations.productSets.products.html b/docs/dyn/vision_v1.projects.locations.productSets.products.html index eafe998dcc..e3404cf9e4 100644 --- a/docs/dyn/vision_v1.projects.locations.productSets.products.html +++ b/docs/dyn/vision_v1.projects.locations.productSets.products.html @@ -81,7 +81,7 @@

Instance Methods

list(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists the Products in a ProductSet, in an unspecified order. If the ProductSet does not exist, the products field of the response will be empty. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -125,17 +125,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vision_v1.projects.locations.products.html b/docs/dyn/vision_v1.projects.locations.products.html index 66899d74e5..6369fbc6a7 100644 --- a/docs/dyn/vision_v1.projects.locations.products.html +++ b/docs/dyn/vision_v1.projects.locations.products.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists products in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -236,17 +236,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vision_v1.projects.locations.products.referenceImages.html b/docs/dyn/vision_v1.projects.locations.products.referenceImages.html index cac754e78f..619f5692a3 100644 --- a/docs/dyn/vision_v1.projects.locations.products.referenceImages.html +++ b/docs/dyn/vision_v1.projects.locations.products.referenceImages.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists reference images. Possible errors: * Returns NOT_FOUND if the parent product does not exist. * Returns INVALID_ARGUMENT if the page_size is greater than 100, or less than 1.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -258,17 +258,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vision_v1p1beta1.html b/docs/dyn/vision_v1p1beta1.html index e9648c433d..6de31c7957 100644 --- a/docs/dyn/vision_v1p1beta1.html +++ b/docs/dyn/vision_v1p1beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vision_v1p2beta1.html b/docs/dyn/vision_v1p2beta1.html index 0908dc9442..da83f75b07 100644 --- a/docs/dyn/vision_v1p2beta1.html +++ b/docs/dyn/vision_v1p2beta1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vmmigration_v1.html b/docs/dyn/vmmigration_v1.html index 8b1a80cc98..2c75d4a469 100644 --- a/docs/dyn/vmmigration_v1.html +++ b/docs/dyn/vmmigration_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vmmigration_v1.projects.locations.groups.html b/docs/dyn/vmmigration_v1.projects.locations.groups.html index 7510139fcc..bb3886d578 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.groups.html +++ b/docs/dyn/vmmigration_v1.projects.locations.groups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Groups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1.projects.locations.html b/docs/dyn/vmmigration_v1.projects.locations.html index 16a0c302bb..93319be20c 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.html +++ b/docs/dyn/vmmigration_v1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.imageImports.html b/docs/dyn/vmmigration_v1.projects.locations.imageImports.html index a490916e81..d8b8932703 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.imageImports.html +++ b/docs/dyn/vmmigration_v1.projects.locations.imageImports.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ImageImports in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -936,17 +936,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.imageImports.imageImportJobs.html b/docs/dyn/vmmigration_v1.projects.locations.imageImports.imageImportJobs.html index 2efbf06477..2a2dc3fc0d 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.imageImports.imageImportJobs.html +++ b/docs/dyn/vmmigration_v1.projects.locations.imageImports.imageImportJobs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ImageImportJobs in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -463,17 +463,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.operations.html b/docs/dyn/vmmigration_v1.projects.locations.operations.html index 3a9fd5912a..f7a2681749 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.operations.html +++ b/docs/dyn/vmmigration_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.sources.datacenterConnectors.html b/docs/dyn/vmmigration_v1.projects.locations.sources.datacenterConnectors.html index 7d805d5f6d..4566bec577 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.datacenterConnectors.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.datacenterConnectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DatacenterConnectors in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

upgradeAppliance(datacenterConnector, body=None, x__xgafv=None)

@@ -376,17 +376,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1.projects.locations.sources.diskMigrationJobs.html b/docs/dyn/vmmigration_v1.projects.locations.sources.diskMigrationJobs.html index 1d717a856a..47b4d51cfe 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.diskMigrationJobs.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.diskMigrationJobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DiskMigrationJobs in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -431,17 +431,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1.projects.locations.sources.html b/docs/dyn/vmmigration_v1.projects.locations.sources.html index 0a7d856e20..3c356933f9 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.html @@ -107,13 +107,13 @@

Instance Methods

fetchInventory(source, forceRefresh=None, pageSize=None, pageToken=None, x__xgafv=None)

List remote source's inventory of VMs. The remote source is the onprem vCenter (remote in the sense it's not in Compute Engine). The inventory describes the list of existing VMs in that source. Note that this operation lists the VMs on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

- fetchInventory_next(previous_request, previous_response)

+ fetchInventory_next()

Retrieves the next page of results.

fetchStorageInventory(source, forceRefresh=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

List remote source's inventory of storage resources. The remote source is another cloud vendor (e.g. AWS, Azure). The inventory describes the list of existing storage resources in that source. Note that this operation lists the resources on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

- fetchStorageInventory_next(previous_request, previous_response)

+ fetchStorageInventory_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Sources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -395,17 +395,17 @@

Method Details

- fetchInventory_next(previous_request, previous_response) + fetchInventory_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)
+        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.
-
+ 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. +
@@ -449,17 +449,17 @@

Method Details

- fetchStorageInventory_next(previous_request, previous_response) + fetchStorageInventory_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)
+        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.
-
+ 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. +
@@ -653,17 +653,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cloneJobs.html b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cloneJobs.html index 5e0ac9257f..1dbb1fc471 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cloneJobs.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cloneJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the CloneJobs of a migrating VM. Only 25 most recent CloneJobs are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -552,17 +552,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.sources.migratingVms.cutoverJobs.html b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cutoverJobs.html index 42fb1447c2..c882b547ca 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cutoverJobs.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.cutoverJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the CutoverJobs of a migrating VM. Only 25 most recent CutoverJobs are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -882,17 +882,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.sources.migratingVms.html b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html index 439e5e9221..472b1f86e7 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists MigratingVms in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -2435,17 +2435,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.replicationCycles.html b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.replicationCycles.html index b5cd7e41c7..ae83c66fef 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.replicationCycles.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.replicationCycles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReplicationCycles in a given MigratingVM.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -245,17 +245,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.sources.utilizationReports.html b/docs/dyn/vmmigration_v1.projects.locations.sources.utilizationReports.html index 64b3aa0b3d..b0e28dc2a6 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.sources.utilizationReports.html +++ b/docs/dyn/vmmigration_v1.projects.locations.sources.utilizationReports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Utilization Reports of the given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -377,17 +377,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1.projects.locations.targetProjects.html b/docs/dyn/vmmigration_v1.projects.locations.targetProjects.html index a715859618..e9da284268 100644 --- a/docs/dyn/vmmigration_v1.projects.locations.targetProjects.html +++ b/docs/dyn/vmmigration_v1.projects.locations.targetProjects.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TargetProjects in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.html b/docs/dyn/vmmigration_v1alpha1.html index a13bd2a1fc..6912584ccf 100644 --- a/docs/dyn/vmmigration_v1alpha1.html +++ b/docs/dyn/vmmigration_v1alpha1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.groups.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.groups.html index 15bb69a75a..c05429c2d7 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.groups.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.groups.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Groups in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -295,17 +295,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.html index 96144af1d4..2968d1aec8 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.html @@ -109,7 +109,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -181,17 +181,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.imageImports.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.html index 047c5880d0..eaf7182eb7 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ImageImports in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -936,17 +936,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.imageImports.imageImportJobs.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.imageImportJobs.html index 2b9aa7f35f..cfb357556c 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.imageImportJobs.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.imageImports.imageImportJobs.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ImageImportJobs in a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -463,17 +463,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.operations.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.operations.html index 1186e6db41..2104cf8b3d 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.operations.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.sources.datacenterConnectors.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.datacenterConnectors.html index da15aff443..314eec3647 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.datacenterConnectors.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.datacenterConnectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DatacenterConnectors in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

upgradeAppliance(datacenterConnector, body=None, x__xgafv=None)

@@ -376,17 +376,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.diskMigrationJobs.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.diskMigrationJobs.html index b1128cfd43..bd44502f36 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.diskMigrationJobs.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.diskMigrationJobs.html @@ -93,7 +93,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists DiskMigrationJobs in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -431,17 +431,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.html index 2985ab51c8..44e5fd4ab3 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.html @@ -107,13 +107,13 @@

Instance Methods

fetchInventory(source, forceRefresh=None, pageSize=None, pageToken=None, x__xgafv=None)

List remote source's inventory of VMs. The remote source is the onprem vCenter (remote in the sense it's not in Compute Engine). The inventory describes the list of existing VMs in that source. Note that this operation lists the VMs on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

- fetchInventory_next(previous_request, previous_response)

+ fetchInventory_next()

Retrieves the next page of results.

fetchStorageInventory(source, forceRefresh=None, pageSize=None, pageToken=None, type=None, x__xgafv=None)

List remote source's inventory of storage resources. The remote source is another cloud vendor (e.g. AWS, Azure). The inventory describes the list of existing storage resources in that source. Note that this operation lists the resources on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

- fetchStorageInventory_next(previous_request, previous_response)

+ fetchStorageInventory_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -122,7 +122,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Sources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -405,17 +405,17 @@

Method Details

- fetchInventory_next(previous_request, previous_response) + fetchInventory_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)
+        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.
-
+ 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. +
@@ -459,17 +459,17 @@

Method Details

- fetchStorageInventory_next(previous_request, previous_response) + fetchStorageInventory_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)
+        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.
-
+ 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. +
@@ -681,17 +681,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cloneJobs.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cloneJobs.html index 1c4025478d..86b170e68c 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cloneJobs.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cloneJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the CloneJobs of a migrating VM. Only 25 most recent CloneJobs are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -879,17 +879,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cutoverJobs.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cutoverJobs.html index ec11d657d9..b66b8b6c92 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cutoverJobs.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.cutoverJobs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the CutoverJobs of a migrating VM. Only 25 most recent CutoverJobs are listed.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -1218,17 +1218,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html index d64dbc0bbb..0fbe9f8f5b 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html @@ -111,7 +111,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists MigratingVms in a given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -3434,17 +3434,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.replicationCycles.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.replicationCycles.html index d2f5bf3bc7..64c9fa373a 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.replicationCycles.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.replicationCycles.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists ReplicationCycles in a given MigratingVM.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -247,17 +247,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.sources.utilizationReports.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.utilizationReports.html index d208a5e344..d6d0675502 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.utilizationReports.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.utilizationReports.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Lists Utilization Reports of the given Source.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -407,17 +407,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmmigration_v1alpha1.projects.locations.targetProjects.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.targetProjects.html index e5d973c4be..b2bff12791 100644 --- a/docs/dyn/vmmigration_v1alpha1.projects.locations.targetProjects.html +++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.targetProjects.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists TargetProjects in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -244,17 +244,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.html b/docs/dyn/vmwareengine_v1.html index 2a4f08a73e..3fa2ac8b51 100644 --- a/docs/dyn/vmwareengine_v1.html +++ b/docs/dyn/vmwareengine_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vmwareengine_v1.projects.locations.announcements.html b/docs/dyn/vmwareengine_v1.projects.locations.announcements.html index 0ddb255ab4..26b0f3758a 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.announcements.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.announcements.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `Announcements` for a given region and project

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -167,17 +167,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.datastores.html b/docs/dyn/vmwareengine_v1.projects.locations.datastores.html index 7a6a8a72d7..3ff65bb929 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.datastores.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.datastores.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, requestId=None, x__xgafv=None)

Lists `Datastore` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -306,17 +306,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.html b/docs/dyn/vmwareengine_v1.projects.locations.html index 4051cb49cf..3670367113 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.html @@ -137,7 +137,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -234,17 +234,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.networkPeerings.html b/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.html index 3adbd708bd..4804168250 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `NetworkPeering` resources in a given project. NetworkPeering is a global resource and location can only be global.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -283,17 +283,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.peeringRoutes.html b/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.peeringRoutes.html index 98dfadf8ce..dfc88f421c 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.peeringRoutes.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.networkPeerings.peeringRoutes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the network peering routes exchanged over a peering connection. NetworkPeering is a global resource and location can only be global.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -122,17 +122,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.networkPolicies.externalAccessRules.html b/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.externalAccessRules.html index 334616fa23..0c09eaab3a 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.externalAccessRules.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.externalAccessRules.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `ExternalAccessRule` resources in the specified network policy.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -317,17 +317,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.html b/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.html index 776e0d034f..372f25a1d8 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.networkPolicies.html @@ -92,7 +92,7 @@

Instance Methods

fetchExternalAddresses(networkPolicy, pageSize=None, pageToken=None, x__xgafv=None)

Lists external IP addresses assigned to VMware workload VMs within the scope of the given network policy.

- fetchExternalAddresses_next(previous_request, previous_response)

+ fetchExternalAddresses_next()

Retrieves the next page of results.

get(name, x__xgafv=None)

@@ -101,7 +101,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `NetworkPolicy` resources in a specified project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -242,17 +242,17 @@

Method Details

- fetchExternalAddresses_next(previous_request, previous_response) + fetchExternalAddresses_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)
+        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.
-
+ 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. +
@@ -336,17 +336,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.nodeTypes.html b/docs/dyn/vmwareengine_v1.projects.locations.nodeTypes.html index ec06bfa4b7..0b52538939 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.nodeTypes.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.nodeTypes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists node types

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -174,17 +174,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.operations.html b/docs/dyn/vmwareengine_v1.projects.locations.operations.html index 0b10816b28..90d61c3f4d 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.operations.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.privateClouds.clusters.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.html index fe719b3e03..83b14e152c 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.html @@ -98,7 +98,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `Cluster` resources in a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

mountDatastore(name, body=None, x__xgafv=None)

@@ -478,17 +478,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.nodes.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.nodes.html index 751f64ffe7..94e801aaa6 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.nodes.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.clusters.nodes.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists nodes in a given cluster.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.privateClouds.externalAddresses.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.externalAddresses.html index ecb12cddf6..17e1755adc 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.externalAddresses.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.externalAddresses.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists external IP addresses assigned to VMware workload VMs in a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -254,17 +254,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.hcxActivationKeys.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.hcxActivationKeys.html index 1aa21dde75..5ec68f3e87 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.hcxActivationKeys.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.hcxActivationKeys.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists `HcxActivationKey` resources in a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -257,17 +257,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.html index 450d23bdfa..d88279fae5 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.html @@ -131,7 +131,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `PrivateCloud` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

migrateManagementVms(name, body=None, x__xgafv=None)

@@ -533,17 +533,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.loggingServers.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.loggingServers.html index 15e31f29b3..fb2e576b17 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.loggingServers.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.loggingServers.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists logging servers configured for a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.managementDnsZoneBindings.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.managementDnsZoneBindings.html index 3196983b99..4a386f0f6c 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.managementDnsZoneBindings.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.managementDnsZoneBindings.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Consumer VPCs bound to Management DNS Zone of a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -256,17 +256,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.subnets.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.subnets.html index 9963e668d8..9e8990484e 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.subnets.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.subnets.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists subnets in a given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -154,17 +154,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.upgrades.html b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.upgrades.html index ac8f74b85b..06364bf5a8 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.upgrades.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateClouds.upgrades.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists past, ongoing and upcoming `Upgrades` for the given private cloud.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.html b/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.html index f3f6b7dc3e..d9c9d2dd0b 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `PrivateConnection` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -274,17 +274,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.peeringRoutes.html b/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.peeringRoutes.html index c9e8f3dec1..ab4be97a82 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.peeringRoutes.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.privateConnections.peeringRoutes.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists the private connection routes exchanged over a peering connection.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vmwareengine_v1.projects.locations.vmwareEngineNetworks.html b/docs/dyn/vmwareengine_v1.projects.locations.vmwareEngineNetworks.html index 4b970ba075..b91589f09d 100644 --- a/docs/dyn/vmwareengine_v1.projects.locations.vmwareEngineNetworks.html +++ b/docs/dyn/vmwareengine_v1.projects.locations.vmwareEngineNetworks.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists `VmwareEngineNetwork` resources in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -273,17 +273,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vpcaccess_v1.html b/docs/dyn/vpcaccess_v1.html index cfdcb3e77b..fdc5444aba 100644 --- a/docs/dyn/vpcaccess_v1.html +++ b/docs/dyn/vpcaccess_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vpcaccess_v1.projects.locations.connectors.html b/docs/dyn/vpcaccess_v1.projects.locations.connectors.html index 79eed9cb6f..108af6632e 100644 --- a/docs/dyn/vpcaccess_v1.projects.locations.connectors.html +++ b/docs/dyn/vpcaccess_v1.projects.locations.connectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Serverless VPC Access connectors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -270,17 +270,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vpcaccess_v1.projects.locations.html b/docs/dyn/vpcaccess_v1.projects.locations.html index f0d41b9617..1c9a8a911e 100644 --- a/docs/dyn/vpcaccess_v1.projects.locations.html +++ b/docs/dyn/vpcaccess_v1.projects.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vpcaccess_v1.projects.locations.operations.html b/docs/dyn/vpcaccess_v1.projects.locations.operations.html index 30d5497b43..74f97b2f35 100644 --- a/docs/dyn/vpcaccess_v1.projects.locations.operations.html +++ b/docs/dyn/vpcaccess_v1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vpcaccess_v1beta1.html b/docs/dyn/vpcaccess_v1beta1.html index 5c7b9ada42..de99891a61 100644 --- a/docs/dyn/vpcaccess_v1beta1.html +++ b/docs/dyn/vpcaccess_v1beta1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/vpcaccess_v1beta1.projects.locations.connectors.html b/docs/dyn/vpcaccess_v1beta1.projects.locations.connectors.html index 7c8c9ee03c..d5dedfb636 100644 --- a/docs/dyn/vpcaccess_v1beta1.projects.locations.connectors.html +++ b/docs/dyn/vpcaccess_v1beta1.projects.locations.connectors.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists Serverless VPC Access connectors.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -276,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/vpcaccess_v1beta1.projects.locations.html b/docs/dyn/vpcaccess_v1beta1.projects.locations.html index bb9e2f028b..600bf8b858 100644 --- a/docs/dyn/vpcaccess_v1beta1.projects.locations.html +++ b/docs/dyn/vpcaccess_v1beta1.projects.locations.html @@ -91,7 +91,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -136,17 +136,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/vpcaccess_v1beta1.projects.locations.operations.html b/docs/dyn/vpcaccess_v1beta1.projects.locations.operations.html index aded8d7eb9..66658508c9 100644 --- a/docs/dyn/vpcaccess_v1beta1.projects.locations.operations.html +++ b/docs/dyn/vpcaccess_v1beta1.projects.locations.operations.html @@ -84,7 +84,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -175,17 +175,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/walletobjects_v1.html b/docs/dyn/walletobjects_v1.html index cae39baa15..7727edf93d 100644 --- a/docs/dyn/walletobjects_v1.html +++ b/docs/dyn/walletobjects_v1.html @@ -178,7 +178,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -187,20 +187,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/webcontentpublisher_v1.html b/docs/dyn/webcontentpublisher_v1.html index 3a78ac49c7..1277495c88 100644 --- a/docs/dyn/webcontentpublisher_v1.html +++ b/docs/dyn/webcontentpublisher_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html b/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html index 422e7a2dfa..a0b0334dd3 100644 --- a/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html +++ b/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html @@ -87,7 +87,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists CTAs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -211,17 +211,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/webcontentpublisher_v1.organizations.publications.html b/docs/dyn/webcontentpublisher_v1.organizations.publications.html index 3a43416164..84a4798ed5 100644 --- a/docs/dyn/webcontentpublisher_v1.organizations.publications.html +++ b/docs/dyn/webcontentpublisher_v1.organizations.publications.html @@ -92,7 +92,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists publications.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -271,7 +271,7 @@

Method Details

Lists publications.
 
 Args:
-  parent: string, Required. The parent organization whose publications to list. Format: `organizations/{organization}`. (required)
+  parent: string, Required. The parent organization whose publications to list, or "organizations/-" for all organizations a user has access to. Format: `organizations/{organization}`. (required)
   filter: string, Optional. A filter expression to filter the publications returned.
   pageSize: integer, Optional. The maximum number of publications to return. The service may return fewer than this value. If unspecified, at most 50 publications will be returned.
   pageToken: string, Optional. A page token, received from a previous `ListPublications` call, to retrieve the next page.
@@ -333,17 +333,17 @@ 
Method Details
- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/webfonts_v1.html b/docs/dyn/webfonts_v1.html index 340832baff..931aca76f2 100644 --- a/docs/dyn/webfonts_v1.html +++ b/docs/dyn/webfonts_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/webrisk_v1.html b/docs/dyn/webrisk_v1.html index 35b1e0771d..8736025cea 100644 --- a/docs/dyn/webrisk_v1.html +++ b/docs/dyn/webrisk_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/webrisk_v1.projects.operations.html b/docs/dyn/webrisk_v1.projects.operations.html index eb8fee7679..db92b3680c 100644 --- a/docs/dyn/webrisk_v1.projects.operations.html +++ b/docs/dyn/webrisk_v1.projects.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1.html b/docs/dyn/websecurityscanner_v1.html index 2231e2b8cb..22683b56c5 100644 --- a/docs/dyn/websecurityscanner_v1.html +++ b/docs/dyn/websecurityscanner_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.html b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.html index a02fcd3939..c20dd9dc79 100644 --- a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.html +++ b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanConfigs under a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -443,17 +443,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.crawledUrls.html b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.crawledUrls.html index 4700e735fc..8fa4e766b6 100644 --- a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.crawledUrls.html +++ b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.crawledUrls.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List CrawledUrls under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -118,17 +118,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1.projects.scanConfigs.scanRuns.findings.html b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.findings.html index 03bd23305c..5581f03282 100644 --- a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.findings.html +++ b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.findings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Findings under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -255,17 +255,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1.projects.scanConfigs.scanRuns.html b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.html index 413e1b6b0d..d032507fe9 100644 --- a/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.html +++ b/docs/dyn/websecurityscanner_v1.projects.scanConfigs.scanRuns.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanRuns under a given ScanConfig, in descending order of ScanRun stop time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stop(name, body=None, x__xgafv=None)

@@ -198,17 +198,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/websecurityscanner_v1alpha.html b/docs/dyn/websecurityscanner_v1alpha.html index 0a0bba65f9..41906b0218 100644 --- a/docs/dyn/websecurityscanner_v1alpha.html +++ b/docs/dyn/websecurityscanner_v1alpha.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.html b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.html index 8f2835d749..99420b7b13 100644 --- a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.html +++ b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanConfigs under a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -351,17 +351,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.crawledUrls.html b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.crawledUrls.html index fc2fdca27d..704b2eccb3 100644 --- a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.crawledUrls.html +++ b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.crawledUrls.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List CrawledUrls under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -118,17 +118,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.findings.html b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.findings.html index 19e4d1d176..a41b5193c3 100644 --- a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.findings.html +++ b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.findings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Findings under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -229,17 +229,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.html b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.html index 74341bf6e7..efbd4552ce 100644 --- a/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.html +++ b/docs/dyn/websecurityscanner_v1alpha.projects.scanConfigs.scanRuns.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanRuns under a given ScanConfig, in descending order of ScanRun stop time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stop(name, body=None, x__xgafv=None)

@@ -172,17 +172,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/websecurityscanner_v1beta.html b/docs/dyn/websecurityscanner_v1beta.html index 556c35611d..dac8be4ded 100644 --- a/docs/dyn/websecurityscanner_v1beta.html +++ b/docs/dyn/websecurityscanner_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.html b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.html index 6b4c962f3d..5164387141 100644 --- a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.html +++ b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanConfigs under a given project.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -443,17 +443,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.crawledUrls.html b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.crawledUrls.html index 50f7f5fbfa..67a3784e9c 100644 --- a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.crawledUrls.html +++ b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.crawledUrls.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

List CrawledUrls under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -118,17 +118,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.findings.html b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.findings.html index eac57bc59c..a709b7e5d0 100644 --- a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.findings.html +++ b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.findings.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Findings under a given ScanRun.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -251,17 +251,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.html b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.html index 02386d43bc..70f435e8f6 100644 --- a/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.html +++ b/docs/dyn/websecurityscanner_v1beta.projects.scanConfigs.scanRuns.html @@ -99,7 +99,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists ScanRuns under a given ScanConfig, in descending order of ScanRun stop time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

stop(name, body=None, x__xgafv=None)

@@ -198,17 +198,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workflowexecutions_v1.html b/docs/dyn/workflowexecutions_v1.html index e0acd7464f..3344cf96b6 100644 --- a/docs/dyn/workflowexecutions_v1.html +++ b/docs/dyn/workflowexecutions_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.callbacks.html b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.callbacks.html index 56d42965d5..e3693b15d1 100644 --- a/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.callbacks.html +++ b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.callbacks.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns a list of active callbacks that belong to the execution with the given name. The returned callbacks are ordered by callback ID.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -121,17 +121,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflowexecutions_v1.projects.locations.workflows.executions.html b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.html index da4b59ec9a..3f0cb9a1f2 100644 --- a/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.html +++ b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.html @@ -106,7 +106,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Returns a list of executions which belong to the workflow with the given name. The method returns executions of all workflow revisions. Returned executions are ordered by their start time (newest first).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -481,17 +481,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflowexecutions_v1.projects.locations.workflows.executions.stepEntries.html b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.stepEntries.html index 6f5916d1af..c9173d7056 100644 --- a/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.stepEntries.html +++ b/docs/dyn/workflowexecutions_v1.projects.locations.workflows.executions.stepEntries.html @@ -84,7 +84,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, skip=None, view=None, x__xgafv=None)

Lists step entries for the corresponding workflow execution. Returned entries are ordered by their create_time.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -210,17 +210,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflowexecutions_v1beta.html b/docs/dyn/workflowexecutions_v1beta.html index e14f6075ef..d516034dd2 100644 --- a/docs/dyn/workflowexecutions_v1beta.html +++ b/docs/dyn/workflowexecutions_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workflowexecutions_v1beta.projects.locations.workflows.executions.html b/docs/dyn/workflowexecutions_v1beta.projects.locations.workflows.executions.html index 754981b756..24fe24bd64 100644 --- a/docs/dyn/workflowexecutions_v1beta.projects.locations.workflows.executions.html +++ b/docs/dyn/workflowexecutions_v1beta.projects.locations.workflows.executions.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Returns a list of executions which belong to the workflow with the given name. The method returns executions of all workflow revisions. Returned executions are ordered by their start time (newest first).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -365,17 +365,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflows_v1.html b/docs/dyn/workflows_v1.html index 03235c8e42..b289461c68 100644 --- a/docs/dyn/workflows_v1.html +++ b/docs/dyn/workflows_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workflows_v1.projects.locations.html b/docs/dyn/workflows_v1.projects.locations.html index d98ec1e7af..5b330c21cc 100644 --- a/docs/dyn/workflows_v1.projects.locations.html +++ b/docs/dyn/workflows_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflows_v1.projects.locations.operations.html b/docs/dyn/workflows_v1.projects.locations.operations.html index 6363e0cea2..484ad15ea5 100644 --- a/docs/dyn/workflows_v1.projects.locations.operations.html +++ b/docs/dyn/workflows_v1.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflows_v1.projects.locations.workflows.html b/docs/dyn/workflows_v1.projects.locations.workflows.html index 751b8a7f30..91b509cee6 100644 --- a/docs/dyn/workflows_v1.projects.locations.workflows.html +++ b/docs/dyn/workflows_v1.projects.locations.workflows.html @@ -93,10 +93,10 @@

Instance Methods

listRevisions(name, pageSize=None, pageToken=None, x__xgafv=None)

Lists revisions for a given workflow.

- listRevisions_next(previous_request, previous_response)

+ listRevisions_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -387,31 +387,31 @@

Method Details

- listRevisions_next(previous_request, previous_response) + listRevisions_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workflows_v1beta.html b/docs/dyn/workflows_v1beta.html index bf97d3ea59..95aaa70d24 100644 --- a/docs/dyn/workflows_v1beta.html +++ b/docs/dyn/workflows_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workflows_v1beta.projects.locations.html b/docs/dyn/workflows_v1beta.projects.locations.html index 6dde4ff5a2..df6cf4f821 100644 --- a/docs/dyn/workflows_v1beta.projects.locations.html +++ b/docs/dyn/workflows_v1beta.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflows_v1beta.projects.locations.operations.html b/docs/dyn/workflows_v1beta.projects.locations.operations.html index 9f24ef97d4..853a0b6281 100644 --- a/docs/dyn/workflows_v1beta.projects.locations.operations.html +++ b/docs/dyn/workflows_v1beta.projects.locations.operations.html @@ -87,7 +87,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -196,17 +196,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workflows_v1beta.projects.locations.workflows.html b/docs/dyn/workflows_v1beta.projects.locations.workflows.html index f43eef090f..04e53f822a 100644 --- a/docs/dyn/workflows_v1beta.projects.locations.workflows.html +++ b/docs/dyn/workflows_v1beta.projects.locations.workflows.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Workflows in a given project and location. The default order is not specified.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

@@ -263,17 +263,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workloadmanager_v1.html b/docs/dyn/workloadmanager_v1.html index 9502bb4a09..a2daed99c9 100644 --- a/docs/dyn/workloadmanager_v1.html +++ b/docs/dyn/workloadmanager_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workloadmanager_v1.projects.locations.deployments.actuations.html b/docs/dyn/workloadmanager_v1.projects.locations.deployments.actuations.html index a206d74761..6bafc89a22 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.deployments.actuations.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.deployments.actuations.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Actuations in a given project, location and deployment.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -296,17 +296,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.deployments.html b/docs/dyn/workloadmanager_v1.projects.locations.deployments.html index 43421d0ce3..2ac0882c2b 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.deployments.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.deployments.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Deployments in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -609,17 +609,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.discoveredprofiles.html b/docs/dyn/workloadmanager_v1.projects.locations.discoveredprofiles.html index e4531e5eaf..a11cd5a971 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.discoveredprofiles.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.discoveredprofiles.html @@ -89,7 +89,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List discovered workload profiles

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -469,17 +469,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.evaluations.executions.html b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.html index c02edbf413..19fc5079a2 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.html @@ -97,7 +97,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Executions in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

run(name, body=None, x__xgafv=None)

@@ -269,17 +269,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.results.html b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.results.html index a26882e9ff..4d8d3d5fd2 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.results.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.results.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the result of a single evaluation.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -156,17 +156,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.evaluations.executions.scannedResources.html b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.scannedResources.html index e6ca24a7bc..1d0f1d0cc8 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.scannedResources.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.executions.scannedResources.html @@ -81,7 +81,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, rule=None, x__xgafv=None)

List all scanned resources for a single Execution.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.evaluations.html b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.html index ee8d1709ed..a667db4b99 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.evaluations.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.evaluations.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Evaluations in a given project and location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)

@@ -346,17 +346,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workloadmanager_v1.projects.locations.html b/docs/dyn/workloadmanager_v1.projects.locations.html index f196b89cae..0de096d2d4 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.html @@ -114,7 +114,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -186,17 +186,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workloadmanager_v1.projects.locations.operations.html b/docs/dyn/workloadmanager_v1.projects.locations.operations.html index 1dea8f4b90..2ee3ef740b 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.operations.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workspaceevents_v1.html b/docs/dyn/workspaceevents_v1.html index 6ae45d53fe..8facb804ee 100644 --- a/docs/dyn/workspaceevents_v1.html +++ b/docs/dyn/workspaceevents_v1.html @@ -98,7 +98,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -107,20 +107,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workspaceevents_v1.subscriptions.html b/docs/dyn/workspaceevents_v1.subscriptions.html index a44851c872..4ffb8ccefc 100644 --- a/docs/dyn/workspaceevents_v1.subscriptions.html +++ b/docs/dyn/workspaceevents_v1.subscriptions.html @@ -90,7 +90,7 @@

Instance Methods

list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Google Workspace subscriptions. To learn how to use this method, see [List Google Workspace subscriptions](https://developers.google.com/workspace/events/guides/list-subscriptions).

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -308,17 +308,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workspaceevents_v1.tasks.pushNotificationConfigs.html b/docs/dyn/workspaceevents_v1.tasks.pushNotificationConfigs.html index 16818e205c..1dbbb8410c 100644 --- a/docs/dyn/workspaceevents_v1.tasks.pushNotificationConfigs.html +++ b/docs/dyn/workspaceevents_v1.tasks.pushNotificationConfigs.html @@ -90,7 +90,7 @@

Instance Methods

list(parent, pageSize=None, pageToken=None, tenant=None, x__xgafv=None)

Get a list of push notifications configured for a task.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -237,17 +237,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workstations_v1.html b/docs/dyn/workstations_v1.html index ee0eae6dac..94e68e30cb 100644 --- a/docs/dyn/workstations_v1.html +++ b/docs/dyn/workstations_v1.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workstations_v1.projects.locations.html b/docs/dyn/workstations_v1.projects.locations.html index 7a40a17ecd..74f02f1c8b 100644 --- a/docs/dyn/workstations_v1.projects.locations.html +++ b/docs/dyn/workstations_v1.projects.locations.html @@ -94,7 +94,7 @@

Instance Methods

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -166,17 +166,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workstations_v1.projects.locations.operations.html b/docs/dyn/workstations_v1.projects.locations.operations.html index 78dc021a5b..06ea7459cd 100644 --- a/docs/dyn/workstations_v1.projects.locations.operations.html +++ b/docs/dyn/workstations_v1.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workstations_v1.projects.locations.workstationClusters.html b/docs/dyn/workstations_v1.projects.locations.workstationClusters.html index 8b33a37a26..14ba3506d8 100644 --- a/docs/dyn/workstations_v1.projects.locations.workstationClusters.html +++ b/docs/dyn/workstations_v1.projects.locations.workstationClusters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstation clusters in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -379,17 +379,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html index 66bcbfffc2..7aba3141a3 100644 --- a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html +++ b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html @@ -101,10 +101,10 @@

Instance Methods

listUsable(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -934,31 +934,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.workstations.html b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.workstations.html index a0dbe87664..51db280fe7 100644 --- a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.workstations.html +++ b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.workstations.html @@ -99,10 +99,10 @@

Instance Methods

listUsable(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -501,31 +501,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workstations_v1beta.html b/docs/dyn/workstations_v1beta.html index 5de3acbbcd..24bb754ecd 100644 --- a/docs/dyn/workstations_v1beta.html +++ b/docs/dyn/workstations_v1beta.html @@ -83,7 +83,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -92,20 +92,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/workstations_v1beta.projects.locations.operations.html b/docs/dyn/workstations_v1beta.projects.locations.operations.html index 53d25c14fb..981e3264ca 100644 --- a/docs/dyn/workstations_v1beta.projects.locations.operations.html +++ b/docs/dyn/workstations_v1beta.projects.locations.operations.html @@ -90,7 +90,7 @@

Instance Methods

list(name, filter=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -223,17 +223,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/workstations_v1beta.projects.locations.workstationClusters.html b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.html index 8ca1561d53..be54fe5567 100644 --- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.html +++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.html @@ -95,7 +95,7 @@

Instance Methods

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstation clusters in the specified location.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -388,17 +388,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html index 1f9e8942cc..c72f84fe19 100644 --- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html +++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html @@ -101,10 +101,10 @@

Instance Methods

listUsable(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -1026,31 +1026,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html index ad092d284f..7a08402f5b 100644 --- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html +++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html @@ -99,10 +99,10 @@

Instance Methods

listUsable(parent, pageSize=None, pageToken=None, x__xgafv=None)

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

- listUsable_next(previous_request, previous_response)

+ listUsable_next()

Retrieves the next page of results.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

@@ -584,31 +584,31 @@

Method Details

- listUsable_next(previous_request, previous_response) + listUsable_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)
+        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.
-
+ 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(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtubeAnalytics_v2.groups.html b/docs/dyn/youtubeAnalytics_v2.groups.html index c2ef730953..0a2cf2f1b1 100644 --- a/docs/dyn/youtubeAnalytics_v2.groups.html +++ b/docs/dyn/youtubeAnalytics_v2.groups.html @@ -87,7 +87,7 @@

Instance Methods

list(id=None, mine=None, onBehalfOfContentOwner=None, pageToken=None, x__xgafv=None)

Returns a collection of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(body=None, onBehalfOfContentOwner=None, x__xgafv=None)

@@ -288,17 +288,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtubeAnalytics_v2.html b/docs/dyn/youtubeAnalytics_v2.html index ce82e9f603..38ac230686 100644 --- a/docs/dyn/youtubeAnalytics_v2.html +++ b/docs/dyn/youtubeAnalytics_v2.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/youtube_v3.activities.html b/docs/dyn/youtube_v3.activities.html index 1056e1c261..41537ce1a7 100644 --- a/docs/dyn/youtube_v3.activities.html +++ b/docs/dyn/youtube_v3.activities.html @@ -81,7 +81,7 @@

Instance Methods

list(part, channelId=None, home=None, maxResults=None, mine=None, pageToken=None, publishedAfter=None, publishedBefore=None, regionCode=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -141,22 +141,6 @@

Method Details

"videoId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video. }, }, - "favorite": { # Information about a video that was marked as a favorite video. Deprecated: This resource is no longer returned. # The `favorite` object contains information about a video that was marked as a favorite video. This property is only present if the `snippet.type` is `favorite`. Deprecated: This property is no longer returned. - "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The `resourceId` object contains information that identifies the resource that was marked as a favorite. - "channelId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel. - "kind": "A String", # The type of the API resource. - "playlistId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist. - "videoId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video. - }, - }, - "like": { # Information about a resource that received a positive (like) rating. Deprecated: This resource is no longer returned. # The `like` object contains information about a resource that received a positive (like) rating. This property is only present if the `snippet.type` is `like`. Deprecated: This property is no longer returned. - "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The `resourceId` object contains information that identifies the rated resource. - "channelId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel. - "kind": "A String", # The type of the API resource. - "playlistId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist. - "videoId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video. - }, - }, "playlistItem": { # Information about a new playlist item. # The `playlistItem` object contains information about a new playlist item. This property is only present if the `snippet.type` is `playlistItem`. "playlistId": "A String", # The value that YouTube uses to uniquely identify the playlist. "playlistItemId": "A String", # ID of the item within the playlist. @@ -210,7 +194,7 @@

Method Details

}, "type": "A String", # The name of the social network. }, - "subscription": { # Information about a channel that a user subscribed to. Deprecated: This resource is no longer returned. # The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`. Deprecated: This property is no longer returned. + "subscription": { # Information about a channel that a user subscribed to. # The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`. "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The `resourceId` object contains information that identifies the resource that the user subscribed to. "channelId": "A String", # The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel. "kind": "A String", # The type of the API resource. @@ -292,17 +276,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.channels.html b/docs/dyn/youtube_v3.channels.html index ae30f19c88..eb1285789f 100644 --- a/docs/dyn/youtube_v3.channels.html +++ b/docs/dyn/youtube_v3.channels.html @@ -81,7 +81,7 @@

Instance Methods

list(part, categoryId=None, forHandle=None, forUsername=None, hl=None, id=None, managedByMe=None, maxResults=None, mine=None, mySubscribers=None, onBehalfOfContentOwner=None, pageToken=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(part, body=None, onBehalfOfContentOwner=None, x__xgafv=None)

@@ -360,17 +360,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -607,7 +607,7 @@

Method Details

}, } - onBehalfOfContentOwner: string, The *onBehalfOfContentOwner* parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner. + onBehalfOfContentOwner: string, The *onBehalfOfContentOwner* parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner. This parameter must be provided if the request is authenticated with credentials for a CMS content owner user acting on a managed channel. If omitted, the request executes under the authenticated user's direct context and returns an HTTP 403 Forbidden error. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/docs/dyn/youtube_v3.commentThreads.html b/docs/dyn/youtube_v3.commentThreads.html index 15d764612e..b3206755ae 100644 --- a/docs/dyn/youtube_v3.commentThreads.html +++ b/docs/dyn/youtube_v3.commentThreads.html @@ -84,7 +84,7 @@

Instance Methods

list(part, allThreadsRelatedToChannelId=None, channelId=None, id=None, maxResults=None, moderationStatus=None, order=None, pageToken=None, postId=None, searchTerms=None, textFormat=None, videoId=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -369,17 +369,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.comments.html b/docs/dyn/youtube_v3.comments.html index 7fff41c444..589918c802 100644 --- a/docs/dyn/youtube_v3.comments.html +++ b/docs/dyn/youtube_v3.comments.html @@ -87,7 +87,7 @@

Instance Methods

list(part, id=None, maxResults=None, pageToken=None, parentId=None, textFormat=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

markAsSpam(id, x__xgafv=None)

@@ -253,17 +253,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.html b/docs/dyn/youtube_v3.html index e8f8399ce4..9ffbd352e9 100644 --- a/docs/dyn/youtube_v3.html +++ b/docs/dyn/youtube_v3.html @@ -238,7 +238,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -247,20 +247,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/youtube_v3.liveBroadcasts.html b/docs/dyn/youtube_v3.liveBroadcasts.html index 243a52c7f7..1e6ab45a16 100644 --- a/docs/dyn/youtube_v3.liveBroadcasts.html +++ b/docs/dyn/youtube_v3.liveBroadcasts.html @@ -93,7 +93,7 @@

Instance Methods

list(part, broadcastStatus=None, broadcastType=None, id=None, maxResults=None, mine=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, pageToken=None, x__xgafv=None)

Retrieve the list of broadcasts associated with the given channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

transition(broadcastStatus, id, part, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, x__xgafv=None)

@@ -751,17 +751,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.liveChatMessages.html b/docs/dyn/youtube_v3.liveChatMessages.html index 0d3b45520c..c1ec4648b2 100644 --- a/docs/dyn/youtube_v3.liveChatMessages.html +++ b/docs/dyn/youtube_v3.liveChatMessages.html @@ -87,7 +87,7 @@

Instance Methods

list(liveChatId, part, hl=None, maxResults=None, pageToken=None, profileImageSize=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

transition(id=None, status=None, x__xgafv=None)

@@ -594,17 +594,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.liveChatModerators.html b/docs/dyn/youtube_v3.liveChatModerators.html index f64d4045a1..4aeec5c54d 100644 --- a/docs/dyn/youtube_v3.liveChatModerators.html +++ b/docs/dyn/youtube_v3.liveChatModerators.html @@ -87,7 +87,7 @@

Instance Methods

list(liveChatId, part, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -206,17 +206,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.liveStreams.html b/docs/dyn/youtube_v3.liveStreams.html index 24ff26bf4a..3f798c22b3 100644 --- a/docs/dyn/youtube_v3.liveStreams.html +++ b/docs/dyn/youtube_v3.liveStreams.html @@ -87,7 +87,7 @@

Instance Methods

list(part, id=None, maxResults=None, mine=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, pageToken=None, x__xgafv=None)

Retrieve the list of streams associated with the given channel. --

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(part, body=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, x__xgafv=None)

@@ -306,17 +306,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.members.html b/docs/dyn/youtube_v3.members.html index 3736be5fc4..c4eeca62ee 100644 --- a/docs/dyn/youtube_v3.members.html +++ b/docs/dyn/youtube_v3.members.html @@ -81,7 +81,7 @@

Instance Methods

list(part, filterByMemberChannelId=None, hasAccessToLevel=None, maxResults=None, mode=None, pageToken=None, x__xgafv=None)

Retrieves a list of members that match the request criteria for a channel.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -161,17 +161,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.playlistImages.html b/docs/dyn/youtube_v3.playlistImages.html index 1442505a8a..a2514d4461 100644 --- a/docs/dyn/youtube_v3.playlistImages.html +++ b/docs/dyn/youtube_v3.playlistImages.html @@ -87,7 +87,7 @@

Instance Methods

list(maxResults=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, pageToken=None, parent=None, part=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(body=None, media_body=None, media_mime_type=None, onBehalfOfContentOwner=None, part=None, x__xgafv=None)

@@ -199,17 +199,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.playlistItems.html b/docs/dyn/youtube_v3.playlistItems.html index 5b4f02c50e..e0e669c0fc 100644 --- a/docs/dyn/youtube_v3.playlistItems.html +++ b/docs/dyn/youtube_v3.playlistItems.html @@ -87,7 +87,7 @@

Instance Methods

list(part, id=None, maxResults=None, onBehalfOfContentOwner=None, pageToken=None, playlistId=None, videoId=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(part, body=None, onBehalfOfContentOwner=None, x__xgafv=None)

@@ -394,17 +394,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.playlists.html b/docs/dyn/youtube_v3.playlists.html index e83c216e2d..9cb8cee114 100644 --- a/docs/dyn/youtube_v3.playlists.html +++ b/docs/dyn/youtube_v3.playlists.html @@ -87,7 +87,7 @@

Instance Methods

list(part, channelId=None, hl=None, id=None, maxResults=None, mine=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, pageToken=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

update(part, body=None, onBehalfOfContentOwner=None, x__xgafv=None)

@@ -412,17 +412,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
diff --git a/docs/dyn/youtube_v3.search.html b/docs/dyn/youtube_v3.search.html index a25b86016c..5623252627 100644 --- a/docs/dyn/youtube_v3.search.html +++ b/docs/dyn/youtube_v3.search.html @@ -81,7 +81,7 @@

Instance Methods

list(part, channelId=None, channelType=None, eventType=None, forContentOwner=None, forDeveloper=None, forMine=None, location=None, locationRadius=None, maxResults=None, onBehalfOfContentOwner=None, order=None, pageToken=None, publishedAfter=None, publishedBefore=None, q=None, regionCode=None, relevanceLanguage=None, safeSearch=None, topicId=None, type=None, videoCaption=None, videoCategoryId=None, videoDefinition=None, videoDimension=None, videoDuration=None, videoEmbeddable=None, videoLicense=None, videoPaidProductPlacement=None, videoSyndicated=None, videoType=None, x__xgafv=None)

Retrieves a list of search resources

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -103,7 +103,7 @@

Method Details

show - Only retrieve shows. eventType: string, Filter on the livestream status of the videos. Allowed values - none - + none - The resource does not have live broadcast content. upcoming - The live broadcast is upcoming. live - The live broadcast is active. completed - The live broadcast has been completed. @@ -275,17 +275,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.subscriptions.html b/docs/dyn/youtube_v3.subscriptions.html index 8f576ce55d..8de34f0b51 100644 --- a/docs/dyn/youtube_v3.subscriptions.html +++ b/docs/dyn/youtube_v3.subscriptions.html @@ -87,7 +87,7 @@

Instance Methods

list(part, channelId=None, forChannelId=None, id=None, maxResults=None, mine=None, myRecentSubscribers=None, mySubscribers=None, onBehalfOfContentOwner=None, onBehalfOfContentOwnerChannel=None, order=None, pageToken=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -510,17 +510,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.superChatEvents.html b/docs/dyn/youtube_v3.superChatEvents.html index 5514eabb24..27e92393db 100644 --- a/docs/dyn/youtube_v3.superChatEvents.html +++ b/docs/dyn/youtube_v3.superChatEvents.html @@ -81,7 +81,7 @@

Instance Methods

list(part, hl=None, maxResults=None, pageToken=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -150,17 +150,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtube_v3.videos.html b/docs/dyn/youtube_v3.videos.html index 8eed306fb7..cce285b455 100644 --- a/docs/dyn/youtube_v3.videos.html +++ b/docs/dyn/youtube_v3.videos.html @@ -93,7 +93,7 @@

Instance Methods

list(part, chart=None, hl=None, id=None, locale=None, maxHeight=None, maxResults=None, maxWidth=None, myRating=None, onBehalfOfContentOwner=None, pageToken=None, regionCode=None, videoCategoryId=None, x__xgafv=None)

Retrieves a list of resources, possibly filtered.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

rate(id, rating, x__xgafv=None)

@@ -466,7 +466,7 @@

Method Details

"likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating. "viewCount": "A String", # The number of times the video has been viewed. }, - "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses. + "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses. "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media. "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed. @@ -793,7 +793,7 @@

Method Details

"likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating. "viewCount": "A String", # The number of times the video has been viewed. }, - "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses. + "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses. "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media. "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed. @@ -860,7 +860,7 @@

Method Details

maxWidth: integer, Return the player with maximum height specified in myRating: string, Return videos liked/disliked by the authenticated user. Does not support RateType.RATED_TYPE_NONE. Allowed values - none - + none - The entity has not been rated. like - The entity is liked. dislike - The entity is disliked. onBehalfOfContentOwner: string, *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. @@ -1143,7 +1143,7 @@

Method Details

"likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating. "viewCount": "A String", # The number of times the video has been viewed. }, - "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses. + "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses. "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media. "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed. @@ -1205,17 +1205,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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. +
@@ -1226,7 +1226,7 @@

Method Details

id: string, A parameter (required) rating: string, A parameter (required) Allowed values - none - + none - The entity has not been rated. like - The entity is liked. dislike - The entity is disliked. x__xgafv: string, V1 error format. @@ -1533,7 +1533,7 @@

Method Details

"likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating. "viewCount": "A String", # The number of times the video has been viewed. }, - "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses. + "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses. "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media. "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed. @@ -1854,7 +1854,7 @@

Method Details

"likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating. "viewCount": "A String", # The number of times the video has been viewed. }, - "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses. + "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses. "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media. "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed. diff --git a/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html b/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html index 940b273bae..5298f30d04 100644 --- a/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html +++ b/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html @@ -81,7 +81,7 @@

Instance Methods

stream(hl=None, liveChatId=None, maxResults=None, pageToken=None, part=None, profileImageSize=None, x__xgafv=None)

Allows a user to load live chat through a server-streamed RPC.

- stream_next(previous_request, previous_response)

+ stream_next()

Retrieves the next page of results.

Method Details

@@ -340,17 +340,17 @@

Method Details

- stream_next(previous_request, previous_response) + stream_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)
+        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.
-
+ 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/youtubereporting_v1.html b/docs/dyn/youtubereporting_v1.html index 2829dba0cb..bf64d7869d 100644 --- a/docs/dyn/youtubereporting_v1.html +++ b/docs/dyn/youtubereporting_v1.html @@ -93,7 +93,7 @@

Instance Methods

close()

Close httplib2 connections.

- new_batch_http_request(callback=None)

+ new_batch_http_request()

Create a BatchHttpRequest object based on the discovery document.

Method Details

@@ -102,20 +102,20 @@

Method Details

- new_batch_http_request(callback=None) + new_batch_http_request() 
Create a BatchHttpRequest object based on the discovery document.
 
-Args:
-  callback: callable, A callback to be called for each response, of the
-    form callback(id, response, exception). The first parameter is the
-    request id, and the second is the deserialized response object. The
-    third is an apiclient.errors.HttpError exception object if an HTTP
-    error occurred while processing the request, or None if no error
-    occurred.
-
-Returns:
-  A BatchHttpRequest object based on the discovery document.
-
+ Args: + callback: callable, A callback to be called for each response, of the + form callback(id, response, exception). The first parameter is the + request id, and the second is the deserialized response object. The + third is an apiclient.errors.HttpError exception object if an HTTP + error occurred while processing the request, or None if no error + occurred. + + Returns: + A BatchHttpRequest object based on the discovery document. +
\ No newline at end of file diff --git a/docs/dyn/youtubereporting_v1.jobs.html b/docs/dyn/youtubereporting_v1.jobs.html index cf0dbc300e..7af417fc03 100644 --- a/docs/dyn/youtubereporting_v1.jobs.html +++ b/docs/dyn/youtubereporting_v1.jobs.html @@ -95,7 +95,7 @@

Instance Methods

list(includeSystemManaged=None, onBehalfOfContentOwner=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists jobs.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -216,17 +216,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtubereporting_v1.jobs.reports.html b/docs/dyn/youtubereporting_v1.jobs.reports.html index 0336f86b83..89227ac0b9 100644 --- a/docs/dyn/youtubereporting_v1.jobs.reports.html +++ b/docs/dyn/youtubereporting_v1.jobs.reports.html @@ -84,7 +84,7 @@

Instance Methods

list(jobId, createdAfter=None, onBehalfOfContentOwner=None, pageSize=None, pageToken=None, startTimeAtOrAfter=None, startTimeBefore=None, x__xgafv=None)

Lists reports created by a specific job. Returns NOT_FOUND if the job does not exist.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -156,17 +156,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/youtubereporting_v1.reportTypes.html b/docs/dyn/youtubereporting_v1.reportTypes.html index d742e78313..83f177445e 100644 --- a/docs/dyn/youtubereporting_v1.reportTypes.html +++ b/docs/dyn/youtubereporting_v1.reportTypes.html @@ -81,7 +81,7 @@

Instance Methods

list(includeSystemManaged=None, onBehalfOfContentOwner=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists report types.

- list_next(previous_request, previous_response)

+ list_next()

Retrieves the next page of results.

Method Details

@@ -120,17 +120,17 @@

Method Details

- list_next(previous_request, previous_response) + 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)
+        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.
-
+ 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/alertcenter.v1beta1.json b/googleapiclient/discovery_cache/documents/alertcenter.v1beta1.json index 0fe129e3f6..4a5b145655 100644 --- a/googleapiclient/discovery_cache/documents/alertcenter.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/alertcenter.v1beta1.json @@ -423,7 +423,7 @@ } } }, -"revision": "20260914", +"revision": "20260921", "rootUrl": "https://alertcenter.googleapis.com/", "schemas": { "AbuseDetected": { @@ -1514,7 +1514,8 @@ "MISSING_SIGNATURE", "MISSING_ALGORITHM_NAME", "UNSUPPORTED_ALGORITHM", -"FETCH_REQUEST_ERROR" +"FETCH_REQUEST_ERROR", +"SERVER_SIDE_FETCH_REQUEST_ERROR" ], "enumDescriptions": [ "Error info not specified.", @@ -1523,7 +1524,8 @@ "SMIME sign only: The sign response did not contain the signature.", "SMIME only: The sign response does not include the algorithm name.", "SMIME only: the algorithm name in the response is not supported by the client.", -"Fetch request on the client has failed." +"Fetch request on the client has failed.", +"Fetch request from the Google server to the key service has failed." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json index ebe7d1c926..7ff5532564 100644 --- a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json +++ b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json @@ -1272,7 +1272,7 @@ "accept": [ "application/octet-stream" ], -"maxSize": "1677721600", +"maxSize": "2097152000", "protocols": { "resumable": { "multipart": true, @@ -5970,7 +5970,7 @@ } } }, -"revision": "20260917", +"revision": "20260924", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -14219,7 +14219,12 @@ false "UpdateAppStoreHostedAppResponse": { "description": "Response for updating an app record for an app store hosted app.", "id": "UpdateAppStoreHostedAppResponse", -"properties": {}, +"properties": { +"updateId": { +"description": "Unique identifier for the specific version of the hosted app submitted in this update. This identifier can be used to correlate publishing signals (such as those returned by ListHostedAppsPublishingSignals) with this specific app update.", +"type": "string" +} +}, "type": "object" }, "UpdateBasePlanStateRequest": { diff --git a/googleapiclient/discovery_cache/documents/apigee.v1.json b/googleapiclient/discovery_cache/documents/apigee.v1.json index 7989f9a872..8ba4b9446a 100644 --- a/googleapiclient/discovery_cache/documents/apigee.v1.json +++ b/googleapiclient/discovery_cache/documents/apigee.v1.json @@ -11994,7 +11994,7 @@ } } }, -"revision": "20260905", +"revision": "20260920", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -21221,7 +21221,7 @@ "type": "boolean" }, "name": { -"description": "Required. The resource id of this target server. Values must match the regular expression ", +"description": "Required. The resource id of this target server. ", "type": "string" }, "port": { @@ -21244,7 +21244,7 @@ "The TargetServer uses HTTP.", "The TargetSever uses HTTP2.", "The TargetServer uses GRPC.", -"GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead. TODO(b/266125112) deprecate once EXTERNAL _CALLOUT generally available.", +"GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead.", "The TargetServer is to be used in the ExternalCallout Policy" ], "type": "string" @@ -21291,7 +21291,7 @@ "The TargetServer uses HTTP.", "The TargetSever uses HTTP2.", "The TargetServer uses GRPC.", -"GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead. TODO(b/266125112) deprecate once EXTERNAL _CALLOUT generally available.", +"GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead.", "The TargetServer is to be used in the ExternalCallout Policy" ], "type": "string" diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1.json b/googleapiclient/discovery_cache/documents/backupdr.v1.json index e2ee187c71..3b4ff20764 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1.json @@ -2725,7 +2725,7 @@ } } }, -"revision": "20260908", +"revision": "20260918", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -6197,6 +6197,7 @@ "ALLOY_DB", "FILESTORE", "BV_AF", +"GOOGLE_CLOUD_NETAPP_VOLUME", "CEP_MONITORING_COMPUTE_INSTANCE", "CEP_MONITORING_DISK", "BV_CUSTOM_PROBERS", @@ -6214,6 +6215,7 @@ "", "", "", +"", "Remove once parity achieved between BV_AF and BV_CUSTOM_PROBERS.", "" ], diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1beta.json b/googleapiclient/discovery_cache/documents/backupdr.v1beta.json index bbe9e82cfc..ea983f2f4b 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1beta.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1beta.json @@ -3179,7 +3179,7 @@ } } }, -"revision": "20260908", +"revision": "20260918", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -4597,7 +4597,8 @@ "ACTIVE", "DELETING", "INACTIVE", -"UPDATING" +"UPDATING", +"PAUSED" ], "enumDescriptions": [ "State not set.", @@ -4605,7 +4606,8 @@ "The resource has been created and is fully usable.", "The resource is being deleted.", "The resource has been created but is not usable.", -"The resource is being updated." +"The resource is being updated.", +"The resource has been created but backups are paused." ], "readOnly": true, "type": "string" @@ -7033,6 +7035,7 @@ "ALLOY_DB", "FILESTORE", "BV_AF", +"GOOGLE_CLOUD_NETAPP_VOLUME", "CEP_MONITORING_COMPUTE_INSTANCE", "CEP_MONITORING_DISK", "BV_CUSTOM_PROBERS", @@ -7050,6 +7053,7 @@ "", "", "", +"", "Remove once parity achieved between BV_AF and BV_CUSTOM_PROBERS.", "" ], diff --git a/googleapiclient/discovery_cache/documents/biglake.v1.json b/googleapiclient/discovery_cache/documents/biglake.v1.json index db1cdad9ce..697df93b82 100644 --- a/googleapiclient/discovery_cache/documents/biglake.v1.json +++ b/googleapiclient/discovery_cache/documents/biglake.v1.json @@ -21,18 +21,113 @@ "endpoints": [ { "description": "Regional Endpoint", +"endpointUrl": "https://biglake.asia-south1.rep.googleapis.com/", +"location": "asia-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west1.rep.googleapis.com/", +"location": "europe-west1" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://biglake.europe-west10.rep.googleapis.com/", "location": "europe-west10" }, { "description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west2.rep.googleapis.com/", +"location": "europe-west2" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://biglake.europe-west3.rep.googleapis.com/", "location": "europe-west3" }, { "description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west4.rep.googleapis.com/", +"location": "europe-west4" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west6.rep.googleapis.com/", +"location": "europe-west6" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west8.rep.googleapis.com/", +"location": "europe-west8" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.europe-west9.rep.googleapis.com/", +"location": "europe-west9" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.me-central2.rep.googleapis.com/", +"location": "me-central2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.northamerica-northeast1.rep.googleapis.com/", +"location": "northamerica-northeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.northamerica-northeast2.rep.googleapis.com/", +"location": "northamerica-northeast2" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://biglake.us-central1.rep.googleapis.com/", "location": "us-central1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-central2.rep.googleapis.com/", +"location": "us-central2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-east1.rep.googleapis.com/", +"location": "us-east1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-east4.rep.googleapis.com/", +"location": "us-east4" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-east5.rep.googleapis.com/", +"location": "us-east5" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-east7.rep.googleapis.com/", +"location": "us-east7" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-south1.rep.googleapis.com/", +"location": "us-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-west1.rep.googleapis.com/", +"location": "us-west1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-west2.rep.googleapis.com/", +"location": "us-west2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://biglake.us-west8.rep.googleapis.com/", +"location": "us-west8" } ], "fullyEncodeReservedExpansion": true, @@ -919,7 +1014,7 @@ } } }, -"revision": "20260905", +"revision": "20260915", "rootUrl": "https://biglake.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json index 3c28343ec8..871321825a 100644 --- a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json +++ b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json @@ -3238,7 +3238,7 @@ } } }, -"revision": "20260817", +"revision": "20260913", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -3422,6 +3422,20 @@ }, "type": "object" }, +"AvroSchema": { +"description": "Represents a collection of Avro schemas.", +"id": "AvroSchema", +"properties": { +"jsonSchemas": { +"description": "Required. The Avro schemas in JSON format. Each element must be the content of a valid, self-contained Avro schema file (.avsc), as described in https://avro.apache.org/docs/1.8.1/spec.html. Use repeated elements to include multiple Avro schema files in a single bundle.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "Backup": { "description": "A backup of a Cloud Bigtable table.", "id": "Backup", @@ -5688,6 +5702,10 @@ "description": "A named collection of related schemas.", "id": "SchemaBundle", "properties": { +"avroSchema": { +"$ref": "AvroSchema", +"description": "Optional. Schema for Avros." +}, "etag": { "description": "Optional. The etag for this schema bundle. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag.", "type": "string" diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json index 74e48f6a37..4235d39730 100644 --- a/googleapiclient/discovery_cache/documents/chat.v1.json +++ b/googleapiclient/discovery_cache/documents/chat.v1.json @@ -2181,7 +2181,7 @@ } } }, -"revision": "20260913", +"revision": "20260920", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessPermissionSetting": { @@ -6227,7 +6227,7 @@ "id": "SearchMessagesRequest", "properties": { "filter": { -"description": "Required. A search query. The query can specify one or more search keywords, which are used to filter the results, You can also filter the results using the following message fields: - `create_time`: Accepts a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported comparison operators are: `<` and `>=`. - `sender.name`: The resource name of the sender (`users/{user}`). Only supports `=`. You can use the e-mail as an alias for `{user}`. For example, `users/example@gmail.com`, where `example@gmail.com` is the e-mail of the Google Chat user. - `space.name`: The resource name of the space where the message is posted. (`spaces/{space}`). Only supports `=`. If this filter is not set, the search is performed across all direct messages and spaces the user has access to as a space member. - `space.display_name`: Supports the operator `:` (has) and filters spaces based on a partial match of their display name. Results are limited to the top five space matches. For example, `space.display_name:Project` searches for messages in the top five spaces that contain the word \"Project\" in their display names. - `attachment`: Supports the operator `:*` (has any) to check for the presence of attachments. If `attachment:*` is specified, only messages that have at least one attachment are returned. - `annotations.user_mentions.user.name`: The resource name of the mentioned user (`users/{user}`). Only supports `:` (has). For example: `annotations.user_mentions.user.name:\"users/1234567890\"` returns only messages that contain a mention to the specified user. Alternatively, the alias `me` can be used to filter for messages that mention the caller user, for example: `annotations.user_mentions.user.name:users/me`. You can also use the e-mail as an alias for `{user}`, for example, `users/example@gmail.com`. For advanced filtering, the following functions are also available: - `has_link()`: Returns only messages that have at least one hyperlink in the message text. - `is_unread()`: Filters out messages that have been read by the calling user. Using the `space.display_name` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` Using the `is_unread()` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.readstate.readonly` - `https://www.googleapis.com/auth/chat.users.readstate` Across different fields, only `AND` operators are supported. A valid example is `sender.name = \"users/1234567890\" AND is_unread()`. The word `AND` is optional and is implied if omitted. For example, `sender.name = \"users/1234567890\" is_unread()` is valid and is equivalent to the previous example. An invalid example is `sender.name = \"users/1234567890\" OR is_unread()` because `OR` is not supported between different fields. Among the same field: - `create_time` supports only `AND`, and can only be used to represent an interval, such as `create_time >= \"2022-01-01T00:00:00+00:00\" AND create_time < \"2023-01-01T00:00:00+00:00\"`. - `sender.name` supports only the `OR` operator, for example: `sender.name = \"users/1234567890\" OR sender.name = \"users/0987654321\"`. - `space.name` supports only the `OR` operator, for example: `space.name = \"spaces/ABCDEFGH\" OR space.name = \"spaces/QWERTYUI\"`. - `space.display_name` supports the operators `AND` and `OR`, but not a mix of both. For example: `space.display_name:Project AND space.display_name:Tasks` returns messages that are in spaces with display names containing both `Project` and `Tasks`, whereas `space.display_name:Project OR space.display_name:Tasks` returns messages that are in spaces with display names containing either `Project` or `Tasks` or both. - `annotations.user_mentions.user.name` supports the operators `AND` and `OR`, but not a mix of both. For example: `annotations.user_mentions.user.name:\"users/1234567890\" AND annotations.user_mentions.user.name:\"users/0987654321\"` returns only messages that mentions both users, whereas `annotations.user_mentions.user.name:\"users/1234567890\" OR annotations.user_mentions.user.name:\"users/0987654321\"` returns messages that mention either user or both. Parentheses are required to disambiguate operator precedence when combining `AND` and `OR` operators in the same query. For example: `(sender.name=\"users/me\" OR sender.name=\"users/123456\") AND is_unread()`. Otherwise, parentheses are optional. The following example queries are valid: ``` \"Pending reports\" AND create_time >= \"2023-01-01T00:00:00Z\" sender.name = \"users/example@gmail.com\" annotations.user_mentions.user.name:\"users/0987654321\" attachment:* AND space.name = \"spaces/ABCDEFGH\" tasks AND is_unread() AND sender.name = \"users/1234567890\" \"things to do\" \"urgent\" (sender.name = \"users/1234567890\") AND (create_time < \"2023-05-01T00:00:00Z\") tasks AND space.name = \"spaces/ABCDEFGH\" AND has_link() \"project one\" is_unread() space.display_name:Project tasks ``` The maximum query length is 1,000 characters. Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", +"description": "Required. A search query. The query can specify one or more search keywords, which are used to filter the results, You can also filter the results using the following message fields: - `create_time`: Accepts a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported comparison operators are: `<` and `>=`. - `sender.name`: The resource name of the sender (`users/{user}`). Only supports `=`. You can use the e-mail as an alias for `{user}`. For example, `users/example@gmail.com`, where `example@gmail.com` is the e-mail of the Google Chat user. - `space.name`: The resource name of the space where the message is posted. (`spaces/{space}`). Only supports `=`. If this filter is not set, the search is performed across all direct messages and spaces the user has access to as a space member. - `space.display_name`: Supports the operator `:` (has) and filters spaces based on a partial match of their display name. Results are limited to the top five space matches. For example, `space.display_name:Project` searches for messages in the top five spaces that contain the word \"Project\" in their display names. - `space.space_type`: The type of the space. Only supports `=`. For example, `space.space_type=\"DIRECT_MESSAGE\"` returns only messages from direct messages. The possible values are `DIRECT_MESSAGE`, `GROUP_CHAT`, and `SPACE`. - `attachment`: Supports the operator `:*` (has any) to check for the presence of attachments. If `attachment:*` is specified, only messages that have at least one attachment are returned. - `annotations.user_mentions.user.name`: The resource name of the mentioned user (`users/{user}`). Only supports `:` (has). For example: `annotations.user_mentions.user.name:\"users/1234567890\"` returns only messages that contain a mention to the specified user. Alternatively, the alias `me` can be used to filter for messages that mention the caller user, for example: `annotations.user_mentions.user.name:users/me`. You can also use the e-mail as an alias for `{user}`, for example, `users/example@gmail.com`. For advanced filtering, the following functions are also available: - `has_link()`: Returns only messages that have at least one hyperlink in the message text. - `is_unread()`: Filters out messages that have been read by the calling user. Using the `space.display_name` or the `space.space_type` filters requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` Using the `is_unread()` filter requires that the calling credentials include one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.readstate.readonly` - `https://www.googleapis.com/auth/chat.users.readstate` Across different fields, only `AND` operators are supported. A valid example is `sender.name = \"users/1234567890\" AND is_unread()`. The word `AND` is optional and is implied if omitted. For example, `sender.name = \"users/1234567890\" is_unread()` is valid and is equivalent to the previous example. An invalid example is `sender.name = \"users/1234567890\" OR is_unread()` because `OR` is not supported between different fields. Among the same field: - `create_time` supports only `AND`, and can only be used to represent an interval, such as `create_time >= \"2022-01-01T00:00:00+00:00\" AND create_time < \"2023-01-01T00:00:00+00:00\"`. - `sender.name` supports only the `OR` operator, for example: `sender.name = \"users/1234567890\" OR sender.name = \"users/0987654321\"`. - `space.name` supports only the `OR` operator, for example: `space.name = \"spaces/ABCDEFGH\" OR space.name = \"spaces/QWERTYUI\"`. - `space.display_name` supports the operators `AND` and `OR`, but not a mix of both. For example: `space.display_name:Project AND space.display_name:Tasks` returns messages that are in spaces with display names containing both `Project` and `Tasks`, whereas `space.display_name:Project OR space.display_name:Tasks` returns messages that are in spaces with display names containing either `Project` or `Tasks` or both. - `space.space_type` supports only the `OR` operator, for example: `space.space_type = \"DIRECT_MESSAGE\" OR space.space_type = \"GROUP_CHAT\"`. - `annotations.user_mentions.user.name` supports the operators `AND` and `OR`, but not a mix of both. For example: `annotations.user_mentions.user.name:\"users/1234567890\" AND annotations.user_mentions.user.name:\"users/0987654321\"` returns only messages that mentions both users, whereas `annotations.user_mentions.user.name:\"users/1234567890\" OR annotations.user_mentions.user.name:\"users/0987654321\"` returns messages that mention either user or both. Parentheses are required to disambiguate operator precedence when combining `AND` and `OR` operators in the same query. For example: `(sender.name=\"users/me\" OR sender.name=\"users/123456\") AND is_unread()`. Otherwise, parentheses are optional. The following example queries are valid: ``` \"Pending reports\" AND create_time >= \"2023-01-01T00:00:00Z\" sender.name = \"users/example@gmail.com\" annotations.user_mentions.user.name:\"users/0987654321\" attachment:* AND space.name = \"spaces/ABCDEFGH\" tasks AND is_unread() AND sender.name = \"users/1234567890\" \"things to do\" \"urgent\" (sender.name = \"users/1234567890\") AND (create_time < \"2023-05-01T00:00:00Z\") tasks AND space.name = \"spaces/ABCDEFGH\" AND has_link() \"project one\" is_unread() space.display_name:Project tasks ``` The maximum query length is 1,000 characters. Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", "type": "string" }, "markupSyntax": { @@ -6986,6 +6986,11 @@ "description": "If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource (such as in the Messages and Memberships APIs) only populates the `name` and `type` fields for both internal and external users, unless they are members of the space or have prior affinity with the calling user.", "id": "User", "properties": { +"avatarUrl": { +"description": "Output only. The user's avatar image URL. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user.", +"readOnly": true, +"type": "string" +}, "displayName": { "description": "Output only. The user's display name. Populated for both app authentication and user authentication. This field is always populated for requests made with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user.", "readOnly": true, @@ -6995,6 +7000,11 @@ "description": "Unique identifier of the user's Google Workspace domain.", "type": "string" }, +"email": { +"description": "Output only. The user's email address. When calling the Messages and Memberships APIs with [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), this field is populated for both internal and external users for the `sender` of a message, users within `annotations` (such as user mentions), and within `Membership` resources, provided the user is a member of the space or has prior affinity with the calling user.", +"readOnly": true, +"type": "string" +}, "isAnonymous": { "description": "Output only. When `true`, the user is deleted or their profile is not visible, such as when a user is mentioned in a space without being a member and without prior affinity with the calling user.", "readOnly": true, diff --git a/googleapiclient/discovery_cache/documents/cloudidentity.v1.json b/googleapiclient/discovery_cache/documents/cloudidentity.v1.json index 12df482703..50c3e9e4c4 100644 --- a/googleapiclient/discovery_cache/documents/cloudidentity.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudidentity.v1.json @@ -2423,7 +2423,7 @@ } } }, -"revision": "20260914", +"revision": "20260920", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { @@ -2667,15 +2667,15 @@ "type": "object" }, "ExternalId": { -"description": "An external identifier for an entity in the Cloud Identity Groups API. Used to link a `Group` in Cloud Identity Groups API with a corresponding entity in an external identity system or directory.", +"description": "Represents an external identifier that links a Group in the Cloud Identity Groups API with a corresponding entity in an external directory or identity provider.", "id": "ExternalId", "properties": { "id": { -"description": "Required. The unique identifier assigned by the external identity provider. The API does not enforce uniqueness of IDs across entities, but clients should ensure IDs are unique within their namespace.", +"description": "Required. The unique identifier assigned by the external identity provider. The API does not enforce unique IDs across entities, but clients **must** ensure IDs are unique within their namespace.", "type": "string" }, "namespace": { -"description": "Required. The namespace in which the entity exists. Cannot be empty. Currently, the only allowable namespace is `\"system/external\"`.", +"description": "Required. The namespace in which the entity exists. The only supported namespace is `system/external`.", "type": "string" } }, @@ -3776,7 +3776,7 @@ "description": "Optional. Dynamic group metadata like queries and status." }, "externalIds": { -"description": "Optional. External identifiers associated with the `Group`. Enables external identity providers and directory sync tools to link their native unique identifiers with this group. Currently, the only allowable namespace is `\"system/external\"`.", +"description": "Optional. External identifiers associated with the `Group`. Allows external identity providers and directory sync tools link their native unique identifiers with this group. The only supported namespace is `system/external`.", "items": { "$ref": "ExternalId" }, diff --git a/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1.json b/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1.json index c4f7a003a3..df89a63847 100644 --- a/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1.json @@ -304,7 +304,7 @@ } } }, -"revision": "20260909", +"revision": "20260916", "rootUrl": "https://cloudlocationfinder.googleapis.com/", "schemas": { "CloudLocation": { @@ -322,13 +322,15 @@ "CLOUD_LOCATION_TYPE_UNSPECIFIED", "CLOUD_LOCATION_TYPE_REGION", "CLOUD_LOCATION_TYPE_ZONE", -"CLOUD_LOCATION_TYPE_GDCC_ZONE" +"CLOUD_LOCATION_TYPE_GDCC_ZONE", +"CLOUD_LOCATION_TYPE_GLOBAL" ], "enumDescriptions": [ "Unspecified type.", "CloudLocation type for region.", "CloudLocation type for zone.", -"CloudLocation type for Google Distributed Cloud Connected Zone." +"CloudLocation type for Google Distributed Cloud Connected Zone.", +"CloudLocation type for global." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1alpha.json b/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1alpha.json index e58b40896b..9d0ca69f86 100644 --- a/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/cloudlocationfinder.v1alpha.json @@ -304,7 +304,7 @@ } } }, -"revision": "20260909", +"revision": "20260916", "rootUrl": "https://cloudlocationfinder.googleapis.com/", "schemas": { "CloudLocation": { @@ -322,13 +322,15 @@ "CLOUD_LOCATION_TYPE_UNSPECIFIED", "CLOUD_LOCATION_TYPE_REGION", "CLOUD_LOCATION_TYPE_ZONE", -"CLOUD_LOCATION_TYPE_GDCC_ZONE" +"CLOUD_LOCATION_TYPE_GDCC_ZONE", +"CLOUD_LOCATION_TYPE_GLOBAL" ], "enumDescriptions": [ "Unspecified type.", "CloudLocation type for region.", "CloudLocation type for zone.", -"CloudLocation type for Google Distributed Cloud Connected Zone." +"CloudLocation type for Google Distributed Cloud Connected Zone.", +"CloudLocation type for global." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json index 3b9541ee3d..4abc02bbeb 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json @@ -588,7 +588,7 @@ ] }, "get": { -"description": "Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", +"description": "Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", "flatPath": "v3/folders/{foldersId}/capabilityConfigs/{capabilityConfigsId}", "httpMethod": "GET", "id": "cloudresourcemanager.folders.capabilityConfigs.get", @@ -1134,7 +1134,7 @@ ] }, "get": { -"description": "Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", +"description": "Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", "flatPath": "v3/organizations/{organizationsId}/capabilityConfigs/{capabilityConfigsId}", "httpMethod": "GET", "id": "cloudresourcemanager.organizations.capabilityConfigs.get", @@ -1615,7 +1615,7 @@ ] }, "get": { -"description": "Retrieves the Capability Config identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", +"description": "Retrieves the CapabilityConfig identified by the specified `name` (for example, `folders/123456789/capabilityConfigs/my-capability-config`).", "flatPath": "v3/projects/{projectsId}/capabilityConfigs/{capabilityConfigsId}", "httpMethod": "GET", "id": "cloudresourcemanager.projects.capabilityConfigs.get", @@ -2475,7 +2475,7 @@ } } }, -"revision": "20260909", +"revision": "20260917", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -2581,7 +2581,7 @@ "type": "string" }, "displayName": { -"description": "Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Capability Config`", +"description": "Optional. Human-readable non-unique display name of the CapabilityConfig. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My CapabilityConfig`", "type": "string" }, "etag": { diff --git a/googleapiclient/discovery_cache/documents/compute.preview.json b/googleapiclient/discovery_cache/documents/compute.preview.json new file mode 100644 index 0000000000..fa5a9e9dcd --- /dev/null +++ b/googleapiclient/discovery_cache/documents/compute.preview.json @@ -0,0 +1,116737 @@ +{ +"auth": { +"oauth2": { +"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/compute": { +"description": "View and manage your Google Compute Engine resources" +}, +"https://www.googleapis.com/auth/compute.readonly": { +"description": "View your Google Compute Engine resources" +}, +"https://www.googleapis.com/auth/devstorage.full_control": { +"description": "Manage your data and permissions in Cloud Storage and see the email address for your Google Account" +}, +"https://www.googleapis.com/auth/devstorage.read_only": { +"description": "View your data in Google Cloud Storage" +}, +"https://www.googleapis.com/auth/devstorage.read_write": { +"description": "Manage your data in Cloud Storage and see the email address of your Google Account" +} +} +} +}, +"basePath": "/compute/v1/", +"baseUrl": "https://compute.googleapis.com/compute/v1/", +"batchPath": "batch/compute/v1", +"description": "Creates and runs virtual machines on Google Cloud Platform.", +"discoveryVersion": "v1", +"documentationLink": "https://cloud.google.com/compute/", +"endpoints": [ +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.africa-south1.rep.googleapis.com/", +"location": "africa-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-east1.rep.googleapis.com/", +"location": "asia-east1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-east2.rep.googleapis.com/", +"location": "asia-east2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-northeast1.rep.googleapis.com/", +"location": "asia-northeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-northeast2.rep.googleapis.com/", +"location": "asia-northeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-northeast3.rep.googleapis.com/", +"location": "asia-northeast3" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-south1.rep.googleapis.com/", +"location": "asia-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-south2.rep.googleapis.com/", +"location": "asia-south2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-southeast1.rep.googleapis.com/", +"location": "asia-southeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-southeast2.rep.googleapis.com/", +"location": "asia-southeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.asia-southeast3.rep.googleapis.com/", +"location": "asia-southeast3" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.australia-southeast1.rep.googleapis.com/", +"location": "australia-southeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.australia-southeast2.rep.googleapis.com/", +"location": "australia-southeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-central2.rep.googleapis.com/", +"location": "europe-central2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-north1.rep.googleapis.com/", +"location": "europe-north1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-north2.rep.googleapis.com/", +"location": "europe-north2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-southwest1.rep.googleapis.com/", +"location": "europe-southwest1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west1.rep.googleapis.com/", +"location": "europe-west1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west10.rep.googleapis.com/", +"location": "europe-west10" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west12.rep.googleapis.com/", +"location": "europe-west12" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west2.rep.googleapis.com/", +"location": "europe-west2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west3.rep.googleapis.com/", +"location": "europe-west3" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west4.rep.googleapis.com/", +"location": "europe-west4" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west6.rep.googleapis.com/", +"location": "europe-west6" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west8.rep.googleapis.com/", +"location": "europe-west8" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.europe-west9.rep.googleapis.com/", +"location": "europe-west9" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.me-central1.rep.googleapis.com/", +"location": "me-central1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.me-central2.rep.googleapis.com/", +"location": "me-central2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.me-west1.rep.googleapis.com/", +"location": "me-west1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.northamerica-northeast1.rep.googleapis.com/", +"location": "northamerica-northeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.northamerica-northeast2.rep.googleapis.com/", +"location": "northamerica-northeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.northamerica-south1.rep.googleapis.com/", +"location": "northamerica-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.southamerica-east1.rep.googleapis.com/", +"location": "southamerica-east1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.southamerica-west1.rep.googleapis.com/", +"location": "southamerica-west1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-central1.rep.googleapis.com/", +"location": "us-central1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-east1.rep.googleapis.com/", +"location": "us-east1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-east4.rep.googleapis.com/", +"location": "us-east4" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-east5.rep.googleapis.com/", +"location": "us-east5" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-south1.rep.googleapis.com/", +"location": "us-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-west1.rep.googleapis.com/", +"location": "us-west1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-west2.rep.googleapis.com/", +"location": "us-west2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-west3.rep.googleapis.com/", +"location": "us-west3" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://compute.us-west4.rep.googleapis.com/", +"location": "us-west4" +} +], +"icons": { +"x16": "https://www.google.com/images/icons/product/compute_engine-16.png", +"x32": "https://www.google.com/images/icons/product/compute_engine-32.png" +}, +"id": "compute:preview", +"kind": "discovery#restDescription", +"mtlsRootUrl": "https://compute.mtls.googleapis.com/", +"name": "compute", +"ownerDomain": "google.com", +"ownerName": "Google", +"parameters": { +"$.xgafv": { +"description": "V1 error format.", +"enum": [ +"1", +"2" +], +"enumDescriptions": [ +"v1 error format", +"v2 error format" +], +"location": "query", +"type": "string" +}, +"access_token": { +"description": "OAuth access token.", +"location": "query", +"type": "string" +}, +"alt": { +"default": "json", +"description": "Data format for response.", +"enum": [ +"json", +"media", +"proto" +], +"enumDescriptions": [ +"Responses with Content-Type of application/json", +"Media download with context-dependent Content-Type", +"Responses with Content-Type of application/x-protobuf" +], +"location": "query", +"type": "string" +}, +"callback": { +"description": "JSONP", +"location": "query", +"type": "string" +}, +"fields": { +"description": "Selector specifying which fields to include in a partial response.", +"location": "query", +"type": "string" +}, +"key": { +"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", +"location": "query", +"type": "string" +}, +"oauth_token": { +"description": "OAuth 2.0 token for the current user.", +"location": "query", +"type": "string" +}, +"prettyPrint": { +"default": "true", +"description": "Returns response with indentations and line breaks.", +"location": "query", +"type": "boolean" +}, +"quotaUser": { +"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", +"location": "query", +"type": "string" +}, +"uploadType": { +"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", +"location": "query", +"type": "string" +}, +"upload_protocol": { +"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", +"location": "query", +"type": "string" +}, +"userIp": { +"description": "Legacy name for parameter that has been superseded by `quotaUser`.", +"location": "query", +"type": "string" +} +}, +"protocol": "rest", +"resources": { +"acceleratorTypes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of accelerator types.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/acceleratorTypes", +"httpMethod": "GET", +"id": "compute.acceleratorTypes.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": "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" +}, +"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/acceleratorTypes", +"response": { +"$ref": "AcceleratorTypeAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified accelerator type.", +"flatPath": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", +"httpMethod": "GET", +"id": "compute.acceleratorTypes.get", +"parameterOrder": [ +"project", +"zone", +"acceleratorType" +], +"parameters": { +"acceleratorType": { +"description": "Name of the accelerator type 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", +"response": { +"$ref": "AcceleratorType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of accelerator types that are available to the specified\nproject.", +"flatPath": "projects/{project}/zones/{zone}/acceleratorTypes", +"httpMethod": "GET", +"id": "compute.acceleratorTypes.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/acceleratorTypes", +"response": { +"$ref": "AcceleratorTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"addresses": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of addresses.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/addresses", +"httpMethod": "GET", +"id": "compute.addresses.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": "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" +}, +"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/addresses", +"response": { +"$ref": "AddressAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified address resource.", +"flatPath": "projects/{project}/regions/{region}/addresses/{address}", +"httpMethod": "DELETE", +"id": "compute.addresses.delete", +"parameterOrder": [ +"project", +"region", +"address" +], +"parameters": { +"address": { +"description": "Name of the address 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 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" +} +}, +"path": "projects/{project}/regions/{region}/addresses/{address}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified address resource.", +"flatPath": "projects/{project}/regions/{region}/addresses/{address}", +"httpMethod": "GET", +"id": "compute.addresses.get", +"parameterOrder": [ +"project", +"region", +"address" +], +"parameters": { +"address": { +"description": "Name of the address 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/addresses/{address}", +"response": { +"$ref": "Address" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an address resource in the specified project by using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/addresses", +"httpMethod": "POST", +"id": "compute.addresses.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 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" +} +}, +"path": "projects/{project}/regions/{region}/addresses", +"request": { +"$ref": "Address" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of addresses contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/addresses", +"httpMethod": "GET", +"id": "compute.addresses.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/addresses", +"response": { +"$ref": "AddressList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"move": { +"apiVersion": "2026-10-01-preview", +"description": "Moves the specified address resource.", +"flatPath": "projects/{project}/regions/{region}/addresses/{address}/move", +"httpMethod": "POST", +"id": "compute.addresses.move", +"parameterOrder": [ +"project", +"region", +"address" +], +"parameters": { +"address": { +"description": "Name of the address resource to move.", +"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": "Source project ID which the Address is moved from.", +"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" +} +}, +"path": "projects/{project}/regions/{region}/addresses/{address}/move", +"request": { +"$ref": "RegionAddressesMoveRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on an Address. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.addresses.setLabels", +"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 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" +}, +"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}/addresses/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/addresses/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.addresses.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}/addresses/{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" +] +} +} +}, +"advice": { +"methods": { +"calendarMode": { +"apiVersion": "2026-10-01-preview", +"description": "Advise how, where and when to create the requested amount of instances\nwith specified accelerators, within the specified time and location limits.\nThe method recommends creating future reservations for the requested\nresources.", +"flatPath": "projects/{project}/regions/{region}/advice/calendarMode", +"httpMethod": "POST", +"id": "compute.advice.calendarMode", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/advice/calendarMode", +"request": { +"$ref": "CalendarModeAdviceRequest" +}, +"response": { +"$ref": "CalendarModeAdviceResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"capacity": { +"apiVersion": "2026-10-01-preview", +"description": "Advice on making real-time decisions (such as choosing zone or\nmachine types) during deployment to maximize your chances of obtaining\ncapacity.", +"flatPath": "projects/{project}/regions/{region}/advice/capacity", +"httpMethod": "POST", +"id": "compute.advice.capacity", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/advice/capacity", +"request": { +"$ref": "CapacityAdviceRequest" +}, +"response": { +"$ref": "CapacityAdviceResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"capacityHistory": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the capacity history.", +"flatPath": "projects/{project}/regions/{region}/advice/capacityHistory", +"httpMethod": "POST", +"id": "compute.advice.capacityHistory", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/advice/capacityHistory", +"request": { +"$ref": "CapacityHistoryRequest" +}, +"response": { +"$ref": "CapacityHistoryResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"autoscalers": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of autoscalers.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/autoscalers", +"httpMethod": "GET", +"id": "compute.autoscalers.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": "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" +}, +"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/autoscalers", +"response": { +"$ref": "AutoscalerAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified autoscaler.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", +"httpMethod": "DELETE", +"id": "compute.autoscalers.delete", +"parameterOrder": [ +"project", +"zone", +"autoscaler" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler 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" +}, +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified autoscaler resource.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", +"httpMethod": "GET", +"id": "compute.autoscalers.get", +"parameterOrder": [ +"project", +"zone", +"autoscaler" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler 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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", +"response": { +"$ref": "Autoscaler" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an autoscaler in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers", +"httpMethod": "POST", +"id": "compute.autoscalers.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of autoscalers contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers", +"httpMethod": "GET", +"id": "compute.autoscalers.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers", +"response": { +"$ref": "AutoscalerList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an autoscaler 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}/zones/{zone}/autoscalers", +"httpMethod": "PATCH", +"id": "compute.autoscalers.patch", +"parameterOrder": [ +"project", +"zone" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler to patch.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"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. 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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.autoscalers.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an autoscaler in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/zones/{zone}/autoscalers", +"httpMethod": "PUT", +"id": "compute.autoscalers.update", +"parameterOrder": [ +"project", +"zone" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler to update.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"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. 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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"backendBuckets": { +"methods": { +"addSignedUrlKey": { +"apiVersion": "2026-10-01-preview", +"description": "Adds a key for validating requests with signed URLs for this backend\nbucket.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", +"httpMethod": "POST", +"id": "compute.backendBuckets.addSignedUrlKey", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket resource to which the Signed URL Key should be\nadded. The name 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. 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}/global/backendBuckets/{backendBucket}/addSignedUrlKey", +"request": { +"$ref": "SignedUrlKey" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all BackendBucket resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/backendBuckets", +"httpMethod": "GET", +"id": "compute.backendBuckets.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" +}, +"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/backendBuckets", +"response": { +"$ref": "BackendBucketAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified BackendBucket resource.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", +"httpMethod": "DELETE", +"id": "compute.backendBuckets.delete", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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" +}, +"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}/global/backendBuckets/{backendBucket}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteSignedUrlKey": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a key for validating requests with signed URLs for this backend\nbucket.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", +"httpMethod": "POST", +"id": "compute.backendBuckets.deleteSignedUrlKey", +"parameterOrder": [ +"project", +"backendBucket", +"keyName" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket resource to which the Signed URL Key should be\nadded. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"keyName": { +"description": "The name of the Signed URL Key to delete.", +"location": "query", +"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. 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}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified BackendBucket resource.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", +"httpMethod": "GET", +"id": "compute.backendBuckets.get", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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" +} +}, +"path": "projects/{project}/global/backendBuckets/{backendBucket}", +"response": { +"$ref": "BackendBucket" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.backendBuckets.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/backendBuckets/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a BackendBucket resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/backendBuckets", +"httpMethod": "POST", +"id": "compute.backendBuckets.insert", +"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" +} +}, +"path": "projects/{project}/global/backendBuckets", +"request": { +"$ref": "BackendBucket" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of BackendBucket resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/backendBuckets", +"httpMethod": "GET", +"id": "compute.backendBuckets.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendBuckets", +"response": { +"$ref": "BackendBucketList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listUsable": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of all usable backend buckets in the specified project.", +"flatPath": "projects/{project}/global/backendBuckets/listUsable", +"httpMethod": "GET", +"id": "compute.backendBuckets.listUsable", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendBuckets/listUsable", +"response": { +"$ref": "BackendBucketListUsable" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified BackendBucket resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", +"httpMethod": "PATCH", +"id": "compute.backendBuckets.patch", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendBuckets/{backendBucket}", +"request": { +"$ref": "BackendBucket" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setEdgeSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the edge security policy for the specified backend bucket.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", +"httpMethod": "POST", +"id": "compute.backendBuckets.setEdgeSecurityPolicy", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket resource to which the security policy should be\nset. The name 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. 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}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.backendBuckets.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/backendBuckets/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.backendBuckets.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/backendBuckets/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified BackendBucket resource with the data included in the\nrequest.", +"flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", +"httpMethod": "PUT", +"id": "compute.backendBuckets.update", +"parameterOrder": [ +"project", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket resource to update.", +"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" +}, +"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}/global/backendBuckets/{backendBucket}", +"request": { +"$ref": "BackendBucket" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"backendServices": { +"methods": { +"addSignedUrlKey": { +"apiVersion": "2026-10-01-preview", +"description": "Adds a key for validating requests with signed URLs for this backend\nservice.", +"flatPath": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", +"httpMethod": "POST", +"id": "compute.backendServices.addSignedUrlKey", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the Signed URL Key should be\nadded. The name 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. 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}/global/backendServices/{backendService}/addSignedUrlKey", +"request": { +"$ref": "SignedUrlKey" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all BackendService resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/backendServices", +"httpMethod": "GET", +"id": "compute.backendServices.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" +}, +"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/backendServices", +"response": { +"$ref": "BackendServiceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified BackendService resource.", +"flatPath": "projects/{project}/global/backendServices/{backendService}", +"httpMethod": "DELETE", +"id": "compute.backendServices.delete", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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" +}, +"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}/global/backendServices/{backendService}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteSignedUrlKey": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a key for validating requests with signed URLs for this backend\nservice.", +"flatPath": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", +"httpMethod": "POST", +"id": "compute.backendServices.deleteSignedUrlKey", +"parameterOrder": [ +"project", +"backendService", +"keyName" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the Signed URL Key should be\nadded. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"keyName": { +"description": "The name of the Signed URL Key to delete.", +"location": "query", +"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. 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}/global/backendServices/{backendService}/deleteSignedUrlKey", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified BackendService resource.", +"flatPath": "projects/{project}/global/backendServices/{backendService}", +"httpMethod": "GET", +"id": "compute.backendServices.get", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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" +} +}, +"path": "projects/{project}/global/backendServices/{backendService}", +"response": { +"$ref": "BackendService" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getEffectiveSecurityPolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Returns effective security policies applied to this backend service.", +"flatPath": "projects/{project}/global/backendServices/{backendService}/getEffectiveSecurityPolicies", +"httpMethod": "GET", +"id": "compute.backendServices.getEffectiveSecurityPolicies", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the Backend Service for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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" +} +}, +"path": "projects/{project}/global/backendServices/{backendService}/getEffectiveSecurityPolicies", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the most recent health check results for this\nBackendService.\n\nExample request body:\n\n{\n \"group\": \"/zones/us-east1-b/instanceGroups/lb-backend-example\"\n}", +"flatPath": "projects/{project}/global/backendServices/{backendService}/getHealth", +"httpMethod": "POST", +"id": "compute.backendServices.getHealth", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the queried instance belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"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/backendServices/{backendService}/getHealth", +"request": { +"$ref": "ResourceGroupReference" +}, +"response": { +"$ref": "BackendServiceGroupHealth" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/backendServices/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.backendServices.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/backendServices/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a BackendService resource in the specified project using\nthe data included in the request. For more information, see\nBackend services overview.", +"flatPath": "projects/{project}/global/backendServices", +"httpMethod": "POST", +"id": "compute.backendServices.insert", +"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" +} +}, +"path": "projects/{project}/global/backendServices", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of BackendService resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/backendServices", +"httpMethod": "GET", +"id": "compute.backendServices.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendServices", +"response": { +"$ref": "BackendServiceList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listUsable": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of all usable backend services for Application Load\nBalancers and Proxy Network Load Balancers in the specified project.\nBackend services for external and internal passthrough Network Load\nBalancers are not included in the response.", +"flatPath": "projects/{project}/global/backendServices/listUsable", +"httpMethod": "GET", +"id": "compute.backendServices.listUsable", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendServices/listUsable", +"response": { +"$ref": "BackendServiceListUsable" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified BackendService resource with the data included in the\nrequest. For more information, see \nBackend services overview. This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/backendServices/{backendService}", +"httpMethod": "PATCH", +"id": "compute.backendServices.patch", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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" +}, +"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" +} +}, +"path": "projects/{project}/global/backendServices/{backendService}", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setEdgeSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the edge security policy for the specified backend service.", +"flatPath": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", +"httpMethod": "POST", +"id": "compute.backendServices.setEdgeSecurityPolicy", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the edge security policy\nshould be set. The name 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. 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}/global/backendServices/{backendService}/setEdgeSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/backendServices/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.backendServices.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/backendServices/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Google Cloud Armor security policy for the specified backend\nservice. For more information, seeGoogle\nCloud Armor Overview", +"flatPath": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", +"httpMethod": "POST", +"id": "compute.backendServices.setSecurityPolicy", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the security policy should be\nset. The name 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. 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}/global/backendServices/{backendService}/setSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/backendServices/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.backendServices.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/backendServices/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified BackendService resource with the data included in the\nrequest. For more information, seeBackend\nservices overview.", +"flatPath": "projects/{project}/global/backendServices/{backendService}", +"httpMethod": "PUT", +"id": "compute.backendServices.update", +"parameterOrder": [ +"project", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to update.", +"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" +}, +"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}/global/backendServices/{backendService}", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"crossSiteNetworks": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified cross-site network in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"httpMethod": "DELETE", +"id": "compute.crossSiteNetworks.delete", +"parameterOrder": [ +"project", +"crossSiteNetwork" +], +"parameters": { +"crossSiteNetwork": { +"description": "Name of the cross-site network 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified cross-site network in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"httpMethod": "GET", +"id": "compute.crossSiteNetworks.get", +"parameterOrder": [ +"project", +"crossSiteNetwork" +], +"parameters": { +"crossSiteNetwork": { +"description": "Name of the cross-site network 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" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"response": { +"$ref": "CrossSiteNetwork" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a cross-site network in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/global/crossSiteNetworks", +"httpMethod": "POST", +"id": "compute.crossSiteNetworks.insert", +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"validateOnly": { +"description": "[Input Only] Validate the new configuration, but don't create it.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/crossSiteNetworks", +"request": { +"$ref": "CrossSiteNetwork" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the cross-site networks for a project in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks", +"httpMethod": "GET", +"id": "compute.crossSiteNetworks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/crossSiteNetworks", +"response": { +"$ref": "CrossSiteNetworkList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified cross-site network with the data included in\nthe request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"httpMethod": "PATCH", +"id": "compute.crossSiteNetworks.patch", +"parameterOrder": [ +"project", +"crossSiteNetwork" +], +"parameters": { +"crossSiteNetwork": { +"description": "Name of the cross-site network to update.", +"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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"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" +}, +"validateOnly": { +"description": "[Input Only] Validate the new configuration, but don't update it.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", +"request": { +"$ref": "CrossSiteNetwork" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"diskTypes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of disk types.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/diskTypes", +"httpMethod": "GET", +"id": "compute.diskTypes.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": "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" +}, +"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/diskTypes", +"response": { +"$ref": "DiskTypeAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified disk type.", +"flatPath": "projects/{project}/zones/{zone}/diskTypes/{diskType}", +"httpMethod": "GET", +"id": "compute.diskTypes.get", +"parameterOrder": [ +"project", +"zone", +"diskType" +], +"parameters": { +"diskType": { +"description": "Name of the disk type 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/diskTypes/{diskType}", +"response": { +"$ref": "DiskType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of disk types available to the specified\nproject.", +"flatPath": "projects/{project}/zones/{zone}/diskTypes", +"httpMethod": "GET", +"id": "compute.diskTypes.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/diskTypes", +"response": { +"$ref": "DiskTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"disks": { +"methods": { +"addResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Adds existing resource policies to a disk. You can only add one\npolicy which will be applied to this disk for scheduling snapshot\ncreation.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", +"httpMethod": "POST", +"id": "compute.disks.addResourcePolicies", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", +"request": { +"$ref": "DisksAddResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of persistent disks.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/disks", +"httpMethod": "GET", +"id": "compute.disks.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": "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" +}, +"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/disks", +"response": { +"$ref": "DiskAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"bulkInsert": { +"apiVersion": "2026-10-01-preview", +"description": "Bulk create a set of disks.", +"flatPath": "projects/{project}/zones/{zone}/disks/bulkInsert", +"httpMethod": "POST", +"id": "compute.disks.bulkInsert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/bulkInsert", +"request": { +"$ref": "BulkInsertDiskResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"bulkSetLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on many disks at once. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/zones/{zone}/disks/bulkSetLabels", +"httpMethod": "POST", +"id": "compute.disks.bulkSetLabels", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/bulkSetLabels", +"request": { +"$ref": "BulkZoneSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"createSnapshot": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a snapshot of a specified persistent disk. For regular snapshot\ncreation, consider using snapshots.insert\ninstead, as that method supports more features, such as creating snapshots\nin a project different from the source disk project.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", +"httpMethod": "POST", +"id": "compute.disks.createSnapshot", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the persistent disk to snapshot.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"guestFlush": { +"description": "[Input Only] Whether to attempt an application consistent snapshot by\ninforming the OS to prepare for the snapshot process.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", +"request": { +"$ref": "Snapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified persistent disk. Deleting a disk removes its data\npermanently and is irreversible. However, deleting a disk does not\ndelete any snapshots\npreviously made from the disk. You must separatelydelete\nsnapshots.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}", +"httpMethod": "DELETE", +"id": "compute.disks.delete", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the persistent disk to delete.", +"location": "path", +"pattern": "\\S{1,66}", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified persistent disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}", +"httpMethod": "GET", +"id": "compute.disks.get", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the persistent disk 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}", +"response": { +"$ref": "Disk" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.disks.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a persistent disk in the specified project using the data\nin the request. You can create a disk from a source\n(sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by\nomitting all properties. You can also create a disk that is larger than\nthe default size by specifying the sizeGb property.", +"flatPath": "projects/{project}/zones/{zone}/disks", +"httpMethod": "POST", +"id": "compute.disks.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"sourceImage": { +"description": "Source image to restore onto a disk. This field is optional.", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks", +"request": { +"$ref": "Disk" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of persistent disks contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/disks", +"httpMethod": "GET", +"id": "compute.disks.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks", +"response": { +"$ref": "DiskList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"removeResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Removes resource policies from a disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", +"httpMethod": "POST", +"id": "compute.disks.removeResourcePolicies", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", +"request": { +"$ref": "DisksRemoveResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resize": { +"apiVersion": "2026-10-01-preview", +"description": "Resizes the specified persistent disk.\nYou can only increase the size of the disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/resize", +"httpMethod": "POST", +"id": "compute.disks.resize", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The name of the persistent disk.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/resize", +"request": { +"$ref": "DisksResizeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.disks.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a disk. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.disks.setLabels", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"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.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", +"request": { +"$ref": "ZoneSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"startAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Starts asynchronous replication.\nMust be invoked on the primary disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", +"httpMethod": "POST", +"id": "compute.disks.startAsyncReplication", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The name of the persistent disk.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", +"request": { +"$ref": "DisksStartAsyncReplicationRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Stops asynchronous replication.\nCan be invoked either on the primary or on the secondary disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", +"httpMethod": "POST", +"id": "compute.disks.stopAsyncReplication", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The name of the persistent disk.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopGroupAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Stops asynchronous replication for a consistency group of disks.\nCan be invoked either in the primary or secondary scope.", +"flatPath": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", +"httpMethod": "POST", +"id": "compute.disks.stopGroupAsyncReplication", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request. This must be the zone of the primary\nor secondary disks in the consistency group.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", +"request": { +"$ref": "DisksStopGroupAsyncReplicationResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.disks.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{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": { +"apiVersion": "2026-10-01-preview", +"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", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"paths": { +"location": "query", +"repeated": 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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}", +"request": { +"$ref": "Disk" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateKmsKey": { +"apiVersion": "2026-10-01-preview", +"description": "Rotates the customer-managed\nencryption key to the latest version for the specified persistent disk.", +"flatPath": "projects/{project}/zones/{zone}/disks/{disk}/updateKmsKey", +"httpMethod": "POST", +"id": "compute.disks.updateKmsKey", +"parameterOrder": [ +"project", +"zone", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the Disk resource, 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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/disks/{disk}/updateKmsKey", +"request": { +"$ref": "DiskUpdateKmsKeyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"externalVpnGateways": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified externalVpnGateway.", +"flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", +"httpMethod": "DELETE", +"id": "compute.externalVpnGateways.delete", +"parameterOrder": [ +"project", +"externalVpnGateway" +], +"parameters": { +"externalVpnGateway": { +"description": "Name of the externalVpnGateways to delete.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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. 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}/global/externalVpnGateways/{externalVpnGateway}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified externalVpnGateway. Get a list of available\nexternalVpnGateways by making a list() request.", +"flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", +"httpMethod": "GET", +"id": "compute.externalVpnGateways.get", +"parameterOrder": [ +"project", +"externalVpnGateway" +], +"parameters": { +"externalVpnGateway": { +"description": "Name of the externalVpnGateway to return.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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" +} +}, +"path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", +"response": { +"$ref": "ExternalVpnGateway" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a ExternalVpnGateway in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/externalVpnGateways", +"httpMethod": "POST", +"id": "compute.externalVpnGateways.insert", +"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" +} +}, +"path": "projects/{project}/global/externalVpnGateways", +"request": { +"$ref": "ExternalVpnGateway" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of ExternalVpnGateway available to the specified\nproject.", +"flatPath": "projects/{project}/global/externalVpnGateways", +"httpMethod": "GET", +"id": "compute.externalVpnGateways.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/externalVpnGateways", +"response": { +"$ref": "ExternalVpnGatewayList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on an ExternalVpnGateway. To learn more about labels,\nread the Labeling\nResources documentation.", +"flatPath": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.externalVpnGateways.setLabels", +"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/externalVpnGateways/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.externalVpnGateways.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/externalVpnGateways/{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" +] +} +} +}, +"firewallPolicies": { +"methods": { +"addAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts an association for the specified firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", +"httpMethod": "POST", +"id": "compute.firewallPolicies.addAssociation", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"replaceExistingAssociation": { +"description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", +"location": "query", +"type": "boolean" +}, +"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": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", +"request": { +"$ref": "FirewallPolicyAssociation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.firewallPolicies.addRule", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"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": "locations/global/firewallPolicies/{firewallPolicy}/addRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"cloneRules": { +"apiVersion": "2026-10-01-preview", +"description": "Copies rules to the specified firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", +"httpMethod": "POST", +"id": "compute.firewallPolicies.cloneRules", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"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" +}, +"sourceFirewallPolicy": { +"description": "The firewall policy from which to copy rules.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "DELETE", +"id": "compute.firewallPolicies.delete", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to delete.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"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": "locations/global/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "GET", +"id": "compute.firewallPolicies.get", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to get.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "FirewallPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Gets an association with the specified name.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", +"httpMethod": "GET", +"id": "compute.firewallPolicies.getAssociation", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried rule belongs.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"name": { +"description": "The name of the association to get from the firewall policy.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", +"response": { +"$ref": "FirewallPolicyAssociation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "locations/global/firewallPolicies/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.firewallPolicies.getIamPolicy", +"parameterOrder": [ +"resource" +], +"parameters": { +"optionsRequestedPolicyVersion": { +"description": "Requested IAM Policy version.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{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" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule of the specified priority.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.firewallPolicies.getRule", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried rule belongs.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to get from the firewall policy.", +"format": "int32", +"location": "query", +"type": "integer" +} +}, +"path": "locations/global/firewallPolicies/{firewallPolicy}/getRule", +"response": { +"$ref": "FirewallPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified project using the data included in\nthe request.", +"flatPath": "locations/global/firewallPolicies", +"httpMethod": "POST", +"id": "compute.firewallPolicies.insert", +"parameters": { +"parentId": { +"description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", +"location": "query", +"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": "locations/global/firewallPolicies", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all the policies that have been configured for the specified\nfolder or organization.", +"flatPath": "locations/global/firewallPolicies", +"httpMethod": "GET", +"id": "compute.firewallPolicies.list", +"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" +}, +"parentId": { +"description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/firewallPolicies", +"response": { +"$ref": "FirewallPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listAssociations": { +"apiVersion": "2026-10-01-preview", +"description": "Lists associations of a specified target, i.e., organization or folder.", +"flatPath": "locations/global/firewallPolicies/listAssociations", +"httpMethod": "GET", +"id": "compute.firewallPolicies.listAssociations", +"parameters": { +"includeInheritedPolicies": { +"description": "If set to \"true\", the response will contain a list of all associations for\nthe containing folders and the containing organization of the target. The\nparameter has no effect if the target is an organization.", +"location": "query", +"type": "boolean" +}, +"targetResource": { +"description": "The target resource to list associations. It is an organization, or a\nfolder.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/listAssociations", +"response": { +"$ref": "FirewallPoliciesListAssociationsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"move": { +"apiVersion": "2026-10-01-preview", +"description": "Moves the specified firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/move", +"httpMethod": "POST", +"id": "compute.firewallPolicies.move", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"parentId": { +"description": "The new parent of the firewall policy. The ID can be either be\n\"folders/[FOLDER_ID]\" if the parent is a folder or\n\"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", +"location": "query", +"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": "locations/global/firewallPolicies/{firewallPolicy}/move", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "PATCH", +"id": "compute.firewallPolicies.patch", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"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": "locations/global/firewallPolicies/{firewallPolicy}", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule of the specified priority.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.firewallPolicies.patchRule", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to patch.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"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": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Removes an association for the specified firewall policy.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", +"httpMethod": "POST", +"id": "compute.firewallPolicies.removeAssociation", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"name": { +"description": "Name for the attachment that will be removed.", +"location": "query", +"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": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule of the specified priority.", +"flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.firewallPolicies.removeRule", +"parameterOrder": [ +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to remove from the firewall policy.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"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": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "locations/global/firewallPolicies/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.firewallPolicies.setIamPolicy", +"parameterOrder": [ +"resource" +], +"parameters": { +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalOrganizationSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "locations/global/firewallPolicies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.firewallPolicies.testIamPermissions", +"parameterOrder": [ +"resource" +], +"parameters": { +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "(firewallPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/firewallPolicies/{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" +] +} +} +}, +"firewalls": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified firewall.", +"flatPath": "projects/{project}/global/firewalls/{firewall}", +"httpMethod": "DELETE", +"id": "compute.firewalls.delete", +"parameterOrder": [ +"project", +"firewall" +], +"parameters": { +"firewall": { +"description": "Name of the firewall rule 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" +}, +"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}/global/firewalls/{firewall}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified firewall.", +"flatPath": "projects/{project}/global/firewalls/{firewall}", +"httpMethod": "GET", +"id": "compute.firewalls.get", +"parameterOrder": [ +"project", +"firewall" +], +"parameters": { +"firewall": { +"description": "Name of the firewall rule 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" +} +}, +"path": "projects/{project}/global/firewalls/{firewall}", +"response": { +"$ref": "Firewall" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a firewall rule in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/firewalls", +"httpMethod": "POST", +"id": "compute.firewalls.insert", +"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" +} +}, +"path": "projects/{project}/global/firewalls", +"request": { +"$ref": "Firewall" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of firewall rules available to the specified\nproject.", +"flatPath": "projects/{project}/global/firewalls", +"httpMethod": "GET", +"id": "compute.firewalls.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/firewalls", +"response": { +"$ref": "FirewallList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified firewall rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/firewalls/{firewall}", +"httpMethod": "PATCH", +"id": "compute.firewalls.patch", +"parameterOrder": [ +"project", +"firewall" +], +"parameters": { +"firewall": { +"description": "Name of the firewall rule 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" +}, +"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" +} +}, +"path": "projects/{project}/global/firewalls/{firewall}", +"request": { +"$ref": "Firewall" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/firewalls/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.firewalls.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/firewalls/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified firewall rule with the data included in the\nrequest.\nNote that all fields will be updated if using PUT, even fields that are not\nspecified. To update individual fields, please use PATCH instead.", +"flatPath": "projects/{project}/global/firewalls/{firewall}", +"httpMethod": "PUT", +"id": "compute.firewalls.update", +"parameterOrder": [ +"project", +"firewall" +], +"parameters": { +"firewall": { +"description": "Name of the firewall rule to update.", +"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" +}, +"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}/global/firewalls/{firewall}", +"request": { +"$ref": "Firewall" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"forwardingRules": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of forwarding rules.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/forwardingRules", +"httpMethod": "GET", +"id": "compute.forwardingRules.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": "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" +}, +"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/forwardingRules", +"response": { +"$ref": "ForwardingRuleAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified ForwardingRule resource.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", +"httpMethod": "DELETE", +"id": "compute.forwardingRules.delete", +"parameterOrder": [ +"project", +"region", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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}/forwardingRules/{forwardingRule}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified ForwardingRule resource.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", +"httpMethod": "GET", +"id": "compute.forwardingRules.get", +"parameterOrder": [ +"project", +"region", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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" +}, +"view": { +"enum": [ +"BASIC", +"FULL" +], +"enumDescriptions": [ +"The default view of a ForwardingRule, which includes the basic fields.", +"The full view, including the ForwardingRule.`attached_extensions` field." +], +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", +"response": { +"$ref": "ForwardingRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a ForwardingRule resource in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules", +"httpMethod": "POST", +"id": "compute.forwardingRules.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}/forwardingRules", +"request": { +"$ref": "ForwardingRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of ForwardingRule resources available to the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules", +"httpMethod": "GET", +"id": "compute.forwardingRules.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" +} +}, +"path": "projects/{project}/regions/{region}/forwardingRules", +"response": { +"$ref": "ForwardingRuleList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified forwarding rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules. Currently, you can only\npatch the network_tier field.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", +"httpMethod": "PATCH", +"id": "compute.forwardingRules.patch", +"parameterOrder": [ +"project", +"region", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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" +}, +"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}/forwardingRules/{forwardingRule}", +"request": { +"$ref": "ForwardingRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on the specified resource. To learn more about labels,\nread the \nLabeling Resources documentation.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.forwardingRules.setLabels", +"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 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" +}, +"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}/forwardingRules/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setTarget": { +"apiVersion": "2026-10-01-preview", +"description": "Changes target URL for forwarding rule. The new target should be of the\nsame type as the old target.", +"flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", +"httpMethod": "POST", +"id": "compute.forwardingRules.setTarget", +"parameterOrder": [ +"project", +"region", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule resource in which target is to be set.", +"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}/forwardingRules/{forwardingRule}/setTarget", +"request": { +"$ref": "TargetReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"futureReservations": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of future reservations.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/futureReservations", +"httpMethod": "GET", +"id": "compute.futureReservations.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": "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" +}, +"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/futureReservations", +"response": { +"$ref": "FutureReservationsAggregatedListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"cancel": { +"apiVersion": "2026-10-01-preview", +"description": "Cancel the specified future reservation.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", +"httpMethod": "POST", +"id": "compute.futureReservations.cancel", +"parameterOrder": [ +"project", +"zone", +"futureReservation" +], +"parameters": { +"futureReservation": { +"description": "Name of the future reservation to retrieve. Name 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. 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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified future reservation.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"httpMethod": "DELETE", +"id": "compute.futureReservations.delete", +"parameterOrder": [ +"project", +"zone", +"futureReservation" +], +"parameters": { +"futureReservation": { +"description": "Name of the future reservation to retrieve. Name 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. 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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified future reservation.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"httpMethod": "GET", +"id": "compute.futureReservations.get", +"parameterOrder": [ +"project", +"zone", +"futureReservation" +], +"parameters": { +"futureReservation": { +"description": "Name of the future reservation to retrieve. Name 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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"response": { +"$ref": "FutureReservation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new Future Reservation.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations", +"httpMethod": "POST", +"id": "compute.futureReservations.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations", +"request": { +"$ref": "FutureReservation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "A list of all the future reservations that have been configured for the\nspecified project in specified zone.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations", +"httpMethod": "GET", +"id": "compute.futureReservations.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations", +"response": { +"$ref": "FutureReservationsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified future reservation.", +"flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"httpMethod": "PATCH", +"id": "compute.futureReservations.update", +"parameterOrder": [ +"project", +"zone", +"futureReservation" +], +"parameters": { +"futureReservation": { +"description": "Name of the reservation to update. Name 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. 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" +}, +"zone": { +"description": "Name of the zone for this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", +"request": { +"$ref": "FutureReservation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"globalAddresses": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified address resource.", +"flatPath": "projects/{project}/global/addresses/{address}", +"httpMethod": "DELETE", +"id": "compute.globalAddresses.delete", +"parameterOrder": [ +"project", +"address" +], +"parameters": { +"address": { +"description": "Name of the address 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" +}, +"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}/global/addresses/{address}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified address resource.", +"flatPath": "projects/{project}/global/addresses/{address}", +"httpMethod": "GET", +"id": "compute.globalAddresses.get", +"parameterOrder": [ +"project", +"address" +], +"parameters": { +"address": { +"description": "Name of the address 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" +} +}, +"path": "projects/{project}/global/addresses/{address}", +"response": { +"$ref": "Address" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an address resource in the specified project by using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/addresses", +"httpMethod": "POST", +"id": "compute.globalAddresses.insert", +"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" +} +}, +"path": "projects/{project}/global/addresses", +"request": { +"$ref": "Address" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of global addresses.", +"flatPath": "projects/{project}/global/addresses", +"httpMethod": "GET", +"id": "compute.globalAddresses.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/addresses", +"response": { +"$ref": "AddressList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"move": { +"apiVersion": "2026-10-01-preview", +"description": "Moves the specified address resource from one project to another project.", +"flatPath": "projects/{project}/global/addresses/{address}/move", +"httpMethod": "POST", +"id": "compute.globalAddresses.move", +"parameterOrder": [ +"project", +"address" +], +"parameters": { +"address": { +"description": "Name of the address resource to move.", +"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": "Source project ID which the Address is moved from.", +"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" +} +}, +"path": "projects/{project}/global/addresses/{address}/move", +"request": { +"$ref": "GlobalAddressesMoveRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/global/addresses/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.globalAddresses.setLabels", +"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/addresses/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/addresses/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.globalAddresses.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/addresses/{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" +] +} +} +}, +"globalForwardingRules": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified GlobalForwardingRule resource.", +"flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", +"httpMethod": "DELETE", +"id": "compute.globalForwardingRules.delete", +"parameterOrder": [ +"project", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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" +}, +"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}/global/forwardingRules/{forwardingRule}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified GlobalForwardingRule resource. Gets a list of\navailable forwarding rules by making a list() request.", +"flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", +"httpMethod": "GET", +"id": "compute.globalForwardingRules.get", +"parameterOrder": [ +"project", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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" +}, +"view": { +"enum": [ +"BASIC", +"FULL" +], +"enumDescriptions": [ +"The default view of a ForwardingRule, which includes the basic fields.", +"The full view, including the ForwardingRule.`attached_extensions` field." +], +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/forwardingRules/{forwardingRule}", +"response": { +"$ref": "ForwardingRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a GlobalForwardingRule resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/forwardingRules", +"httpMethod": "POST", +"id": "compute.globalForwardingRules.insert", +"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" +} +}, +"path": "projects/{project}/global/forwardingRules", +"request": { +"$ref": "ForwardingRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of GlobalForwardingRule resources available to the\nspecified project.", +"flatPath": "projects/{project}/global/forwardingRules", +"httpMethod": "GET", +"id": "compute.globalForwardingRules.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/forwardingRules", +"response": { +"$ref": "ForwardingRuleList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified forwarding rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules. Currently, you can only\npatch the network_tier field.", +"flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", +"httpMethod": "PATCH", +"id": "compute.globalForwardingRules.patch", +"parameterOrder": [ +"project", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule 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" +}, +"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" +} +}, +"path": "projects/{project}/global/forwardingRules/{forwardingRule}", +"request": { +"$ref": "ForwardingRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on the specified resource. To learn more about labels,\nread the \nLabeling resources documentation.", +"flatPath": "projects/{project}/global/forwardingRules/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.globalForwardingRules.setLabels", +"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/forwardingRules/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setTarget": { +"apiVersion": "2026-10-01-preview", +"description": "Changes target URL for the GlobalForwardingRule resource. The new target\nshould be of the same type as the old target.", +"flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", +"httpMethod": "POST", +"id": "compute.globalForwardingRules.setTarget", +"parameterOrder": [ +"project", +"forwardingRule" +], +"parameters": { +"forwardingRule": { +"description": "Name of the ForwardingRule resource in which target is to be set.", +"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" +}, +"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}/global/forwardingRules/{forwardingRule}/setTarget", +"request": { +"$ref": "TargetReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"globalFrontendSettings": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the Global Frontend Billing Bundle Settings for a project.", +"flatPath": "projects/{project}/global/globalFrontendSettings", +"httpMethod": "GET", +"id": "compute.globalFrontendSettings.get", +"parameterOrder": [ +"project" +], +"parameters": { +"project": { +"description": "Required. Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/globalFrontendSettings", +"response": { +"$ref": "GlobalFrontendSettings" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the Global Frontend Billing Bundle Settings for a project.", +"flatPath": "projects/{project}/global/globalFrontendSettings", +"httpMethod": "PATCH", +"id": "compute.globalFrontendSettings.patch", +"parameterOrder": [ +"project" +], +"parameters": { +"project": { +"description": "Required. Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests.", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "Field mask to support patch. E.g., \"type\".", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/globalFrontendSettings", +"request": { +"$ref": "GlobalFrontendSettings" +}, +"response": { +"$ref": "GlobalFrontendSettingsPatchResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"globalNetworkEndpointGroups": { +"methods": { +"attachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Attach a network endpoint to the specified network endpoint group.", +"flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.globalNetworkEndpointGroups.attachNetworkEndpoints", +"parameterOrder": [ +"project", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should 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" +}, +"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}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"request": { +"$ref": "GlobalNetworkEndpointGroupsAttachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified network endpoint group.Note that the NEG cannot be\ndeleted if there are backend services referencing it.", +"flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "DELETE", +"id": "compute.globalNetworkEndpointGroups.delete", +"parameterOrder": [ +"project", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", +"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. 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}/global/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"detachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Detach the network endpoint from the specified network endpoint group.", +"flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.globalNetworkEndpointGroups.detachNetworkEndpoints", +"parameterOrder": [ +"project", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group where you are removing network\nendpoints. It should 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" +}, +"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}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"request": { +"$ref": "GlobalNetworkEndpointGroupsDetachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network endpoint group.", +"flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "GET", +"id": "compute.globalNetworkEndpointGroups.get", +"parameterOrder": [ +"project", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group. It should 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" +} +}, +"path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "NetworkEndpointGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", +"flatPath": "projects/{project}/global/networkEndpointGroups", +"httpMethod": "POST", +"id": "compute.globalNetworkEndpointGroups.insert", +"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" +} +}, +"path": "projects/{project}/global/networkEndpointGroups", +"request": { +"$ref": "NetworkEndpointGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of network endpoint groups that are located in the\nspecified project.", +"flatPath": "projects/{project}/global/networkEndpointGroups", +"httpMethod": "GET", +"id": "compute.globalNetworkEndpointGroups.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/networkEndpointGroups", +"response": { +"$ref": "NetworkEndpointGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the network endpoints in the specified network endpoint group.", +"flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.globalNetworkEndpointGroups.listNetworkEndpoints", +"parameterOrder": [ +"project", +"networkEndpointGroup" +], +"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" +}, +"networkEndpointGroup": { +"description": "The name of the network endpoint group from which you want to generate a\nlist of included network endpoints. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"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" +} +}, +"path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"response": { +"$ref": "NetworkEndpointGroupsListNetworkEndpoints" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"globalOperations": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of all operations.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/operations", +"httpMethod": "GET", +"id": "compute.globalOperations.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": "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" +}, +"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/operations", +"response": { +"$ref": "OperationAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Operations resource.", +"flatPath": "projects/{project}/global/operations/{operation}", +"httpMethod": "DELETE", +"id": "compute.globalOperations.delete", +"parameterOrder": [ +"project", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", +"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" +} +}, +"path": "projects/{project}/global/operations/{operation}", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the specified Operations resource.", +"flatPath": "projects/{project}/global/operations/{operation}", +"httpMethod": "GET", +"id": "compute.globalOperations.get", +"parameterOrder": [ +"project", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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" +} +}, +"path": "projects/{project}/global/operations/{operation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Operation resources contained within the specified\nproject.", +"flatPath": "projects/{project}/global/operations", +"httpMethod": "GET", +"id": "compute.globalOperations.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/operations", +"response": { +"$ref": "OperationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"wait": { +"apiVersion": "2026-10-01-preview", +"description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method differs from the\n`GET` method in that it waits for no more than the default\ndeadline (2 minutes) and then returns the current state of the operation,\nwhich might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", +"flatPath": "projects/{project}/global/operations/{operation}/wait", +"httpMethod": "POST", +"id": "compute.globalOperations.wait", +"parameterOrder": [ +"project", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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" +} +}, +"path": "projects/{project}/global/operations/{operation}/wait", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"globalOrganizationOperations": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Operations resource.", +"flatPath": "locations/global/operations/{operation}", +"httpMethod": "DELETE", +"id": "compute.globalOrganizationOperations.delete", +"parameterOrder": [ +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"parentId": { +"description": "Parent ID for this request.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/operations/{operation}", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the specified Operations resource. Gets a list of operations\nby making a `list()` request.", +"flatPath": "locations/global/operations/{operation}", +"httpMethod": "GET", +"id": "compute.globalOrganizationOperations.get", +"parameterOrder": [ +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return. Parent is derived from this\nfield.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"parentId": { +"description": "Parent ID for this request. Not used. Parent is derived from resource_id.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/operations/{operation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Operation resources contained within the specified\norganization.", +"flatPath": "locations/global/operations", +"httpMethod": "GET", +"id": "compute.globalOrganizationOperations.list", +"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" +}, +"parentId": { +"description": "Parent ID for this request.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/operations", +"response": { +"$ref": "OperationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"globalPublicDelegatedPrefixes": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified global PublicDelegatedPrefix.", +"flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "DELETE", +"id": "compute.globalPublicDelegatedPrefixes.delete", +"parameterOrder": [ +"project", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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" +}, +"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}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified global PublicDelegatedPrefix resource.", +"flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "GET", +"id": "compute.globalPublicDelegatedPrefixes.get", +"parameterOrder": [ +"project", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"response": { +"$ref": "PublicDelegatedPrefix" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a global PublicDelegatedPrefix in the specified project using the\nparameters that are included in the request.", +"flatPath": "projects/{project}/global/publicDelegatedPrefixes", +"httpMethod": "POST", +"id": "compute.globalPublicDelegatedPrefixes.insert", +"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" +} +}, +"path": "projects/{project}/global/publicDelegatedPrefixes", +"request": { +"$ref": "PublicDelegatedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the global PublicDelegatedPrefixes for a project.", +"flatPath": "projects/{project}/global/publicDelegatedPrefixes", +"httpMethod": "GET", +"id": "compute.globalPublicDelegatedPrefixes.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/publicDelegatedPrefixes", +"response": { +"$ref": "PublicDelegatedPrefixList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified global PublicDelegatedPrefix resource with the data\nincluded in the request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "PATCH", +"id": "compute.globalPublicDelegatedPrefixes.patch", +"parameterOrder": [ +"project", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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" +}, +"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}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"request": { +"$ref": "PublicDelegatedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"globalVmExtensionPolicies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all VM Extension Policy resources\navailable to the specified project.\n\nTo prevent failure, it's recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/vmExtensionPolicies", +"httpMethod": "GET", +"id": "compute.globalVmExtensionPolicies.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" +}, +"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/vmExtensionPolicies", +"response": { +"$ref": "VmExtensionPolicyAggregatedListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Purge scoped resources (zonal policies) from a global VM extension\npolicy, and then delete the global VM extension policy. Purge of the scoped\nresources is a pre-condition of the global VM extension policy deletion.\nThe deletion of the global VM extension policy happens after the purge\nrollout is done, so it's not a part of the LRO. It's an automatic process\nthat triggers in the backend.", +"flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}/delete", +"httpMethod": "POST", +"id": "compute.globalVmExtensionPolicies.delete", +"parameterOrder": [ +"project", +"globalVmExtensionPolicy" +], +"parameters": { +"globalVmExtensionPolicy": { +"description": "Name of the global VM extension policy to purge scoped resources for.", +"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. 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}/global/vmExtensionPolicies/{globalVmExtensionPolicy}/delete", +"request": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutInput" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets details of a global VM extension policy.", +"flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", +"httpMethod": "GET", +"id": "compute.globalVmExtensionPolicies.get", +"parameterOrder": [ +"project", +"globalVmExtensionPolicy" +], +"parameters": { +"globalVmExtensionPolicy": { +"description": "Name of the GlobalVmExtensionPolicy 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" +} +}, +"path": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", +"response": { +"$ref": "GlobalVmExtensionPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new project level GlobalVmExtensionPolicy.", +"flatPath": "projects/{project}/global/vmExtensionPolicies", +"httpMethod": "POST", +"id": "compute.globalVmExtensionPolicies.insert", +"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" +} +}, +"path": "projects/{project}/global/vmExtensionPolicies", +"request": { +"$ref": "GlobalVmExtensionPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists global VM extension policies.", +"flatPath": "projects/{project}/global/vmExtensionPolicies", +"httpMethod": "GET", +"id": "compute.globalVmExtensionPolicies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/vmExtensionPolicies", +"response": { +"$ref": "GlobalVmExtensionPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a global VM extension policy.", +"flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", +"httpMethod": "PATCH", +"id": "compute.globalVmExtensionPolicies.update", +"parameterOrder": [ +"project", +"globalVmExtensionPolicy" +], +"parameters": { +"globalVmExtensionPolicy": { +"description": "Name of the global VM extension policy to update.", +"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. 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}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", +"request": { +"$ref": "GlobalVmExtensionPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"haControllers": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of all of the HaControllers in the specified\nproject across all regions.", +"flatPath": "projects/{project}/aggregated/haControllers", +"httpMethod": "GET", +"id": "compute.haControllers.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": "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" +}, +"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/haControllers", +"response": { +"$ref": "HaControllersAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes an HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "DELETE", +"id": "compute.haControllers.delete", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"force": { +"description": "Force-deletes HA Controller when the Delete is stuck. Instance that is not\nprimary at the moment will also be deleted. Can only be used against the HA\nController resource that is already being deleted.", +"location": "query", +"type": "boolean" +}, +"haController": { +"description": "Name of the HaController resource to delete.", +"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 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.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"failover": { +"apiVersion": "2026-10-01-preview", +"description": "Fails over a VM targeted by the specified HaController to the selected\nzone.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}/failover", +"httpMethod": "POST", +"id": "compute.haControllers.failover", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "ID of the HaController resource to update.", +"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 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.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}/failover", +"request": { +"$ref": "HaControllersFailoverRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns all the details of a specific HaController.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "GET", +"id": "compute.haControllers.get", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "Name of the HaController 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}", +"response": { +"$ref": "HaController" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers", +"httpMethod": "POST", +"id": "compute.haControllers.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 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.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers", +"request": { +"$ref": "HaController" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all HaControllers in the specified project in the specified region.", +"flatPath": "projects/{project}/regions/{region}/haControllers", +"httpMethod": "GET", +"id": "compute.haControllers.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers", +"response": { +"$ref": "HaControllersList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "PATCH", +"id": "compute.haControllers.patch", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "ID of the HaController resource to update.", +"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 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.", +"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}/regions/{region}/haControllers/{haController}", +"request": { +"$ref": "HaController" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"healthChecks": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all HealthCheck resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/healthChecks", +"httpMethod": "GET", +"id": "compute.healthChecks.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" +}, +"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/healthChecks", +"response": { +"$ref": "HealthChecksAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HealthCheck resource.", +"flatPath": "projects/{project}/global/healthChecks/{healthCheck}", +"httpMethod": "DELETE", +"id": "compute.healthChecks.delete", +"parameterOrder": [ +"project", +"healthCheck" +], +"parameters": { +"healthCheck": { +"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" +}, +"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}/global/healthChecks/{healthCheck}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified HealthCheck resource.", +"flatPath": "projects/{project}/global/healthChecks/{healthCheck}", +"httpMethod": "GET", +"id": "compute.healthChecks.get", +"parameterOrder": [ +"project", +"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" +} +}, +"path": "projects/{project}/global/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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/healthChecks", +"httpMethod": "POST", +"id": "compute.healthChecks.insert", +"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" +} +}, +"path": "projects/{project}/global/healthChecks", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/healthChecks", +"httpMethod": "GET", +"id": "compute.healthChecks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/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": { +"apiVersion": "2026-10-01-preview", +"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}/global/healthChecks/{healthCheck}", +"httpMethod": "PATCH", +"id": "compute.healthChecks.patch", +"parameterOrder": [ +"project", +"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, +"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. 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}/global/healthChecks/{healthCheck}", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/healthChecks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.healthChecks.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/healthChecks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/healthChecks/{healthCheck}", +"httpMethod": "PUT", +"id": "compute.healthChecks.update", +"parameterOrder": [ +"project", +"healthCheck" +], +"parameters": { +"healthCheck": { +"description": "Name of the HealthCheck resource to update.", +"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" +}, +"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}/global/healthChecks/{healthCheck}", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"hosts": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified host.", +"flatPath": "projects/{project}/zones/{zone}/{association}/hosts/{host}", +"httpMethod": "GET", +"id": "compute.hosts.get", +"parameterOrder": [ +"project", +"zone", +"association", +"host" +], +"parameters": { +"association": { +"description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host. For example, reservations/reservation_name,\nreservations/reservation_name/reservationBlocks/reservation_block_name or\nreservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.", +"location": "path", +"required": true, +"type": "string" +}, +"host": { +"description": "The name of the host, formatted as RFC1035 or a resource ID\nnumber.", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "The project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request, formatted as RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{association}/hosts/{host}", +"response": { +"$ref": "Host" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getVersion": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to get SBOM versions of a host.", +"flatPath": "projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion", +"httpMethod": "POST", +"id": "compute.hosts.getVersion", +"parameterOrder": [ +"project", +"zone", +"association", +"host" +], +"parameters": { +"association": { +"description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host.", +"location": "path", +"required": true, +"type": "string" +}, +"host": { +"description": "The name of the host, formatted as RFC1035 or a resource ID\nnumber.", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"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.", +"location": "query", +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion", +"request": { +"$ref": "HostsGetVersionRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of hosts.", +"flatPath": "projects/{project}/zones/{zone}/{association}/hosts", +"httpMethod": "GET", +"id": "compute.hosts.list", +"parameterOrder": [ +"project", +"zone", +"association" +], +"parameters": { +"association": { +"description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host. For example, reservations/reservation_name,\nreservations/reservation_name/reservationBlocks/reservation_block_name or\nreservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.", +"location": "path", +"required": true, +"type": "string" +}, +"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": "The project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request, formatted as RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{association}/hosts", +"response": { +"$ref": "HostsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"httpHealthChecks": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HttpHealthCheck resource.", +"flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", +"httpMethod": "DELETE", +"id": "compute.httpHealthChecks.delete", +"parameterOrder": [ +"project", +"httpHealthCheck" +], +"parameters": { +"httpHealthCheck": { +"description": "Name of the HttpHealthCheck 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" +}, +"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}/global/httpHealthChecks/{httpHealthCheck}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified HttpHealthCheck resource.", +"flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", +"httpMethod": "GET", +"id": "compute.httpHealthChecks.get", +"parameterOrder": [ +"project", +"httpHealthCheck" +], +"parameters": { +"httpHealthCheck": { +"description": "Name of the HttpHealthCheck 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" +} +}, +"path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", +"response": { +"$ref": "HttpHealthCheck" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a HttpHealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/httpHealthChecks", +"httpMethod": "POST", +"id": "compute.httpHealthChecks.insert", +"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" +} +}, +"path": "projects/{project}/global/httpHealthChecks", +"request": { +"$ref": "HttpHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of HttpHealthCheck resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/httpHealthChecks", +"httpMethod": "GET", +"id": "compute.httpHealthChecks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/httpHealthChecks", +"response": { +"$ref": "HttpHealthCheckList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HttpHealthCheck 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}/global/httpHealthChecks/{httpHealthCheck}", +"httpMethod": "PATCH", +"id": "compute.httpHealthChecks.patch", +"parameterOrder": [ +"project", +"httpHealthCheck" +], +"parameters": { +"httpHealthCheck": { +"description": "Name of the HttpHealthCheck 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" +}, +"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" +} +}, +"path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", +"request": { +"$ref": "HttpHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/httpHealthChecks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.httpHealthChecks.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/httpHealthChecks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HttpHealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", +"httpMethod": "PUT", +"id": "compute.httpHealthChecks.update", +"parameterOrder": [ +"project", +"httpHealthCheck" +], +"parameters": { +"httpHealthCheck": { +"description": "Name of the HttpHealthCheck resource to update.", +"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" +}, +"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}/global/httpHealthChecks/{httpHealthCheck}", +"request": { +"$ref": "HttpHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"httpsHealthChecks": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HttpsHealthCheck resource.", +"flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", +"httpMethod": "DELETE", +"id": "compute.httpsHealthChecks.delete", +"parameterOrder": [ +"project", +"httpsHealthCheck" +], +"parameters": { +"httpsHealthCheck": { +"description": "Name of the HttpsHealthCheck 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" +}, +"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}/global/httpsHealthChecks/{httpsHealthCheck}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified HttpsHealthCheck resource.", +"flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", +"httpMethod": "GET", +"id": "compute.httpsHealthChecks.get", +"parameterOrder": [ +"project", +"httpsHealthCheck" +], +"parameters": { +"httpsHealthCheck": { +"description": "Name of the HttpsHealthCheck 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" +} +}, +"path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", +"response": { +"$ref": "HttpsHealthCheck" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a HttpsHealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/httpsHealthChecks", +"httpMethod": "POST", +"id": "compute.httpsHealthChecks.insert", +"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" +} +}, +"path": "projects/{project}/global/httpsHealthChecks", +"request": { +"$ref": "HttpsHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of HttpsHealthCheck resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/httpsHealthChecks", +"httpMethod": "GET", +"id": "compute.httpsHealthChecks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/httpsHealthChecks", +"response": { +"$ref": "HttpsHealthCheckList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HttpsHealthCheck 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}/global/httpsHealthChecks/{httpsHealthCheck}", +"httpMethod": "PATCH", +"id": "compute.httpsHealthChecks.patch", +"parameterOrder": [ +"project", +"httpsHealthCheck" +], +"parameters": { +"httpsHealthCheck": { +"description": "Name of the HttpsHealthCheck 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" +}, +"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" +} +}, +"path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", +"request": { +"$ref": "HttpsHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/httpsHealthChecks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.httpsHealthChecks.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/httpsHealthChecks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HttpsHealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", +"httpMethod": "PUT", +"id": "compute.httpsHealthChecks.update", +"parameterOrder": [ +"project", +"httpsHealthCheck" +], +"parameters": { +"httpsHealthCheck": { +"description": "Name of the HttpsHealthCheck resource to update.", +"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" +}, +"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}/global/httpsHealthChecks/{httpsHealthCheck}", +"request": { +"$ref": "HttpsHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"imageFamilyViews": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the latest image that is part of an image family, is not\ndeprecated and is rolled out in the specified zone.", +"flatPath": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", +"httpMethod": "GET", +"id": "compute.imageFamilyViews.get", +"parameterOrder": [ +"project", +"zone", +"family" +], +"parameters": { +"family": { +"description": "Name of the image family to search for.", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", +"response": { +"$ref": "ImageFamilyView" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"imageViews": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified global ImageView resource, with a regional\ncontext.", +"flatPath": "projects/{project}/regions/{region}/imageViews/{resourceId}", +"httpMethod": "GET", +"id": "compute.imageViews.get", +"parameterOrder": [ +"project", +"region", +"resourceId" +], +"parameters": { +"project": { +"description": "Required. 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": "Required. Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"resourceId": { +"description": "Name of the image 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}/regions/{region}/imageViews/{resourceId}", +"response": { +"$ref": "ImageView" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Returns a list of global ImageView resources, with a regional\ncontext.", +"flatPath": "projects/{project}/regions/{region}/imageViews", +"httpMethod": "GET", +"id": "compute.imageViews.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": "Required. 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": "Required. Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/imageViews", +"response": { +"$ref": "ImageViewsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"images": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified image.", +"flatPath": "projects/{project}/global/images/{image}", +"httpMethod": "DELETE", +"id": "compute.images.delete", +"parameterOrder": [ +"project", +"image" +], +"parameters": { +"image": { +"description": "Name of the image 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" +}, +"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}/global/images/{image}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deprecate": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the deprecation status of an image.\n\nIf an empty request body is given, clears the deprecation status instead.", +"flatPath": "projects/{project}/global/images/{image}/deprecate", +"httpMethod": "POST", +"id": "compute.images.deprecate", +"parameterOrder": [ +"project", +"image" +], +"parameters": { +"image": { +"description": "Image name.", +"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" +}, +"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}/global/images/{image}/deprecate", +"request": { +"$ref": "DeprecationStatus" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified image.", +"flatPath": "projects/{project}/global/images/{image}", +"httpMethod": "GET", +"id": "compute.images.get", +"parameterOrder": [ +"project", +"image" +], +"parameters": { +"image": { +"description": "Name of the image 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" +} +}, +"path": "projects/{project}/global/images/{image}", +"response": { +"$ref": "Image" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getFromFamily": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the latest image that is part of an image family and is not\ndeprecated. For more information on image families, seePublic\nimage families documentation.", +"flatPath": "projects/{project}/global/images/family/{family}", +"httpMethod": "GET", +"id": "compute.images.getFromFamily", +"parameterOrder": [ +"project", +"family" +], +"parameters": { +"family": { +"description": "Name of the image family to search for.", +"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": "The image project that the image belongs to. For example, to get a CentOS\nimage, specify centos-cloud as the image project.", +"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/images/family/{family}", +"response": { +"$ref": "Image" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/images/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.images.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/images/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an image in the specified project using the data included\nin the request.", +"flatPath": "projects/{project}/global/images", +"httpMethod": "POST", +"id": "compute.images.insert", +"parameterOrder": [ +"project" +], +"parameters": { +"forceCreate": { +"description": "Force image creation if true.", +"location": "query", +"type": "boolean" +}, +"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" +} +}, +"path": "projects/{project}/global/images", +"request": { +"$ref": "Image" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of custom images\navailable to the specified project. Custom images are images you\ncreate that belong to your project. This method does not\nget any images that belong to other projects, including publicly-available\nimages, like Debian 8. If you want to get a list of publicly-available\nimages, use this method to make a request to the respective image project,\nsuch as debian-cloud or windows-cloud.", +"flatPath": "projects/{project}/global/images", +"httpMethod": "GET", +"id": "compute.images.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/images", +"response": { +"$ref": "ImageList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified image with the data included in the request.\nOnly the following fields can be modified: family, description,\ndeprecation status.", +"flatPath": "projects/{project}/global/images/{image}", +"httpMethod": "PATCH", +"id": "compute.images.patch", +"parameterOrder": [ +"project", +"image" +], +"parameters": { +"image": { +"description": "Name of the image 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" +}, +"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" +} +}, +"path": "projects/{project}/global/images/{image}", +"request": { +"$ref": "Image" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/images/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.images.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/images/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on an image. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/global/images/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.images.setLabels", +"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/images/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/images/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.images.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/images/{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" +] +} +} +}, +"instanceGroupManagerResizeRequests": { +"methods": { +"cancel": { +"apiVersion": "2026-10-01-preview", +"description": "Cancels the specified resize request and removes it from the queue.\nCancelled resize request does no longer wait for the resources to be\nprovisioned. Cancel is only possible for requests that are accepted in the\nqueue.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", +"httpMethod": "POST", +"id": "compute.instanceGroupManagerResizeRequests.cancel", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nThe name should conform to RFC1035 or be a resource ID.", +"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. 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" +}, +"resizeRequest": { +"description": "The name of the resize request to cancel.\nThe name should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified, inactive resize request. Requests that are still\nactive cannot be deleted. Deleting request does not delete instances that\nwere provisioned previously.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"httpMethod": "DELETE", +"id": "compute.instanceGroupManagerResizeRequests.delete", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nThe name should conform to RFC1035 or be a resource ID.", +"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. 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" +}, +"resizeRequest": { +"description": "The name of the resize request to delete.\nThe name should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns all of the details about the specified resize request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"httpMethod": "GET", +"id": "compute.instanceGroupManagerResizeRequests.get", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", +"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" +}, +"resizeRequest": { +"description": "The name of the resize request.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the href=\"/compute/docs/regions-zones/#available\">zone\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"response": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new resize request that starts provisioning VMs immediately\nor queues VM creation.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"httpMethod": "POST", +"id": "compute.instanceGroupManagerResizeRequests.insert", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group to which the resize request will\nbe added.\nName should conform to RFC1035 or be a resource ID.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located and where the resize request will be created.\nName should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"request": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of resize requests that are contained in the\nmanaged instance group.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"httpMethod": "GET", +"id": "compute.instanceGroupManagerResizeRequests.list", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group. The name should conform to RFC1035.", +"location": "path", +"required": true, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"response": { +"$ref": "InstanceGroupManagerResizeRequestsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"instanceGroupManagers": { +"methods": { +"abandonInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances to be removed from the\nmanaged instance group. Abandoning an instance does not delete the\ninstance, but it does remove the instance from any target pools that are\napplied by the managed instance group. This method reduces thetargetSize of the managed instance group by the\nnumber of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have\nnot yet been removed from the group. You must separately verify the\nstatus of the abandoning action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.abandonInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", +"request": { +"$ref": "InstanceGroupManagersAbandonInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of managed instance groups and groups them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/instanceGroupManagers", +"httpMethod": "GET", +"id": "compute.instanceGroupManagers.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": "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" +}, +"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/instanceGroupManagers", +"response": { +"$ref": "InstanceGroupManagerAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"applyUpdatesToInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Applies changes to selected instances on the managed instance group.\nThis method can be used to apply new overrides and/or new versions.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.applyUpdatesToInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group, 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" +}, +"zone": { +"description": "The name of thezone\nwhere the managed instance group is located. Should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", +"request": { +"$ref": "InstanceGroupManagersApplyUpdatesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"createInstances": { +"apiVersion": "2026-10-01-preview", +"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", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.createInstances", +"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}/createInstances", +"request": { +"$ref": "InstanceGroupManagersCreateInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified managed instance group and all of the instances\nin that group. Note that the instance group must not belong to a\nbackend service. Read\nDeleting an instance group for more information.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "DELETE", +"id": "compute.instanceGroupManagers.delete", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group for immediate\ndeletion. The instances are also removed from any target\npools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of\ninstances that you delete. This operation is marked as DONE\nwhen the action is scheduled even if the instances are still being deleted.\nYou must separately verify the status of the deleting action\nwith thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.deleteInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", +"request": { +"$ref": "InstanceGroupManagersDeleteInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deletePerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes selected per-instance configurations for the managed instance\ngroup.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.deletePerInstanceConfigs", +"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" +}, +"zone": { +"description": "The name of thezone\nwhere the managed instance\ngroup is located.\nIt should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", +"request": { +"$ref": "InstanceGroupManagersDeletePerInstanceConfigsReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns all of the details about the specified managed instance group.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "GET", +"id": "compute.instanceGroupManagers.get", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"response": { +"$ref": "InstanceGroupManager" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a managed instance group using the information that you specify\nin the request. After the group is created, instances in the group are\ncreated using the specified instance template.\nThis operation is marked as DONE when the group is created\neven if the instances in the group have not yet been created. You\nmust separately verify the status of the individual instances with thelistmanagedinstances\nmethod.\n\nA managed instance group can have up to 1000 VM instances per group. Please\ncontact Cloud Support if you need an increase in\nthis limit.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone\nwhere you want to create the managed instance group.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers", +"request": { +"$ref": "InstanceGroupManager" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of managed instance groups that are contained within the\nspecified project and zone.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", +"httpMethod": "GET", +"id": "compute.instanceGroupManagers.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers", +"response": { +"$ref": "InstanceGroupManagerList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listErrors": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all errors thrown by actions on instances for a given managed\ninstance group. The filter and orderBy query\nparameters are not supported.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", +"httpMethod": "GET", +"id": "compute.instanceGroupManagers.listErrors", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group.\nIt must be a string that meets the requirements in RFC1035, or an\nunsigned long integer: must match regexp pattern:\n(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", +"location": "path", +"required": true, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.\nIt should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", +"response": { +"$ref": "InstanceGroupManagersListErrorsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listManagedInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all of the instances in the managed instance group. Each instance\nin the list has a currentAction, which indicates the action\nthat the managed instance group is performing on the instance. For example,\nif the group is still creating an instance, the currentAction\nis CREATING. If a previous action failed, the\nlist displays the errors for that failed action. The orderBy\nquery parameter is not supported. The `pageToken` query parameter is\nsupported only if the group's `listManagedInstancesResults` field is set\nto `PAGINATED`.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.listManagedInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", +"response": { +"$ref": "InstanceGroupManagersListManagedInstancesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listPerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all of the per-instance configurations defined for the managed\ninstance group. The orderBy query parameter is not supported.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.listPerInstanceConfigs", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group. It should conform to RFC1035.", +"location": "path", +"required": true, +"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" +}, +"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}/listPerInstanceConfigs", +"response": { +"$ref": "InstanceGroupManagersListPerInstanceConfigsResp" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a managed instance group using the information that you specify\nin the request.\nThis operation is marked as DONE when the group is patched\neven if the instances in the group are still in the process of being\npatched. You must separately verify the status of the individual instances\nwith thelistManagedInstances\nmethod. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.\n\nIf you update your group to specify a new template or instance\nconfiguration, it's possible that your intended specification for each VM\nin the group is different from the current state of that VM. To learn how\nto apply an updated configuration to the VMs in a MIG, seeUpdating instances in\na MIG.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "PATCH", +"id": "compute.instanceGroupManagers.patch", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the instance group manager.", +"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. 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" +}, +"zone": { +"description": "The name of the zone where\nyou want to create the managed instance group.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", +"request": { +"$ref": "InstanceGroupManager" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchPerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts or patches per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.patchPerInstanceConfigs", +"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. 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" +}, +"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}/patchPerInstanceConfigs", +"request": { +"$ref": "InstanceGroupManagersPatchPerInstanceConfigsReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"recreateInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified VM instances in the managed instance group to be\nimmediately recreated. Each instance is recreated using the group's current\nconfiguration. This operation is marked as DONE when the flag\nis set even if the instances have not yet been recreated. You must\nseparately verify the status of each instance by checking itscurrentAction field; for more information, see Checking\nthe status of managed instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.recreateInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance recreation even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", +"request": { +"$ref": "InstanceGroupManagersRecreateInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resize": { +"apiVersion": "2026-10-01-preview", +"description": "Resizes the managed instance group. If you increase the size, the group\ncreates new instances using the current instance template. If you decrease\nthe size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group\nhas not yet added or deleted any instances. You must separately\nverify the status of the creating or deleting\nactions with thelistmanagedinstances\nmethod.\n\nWhen resizing down, the instance group arbitrarily chooses the order in\nwhich VMs are deleted. The group takes into account some VM attributes when\nmaking the selection including:\n\n+ The status of the VM instance.\n+ The health of the VM instance.\n+ The instance template version the VM is based on.\n+ For regional managed instance groups, the location of the VM instance.\n\nThis list is subject to change.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.resize", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager", +"size" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"size": { +"description": "The number of running instances that the managed instance group should\nmaintain at any given time. The group automatically adds or removes\ninstances to maintain the number of instances specified by this parameter.", +"format": "int32", +"location": "query", +"required": true, +"type": "integer" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resumeInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nresumed. This method increases thetargetSize and decreases the targetSuspendedSize\nof the managed instance group by the number of instances that you resume.\nThe resumeInstances operation is marked DONE if\nthe resumeInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are suspended. For\nexample, if an instance was previously suspended using the suspendInstances\nmethod, it can be resumed using the resumeInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are resumed.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.resumeInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", +"request": { +"$ref": "InstanceGroupManagersResumeInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setInstanceTemplate": { +"apiVersion": "2026-10-01-preview", +"description": "Specifies the instance template to use when creating new instances in this\ngroup. The templates for existing instances in the group do not change\nunless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.setInstanceTemplate", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", +"request": { +"$ref": "InstanceGroupManagersSetInstanceTemplateRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setTargetPools": { +"apiVersion": "2026-10-01-preview", +"description": "Modifies the target pools to which all instances in this managed instance\ngroup are assigned. The target pools automatically apply to all of the\ninstances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not\nyet been added to their target pools. The change might take some time to\napply to all of the instances in the group depending on the size of the\ngroup.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.setTargetPools", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", +"request": { +"$ref": "InstanceGroupManagersSetTargetPoolsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"startInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nstarted. This method increases thetargetSize and decreases the targetStoppedSize\nof the managed instance group by the number of instances that you start.\nThe startInstances operation is marked DONE if\nthe startInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are stopped. For\nexample, if an instance was previously stopped using the stopInstances\nmethod, it can be started using the startInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are started.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.startInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", +"request": { +"$ref": "InstanceGroupManagersStartInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nimmediately stopped. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetStoppedSize\nof the managed instance group by the number of instances that you stop.\nThe stopInstances operation is marked DONE if\nthe stopInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays stopping the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is stopped.\n\nStopped instances can be started using the startInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.stopInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance stopping even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", +"request": { +"$ref": "InstanceGroupManagersStopInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"suspendInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nimmediately suspended. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetSuspendedSize\nof the managed instance group by the number of instances that you suspend.\nThe suspendInstances operation is marked DONE if\nthe suspendInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays suspension of the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is suspended.\n\nSuspended instances can be resumed using the resumeInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.suspendInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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. 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" +}, +"zone": { +"description": "The name of thezone where the managed\ninstance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", +"request": { +"$ref": "InstanceGroupManagersSuspendInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updatePerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts or updates per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.updatePerInstanceConfigs", +"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. 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" +}, +"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}/updatePerInstanceConfigs", +"request": { +"$ref": "InstanceGroupManagersUpdatePerInstanceConfigsReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"instanceGroups": { +"methods": { +"addInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Adds a list of instances to the specified instance group. All of the\ninstances in the instance group must be in the same network/subnetwork.\nRead \nAdding instances for more information.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", +"httpMethod": "POST", +"id": "compute.instanceGroups.addInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the instance group where you are adding instances.", +"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. 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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", +"request": { +"$ref": "InstanceGroupsAddInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of instance groups and sorts them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/instanceGroups", +"httpMethod": "GET", +"id": "compute.instanceGroups.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": "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" +}, +"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/instanceGroups", +"response": { +"$ref": "InstanceGroupAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified instance group. The instances in the group are not\ndeleted. Note that instance group must not belong to a backend service.\nRead\nDeleting an instance group for more information.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", +"httpMethod": "DELETE", +"id": "compute.instanceGroups.delete", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the instance group to delete.", +"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. 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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified zonal instance group. Get a list of available zonal\ninstance groups by making a list() request.\n\nFor managed instance groups, use theinstanceGroupManagers\nor regionInstanceGroupManagers\nmethods instead.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", +"httpMethod": "GET", +"id": "compute.instanceGroups.get", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the instance group.", +"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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", +"response": { +"$ref": "InstanceGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instance group in the specified project using the\nparameters that are included in the request.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups", +"httpMethod": "POST", +"id": "compute.instanceGroups.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone\nwhere you want to create the instance group.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups", +"request": { +"$ref": "InstanceGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of zonal instance group resources contained within the\nspecified zone.\n\nFor managed instance groups, use theinstanceGroupManagers\nor regionInstanceGroupManagers\nmethods instead.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups", +"httpMethod": "GET", +"id": "compute.instanceGroups.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of thezone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups", +"response": { +"$ref": "InstanceGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the instances in the specified instance group.\nThe orderBy query parameter is not supported.\nThe filter query parameter is supported, but only for\nexpressions that use `eq` (equal) or `ne` (not equal) operators.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", +"httpMethod": "POST", +"id": "compute.instanceGroups.listInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"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" +}, +"instanceGroup": { +"description": "The name of the instance group from which you want to generate a list\nof included instances.", +"location": "path", +"required": true, +"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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", +"request": { +"$ref": "InstanceGroupsListInstancesRequest" +}, +"response": { +"$ref": "InstanceGroupsListInstances" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"removeInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Removes one or more instances from the specified instance group, but does\nnot delete those instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration before the VM instance is removed or deleted.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", +"httpMethod": "POST", +"id": "compute.instanceGroups.removeInstances", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the instance group where the specified instances will be\nremoved.", +"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. 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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", +"request": { +"$ref": "InstanceGroupsRemoveInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setNamedPorts": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the named ports for the specified instance group.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", +"httpMethod": "POST", +"id": "compute.instanceGroups.setNamedPorts", +"parameterOrder": [ +"project", +"zone", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the instance group where the named ports are updated.", +"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. 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" +}, +"zone": { +"description": "The name of the zone\nwhere the instance group is located.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", +"request": { +"$ref": "InstanceGroupsSetNamedPortsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.instanceGroups.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroups/{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" +] +} +} +}, +"instanceSettings": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Get Instance settings.", +"flatPath": "projects/{project}/zones/{zone}/instanceSettings", +"httpMethod": "GET", +"id": "compute.instanceSettings.get", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceSettings", +"response": { +"$ref": "InstanceSettings" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patch Instance settings", +"flatPath": "projects/{project}/zones/{zone}/instanceSettings", +"httpMethod": "PATCH", +"id": "compute.instanceSettings.patch", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The zone scoping this request. It should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceSettings", +"request": { +"$ref": "InstanceSettings" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"instanceTemplates": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all InstanceTemplates resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/instanceTemplates", +"httpMethod": "GET", +"id": "compute.instanceTemplates.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" +}, +"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/instanceTemplates", +"response": { +"$ref": "InstanceTemplateAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified instance template. Deleting an instance template is\npermanent and cannot be undone. It is not possible to delete templates\nthat are already in use by a managed instance group.", +"flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", +"httpMethod": "DELETE", +"id": "compute.instanceTemplates.delete", +"parameterOrder": [ +"project", +"instanceTemplate" +], +"parameters": { +"instanceTemplate": { +"description": "The name of the instance template 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" +}, +"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}/global/instanceTemplates/{instanceTemplate}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified instance template.", +"flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", +"httpMethod": "GET", +"id": "compute.instanceTemplates.get", +"parameterOrder": [ +"project", +"instanceTemplate" +], +"parameters": { +"instanceTemplate": { +"description": "The name of the instance template.", +"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" +} +}, +"path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", +"response": { +"$ref": "InstanceTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.instanceTemplates.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/instanceTemplates/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instance template in the specified project using the\ndata that is included in the request. If you are creating a new template to\nupdate an existing instance group, your new instance template must use the\nsame network or, if applicable, the same subnetwork as the original\ntemplate.", +"flatPath": "projects/{project}/global/instanceTemplates", +"httpMethod": "POST", +"id": "compute.instanceTemplates.insert", +"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" +} +}, +"path": "projects/{project}/global/instanceTemplates", +"request": { +"$ref": "InstanceTemplate" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of instance templates that are contained within\nthe specified project.", +"flatPath": "projects/{project}/global/instanceTemplates", +"httpMethod": "GET", +"id": "compute.instanceTemplates.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/instanceTemplates", +"response": { +"$ref": "InstanceTemplateList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.instanceTemplates.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/instanceTemplates/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.instanceTemplates.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/instanceTemplates/{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" +] +} +} +}, +"instances": { +"methods": { +"addAccessConfig": { +"apiVersion": "2026-10-01-preview", +"description": "Adds an access config to an instance's network interface.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", +"httpMethod": "POST", +"id": "compute.instances.addAccessConfig", +"parameterOrder": [ +"project", +"zone", +"instance", +"networkInterface" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"networkInterface": { +"description": "The name of the network interface to add to this instance.", +"location": "query", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", +"request": { +"$ref": "AccessConfig" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addNetworkInterface": { +"apiVersion": "2026-10-01-preview", +"description": "Adds one dynamic network interface to an active instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", +"httpMethod": "POST", +"id": "compute.instances.addNetworkInterface", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "The instance name for this request stored as resource_id.\nName should conform to RFC1035 or be an unsigned long integer.", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", +"request": { +"$ref": "NetworkInterface" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Adds existing resource policies to an instance. You can only add one\npolicy right now which will be applied to this instance for scheduling live\nmigrations.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", +"httpMethod": "POST", +"id": "compute.instances.addResourcePolicies", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", +"request": { +"$ref": "InstancesAddResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of all of the instances in your project\nacross all regions and zones.\n\nThe performance of this method degrades when a filter is specified on a\nproject that has a very large number of instances.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/instances", +"httpMethod": "GET", +"id": "compute.instances.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": "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" +}, +"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/instances", +"response": { +"$ref": "InstanceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"attachDisk": { +"apiVersion": "2026-10-01-preview", +"description": "Attaches an existing Disk resource to an instance. You must first\ncreate the disk before you can attach it. It is not possible to create\nand attach a disk at the same time. For more information, readAdding a\npersistent disk to your instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", +"httpMethod": "POST", +"id": "compute.instances.attachDisk", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"forceAttach": { +"description": "Whether to force attach the regional disk even if it's currently attached\nto another instance. If you try to force attach a zonal disk to an\ninstance, you will receive an error.", +"location": "query", +"type": "boolean" +}, +"instance": { +"description": "The instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", +"request": { +"$ref": "AttachedDisk" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"bulkInsert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates multiple instances. Count specifies the number of instances to\ncreate. For more information, seeAbout bulk\ncreation of VMs.", +"flatPath": "projects/{project}/zones/{zone}/instances/bulkInsert", +"httpMethod": "POST", +"id": "compute.instances.bulkInsert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/bulkInsert", +"request": { +"$ref": "BulkInsertInstanceResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Instance resource. For more information, seeDeleting\nan instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}", +"httpMethod": "DELETE", +"id": "compute.instances.delete", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance 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" +}, +"noGracefulShutdown": { +"description": "If set to true, Graceful Shutdown is skipped.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteAccessConfig": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes an access config from an instance's network interface.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", +"httpMethod": "POST", +"id": "compute.instances.deleteAccessConfig", +"parameterOrder": [ +"project", +"zone", +"instance", +"accessConfig", +"networkInterface" +], +"parameters": { +"accessConfig": { +"description": "The name of the access config to delete.", +"location": "query", +"required": true, +"type": "string" +}, +"instance": { +"description": "The instance name 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" +}, +"networkInterface": { +"description": "The name of the network interface.", +"location": "query", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteNetworkInterface": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes one dynamic network interface from an active instance.\nInstancesDeleteNetworkInterfaceRequest indicates:\n- instance from which to delete, using project+zone+resource_id fields;\n- dynamic network interface to be deleted, using network_interface_name\nfield;", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", +"httpMethod": "POST", +"id": "compute.instances.deleteNetworkInterface", +"parameterOrder": [ +"project", +"zone", +"instance", +"networkInterfaceName" +], +"parameters": { +"instance": { +"description": "The instance name for this request stored as resource_id.\nName should conform to RFC1035 or be an unsigned long integer.", +"location": "path", +"required": true, +"type": "string" +}, +"networkInterfaceName": { +"description": "The name of the dynamic network interface to be deleted from the instance.", +"location": "query", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"detachDisk": { +"apiVersion": "2026-10-01-preview", +"description": "Detaches a disk from an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", +"httpMethod": "POST", +"id": "compute.instances.detachDisk", +"parameterOrder": [ +"project", +"zone", +"instance", +"deviceName" +], +"parameters": { +"deviceName": { +"description": "The device name of the disk to detach. Make a get() request on\nthe instance to view currently attached disks and device names.", +"location": "query", +"required": true, +"type": "string" +}, +"instance": { +"description": "Instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Instance resource.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}", +"httpMethod": "GET", +"id": "compute.instances.get", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}", +"response": { +"$ref": "Instance" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getEffectiveFirewalls": { +"apiVersion": "2026-10-01-preview", +"description": "Returns effective firewalls applied to an interface of the instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", +"httpMethod": "GET", +"id": "compute.instances.getEffectiveFirewalls", +"parameterOrder": [ +"project", +"zone", +"instance", +"networkInterface" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"networkInterface": { +"description": "The name of the network interface to get the effective firewalls.", +"location": "query", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", +"response": { +"$ref": "InstancesGetEffectiveFirewallsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getGuestAttributes": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified guest attributes entry.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", +"httpMethod": "GET", +"id": "compute.instances.getGuestAttributes", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"queryPath": { +"description": "Specifies the guest attributes path to be queried.", +"location": "query", +"type": "string" +}, +"variableKey": { +"description": "Specifies the key for the guest attributes entry.", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", +"response": { +"$ref": "GuestAttributes" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.instances.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{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" +] +}, +"getScreenshot": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the screenshot from the specified instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", +"httpMethod": "GET", +"id": "compute.instances.getScreenshot", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", +"response": { +"$ref": "Screenshot" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getSerialPortOutput": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the last 1 MB of serial port output from the specified instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", +"httpMethod": "GET", +"id": "compute.instances.getSerialPortOutput", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance 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" +}, +"port": { +"default": "1", +"description": "Specifies which COM or serial port to retrieve data from.", +"format": "int32", +"location": "query", +"maximum": "4", +"minimum": "1", +"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" +}, +"start": { +"description": "Specifies the starting byte position of the output to return. To start with\nthe first byte of output to the specified port, omit this field or set it\nto `0`.\n\nIf the output for that byte position is available, this field matches the\n`start` parameter sent with the request. If the amount of serial console\noutput exceeds the size of the buffer (1 MB), the oldest output is\ndiscarded and is no longer available. If the requested start position\nrefers to discarded output, the start position is adjusted to the oldest\noutput still available, and the adjusted start position is returned as the\n`start` property value.\n\nYou can also provide a negative start position, which translates to the\nmost recent number of bytes written to the serial port. For example, -3 is\ninterpreted as the most recent 3 bytes written to the serial console. Note\nthat the negative start is bounded by the retained buffer size, and the\nreturned serial console output will not exceed the max buffer size.", +"format": "int64", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", +"response": { +"$ref": "SerialPortOutput" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getShieldedInstanceIdentity": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the Shielded Instance Identity of an instance", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", +"httpMethod": "GET", +"id": "compute.instances.getShieldedInstanceIdentity", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name or id of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", +"response": { +"$ref": "ShieldedInstanceIdentity" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instance resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/zones/{zone}/instances", +"httpMethod": "POST", +"id": "compute.instances.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"sourceInstanceTemplate": { +"description": "Specifies instance template to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the\nfollowing are all valid URLs to an instance template:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate", +"location": "query", +"type": "string" +}, +"sourceMachineImage": { +"description": "Specifies the machine image to use to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the\nfollowing are all valid URLs to a machine image:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage\n - projects/project/global/global/machineImages/machineImage\n - global/machineImages/machineImage", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances", +"request": { +"$ref": "Instance" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of instances contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instances", +"httpMethod": "GET", +"id": "compute.instances.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances", +"response": { +"$ref": "InstanceList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listReferrers": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of resources that refer to the VM instance specified in\nthe request. For example, if the VM instance is part of a managed or\nunmanaged instance group, the referrers list includes the instance group.\nFor more information, readViewing\nreferrers to VM instances.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/referrers", +"httpMethod": "GET", +"id": "compute.instances.listReferrers", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"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" +}, +"instance": { +"description": "Name of the target instance scoping this request, or '-' if the\nrequest should span over all instances in the container.", +"location": "path", +"pattern": "-|[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/referrers", +"response": { +"$ref": "InstanceListReferrers" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"performMaintenance": { +"apiVersion": "2026-10-01-preview", +"description": "Perform a manual maintenance on the instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", +"httpMethod": "POST", +"id": "compute.instances.performMaintenance", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Removes resource policies from an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", +"httpMethod": "POST", +"id": "compute.instances.removeResourcePolicies", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", +"request": { +"$ref": "InstancesRemoveResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"reportHostAsFaulty": { +"apiVersion": "2026-10-01-preview", +"description": "Mark the host as faulty and try to restart the instance on a new host.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", +"httpMethod": "POST", +"id": "compute.instances.reportHostAsFaulty", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", +"request": { +"$ref": "InstancesReportHostAsFaultyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"reset": { +"apiVersion": "2026-10-01-preview", +"description": "Performs a reset on the instance. This is a hard reset. The VM\ndoes not do a graceful shutdown. For more information, seeResetting\nan instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reset", +"httpMethod": "POST", +"id": "compute.instances.reset", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/reset", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resume": { +"apiVersion": "2026-10-01-preview", +"description": "Resumes an instance that was suspended using theinstances().suspend\nmethod.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/resume", +"httpMethod": "POST", +"id": "compute.instances.resume", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance resource to resume.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/resume", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"sendDiagnosticInterrupt": { +"apiVersion": "2026-10-01-preview", +"description": "Sends diagnostic interrupt to the instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", +"httpMethod": "POST", +"id": "compute.instances.sendDiagnosticInterrupt", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setDeletionProtection": { +"apiVersion": "2026-10-01-preview", +"description": "Sets deletion protection on the instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", +"httpMethod": "POST", +"id": "compute.instances.setDeletionProtection", +"parameterOrder": [ +"project", +"zone", +"resource" +], +"parameters": { +"deletionProtection": { +"default": "true", +"description": "Whether the resource should be protected against deletion.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setDiskAutoDelete": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the auto-delete flag for a disk attached to an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", +"httpMethod": "POST", +"id": "compute.instances.setDiskAutoDelete", +"parameterOrder": [ +"project", +"zone", +"instance", +"autoDelete", +"deviceName" +], +"parameters": { +"autoDelete": { +"description": "Whether to auto-delete the disk when the instance is deleted.", +"location": "query", +"required": true, +"type": "boolean" +}, +"deviceName": { +"description": "The device name of the disk to modify. Make a get() request\non the instance to view currently attached disks and device names.", +"location": "query", +"pattern": "\\w[\\w.-]{0,254}", +"required": true, +"type": "string" +}, +"instance": { +"description": "The instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.instances.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets labels on an instance. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", +"httpMethod": "POST", +"id": "compute.instances.setLabels", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", +"request": { +"$ref": "InstancesSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setMachineResources": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the number and/or type of accelerator for a stopped instance to the\nvalues specified in the request.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", +"httpMethod": "POST", +"id": "compute.instances.setMachineResources", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", +"request": { +"$ref": "InstancesSetMachineResourcesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setMachineType": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the machine type for a stopped instance to the machine\ntype specified in the request.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", +"httpMethod": "POST", +"id": "compute.instances.setMachineType", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", +"request": { +"$ref": "InstancesSetMachineTypeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setMetadata": { +"apiVersion": "2026-10-01-preview", +"description": "Sets metadata for the specified instance to the data included\nin the request.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", +"httpMethod": "POST", +"id": "compute.instances.setMetadata", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", +"request": { +"$ref": "Metadata" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setMinCpuPlatform": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the minimum CPU platform that this instance should use.\nThis method can only\nbe called on a stopped instance. For more information, readSpecifying a\nMinimum CPU Platform.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", +"httpMethod": "POST", +"id": "compute.instances.setMinCpuPlatform", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", +"request": { +"$ref": "InstancesSetMinCpuPlatformRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setName": { +"apiVersion": "2026-10-01-preview", +"description": "Sets name of an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setName", +"httpMethod": "POST", +"id": "compute.instances.setName", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setName", +"request": { +"$ref": "InstancesSetNameRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setScheduling": { +"apiVersion": "2026-10-01-preview", +"description": "Sets an instance's scheduling options. You can only call this method on astopped instance,\nthat is, a VM instance that is in a `TERMINATED` state. SeeInstance Life\nCycle for more information on the possible instance states.\nFor more information about setting scheduling options for a VM, seeSet\nVM host maintenance policy.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", +"httpMethod": "POST", +"id": "compute.instances.setScheduling", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Instance name 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", +"request": { +"$ref": "Scheduling" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Google Cloud Armor security policy for the specified instance.\nFor more information, seeGoogle\nCloud Armor Overview", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", +"httpMethod": "POST", +"id": "compute.instances.setSecurityPolicy", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the Instance resource to which the security policy should be\nset. The name 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. 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" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", +"request": { +"$ref": "InstancesSetSecurityPolicyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setServiceAccount": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the service account on the instance. For more information,\nreadChanging\nthe service account and access scopes for an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", +"httpMethod": "POST", +"id": "compute.instances.setServiceAccount", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance resource to start.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", +"request": { +"$ref": "InstancesSetServiceAccountRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setShieldedInstanceIntegrityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Shielded Instance integrity policy for an instance. You can\nonly use this method on a running instance. This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", +"httpMethod": "PATCH", +"id": "compute.instances.setShieldedInstanceIntegrityPolicy", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name or id of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", +"request": { +"$ref": "ShieldedInstanceIntegrityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setTags": { +"apiVersion": "2026-10-01-preview", +"description": "Sets network tags\nfor the specified instance to the data included in the request.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setTags", +"httpMethod": "POST", +"id": "compute.instances.setTags", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/setTags", +"request": { +"$ref": "Tags" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"simulateMaintenanceEvent": { +"apiVersion": "2026-10-01-preview", +"description": "Simulates a host maintenance event on a VM. For more information, see\nSimulate a host maintenance event.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", +"httpMethod": "POST", +"id": "compute.instances.simulateMaintenanceEvent", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping 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" +}, +"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" +}, +"withExtendedNotifications": { +"description": "Determines whether the customers receive notifications before migration.\nOnly applicable to SF vms.", +"location": "query", +"type": "boolean" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"start": { +"apiVersion": "2026-10-01-preview", +"description": "Starts an instance that was stopped using theinstances().stop\nmethod. For more information, seeRestart an\ninstance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/start", +"httpMethod": "POST", +"id": "compute.instances.start", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance resource to start.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/start", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"startWithEncryptionKey": { +"apiVersion": "2026-10-01-preview", +"description": "Starts an instance that was stopped using theinstances().stop\nmethod. For more information, seeRestart an\ninstance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", +"httpMethod": "POST", +"id": "compute.instances.startWithEncryptionKey", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance resource to start.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", +"request": { +"$ref": "InstancesStartWithEncryptionKeyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stop": { +"apiVersion": "2026-10-01-preview", +"description": "Stops a running instance, shutting it down cleanly, and allows\nyou to restart the instance at a later time. Stopped instances do not incur\nVM usage charges while they are stopped. However, resources that the VM is\nusing, such as persistent disks and static IP addresses, will continue to\nbe charged until they are deleted. For more information, seeStopping\nan instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/stop", +"httpMethod": "POST", +"id": "compute.instances.stop", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"discardLocalSsd": { +"description": "This property is required if the instance has any attached Local SSD disks.\nIf false, Local SSD data will be preserved when the instance is suspended.\nIf true, the contents of any attached Local SSD disks will be discarded.", +"location": "query", +"type": "boolean" +}, +"instance": { +"description": "Name of the instance resource to stop.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"description": "If set to true, Graceful Shutdown is skipped.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/stop", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"suspend": { +"apiVersion": "2026-10-01-preview", +"description": "This method suspends a running instance, saving its state to persistent\nstorage, and allows you to resume the instance at a later time. Suspended\ninstances have no compute costs (cores or RAM), and incur only storage\ncharges for the saved VM memory and localSSD data. Any charged resources\nthe virtual machine was using, such as persistent disks and static IP\naddresses, will continue to be charged while the instance is suspended.\nFor more information, see\nSuspending and resuming an instance.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/suspend", +"httpMethod": "POST", +"id": "compute.instances.suspend", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"discardLocalSsd": { +"description": "This property is required if the instance has any attached Local SSD disks.\nIf false, Local SSD data will be preserved when the instance is suspended.\nIf true, the contents of any attached Local SSD disks will be discarded.", +"location": "query", +"type": "boolean" +}, +"instance": { +"description": "Name of the instance resource to suspend.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/suspend", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.instances.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an instance only if the necessary resources are available. This\nmethod can update only a specific set of instance properties. See\nUpdating a running instance for a list of updatable instance\nproperties.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}", +"httpMethod": "PUT", +"id": "compute.instances.update", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"discardLocalSsd": { +"description": "Whether to discard local SSDs from the instance during restart\ndefault value is false.", +"location": "query", +"type": "boolean" +}, +"instance": { +"description": "Name of the instance resource to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"minimalAction": { +"description": "Specifies the action to take when updating an instance even if the\nupdated properties do not require it. If not specified, then\nCompute Engine acts based on the minimum action that the updated\nproperties require.", +"enum": [ +"INVALID", +"NO_EFFECT", +"REFRESH", +"RESTART" +], +"enumDescriptions": [ +"", +"No changes can be made to the instance.", +"The instance will not restart.", +"The instance will restart, potentially on a different host." +], +"location": "query", +"type": "string" +}, +"mostDisruptiveAllowedAction": { +"description": "Specifies the most disruptive action that can be taken on the instance\nas part of the update. Compute Engine returns an error if the\ninstance properties require a more disruptive action as part of the\ninstance update. Valid options from lowest to highest are\nNO_EFFECT, REFRESH, and RESTART.", +"enum": [ +"INVALID", +"NO_EFFECT", +"REFRESH", +"RESTART" +], +"enumDescriptions": [ +"", +"No changes can be made to the instance.", +"The instance will not restart.", +"The instance will restart, potentially on a different host." +], +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}", +"request": { +"$ref": "Instance" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateAccessConfig": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified access config from an instance's network interface\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", +"httpMethod": "POST", +"id": "compute.instances.updateAccessConfig", +"parameterOrder": [ +"project", +"zone", +"instance", +"networkInterface" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"networkInterface": { +"description": "The name of the network interface where the access config is attached.", +"location": "query", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", +"request": { +"$ref": "AccessConfig" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateDisplayDevice": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the Display config for a VM instance. You can\nonly use this method on a stopped VM instance. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", +"httpMethod": "PATCH", +"id": "compute.instances.updateDisplayDevice", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name of the instance scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", +"request": { +"$ref": "DisplayDevice" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateNetworkInterface": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an instance's network interface. This method can only update an\ninterface's alias IP range and attached network. See Modifying\nalias IP ranges for an existing instance for instructions on\nchanging alias IP ranges. See Migrating\na VM between networks for instructions on migrating an interface.\nThis method follows PATCH semantics.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", +"httpMethod": "PATCH", +"id": "compute.instances.updateNetworkInterface", +"parameterOrder": [ +"project", +"zone", +"instance", +"networkInterface" +], +"parameters": { +"instance": { +"description": "The instance name 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" +}, +"networkInterface": { +"description": "The name of the network interface to update.", +"location": "query", +"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. 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", +"request": { +"$ref": "NetworkInterface" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateShieldedInstanceConfig": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the Shielded Instance config for an instance. You can\nonly use this method on a stopped instance. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", +"httpMethod": "PATCH", +"id": "compute.instances.updateShieldedInstanceConfig", +"parameterOrder": [ +"project", +"zone", +"instance" +], +"parameters": { +"instance": { +"description": "Name or id of the instance scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", +"request": { +"$ref": "ShieldedInstanceConfig" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"instantSnapshotGroups": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "deletes a Zonal InstantSnapshotGroup resource", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", +"httpMethod": "DELETE", +"id": "compute.instantSnapshotGroups.delete", +"parameterOrder": [ +"project", +"zone", +"instantSnapshotGroup" +], +"parameters": { +"instantSnapshotGroup": { +"description": "Name of the InstantSnapshot 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "returns the specified InstantSnapshotGroup resource in the specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", +"httpMethod": "GET", +"id": "compute.instantSnapshotGroups.get", +"parameterOrder": [ +"project", +"zone", +"instantSnapshotGroup" +], +"parameters": { +"instantSnapshotGroup": { +"description": "Name of the InstantSnapshotGroup 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", +"response": { +"$ref": "InstantSnapshotGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.instantSnapshotGroups.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{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": { +"apiVersion": "2026-10-01-preview", +"description": "inserts a Zonal InstantSnapshotGroup resource", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups", +"httpMethod": "POST", +"id": "compute.instantSnapshotGroups.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"sourceConsistencyGroup": { +"description": "begin_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups", +"request": { +"$ref": "InstantSnapshotGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "retrieves the list of InstantSnapshotGroup resources contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups", +"httpMethod": "GET", +"id": "compute.instantSnapshotGroups.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups", +"response": { +"$ref": "ListInstantSnapshotGroups" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.instantSnapshotGroups.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.instantSnapshotGroups.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{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" +] +} +} +}, +"instantSnapshots": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of instantSnapshots.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/instantSnapshots", +"httpMethod": "GET", +"id": "compute.instantSnapshots.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": "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" +}, +"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/instantSnapshots", +"response": { +"$ref": "InstantSnapshotAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting\na single instantSnapshot might not necessarily delete all the data on that\ninstantSnapshot. If any data on the instantSnapshot that is marked for\ndeletion is needed for subsequent instantSnapshots, the data will be moved\nto the next corresponding instantSnapshot.\n\nFor more information, seeDeleting\ninstantSnapshots.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", +"httpMethod": "DELETE", +"id": "compute.instantSnapshots.delete", +"parameterOrder": [ +"project", +"zone", +"instantSnapshot" +], +"parameters": { +"instantSnapshot": { +"description": "Name of the InstantSnapshot 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified InstantSnapshot resource in the specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", +"httpMethod": "GET", +"id": "compute.instantSnapshots.get", +"parameterOrder": [ +"project", +"zone", +"instantSnapshot" +], +"parameters": { +"instantSnapshot": { +"description": "Name of the InstantSnapshot 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", +"response": { +"$ref": "InstantSnapshot" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.instantSnapshots.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instant snapshot in the specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots", +"httpMethod": "POST", +"id": "compute.instantSnapshots.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots", +"request": { +"$ref": "InstantSnapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of InstantSnapshot resources contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots", +"httpMethod": "GET", +"id": "compute.instantSnapshots.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots", +"response": { +"$ref": "InstantSnapshotList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.instantSnapshots.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a instantSnapshot in the given zone. To learn more about\nlabels, read the Labeling\nResources documentation.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.instantSnapshots.setLabels", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"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.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", +"request": { +"$ref": "ZoneSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.instantSnapshots.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instantSnapshots/{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" +] +} +} +}, +"interconnectAttachmentGroups": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified InterconnectAttachmentGroup in the given scope", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"httpMethod": "DELETE", +"id": "compute.interconnectAttachmentGroups.delete", +"parameterOrder": [ +"project", +"interconnectAttachmentGroup" +], +"parameters": { +"interconnectAttachmentGroup": { +"description": "Name of the InterconnectAttachmentGroup 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified InterconnectAttachmentGroup resource in the given\nscope.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"httpMethod": "GET", +"id": "compute.interconnectAttachmentGroups.get", +"parameterOrder": [ +"project", +"interconnectAttachmentGroup" +], +"parameters": { +"interconnectAttachmentGroup": { +"description": "Name of the InterconnectAttachmentGroup 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" +} +}, +"path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"response": { +"$ref": "InterconnectAttachmentGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.interconnectAttachmentGroups.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/interconnectAttachmentGroups/{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" +] +}, +"getOperationalStatus": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the InterconnectAttachmentStatuses for the specified\nInterconnectAttachmentGroup resource.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", +"httpMethod": "GET", +"id": "compute.interconnectAttachmentGroups.getOperationalStatus", +"parameterOrder": [ +"project", +"interconnectAttachmentGroup" +], +"parameters": { +"interconnectAttachmentGroup": { +"description": "Name of the interconnectAttachmentGroup 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" +}, +"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/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", +"response": { +"$ref": "InterconnectAttachmentGroupsGetOperationalStatusResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a InterconnectAttachmentGroup in the specified project in the given\nscope using the parameters that are included in the request.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups", +"httpMethod": "POST", +"id": "compute.interconnectAttachmentGroups.insert", +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectAttachmentGroups", +"request": { +"$ref": "InterconnectAttachmentGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the InterconnectAttachmentGroups for a project in the given scope.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups", +"httpMethod": "GET", +"id": "compute.interconnectAttachmentGroups.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/interconnectAttachmentGroups", +"response": { +"$ref": "InterconnectAttachmentGroupsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified InterconnectAttachmentGroup resource with the data\nincluded in the request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"httpMethod": "PATCH", +"id": "compute.interconnectAttachmentGroups.patch", +"parameterOrder": [ +"project", +"interconnectAttachmentGroup" +], +"parameters": { +"interconnectAttachmentGroup": { +"description": "Name of the InterconnectAttachmentGroup 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "The list of fields to update.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", +"request": { +"$ref": "InterconnectAttachmentGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.interconnectAttachmentGroups.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/interconnectAttachmentGroups/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.interconnectAttachmentGroups.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/interconnectAttachmentGroups/{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" +] +} +} +}, +"interconnectAttachments": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of interconnect attachments.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/interconnectAttachments", +"httpMethod": "GET", +"id": "compute.interconnectAttachments.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": "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" +}, +"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/interconnectAttachments", +"response": { +"$ref": "InterconnectAttachmentAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified interconnect attachment.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", +"httpMethod": "DELETE", +"id": "compute.interconnectAttachments.delete", +"parameterOrder": [ +"project", +"region", +"interconnectAttachment" +], +"parameters": { +"interconnectAttachment": { +"description": "Name of the interconnect attachment 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 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" +} +}, +"path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified interconnect attachment.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", +"httpMethod": "GET", +"id": "compute.interconnectAttachments.get", +"parameterOrder": [ +"project", +"region", +"interconnectAttachment" +], +"parameters": { +"interconnectAttachment": { +"description": "Name of the interconnect attachment 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", +"response": { +"$ref": "InterconnectAttachment" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an InterconnectAttachment in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments", +"httpMethod": "POST", +"id": "compute.interconnectAttachments.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 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" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/interconnectAttachments", +"request": { +"$ref": "InterconnectAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of interconnect attachments contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments", +"httpMethod": "GET", +"id": "compute.interconnectAttachments.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/interconnectAttachments", +"response": { +"$ref": "InterconnectAttachmentList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified interconnect attachment with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", +"httpMethod": "PATCH", +"id": "compute.interconnectAttachments.patch", +"parameterOrder": [ +"project", +"region", +"interconnectAttachment" +], +"parameters": { +"interconnectAttachment": { +"description": "Name of the interconnect attachment 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" +}, +"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}/interconnectAttachments/{interconnectAttachment}", +"request": { +"$ref": "InterconnectAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on an InterconnectAttachment. To learn more about labels,\nread the Labeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.interconnectAttachments.setLabels", +"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 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" +}, +"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}/interconnectAttachments/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"interconnectGroups": { +"methods": { +"createMembers": { +"apiVersion": "2026-10-01-preview", +"description": "Create Interconnects with redundancy by creating them in a specified\ninterconnect group.", +"flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", +"httpMethod": "POST", +"id": "compute.interconnectGroups.createMembers", +"parameterOrder": [ +"project", +"interconnectGroup" +], +"parameters": { +"interconnectGroup": { +"description": "Name of the group resource to create members for.", +"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" +} +}, +"path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", +"request": { +"$ref": "InterconnectGroupsCreateMembersRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified InterconnectGroup in the given scope", +"flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"httpMethod": "DELETE", +"id": "compute.interconnectGroups.delete", +"parameterOrder": [ +"project", +"interconnectGroup" +], +"parameters": { +"interconnectGroup": { +"description": "Name of the InterconnectGroup 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified InterconnectGroup resource in the given scope.", +"flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"httpMethod": "GET", +"id": "compute.interconnectGroups.get", +"parameterOrder": [ +"project", +"interconnectGroup" +], +"parameters": { +"interconnectGroup": { +"description": "Name of the InterconnectGroup 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" +} +}, +"path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"response": { +"$ref": "InterconnectGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/interconnectGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.interconnectGroups.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/interconnectGroups/{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" +] +}, +"getOperationalStatus": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the interconnectStatuses for the specified\nInterconnectGroup.", +"flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", +"httpMethod": "GET", +"id": "compute.interconnectGroups.getOperationalStatus", +"parameterOrder": [ +"project", +"interconnectGroup" +], +"parameters": { +"interconnectGroup": { +"description": "Name of the interconnectGroup 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" +}, +"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/interconnectGroups/{interconnectGroup}/getOperationalStatus", +"response": { +"$ref": "InterconnectGroupsGetOperationalStatusResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a InterconnectGroup in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/global/interconnectGroups", +"httpMethod": "POST", +"id": "compute.interconnectGroups.insert", +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectGroups", +"request": { +"$ref": "InterconnectGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the InterconnectGroups for a project in the given scope.", +"flatPath": "projects/{project}/global/interconnectGroups", +"httpMethod": "GET", +"id": "compute.interconnectGroups.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/interconnectGroups", +"response": { +"$ref": "InterconnectGroupsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified InterconnectGroup resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"httpMethod": "PATCH", +"id": "compute.interconnectGroups.patch", +"parameterOrder": [ +"project", +"interconnectGroup" +], +"parameters": { +"interconnectGroup": { +"description": "Name of the InterconnectGroup 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "The list of fields to update.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", +"request": { +"$ref": "InterconnectGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.interconnectGroups.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/interconnectGroups/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.interconnectGroups.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/interconnectGroups/{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" +] +} +} +}, +"interconnectLocations": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the details for the specified interconnect location. Gets a list of\navailable interconnect locations by making a list() request.", +"flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", +"httpMethod": "GET", +"id": "compute.interconnectLocations.get", +"parameterOrder": [ +"project", +"interconnectLocation" +], +"parameters": { +"interconnectLocation": { +"description": "Name of the interconnect location 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" +} +}, +"path": "projects/{project}/global/interconnectLocations/{interconnectLocation}", +"response": { +"$ref": "InterconnectLocation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of interconnect locations available to the specified\nproject.", +"flatPath": "projects/{project}/global/interconnectLocations", +"httpMethod": "GET", +"id": "compute.interconnectLocations.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/interconnectLocations", +"response": { +"$ref": "InterconnectLocationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"interconnectRemoteLocations": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the details for the specified interconnect remote location. Gets a\nlist of available interconnect remote locations by making alist() request.", +"flatPath": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", +"httpMethod": "GET", +"id": "compute.interconnectRemoteLocations.get", +"parameterOrder": [ +"project", +"interconnectRemoteLocation" +], +"parameters": { +"interconnectRemoteLocation": { +"description": "Name of the interconnect remote location 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" +} +}, +"path": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", +"response": { +"$ref": "InterconnectRemoteLocation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of interconnect remote locations available to the\nspecified project.", +"flatPath": "projects/{project}/global/interconnectRemoteLocations", +"httpMethod": "GET", +"id": "compute.interconnectRemoteLocations.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/interconnectRemoteLocations", +"response": { +"$ref": "InterconnectRemoteLocationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"interconnects": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Interconnect.", +"flatPath": "projects/{project}/global/interconnects/{interconnect}", +"httpMethod": "DELETE", +"id": "compute.interconnects.delete", +"parameterOrder": [ +"project", +"interconnect" +], +"parameters": { +"interconnect": { +"description": "Name of the interconnect 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" +}, +"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}/global/interconnects/{interconnect}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Interconnect. Get a list of available Interconnects\nby making a list() request.", +"flatPath": "projects/{project}/global/interconnects/{interconnect}", +"httpMethod": "GET", +"id": "compute.interconnects.get", +"parameterOrder": [ +"project", +"interconnect" +], +"parameters": { +"interconnect": { +"description": "Name of the interconnect 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" +} +}, +"path": "projects/{project}/global/interconnects/{interconnect}", +"response": { +"$ref": "Interconnect" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getDiagnostics": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the interconnectDiagnostics for the specified\nInterconnect.\n\nIn the event of a\nglobal outage, do not use this API to make decisions about where to\nredirect your network traffic.\n\nUnlike a VLAN attachment, which is regional, a Cloud Interconnect\nconnection is a global resource. A global outage can prevent this\nAPI from functioning properly.", +"flatPath": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", +"httpMethod": "GET", +"id": "compute.interconnects.getDiagnostics", +"parameterOrder": [ +"project", +"interconnect" +], +"parameters": { +"interconnect": { +"description": "Name of the interconnect 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" +}, +"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/interconnects/{interconnect}/getDiagnostics", +"response": { +"$ref": "InterconnectsGetDiagnosticsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getMacsecConfig": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the interconnectMacsecConfig for the specified\nInterconnect.", +"flatPath": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", +"httpMethod": "GET", +"id": "compute.interconnects.getMacsecConfig", +"parameterOrder": [ +"project", +"interconnect" +], +"parameters": { +"interconnect": { +"description": "Name of the interconnect 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" +}, +"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/interconnects/{interconnect}/getMacsecConfig", +"response": { +"$ref": "InterconnectsGetMacsecConfigResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an Interconnect in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/interconnects", +"httpMethod": "POST", +"id": "compute.interconnects.insert", +"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" +} +}, +"path": "projects/{project}/global/interconnects", +"request": { +"$ref": "Interconnect" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Interconnects available to the specified project.", +"flatPath": "projects/{project}/global/interconnects", +"httpMethod": "GET", +"id": "compute.interconnects.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/interconnects", +"response": { +"$ref": "InterconnectList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified Interconnect with the data included in the request.\nThis method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/interconnects/{interconnect}", +"httpMethod": "PATCH", +"id": "compute.interconnects.patch", +"parameterOrder": [ +"project", +"interconnect" +], +"parameters": { +"interconnect": { +"description": "Name of the interconnect to update.", +"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" +}, +"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}/global/interconnects/{interconnect}", +"request": { +"$ref": "Interconnect" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on an Interconnect. To learn more about labels,\nread the Labeling\nResources documentation.", +"flatPath": "projects/{project}/global/interconnects/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.interconnects.setLabels", +"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/interconnects/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"licenseCodes": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Return a specified license code. License codes are mirrored across\nall projects that have permissions to read the License Code.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenseCodes/{licenseCode}", +"httpMethod": "GET", +"id": "compute.licenseCodes.get", +"parameterOrder": [ +"project", +"licenseCode" +], +"parameters": { +"licenseCode": { +"description": "Number corresponding to the License code resource to return.", +"location": "path", +"pattern": "[0-9]{0,61}?", +"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" +} +}, +"path": "projects/{project}/global/licenseCodes/{licenseCode}", +"response": { +"$ref": "LicenseCode" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenseCodes/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.licenseCodes.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/licenseCodes/{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" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenseCodes/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.licenseCodes.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/licenseCodes/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.licenseCodes.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/licenseCodes/{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" +] +} +} +}, +"licenses": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified license.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{license}", +"httpMethod": "DELETE", +"id": "compute.licenses.delete", +"parameterOrder": [ +"project", +"license" +], +"parameters": { +"license": { +"description": "Name of the license 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" +}, +"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}/global/licenses/{license}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified License resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{license}", +"httpMethod": "GET", +"id": "compute.licenses.get", +"parameterOrder": [ +"project", +"license" +], +"parameters": { +"license": { +"description": "Name of the License 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" +} +}, +"path": "projects/{project}/global/licenses/{license}", +"response": { +"$ref": "License" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.licenses.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/licenses/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Create a License resource in the specified project.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses", +"httpMethod": "POST", +"id": "compute.licenses.insert", +"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" +} +}, +"path": "projects/{project}/global/licenses", +"request": { +"$ref": "License" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/devstorage.full_control", +"https://www.googleapis.com/auth/devstorage.read_only", +"https://www.googleapis.com/auth/devstorage.read_write" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of licenses\navailable in the specified project. This method does not\nget any licenses that belong to other projects, including licenses attached\nto publicly-available images, like Debian 9. If you want to get a list of\npublicly-available licenses, use this method to make a request to the\nrespective image project, such as debian-cloud orwindows-cloud.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses", +"httpMethod": "GET", +"id": "compute.licenses.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/licenses", +"response": { +"$ref": "LicensesListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.licenses.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/licenses/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.licenses.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/licenses/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a License resource in the specified project.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", +"flatPath": "projects/{project}/global/licenses/{license}", +"httpMethod": "PATCH", +"id": "compute.licenses.update", +"parameterOrder": [ +"project", +"license" +], +"parameters": { +"license": { +"description": "The license name 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" +}, +"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/licenses/{license}", +"request": { +"$ref": "License" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"machineImages": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified machine image. Deleting a machine image is permanent\nand cannot be undone.", +"flatPath": "projects/{project}/global/machineImages/{machineImage}", +"httpMethod": "DELETE", +"id": "compute.machineImages.delete", +"parameterOrder": [ +"project", +"machineImage" +], +"parameters": { +"machineImage": { +"description": "The name of the machine image 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" +}, +"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}/global/machineImages/{machineImage}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified machine image.", +"flatPath": "projects/{project}/global/machineImages/{machineImage}", +"httpMethod": "GET", +"id": "compute.machineImages.get", +"parameterOrder": [ +"project", +"machineImage" +], +"parameters": { +"machineImage": { +"description": "The name of the machine image.", +"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" +} +}, +"path": "projects/{project}/global/machineImages/{machineImage}", +"response": { +"$ref": "MachineImage" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/machineImages/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.machineImages.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/machineImages/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a machine image in the specified project using the\ndata that is included in the request. If you are creating a new machine\nimage to update an existing instance, your new machine image should use the\nsame network or, if applicable, the same subnetwork as the original\ninstance.", +"flatPath": "projects/{project}/global/machineImages", +"httpMethod": "POST", +"id": "compute.machineImages.insert", +"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" +}, +"sourceInstance": { +"description": "Required. Source instance that is used to create the machine image from.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/machineImages", +"request": { +"$ref": "MachineImage" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of machine images that are contained within\nthe specified project.", +"flatPath": "projects/{project}/global/machineImages", +"httpMethod": "GET", +"id": "compute.machineImages.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/machineImages", +"response": { +"$ref": "MachineImageList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/machineImages/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.machineImages.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/machineImages/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a machine image. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/global/machineImages/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.machineImages.setLabels", +"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/machineImages/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/machineImages/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.machineImages.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/machineImages/{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" +] +} +} +}, +"machineTypes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of machine types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/machineTypes", +"httpMethod": "GET", +"id": "compute.machineTypes.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": "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" +}, +"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/machineTypes", +"response": { +"$ref": "MachineTypeAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified machine type.", +"flatPath": "projects/{project}/zones/{zone}/machineTypes/{machineType}", +"httpMethod": "GET", +"id": "compute.machineTypes.get", +"parameterOrder": [ +"project", +"zone", +"machineType" +], +"parameters": { +"machineType": { +"description": "Name of the machine type 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/machineTypes/{machineType}", +"response": { +"$ref": "MachineType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of machine types available to the specified\nproject.", +"flatPath": "projects/{project}/zones/{zone}/machineTypes", +"httpMethod": "GET", +"id": "compute.machineTypes.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/machineTypes", +"response": { +"$ref": "MachineTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"managedRulesets": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the details for the specified managed ruleset name.", +"flatPath": "projects/{project}/global/managedRulesets/{managedRuleset}", +"httpMethod": "GET", +"id": "compute.managedRulesets.get", +"parameterOrder": [ +"project", +"managedRuleset" +], +"parameters": { +"managedRuleset": { +"description": "Name of the managed ruleset 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" +} +}, +"path": "projects/{project}/global/managedRulesets/{managedRuleset}", +"response": { +"$ref": "ManagedRuleset" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all the managed rulesets available.", +"flatPath": "projects/{project}/global/managedRulesets", +"httpMethod": "GET", +"id": "compute.managedRulesets.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/managedRulesets", +"response": { +"$ref": "ManagedRulesetList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"networkAttachments": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all NetworkAttachment resources,\nregional and global, available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/networkAttachments", +"httpMethod": "GET", +"id": "compute.networkAttachments.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": "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" +}, +"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/networkAttachments", +"response": { +"$ref": "NetworkAttachmentAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified NetworkAttachment in the given scope", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"httpMethod": "DELETE", +"id": "compute.networkAttachments.delete", +"parameterOrder": [ +"project", +"region", +"networkAttachment" +], +"parameters": { +"networkAttachment": { +"description": "Name of the NetworkAttachment 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 of 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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified NetworkAttachment resource in the given scope.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"httpMethod": "GET", +"id": "compute.networkAttachments.get", +"parameterOrder": [ +"project", +"region", +"networkAttachment" +], +"parameters": { +"networkAttachment": { +"description": "Name of the NetworkAttachment 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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"response": { +"$ref": "NetworkAttachment" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.networkAttachments.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/networkAttachments/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a NetworkAttachment in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments", +"httpMethod": "POST", +"id": "compute.networkAttachments.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 of 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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkAttachments", +"request": { +"$ref": "NetworkAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the NetworkAttachments for a project in the given scope.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments", +"httpMethod": "GET", +"id": "compute.networkAttachments.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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkAttachments", +"response": { +"$ref": "NetworkAttachmentList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified NetworkAttachment resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"httpMethod": "PATCH", +"id": "compute.networkAttachments.patch", +"parameterOrder": [ +"project", +"region", +"networkAttachment" +], +"parameters": { +"networkAttachment": { +"description": "Name of the NetworkAttachment 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", +"request": { +"$ref": "NetworkAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.networkAttachments.setIamPolicy", +"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}/networkAttachments/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.networkAttachments.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}/networkAttachments/{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" +] +} +} +}, +"networkEdgeSecurityServices": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all NetworkEdgeSecurityService resources available to\nthe specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/networkEdgeSecurityServices", +"httpMethod": "GET", +"id": "compute.networkEdgeSecurityServices.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" +}, +"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/networkEdgeSecurityServices", +"response": { +"$ref": "NetworkEdgeSecurityServiceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified service.", +"flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"httpMethod": "DELETE", +"id": "compute.networkEdgeSecurityServices.delete", +"parameterOrder": [ +"project", +"region", +"networkEdgeSecurityService" +], +"parameters": { +"networkEdgeSecurityService": { +"description": "Name of the network edge security service 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}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a specified NetworkEdgeSecurityService.", +"flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"httpMethod": "GET", +"id": "compute.networkEdgeSecurityServices.get", +"parameterOrder": [ +"project", +"region", +"networkEdgeSecurityService" +], +"parameters": { +"networkEdgeSecurityService": { +"description": "Name of the network edge security service to get.", +"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}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"response": { +"$ref": "NetworkEdgeSecurityService" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new service in the specified project using the data included in\nthe request.", +"flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices", +"httpMethod": "POST", +"id": "compute.networkEdgeSecurityServices.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" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/networkEdgeSecurityServices", +"request": { +"$ref": "NetworkEdgeSecurityService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"httpMethod": "PATCH", +"id": "compute.networkEdgeSecurityServices.patch", +"parameterOrder": [ +"project", +"region", +"networkEdgeSecurityService" +], +"parameters": { +"networkEdgeSecurityService": { +"description": "Name of the network edge security service to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"paths": { +"location": "query", +"repeated": 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" +}, +"updateMask": { +"description": "Indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", +"request": { +"$ref": "NetworkEdgeSecurityService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"networkEndpointGroups": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of network endpoint groups and sorts them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/networkEndpointGroups", +"httpMethod": "GET", +"id": "compute.networkEndpointGroups.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": "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" +}, +"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/networkEndpointGroups", +"response": { +"$ref": "NetworkEndpointGroupAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"attachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Attach a list of network endpoints to the specified network endpoint group.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.networkEndpointGroups.attachNetworkEndpoints", +"parameterOrder": [ +"project", +"zone", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"request": { +"$ref": "NetworkEndpointGroupsAttachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified network endpoint group. The network endpoints in the\nNEG and the VM instances they belong to are not terminated when the NEG is\ndeleted. Note that the NEG cannot be deleted if there are backend services\nreferencing it.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "DELETE", +"id": "compute.networkEndpointGroups.delete", +"parameterOrder": [ +"project", +"zone", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", +"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. 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" +}, +"zone": { +"description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"detachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Detach a list of network endpoints from the specified network endpoint\ngroup.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.networkEndpointGroups.detachNetworkEndpoints", +"parameterOrder": [ +"project", +"zone", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group where you are removing network\nendpoints. It should 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"request": { +"$ref": "NetworkEndpointGroupsDetachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network endpoint group.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "GET", +"id": "compute.networkEndpointGroups.get", +"parameterOrder": [ +"project", +"zone", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group. It should 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" +}, +"zone": { +"description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "NetworkEndpointGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", +"httpMethod": "POST", +"id": "compute.networkEndpointGroups.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups", +"request": { +"$ref": "NetworkEndpointGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of network endpoint groups that are located in the\nspecified project and zone.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", +"httpMethod": "GET", +"id": "compute.networkEndpointGroups.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of thezone\nwhere the network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups", +"response": { +"$ref": "NetworkEndpointGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the network endpoints in the specified network endpoint group.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.networkEndpointGroups.listNetworkEndpoints", +"parameterOrder": [ +"project", +"zone", +"networkEndpointGroup" +], +"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" +}, +"networkEndpointGroup": { +"description": "The name of the network endpoint group from which you want to generate a\nlist of included network endpoints. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"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" +}, +"zone": { +"description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"request": { +"$ref": "NetworkEndpointGroupsListEndpointsRequest" +}, +"response": { +"$ref": "NetworkEndpointGroupsListNetworkEndpoints" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.networkEndpointGroups.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/networkEndpointGroups/{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" +] +} +} +}, +"networkFirewallPolicies": { +"methods": { +"addAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts an association for the specified firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.addAssociation", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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" +}, +"replaceExistingAssociation": { +"description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", +"location": "query", +"type": "boolean" +}, +"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}/global/firewallPolicies/{firewallPolicy}/addAssociation", +"request": { +"$ref": "FirewallPolicyAssociation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addPacketMirroringRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a packet mirroring rule into a firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.addPacketMirroringRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"maxPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"minPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.addRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"maxPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"minPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/addRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of network firewall policies, listing network\nfirewall policies from all applicable scopes (global and regional) and\ngrouping the results per scope.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/firewallPolicies", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.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": "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" +}, +"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/firewallPolicies", +"response": { +"$ref": "NetworkFirewallPolicyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"cloneRules": { +"apiVersion": "2026-10-01-preview", +"description": "Copies rules to the specified firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.cloneRules", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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" +}, +"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" +}, +"sourceFirewallPolicy": { +"description": "The firewall policy from which to copy rules.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "DELETE", +"id": "compute.networkFirewallPolicies.delete", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy 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" +}, +"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}/global/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.get", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to get.", +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "FirewallPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Gets an association with the specified name.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.getAssociation", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried association belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"name": { +"description": "The name of the association to get from the firewall policy.", +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", +"response": { +"$ref": "FirewallPolicyAssociation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.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/firewallPolicies/{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" +] +}, +"getPacketMirroringRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a packet mirroring rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.getPacketMirroringRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried rule belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to get from the firewall policy.", +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", +"response": { +"$ref": "FirewallPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.getRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried rule belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to get from the firewall policy.", +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", +"response": { +"$ref": "FirewallPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified project using the data included in\nthe request.", +"flatPath": "projects/{project}/global/firewallPolicies", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.insert", +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all the policies that have been configured for the specified project.", +"flatPath": "projects/{project}/global/firewallPolicies", +"httpMethod": "GET", +"id": "compute.networkFirewallPolicies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/firewallPolicies", +"response": { +"$ref": "FirewallPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", +"httpMethod": "PATCH", +"id": "compute.networkFirewallPolicies.patch", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchPacketMirroringRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a packet mirroring rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.patchPacketMirroringRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to patch.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.patchRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to patch.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/patchRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Removes an association for the specified firewall policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.removeAssociation", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"name": { +"description": "Name for the attachment that will be removed.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/removeAssociation", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removePacketMirroringRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a packet mirroring rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.removePacketMirroringRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to remove from the firewall policy.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule of the specified priority.", +"flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.removeRule", +"parameterOrder": [ +"project", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to remove from the firewall policy.", +"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" +}, +"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}/global/firewallPolicies/{firewallPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.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/firewallPolicies/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.networkFirewallPolicies.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/firewallPolicies/{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" +] +} +} +}, +"networkProfiles": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network profile.", +"flatPath": "projects/{project}/global/networkProfiles/{networkProfile}", +"httpMethod": "GET", +"id": "compute.networkProfiles.get", +"parameterOrder": [ +"project", +"networkProfile" +], +"parameters": { +"networkProfile": { +"description": "Name of the network profile 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" +} +}, +"path": "projects/{project}/global/networkProfiles/{networkProfile}", +"response": { +"$ref": "NetworkProfile" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of network profiles available to the specified\nproject.", +"flatPath": "projects/{project}/global/networkProfiles", +"httpMethod": "GET", +"id": "compute.networkProfiles.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/networkProfiles", +"response": { +"$ref": "NetworkProfilesListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"networks": { +"methods": { +"addPeering": { +"apiVersion": "2026-10-01-preview", +"description": "Adds a peering to the specified network.", +"flatPath": "projects/{project}/global/networks/{network}/addPeering", +"httpMethod": "POST", +"id": "compute.networks.addPeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource to add peering to.", +"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" +}, +"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}/global/networks/{network}/addPeering", +"request": { +"$ref": "NetworksAddPeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"cancelRequestRemovePeering": { +"apiVersion": "2026-10-01-preview", +"description": "Cancel requests to remove a peering from the specified network. Applicable\nonly for PeeringConnection with update_strategy=CONSENSUS. Cancels a\nrequest to remove a peering from the specified network.", +"flatPath": "projects/{project}/global/networks/{network}/cancelRequestRemovePeering", +"httpMethod": "POST", +"id": "compute.networks.cancelRequestRemovePeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource to remove peering from.", +"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" +}, +"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}/global/networks/{network}/cancelRequestRemovePeering", +"request": { +"$ref": "NetworksCancelRequestRemovePeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified network.", +"flatPath": "projects/{project}/global/networks/{network}", +"httpMethod": "DELETE", +"id": "compute.networks.delete", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network 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" +}, +"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}/global/networks/{network}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network.", +"flatPath": "projects/{project}/global/networks/{network}", +"httpMethod": "GET", +"id": "compute.networks.get", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network 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" +} +}, +"path": "projects/{project}/global/networks/{network}", +"response": { +"$ref": "Network" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getEffectiveFirewalls": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the effective firewalls on a given network.", +"flatPath": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", +"httpMethod": "GET", +"id": "compute.networks.getEffectiveFirewalls", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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" +} +}, +"path": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", +"response": { +"$ref": "NetworksGetEffectiveFirewallsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a network in the specified project using the data included\nin the request.", +"flatPath": "projects/{project}/global/networks", +"httpMethod": "POST", +"id": "compute.networks.insert", +"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" +} +}, +"path": "projects/{project}/global/networks", +"request": { +"$ref": "Network" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of networks available to the specified project.", +"flatPath": "projects/{project}/global/networks", +"httpMethod": "GET", +"id": "compute.networks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/networks", +"response": { +"$ref": "NetworkList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listPeeringRoutes": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the peering routes exchanged over peering connection.", +"flatPath": "projects/{project}/global/networks/{network}/listPeeringRoutes", +"httpMethod": "GET", +"id": "compute.networks.listPeeringRoutes", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"direction": { +"description": "The direction of the exchanged routes.", +"enum": [ +"INCOMING", +"OUTGOING" +], +"enumDescriptions": [ +"For routes exported from peer network.", +"For routes exported from local network." +], +"location": "query", +"type": "string" +}, +"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" +}, +"network": { +"description": "Name of the network for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"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" +}, +"peeringName": { +"description": "The response will show routes exchanged over the given peering connection.", +"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": "The region of the request. The response will include all subnet routes,\nstatic routes and dynamic routes in the region.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/networks/{network}/listPeeringRoutes", +"response": { +"$ref": "ExchangedPeeringRoutesList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified network with the data included in the request.\nOnly routingConfig can be modified.", +"flatPath": "projects/{project}/global/networks/{network}", +"httpMethod": "PATCH", +"id": "compute.networks.patch", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network to update.", +"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" +}, +"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}/global/networks/{network}", +"request": { +"$ref": "Network" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removePeering": { +"apiVersion": "2026-10-01-preview", +"description": "Removes a peering from the specified network.", +"flatPath": "projects/{project}/global/networks/{network}/removePeering", +"httpMethod": "POST", +"id": "compute.networks.removePeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource to remove peering from.", +"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" +}, +"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}/global/networks/{network}/removePeering", +"request": { +"$ref": "NetworksRemovePeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"requestRemovePeering": { +"apiVersion": "2026-10-01-preview", +"description": "Requests to remove a peering from the specified network. Applicable only\nfor PeeringConnection with update_strategy=CONSENSUS.", +"flatPath": "projects/{project}/global/networks/{network}/requestRemovePeering", +"httpMethod": "POST", +"id": "compute.networks.requestRemovePeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource to remove peering from.", +"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" +}, +"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}/global/networks/{network}/requestRemovePeering", +"request": { +"$ref": "NetworksRequestRemovePeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"switchToCustomMode": { +"apiVersion": "2026-10-01-preview", +"description": "Switches the network mode from auto subnet mode to custom subnet mode.", +"flatPath": "projects/{project}/global/networks/{network}/switchToCustomMode", +"httpMethod": "POST", +"id": "compute.networks.switchToCustomMode", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network to be updated.", +"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" +}, +"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}/global/networks/{network}/switchToCustomMode", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updatePeering": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified network peering with the data included in the\nrequest. You can only modify the NetworkPeering.export_custom_routes field\nand the NetworkPeering.import_custom_routes field.", +"flatPath": "projects/{project}/global/networks/{network}/updatePeering", +"httpMethod": "PATCH", +"id": "compute.networks.updatePeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource which the updated peering is belonging to.", +"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" +}, +"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}/global/networks/{network}/updatePeering", +"request": { +"$ref": "NetworksUpdatePeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"nodeGroups": { +"methods": { +"addNodes": { +"apiVersion": "2026-10-01-preview", +"description": "Adds specified number of nodes to the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", +"httpMethod": "POST", +"id": "compute.nodeGroups.addNodes", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup resource.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", +"request": { +"$ref": "NodeGroupsAddNodesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of node groups.\nNote: use nodeGroups.listNodes for more details about each group.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/nodeGroups", +"httpMethod": "GET", +"id": "compute.nodeGroups.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": "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" +}, +"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/nodeGroups", +"response": { +"$ref": "NodeGroupAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified NodeGroup resource.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"httpMethod": "DELETE", +"id": "compute.nodeGroups.delete", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteNodes": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes specified nodes from the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", +"httpMethod": "POST", +"id": "compute.nodeGroups.deleteNodes", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup resource whose nodes will be deleted.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", +"request": { +"$ref": "NodeGroupsDeleteNodesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified NodeGroup. Get a list of available NodeGroups\nby making a list() request.\nNote: the \"nodes\" field should not be used. Use nodeGroups.listNodes\ninstead.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"httpMethod": "GET", +"id": "compute.nodeGroups.get", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the node group 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"response": { +"$ref": "NodeGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.nodeGroups.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a NodeGroup resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups", +"httpMethod": "POST", +"id": "compute.nodeGroups.insert", +"parameterOrder": [ +"project", +"zone", +"initialNodeCount" +], +"parameters": { +"initialNodeCount": { +"description": "Initial count of nodes in the node group.", +"format": "int32", +"location": "query", +"required": true, +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups", +"request": { +"$ref": "NodeGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of node groups available to the specified project.\nNote: use nodeGroups.listNodes for more details about each group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups", +"httpMethod": "GET", +"id": "compute.nodeGroups.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups", +"response": { +"$ref": "NodeGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listNodes": { +"apiVersion": "2026-10-01-preview", +"description": "Lists nodes in the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", +"httpMethod": "POST", +"id": "compute.nodeGroups.listNodes", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"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" +}, +"nodeGroup": { +"description": "Name of the NodeGroup resource whose nodes you want to list.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", +"response": { +"$ref": "NodeGroupsListNodes" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"httpMethod": "PATCH", +"id": "compute.nodeGroups.patch", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup resource to update.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", +"request": { +"$ref": "NodeGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"performMaintenance": { +"apiVersion": "2026-10-01-preview", +"description": "Perform maintenance on a subset of nodes in the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", +"httpMethod": "POST", +"id": "compute.nodeGroups.performMaintenance", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the node group scoping 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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", +"request": { +"$ref": "NodeGroupsPerformMaintenanceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.nodeGroups.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setNodeTemplate": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the node template of the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", +"httpMethod": "POST", +"id": "compute.nodeGroups.setNodeTemplate", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup resource to update.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", +"request": { +"$ref": "NodeGroupsSetNodeTemplateRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"simulateMaintenanceEvent": { +"apiVersion": "2026-10-01-preview", +"description": "Simulates maintenance event on specified nodes from the node group.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", +"httpMethod": "POST", +"id": "compute.nodeGroups.simulateMaintenanceEvent", +"parameterOrder": [ +"project", +"zone", +"nodeGroup" +], +"parameters": { +"nodeGroup": { +"description": "Name of the NodeGroup resource whose nodes will go under maintenance\nsimulation.", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", +"request": { +"$ref": "NodeGroupsSimulateMaintenanceEventRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.nodeGroups.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeGroups/{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" +] +} +} +}, +"nodeTemplates": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of node templates.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/nodeTemplates", +"httpMethod": "GET", +"id": "compute.nodeTemplates.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": "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" +}, +"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/nodeTemplates", +"response": { +"$ref": "NodeTemplateAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified NodeTemplate resource.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", +"httpMethod": "DELETE", +"id": "compute.nodeTemplates.delete", +"parameterOrder": [ +"project", +"region", +"nodeTemplate" +], +"parameters": { +"nodeTemplate": { +"description": "Name of the NodeTemplate 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": "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" +}, +"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}/nodeTemplates/{nodeTemplate}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified node template.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", +"httpMethod": "GET", +"id": "compute.nodeTemplates.get", +"parameterOrder": [ +"project", +"region", +"nodeTemplate" +], +"parameters": { +"nodeTemplate": { +"description": "Name of the node template 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": "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" +} +}, +"path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", +"response": { +"$ref": "NodeTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.nodeTemplates.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/nodeTemplates/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a NodeTemplate resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates", +"httpMethod": "POST", +"id": "compute.nodeTemplates.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": "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" +}, +"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}/nodeTemplates", +"request": { +"$ref": "NodeTemplate" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of node templates available to the specified\nproject.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates", +"httpMethod": "GET", +"id": "compute.nodeTemplates.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": "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" +} +}, +"path": "projects/{project}/regions/{region}/nodeTemplates", +"response": { +"$ref": "NodeTemplateList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.nodeTemplates.setIamPolicy", +"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}/nodeTemplates/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.nodeTemplates.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}/nodeTemplates/{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" +] +} +} +}, +"nodeTypes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of node types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/nodeTypes", +"httpMethod": "GET", +"id": "compute.nodeTypes.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": "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" +}, +"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/nodeTypes", +"response": { +"$ref": "NodeTypeAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified node type.", +"flatPath": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", +"httpMethod": "GET", +"id": "compute.nodeTypes.get", +"parameterOrder": [ +"project", +"zone", +"nodeType" +], +"parameters": { +"nodeType": { +"description": "Name of the node type 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", +"response": { +"$ref": "NodeType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of node types available to the specified\nproject.", +"flatPath": "projects/{project}/zones/{zone}/nodeTypes", +"httpMethod": "GET", +"id": "compute.nodeTypes.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/nodeTypes", +"response": { +"$ref": "NodeTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"organizationSecurityPolicies": { +"methods": { +"addAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts an association for the specified security policy.\n\nThis has billing implications. Projects in the hierarchy with effective\nhierarchical security policies will be automatically enrolled into Cloud\nArmor Enterprise if not already enrolled.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.addAssociation\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/addAssociation", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.addAssociation", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"replaceExistingAssociation": { +"description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/addAssociation", +"request": { +"$ref": "SecurityPolicyAssociation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.addRule instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.addRule", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/addRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"copyRules": { +"apiVersion": "2026-10-01-preview", +"description": "Copies rules to the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.cloneRules\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/copyRules", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.copyRules", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +}, +"sourceSecurityPolicy": { +"description": "The security policy from which to copy rules.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/copyRules", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified policy.\n\nUse this API to remove Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to remove firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.delete instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}", +"httpMethod": "DELETE", +"id": "compute.organizationSecurityPolicies.delete", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to delete.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "List all of the ordered rules present in a single specified policy.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.get instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.get", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"securityPolicy": { +"description": "Name of the security policy to get.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}", +"response": { +"$ref": "SecurityPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Gets an association with the specified name.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.getAssociation\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/getAssociation", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.getAssociation", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"name": { +"description": "The name of the association to get from the security policy.", +"location": "query", +"type": "string" +}, +"securityPolicy": { +"description": "Name of the security policy to which the queried rule belongs.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/getAssociation", +"response": { +"$ref": "SecurityPolicyAssociation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule at the specified priority.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.getRule instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.getRule", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to get from the security policy.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"securityPolicy": { +"description": "Name of the security policy to which the queried rule belongs.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/getRule", +"response": { +"$ref": "SecurityPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified organization using the data included\nin the request.\n\nUse this API to add Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to add firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.insert instead.", +"flatPath": "locations/global/securityPolicies", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.insert", +"parameters": { +"parentId": { +"description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", +"location": "query", +"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": "locations/global/securityPolicies", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "List all the policies that have been configured for the specified\norganization.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.list instead.", +"flatPath": "locations/global/securityPolicies", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.list", +"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" +}, +"parentId": { +"description": "Parent ID for this request.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/securityPolicies", +"response": { +"$ref": "SecurityPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listAssociations": { +"apiVersion": "2026-10-01-preview", +"description": "Lists associations of a specified target, i.e., organization or folder.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.listAssociations\ninstead.", +"flatPath": "locations/global/securityPolicies/listAssociations", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.listAssociations", +"parameters": { +"targetResource": { +"description": "The target resource to list associations. It is an organization, or a\nfolder.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/securityPolicies/listAssociations", +"response": { +"$ref": "OrganizationSecurityPoliciesListAssociationsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listPreconfiguredExpressionSets": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the current list of preconfigured Web Application Firewall (WAF)\nexpressions.", +"flatPath": "locations/global/securityPolicies/listPreconfiguredExpressionSets", +"httpMethod": "GET", +"id": "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets", +"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" +}, +"parentId": { +"description": "Parent ID for this request.", +"location": "query", +"type": "string" +} +}, +"path": "locations/global/securityPolicies/listPreconfiguredExpressionSets", +"response": { +"$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"move": { +"apiVersion": "2026-10-01-preview", +"description": "Moves the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.move instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/move", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.move", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"parentId": { +"description": "The new parent of the security policy.", +"location": "query", +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/move", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.patch instead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}", +"httpMethod": "PATCH", +"id": "compute.organizationSecurityPolicies.patch", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule at the specified priority.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.patchRule\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.patchRule", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to patch.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/patchRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Removes an association for the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.removeAssociation\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/removeAssociation", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.removeAssociation", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"name": { +"description": "Name for the attachment that will be removed.", +"location": "query", +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/removeAssociation", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule at the specified priority.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.removeRule\ninstead.", +"flatPath": "locations/global/securityPolicies/{securityPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.organizationSecurityPolicies.removeRule", +"parameterOrder": [ +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to remove from the security policy.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "(securityPolicies/)?[0-9]{0,20}", +"required": true, +"type": "string" +} +}, +"path": "locations/global/securityPolicies/{securityPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"packetMirrorings": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of packetMirrorings.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/packetMirrorings", +"httpMethod": "GET", +"id": "compute.packetMirrorings.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": "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" +}, +"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/packetMirrorings", +"response": { +"$ref": "PacketMirroringAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified PacketMirroring resource.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"httpMethod": "DELETE", +"id": "compute.packetMirrorings.delete", +"parameterOrder": [ +"project", +"region", +"packetMirroring" +], +"parameters": { +"packetMirroring": { +"description": "Name of the PacketMirroring 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 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" +} +}, +"path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified PacketMirroring resource.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"httpMethod": "GET", +"id": "compute.packetMirrorings.get", +"parameterOrder": [ +"project", +"region", +"packetMirroring" +], +"parameters": { +"packetMirroring": { +"description": "Name of the PacketMirroring 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"response": { +"$ref": "PacketMirroring" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a PacketMirroring resource in the specified project and region\nusing the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings", +"httpMethod": "POST", +"id": "compute.packetMirrorings.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 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" +} +}, +"path": "projects/{project}/regions/{region}/packetMirrorings", +"request": { +"$ref": "PacketMirroring" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of PacketMirroring resources available to the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings", +"httpMethod": "GET", +"id": "compute.packetMirrorings.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/packetMirrorings", +"response": { +"$ref": "PacketMirroringList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified PacketMirroring resource with the data included in\nthe request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"httpMethod": "PATCH", +"id": "compute.packetMirrorings.patch", +"parameterOrder": [ +"project", +"region", +"packetMirroring" +], +"parameters": { +"packetMirroring": { +"description": "Name of the PacketMirroring 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" +}, +"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" +} +}, +"path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", +"request": { +"$ref": "PacketMirroring" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.packetMirrorings.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}/packetMirrorings/{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" +] +} +} +}, +"previewFeatures": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the details of the given PreviewFeature.", +"flatPath": "projects/{project}/global/previewFeatures/{previewFeature}", +"httpMethod": "GET", +"id": "compute.previewFeatures.get", +"parameterOrder": [ +"project", +"previewFeature" +], +"parameters": { +"previewFeature": { +"description": "Name of the PreviewFeature 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" +}, +"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/previewFeatures/{previewFeature}", +"response": { +"$ref": "PreviewFeature" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the details of the given PreviewFeature.", +"flatPath": "projects/{project}/global/previewFeatures", +"httpMethod": "GET", +"id": "compute.previewFeatures.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/previewFeatures", +"response": { +"$ref": "PreviewFeatureList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the given PreviewFeature. This method is used to enable or disable\na PreviewFeature.", +"flatPath": "projects/{project}/global/previewFeatures/{previewFeature}", +"httpMethod": "PATCH", +"id": "compute.previewFeatures.update", +"parameterOrder": [ +"project", +"previewFeature" +], +"parameters": { +"previewFeature": { +"description": "Name of the PreviewFeature 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" +}, +"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" +} +}, +"path": "projects/{project}/global/previewFeatures/{previewFeature}", +"request": { +"$ref": "PreviewFeature" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"projectViews": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified global ProjectViews resource, with a regional\ncontext.\nThis regional API endpoint reads resource metadata from regional\nread-only replicas. Because changes are copied to these regional replicas\nasynchronously, for real-time resource reads or any write operations\n(creating, updating, or deleting resources), use the global\n[projects.get](https://cloud.google.com/compute/docs/reference/rest/v1/projects/get)\nendpoint.", +"flatPath": "projects/{project}/regions/{region}/projectViews", +"httpMethod": "GET", +"id": "compute.projectViews.get", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"project": { +"description": "Required. Project ID for this request. This is part of the URL path.", +"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": "Required. Name of the region for this request. This is part of the URL path.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/projectViews", +"response": { +"$ref": "ProjectView" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"projects": { +"methods": { +"disableXpnHost": { +"apiVersion": "2026-10-01-preview", +"description": "Disable this project as a shared VPC host project.", +"flatPath": "projects/{project}/disableXpnHost", +"httpMethod": "POST", +"id": "compute.projects.disableXpnHost", +"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" +} +}, +"path": "projects/{project}/disableXpnHost", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"disableXpnResource": { +"apiVersion": "2026-10-01-preview", +"description": "Disable a service resource (also known as service project) associated with\nthis host project.", +"flatPath": "projects/{project}/disableXpnResource", +"httpMethod": "POST", +"id": "compute.projects.disableXpnResource", +"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" +} +}, +"path": "projects/{project}/disableXpnResource", +"request": { +"$ref": "ProjectsDisableXpnResourceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"enableXpnHost": { +"apiVersion": "2026-10-01-preview", +"description": "Enable this project as a shared VPC host project.", +"flatPath": "projects/{project}/enableXpnHost", +"httpMethod": "POST", +"id": "compute.projects.enableXpnHost", +"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" +} +}, +"path": "projects/{project}/enableXpnHost", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"enableXpnResource": { +"apiVersion": "2026-10-01-preview", +"description": "Enable service resource (a.k.a service project) for a host project, so that\nsubnets in the host project can be used by instances in the service\nproject.", +"flatPath": "projects/{project}/enableXpnResource", +"httpMethod": "POST", +"id": "compute.projects.enableXpnResource", +"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" +} +}, +"path": "projects/{project}/enableXpnResource", +"request": { +"$ref": "ProjectsEnableXpnResourceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Project resource.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information (the `quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.", +"flatPath": "projects/{project}", +"httpMethod": "GET", +"id": "compute.projects.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}", +"response": { +"$ref": "Project" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getXpnHost": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the shared VPC host project that this project links to. May be empty\nif no link exists.", +"flatPath": "projects/{project}/getXpnHost", +"httpMethod": "GET", +"id": "compute.projects.getXpnHost", +"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}/getXpnHost", +"response": { +"$ref": "Project" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"getXpnResources": { +"apiVersion": "2026-10-01-preview", +"description": "Gets service resources (a.k.a service project) associated with this host\nproject.", +"flatPath": "projects/{project}/getXpnResources", +"httpMethod": "GET", +"id": "compute.projects.getXpnResources", +"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" +}, +"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" +} +}, +"path": "projects/{project}/getXpnResources", +"response": { +"$ref": "ProjectsGetXpnResources" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"listXpnHosts": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all shared VPC host projects visible to the user in an organization.", +"flatPath": "projects/{project}/listXpnHosts", +"httpMethod": "POST", +"id": "compute.projects.listXpnHosts", +"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" +}, +"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" +} +}, +"path": "projects/{project}/listXpnHosts", +"request": { +"$ref": "ProjectsListXpnHostsRequest" +}, +"response": { +"$ref": "XpnHostList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"moveDisk": { +"apiVersion": "2026-10-01-preview", +"deprecated": true, +"description": "Moves a persistent disk from one zone to another.\n*Note*: The moveDisk API will be deprecated on September 29, 2026.\n\nStarting September 29, 2025, you can't use the moveDisk API on new\nprojects. To move a disk to a different region or zone, follow the steps in\n[Change the location of a\ndisk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd).\n\nProjects that already use the moveDisk API can continue usage until\nSeptember 29, 2026.\n\nStarting November 1, 2025, API responses will include a warning message in\nthe response body about the upcoming deprecation. You can skip the message\nto continue using the service without interruption.", +"flatPath": "projects/{project}/moveDisk", +"httpMethod": "POST", +"id": "compute.projects.moveDisk", +"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" +} +}, +"path": "projects/{project}/moveDisk", +"request": { +"$ref": "DiskMoveRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"moveInstance": { +"apiVersion": "2026-10-01-preview", +"deprecated": true, +"description": "Moves an instance and its attached persistent disks from one zone to\nanother.\n*Note*: Moving VMs or disks by using this method might\n cause unexpected behavior. For more information, see the [known\n issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior).\n[Deprecated] This method is deprecated. See [moving instance across\nzones](/compute/docs/instances/moving-instance-across-zones) instead.", +"flatPath": "projects/{project}/moveInstance", +"httpMethod": "POST", +"id": "compute.projects.moveInstance", +"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" +} +}, +"path": "projects/{project}/moveInstance", +"request": { +"$ref": "InstanceMoveRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setCloudArmorTier": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the\nbilling account of the project must be subscribed to Cloud Armor\nEnterprise. See Subscribing\nto Cloud Armor Enterprise for more information.", +"flatPath": "projects/{project}/setCloudArmorTier", +"httpMethod": "POST", +"id": "compute.projects.setCloudArmorTier", +"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" +} +}, +"path": "projects/{project}/setCloudArmorTier", +"request": { +"$ref": "ProjectsSetCloudArmorTierRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setCommonInstanceMetadata": { +"apiVersion": "2026-10-01-preview", +"description": "Sets metadata common to all instances within the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/setCommonInstanceMetadata", +"httpMethod": "POST", +"id": "compute.projects.setCommonInstanceMetadata", +"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" +} +}, +"path": "projects/{project}/setCommonInstanceMetadata", +"request": { +"$ref": "Metadata" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setDefaultNetworkTier": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the default network tier of the project. The default network tier is\nused when an address/forwardingRule/instance is created without specifying\nthe network tier field.", +"flatPath": "projects/{project}/setDefaultNetworkTier", +"httpMethod": "POST", +"id": "compute.projects.setDefaultNetworkTier", +"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" +} +}, +"path": "projects/{project}/setDefaultNetworkTier", +"request": { +"$ref": "ProjectsSetDefaultNetworkTierRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setUsageExportBucket": { +"apiVersion": "2026-10-01-preview", +"description": "Enables the usage export feature and sets theusage export bucket\nwhere reports are stored. If you provide an empty request body using this\nmethod, the usage export feature will be disabled.", +"flatPath": "projects/{project}/setUsageExportBucket", +"httpMethod": "POST", +"id": "compute.projects.setUsageExportBucket", +"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" +} +}, +"path": "projects/{project}/setUsageExportBucket", +"request": { +"$ref": "UsageExportLocation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/devstorage.full_control", +"https://www.googleapis.com/auth/devstorage.read_only", +"https://www.googleapis.com/auth/devstorage.read_write" +] +} +} +}, +"publicAdvertisedPrefixes": { +"methods": { +"announce": { +"apiVersion": "2026-10-01-preview", +"description": "Announces the specified PublicAdvertisedPrefix", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", +"httpMethod": "POST", +"id": "compute.publicAdvertisedPrefixes.announce", +"parameterOrder": [ +"project", +"publicAdvertisedPrefix" +], +"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" +}, +"publicAdvertisedPrefix": { +"description": "The name of the public advertised prefix. It should comply with RFC1035.", +"location": "path", +"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}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified PublicAdvertisedPrefix", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"httpMethod": "DELETE", +"id": "compute.publicAdvertisedPrefixes.delete", +"parameterOrder": [ +"project", +"publicAdvertisedPrefix" +], +"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" +}, +"publicAdvertisedPrefix": { +"description": "Name of the PublicAdvertisedPrefix 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" +}, +"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}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified PublicAdvertisedPrefix resource.", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"httpMethod": "GET", +"id": "compute.publicAdvertisedPrefixes.get", +"parameterOrder": [ +"project", +"publicAdvertisedPrefix" +], +"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" +}, +"publicAdvertisedPrefix": { +"description": "Name of the PublicAdvertisedPrefix 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/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"response": { +"$ref": "PublicAdvertisedPrefix" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a PublicAdvertisedPrefix in the specified project\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes", +"httpMethod": "POST", +"id": "compute.publicAdvertisedPrefixes.insert", +"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" +} +}, +"path": "projects/{project}/global/publicAdvertisedPrefixes", +"request": { +"$ref": "PublicAdvertisedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the PublicAdvertisedPrefixes for a project.", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes", +"httpMethod": "GET", +"id": "compute.publicAdvertisedPrefixes.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/publicAdvertisedPrefixes", +"response": { +"$ref": "PublicAdvertisedPrefixList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"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}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"httpMethod": "PATCH", +"id": "compute.publicAdvertisedPrefixes.patch", +"parameterOrder": [ +"project", +"publicAdvertisedPrefix" +], +"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" +}, +"publicAdvertisedPrefix": { +"description": "Name of the PublicAdvertisedPrefix 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" +}, +"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}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", +"request": { +"$ref": "PublicAdvertisedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"withdraw": { +"apiVersion": "2026-10-01-preview", +"description": "Withdraws the specified PublicAdvertisedPrefix", +"flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", +"httpMethod": "POST", +"id": "compute.publicAdvertisedPrefixes.withdraw", +"parameterOrder": [ +"project", +"publicAdvertisedPrefix" +], +"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" +}, +"publicAdvertisedPrefix": { +"description": "The name of the public advertised prefix. It should comply with RFC1035.", +"location": "path", +"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}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"publicDelegatedPrefixes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all PublicDelegatedPrefix resources owned by the specific project\nacross all scopes.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/publicDelegatedPrefixes", +"httpMethod": "GET", +"id": "compute.publicDelegatedPrefixes.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" +}, +"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/publicDelegatedPrefixes", +"response": { +"$ref": "PublicDelegatedPrefixAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"announce": { +"apiVersion": "2026-10-01-preview", +"description": "Announces the specified PublicDelegatedPrefix in the given region.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", +"httpMethod": "POST", +"id": "compute.publicDelegatedPrefixes.announce", +"parameterOrder": [ +"project", +"region", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "The name of the public delegated prefix. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"region": { +"description": "The name of theregion where\nthe public delegated prefix is located. It should comply with RFC1035.", +"location": "path", +"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}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified PublicDelegatedPrefix in the given region.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "DELETE", +"id": "compute.publicDelegatedPrefixes.delete", +"parameterOrder": [ +"project", +"region", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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" +}, +"region": { +"description": "Name of the region of 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}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified PublicDelegatedPrefix resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "GET", +"id": "compute.publicDelegatedPrefixes.get", +"parameterOrder": [ +"project", +"region", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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" +}, +"region": { +"description": "Name of the region of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"response": { +"$ref": "PublicDelegatedPrefix" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a PublicDelegatedPrefix in the specified project in the given\nregion using the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", +"httpMethod": "POST", +"id": "compute.publicDelegatedPrefixes.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 of 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}/publicDelegatedPrefixes", +"request": { +"$ref": "PublicDelegatedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the PublicDelegatedPrefixes for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", +"httpMethod": "GET", +"id": "compute.publicDelegatedPrefixes.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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", +"response": { +"$ref": "PublicDelegatedPrefixList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified PublicDelegatedPrefix resource with the data included\nin the request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"httpMethod": "PATCH", +"id": "compute.publicDelegatedPrefixes.patch", +"parameterOrder": [ +"project", +"region", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "Name of the PublicDelegatedPrefix 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" +}, +"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" +} +}, +"path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", +"request": { +"$ref": "PublicDelegatedPrefix" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"withdraw": { +"apiVersion": "2026-10-01-preview", +"description": "Withdraws the specified PublicDelegatedPrefix in the given region.", +"flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", +"httpMethod": "POST", +"id": "compute.publicDelegatedPrefixes.withdraw", +"parameterOrder": [ +"project", +"region", +"publicDelegatedPrefix" +], +"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" +}, +"publicDelegatedPrefix": { +"description": "The name of the public delegated prefix. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"region": { +"description": "The name of theregion where\nthe public delegated prefix is located. It should comply with RFC1035.", +"location": "path", +"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}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionAutoscalers": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified autoscaler.", +"flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", +"httpMethod": "DELETE", +"id": "compute.regionAutoscalers.delete", +"parameterOrder": [ +"project", +"region", +"autoscaler" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler 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}/autoscalers/{autoscaler}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified autoscaler.", +"flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", +"httpMethod": "GET", +"id": "compute.regionAutoscalers.get", +"parameterOrder": [ +"project", +"region", +"autoscaler" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler 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}/autoscalers/{autoscaler}", +"response": { +"$ref": "Autoscaler" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an autoscaler in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/autoscalers", +"httpMethod": "POST", +"id": "compute.regionAutoscalers.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}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of autoscalers contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/autoscalers", +"httpMethod": "GET", +"id": "compute.regionAutoscalers.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" +} +}, +"path": "projects/{project}/regions/{region}/autoscalers", +"response": { +"$ref": "RegionAutoscalerList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an autoscaler in the specified project using\nthe data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/autoscalers", +"httpMethod": "PATCH", +"id": "compute.regionAutoscalers.patch", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler to patch.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"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}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/autoscalers/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionAutoscalers.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}/autoscalers/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an autoscaler in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/autoscalers", +"httpMethod": "PUT", +"id": "compute.regionAutoscalers.update", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"autoscaler": { +"description": "Name of the autoscaler to update.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"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}/autoscalers", +"request": { +"$ref": "Autoscaler" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionBackendBuckets": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified regional BackendBucket resource.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", +"httpMethod": "DELETE", +"id": "compute.regionBackendBuckets.delete", +"parameterOrder": [ +"project", +"region", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified regional BackendBucket resource.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", +"httpMethod": "GET", +"id": "compute.regionBackendBuckets.get", +"parameterOrder": [ +"project", +"region", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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}/backendBuckets/{backendBucket}", +"response": { +"$ref": "BackendBucket" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionBackendBuckets.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/backendBuckets/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a RegionBackendBucket in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets", +"httpMethod": "POST", +"id": "compute.regionBackendBuckets.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 of 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}/backendBuckets", +"request": { +"$ref": "BackendBucket" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of BackendBucket resources available to the specified\nproject in the given region.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets", +"httpMethod": "GET", +"id": "compute.regionBackendBuckets.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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/backendBuckets", +"response": { +"$ref": "BackendBucketList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listUsable": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of all usable backend buckets in the specified project in\nthe given region.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/listUsable", +"httpMethod": "GET", +"id": "compute.regionBackendBuckets.listUsable", +"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.\nIt must be a string that meets the requirements in RFC1035.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/backendBuckets/listUsable", +"response": { +"$ref": "BackendBucketListUsable" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified BackendBucket resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", +"httpMethod": "PATCH", +"id": "compute.regionBackendBuckets.patch", +"parameterOrder": [ +"project", +"region", +"backendBucket" +], +"parameters": { +"backendBucket": { +"description": "Name of the BackendBucket 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" +}, +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", +"request": { +"$ref": "BackendBucket" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionBackendBuckets.setIamPolicy", +"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}/backendBuckets/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionBackendBuckets.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}/backendBuckets/{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" +] +} +} +}, +"regionBackendServices": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified regional BackendService resource.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", +"httpMethod": "DELETE", +"id": "compute.regionBackendServices.delete", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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}/backendServices/{backendService}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified regional BackendService resource.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", +"httpMethod": "GET", +"id": "compute.regionBackendServices.get", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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}/backendServices/{backendService}", +"response": { +"$ref": "BackendService" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the most recent health check results for this\nregional BackendService.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", +"httpMethod": "POST", +"id": "compute.regionBackendServices.getHealth", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource for which to get health.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"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}/backendServices/{backendService}/getHealth", +"request": { +"$ref": "ResourceGroupReference" +}, +"response": { +"$ref": "BackendServiceGroupHealth" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionBackendServices.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/backendServices/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a regional BackendService resource in the specified project using\nthe data included in the request. For more information, see\nBackend services overview.", +"flatPath": "projects/{project}/regions/{region}/backendServices", +"httpMethod": "POST", +"id": "compute.regionBackendServices.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}/backendServices", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of regional BackendService resources available to the\nspecified project in the given region.", +"flatPath": "projects/{project}/regions/{region}/backendServices", +"httpMethod": "GET", +"id": "compute.regionBackendServices.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" +} +}, +"path": "projects/{project}/regions/{region}/backendServices", +"response": { +"$ref": "BackendServiceList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listUsable": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of all usable backend services for Application Load\nBalancers and Proxy Network Load Balancers in the specified project in the\ngiven region. Backend services for external and internal passthrough\nNetwork Load Balancers are not included in the response.", +"flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", +"httpMethod": "GET", +"id": "compute.regionBackendServices.listUsable", +"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.\nIt must be a string that meets the requirements in RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/backendServices/listUsable", +"response": { +"$ref": "BackendServiceListUsable" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified regional BackendService resource with the data\nincluded in the request. For more information, see \nUnderstanding backend services This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", +"httpMethod": "PATCH", +"id": "compute.regionBackendServices.patch", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService 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" +}, +"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}/backendServices/{backendService}", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionBackendServices.setIamPolicy", +"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}/backendServices/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Google Cloud Armor security policy for the specified backend\nservice. For more information, seeGoogle\nCloud Armor Overview", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", +"httpMethod": "POST", +"id": "compute.regionBackendServices.setSecurityPolicy", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to which the security policy should be\nset. The name 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" +}, +"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}/backendServices/{backendService}/setSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionBackendServices.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}/backendServices/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified regional BackendService resource with the data\nincluded in the request. For more information,\nsee \nBackend services overview.", +"flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", +"httpMethod": "PUT", +"id": "compute.regionBackendServices.update", +"parameterOrder": [ +"project", +"region", +"backendService" +], +"parameters": { +"backendService": { +"description": "Name of the BackendService resource to update.", +"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}/backendServices/{backendService}", +"request": { +"$ref": "BackendService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionCommitments": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of commitments by region.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/commitments", +"httpMethod": "GET", +"id": "compute.regionCommitments.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": "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" +}, +"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/commitments", +"response": { +"$ref": "CommitmentAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified commitment resource.", +"flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", +"httpMethod": "GET", +"id": "compute.regionCommitments.get", +"parameterOrder": [ +"project", +"region", +"commitment" +], +"parameters": { +"commitment": { +"description": "Name of the commitment 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/commitments/{commitment}", +"response": { +"$ref": "Commitment" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a commitment in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/commitments", +"httpMethod": "POST", +"id": "compute.regionCommitments.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 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" +} +}, +"path": "projects/{project}/regions/{region}/commitments", +"request": { +"$ref": "Commitment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of commitments contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/commitments", +"httpMethod": "GET", +"id": "compute.regionCommitments.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/commitments", +"response": { +"$ref": "CommitmentList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified commitment with the data included in the request.\nUpdate is performed only on selected fields included as part of\nupdate-mask. Only the following fields can be updated: auto_renew and plan.", +"flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", +"httpMethod": "PATCH", +"id": "compute.regionCommitments.update", +"parameterOrder": [ +"project", +"region", +"commitment" +], +"parameters": { +"commitment": { +"description": "Name of the commitment that you want to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"paths": { +"location": "query", +"repeated": 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 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" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/commitments/{commitment}", +"request": { +"$ref": "Commitment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionCompositeHealthChecks": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all CompositeHealthCheck resources (all\nregional) 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/compositeHealthChecks", +"httpMethod": "GET", +"id": "compute.regionCompositeHealthChecks.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" +}, +"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/compositeHealthChecks", +"response": { +"$ref": "CompositeHealthCheckAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified CompositeHealthCheck in the given region", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", +"httpMethod": "DELETE", +"id": "compute.regionCompositeHealthChecks.delete", +"parameterOrder": [ +"project", +"region", +"compositeHealthCheck" +], +"parameters": { +"compositeHealthCheck": { +"description": "Name of the CompositeHealthCheck 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}/compositeHealthChecks/{compositeHealthCheck}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified CompositeHealthCheck resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", +"httpMethod": "GET", +"id": "compute.regionCompositeHealthChecks.get", +"parameterOrder": [ +"project", +"region", +"compositeHealthCheck" +], +"parameters": { +"compositeHealthCheck": { +"description": "Name of the CompositeHealthCheck 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}/compositeHealthChecks/{compositeHealthCheck}", +"response": { +"$ref": "CompositeHealthCheck" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the most recent health check results for this\nregional CompositeHealthCheck.", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}/getHealth", +"httpMethod": "GET", +"id": "compute.regionCompositeHealthChecks.getHealth", +"parameterOrder": [ +"project", +"region", +"compositeHealthCheck" +], +"parameters": { +"compositeHealthCheck": { +"description": "Name of the CompositeHealthCheck resource to get health for.", +"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": "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" +}, +"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}/compositeHealthChecks/{compositeHealthCheck}/getHealth", +"response": { +"$ref": "CompositeHealthCheckHealth" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Create a CompositeHealthCheck in the specified project in the given region\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks", +"httpMethod": "POST", +"id": "compute.regionCompositeHealthChecks.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}/compositeHealthChecks", +"request": { +"$ref": "CompositeHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the CompositeHealthChecks for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks", +"httpMethod": "GET", +"id": "compute.regionCompositeHealthChecks.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" +} +}, +"path": "projects/{project}/regions/{region}/compositeHealthChecks", +"response": { +"$ref": "CompositeHealthCheckList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified regional CompositeHealthCheck 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}/compositeHealthChecks/{compositeHealthCheck}", +"httpMethod": "PATCH", +"id": "compute.regionCompositeHealthChecks.patch", +"parameterOrder": [ +"project", +"region", +"compositeHealthCheck" +], +"parameters": { +"compositeHealthCheck": { +"description": "Name of the CompositeHealthCheck 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}/compositeHealthChecks/{compositeHealthCheck}", +"request": { +"$ref": "CompositeHealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionCompositeHealthChecks.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}/compositeHealthChecks/{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" +] +} +} +}, +"regionDiskTypes": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified regional disk type.", +"flatPath": "projects/{project}/regions/{region}/diskTypes/{diskType}", +"httpMethod": "GET", +"id": "compute.regionDiskTypes.get", +"parameterOrder": [ +"project", +"region", +"diskType" +], +"parameters": { +"diskType": { +"description": "Name of the disk type 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": "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" +} +}, +"path": "projects/{project}/regions/{region}/diskTypes/{diskType}", +"response": { +"$ref": "DiskType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of regional disk types available to the specified project.", +"flatPath": "projects/{project}/regions/{region}/diskTypes", +"httpMethod": "GET", +"id": "compute.regionDiskTypes.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": "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" +} +}, +"path": "projects/{project}/regions/{region}/diskTypes", +"response": { +"$ref": "RegionDiskTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionDisks": { +"methods": { +"addResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Adds existing resource policies to a regional disk. You can only add one\npolicy which will be applied to this disk for scheduling snapshot\ncreation.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", +"httpMethod": "POST", +"id": "compute.regionDisks.addResourcePolicies", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"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" +}, +"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}/disks/{disk}/addResourcePolicies", +"request": { +"$ref": "RegionDisksAddResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"bulkInsert": { +"apiVersion": "2026-10-01-preview", +"description": "Bulk create a set of disks.", +"flatPath": "projects/{project}/regions/{region}/disks/bulkInsert", +"httpMethod": "POST", +"id": "compute.regionDisks.bulkInsert", +"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": "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" +}, +"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}/disks/bulkInsert", +"request": { +"$ref": "BulkInsertDiskResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"createSnapshot": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a snapshot of a specified persistent disk. For regular snapshot\ncreation, consider using snapshots.insert\ninstead, as that method supports more features, such as creating snapshots\nin a project different from the source disk project.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", +"httpMethod": "POST", +"id": "compute.regionDisks.createSnapshot", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the regional persistent disk to snapshot.", +"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 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" +} +}, +"path": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", +"request": { +"$ref": "Snapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified regional persistent disk. Deleting a regional disk\nremoves all the replicas of its data permanently and is irreversible.\nHowever, deleting a disk does not delete anysnapshots\npreviously made from the disk. You must separatelydelete\nsnapshots.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}", +"httpMethod": "DELETE", +"id": "compute.regionDisks.delete", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the regional persistent disk to delete.", +"location": "path", +"pattern": "\\S{1,66}", +"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 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" +} +}, +"path": "projects/{project}/regions/{region}/disks/{disk}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns a specified regional persistent disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}", +"httpMethod": "GET", +"id": "compute.regionDisks.get", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the regional persistent disk 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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/disks/{disk}", +"response": { +"$ref": "Disk" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionDisks.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/disks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a persistent regional disk in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/disks", +"httpMethod": "POST", +"id": "compute.regionDisks.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 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" +}, +"sourceImage": { +"description": "Source image to restore onto a disk. This field is optional.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/disks", +"request": { +"$ref": "Disk" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of persistent disks contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/disks", +"httpMethod": "GET", +"id": "compute.regionDisks.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/disks", +"response": { +"$ref": "DiskList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"removeResourcePolicies": { +"apiVersion": "2026-10-01-preview", +"description": "Removes resource policies from a regional disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", +"httpMethod": "POST", +"id": "compute.regionDisks.removeResourcePolicies", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"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" +}, +"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}/disks/{disk}/removeResourcePolicies", +"request": { +"$ref": "RegionDisksRemoveResourcePoliciesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resize": { +"apiVersion": "2026-10-01-preview", +"description": "Resizes the specified regional persistent disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/resize", +"httpMethod": "POST", +"id": "compute.regionDisks.resize", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the regional persistent disk.", +"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": "The 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" +} +}, +"path": "projects/{project}/regions/{region}/disks/{disk}/resize", +"request": { +"$ref": "RegionDisksResizeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionDisks.setIamPolicy", +"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}/disks/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on the target regional disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.regionDisks.setLabels", +"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 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" +}, +"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}/disks/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"startAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Starts asynchronous replication.\nMust be invoked on the primary disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", +"httpMethod": "POST", +"id": "compute.regionDisks.startAsyncReplication", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "The name of the persistent disk.", +"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": "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" +}, +"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}/disks/{disk}/startAsyncReplication", +"request": { +"$ref": "RegionDisksStartAsyncReplicationRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Stops asynchronous replication.\nCan be invoked either on the primary or on the secondary disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", +"httpMethod": "POST", +"id": "compute.regionDisks.stopAsyncReplication", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "The name of the persistent disk.", +"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": "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" +}, +"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}/disks/{disk}/stopAsyncReplication", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopGroupAsyncReplication": { +"apiVersion": "2026-10-01-preview", +"description": "Stops asynchronous replication for a consistency group of disks.\nCan be invoked either in the primary or secondary scope.", +"flatPath": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", +"httpMethod": "POST", +"id": "compute.regionDisks.stopGroupAsyncReplication", +"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": "The name of the region for this request. This must be the region of the\nprimary or secondary disks in the consistency group.", +"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}/disks/stopGroupAsyncReplication", +"request": { +"$ref": "DisksStopGroupAsyncReplicationResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionDisks.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}/disks/{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": { +"apiVersion": "2026-10-01-preview", +"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", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "The disk name 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" +}, +"paths": { +"location": "query", +"repeated": 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": "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" +}, +"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}/regions/{region}/disks/{disk}", +"request": { +"$ref": "Disk" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateKmsKey": { +"apiVersion": "2026-10-01-preview", +"description": "Rotates the customer-managed\nencryption key to the latest version for the specified persistent disk.", +"flatPath": "projects/{project}/regions/{region}/disks/{disk}/updateKmsKey", +"httpMethod": "POST", +"id": "compute.regionDisks.updateKmsKey", +"parameterOrder": [ +"project", +"region", +"disk" +], +"parameters": { +"disk": { +"description": "Name of the Disk resource, 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" +}, +"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" +}, +"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}/disks/{disk}/updateKmsKey", +"request": { +"$ref": "RegionDiskUpdateKmsKeyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionHealthAggregationPolicies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"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" +}, +"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": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HealthAggregationPolicy in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", +"httpMethod": "DELETE", +"id": "compute.regionHealthAggregationPolicies.delete", +"parameterOrder": [ +"project", +"region", +"healthAggregationPolicy" +], +"parameters": { +"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" +}, +"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}/healthAggregationPolicies/{healthAggregationPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified HealthAggregationPolicy resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", +"httpMethod": "GET", +"id": "compute.regionHealthAggregationPolicies.get", +"parameterOrder": [ +"project", +"region", +"healthAggregationPolicy" +], +"parameters": { +"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" +}, +"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}/healthAggregationPolicies/{healthAggregationPolicy}", +"response": { +"$ref": "HealthAggregationPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"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.regionHealthAggregationPolicies.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}/healthAggregationPolicies", +"request": { +"$ref": "HealthAggregationPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the HealthAggregationPolicies for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", +"httpMethod": "GET", +"id": "compute.regionHealthAggregationPolicies.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" +} +}, +"path": "projects/{project}/regions/{region}/healthAggregationPolicies", +"response": { +"$ref": "HealthAggregationPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"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.regionHealthAggregationPolicies.patch", +"parameterOrder": [ +"project", +"region", +"healthAggregationPolicy" +], +"parameters": { +"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" +}, +"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}/healthAggregationPolicies/{healthAggregationPolicy}", +"request": { +"$ref": "HealthAggregationPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionHealthAggregationPolicies.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}/healthAggregationPolicies/{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" +] +} +} +}, +"regionHealthCheckServices": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all HealthCheckService 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/healthCheckServices", +"httpMethod": "GET", +"id": "compute.regionHealthCheckServices.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" +}, +"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/healthCheckServices", +"response": { +"$ref": "HealthCheckServiceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified regional HealthCheckService.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"httpMethod": "DELETE", +"id": "compute.regionHealthCheckServices.delete", +"parameterOrder": [ +"project", +"region", +"healthCheckService" +], +"parameters": { +"healthCheckService": { +"description": "Name of the HealthCheckService to delete. 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}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified regional HealthCheckService resource.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"httpMethod": "GET", +"id": "compute.regionHealthCheckServices.get", +"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" +} +}, +"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"response": { +"$ref": "HealthCheckService" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"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.regionHealthCheckServices.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}/healthCheckServices", +"request": { +"$ref": "HealthCheckService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"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.regionHealthCheckServices.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" +} +}, +"path": "projects/{project}/regions/{region}/healthCheckServices", +"response": { +"$ref": "HealthCheckServicesList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"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.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": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HealthCheck resource.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"httpMethod": "DELETE", +"id": "compute.regionHealthChecks.delete", +"parameterOrder": [ +"project", +"region", +"healthCheck" +], +"parameters": { +"healthCheck": { +"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": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"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" +} +}, +"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": { +"apiVersion": "2026-10-01-preview", +"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, +"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}", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionHealthChecks.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}/healthChecks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"httpMethod": "PUT", +"id": "compute.regionHealthChecks.update", +"parameterOrder": [ +"project", +"region", +"healthCheck" +], +"parameters": { +"healthCheck": { +"description": "Name of the HealthCheck resource to update.", +"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}", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionHealthSources": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all HealthSource resources (all\nregional) available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/healthSources", +"httpMethod": "GET", +"id": "compute.regionHealthSources.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" +}, +"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/healthSources", +"response": { +"$ref": "HealthSourceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified HealthSource in the given region", +"flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}", +"httpMethod": "DELETE", +"id": "compute.regionHealthSources.delete", +"parameterOrder": [ +"project", +"region", +"healthSource" +], +"parameters": { +"healthSource": { +"description": "Name of the HealthSource 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}/healthSources/{healthSource}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified HealthSource resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}", +"httpMethod": "GET", +"id": "compute.regionHealthSources.get", +"parameterOrder": [ +"project", +"region", +"healthSource" +], +"parameters": { +"healthSource": { +"description": "Name of the HealthSource 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}/healthSources/{healthSource}", +"response": { +"$ref": "HealthSource" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the most recent health check results for this\nregional HealthSource.", +"flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}/getHealth", +"httpMethod": "GET", +"id": "compute.regionHealthSources.getHealth", +"parameterOrder": [ +"project", +"region", +"healthSource" +], +"parameters": { +"healthSource": { +"description": "Name of the HealthSource resource to get health for.", +"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": "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" +}, +"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}/healthSources/{healthSource}/getHealth", +"response": { +"$ref": "HealthSourceHealth" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Create a HealthSource in the specified project in the given region\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/healthSources", +"httpMethod": "POST", +"id": "compute.regionHealthSources.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}/healthSources", +"request": { +"$ref": "HealthSource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the HealthSources for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthSources", +"httpMethod": "GET", +"id": "compute.regionHealthSources.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" +} +}, +"path": "projects/{project}/regions/{region}/healthSources", +"response": { +"$ref": "HealthSourceList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified regional HealthSource 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}/healthSources/{healthSource}", +"httpMethod": "PATCH", +"id": "compute.regionHealthSources.patch", +"parameterOrder": [ +"project", +"region", +"healthSource" +], +"parameters": { +"healthSource": { +"description": "Name of the HealthSource 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}/healthSources/{healthSource}", +"request": { +"$ref": "HealthSource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/healthSources/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionHealthSources.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}/healthSources/{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" +] +} +} +}, +"regionInstanceGroupManagerResizeRequests": { +"methods": { +"cancel": { +"apiVersion": "2026-10-01-preview", +"description": "Cancels the specified resize request.\nCancelled resize request no longer waits for the resources to be\nprovisioned. Cancel is only possible for requests that are in accepted\nstate.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagerResizeRequests.cancel", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", +"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": "The name of the region\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"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" +}, +"resizeRequest": { +"description": "The name of the resize request to cancel.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified, inactive resize request. Requests that are still\nactive cannot be deleted. Deleting request does not delete instances that\nwere provisioned previously.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"httpMethod": "DELETE", +"id": "compute.regionInstanceGroupManagerResizeRequests.delete", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", +"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": "The name of the region\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"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" +}, +"resizeRequest": { +"description": "The name of the resize request to delete.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns all of the details about the specified resize request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"httpMethod": "GET", +"id": "compute.regionInstanceGroupManagerResizeRequests.get", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager", +"resizeRequest" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", +"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": "The name of the region\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"resizeRequest": { +"description": "The name of the resize request.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", +"response": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new Resize Request that starts provisioning VMs immediately\nor queues VM creation.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagerResizeRequests.insert", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group to which the resize request is scoped.\nName should conform to RFC1035 or be a resource ID.", +"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\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"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}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"request": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Resize Requests that are contained in the\nmanaged instance group.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"httpMethod": "GET", +"id": "compute.regionInstanceGroupManagerResizeRequests.list", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group. The name should conform to RFC1035.", +"location": "path", +"required": true, +"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\nscoping this request. Name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", +"response": { +"$ref": "RegionInstanceGroupManagerResizeRequestsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionInstanceGroupManagers": { +"methods": { +"abandonInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances to be immediately removed from the managed\ninstance group. Abandoning an instance does not delete the\ninstance, but it does remove the instance from any target pools that are\napplied by the managed instance group. This method reduces thetargetSize of the managed instance group by the\nnumber of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have\nnot yet been removed from the group. You must separately verify the\nstatus of the abandoning action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.abandonInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", +"request": { +"$ref": "RegionInstanceGroupManagersAbandonInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"applyUpdatesToInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Apply updates to selected instances the managed instance group.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.applyUpdatesToInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group, 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" +}, +"region": { +"description": "Name of the region scoping this request, should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", +"request": { +"$ref": "RegionInstanceGroupManagersApplyUpdatesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"createInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Creates instances with per-instance configurations in this regional managed\ninstance group. Instances are created using the current instance template.\nThe create instances operation is marked DONE if\nthe createInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances\nmethod.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.createInstances", +"parameterOrder": [ +"project", +"region", +"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" +}, +"region": { +"description": "The name of theregion\nwhere the managed instance group is located.\nIt should conform to RFC1035.", +"location": "path", +"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" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", +"request": { +"$ref": "RegionInstanceGroupManagersCreateInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified managed instance group and all of the instances\nin that group.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "DELETE", +"id": "compute.regionInstanceGroupManagers.delete", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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", +"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}/instanceGroupManagers/{instanceGroupManager}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nimmediately deleted. The instances are also removed from any target\npools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of\ninstances that you delete.\nThe deleteInstances operation is marked DONE if\nthe deleteInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.deleteInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", +"request": { +"$ref": "RegionInstanceGroupManagersDeleteInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deletePerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes selected per-instance configurations for the managed instance\ngroup.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group. It 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" +}, +"region": { +"description": "Name of the region scoping this request, should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", +"request": { +"$ref": "RegionInstanceGroupManagerDeleteInstanceConfigReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns all of the details about the specified managed instance group.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "GET", +"id": "compute.regionInstanceGroupManagers.get", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group to return.", +"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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", +"response": { +"$ref": "InstanceGroupManager" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a managed instance group using the information that you specify\nin the request. After the group is created, instances in the group are\ncreated using the specified instance template.\nThis operation is marked as DONE when the group is created\neven if the instances in the group have not yet been created. You must\nseparately verify the status of the individual instances with thelistmanagedinstances\nmethod.\n\nA regional managed instance group can contain up to 2000 instances.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.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", +"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}/instanceGroupManagers", +"request": { +"$ref": "InstanceGroupManager" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of managed instance groups that are contained\nwithin the specified region.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", +"httpMethod": "GET", +"id": "compute.regionInstanceGroupManagers.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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers", +"response": { +"$ref": "RegionInstanceGroupManagerList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listErrors": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all errors thrown by actions on instances for a given regional\nmanaged instance group. The filter andorderBy query parameters are not supported.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", +"httpMethod": "GET", +"id": "compute.regionInstanceGroupManagers.listErrors", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group.\nIt must be a string that meets the requirements in RFC1035, or an\nunsigned long integer: must match regexp pattern:\n(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", +"location": "path", +"required": true, +"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.\nThis should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", +"response": { +"$ref": "RegionInstanceGroupManagersListErrorsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listManagedInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the instances in the managed instance group and instances that are\nscheduled to be created. The list includes any current actions\nthat the group has scheduled for its instances. The orderBy\nquery parameter is not supported. The `pageToken` query parameter is\nsupported only if the group's `listManagedInstancesResults` field is set\nto `PAGINATED`.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.listManagedInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", +"response": { +"$ref": "RegionInstanceGroupManagersListInstancesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listPerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all of the per-instance configurations defined for the managed\ninstance group. The orderBy query parameter is not supported.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"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" +}, +"instanceGroupManager": { +"description": "The name of the managed instance group. It should conform to RFC1035.", +"location": "path", +"required": true, +"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, should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", +"response": { +"$ref": "RegionInstanceGroupManagersListInstanceConfigsResp" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates a managed instance group using the information that you specify\nin the request.\nThis operation is marked as DONE when the group is patched\neven if the instances in the group are still in the process of being\npatched. You must separately verify the status of the individual instances\nwith the listmanagedinstances\nmethod. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.\n\nIf you update your group to specify a new template or instance\nconfiguration, it's possible that your intended specification for each VM\nin the group is different from the current state of that VM. To learn how\nto apply an updated configuration to the VMs in a MIG, seeUpdating instances in\na MIG.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", +"httpMethod": "PATCH", +"id": "compute.regionInstanceGroupManagers.patch", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the instance group manager.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}", +"request": { +"$ref": "InstanceGroupManager" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchPerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts or patches per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", +"parameterOrder": [ +"project", +"region", +"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" +}, +"region": { +"description": "Name of the region scoping this request, should conform to RFC1035.", +"location": "path", +"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}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", +"request": { +"$ref": "RegionInstanceGroupManagerPatchInstanceConfigReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"recreateInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified VM instances in the managed instance group to be\nimmediately recreated. Each instance is recreated using the group's current\nconfiguration. This operation is marked as DONE when the flag\nis set even if the instances have not yet been recreated. You must\nseparately verify the status of each instance by checking itscurrentAction field; for more information, see Checking\nthe status of managed instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.recreateInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance recreation even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", +"request": { +"$ref": "RegionInstanceGroupManagersRecreateRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resize": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the intended size of the managed instance group. If you increase\nthe size, the group creates new instances using the current instance\ntemplate. If you decrease the size, the group deletes one or more\ninstances.\n\nThe resize operation is marked DONE if theresize request is successful. The underlying actions take\nadditional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.resize", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager", +"size" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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" +}, +"size": { +"description": "Number of instances that should exist in this instance group\nmanager.", +"format": "int32", +"location": "query", +"minimum": "0", +"required": true, +"type": "integer" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resumeInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nresumed. This method increases thetargetSize and decreases the targetSuspendedSize\nof the managed instance group by the number of instances that you resume.\nThe resumeInstances operation is marked DONE if\nthe resumeInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are suspended. For\nexample, if an instance was previously suspended using the suspendInstances\nmethod, it can be resumed using the resumeInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are resumed.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.resumeInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", +"request": { +"$ref": "RegionInstanceGroupManagersResumeInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setInstanceTemplate": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the instance template to use when creating new instances or recreating\ninstances in this group. Existing instances are not affected.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.setInstanceTemplate", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", +"request": { +"$ref": "RegionInstanceGroupManagersSetTemplateRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setTargetPools": { +"apiVersion": "2026-10-01-preview", +"description": "Modifies the target pools to which all new instances in this group are\nassigned. Existing instances in the group are not affected.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.setTargetPools", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", +"request": { +"$ref": "RegionInstanceGroupManagersSetTargetPoolsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"startInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nstarted. This method increases thetargetSize and decreases the targetStoppedSize\nof the managed instance group by the number of instances that you start.\nThe startInstances operation is marked DONE if\nthe startInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are stopped. For\nexample, if an instance was previously stopped using the stopInstances\nmethod, it can be started using the startInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are started.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/startInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.startInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/startInstances", +"request": { +"$ref": "RegionInstanceGroupManagersStartInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"stopInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nimmediately stopped. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetStoppedSize\nof the managed instance group by the number of instances that you stop.\nThe stopInstances operation is marked DONE if\nthe stopInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays stopping the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is stopped.\n\nStopped instances can be started using the startInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/stopInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.stopInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.", +"location": "path", +"required": true, +"type": "string" +}, +"noGracefulShutdown": { +"default": "false", +"description": "When set, graceful shutdown is skipped for instance stopping even if it's\nconfigured for the instances.", +"location": "query", +"type": "boolean" +}, +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/stopInstances", +"request": { +"$ref": "RegionInstanceGroupManagersStopInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"suspendInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Flags the specified instances in the managed instance group to be\nimmediately suspended. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetSuspendedSize\nof the managed instance group by the number of instances that you suspend.\nThe suspendInstances operation is marked DONE if\nthe suspendInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays suspension of the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is suspended.\n\nSuspended instances can be resumed using the resumeInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.suspendInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "Name of the managed instance group.", +"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", +"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}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", +"request": { +"$ref": "RegionInstanceGroupManagersSuspendInstancesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updatePerInstanceConfigs": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts or updates per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", +"flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", +"httpMethod": "POST", +"id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", +"parameterOrder": [ +"project", +"region", +"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" +}, +"region": { +"description": "Name of the region scoping this request, should conform to RFC1035.", +"location": "path", +"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}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", +"request": { +"$ref": "RegionInstanceGroupManagerUpdateInstanceConfigReq" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionInstanceGroups": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified instance group resource.", +"flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", +"httpMethod": "GET", +"id": "compute.regionInstanceGroups.get", +"parameterOrder": [ +"project", +"region", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "Name of the instance group resource to return.", +"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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", +"response": { +"$ref": "InstanceGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of instance group resources contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/instanceGroups", +"httpMethod": "GET", +"id": "compute.regionInstanceGroups.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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroups", +"response": { +"$ref": "RegionInstanceGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listInstances": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the instances in the specified instance group and displays\ninformation about the named ports. Depending on the specified options, this\nmethod can list all instances or only the instances that are running.\nThe orderBy query parameter is not supported.", +"flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", +"httpMethod": "POST", +"id": "compute.regionInstanceGroups.listInstances", +"parameterOrder": [ +"project", +"region", +"instanceGroup" +], +"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" +}, +"instanceGroup": { +"description": "Name of the regional instance group for which we want to list the\ninstances.", +"location": "path", +"required": true, +"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", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", +"request": { +"$ref": "RegionInstanceGroupsListInstancesRequest" +}, +"response": { +"$ref": "RegionInstanceGroupsListInstances" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setNamedPorts": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the named ports for the specified regional instance group.", +"flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", +"httpMethod": "POST", +"id": "compute.regionInstanceGroups.setNamedPorts", +"parameterOrder": [ +"project", +"region", +"instanceGroup" +], +"parameters": { +"instanceGroup": { +"description": "The name of the regional instance group where the named ports are updated.", +"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", +"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}/instanceGroups/{instanceGroup}/setNamedPorts", +"request": { +"$ref": "RegionInstanceGroupsSetNamedPortsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/instanceGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionInstanceGroups.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}/instanceGroups/{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" +] +} +} +}, +"regionInstanceTemplates": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified instance template. Deleting an instance template is\npermanent and cannot be undone.", +"flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", +"httpMethod": "DELETE", +"id": "compute.regionInstanceTemplates.delete", +"parameterOrder": [ +"project", +"region", +"instanceTemplate" +], +"parameters": { +"instanceTemplate": { +"description": "The name of the instance template 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": "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" +}, +"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}/instanceTemplates/{instanceTemplate}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified instance template.", +"flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", +"httpMethod": "GET", +"id": "compute.regionInstanceTemplates.get", +"parameterOrder": [ +"project", +"region", +"instanceTemplate" +], +"parameters": { +"instanceTemplate": { +"description": "The name of the instance template.", +"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": "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" +} +}, +"path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", +"response": { +"$ref": "InstanceTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instance template in the specified project and region using the\nglobal instance template whose URL is included in the request.", +"flatPath": "projects/{project}/regions/{region}/instanceTemplates", +"httpMethod": "POST", +"id": "compute.regionInstanceTemplates.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": "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" +}, +"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}/instanceTemplates", +"request": { +"$ref": "InstanceTemplate" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of instance templates that are contained within the\nspecified project and region.", +"flatPath": "projects/{project}/regions/{region}/instanceTemplates", +"httpMethod": "GET", +"id": "compute.regionInstanceTemplates.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": "The name of the regions for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instanceTemplates", +"response": { +"$ref": "InstanceTemplateList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionInstances": { +"methods": { +"bulkInsert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates multiple instances in a given region. Count specifies the number of\ninstances to create.", +"flatPath": "projects/{project}/regions/{region}/instances/bulkInsert", +"httpMethod": "POST", +"id": "compute.regionInstances.bulkInsert", +"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": "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" +}, +"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}/instances/bulkInsert", +"request": { +"$ref": "BulkInsertInstanceResource" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionInstantSnapshotGroups": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "deletes a Regional InstantSnapshotGroup resource", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", +"httpMethod": "DELETE", +"id": "compute.regionInstantSnapshotGroups.delete", +"parameterOrder": [ +"project", +"region", +"instantSnapshotGroup" +], +"parameters": { +"instantSnapshotGroup": { +"description": "Name of the InstantSnapshotGroup 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": "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" +}, +"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}/instantSnapshotGroups/{instantSnapshotGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "returns the specified InstantSnapshotGroup resource in the specified\nregion.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshotGroups.get", +"parameterOrder": [ +"project", +"region", +"instantSnapshotGroup" +], +"parameters": { +"instantSnapshotGroup": { +"description": "Name of the InstantSnapshotGroup 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": "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" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", +"response": { +"$ref": "InstantSnapshotGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshotGroups.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/instantSnapshotGroups/{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": { +"apiVersion": "2026-10-01-preview", +"description": "creates a Regional InstantSnapshotGroup resource", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshotGroups.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 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" +}, +"sourceConsistencyGroup": { +"description": "begin_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshotGroups", +"request": { +"$ref": "InstantSnapshotGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "retrieves the list of InstantSnapshotGroup resources contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshotGroups.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": "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" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshotGroups", +"response": { +"$ref": "ListInstantSnapshotGroups" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshotGroups.setIamPolicy", +"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}/instantSnapshotGroups/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshotGroups.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}/instantSnapshotGroups/{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" +] +} +} +}, +"regionInstantSnapshots": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting\na single instantSnapshot might not necessarily delete all the data on that\ninstantSnapshot. If any data on the instantSnapshot that is marked for\ndeletion is needed for subsequent instantSnapshots, the data will be moved\nto the next corresponding instantSnapshot.\n\nFor more information, seeDeleting\ninstantSnapshots.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", +"httpMethod": "DELETE", +"id": "compute.regionInstantSnapshots.delete", +"parameterOrder": [ +"project", +"region", +"instantSnapshot" +], +"parameters": { +"instantSnapshot": { +"description": "Name of the InstantSnapshot 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": "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" +}, +"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}/instantSnapshots/{instantSnapshot}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified InstantSnapshot resource in the specified region.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshots.get", +"parameterOrder": [ +"project", +"region", +"instantSnapshot" +], +"parameters": { +"instantSnapshot": { +"description": "Name of the InstantSnapshot 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": "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" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", +"response": { +"$ref": "InstantSnapshot" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshots.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/instantSnapshots/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates an instant snapshot in the specified region.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshots.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 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" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshots", +"request": { +"$ref": "InstantSnapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of InstantSnapshot resources contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots", +"httpMethod": "GET", +"id": "compute.regionInstantSnapshots.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": "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" +} +}, +"path": "projects/{project}/regions/{region}/instantSnapshots", +"response": { +"$ref": "InstantSnapshotList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshots.setIamPolicy", +"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}/instantSnapshots/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a instantSnapshot in the given region. To learn more\nabout labels, read the Labeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshots.setLabels", +"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 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" +}, +"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}/instantSnapshots/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionInstantSnapshots.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}/instantSnapshots/{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" +] +} +} +}, +"regionNetworkEndpointGroups": { +"methods": { +"attachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Attach a list of network endpoints to the specified network endpoint group.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.regionNetworkEndpointGroups.attachNetworkEndpoints", +"parameterOrder": [ +"project", +"region", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should 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": "The name of the region where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", +"location": "path", +"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}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", +"request": { +"$ref": "RegionNetworkEndpointGroupsAttachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified network endpoint group. Note that the NEG cannot be\ndeleted if it is configured as a backend of a backend service.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "DELETE", +"id": "compute.regionNetworkEndpointGroups.delete", +"parameterOrder": [ +"project", +"region", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", +"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": "The name of the region where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"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}/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"detachNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Detach the network endpoint from the specified network endpoint group.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.regionNetworkEndpointGroups.detachNetworkEndpoints", +"parameterOrder": [ +"project", +"region", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group you are detaching network\nendpoints from. It should 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": "The name of the region where\nthe network endpoint group is located. It should comply with\nRFC1035.", +"location": "path", +"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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", +"request": { +"$ref": "RegionNetworkEndpointGroupsDetachEndpointsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network endpoint group.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", +"httpMethod": "GET", +"id": "compute.regionNetworkEndpointGroups.get", +"parameterOrder": [ +"project", +"region", +"networkEndpointGroup" +], +"parameters": { +"networkEndpointGroup": { +"description": "The name of the network endpoint group. It should 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": "The name of the region where\nthe network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", +"response": { +"$ref": "NetworkEndpointGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", +"httpMethod": "POST", +"id": "compute.regionNetworkEndpointGroups.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": "The name of the region where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", +"location": "path", +"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}/networkEndpointGroups", +"request": { +"$ref": "NetworkEndpointGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of regional network endpoint groups available to the\nspecified project in the given region.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", +"httpMethod": "GET", +"id": "compute.regionNetworkEndpointGroups.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": "The name of theregion\nwhere the network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkEndpointGroups", +"response": { +"$ref": "NetworkEndpointGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listNetworkEndpoints": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the network endpoints in the specified network endpoint group.", +"flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"httpMethod": "POST", +"id": "compute.regionNetworkEndpointGroups.listNetworkEndpoints", +"parameterOrder": [ +"project", +"region", +"networkEndpointGroup" +], +"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" +}, +"networkEndpointGroup": { +"description": "The name of the network endpoint group from which you want to generate a\nlist of included network endpoints. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"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": "The name of theregion\nwhere the network endpoint group is located. It should comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", +"response": { +"$ref": "NetworkEndpointGroupsListNetworkEndpoints" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionNetworkFirewallPolicies": { +"methods": { +"addAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts an association for the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.addAssociation", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"associatedPolicyToBeReplaced": { +"description": "Name of the firewall policy associated with the target network to swap\nassociation with. This field is mutually exclusive with\n'replace_existing_association'.", +"location": "query", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"type": "string" +}, +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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" +}, +"replaceExistingAssociation": { +"description": "Indicates whether or not to replace it if an association already exists.\nThis is false by default, in which case an error will be returned if an\nassociation already exists.", +"location": "query", +"type": "boolean" +}, +"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}/firewallPolicies/{firewallPolicy}/addAssociation", +"request": { +"$ref": "FirewallPolicyAssociation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.addRule", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"maxPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"minPriority": { +"description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", +"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" +}, +"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}/firewallPolicies/{firewallPolicy}/addRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"cloneRules": { +"apiVersion": "2026-10-01-preview", +"description": "Copies rules to the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.cloneRules", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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" +}, +"sourceFirewallPolicy": { +"description": "The firewall policy from which to copy rules.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", +"httpMethod": "DELETE", +"id": "compute.regionNetworkFirewallPolicies.delete", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy 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}/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.get", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to get.", +"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}/firewallPolicies/{firewallPolicy}", +"response": { +"$ref": "FirewallPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Gets an association with the specified name.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.getAssociation", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried association belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"name": { +"description": "The name of the association to get from the firewall policy.", +"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" +} +}, +"path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", +"response": { +"$ref": "FirewallPolicyAssociation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getEffectiveFirewalls": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the effective firewalls on a given network.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.getEffectiveFirewalls", +"parameterOrder": [ +"project", +"region", +"network" +], +"parameters": { +"network": { +"description": "Network reference", +"location": "query", +"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}/firewallPolicies/getEffectiveFirewalls", +"response": { +"$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/firewallPolicies/{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" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule of the specified priority.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.getRule", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to which the queried rule belongs.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to get from the firewall policy.", +"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" +}, +"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}/firewallPolicies/{firewallPolicy}/getRule", +"response": { +"$ref": "FirewallPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new network firewall policy in the specified project and region.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.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\nso that 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}/firewallPolicies", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all the network firewall policies that have been configured\nfor the specified project in the given region.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies", +"httpMethod": "GET", +"id": "compute.regionNetworkFirewallPolicies.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" +} +}, +"path": "projects/{project}/regions/{region}/firewallPolicies", +"response": { +"$ref": "FirewallPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", +"httpMethod": "PATCH", +"id": "compute.regionNetworkFirewallPolicies.patch", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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}/firewallPolicies/{firewallPolicy}", +"request": { +"$ref": "FirewallPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Updates an association for the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchAssociation", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.patchAssociation", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"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}/firewallPolicies/{firewallPolicy}/patchAssociation", +"request": { +"$ref": "FirewallPolicyAssociation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule of the specified priority.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.patchRule", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to patch.", +"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" +}, +"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}/firewallPolicies/{firewallPolicy}/patchRule", +"request": { +"$ref": "FirewallPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeAssociation": { +"apiVersion": "2026-10-01-preview", +"description": "Removes an association for the specified network firewall policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.removeAssociation", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"name": { +"description": "Name for the association that will be removed.", +"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" +}, +"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}/firewallPolicies/{firewallPolicy}/removeAssociation", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule of the specified priority.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.removeRule", +"parameterOrder": [ +"project", +"region", +"firewallPolicy" +], +"parameters": { +"firewallPolicy": { +"description": "Name of the firewall policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"priority": { +"description": "The priority of the rule to remove from the firewall policy.", +"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" +}, +"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}/firewallPolicies/{firewallPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.setIamPolicy", +"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}/firewallPolicies/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionNetworkFirewallPolicies.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}/firewallPolicies/{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" +] +} +} +}, +"regionNotificationEndpoints": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all NotificationEndpoint resources,\nregional and global, available to the specified project.", +"flatPath": "projects/{project}/aggregated/notificationEndpoints", +"httpMethod": "GET", +"id": "compute.regionNotificationEndpoints.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" +}, +"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/notificationEndpoints", +"response": { +"$ref": "NotificationEndpointAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified NotificationEndpoint in the given region", +"flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", +"httpMethod": "DELETE", +"id": "compute.regionNotificationEndpoints.delete", +"parameterOrder": [ +"project", +"region", +"notificationEndpoint" +], +"parameters": { +"notificationEndpoint": { +"description": "Name of the NotificationEndpoint 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}/notificationEndpoints/{notificationEndpoint}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified NotificationEndpoint resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", +"httpMethod": "GET", +"id": "compute.regionNotificationEndpoints.get", +"parameterOrder": [ +"project", +"region", +"notificationEndpoint" +], +"parameters": { +"notificationEndpoint": { +"description": "Name of the NotificationEndpoint 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}/notificationEndpoints/{notificationEndpoint}", +"response": { +"$ref": "NotificationEndpoint" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Create a NotificationEndpoint in the specified project in the given region\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/notificationEndpoints", +"httpMethod": "POST", +"id": "compute.regionNotificationEndpoints.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}/notificationEndpoints", +"request": { +"$ref": "NotificationEndpoint" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the NotificationEndpoints for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/notificationEndpoints", +"httpMethod": "GET", +"id": "compute.regionNotificationEndpoints.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" +} +}, +"path": "projects/{project}/regions/{region}/notificationEndpoints", +"response": { +"$ref": "NotificationEndpointList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionNotificationEndpoints.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}/notificationEndpoints/{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" +] +} +} +}, +"regionOperations": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified region-specific Operations resource.", +"flatPath": "projects/{project}/regions/{region}/operations/{operation}", +"httpMethod": "DELETE", +"id": "compute.regionOperations.delete", +"parameterOrder": [ +"project", +"region", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/operations/{operation}", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the specified region-specific Operations resource.", +"flatPath": "projects/{project}/regions/{region}/operations/{operation}", +"httpMethod": "GET", +"id": "compute.regionOperations.get", +"parameterOrder": [ +"project", +"region", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/operations/{operation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Operation resources contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/operations", +"httpMethod": "GET", +"id": "compute.regionOperations.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/operations", +"response": { +"$ref": "OperationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"wait": { +"apiVersion": "2026-10-01-preview", +"description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method differs from the\n`GET` method in that it waits for no more than the default\ndeadline (2 minutes) and then returns the current state of the operation,\nwhich might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", +"flatPath": "projects/{project}/regions/{region}/operations/{operation}/wait", +"httpMethod": "POST", +"id": "compute.regionOperations.wait", +"parameterOrder": [ +"project", +"region", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/operations/{operation}/wait", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionSecurityPolicies": { +"methods": { +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a security policy.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.regionSecurityPolicies.addRule", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified policy.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", +"httpMethod": "DELETE", +"id": "compute.regionSecurityPolicies.delete", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy 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}/regions/{region}/securityPolicies/{securityPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "List all of the ordered rules present in a single specified policy.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", +"httpMethod": "GET", +"id": "compute.regionSecurityPolicies.get", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to get.", +"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}/securityPolicies/{securityPolicy}", +"response": { +"$ref": "SecurityPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule at the specified priority.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.regionSecurityPolicies.getRule", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to get from the security policy.", +"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" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to which the queried rule belongs.", +"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}/securityPolicies/{securityPolicy}/getRule", +"response": { +"$ref": "SecurityPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified project using the data included in\nthe request.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies", +"httpMethod": "POST", +"id": "compute.regionSecurityPolicies.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" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/securityPolicies", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "List all the policies that have been configured for the specified project\nand region.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies", +"httpMethod": "GET", +"id": "compute.regionSecurityPolicies.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" +} +}, +"path": "projects/{project}/regions/{region}/securityPolicies", +"response": { +"$ref": "SecurityPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request. To\nclear fields in the policy, leave the fields empty and specify them in the\nupdateMask. This cannot be used to be update the rules in the policy.\nPlease use the per rule methods like addRule, patchRule, and removeRule\ninstead.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", +"httpMethod": "PATCH", +"id": "compute.regionSecurityPolicies.patch", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Indicates fields to be cleared as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule at the specified priority. To clear fields in the rule,\nleave the fields empty and specify them in the updateMask.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.regionSecurityPolicies.patchRule", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to patch.", +"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" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Indicates fields to be cleared as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule at the specified priority.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.regionSecurityPolicies.removeRule", +"parameterOrder": [ +"project", +"region", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to remove from the security policy.", +"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" +}, +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"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}/securityPolicies/{securityPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a security policy. To learn more about labels,\nread the Labeling Resources\ndocumentation.", +"flatPath": "projects/{project}/regions/{region}/securityPolicies/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.regionSecurityPolicies.setLabels", +"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 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" +}, +"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}/securityPolicies/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionSnapshotSettings": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Get region snapshot settings.", +"flatPath": "projects/{project}/regions/{region}/snapshotSettings", +"httpMethod": "GET", +"id": "compute.regionSnapshotSettings.get", +"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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/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": { +"apiVersion": "2026-10-01-preview", +"description": "Patch region snapshot settings.", +"flatPath": "projects/{project}/regions/{region}/snapshotSettings", +"httpMethod": "PATCH", +"id": "compute.regionSnapshotSettings.patch", +"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 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" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/snapshotSettings", +"request": { +"$ref": "SnapshotSettings" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionSnapshots": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Snapshot resource. Keep in mind that deleting\na single snapshot might not necessarily delete all the data on that\nsnapshot. If any data on the snapshot that is marked for deletion is\nneeded for subsequent snapshots, the data will be moved to the next\ncorresponding snapshot.\n\nFor more information, seeDeleting\nsnapshots.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}", +"httpMethod": "DELETE", +"id": "compute.regionSnapshots.delete", +"parameterOrder": [ +"project", +"region", +"snapshot" +], +"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" +}, +"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" +}, +"snapshot": { +"description": "Name of the snapshot 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}/regions/{region}/snapshots/{snapshot}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Snapshot resource.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}", +"httpMethod": "GET", +"id": "compute.regionSnapshots.get", +"parameterOrder": [ +"project", +"region", +"snapshot" +], +"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" +}, +"snapshot": { +"description": "Name of the Snapshot 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}/regions/{region}/snapshots/{snapshot}", +"response": { +"$ref": "Snapshot" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.regionSnapshots.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/snapshots/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a snapshot in the specified region using the data included\nin the request.", +"flatPath": "projects/{project}/regions/{region}/snapshots", +"httpMethod": "POST", +"id": "compute.regionSnapshots.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 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" +} +}, +"path": "projects/{project}/regions/{region}/snapshots", +"request": { +"$ref": "Snapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Snapshot resources contained within\nthe specified region.", +"flatPath": "projects/{project}/regions/{region}/snapshots", +"httpMethod": "GET", +"id": "compute.regionSnapshots.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/snapshots", +"response": { +"$ref": "SnapshotList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.regionSnapshots.setIamPolicy", +"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}/snapshots/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a regional snapshot. To learn more about labels, read\nthe Labeling Resources\ndocumentation.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.regionSnapshots.setLabels", +"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 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" +}, +"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}/snapshots/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionSnapshots.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}/snapshots/{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" +] +}, +"updateKmsKey": { +"apiVersion": "2026-10-01-preview", +"description": "Rotates the customer-managed\nencryption key to the latest version for the specified snapshot.", +"flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}/updateKmsKey", +"httpMethod": "POST", +"id": "compute.regionSnapshots.updateKmsKey", +"parameterOrder": [ +"project", +"region", +"snapshot" +], +"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" +}, +"snapshot": { +"description": "Name of the snapshot resource to update. 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}/snapshots/{snapshot}/updateKmsKey", +"request": { +"$ref": "RegionSnapshotUpdateKmsKeyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionSslCertificates": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified SslCertificate resource in the region.", +"flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", +"httpMethod": "DELETE", +"id": "compute.regionSslCertificates.delete", +"parameterOrder": [ +"project", +"region", +"sslCertificate" +], +"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" +}, +"sslCertificate": { +"description": "Name of the SslCertificate 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}/regions/{region}/sslCertificates/{sslCertificate}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified SslCertificate resource in the specified region. Get\na list of available SSL certificates by making a list()\nrequest.", +"flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", +"httpMethod": "GET", +"id": "compute.regionSslCertificates.get", +"parameterOrder": [ +"project", +"region", +"sslCertificate" +], +"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" +}, +"sslCertificate": { +"description": "Name of the SslCertificate 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}/regions/{region}/sslCertificates/{sslCertificate}", +"response": { +"$ref": "SslCertificate" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a SslCertificate resource in the specified project and region using\nthe data included in the request", +"flatPath": "projects/{project}/regions/{region}/sslCertificates", +"httpMethod": "POST", +"id": "compute.regionSslCertificates.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}/sslCertificates", +"request": { +"$ref": "SslCertificate" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of SslCertificate resources available to the specified\nproject in the specified region.", +"flatPath": "projects/{project}/regions/{region}/sslCertificates", +"httpMethod": "GET", +"id": "compute.regionSslCertificates.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" +} +}, +"path": "projects/{project}/regions/{region}/sslCertificates", +"response": { +"$ref": "SslCertificateList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionSslPolicies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified SSL policy. The SSL policy resource can be deleted\nonly if it is not in use by any TargetHttpsProxy or TargetSslProxy\nresources.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"httpMethod": "DELETE", +"id": "compute.regionSslPolicies.delete", +"parameterOrder": [ +"project", +"region", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to delete. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all of the ordered rules present in a single specified policy.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"httpMethod": "GET", +"id": "compute.regionSslPolicies.get", +"parameterOrder": [ +"project", +"region", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"response": { +"$ref": "SslPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified project and region using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies", +"httpMethod": "POST", +"id": "compute.regionSslPolicies.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}/sslPolicies", +"request": { +"$ref": "SslPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all the SSL policies that have been configured for the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies", +"httpMethod": "GET", +"id": "compute.regionSslPolicies.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" +} +}, +"path": "projects/{project}/regions/{region}/sslPolicies", +"response": { +"$ref": "SslPoliciesList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listAvailableFeatures": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all features that can be specified in the SSL policy when using\ncustom profile.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", +"httpMethod": "GET", +"id": "compute.regionSslPolicies.listAvailableFeatures", +"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" +} +}, +"path": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", +"response": { +"$ref": "SslPoliciesListAvailableFeaturesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified SSL policy with the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"httpMethod": "PATCH", +"id": "compute.regionSslPolicies.patch", +"parameterOrder": [ +"project", +"region", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", +"request": { +"$ref": "SslPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionTargetHttpProxies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetHttpProxy resource.", +"flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", +"httpMethod": "DELETE", +"id": "compute.regionTargetHttpProxies.delete", +"parameterOrder": [ +"project", +"region", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy 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}/regions/{region}/targetHttpProxies/{targetHttpProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetHttpProxy resource in the specified region.", +"flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", +"httpMethod": "GET", +"id": "compute.regionTargetHttpProxies.get", +"parameterOrder": [ +"project", +"region", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy 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}/regions/{region}/targetHttpProxies/{targetHttpProxy}", +"response": { +"$ref": "TargetHttpProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetHttpProxy resource in the specified project and region\nusing the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/targetHttpProxies", +"httpMethod": "POST", +"id": "compute.regionTargetHttpProxies.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}/targetHttpProxies", +"request": { +"$ref": "TargetHttpProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetHttpProxy resources available\nto the specified project in the specified region.", +"flatPath": "projects/{project}/regions/{region}/targetHttpProxies", +"httpMethod": "GET", +"id": "compute.regionTargetHttpProxies.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" +} +}, +"path": "projects/{project}/regions/{region}/targetHttpProxies", +"response": { +"$ref": "TargetHttpProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setUrlMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the URL map for TargetHttpProxy.", +"flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", +"httpMethod": "POST", +"id": "compute.regionTargetHttpProxies.setUrlMap", +"parameterOrder": [ +"project", +"region", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy to set a URL map for.", +"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}/targetHttpProxies/{targetHttpProxy}/setUrlMap", +"request": { +"$ref": "UrlMapReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionTargetHttpsProxies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetHttpsProxy resource.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "DELETE", +"id": "compute.regionTargetHttpsProxies.delete", +"parameterOrder": [ +"project", +"region", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetHttpsProxy resource in the specified region.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "GET", +"id": "compute.regionTargetHttpsProxies.get", +"parameterOrder": [ +"project", +"region", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", +"response": { +"$ref": "TargetHttpsProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetHttpsProxy resource in the specified project and region\nusing the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", +"httpMethod": "POST", +"id": "compute.regionTargetHttpsProxies.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}/targetHttpsProxies", +"request": { +"$ref": "TargetHttpsProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetHttpsProxy resources available\nto the specified project in the specified region.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", +"httpMethod": "GET", +"id": "compute.regionTargetHttpsProxies.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" +} +}, +"path": "projects/{project}/regions/{region}/targetHttpsProxies", +"response": { +"$ref": "TargetHttpsProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified regional TargetHttpsProxy resource with the data\nincluded in the request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "PATCH", +"id": "compute.regionTargetHttpsProxies.patch", +"parameterOrder": [ +"project", +"region", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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}/targetHttpsProxies/{targetHttpsProxy}", +"request": { +"$ref": "TargetHttpsProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSslCertificates": { +"apiVersion": "2026-10-01-preview", +"description": "Replaces SslCertificates for TargetHttpsProxy.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", +"httpMethod": "POST", +"id": "compute.regionTargetHttpsProxies.setSslCertificates", +"parameterOrder": [ +"project", +"region", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource to set an\nSslCertificates resource for.", +"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}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", +"request": { +"$ref": "RegionTargetHttpsProxiesSetSslCertificatesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setUrlMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the URL map for TargetHttpsProxy.", +"flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", +"httpMethod": "POST", +"id": "compute.regionTargetHttpsProxies.setUrlMap", +"parameterOrder": [ +"project", +"region", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy to set a URL map for.", +"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}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", +"request": { +"$ref": "UrlMapReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionTargetTcpProxies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetTcpProxy resource.", +"flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", +"httpMethod": "DELETE", +"id": "compute.regionTargetTcpProxies.delete", +"parameterOrder": [ +"project", +"region", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy 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}/regions/{region}/targetTcpProxies/{targetTcpProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetTcpProxy resource.", +"flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", +"httpMethod": "GET", +"id": "compute.regionTargetTcpProxies.get", +"parameterOrder": [ +"project", +"region", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy 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}/regions/{region}/targetTcpProxies/{targetTcpProxy}", +"response": { +"$ref": "TargetTcpProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetTcpProxy resource in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/targetTcpProxies", +"httpMethod": "POST", +"id": "compute.regionTargetTcpProxies.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}/targetTcpProxies", +"request": { +"$ref": "TargetTcpProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of TargetTcpProxy resources\navailable to the specified project in a given region.", +"flatPath": "projects/{project}/regions/{region}/targetTcpProxies", +"httpMethod": "GET", +"id": "compute.regionTargetTcpProxies.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" +} +}, +"path": "projects/{project}/regions/{region}/targetTcpProxies", +"response": { +"$ref": "TargetTcpProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionUrlMaps": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified UrlMap resource.", +"flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", +"httpMethod": "DELETE", +"id": "compute.regionUrlMaps.delete", +"parameterOrder": [ +"project", +"region", +"urlMap" +], +"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": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", +"location": "query", +"type": "string" +}, +"urlMap": { +"description": "Name of the UrlMap 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}/regions/{region}/urlMaps/{urlMap}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified UrlMap resource.", +"flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", +"httpMethod": "GET", +"id": "compute.regionUrlMaps.get", +"parameterOrder": [ +"project", +"region", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap 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}/regions/{region}/urlMaps/{urlMap}", +"response": { +"$ref": "UrlMap" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a UrlMap resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/urlMaps", +"httpMethod": "POST", +"id": "compute.regionUrlMaps.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": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/urlMaps", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of UrlMap resources available to the specified\nproject in the specified region.", +"flatPath": "projects/{project}/regions/{region}/urlMaps", +"httpMethod": "GET", +"id": "compute.regionUrlMaps.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" +} +}, +"path": "projects/{project}/regions/{region}/urlMaps", +"response": { +"$ref": "UrlMapList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified UrlMap 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}/urlMaps/{urlMap}", +"httpMethod": "PATCH", +"id": "compute.regionUrlMaps.patch", +"parameterOrder": [ +"project", +"region", +"urlMap" +], +"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": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", +"location": "query", +"type": "string" +}, +"urlMap": { +"description": "Name of the UrlMap 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}/urlMaps/{urlMap}", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified UrlMap resource with the data included in the\nrequest.", +"flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", +"httpMethod": "PUT", +"id": "compute.regionUrlMaps.update", +"parameterOrder": [ +"project", +"region", +"urlMap" +], +"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": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", +"location": "query", +"type": "string" +}, +"urlMap": { +"description": "Name of the UrlMap resource to update.", +"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}/urlMaps/{urlMap}", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"validate": { +"apiVersion": "2026-10-01-preview", +"description": "Runs static validation for the UrlMap. In particular, the tests of the\nprovided UrlMap will be run. Calling this method does NOT create the\nUrlMap.", +"flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", +"httpMethod": "POST", +"id": "compute.regionUrlMaps.validate", +"parameterOrder": [ +"project", +"region", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap resource to be validated as.", +"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}/urlMaps/{urlMap}/validate", +"request": { +"$ref": "RegionUrlMapsValidateRequest" +}, +"response": { +"$ref": "UrlMapsValidateResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"regionZones": { +"methods": { +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Zone resources under the specific region available to\nthe specified project.", +"flatPath": "projects/{project}/regions/{region}/zones", +"httpMethod": "GET", +"id": "compute.regionZones.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": "Region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/zones", +"response": { +"$ref": "ZoneList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regions": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Region resource.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information (the `quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.\n\nThis method fails if the quota information is unavailable for the region\nand if the organization policy constraint\ncompute.requireBasicQuotaInResponse is enforced. This\nconstraint, when enforced, disables the fail-open behaviour when quota\ninformation (the `items.quotas` field) is unavailable for the region.\nIt is recommended to use the default setting\nfor the constraint unless your application requires the fail-closed\nbehaviour for this method.", +"flatPath": "projects/{project}/regions/{region}", +"httpMethod": "GET", +"id": "compute.regions.get", +"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 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}/regions/{region}", +"response": { +"$ref": "Region" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of region resources available to the specified project.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information\n(the `items.quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.\n\nThis method fails if the quota information is unavailable for the region\nand if the organization policy constraint\ncompute.requireBasicQuotaInResponse is enforced. This\nconstraint, when enforced, disables the fail-open behaviour when quota\ninformation (the `items.quotas` field) is unavailable for the region.\nIt is recommended to use the default setting\nfor the constraint unless your application requires the fail-closed\nbehaviour for this method.", +"flatPath": "projects/{project}/regions", +"httpMethod": "GET", +"id": "compute.regions.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/regions", +"response": { +"$ref": "RegionList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"reliabilityRisks": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified ReliabilityRisk resource.", +"flatPath": "projects/{project}/global/reliabilityRisks/{reliabilityRisk}", +"httpMethod": "GET", +"id": "compute.reliabilityRisks.get", +"parameterOrder": [ +"project", +"reliabilityRisk" +], +"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" +}, +"reliabilityRisk": { +"description": "Name of the ReliabilityRisk 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/reliabilityRisks/{reliabilityRisk}", +"response": { +"$ref": "ReliabilityRisk" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of reliabilityRisks available in the specified project.", +"flatPath": "projects/{project}/global/reliabilityRisks", +"httpMethod": "GET", +"id": "compute.reliabilityRisks.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/reliabilityRisks", +"response": { +"$ref": "ReliabilityRisksListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"reservationBlocks": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified reservation block.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", +"httpMethod": "GET", +"id": "compute.reservationBlocks.get", +"parameterOrder": [ +"project", +"zone", +"reservation", +"reservationBlock" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"reservation": { +"description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"reservationBlock": { +"description": "The name of the reservation block.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"view": { +"description": "View of the Block.", +"enum": [ +"BASIC", +"BLOCK_VIEW_UNSPECIFIED", +"FULL" +], +"enumDescriptions": [ +"This view includes basic information about the reservation block", +"The default / unset value. The API will default to the BASIC view.", +"Includes detailed topology view." +], +"location": "query", +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", +"response": { +"$ref": "ReservationBlocksGetResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.reservationBlocks.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"optionsRequestedPolicyVersion": { +"description": "Requested IAM Policy version.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{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" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of reservation blocks under a single reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", +"httpMethod": "GET", +"id": "compute.reservationBlocks.list", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"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", +"required": true, +"type": "string" +}, +"reservation": { +"description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", +"response": { +"$ref": "ReservationBlocksListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"performMaintenance": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to perform maintenance on a reservation block", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", +"httpMethod": "POST", +"id": "compute.reservationBlocks.performMaintenance", +"parameterOrder": [ +"project", +"zone", +"reservation", +"reservationBlock" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"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" +}, +"reservation": { +"description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"reservationBlock": { +"description": "The name of the reservation block.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", +"request": { +"$ref": "ReservationsBlocksPerformMaintenanceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.reservationBlocks.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetNestedPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.reservationBlocks.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{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" +] +} +} +}, +"reservationSlots": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified reservation slot.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}", +"httpMethod": "GET", +"id": "compute.reservationSlots.get", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSlot" +], +"parameters": { +"parentName": { +"description": "The name of the parent reservation and parent block, formatted as\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", +"location": "path", +"pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", +"required": true, +"type": "string" +}, +"project": { +"description": "The project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"reservationSlot": { +"description": "The name of the reservation slot, formatted as RFC1035 or a resource ID\nnumber.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request, formatted as RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}", +"response": { +"$ref": "ReservationSlotsGetResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Get health info on a reservation slot.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}/getHealth", +"httpMethod": "POST", +"id": "compute.reservationSlots.getHealth", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSlot" +], +"parameters": { +"parentName": { +"description": "The name of the parent reservation, parent block and parent sub-block. In\nthe format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", +"location": "path", +"pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([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", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests.", +"location": "query", +"type": "string" +}, +"reservationSlot": { +"description": "The name of the reservation slot.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}/getHealth", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"getVersion": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to get SBOM versions of a reservation slot.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}/getVersion", +"httpMethod": "POST", +"id": "compute.reservationSlots.getVersion", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSlot" +], +"parameters": { +"parentName": { +"description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", +"location": "path", +"pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([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", +"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" +}, +"reservationSlot": { +"description": "The name of the reservation slot.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}/getVersion", +"request": { +"$ref": "ReservationSlotsGetVersionRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of reservation slots under a single reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots", +"httpMethod": "GET", +"id": "compute.reservationSlots.list", +"parameterOrder": [ +"project", +"zone", +"parentName" +], +"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" +}, +"parentName": { +"description": "The name of the parent reservation and parent block, formatted as\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", +"location": "path", +"pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", +"required": true, +"type": "string" +}, +"project": { +"description": "The project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request, formatted as RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots", +"response": { +"$ref": "ReservationSlotsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Update a reservation slot in the specified sub-block.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}", +"httpMethod": "POST", +"id": "compute.reservationSlots.update", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSlot" +], +"parameters": { +"parentName": { +"description": "The name of the sub-block resource.", +"location": "path", +"pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", +"required": true, +"type": "string" +}, +"project": { +"description": "The project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"reservationSlot": { +"description": "The name of the slot resource.", +"location": "path", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "The fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request, formatted as RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}", +"request": { +"$ref": "ReservationSlot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"reservationSubBlocks": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified reservation subBlock.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", +"httpMethod": "GET", +"id": "compute.reservationSubBlocks.get", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSubBlock" +], +"parameters": { +"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" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"reservationSubBlock": { +"description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"view": { +"description": "View of the subBlock.", +"enum": [ +"SUB_BLOCK_VIEW_BASIC", +"SUB_BLOCK_VIEW_FULL", +"SUB_BLOCK_VIEW_UNSPECIFIED" +], +"enumDescriptions": [ +"This view includes basic information about the reservation sub block", +"Includes detailed topology view.", +"The default / unset value. The API will default to the BASIC view." +], +"location": "query", +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", +"response": { +"$ref": "ReservationSubBlocksGetResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.reservationSubBlocks.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"optionsRequestedPolicyVersion": { +"description": "Requested IAM Policy version.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{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" +] +}, +"getVersion": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to get SBOM versions of a reservation subBlock.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/getVersion", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.getVersion", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSubBlock" +], +"parameters": { +"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" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"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" +}, +"reservationSubBlock": { +"description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", +"request": { +"$ref": "ReservationSubBlocksGetVersionRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of reservation subBlocks under a single reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", +"httpMethod": "GET", +"id": "compute.reservationSubBlocks.list", +"parameterOrder": [ +"project", +"zone", +"parentName" +], +"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" +}, +"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" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", +"response": { +"$ref": "ReservationSubBlocksListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"performMaintenance": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to perform maintenance on a reservation subBlock", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.performMaintenance", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSubBlock" +], +"parameters": { +"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" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"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" +}, +"reservationSubBlock": { +"description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"reportFaulty": { +"apiVersion": "2026-10-01-preview", +"description": "Allows customers to report a faulty subBlock.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.reportFaulty", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSubBlock" +], +"parameters": { +"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" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"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" +}, +"reservationSubBlock": { +"description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"request": { +"$ref": "ReservationSubBlocksReportFaultyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetNestedPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"parentResource", +"resource" +], +"parameters": { +"parentResource": { +"description": "Name or id of parent resource of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", +"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" +}, +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{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" +] +} +} +}, +"reservations": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of reservations.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/reservations", +"httpMethod": "GET", +"id": "compute.reservations.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": "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" +}, +"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/reservations", +"response": { +"$ref": "ReservationAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", +"httpMethod": "DELETE", +"id": "compute.reservations.delete", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"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" +}, +"reservation": { +"description": "Name of the reservation 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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves information about the specified reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", +"httpMethod": "GET", +"id": "compute.reservations.get", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"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" +}, +"reservation": { +"description": "Name of the reservation to retrieve.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}", +"response": { +"$ref": "Reservation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.reservations.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new reservation. For more information, readReserving zonal\nresources.", +"flatPath": "projects/{project}/zones/{zone}/reservations", +"httpMethod": "POST", +"id": "compute.reservations.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations", +"request": { +"$ref": "Reservation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "A list of all the reservations that have been configured for the\nspecified project in specified zone.", +"flatPath": "projects/{project}/zones/{zone}/reservations", +"httpMethod": "GET", +"id": "compute.reservations.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations", +"response": { +"$ref": "ReservationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"performMaintenance": { +"apiVersion": "2026-10-01-preview", +"description": "Perform maintenance on an extended reservation", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", +"httpMethod": "POST", +"id": "compute.reservations.performMaintenance", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"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" +}, +"reservation": { +"description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", +"request": { +"$ref": "ReservationsPerformMaintenanceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resize": { +"apiVersion": "2026-10-01-preview", +"description": "Resizes the reservation (applicable to standalone reservations only). For\nmore information, readModifying\nreservations.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", +"httpMethod": "POST", +"id": "compute.reservations.resize", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"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" +}, +"reservation": { +"description": "Name of the reservation to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", +"request": { +"$ref": "ReservationsResizeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.reservations.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.reservations.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Update share settings of the reservation.", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", +"httpMethod": "PATCH", +"id": "compute.reservations.update", +"parameterOrder": [ +"project", +"zone", +"reservation" +], +"parameters": { +"paths": { +"location": "query", +"repeated": 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. 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" +}, +"reservation": { +"description": "Name of the reservation to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/reservations/{reservation}", +"request": { +"$ref": "Reservation" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"resourcePolicies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of resource policies.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/resourcePolicies", +"httpMethod": "GET", +"id": "compute.resourcePolicies.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": "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" +}, +"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/resourcePolicies", +"response": { +"$ref": "ResourcePolicyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified resource policy.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", +"httpMethod": "DELETE", +"id": "compute.resourcePolicies.delete", +"parameterOrder": [ +"project", +"region", +"resourcePolicy" +], +"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" +}, +"resourcePolicy": { +"description": "Name of the resource policy 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}/regions/{region}/resourcePolicies/{resourcePolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves all information of the specified resource policy.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", +"httpMethod": "GET", +"id": "compute.resourcePolicies.get", +"parameterOrder": [ +"project", +"region", +"resourcePolicy" +], +"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" +}, +"resourcePolicy": { +"description": "Name of the resource policy to retrieve.", +"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}/resourcePolicies/{resourcePolicy}", +"response": { +"$ref": "ResourcePolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.resourcePolicies.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/resourcePolicies/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new resource policy.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies", +"httpMethod": "POST", +"id": "compute.resourcePolicies.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 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" +} +}, +"path": "projects/{project}/regions/{region}/resourcePolicies", +"request": { +"$ref": "ResourcePolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "A list all the resource policies that have been configured for the\nspecified project in specified region.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies", +"httpMethod": "GET", +"id": "compute.resourcePolicies.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/resourcePolicies", +"response": { +"$ref": "ResourcePolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Modify the specified resource policy.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", +"httpMethod": "PATCH", +"id": "compute.resourcePolicies.patch", +"parameterOrder": [ +"project", +"region", +"resourcePolicy" +], +"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" +}, +"resourcePolicy": { +"description": "Id of the resource policy 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" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", +"request": { +"$ref": "ResourcePolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.resourcePolicies.setIamPolicy", +"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}/resourcePolicies/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.resourcePolicies.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}/resourcePolicies/{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" +] +} +} +}, +"rolloutPlans": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a RolloutPlan.", +"flatPath": "projects/{project}/global/rolloutPlans/{rolloutPlan}", +"httpMethod": "DELETE", +"id": "compute.rolloutPlans.delete", +"parameterOrder": [ +"project", +"rolloutPlan" +], +"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" +}, +"rolloutPlan": { +"description": "Name of the RolloutPlan 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/rolloutPlans/{rolloutPlan}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets details of a single project-scoped RolloutPlan.", +"flatPath": "projects/{project}/global/rolloutPlans/{rolloutPlan}", +"httpMethod": "GET", +"id": "compute.rolloutPlans.get", +"parameterOrder": [ +"project", +"rolloutPlan" +], +"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" +}, +"rolloutPlan": { +"description": "Name of the persistent rollout plan 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/rolloutPlans/{rolloutPlan}", +"response": { +"$ref": "RolloutPlan" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new RolloutPlan in a given project and location.", +"flatPath": "projects/{project}/global/rolloutPlans", +"httpMethod": "POST", +"id": "compute.rolloutPlans.insert", +"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" +} +}, +"path": "projects/{project}/global/rolloutPlans", +"request": { +"$ref": "RolloutPlan" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists RolloutPlans in a given project and location.", +"flatPath": "projects/{project}/global/rolloutPlans", +"httpMethod": "GET", +"id": "compute.rolloutPlans.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/rolloutPlans", +"response": { +"$ref": "RolloutPlansListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"rollouts": { +"methods": { +"advance": { +"apiVersion": "2026-10-01-preview", +"description": "Advances a Rollout to the next wave, or completes it if no waves remain.", +"flatPath": "projects/{project}/global/rollouts/{rollout}/advance", +"httpMethod": "POST", +"id": "compute.rollouts.advance", +"parameterOrder": [ +"project", +"rollout" +], +"parameters": { +"currentWaveNumber": { +"description": "Required. Wave number of the current wave.", +"format": "int64", +"location": "query", +"type": "string" +}, +"project": { +"description": "Required. 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" +}, +"rollout": { +"description": "Required. Name of the Rollout resource to advance.", +"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/rollouts/{rollout}/advance", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"cancel": { +"apiVersion": "2026-10-01-preview", +"description": "Cancels a Rollout.", +"flatPath": "projects/{project}/global/rollouts/{rollout}", +"httpMethod": "PATCH", +"id": "compute.rollouts.cancel", +"parameterOrder": [ +"project", +"rollout" +], +"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" +}, +"rollback": { +"description": "Optional. If true, then the ongoing rollout must be rolled back. Else, just cancel\nthe rollout without taking any further actions. Note that products must\nsupport at least one of these options, however, it does not need to support\nboth.", +"location": "query", +"type": "boolean" +}, +"rollout": { +"description": "Name of the Rollout resource to cancel.", +"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/rollouts/{rollout}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a Rollout.", +"flatPath": "projects/{project}/global/rollouts/{rollout}", +"httpMethod": "DELETE", +"id": "compute.rollouts.delete", +"parameterOrder": [ +"project", +"rollout" +], +"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" +}, +"rollout": { +"description": "Name of the Rollout 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/rollouts/{rollout}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets details of a single project-scoped Rollout.", +"flatPath": "projects/{project}/global/rollouts/{rollout}", +"httpMethod": "GET", +"id": "compute.rollouts.get", +"parameterOrder": [ +"project", +"rollout" +], +"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" +}, +"rollout": { +"description": "Name of the persistent rollout 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/rollouts/{rollout}", +"response": { +"$ref": "Rollout" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists Rollouts in a given project and location.", +"flatPath": "projects/{project}/global/rollouts", +"httpMethod": "GET", +"id": "compute.rollouts.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/rollouts", +"response": { +"$ref": "RolloutsListResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"pause": { +"apiVersion": "2026-10-01-preview", +"description": "Pauses a Rollout.", +"flatPath": "projects/{project}/global/rollouts/{rollout}/pause", +"httpMethod": "POST", +"id": "compute.rollouts.pause", +"parameterOrder": [ +"project", +"rollout" +], +"parameters": { +"etag": { +"description": "The etag of the Rollout.\nIf this is provided, the request will only succeed if the etag matches\nthe current etag of the Rollout.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Required. 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" +}, +"rollout": { +"description": "Required. Name of the Rollout resource to pause.", +"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/rollouts/{rollout}/pause", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"resume": { +"apiVersion": "2026-10-01-preview", +"description": "Resumes a Rollout.", +"flatPath": "projects/{project}/global/rollouts/{rollout}/resume", +"httpMethod": "POST", +"id": "compute.rollouts.resume", +"parameterOrder": [ +"project", +"rollout" +], +"parameters": { +"etag": { +"description": "The etag of the Rollout.\nIf this is provided, the request will only succeed if the etag matches\nthe current etag of the Rollout.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Required. 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" +}, +"rollout": { +"description": "Required. Name of the Rollout resource to resume.", +"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/rollouts/{rollout}/resume", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"routers": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of routers.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/routers", +"httpMethod": "GET", +"id": "compute.routers.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": "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" +}, +"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/routers", +"response": { +"$ref": "RouterAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Router resource.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}", +"httpMethod": "DELETE", +"id": "compute.routers.delete", +"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 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}/regions/{region}/routers/{router}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"deleteNamedSet": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes Route Policy", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", +"httpMethod": "POST", +"id": "compute.routers.deleteRoutePolicy", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"policy": { +"description": "The Policy 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 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}/deleteRoutePolicy", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Router resource.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}", +"httpMethod": "GET", +"id": "compute.routers.get", +"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 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}/regions/{region}/routers/{router}", +"response": { +"$ref": "Router" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getNamedSet": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves runtime NAT IP information.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", +"httpMethod": "GET", +"id": "compute.routers.getNatIpInfo", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"natName": { +"description": "Name of the nat service to filter the NAT IP information.\nIf it is omitted, all nats for this router will be returned.\nName should 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 Nat IP information. The name\nshould conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", +"response": { +"$ref": "NatIpInfoResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getNatMappingInfo": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves runtime Nat mapping information of VM endpoints.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", +"httpMethod": "GET", +"id": "compute.routers.getNatMappingInfo", +"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" +}, +"natName": { +"description": "Name of the nat service to filter the Nat Mapping information.\nIf it is omitted, all nats for this router will be returned.\nName should conform to RFC1035.", +"location": "query", +"type": "string" +}, +"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 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 Nat Mapping information of\nVM endpoints.", +"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}/getNatMappingInfo", +"response": { +"$ref": "VmEndpointNatMappingsList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRoutePolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Returns specified Route Policy", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", +"httpMethod": "GET", +"id": "compute.routers.getRoutePolicy", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"policy": { +"description": "The Policy 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 route policy. The name should\nconform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", +"response": { +"$ref": "RoutersGetRoutePolicyResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRouterStatus": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves runtime information of the specified router.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", +"httpMethod": "GET", +"id": "compute.routers.getRouterStatus", +"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}/getRouterStatus", +"response": { +"$ref": "RouterStatusResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a Router resource in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/routers", +"httpMethod": "POST", +"id": "compute.routers.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 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" +} +}, +"path": "projects/{project}/regions/{region}/routers", +"request": { +"$ref": "Router" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Router resources available to the specified project.", +"flatPath": "projects/{project}/regions/{region}/routers", +"httpMethod": "GET", +"id": "compute.routers.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers", +"response": { +"$ref": "RouterList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listBgpRoutes": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of router bgp routes available to the specified project.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/listBgpRoutes", +"httpMethod": "GET", +"id": "compute.routers.listBgpRoutes", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"addressFamily": { +"default": "UNSPECIFIED_IP_VERSION", +"description": "(Required) limit results to this address family (either IPv4 or IPv6)", +"enum": [ +"IPV4", +"IPV6", +"UNSPECIFIED_IP_VERSION" +], +"enumDescriptions": [ +"", +"", +"" +], +"location": "query", +"type": "string" +}, +"destinationPrefix": { +"description": "Limit results to destinations that are subnets of this CIDR range", +"location": "query", +"type": "string" +}, +"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" +}, +"peer": { +"description": "(Required) limit results to the BGP peer with the given name.\nName should conform to RFC1035.", +"location": "query", +"type": "string" +}, +"policyApplied": { +"default": "true", +"description": "When true, the method returns post-policy routes. Otherwise, it returns\npre-policy routes.", +"location": "query", +"type": "boolean" +}, +"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" +}, +"routeType": { +"default": "UNSPECIFIED_ROUTE_TYPE", +"description": "(Required) limit results to this type of route (either LEARNED or\nADVERTISED)", +"enum": [ +"ADVERTISED", +"LEARNED", +"UNSPECIFIED_ROUTE_TYPE" +], +"enumDescriptions": [ +"", +"", +"" +], +"location": "query", +"type": "string" +}, +"router": { +"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}/listBgpRoutes", +"response": { +"$ref": "RoutersListBgpRoutes" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listNamedSets": { +"apiVersion": "2026-10-01-preview", +"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.listNamedSets", +"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", +"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 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}/listNamedSets", +"response": { +"$ref": "RoutersListNamedSets" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listRoutePolicies": { +"apiVersion": "2026-10-01-preview", +"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", +"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 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}/listRoutePolicies", +"response": { +"$ref": "RoutersListRoutePolicies" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"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", +"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 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}", +"request": { +"$ref": "Router" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchNamedSet": { +"apiVersion": "2026-10-01-preview", +"description": "Patches Named Set", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", +"httpMethod": "POST", +"id": "compute.routers.patchNamedSet", +"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}/patchNamedSet", +"request": { +"$ref": "NamedSet" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRoutePolicy": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-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" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"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", +"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 to update.", +"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" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"updateNamedSet": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates or creates new Route Policy", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", +"httpMethod": "POST", +"id": "compute.routers.updateRoutePolicy", +"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}/updateRoutePolicy", +"request": { +"$ref": "RoutePolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"routes": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Route resource.", +"flatPath": "projects/{project}/global/routes/{route}", +"httpMethod": "DELETE", +"id": "compute.routes.delete", +"parameterOrder": [ +"project", +"route" +], +"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" +}, +"route": { +"description": "Name of the Route 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/routes/{route}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Route resource.", +"flatPath": "projects/{project}/global/routes/{route}", +"httpMethod": "GET", +"id": "compute.routes.get", +"parameterOrder": [ +"project", +"route" +], +"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" +}, +"route": { +"description": "Name of the Route 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/routes/{route}", +"response": { +"$ref": "Route" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a Route resource in the specified project using the data included\nin the request.", +"flatPath": "projects/{project}/global/routes", +"httpMethod": "POST", +"id": "compute.routes.insert", +"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" +} +}, +"path": "projects/{project}/global/routes", +"request": { +"$ref": "Route" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Route resources available to the specified project.", +"flatPath": "projects/{project}/global/routes", +"httpMethod": "GET", +"id": "compute.routes.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/routes", +"response": { +"$ref": "RouteList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/routes/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.routes.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/routes/{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" +] +} +} +}, +"securityPolicies": { +"methods": { +"addRule": { +"apiVersion": "2026-10-01-preview", +"description": "Inserts a rule into a security policy.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", +"httpMethod": "POST", +"id": "compute.securityPolicies.addRule", +"parameterOrder": [ +"project", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all SecurityPolicy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/securityPolicies", +"httpMethod": "GET", +"id": "compute.securityPolicies.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" +}, +"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/securityPolicies", +"response": { +"$ref": "SecurityPoliciesAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified policy.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", +"httpMethod": "DELETE", +"id": "compute.securityPolicies.delete", +"parameterOrder": [ +"project", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy 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/securityPolicies/{securityPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "List all of the ordered rules present in a single specified policy.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", +"httpMethod": "GET", +"id": "compute.securityPolicies.get", +"parameterOrder": [ +"project", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to get.", +"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/securityPolicies/{securityPolicy}", +"response": { +"$ref": "SecurityPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getRule": { +"apiVersion": "2026-10-01-preview", +"description": "Gets a rule at the specified priority.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", +"httpMethod": "GET", +"id": "compute.securityPolicies.getRule", +"parameterOrder": [ +"project", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to get from the security policy.", +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to which the queried rule belongs.", +"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/securityPolicies/{securityPolicy}/getRule", +"response": { +"$ref": "SecurityPolicyRule" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new policy in the specified project using the data included in\nthe request.", +"flatPath": "projects/{project}/global/securityPolicies", +"httpMethod": "POST", +"id": "compute.securityPolicies.insert", +"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" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/securityPolicies", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "List all the policies that have been configured for the specified project.", +"flatPath": "projects/{project}/global/securityPolicies", +"httpMethod": "GET", +"id": "compute.securityPolicies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/securityPolicies", +"response": { +"$ref": "SecurityPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listPreconfiguredExpressionSets": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the current list of preconfigured Web Application Firewall (WAF)\nexpressions.", +"flatPath": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", +"httpMethod": "GET", +"id": "compute.securityPolicies.listPreconfiguredExpressionSets", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", +"response": { +"$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified policy with the data included in the request. To\nclear fields in the policy, leave the fields empty and specify them in the\nupdateMask. This cannot be used to be update the rules in the policy.\nPlease use the per rule methods like addRule, patchRule, and removeRule\ninstead.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", +"httpMethod": "PATCH", +"id": "compute.securityPolicies.patch", +"parameterOrder": [ +"project", +"securityPolicy" +], +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Indicates fields to be cleared as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/securityPolicies/{securityPolicy}", +"request": { +"$ref": "SecurityPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"patchRule": { +"apiVersion": "2026-10-01-preview", +"description": "Patches a rule at the specified priority. To clear fields in the rule,\nleave the fields empty and specify them in the updateMask.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", +"httpMethod": "POST", +"id": "compute.securityPolicies.patchRule", +"parameterOrder": [ +"project", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to patch.", +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Indicates fields to be cleared as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"validateOnly": { +"description": "If true, the request will not be committed.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", +"request": { +"$ref": "SecurityPolicyRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeRule": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a rule at the specified priority.", +"flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", +"httpMethod": "POST", +"id": "compute.securityPolicies.removeRule", +"parameterOrder": [ +"project", +"securityPolicy" +], +"parameters": { +"priority": { +"description": "The priority of the rule to remove from the security policy.", +"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" +}, +"securityPolicy": { +"description": "Name of the security policy to update.", +"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/securityPolicies/{securityPolicy}/removeRule", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a security policy. To learn more about labels,\nread the Labeling Resources\ndocumentation.", +"flatPath": "projects/{project}/global/securityPolicies/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.securityPolicies.setLabels", +"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/securityPolicies/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"serviceAttachments": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all ServiceAttachment resources,\nregional and global, available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/serviceAttachments", +"httpMethod": "GET", +"id": "compute.serviceAttachments.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" +}, +"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/serviceAttachments", +"response": { +"$ref": "ServiceAttachmentAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified ServiceAttachment in the given scope", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", +"httpMethod": "DELETE", +"id": "compute.serviceAttachments.delete", +"parameterOrder": [ +"project", +"region", +"serviceAttachment" +], +"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 of 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" +}, +"serviceAttachment": { +"description": "Name of the ServiceAttachment 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}/regions/{region}/serviceAttachments/{serviceAttachment}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified ServiceAttachment resource in the given scope.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", +"httpMethod": "GET", +"id": "compute.serviceAttachments.get", +"parameterOrder": [ +"project", +"region", +"serviceAttachment" +], +"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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"serviceAttachment": { +"description": "Name of the ServiceAttachment 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" +}, +"showNatIps": { +"description": "Indicates whether NAT IPs should be included in the response.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", +"response": { +"$ref": "ServiceAttachment" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.serviceAttachments.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/serviceAttachments/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a ServiceAttachment in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments", +"httpMethod": "POST", +"id": "compute.serviceAttachments.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 of 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}/serviceAttachments", +"request": { +"$ref": "ServiceAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the ServiceAttachments for a project in the given scope.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments", +"httpMethod": "GET", +"id": "compute.serviceAttachments.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 of this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/serviceAttachments", +"response": { +"$ref": "ServiceAttachmentList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified ServiceAttachment resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", +"httpMethod": "PATCH", +"id": "compute.serviceAttachments.patch", +"parameterOrder": [ +"project", +"region", +"serviceAttachment" +], +"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 region scoping this request and should conform to RFC1035.", +"location": "path", +"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" +}, +"serviceAttachment": { +"description": "The resource id of the ServiceAttachment to patch. It should conform to\nRFC1035 resource name or be a string form on an unsigned long number.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", +"request": { +"$ref": "ServiceAttachment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.serviceAttachments.setIamPolicy", +"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}/serviceAttachments/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.serviceAttachments.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}/serviceAttachments/{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": { +"apiVersion": "2026-10-01-preview", +"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": { +"apiVersion": "2026-10-01-preview", +"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": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified Snapshot resource. Keep in mind that deleting\na single snapshot might not necessarily delete all the data on that\nsnapshot. If any data on the snapshot that is marked for deletion is\nneeded for subsequent snapshots, the data will be moved to the next\ncorresponding snapshot.\n\nFor more information, seeDeleting\nsnapshots.", +"flatPath": "projects/{project}/global/snapshots/{snapshot}", +"httpMethod": "DELETE", +"id": "compute.snapshots.delete", +"parameterOrder": [ +"project", +"snapshot" +], +"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" +}, +"snapshot": { +"description": "Name of the Snapshot 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/snapshots/{snapshot}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Snapshot resource.", +"flatPath": "projects/{project}/global/snapshots/{snapshot}", +"httpMethod": "GET", +"id": "compute.snapshots.get", +"parameterOrder": [ +"project", +"snapshot" +], +"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" +}, +"snapshot": { +"description": "Name of the Snapshot 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/snapshots/{snapshot}", +"response": { +"$ref": "Snapshot" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/snapshots/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.snapshots.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/snapshots/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a snapshot in the specified project using the data included\nin the request. For regular snapshot creation, consider using this method\ninstead of disks.createSnapshot,\nas this method supports more features, such as creating snapshots in a\nproject different from the source disk project.", +"flatPath": "projects/{project}/global/snapshots", +"httpMethod": "POST", +"id": "compute.snapshots.insert", +"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" +} +}, +"path": "projects/{project}/global/snapshots", +"request": { +"$ref": "Snapshot" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Snapshot resources contained within\nthe specified project.", +"flatPath": "projects/{project}/global/snapshots", +"httpMethod": "GET", +"id": "compute.snapshots.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/snapshots", +"response": { +"$ref": "SnapshotList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/snapshots/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.snapshots.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/snapshots/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a snapshot. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/global/snapshots/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.snapshots.setLabels", +"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/snapshots/{resource}/setLabels", +"request": { +"$ref": "GlobalSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/snapshots/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.snapshots.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/snapshots/{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" +] +}, +"updateKmsKey": { +"apiVersion": "2026-10-01-preview", +"description": "Rotates the customer-managed\nencryption key to the latest version for the specified snapshot.", +"flatPath": "projects/{project}/global/snapshots/{snapshot}/updateKmsKey", +"httpMethod": "POST", +"id": "compute.snapshots.updateKmsKey", +"parameterOrder": [ +"project", +"snapshot" +], +"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" +}, +"snapshot": { +"description": "Name of the snapshot resource to update. 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}/global/snapshots/{snapshot}/updateKmsKey", +"request": { +"$ref": "SnapshotUpdateKmsKeyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"sslCertificates": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all SslCertificate resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/sslCertificates", +"httpMethod": "GET", +"id": "compute.sslCertificates.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" +}, +"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/sslCertificates", +"response": { +"$ref": "SslCertificateAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified SslCertificate resource.", +"flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", +"httpMethod": "DELETE", +"id": "compute.sslCertificates.delete", +"parameterOrder": [ +"project", +"sslCertificate" +], +"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" +}, +"sslCertificate": { +"description": "Name of the SslCertificate 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/sslCertificates/{sslCertificate}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified SslCertificate resource.", +"flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", +"httpMethod": "GET", +"id": "compute.sslCertificates.get", +"parameterOrder": [ +"project", +"sslCertificate" +], +"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" +}, +"sslCertificate": { +"description": "Name of the SslCertificate 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/sslCertificates/{sslCertificate}", +"response": { +"$ref": "SslCertificate" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a SslCertificate resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/global/sslCertificates", +"httpMethod": "POST", +"id": "compute.sslCertificates.insert", +"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" +} +}, +"path": "projects/{project}/global/sslCertificates", +"request": { +"$ref": "SslCertificate" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of SslCertificate resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/sslCertificates", +"httpMethod": "GET", +"id": "compute.sslCertificates.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/sslCertificates", +"response": { +"$ref": "SslCertificateList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"sslPolicies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all SslPolicy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/sslPolicies", +"httpMethod": "GET", +"id": "compute.sslPolicies.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" +}, +"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/sslPolicies", +"response": { +"$ref": "SslPoliciesAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified SSL policy. The SSL policy resource can be deleted\nonly if it is not in use by any TargetHttpsProxy or TargetSslProxy\nresources.", +"flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", +"httpMethod": "DELETE", +"id": "compute.sslPolicies.delete", +"parameterOrder": [ +"project", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to delete. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/sslPolicies/{sslPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all of the ordered rules present in a single specified policy.", +"flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", +"httpMethod": "GET", +"id": "compute.sslPolicies.get", +"parameterOrder": [ +"project", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/sslPolicies/{sslPolicy}", +"response": { +"$ref": "SslPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified SSL policy resource.", +"flatPath": "projects/{project}/global/sslPolicies", +"httpMethod": "POST", +"id": "compute.sslPolicies.insert", +"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" +} +}, +"path": "projects/{project}/global/sslPolicies", +"request": { +"$ref": "SslPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all the SSL policies that have been configured for the specified\nproject.", +"flatPath": "projects/{project}/global/sslPolicies", +"httpMethod": "GET", +"id": "compute.sslPolicies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/sslPolicies", +"response": { +"$ref": "SslPoliciesList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listAvailableFeatures": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all features that can be specified in the SSL policy when using\ncustom profile.", +"flatPath": "projects/{project}/global/sslPolicies/listAvailableFeatures", +"httpMethod": "GET", +"id": "compute.sslPolicies.listAvailableFeatures", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/sslPolicies/listAvailableFeatures", +"response": { +"$ref": "SslPoliciesListAvailableFeaturesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified SSL policy with the data included in the request.", +"flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", +"httpMethod": "PATCH", +"id": "compute.sslPolicies.patch", +"parameterOrder": [ +"project", +"sslPolicy" +], +"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" +}, +"sslPolicy": { +"description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/sslPolicies/{sslPolicy}", +"request": { +"$ref": "SslPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"storagePoolTypes": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of storage pool types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/storagePoolTypes", +"httpMethod": "GET", +"id": "compute.storagePoolTypes.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": "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" +}, +"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/storagePoolTypes", +"response": { +"$ref": "StoragePoolTypeAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified storage pool type.", +"flatPath": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", +"httpMethod": "GET", +"id": "compute.storagePoolTypes.get", +"parameterOrder": [ +"project", +"zone", +"storagePoolType" +], +"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" +}, +"storagePoolType": { +"description": "Name of the storage pool type 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", +"response": { +"$ref": "StoragePoolType" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of storage pool types available to the specified\nproject.", +"flatPath": "projects/{project}/zones/{zone}/storagePoolTypes", +"httpMethod": "GET", +"id": "compute.storagePoolTypes.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePoolTypes", +"response": { +"$ref": "StoragePoolTypeList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"storagePools": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of storage pools.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/storagePools", +"httpMethod": "GET", +"id": "compute.storagePools.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": "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" +}, +"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/storagePools", +"response": { +"$ref": "StoragePoolAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified storage pool. Deleting a storagePool\nremoves its data permanently and is irreversible. However, deleting a\nstoragePool does not delete any snapshots previously\nmade from the storagePool. You must separately delete\nsnapshots.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"httpMethod": "DELETE", +"id": "compute.storagePools.delete", +"parameterOrder": [ +"project", +"zone", +"storagePool" +], +"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" +}, +"storagePool": { +"description": "Name of the storage pool 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns a specified storage pool. Gets a list of available\nstorage pools by making a list() request.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"httpMethod": "GET", +"id": "compute.storagePools.get", +"parameterOrder": [ +"project", +"zone", +"storagePool" +], +"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" +}, +"storagePool": { +"description": "Name of the storage pool 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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"response": { +"$ref": "StoragePool" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.storagePools.getIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a storage pool in the specified project using the data\nin the request.", +"flatPath": "projects/{project}/zones/{zone}/storagePools", +"httpMethod": "POST", +"id": "compute.storagePools.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools", +"request": { +"$ref": "StoragePool" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of storage pools contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/storagePools", +"httpMethod": "GET", +"id": "compute.storagePools.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools", +"response": { +"$ref": "StoragePoolList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listDisks": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the disks in a specified storage pool.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", +"httpMethod": "GET", +"id": "compute.storagePools.listDisks", +"parameterOrder": [ +"project", +"zone", +"storagePool" +], +"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" +}, +"storagePool": { +"description": "Name of the storage pool to list disks of.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", +"response": { +"$ref": "StoragePoolListDisks" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.storagePools.setIamPolicy", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", +"request": { +"$ref": "ZoneSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.storagePools.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified storagePool 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:\npool_provisioned_capacity_gb, pool_provisioned_iops and\npool_provisioned_throughput.", +"flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"httpMethod": "PATCH", +"id": "compute.storagePools.update", +"parameterOrder": [ +"project", +"zone", +"storagePool" +], +"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" +}, +"storagePool": { +"description": "The storagePool name 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" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", +"request": { +"$ref": "StoragePool" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"subnetworks": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of subnetworks.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/subnetworks", +"httpMethod": "GET", +"id": "compute.subnetworks.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": "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" +}, +"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" +}, +"views": { +"description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", +"enum": [ +"DEFAULT", +"WITH_UTILIZATION" +], +"enumDescriptions": [ +"", +"Utilization data is included in the response." +], +"location": "query", +"repeated": true, +"type": "string" +} +}, +"path": "projects/{project}/aggregated/subnetworks", +"response": { +"$ref": "SubnetworkAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified subnetwork.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", +"httpMethod": "DELETE", +"id": "compute.subnetworks.delete", +"parameterOrder": [ +"project", +"region", +"subnetwork" +], +"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" +}, +"subnetwork": { +"description": "Name of the Subnetwork 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}/regions/{region}/subnetworks/{subnetwork}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"expandIpCidrRange": { +"apiVersion": "2026-10-01-preview", +"description": "Expands the IP CIDR range of the subnetwork to a specified value.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", +"httpMethod": "POST", +"id": "compute.subnetworks.expandIpCidrRange", +"parameterOrder": [ +"project", +"region", +"subnetwork" +], +"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" +}, +"subnetwork": { +"description": "Name of the Subnetwork resource to update.", +"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}/subnetworks/{subnetwork}/expandIpCidrRange", +"request": { +"$ref": "SubnetworksExpandIpCidrRangeRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified subnetwork.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", +"httpMethod": "GET", +"id": "compute.subnetworks.get", +"parameterOrder": [ +"project", +"region", +"subnetwork" +], +"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" +}, +"subnetwork": { +"description": "Name of the Subnetwork 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" +}, +"views": { +"description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", +"enum": [ +"DEFAULT", +"WITH_UTILIZATION" +], +"enumDescriptions": [ +"", +"Utilization data is included in the response." +], +"location": "query", +"repeated": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", +"response": { +"$ref": "Subnetwork" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.subnetworks.getIamPolicy", +"parameterOrder": [ +"project", +"region", +"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" +}, +"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}/subnetworks/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a subnetwork in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/subnetworks", +"httpMethod": "POST", +"id": "compute.subnetworks.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}/subnetworks", +"request": { +"$ref": "Subnetwork" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of subnetworks available to the specified\nproject.", +"flatPath": "projects/{project}/regions/{region}/subnetworks", +"httpMethod": "GET", +"id": "compute.subnetworks.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" +}, +"views": { +"description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", +"enum": [ +"DEFAULT", +"WITH_UTILIZATION" +], +"enumDescriptions": [ +"", +"Utilization data is included in the response." +], +"location": "query", +"repeated": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/subnetworks", +"response": { +"$ref": "SubnetworkList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"listUsable": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of all usable subnetworks in the project.", +"flatPath": "projects/{project}/aggregated/subnetworks/listUsable", +"httpMethod": "GET", +"id": "compute.subnetworks.listUsable", +"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" +}, +"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" +}, +"serviceProject": { +"description": "The project id or project number in which the subnetwork is intended to be\nused. Only applied for Shared VPC. See [Shared VPC\ndocumentation](https://cloud.google.com/vpc/docs/shared-vpc/)", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/aggregated/subnetworks/listUsable", +"response": { +"$ref": "UsableSubnetworksAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified subnetwork with the data included in the request.\nOnly certain fields can be updated with a patch request\nas indicated in the field descriptions.\nYou must specify the current fingerprint of the\nsubnetwork resource being patched.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", +"httpMethod": "PATCH", +"id": "compute.subnetworks.patch", +"parameterOrder": [ +"project", +"region", +"subnetwork" +], +"parameters": { +"drainTimeoutSeconds": { +"description": "The drain timeout specifies the upper bound in seconds on the amount of\ntime allowed to drain connections from the current ACTIVE subnetwork\nto the current BACKUP subnetwork. The drain timeout is only applicable\nwhen the following conditions are true:\n - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER\n - the subnetwork being patched has role = BACKUP\n - the patch request is setting the role to ACTIVE. Note that after this\n patch operation the roles of the ACTIVE and BACKUP subnetworks will be\n swapped.", +"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" +}, +"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" +}, +"subnetwork": { +"description": "Name of the Subnetwork 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}/subnetworks/{subnetwork}", +"request": { +"$ref": "Subnetwork" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setIamPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.subnetworks.setIamPolicy", +"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}/subnetworks/{resource}/setIamPolicy", +"request": { +"$ref": "RegionSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setPrivateIpGoogleAccess": { +"apiVersion": "2026-10-01-preview", +"description": "Set whether VMs in this subnet can access Google services without assigning\nexternal IP addresses through Private Google Access.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", +"httpMethod": "POST", +"id": "compute.subnetworks.setPrivateIpGoogleAccess", +"parameterOrder": [ +"project", +"region", +"subnetwork" +], +"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" +}, +"subnetwork": { +"description": "Name of the Subnetwork resource.", +"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}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", +"request": { +"$ref": "SubnetworksSetPrivateIpGoogleAccessRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.subnetworks.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}/subnetworks/{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" +] +} +} +}, +"targetGrpcProxies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetGrpcProxy in the given scope", +"flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", +"httpMethod": "DELETE", +"id": "compute.targetGrpcProxies.delete", +"parameterOrder": [ +"project", +"targetGrpcProxy" +], +"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" +}, +"targetGrpcProxy": { +"description": "Name of the TargetGrpcProxy 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/targetGrpcProxies/{targetGrpcProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetGrpcProxy resource in the given scope.", +"flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", +"httpMethod": "GET", +"id": "compute.targetGrpcProxies.get", +"parameterOrder": [ +"project", +"targetGrpcProxy" +], +"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" +}, +"targetGrpcProxy": { +"description": "Name of the TargetGrpcProxy 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/targetGrpcProxies/{targetGrpcProxy}", +"response": { +"$ref": "TargetGrpcProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetGrpcProxy in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/global/targetGrpcProxies", +"httpMethod": "POST", +"id": "compute.targetGrpcProxies.insert", +"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" +} +}, +"path": "projects/{project}/global/targetGrpcProxies", +"request": { +"$ref": "TargetGrpcProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the TargetGrpcProxies for a project in the given scope.", +"flatPath": "projects/{project}/global/targetGrpcProxies", +"httpMethod": "GET", +"id": "compute.targetGrpcProxies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/targetGrpcProxies", +"response": { +"$ref": "TargetGrpcProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified TargetGrpcProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", +"httpMethod": "PATCH", +"id": "compute.targetGrpcProxies.patch", +"parameterOrder": [ +"project", +"targetGrpcProxy" +], +"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" +}, +"targetGrpcProxy": { +"description": "Name of the TargetGrpcProxy 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}/global/targetGrpcProxies/{targetGrpcProxy}", +"request": { +"$ref": "TargetGrpcProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"targetHttpProxies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all TargetHttpProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetHttpProxies", +"httpMethod": "GET", +"id": "compute.targetHttpProxies.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" +}, +"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/targetHttpProxies", +"response": { +"$ref": "TargetHttpProxyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetHttpProxy resource.", +"flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", +"httpMethod": "DELETE", +"id": "compute.targetHttpProxies.delete", +"parameterOrder": [ +"project", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy 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/targetHttpProxies/{targetHttpProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetHttpProxy resource.", +"flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", +"httpMethod": "GET", +"id": "compute.targetHttpProxies.get", +"parameterOrder": [ +"project", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy 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/targetHttpProxies/{targetHttpProxy}", +"response": { +"$ref": "TargetHttpProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetHttpProxy resource in the specified\nproject using the data included in the request.", +"flatPath": "projects/{project}/global/targetHttpProxies", +"httpMethod": "POST", +"id": "compute.targetHttpProxies.insert", +"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" +} +}, +"path": "projects/{project}/global/targetHttpProxies", +"request": { +"$ref": "TargetHttpProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetHttpProxy resources available\nto the specified project.", +"flatPath": "projects/{project}/global/targetHttpProxies", +"httpMethod": "GET", +"id": "compute.targetHttpProxies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/targetHttpProxies", +"response": { +"$ref": "TargetHttpProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified TargetHttpProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", +"httpMethod": "PATCH", +"id": "compute.targetHttpProxies.patch", +"parameterOrder": [ +"project", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy 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}/global/targetHttpProxies/{targetHttpProxy}", +"request": { +"$ref": "TargetHttpProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setUrlMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the URL map for TargetHttpProxy.", +"flatPath": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", +"httpMethod": "POST", +"id": "compute.targetHttpProxies.setUrlMap", +"parameterOrder": [ +"project", +"targetHttpProxy" +], +"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" +}, +"targetHttpProxy": { +"description": "Name of the TargetHttpProxy to set a URL map for.", +"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}/targetHttpProxies/{targetHttpProxy}/setUrlMap", +"request": { +"$ref": "UrlMapReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"targetHttpsProxies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all TargetHttpsProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetHttpsProxies", +"httpMethod": "GET", +"id": "compute.targetHttpsProxies.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" +}, +"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/targetHttpsProxies", +"response": { +"$ref": "TargetHttpsProxyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetHttpsProxy resource.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "DELETE", +"id": "compute.targetHttpsProxies.delete", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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/targetHttpsProxies/{targetHttpsProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetHttpsProxy resource.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "GET", +"id": "compute.targetHttpsProxies.get", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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/targetHttpsProxies/{targetHttpsProxy}", +"response": { +"$ref": "TargetHttpsProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetHttpsProxy resource in the specified\nproject using the data included in the request.", +"flatPath": "projects/{project}/global/targetHttpsProxies", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.insert", +"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" +} +}, +"path": "projects/{project}/global/targetHttpsProxies", +"request": { +"$ref": "TargetHttpsProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetHttpsProxy resources\navailable to the specified project.", +"flatPath": "projects/{project}/global/targetHttpsProxies", +"httpMethod": "GET", +"id": "compute.targetHttpsProxies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/targetHttpsProxies", +"response": { +"$ref": "TargetHttpsProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified TargetHttpsProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", +"httpMethod": "PATCH", +"id": "compute.targetHttpsProxies.patch", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy 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}/global/targetHttpsProxies/{targetHttpsProxy}", +"request": { +"$ref": "TargetHttpsProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setCertificateMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the Certificate Map for TargetHttpsProxy.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.setCertificateMap", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource whose CertificateMap is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", +"request": { +"$ref": "TargetHttpsProxiesSetCertificateMapRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setQuicOverride": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the QUIC override policy for TargetHttpsProxy.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.setQuicOverride", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource to set the QUIC override policy for.\nThe name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", +"request": { +"$ref": "TargetHttpsProxiesSetQuicOverrideRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSslCertificates": { +"apiVersion": "2026-10-01-preview", +"description": "Replaces SslCertificates for TargetHttpsProxy.", +"flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.setSslCertificates", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource to set an\nSslCertificates resource for.", +"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}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", +"request": { +"$ref": "TargetHttpsProxiesSetSslCertificatesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSslPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the\nserver-side support for SSL features. This affects connections between\nclients and the HTTPS proxy load balancer. They do not affect the\nconnection between the load balancer and the backends.", +"flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.setSslPolicy", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource whose SSL policy is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", +"request": { +"$ref": "SslPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setUrlMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the URL map for TargetHttpsProxy.", +"flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", +"httpMethod": "POST", +"id": "compute.targetHttpsProxies.setUrlMap", +"parameterOrder": [ +"project", +"targetHttpsProxy" +], +"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" +}, +"targetHttpsProxy": { +"description": "Name of the TargetHttpsProxy resource whose URL map is\nto be set.", +"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}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", +"request": { +"$ref": "UrlMapReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"targetInstances": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of target instances.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetInstances", +"httpMethod": "GET", +"id": "compute.targetInstances.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": "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" +}, +"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/targetInstances", +"response": { +"$ref": "TargetInstanceAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetInstance resource.", +"flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", +"httpMethod": "DELETE", +"id": "compute.targetInstances.delete", +"parameterOrder": [ +"project", +"zone", +"targetInstance" +], +"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" +}, +"targetInstance": { +"description": "Name of the TargetInstance 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" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetInstance resource.", +"flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", +"httpMethod": "GET", +"id": "compute.targetInstances.get", +"parameterOrder": [ +"project", +"zone", +"targetInstance" +], +"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" +}, +"targetInstance": { +"description": "Name of the TargetInstance 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" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", +"response": { +"$ref": "TargetInstance" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetInstance resource in the specified project and zone using\nthe data included in the request.", +"flatPath": "projects/{project}/zones/{zone}/targetInstances", +"httpMethod": "POST", +"id": "compute.targetInstances.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances", +"request": { +"$ref": "TargetInstance" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of TargetInstance resources available to the specified\nproject and zone.", +"flatPath": "projects/{project}/zones/{zone}/targetInstances", +"httpMethod": "GET", +"id": "compute.targetInstances.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances", +"response": { +"$ref": "TargetInstanceList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Google Cloud Armor security policy for the specified target\ninstance. For more information, seeGoogle\nCloud Armor Overview", +"flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", +"httpMethod": "POST", +"id": "compute.targetInstances.setSecurityPolicy", +"parameterOrder": [ +"project", +"zone", +"targetInstance" +], +"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" +}, +"targetInstance": { +"description": "Name of the TargetInstance resource to which the security policy should be\nset. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/zones/{zone}/targetInstances/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.targetInstances.testIamPermissions", +"parameterOrder": [ +"project", +"zone", +"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" +}, +"zone": { +"description": "The name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/targetInstances/{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" +] +} +} +}, +"targetPools": { +"methods": { +"addHealthCheck": { +"apiVersion": "2026-10-01-preview", +"description": "Adds health check URLs to a target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", +"httpMethod": "POST", +"id": "compute.targetPools.addHealthCheck", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the target pool to add a health check to.", +"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}/targetPools/{targetPool}/addHealthCheck", +"request": { +"$ref": "TargetPoolsAddHealthCheckRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"addInstance": { +"apiVersion": "2026-10-01-preview", +"description": "Adds an instance to a target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", +"httpMethod": "POST", +"id": "compute.targetPools.addInstance", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool resource to add instances to.", +"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}/targetPools/{targetPool}/addInstance", +"request": { +"$ref": "TargetPoolsAddInstanceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of target pools.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetPools", +"httpMethod": "GET", +"id": "compute.targetPools.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": "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" +}, +"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/targetPools", +"response": { +"$ref": "TargetPoolAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", +"httpMethod": "DELETE", +"id": "compute.targetPools.delete", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool 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}/regions/{region}/targetPools/{targetPool}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", +"httpMethod": "GET", +"id": "compute.targetPools.get", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool 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}/regions/{region}/targetPools/{targetPool}", +"response": { +"$ref": "TargetPool" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getHealth": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the most recent health check results for each IP for the\ninstance that is referenced by the given target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", +"httpMethod": "POST", +"id": "compute.targetPools.getHealth", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool resource to which the queried instance belongs.", +"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}/targetPools/{targetPool}/getHealth", +"request": { +"$ref": "InstanceReference" +}, +"response": { +"$ref": "TargetPoolInstanceHealth" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a target pool in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/targetPools", +"httpMethod": "POST", +"id": "compute.targetPools.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}/targetPools", +"request": { +"$ref": "TargetPool" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of target pools available to the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/targetPools", +"httpMethod": "GET", +"id": "compute.targetPools.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" +} +}, +"path": "projects/{project}/regions/{region}/targetPools", +"response": { +"$ref": "TargetPoolList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"removeHealthCheck": { +"apiVersion": "2026-10-01-preview", +"description": "Removes health check URL from a target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", +"httpMethod": "POST", +"id": "compute.targetPools.removeHealthCheck", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the target pool to remove health checks from.", +"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}/targetPools/{targetPool}/removeHealthCheck", +"request": { +"$ref": "TargetPoolsRemoveHealthCheckRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"removeInstance": { +"apiVersion": "2026-10-01-preview", +"description": "Removes instance URL from a target pool.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", +"httpMethod": "POST", +"id": "compute.targetPools.removeInstance", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool resource to remove instances from.", +"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}/targetPools/{targetPool}/removeInstance", +"request": { +"$ref": "TargetPoolsRemoveInstanceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setBackup": { +"apiVersion": "2026-10-01-preview", +"description": "Changes a backup target pool's configurations.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", +"httpMethod": "POST", +"id": "compute.targetPools.setBackup", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"parameters": { +"failoverRatio": { +"description": "New failoverRatio value for the target pool.", +"format": "float", +"location": "query", +"type": "number" +}, +"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" +}, +"targetPool": { +"description": "Name of the TargetPool resource to set a backup pool for.", +"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}/targetPools/{targetPool}/setBackup", +"request": { +"$ref": "TargetReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSecurityPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the Google Cloud Armor security policy for the specified target pool.\nFor more information, seeGoogle\nCloud Armor Overview", +"flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", +"httpMethod": "POST", +"id": "compute.targetPools.setSecurityPolicy", +"parameterOrder": [ +"project", +"region", +"targetPool" +], +"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" +}, +"targetPool": { +"description": "Name of the TargetPool resource to which the security policy should be\nset. The name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", +"request": { +"$ref": "SecurityPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/targetPools/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.targetPools.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}/targetPools/{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" +] +} +} +}, +"targetSslProxies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetSslProxy resource.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", +"httpMethod": "DELETE", +"id": "compute.targetSslProxies.delete", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy 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/targetSslProxies/{targetSslProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetSslProxy resource.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", +"httpMethod": "GET", +"id": "compute.targetSslProxies.get", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy 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/targetSslProxies/{targetSslProxy}", +"response": { +"$ref": "TargetSslProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetSslProxy resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/targetSslProxies", +"httpMethod": "POST", +"id": "compute.targetSslProxies.insert", +"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" +} +}, +"path": "projects/{project}/global/targetSslProxies", +"request": { +"$ref": "TargetSslProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetSslProxy resources\navailable to the specified project.", +"flatPath": "projects/{project}/global/targetSslProxies", +"httpMethod": "GET", +"id": "compute.targetSslProxies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/targetSslProxies", +"response": { +"$ref": "TargetSslProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setBackendService": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the BackendService for TargetSslProxy.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", +"httpMethod": "POST", +"id": "compute.targetSslProxies.setBackendService", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy resource whose BackendService resource\nis to be set.", +"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/targetSslProxies/{targetSslProxy}/setBackendService", +"request": { +"$ref": "TargetSslProxiesSetBackendServiceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setCertificateMap": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the Certificate Map for TargetSslProxy.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", +"httpMethod": "POST", +"id": "compute.targetSslProxies.setCertificateMap", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy resource whose CertificateMap is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", +"request": { +"$ref": "TargetSslProxiesSetCertificateMapRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setProxyHeader": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the ProxyHeaderType for TargetSslProxy.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", +"httpMethod": "POST", +"id": "compute.targetSslProxies.setProxyHeader", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy resource whose ProxyHeader is to be set.", +"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/targetSslProxies/{targetSslProxy}/setProxyHeader", +"request": { +"$ref": "TargetSslProxiesSetProxyHeaderRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSslCertificates": { +"apiVersion": "2026-10-01-preview", +"description": "Changes SslCertificates for TargetSslProxy.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", +"httpMethod": "POST", +"id": "compute.targetSslProxies.setSslCertificates", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy resource whose SslCertificate resource\nis to be set.", +"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/targetSslProxies/{targetSslProxy}/setSslCertificates", +"request": { +"$ref": "TargetSslProxiesSetSslCertificatesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setSslPolicy": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the SSL policy for TargetSslProxy. The SSL policy specifies the\nserver-side support for SSL features. This affects connections between\nclients and the load balancer. They do not affect the\nconnection between the load balancer and the backends.", +"flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", +"httpMethod": "POST", +"id": "compute.targetSslProxies.setSslPolicy", +"parameterOrder": [ +"project", +"targetSslProxy" +], +"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" +}, +"targetSslProxy": { +"description": "Name of the TargetSslProxy resource whose SSL policy is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", +"request": { +"$ref": "SslPolicyReference" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/targetSslProxies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.targetSslProxies.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/targetSslProxies/{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" +] +} +} +}, +"targetTcpProxies": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all TargetTcpProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetTcpProxies", +"httpMethod": "GET", +"id": "compute.targetTcpProxies.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" +}, +"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/targetTcpProxies", +"response": { +"$ref": "TargetTcpProxyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified TargetTcpProxy resource.", +"flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", +"httpMethod": "DELETE", +"id": "compute.targetTcpProxies.delete", +"parameterOrder": [ +"project", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy 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/targetTcpProxies/{targetTcpProxy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified TargetTcpProxy resource.", +"flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", +"httpMethod": "GET", +"id": "compute.targetTcpProxies.get", +"parameterOrder": [ +"project", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy 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/targetTcpProxies/{targetTcpProxy}", +"response": { +"$ref": "TargetTcpProxy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a TargetTcpProxy resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/targetTcpProxies", +"httpMethod": "POST", +"id": "compute.targetTcpProxies.insert", +"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" +} +}, +"path": "projects/{project}/global/targetTcpProxies", +"request": { +"$ref": "TargetTcpProxy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of TargetTcpProxy resources\navailable to the specified project.", +"flatPath": "projects/{project}/global/targetTcpProxies", +"httpMethod": "GET", +"id": "compute.targetTcpProxies.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/targetTcpProxies", +"response": { +"$ref": "TargetTcpProxyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setBackendService": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the BackendService for TargetTcpProxy.", +"flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", +"httpMethod": "POST", +"id": "compute.targetTcpProxies.setBackendService", +"parameterOrder": [ +"project", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy resource whose BackendService resource\nis to be set.", +"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/targetTcpProxies/{targetTcpProxy}/setBackendService", +"request": { +"$ref": "TargetTcpProxiesSetBackendServiceRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"setProxyHeader": { +"apiVersion": "2026-10-01-preview", +"description": "Changes the ProxyHeaderType for TargetTcpProxy.", +"flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", +"httpMethod": "POST", +"id": "compute.targetTcpProxies.setProxyHeader", +"parameterOrder": [ +"project", +"targetTcpProxy" +], +"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" +}, +"targetTcpProxy": { +"description": "Name of the TargetTcpProxy resource whose ProxyHeader is to be set.", +"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/targetTcpProxies/{targetTcpProxy}/setProxyHeader", +"request": { +"$ref": "TargetTcpProxiesSetProxyHeaderRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/targetTcpProxies/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.targetTcpProxies.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/targetTcpProxies/{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" +] +} +} +}, +"targetVpnGateways": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of target VPN gateways.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/targetVpnGateways", +"httpMethod": "GET", +"id": "compute.targetVpnGateways.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": "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" +}, +"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/targetVpnGateways", +"response": { +"$ref": "TargetVpnGatewayAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified target VPN gateway.", +"flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", +"httpMethod": "DELETE", +"id": "compute.targetVpnGateways.delete", +"parameterOrder": [ +"project", +"region", +"targetVpnGateway" +], +"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" +}, +"targetVpnGateway": { +"description": "Name of the target VPN gateway 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}/regions/{region}/targetVpnGateways/{targetVpnGateway}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified target VPN gateway.", +"flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", +"httpMethod": "GET", +"id": "compute.targetVpnGateways.get", +"parameterOrder": [ +"project", +"region", +"targetVpnGateway" +], +"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" +}, +"targetVpnGateway": { +"description": "Name of the target VPN gateway 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}/regions/{region}/targetVpnGateways/{targetVpnGateway}", +"response": { +"$ref": "TargetVpnGateway" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a target VPN gateway in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/targetVpnGateways", +"httpMethod": "POST", +"id": "compute.targetVpnGateways.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 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" +} +}, +"path": "projects/{project}/regions/{region}/targetVpnGateways", +"request": { +"$ref": "TargetVpnGateway" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of target VPN gateways available to the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/targetVpnGateways", +"httpMethod": "GET", +"id": "compute.targetVpnGateways.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/targetVpnGateways", +"response": { +"$ref": "TargetVpnGatewayList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.targetVpnGateways.setLabels", +"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 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" +}, +"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}/targetVpnGateways/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"urlMaps": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of all UrlMap resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/urlMaps", +"httpMethod": "GET", +"id": "compute.urlMaps.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" +}, +"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/urlMaps", +"response": { +"$ref": "UrlMapsAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified UrlMap resource.", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}", +"httpMethod": "DELETE", +"id": "compute.urlMaps.delete", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap 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/urlMaps/{urlMap}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified UrlMap resource.", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}", +"httpMethod": "GET", +"id": "compute.urlMaps.get", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap 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/urlMaps/{urlMap}", +"response": { +"$ref": "UrlMap" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a UrlMap resource in the specified project using\nthe data included in the request.", +"flatPath": "projects/{project}/global/urlMaps", +"httpMethod": "POST", +"id": "compute.urlMaps.insert", +"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" +} +}, +"path": "projects/{project}/global/urlMaps", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"invalidateCache": { +"apiVersion": "2026-10-01-preview", +"description": "Initiates a cache invalidation operation, invalidating the specified path,\nscoped to the specified UrlMap.\n\nFor more information, see [Invalidating cached\ncontent](/cdn/docs/invalidating-cached-content).", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", +"httpMethod": "POST", +"id": "compute.urlMaps.invalidateCache", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap scoping 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/urlMaps/{urlMap}/invalidateCache", +"request": { +"$ref": "CacheInvalidationRule" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of UrlMap resources available to the specified\nproject.", +"flatPath": "projects/{project}/global/urlMaps", +"httpMethod": "GET", +"id": "compute.urlMaps.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/global/urlMaps", +"response": { +"$ref": "UrlMapList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Patches the specified UrlMap resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}", +"httpMethod": "PATCH", +"id": "compute.urlMaps.patch", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap 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}/global/urlMaps/{urlMap}", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/urlMaps/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.urlMaps.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/urlMaps/{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": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified UrlMap resource with the data included in the\nrequest.", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}", +"httpMethod": "PUT", +"id": "compute.urlMaps.update", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap resource to update.", +"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/urlMaps/{urlMap}", +"request": { +"$ref": "UrlMap" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"validate": { +"apiVersion": "2026-10-01-preview", +"description": "Runs static validation for the UrlMap. In particular, the tests of the\nprovided UrlMap will be run. Calling this method does NOT create the\nUrlMap.", +"flatPath": "projects/{project}/global/urlMaps/{urlMap}/validate", +"httpMethod": "POST", +"id": "compute.urlMaps.validate", +"parameterOrder": [ +"project", +"urlMap" +], +"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" +}, +"urlMap": { +"description": "Name of the UrlMap resource to be validated as.", +"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/urlMaps/{urlMap}/validate", +"request": { +"$ref": "UrlMapsValidateRequest" +}, +"response": { +"$ref": "UrlMapsValidateResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"vpnGateways": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of VPN gateways.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/vpnGateways", +"httpMethod": "GET", +"id": "compute.vpnGateways.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": "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" +}, +"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/vpnGateways", +"response": { +"$ref": "VpnGatewayAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified VPN gateway.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", +"httpMethod": "DELETE", +"id": "compute.vpnGateways.delete", +"parameterOrder": [ +"project", +"region", +"vpnGateway" +], +"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" +}, +"vpnGateway": { +"description": "Name of the VPN gateway 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}/regions/{region}/vpnGateways/{vpnGateway}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified VPN gateway.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", +"httpMethod": "GET", +"id": "compute.vpnGateways.get", +"parameterOrder": [ +"project", +"region", +"vpnGateway" +], +"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" +}, +"vpnGateway": { +"description": "Name of the VPN gateway 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}/regions/{region}/vpnGateways/{vpnGateway}", +"response": { +"$ref": "VpnGateway" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"getStatus": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the status for the specified VPN gateway.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", +"httpMethod": "GET", +"id": "compute.vpnGateways.getStatus", +"parameterOrder": [ +"project", +"region", +"vpnGateway" +], +"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" +}, +"vpnGateway": { +"description": "Name of the VPN gateway 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}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", +"response": { +"$ref": "VpnGatewaysGetStatusResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a VPN gateway in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways", +"httpMethod": "POST", +"id": "compute.vpnGateways.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 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" +} +}, +"path": "projects/{project}/regions/{region}/vpnGateways", +"request": { +"$ref": "VpnGateway" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of VPN gateways available to the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways", +"httpMethod": "GET", +"id": "compute.vpnGateways.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/vpnGateways", +"response": { +"$ref": "VpnGatewayList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a VpnGateway. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.vpnGateways.setLabels", +"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 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" +}, +"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}/vpnGateways/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"apiVersion": "2026-10-01-preview", +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.vpnGateways.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}/vpnGateways/{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" +] +} +} +}, +"vpnTunnels": { +"methods": { +"aggregatedList": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves an aggregated list of VPN tunnels.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/vpnTunnels", +"httpMethod": "GET", +"id": "compute.vpnTunnels.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": "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" +}, +"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/vpnTunnels", +"response": { +"$ref": "VpnTunnelAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified VpnTunnel resource.", +"flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", +"httpMethod": "DELETE", +"id": "compute.vpnTunnels.delete", +"parameterOrder": [ +"project", +"region", +"vpnTunnel" +], +"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" +}, +"vpnTunnel": { +"description": "Name of the VpnTunnel 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}/regions/{region}/vpnTunnels/{vpnTunnel}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified VpnTunnel resource.", +"flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", +"httpMethod": "GET", +"id": "compute.vpnTunnels.get", +"parameterOrder": [ +"project", +"region", +"vpnTunnel" +], +"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" +}, +"vpnTunnel": { +"description": "Name of the VpnTunnel 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}/regions/{region}/vpnTunnels/{vpnTunnel}", +"response": { +"$ref": "VpnTunnel" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a VpnTunnel resource in the specified project and region using\nthe data included in the request.", +"flatPath": "projects/{project}/regions/{region}/vpnTunnels", +"httpMethod": "POST", +"id": "compute.vpnTunnels.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 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" +} +}, +"path": "projects/{project}/regions/{region}/vpnTunnels", +"request": { +"$ref": "VpnTunnel" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of VpnTunnel resources contained in the specified\nproject and region.", +"flatPath": "projects/{project}/regions/{region}/vpnTunnels", +"httpMethod": "GET", +"id": "compute.vpnTunnels.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 for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/vpnTunnels", +"response": { +"$ref": "VpnTunnelList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setLabels": { +"apiVersion": "2026-10-01-preview", +"description": "Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling\nResources documentation.", +"flatPath": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", +"httpMethod": "POST", +"id": "compute.vpnTunnels.setLabels", +"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 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" +}, +"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}/vpnTunnels/{resource}/setLabels", +"request": { +"$ref": "RegionSetLabelsRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"wireGroups": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified wire group in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"httpMethod": "DELETE", +"id": "compute.wireGroups.delete", +"parameterOrder": [ +"project", +"crossSiteNetwork", +"wireGroup" +], +"parameters": { +"crossSiteNetwork": { +"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. 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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"wireGroup": { +"description": "Name of the wire group resource to delete.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Gets the specified wire group resource in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"httpMethod": "GET", +"id": "compute.wireGroups.get", +"parameterOrder": [ +"project", +"crossSiteNetwork", +"wireGroup" +], +"parameters": { +"crossSiteNetwork": { +"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" +}, +"wireGroup": { +"description": "Name of the wire group resource to return.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"response": { +"$ref": "WireGroup" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a wire group in the specified project in the given scope\nusing the parameters that are included in the request.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", +"httpMethod": "POST", +"id": "compute.wireGroups.insert", +"parameterOrder": [ +"project", +"crossSiteNetwork" +], +"parameters": { +"crossSiteNetwork": { +"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. 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).\nend_interface: MixerMutationRequestBuilder", +"location": "query", +"type": "string" +}, +"validateOnly": { +"description": "[Input Only] Validate the new configuration, but don't create it.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", +"request": { +"$ref": "WireGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists the wire groups for a project in the given scope.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", +"httpMethod": "GET", +"id": "compute.wireGroups.list", +"parameterOrder": [ +"project", +"crossSiteNetwork" +], +"parameters": { +"crossSiteNetwork": { +"location": "path", +"required": true, +"type": "string" +}, +"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" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", +"response": { +"$ref": "WireGroupList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"apiVersion": "2026-10-01-preview", +"description": "Updates the specified wire group resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"httpMethod": "PATCH", +"id": "compute.wireGroups.patch", +"parameterOrder": [ +"project", +"crossSiteNetwork", +"wireGroup" +], +"parameters": { +"crossSiteNetwork": { +"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. 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).\nend_interface: MixerMutationRequestBuilder", +"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" +}, +"validateOnly": { +"description": "[Input Only] Validate the new configuration, but don't update it.", +"location": "query", +"type": "boolean" +}, +"wireGroup": { +"description": "Name of the WireGroups resource to patch.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", +"request": { +"$ref": "WireGroup" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"zoneOperations": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes the specified zone-specific Operations resource.", +"flatPath": "projects/{project}/zones/{zone}/operations/{operation}", +"httpMethod": "DELETE", +"id": "compute.zoneOperations.delete", +"parameterOrder": [ +"project", +"zone", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/operations/{operation}", +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the specified zone-specific Operations resource.", +"flatPath": "projects/{project}/zones/{zone}/operations/{operation}", +"httpMethod": "GET", +"id": "compute.zoneOperations.get", +"parameterOrder": [ +"project", +"zone", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/operations/{operation}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves a list of Operation resources contained within\nthe specified zone.", +"flatPath": "projects/{project}/zones/{zone}/operations", +"httpMethod": "GET", +"id": "compute.zoneOperations.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/operations", +"response": { +"$ref": "OperationList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"wait": { +"apiVersion": "2026-10-01-preview", +"description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method waits for no more than the\n2 minutes and then returns the current state of the\noperation, which might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", +"flatPath": "projects/{project}/zones/{zone}/operations/{operation}/wait", +"httpMethod": "POST", +"id": "compute.zoneOperations.wait", +"parameterOrder": [ +"project", +"zone", +"operation" +], +"parameters": { +"operation": { +"description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/operations/{operation}/wait", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"zoneVmExtensionPolicies": { +"methods": { +"delete": { +"apiVersion": "2026-10-01-preview", +"description": "Deletes a specified zone VM extension policy within a project.", +"flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"httpMethod": "DELETE", +"id": "compute.zoneVmExtensionPolicies.delete", +"parameterOrder": [ +"project", +"zone", +"vmExtensionPolicy" +], +"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" +}, +"vmExtensionPolicy": { +"description": "Name of the zone VM extension policy to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves details of a specific zone VM extension policy within a project.", +"flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"httpMethod": "GET", +"id": "compute.zoneVmExtensionPolicies.get", +"parameterOrder": [ +"project", +"zone", +"vmExtensionPolicy" +], +"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" +}, +"vmExtensionPolicy": { +"description": "Name of the VM extension policy 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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"response": { +"$ref": "VmExtensionPolicy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"apiVersion": "2026-10-01-preview", +"description": "Creates a new zone-level VM extension policy within a project.", +"flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies", +"httpMethod": "POST", +"id": "compute.zoneVmExtensionPolicies.insert", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/vmExtensionPolicies", +"request": { +"$ref": "VmExtensionPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Lists all VM extension policies within a specific zone for a project.", +"flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies", +"httpMethod": "GET", +"id": "compute.zoneVmExtensionPolicies.list", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/vmExtensionPolicies", +"response": { +"$ref": "VmExtensionPolicyList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"apiVersion": "2026-10-01-preview", +"description": "Modifies an existing zone VM extension policy within a project.", +"flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"httpMethod": "PATCH", +"id": "compute.zoneVmExtensionPolicies.update", +"parameterOrder": [ +"project", +"zone", +"vmExtensionPolicy" +], +"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" +}, +"vmExtensionPolicy": { +"description": "Name of the zone VM extension policy to update.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", +"request": { +"$ref": "VmExtensionPolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"zones": { +"methods": { +"get": { +"apiVersion": "2026-10-01-preview", +"description": "Returns the specified Zone resource.", +"flatPath": "projects/{project}/zones/{zone}", +"httpMethod": "GET", +"id": "compute.zones.get", +"parameterOrder": [ +"project", +"zone" +], +"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" +}, +"zone": { +"description": "Name of the zone 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}/zones/{zone}", +"response": { +"$ref": "Zone" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"list": { +"apiVersion": "2026-10-01-preview", +"description": "Retrieves the list of Zone resources available to the specified project.", +"flatPath": "projects/{project}/zones", +"httpMethod": "GET", +"id": "compute.zones.list", +"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" +}, +"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" +} +}, +"path": "projects/{project}/zones", +"response": { +"$ref": "ZoneList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +} +}, +"revision": "20260910", +"rootUrl": "https://compute.googleapis.com/", +"schemas": { +"AWSV4Signature": { +"description": "Contains the configurations necessary to generate a signature for access to\nprivate storage buckets that support Signature Version 4 for authentication.\nThe service name for generating the authentication header will always default\nto 's3'.", +"id": "AWSV4Signature", +"properties": { +"accessKey": { +"description": "The access key used for s3 bucket authentication. Required for updating or\ncreating a backend that uses AWS v4 signature authentication, but will not\nbe returned as part of the configuration when queried with a REST API GET\nrequest.\n\n@InputOnly", +"type": "string" +}, +"accessKeyId": { +"description": "The identifier of an access key used for s3 bucket authentication.", +"type": "string" +}, +"accessKeyVersion": { +"description": "The optional version identifier for the access key. You can use this to\nkeep track of different iterations of your access key.", +"type": "string" +}, +"originRegion": { +"description": "The name of the cloud region of your origin. This is a free-form field with\nthe name of the region your cloud uses to host your origin. For example,\n\"us-east-1\" for AWS or \"us-ashburn-1\" for OCI.", +"type": "string" +} +}, +"type": "object" +}, +"AcceleratorConfig": { +"description": "A specification of the type and number of accelerator cards attached to the\ninstance.", +"id": "AcceleratorConfig", +"properties": { +"acceleratorCount": { +"description": "The number of the guest accelerator cards exposed to this instance.", +"format": "int32", +"type": "integer" +}, +"acceleratorType": { +"description": "Full or partial URL of the accelerator type resource to attach to this\ninstance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100\nIf you are creating an instance template, specify only the\naccelerator name.\nSee GPUs on Compute Engine\nfor a full list of accelerator types.", +"type": "string" +} +}, +"type": "object" +}, +"AcceleratorTopologiesInfo": { +"description": "Info for accelerator topologies within a densely packed reservation.", +"id": "AcceleratorTopologiesInfo", +"properties": { +"acceleratorTopologyInfos": { +"description": "Info for each accelerator topology.", +"items": { +"$ref": "AcceleratorTopologiesInfoAcceleratorTopologyInfo" +}, +"type": "array" +} +}, +"type": "object" +}, +"AcceleratorTopologiesInfoAcceleratorTopologyInfo": { +"description": "Info for a slice of a given topology.", +"id": "AcceleratorTopologiesInfoAcceleratorTopologyInfo", +"properties": { +"acceleratorTopology": { +"description": "The accelerator topology.", +"type": "string" +}, +"infoPerTopologyStates": { +"description": "Info for each topology state.", +"items": { +"$ref": "AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState" +}, +"type": "array" +} +}, +"type": "object" +}, +"AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState": { +"description": "Info for each topology state.", +"id": "AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState", +"properties": { +"count": { +"description": "The number of accelerator topologies in this state.", +"format": "int32", +"type": "integer" +}, +"state": { +"description": "The state of the accelerator topology.", +"enum": [ +"AVAILABLE", +"DEGRADED", +"RUNNING", +"TOPOLOGY_STATE_UNSPECIFIED", +"UNHEALTHY" +], +"enumDeprecated": [ +false, +false, +false, +false, +true +], +"enumDescriptions": [ +"The accelerator topology is available.", +"The accelerator topology is degraded. The underlying capacity is not in a\nhealthy state and is not available.", +"The accelerator topology is running. If there are both running and\ndegraded hosts within a topology, DEGRADED state will be returned.", +"The state of the topology is unspecified.", +"This value has been deprecated and is no longer used." +], +"type": "string" +} +}, +"type": "object" +}, +"AcceleratorType": { +"description": "Represents an Accelerator Type resource.\n\nGoogle Cloud Platform provides graphics processing units (accelerators) that\nyou can add to VM instances to improve or accelerate performance when working\nwith intensive workloads. For more information, readGPUs on Compute Engine.", +"id": "AcceleratorType", +"properties": { +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339 text format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this accelerator type." +}, +"description": { +"description": "[Output Only] An optional textual description of the resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#acceleratorType", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types.", +"readOnly": true, +"type": "string" +}, +"maximumCardsPerInstance": { +"description": "[Output Only] Maximum number of accelerator cards allowed per instance.", +"format": "int32", +"type": "integer" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"resourceMetadata": { +"$ref": "ResourceMetadata", +"description": "Output only. Contains standard resource metadata for an AcceleratorType\nresource. It is populated for each instance of the AcceleratorType\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined, fully qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "[Output Only] The name of the zone where the accelerator type resides,\nsuch as us-central1-a.\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" +} +}, +"type": "object" +}, +"AcceleratorTypeAggregatedList": { +"id": "AcceleratorTypeAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "AcceleratorTypesScopedList", +"description": "[Output Only] Name of the scope containing this set of accelerator types." +}, +"description": "A list of AcceleratorTypesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#acceleratorTypeAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of\naccelerator types.", +"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" +}, +"AcceleratorTypeList": { +"description": "Contains a list of accelerator types.", +"id": "AcceleratorTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of AcceleratorType resources.", +"items": { +"$ref": "AcceleratorType" +}, +"type": "array" +}, +"kind": { +"default": "compute#acceleratorTypeList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types.", +"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.", +"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" +}, +"AcceleratorTypesScopedList": { +"id": "AcceleratorTypesScopedList", +"properties": { +"acceleratorTypes": { +"description": "[Output Only] A list of accelerator types contained in this scope.", +"items": { +"$ref": "AcceleratorType" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that appears when the accelerator\ntypes 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.", +"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" +}, +"AccessConfig": { +"description": "An access configuration attached to an instance's network interface.\nOnly one access config per instance is supported.", +"id": "AccessConfig", +"properties": { +"externalIpv6": { +"description": "Applies to ipv6AccessConfigs only.\nThe first IPv6 address of the external IPv6 range associated\nwith this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To\nuse a static external IP address, it must be unused and in the same region\nas the instance's zone. If not specified, Google Cloud will automatically\nassign an external IPv6 address from the instance's subnetwork.", +"type": "string" +}, +"externalIpv6PrefixLength": { +"description": "Applies to ipv6AccessConfigs only. The prefix length of the\nexternal IPv6 range.", +"format": "int32", +"type": "integer" +}, +"kind": { +"default": "compute#accessConfig", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "The name of this access configuration. In accessConfigs\n(IPv4), the default and recommended name is External NAT, but\nyou can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the\nrecommend name is External IPv6.", +"type": "string" +}, +"natIP": { +"description": "Applies to accessConfigs (IPv4) only. Anexternal IP\naddress associated with this instance. Specify an unused static\nexternal IP address available to the project or leave this field undefined\nto use an IP from a shared ephemeral IP address pool. If you specify a\nstatic external IP address, it must live in the same region as the zone of\nthe instance.", +"type": "string" +}, +"networkTier": { +"description": "This signifies the networking tier used for configuring this access\nconfiguration and can only take the following values: PREMIUM,STANDARD.\n\nIf an AccessConfig is specified without a valid external IP address, an\nephemeral IP will be created with this networkTier.\n\nIf an AccessConfig with a valid external IP address is specified, it must\nmatch that of the networkTier associated with the Address resource owning\nthat IP.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +}, +"publicPtrDomainName": { +"description": "The DNS domain name for the public PTR record.\n\nYou can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for\nfirst IP in associated external IPv6 range.", +"type": "string" +}, +"securityPolicy": { +"description": "The resource URL for the security policy associated with this access\nconfig.", +"type": "string" +}, +"setPublicPtr": { +"description": "Specifies whether a public DNS 'PTR' record should be created to map the\nexternal IP address of the instance to a DNS domain name.\n\nThis field is not used in ipv6AccessConfig. A default PTR\nrecord will be created if the VM has external IPv6 range associated.", +"type": "boolean" +}, +"type": { +"description": "The type of configuration. In accessConfigs (IPv4), the\ndefault and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.", +"enum": [ +"DIRECT_IPV6", +"ONE_TO_ONE_NAT" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"Address": { +"description": "Represents an IP Address resource.\n\nGoogle Compute Engine has two IP Address resources:\n\n* [Global (external and\ninternal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)\n* [Regional (external and\ninternal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)\n\nFor more information, see\nReserving a static external IP address.", +"id": "Address", +"properties": { +"address": { +"description": "The static IP address represented by this resource.", +"type": "string" +}, +"addressType": { +"description": "The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.", +"enum": [ +"EXTERNAL", +"INTERNAL", +"UNSPECIFIED_TYPE" +], +"enumDescriptions": [ +"A publicly visible external IP address.", +"A private network IP address, for use with an Instance or Internal Load\nBalancer forwarding rule.", +"" +], +"type": "string" +}, +"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 field 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" +}, +"ipCollection": { +"description": "Reference to the source of IP addresses.\n\nIt supports the following cases:\n \n - \n Case 1: PublicDelegatedPrefix (PDP) for BYOIP external\n addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4\n allocations. If an IPv6 PDP is used, the PDP must be in\n EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.\n - \n Case 2: Internal Range for global internal addresses.\n\n\n\nUse one of the following formats to specify the resource:\n\nFor a Public Delegated Prefix:\n \n - \n Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp\n - Partial URL:\n - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name\n - regions/region/publicDelegatedPrefixes/pdp-name\n \n\n\nFor an Internal Range:\n \n - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range\n - Partial URL:projects/project/locations/global/internalRanges/internal-range", +"type": "string" +}, +"ipVersion": { +"description": "The IP version that will be used by this address. Valid options areIPV4 or IPV6.", +"enum": [ +"IPV4", +"IPV6", +"UNSPECIFIED_VERSION" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"ipv6EndpointType": { +"description": "The endpoint type of this address, which should be VM\nor NETLB. This is used for deciding which type of endpoint\nthis address can be used after the external IPv6 address reservation.", +"enum": [ +"NETLB", +"VM" +], +"enumDescriptions": [ +"Reserved IPv6 address can be used on network load balancer.", +"Reserved IPv6 address can be used on VM." +], +"type": "string" +}, +"kind": { +"default": "compute#address", +"description": "Output only. [Output Only] Type of the resource. Always compute#address for\naddresses.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this Address, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an Address.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.addresses.insert" +] +}, +"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])?`. The first character\nmust be a lowercase letter, and all following characters (except for the\nlast character) must be a dash, lowercase letter, or digit. The last\ncharacter must be a lowercase letter or digit.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"network": { +"description": "The URL of the network in which to reserve the address. This field can\nonly be used with INTERNAL type with theVPC_PEERING purpose.", +"type": "string" +}, +"networkTier": { +"description": "This signifies the networking tier used for configuring this address and\ncan only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;\nglobal external IP addresses are always Premium Tier; regional external IP\naddresses can be either Standard or Premium Tier.\n\nIf this field is not specified, it is assumed to be PREMIUM.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +}, +"prefixLength": { +"description": "The prefix length if the resource represents an IP range.", +"format": "int32", +"type": "integer" +}, +"purpose": { +"description": "The purpose of this resource, which can be one of the following values:\n \n \n - GCE_ENDPOINT for addresses that are used by VM\n instances, alias IP ranges, load balancers, and similar resources.\n - DNS_RESOLVER for a DNS resolver address in a subnetwork\n for a Cloud DNS inbound\n forwarder IP addresses (regional internal IP address in a subnet of\n a VPC network)\n - VPC_PEERING for global internal IP addresses used for\n \n private services access allocated ranges.\n - NAT_AUTO for the regional external IP addresses used by\n Cloud NAT when allocating addresses using\n \n automatic NAT IP address allocation.\n - IPSEC_INTERCONNECT for addresses created from a private\n IP range that are reserved for a VLAN attachment in an\n *HA VPN over Cloud Interconnect* configuration. These addresses\n are regional resources.\n - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned\n to multiple internal forwarding rules.\n - `PRIVATE_SERVICE_CONNECT` for a private network address that is\n used to configure Private Service Connect. Only global internal addresses\n can use this purpose.\n - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses\n that can only be assigned to global external Passthrough Network Load\n Balancer forwarding rules, as an Availability Group 0 address.\n - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that\n can only be assigned to global external Passthrough Network Load Balancer\n forwarding rules, as an Availability Group 1 address.", +"enum": [ +"DNS_RESOLVER", +"GCE_ENDPOINT", +"IPSEC_INTERCONNECT", +"NAT_AUTO", +"PRIVATE_SERVICE_CONNECT", +"SERVERLESS", +"SHARED_LOADBALANCER_VIP", +"VPC_PEERING" +], +"enumDescriptions": [ +"DNS resolver address in the subnetwork.", +"VM internal/alias IP, Internal LB service IP, etc.", +"A regional internal IP address range reserved for the VLAN attachment\nthat is used in HA VPN over Cloud Interconnect. This regional\ninternal IP address range must not overlap with any IP address range\nof subnet/route in the VPC network and its peering networks. After the\nVLAN attachment is created with the reserved IP address range, when\ncreating a new VPN gateway, its interface IP address is allocated\nfrom the associated VLAN attachment's IP address range.", +"External IP automatically reserved for Cloud NAT.", +"A private network IP address that can be used to configure Private\nService Connect. This purpose can be specified only forGLOBAL addresses of Type INTERNAL", +"A regional internal IP address range reserved for Serverless.", +"A private network IP address that can be shared by multiple Internal\nLoad Balancer forwarding rules.", +"IP range for peer networks." +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] The URL of the region where a regional address resides.\nFor regional addresses, you must specify the region as a path parameter in\nthe HTTP request URL. *This field is not applicable to global\naddresses.*", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.\nAn address that is RESERVING is currently in the process of\nbeing reserved. A RESERVED address is currently reserved and\navailable to use. An IN_USE address is currently being used\nby another resource and is not available.", +"enum": [ +"IN_USE", +"RESERVED", +"RESERVING" +], +"enumDescriptions": [ +"Address is being used by another resource and is not available.", +"Address is reserved and available to use.", +"Address is being reserved." +], +"readOnly": true, +"type": "string" +}, +"subnetwork": { +"description": "The URL of the subnetwork in which to reserve the address. If an IP address\nis specified, it must be within the subnetwork's IP range. This field can\nonly be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.", +"type": "string" +}, +"users": { +"description": "[Output Only] The URLs of the resources that are using this address.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"AddressAggregatedList": { +"id": "AddressAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "AddressesScopedList", +"description": "[Output Only] Name of the scope containing this set of addresses." +}, +"description": "A list of AddressesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#addressAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of\naddresses.", +"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" +}, +"AddressList": { +"description": "Contains a list of addresses.", +"id": "AddressList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Address resources.", +"items": { +"$ref": "Address" +}, +"type": "array" +}, +"kind": { +"default": "compute#addressList", +"description": "Output only. [Output Only] Type of resource. Always compute#addressList for\nlists of addresses.", +"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.", +"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" +}, +"AddressesScopedList": { +"id": "AddressesScopedList", +"properties": { +"addresses": { +"description": "[Output Only] A list of addresses contained in this scope.", +"items": { +"$ref": "Address" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of addresses\nwhen 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.", +"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" +}, +"AdvancedMachineFeatures": { +"description": "Specifies options for controlling advanced machine features.\nOptions that would traditionally be configured in a BIOS belong\nhere. Features that require operating system support may have\ncorresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or\ndisabled).", +"id": "AdvancedMachineFeatures", +"properties": { +"enableNestedVirtualization": { +"description": "Whether to enable nested virtualization or not (default is false).", +"type": "boolean" +}, +"enableUefiNetworking": { +"description": "Whether to enable UEFI networking for instance creation.", +"type": "boolean" +}, +"performanceMonitoringUnit": { +"description": "Type of Performance Monitoring Unit requested on instance.", +"enum": [ +"ARCHITECTURAL", +"ENHANCED", +"PERFORMANCE_MONITORING_UNIT_UNSPECIFIED", +"STANDARD" +], +"enumDescriptions": [ +"Architecturally defined non-LLC events.", +"Most documented core/L2 and LLC events.", +"", +"Most documented core/L2 events." +], +"type": "string" +}, +"threadsPerCore": { +"description": "The number of threads per physical core. To disable simultaneous\nmultithreading (SMT) set this to 1. If unset, the maximum number\nof threads supported per core by the underlying processor is\nassumed.", +"format": "int32", +"type": "integer" +}, +"turboMode": { +"description": "Turbo frequency mode to use for the instance.\nSupported modes include:\n* ALL_CORE_MAX\n\nUsing empty string or not setting this field will use the platform-specific\ndefault turbo mode.", +"type": "string" +}, +"visibleCoreCount": { +"description": "The number of physical cores to expose to an instance. Multiply by\nthe number of threads per core to compute the total number of virtual\nCPUs to expose to the instance. If unset, the number of cores is\ninferred from the instance's nominal CPU count and the underlying\nplatform's SMT width.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"AliasIpRange": { +"description": "An alias IP range attached to an instance's network interface.", +"id": "AliasIpRange", +"properties": { +"ipCidrRange": { +"description": "The IP alias ranges to allocate for this interface. This IP CIDR range\nmust belong to the specified subnetwork and cannot contain IP addresses\nreserved by system or used by other network interfaces. This range may be\na single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).", +"type": "string" +}, +"subnetworkRangeName": { +"description": "The name of a subnetwork secondary IP range from which to allocate an IP\nalias range. If not specified, the primary range of the subnetwork is used.", +"type": "string" +} +}, +"type": "object" +}, +"AllocationAggregateReservation": { +"description": "This reservation type is specified by total resource amounts (e.g. total\ncount of CPUs) and can account for multiple instance SKUs. In other words,\none can create instances of varying shapes against this reservation.", +"id": "AllocationAggregateReservation", +"properties": { +"inUseResources": { +"description": "Output only. [Output only] List of resources currently in use.", +"items": { +"$ref": "AllocationAggregateReservationReservedResourceInfo" +}, +"readOnly": true, +"type": "array" +}, +"reservedResources": { +"description": "List of reserved resources (CPUs, memory, accelerators).", +"items": { +"$ref": "AllocationAggregateReservationReservedResourceInfo" +}, +"type": "array" +}, +"vmFamily": { +"description": "The VM family that all instances scheduled against this reservation must\nbelong to.", +"enum": [ +"VM_FAMILY_CLOUD_TPU_DEVICE_CT3", +"VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L", +"VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP", +"VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"workloadType": { +"description": "The workload type of the instances that will target this reservation.", +"enum": [ +"BATCH", +"SERVING", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Reserved resources will be optimized for BATCH workloads, such as ML\ntraining.", +"Reserved resources will be optimized for SERVING workloads, such as ML\ninference.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"AllocationAggregateReservationReservedResourceInfo": { +"id": "AllocationAggregateReservationReservedResourceInfo", +"properties": { +"accelerator": { +"$ref": "AllocationAggregateReservationReservedResourceInfoAccelerator", +"description": "Properties of accelerator resources in this reservation." +} +}, +"type": "object" +}, +"AllocationAggregateReservationReservedResourceInfoAccelerator": { +"id": "AllocationAggregateReservationReservedResourceInfoAccelerator", +"properties": { +"acceleratorCount": { +"description": "Number of accelerators of specified type.", +"format": "int32", +"type": "integer" +}, +"acceleratorType": { +"description": "Full or partial URL to accelerator type. e.g.\n\"projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l\"", +"type": "string" +} +}, +"type": "object" +}, +"AllocationReservationSharingPolicy": { +"id": "AllocationReservationSharingPolicy", +"properties": { +"serviceShareType": { +"description": "Sharing config for all Google Cloud services.", +"enum": [ +"ALLOW_ALL", +"DISALLOW_ALL", +"SERVICE_SHARE_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Allow all Google Cloud managed services to share reservations.", +"[Default] Disallow sharing with all Google Cloud services.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"AllocationResourceStatus": { +"description": "[Output Only] Contains output only fields.", +"id": "AllocationResourceStatus", +"properties": { +"healthInfo": { +"$ref": "AllocationResourceStatusHealthInfo", +"description": "[Output only] Health information for the reservation." +}, +"reservationBlockCount": { +"description": "The number of reservation blocks associated with this reservation.", +"format": "int32", +"type": "integer" +}, +"reservationMaintenance": { +"$ref": "GroupMaintenanceInfo", +"description": "Maintenance information for this reservation" +}, +"specificSkuAllocation": { +"$ref": "AllocationResourceStatusSpecificSKUAllocation", +"description": "Allocation Properties of this reservation." +} +}, +"type": "object" +}, +"AllocationResourceStatusHealthInfo": { +"description": "Health information for the reservation.", +"id": "AllocationResourceStatusHealthInfo", +"properties": { +"degradedBlockCount": { +"description": "The number of reservation blocks that are degraded.", +"format": "int32", +"type": "integer" +}, +"healthStatus": { +"description": "The health status of the reservation.", +"enum": [ +"DEGRADED", +"HEALTHY", +"HEALTH_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The reservation is degraded.", +"The reservation is healthy.", +"The health status of the reservation is unspecified." +], +"type": "string" +}, +"healthyBlockCount": { +"description": "The number of reservation blocks that are healthy.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"AllocationResourceStatusSpecificSKUAllocation": { +"description": "Contains Properties set for the reservation.", +"id": "AllocationResourceStatusSpecificSKUAllocation", +"properties": { +"sourceInstanceTemplateId": { +"description": "ID of the instance template used to populate reservation properties.", +"type": "string" +}, +"utilizations": { +"additionalProperties": { +"format": "int64", +"type": "string" +}, +"description": "Per service utilization breakdown. The Key is the Google Cloud managed\nservice name.", +"type": "object" +} +}, +"type": "object" +}, +"AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk": { +"id": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", +"properties": { +"diskSizeGb": { +"description": "Specifies the size of the disk in base-2 GB.", +"format": "int64", +"type": "string" +}, +"interface": { +"description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME. The default isSCSI.\nFor performance characteristics of SCSI over NVMe, seeLocal SSD performance.", +"enum": [ +"NVME", +"SCSI" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"AllocationSpecificSKUAllocationReservedInstanceProperties": { +"description": "Properties of the SKU instances being reserved.\nNext ID: 10", +"id": "AllocationSpecificSKUAllocationReservedInstanceProperties", +"properties": { +"guestAccelerators": { +"description": "Specifies accelerator type and count.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"localSsds": { +"description": "Specifies amount of local ssd to reserve with each instance. The type\nof disk is local-ssd.", +"items": { +"$ref": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk" +}, +"type": "array" +}, +"locationHint": { +"description": "An opaque location hint used to place the allocation close to other\nresources.\nThis field is for use by internal tools that use the public API.", +"type": "string" +}, +"machineType": { +"description": "Specifies type of machine (name only) which has fixed number of vCPUs\nand fixed amount of memory. This also includes specifying custom\nmachine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.", +"type": "string" +}, +"minCpuPlatform": { +"description": "Minimum cpu platform the reservation.", +"type": "string" +} +}, +"type": "object" +}, +"AllocationSpecificSKUReservation": { +"description": "This reservation type allows to pre allocate specific instance\n configuration.", +"id": "AllocationSpecificSKUReservation", +"properties": { +"assuredCount": { +"description": "Output only. [Output Only] Indicates how many instances are actually usable currently.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"count": { +"description": "Specifies the number of resources that are allocated.", +"format": "int64", +"type": "string" +}, +"inUseCount": { +"description": "Output only. [Output Only] Indicates how many instances are in use.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"instanceProperties": { +"$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties", +"description": "The instance properties for the reservation." +}, +"sourceInstanceTemplate": { +"description": "Specifies the instance template to create the reservation. If you use\nthis field, you must exclude the instanceProperties field.\n\nThis field is optional, and it can be a full or partial URL. For example,\nthe following are all valid URLs to an instance template: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate", +"type": "string" +} +}, +"type": "object" +}, +"AttachedDisk": { +"description": "An instance-attached disk resource.", +"id": "AttachedDisk", +"properties": { +"architecture": { +"description": "Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64\nor X86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"readOnly": true, +"type": "string" +}, +"autoDelete": { +"description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (but not when the disk is detached from the instance).", +"type": "boolean" +}, +"boot": { +"description": "Indicates that this is a boot disk. The virtual machine will use the first\npartition of the disk for its root filesystem.", +"type": "boolean" +}, +"deviceName": { +"description": "Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system\nrunning within the instance. This name can be used to reference the device\nfor mounting, resizing, and so on, from within the instance.\n\nIf not specified, the server chooses a default device name to apply to this\ndisk, in the form persistent-disk-x, where x is a number\nassigned by Google Compute Engine. This field is only applicable for\npersistent disks.", +"type": "string" +}, +"diskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Encrypts or decrypts a disk using acustomer-supplied\nencryption key.\n\nIf you are creating a new disk, this field encrypts the new disk using\nan encryption key that you provide. If you are attaching an existing\ndisk that is already encrypted, this field decrypts the disk using\nthe customer-supplied encryption key.\n\nIf you encrypt a disk using a customer-supplied key, you must provide the\nsame key again when you attempt to use this resource at a later time. For\nexample, you must provide the key when you create a snapshot or an image\nfrom the disk or when you attach the disk to a virtual machine instance.\n\nIf you do not provide an encryption key, then the disk will be encrypted\nusing an automatically generated key and you do not need to provide a key\nto use the disk later.\n\nNote:\n\nInstance templates do not storecustomer-supplied\nencryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.\n\nYou cannot create VMs that have disks with customer-supplied keys using\nthe bulk\ninsert method." +}, +"diskSizeGb": { +"description": "The size of the disk in GB.", +"format": "int64", +"type": "string" +}, +"forceAttach": { +"description": "[Input Only] Whether to force attach the regional disk even if it's\ncurrently attached to another instance. If you try to force attach a zonal\ndisk to an instance, you will receive an error.", +"type": "boolean" +}, +"guestOsFeatures": { +"description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", +"items": { +"$ref": "GuestOsFeature" +}, +"type": "array" +}, +"index": { +"description": "Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the\nboot disk. If you have many disks attached to an instance, each\ndisk would have a unique index number.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"initializeParams": { +"$ref": "AttachedDiskInitializeParams", +"description": "[Input Only] Specifies the parameters for a new disk that will be created\nalongside the new instance. Use initialization parameters to create boot\ndisks or local SSDs attached to the new instance.\n\nThis property is mutually exclusive with the source property;\nyou can only define one or the other, but not both." +}, +"interface": { +"description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME. For most machine types, the\ndefault is SCSI. Local SSDs can use either NVME or SCSI.\nIn certain configurations, persistent disks can use NVMe. For more\ninformation, seeAbout\npersistent disks.", +"enum": [ +"NVME", +"SCSI" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"kind": { +"default": "compute#attachedDisk", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.", +"readOnly": true, +"type": "string" +}, +"licenses": { +"description": "Output only. [Output Only] Any valid publicly visible licenses.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"mode": { +"description": "The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk\nin READ_WRITE mode.", +"enum": [ +"READ_ONLY", +"READ_WRITE" +], +"enumDescriptions": [ +"Attaches this disk in read-only mode. Multiple virtual machines can use\na disk in read-only mode at a time.", +"*[Default]* Attaches this disk in read-write mode. Only one\nvirtual machine at a time can be attached to a disk in read-write mode." +], +"type": "string" +}, +"savedState": { +"description": "Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this\nfield is set to PRESERVED if the LocalSSD data has been saved\nto a persistent location by customer request. (see the\ndiscard_local_ssd option on Stop/Suspend).\nRead-only in the api.", +"enum": [ +"DISK_SAVED_STATE_UNSPECIFIED", +"PRESERVED" +], +"enumDescriptions": [ +"*[Default]* Disk state has not been preserved.", +"Disk state has been preserved." +], +"readOnly": true, +"type": "string" +}, +"shieldedInstanceInitialState": { +"$ref": "InitialStateConfig", +"description": "Output only. [Output Only] shielded vm initial state stored on disk", +"readOnly": true +}, +"source": { +"description": "Specifies a valid partial or full URL to an existing Persistent Disk\nresource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source\nis required.\n\nIf desired, you can also attach existing non-root persistent disks using\nthis property. This field is only applicable for persistent disks.\n\nNote that for InstanceTemplate, specify the disk name for zonal disk,\nand the URL for regional disk.", +"type": "string" +}, +"type": { +"description": "Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.", +"enum": [ +"PERSISTENT", +"SCRATCH" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"AttachedDiskInitializeParams": { +"description": "[Input Only] Specifies the parameters for a new disk that will be created\nalongside the new instance. Use initialization parameters to create boot\ndisks or local SSDs attached to the new instance.\n\nThis field is persisted and returned for instanceTemplate and not returned\nin the context of instance.\n\nThis property is mutually exclusive with the source property;\nyou can only define one or the other, but not both.", +"id": "AttachedDiskInitializeParams", +"properties": { +"architecture": { +"description": "The architecture of the attached disk. Valid values are\narm64 or x86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"type": "string" +}, +"description": { +"description": "An optional description. Provide this property when creating the disk.", +"type": "string" +}, +"diskName": { +"description": "Specifies the disk name. If not specified, the default is to use the name\nof the instance. If a disk with the same name already exists in the given\nregion, the existing disk is attached to the new instance and the\nnew disk is not created.", +"type": "string" +}, +"diskSizeGb": { +"description": "Specifies the size of the disk in base-2 GB. The size must be at least\n10 GB. If you specify a sourceImage, which is required for\nboot disks, the default size is the size of the sourceImage.\nIf you do not specify a sourceImage, the default disk size\nis 500 GB.", +"format": "int64", +"type": "string" +}, +"diskType": { +"description": "Specifies the disk type used for the boot disk or an additional data\ndisk. For valid disk type values, see \nSupported types for Hyperdisk volumes and\nPersistent Disk type variables.\n\nWhen creating a single instance, you must provide either the full or\npartial URL of the disk type. For example, the following values are\nvalid: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType\n - projects/project/zones/zone/diskTypes/diskType\n - zones/zone/diskTypes/diskType\n\n\n\nWhen creating an instance template, instance flexibility policy, or when\ncreating or updating an all-instances configuration, you specify the\ndisk type without a URL, for example, hyperdisk-balanced.\n\nIf you omit this field for a disk, the default disk type depends on\nthe instance's machine series, as follows.\n \n \n - For first- and second-generation machine series like N1, N2, T2, and\n M1, the\n default disk type is Standard Persistent Disk\n (pd-standard).\n - For C3, C3D, and M3 the default is Balanced Persistent Disk\n (pd-balanced). \n - For other third-generation machine\n series like A3, H3, Z3, all\n fourth-generation types like C4, N4, M4, and newer machine series,\n the default is Hyperdisk Balanced\n (hyperdisk-balanced).\n\n\n\nThe disk type you specify must be compatible with the instance's machine\nseries. For a list of machine series that support Persistent Disk, see Machine\nseries support for Persistent Disk.\n\nFor a list of machine series that support Hyperdisk, seeMachine\nseries support for Hyperdisk.", +"type": "string" +}, +"enableConfidentialCompute": { +"description": "Whether this disk is using confidential compute mode.", +"type": "boolean" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for\npersistent disks.", +"type": "object" +}, +"licenses": { +"description": "A list of publicly visible licenses. Reserved for Google's use.", +"items": { +"type": "string" +}, +"type": "array" +}, +"onUpdateAction": { +"description": "Specifies which action to take on instance update with this disk. Default\nis to use the existing disk.", +"enum": [ +"RECREATE_DISK", +"RECREATE_DISK_IF_SOURCE_CHANGED", +"USE_EXISTING_DISK" +], +"enumDescriptions": [ +"Always recreate the disk.", +"Recreate the disk if source (image, snapshot) of this disk is different\nfrom source of existing disk.", +"Use the existing disk, this is the default behaviour." +], +"type": "string" +}, +"provisionedIops": { +"description": "Indicates how many IOPS to provision for the disk. This sets the number\nof I/O operations per second that the disk can handle. Values must be\nbetween 10,000 and 120,000. For more details, see theExtreme persistent\ndisk documentation.", +"format": "int64", +"type": "string" +}, +"provisionedThroughput": { +"description": "Indicates how much throughput to provision for the disk. This sets the\nnumber of throughput mb per second that the disk can handle. Values must\ngreater than or equal to 1.", +"format": "int64", +"type": "string" +}, +"replicaZones": { +"description": "Required for each regional disk associated with the instance. Specify\nthe URLs of the zones where the disk should be replicated to.\nYou must provide exactly two replica zones, and one zone must be the same\nas the instance zone.", +"items": { +"type": "string" +}, +"type": "array" +}, +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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 & PATCH) when\nempty.", +"type": "object" +}, +"resourcePolicies": { +"description": "Resource policies applied to this disk for automatic snapshot creations.\nSpecified using the full or partial URL. For instance template, specify\nonly the resource policy name.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceImage": { +"description": "The source image to create this disk. When creating a new instance boot\ndisk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source\nis required.\n\nTo create a disk with one of the public operating system\nimages, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:\n\nprojects/debian-cloud/global/images/family/debian-9\n\n\nAlternatively, use a specific version of a public operating system image:\n\nprojects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD\n\n\nTo create a disk with a custom image that you created, specify the\nimage name in the following format:\n\nglobal/images/my-custom-image\n\n\nYou can also specify a custom image by its image family, which returns\nthe latest version of the image in that family. Replace the image name\nwith family/family-name:\n\nglobal/images/family/my-image-family\n\n\nIf the source image is deleted later, this field will not be set.", +"type": "string" +}, +"sourceImageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source image. Required if the source image is\nprotected by a customer-supplied encryption key.\n\nInstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied\nencryption keys, so you cannot create disks for instances in a managed instance group if the\nsource images are encrypted with your own keys." +}, +"sourceSnapshot": { +"description": "The source snapshot to create this disk. When creating a new instance\nboot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source\nis required.\n\nTo create a disk with a snapshot that you created, specify the\nsnapshot name in the following format:\n\nglobal/snapshots/my-backup\n\n\nIf the source snapshot is deleted later, this field will not be set.\n\nNote: You cannot create VMs in bulk using a snapshot as the source. Use\nan image instead when you create VMs using\nthe bulk\ninsert method.", +"type": "string" +}, +"sourceSnapshotEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source snapshot." +}, +"storagePool": { +"description": "The storage pool in which the new disk is created. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool\n - projects/project/zones/zone/storagePools/storagePool \n - zones/zone/storagePools/storagePool", +"type": "string" +} +}, +"type": "object" +}, +"AuditConfig": { +"description": "Specifies the audit configuration for a service.\nThe configuration determines which permission types are logged, and what\nidentities, if any, are exempted from logging.\nAn AuditConfig must have one or more AuditLogConfigs.\n\nIf there are AuditConfigs for both `allServices` and a specific service,\nthe union of the two AuditConfigs is used for that service: the log_types\nspecified in each AuditConfig are enabled, and the exempted_members in each\nAuditLogConfig are exempted.\n\nExample Policy with multiple AuditConfigs:\n\n {\n \"audit_configs\": [\n {\n \"service\": \"allServices\",\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:jose@example.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\"\n },\n {\n \"log_type\": \"ADMIN_READ\"\n }\n ]\n },\n {\n \"service\": \"sampleservice.googleapis.com\",\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\"\n },\n {\n \"log_type\": \"DATA_WRITE\",\n \"exempted_members\": [\n \"user:aliya@example.com\"\n ]\n }\n ]\n }\n ]\n }\n\nFor sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ\nlogging. It also exempts `jose@example.com` from DATA_READ logging, and\n`aliya@example.com` from DATA_WRITE logging.", +"id": "AuditConfig", +"properties": { +"auditLogConfigs": { +"description": "The configuration for logging of each type of permission.", +"items": { +"$ref": "AuditLogConfig" +}, +"type": "array" +}, +"service": { +"description": "Specifies a service that will be enabled for audit logging.\nFor example, `storage.googleapis.com`, `cloudsql.googleapis.com`.\n`allServices` is a special value that covers all services.", +"type": "string" +} +}, +"type": "object" +}, +"AuditLogConfig": { +"description": "Provides the configuration for logging a type of permissions.\nExample:\n\n {\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:jose@example.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\"\n }\n ]\n }\n\nThis enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting\njose@example.com from DATA_READ logging.", +"id": "AuditLogConfig", +"properties": { +"exemptedMembers": { +"description": "Specifies the identities that do not cause logging for this type of\npermission.\nFollows the same format of Binding.members.", +"items": { +"type": "string" +}, +"type": "array" +}, +"logType": { +"description": "The log type that this config enables.", +"enum": [ +"ADMIN_READ", +"DATA_READ", +"DATA_WRITE", +"LOG_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Admin reads. Example: CloudIAM getIamPolicy", +"Data reads. Example: CloudSQL Users list", +"Data writes. Example: CloudSQL Users create", +"Default case. Should never be this." +], +"type": "string" +} +}, +"type": "object" +}, +"Autoscaler": { +"description": "Represents an Autoscaler resource.\n\nGoogle Compute Engine has two Autoscaler resources:\n\n* [Zonal](/compute/docs/reference/rest/v1/autoscalers)\n* [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)\n\nUse autoscalers to automatically add or delete instances from a\nmanaged instance group according to your defined autoscaling policy.\nFor more information, read Autoscaling Groups of Instances.\n\nFor zonal managed instance groups resource, use the autoscaler\nresource.\n\nFor regional managed instance groups, use theregionAutoscalers resource.", +"id": "Autoscaler", +"properties": { +"autoscalingPolicy": { +"$ref": "AutoscalingPolicy", +"description": "The configuration parameters for the autoscaling algorithm. You can define\none or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.\n\nIf none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%." +}, +"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" +}, +"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#autoscaler", +"description": "Output only. [Output Only] Type of the resource. Always compute#autoscaler\nfor autoscalers.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.autoscalers.insert" +] +}, +"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" +}, +"recommendedSize": { +"description": "Output only. [Output Only] Target recommended MIG size (number of instances) computed by\nautoscaler. Autoscaler calculates the recommended MIG size even when the\nautoscaling policy mode is different from ON. This field is empty when\nautoscaler is not connected to an existing managed instance group or\nautoscaler did not generate its prediction.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"region": { +"description": "Output only. [Output Only] URL of theregion\nwhere the instance group resides (for autoscalers living in regional\nscope).", +"readOnly": true, +"type": "string" +}, +"scalingScheduleStatus": { +"additionalProperties": { +"$ref": "ScalingScheduleStatus" +}, +"description": "Output only. [Output Only] Status information of existing scaling schedules.", +"readOnly": true, +"type": "object" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"status": { +"description": "[Output Only] The status of the autoscaler configuration. Current set of\npossible values:\n \n - PENDING:\n Autoscaler backend hasn't read new/updated configuration.\n - DELETING:\n Configuration is being deleted.\n - ACTIVE:\n Configuration is acknowledged to be effective. Some warnings might\n be present in the statusDetails field.\n - ERROR:\n Configuration has errors. Actionable for users. Details are present in\n the statusDetails field.\n\n\nNew values might be added in the future.", +"enum": [ +"ACTIVE", +"DELETING", +"ERROR", +"PENDING" +], +"enumDescriptions": [ +"Configuration is acknowledged to be effective", +"Configuration is being deleted", +"Configuration has errors. Actionable for users.", +"Autoscaler backend hasn't read new/updated configuration" +], +"type": "string" +}, +"statusDetails": { +"description": "[Output Only] Human-readable details about the current state of the\nautoscaler. Read the documentation forCommonly\nreturned status messages for examples of status messages you might\nencounter.", +"items": { +"$ref": "AutoscalerStatusDetails" +}, +"type": "array" +}, +"target": { +"description": "URL of the managed instance group that this autoscaler will scale. This\nfield is required when creating an autoscaler.", +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] URL of thezone\nwhere the instance group resides (for autoscalers living in zonal scope).", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"AutoscalerAggregatedList": { +"id": "AutoscalerAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "AutoscalersScopedList", +"description": "[Output Only] Name of the scope containing this set of autoscalers." +}, +"description": "A list of AutoscalersScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#autoscalerAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of\nautoscalers.", +"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" +}, +"AutoscalerList": { +"description": "Contains a list of Autoscaler resources.", +"id": "AutoscalerList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Autoscaler resources.", +"items": { +"$ref": "Autoscaler" +}, +"type": "array" +}, +"kind": { +"default": "compute#autoscalerList", +"description": "Output only. [Output Only] Type of resource. Always compute#autoscalerList\nfor lists of autoscalers.", +"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.", +"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" +}, +"AutoscalerStatusDetails": { +"id": "AutoscalerStatusDetails", +"properties": { +"message": { +"description": "The status message.", +"type": "string" +}, +"type": { +"description": "The type of error, warning, or notice returned. Current set of possible\nvalues:\n \n - ALL_INSTANCES_UNHEALTHY (WARNING):\n All instances in the instance group are unhealthy (not in RUNNING\n state).\n - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):\n There is no backend service attached to the instance group.\n - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):\n Autoscaler recommends a size greater than maxNumReplicas.\n - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):\n The custom metric samples are not exported often enough to be\n a credible base for autoscaling.\n - CUSTOM_METRIC_INVALID (ERROR):\n The custom metric that was specified does not exist or does not have\n the necessary labels.\n - MIN_EQUALS_MAX (WARNING):\n The minNumReplicas is equal to maxNumReplicas. This means the\n autoscaler cannot add or remove instances from the instance group.\n - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):\n The autoscaler did not receive any data from the custom metric\n configured for autoscaling.\n - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):\n The autoscaler is configured to scale based on a load balancing signal\n but the instance group has not received any requests from the load\n balancer.\n - MODE_OFF (WARNING):\n Autoscaling is turned off. The number of instances in the group won't\n change automatically. The autoscaling configuration is preserved.\n - MODE_ONLY_UP (WARNING):\n Autoscaling is in the \"Autoscale only out\" mode. The autoscaler can add\n instances but not remove any.\n - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):\n The instance group cannot be autoscaled because it has more than one\n backend service attached to it.\n - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):\n There is insufficient quota for the necessary resources, such as CPU or\n number of instances.\n - REGION_RESOURCE_STOCKOUT (ERROR):\n Shown only for regional autoscalers: there is a resource stockout in\n the chosen region.\n - SCALING_TARGET_DOES_NOT_EXIST (ERROR):\n The target to be scaled does not exist.\n - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION\n (ERROR): Autoscaling does not work with an HTTP/S load balancer that\n has been configured for maxRate.\n - ZONE_RESOURCE_STOCKOUT (ERROR):\n For zonal autoscalers: there is a resource stockout in the chosen zone.\n For regional autoscalers: in at least one of the zones you're using\n there is a resource stockout.\n\n\nNew values might be added in the future. Some of the values might not be\navailable in all API versions.", +"enum": [ +"ALL_INSTANCES_UNHEALTHY", +"BACKEND_SERVICE_DOES_NOT_EXIST", +"CAPPED_AT_MAX_NUM_REPLICAS", +"CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE", +"CUSTOM_METRIC_INVALID", +"MIN_EQUALS_MAX", +"MISSING_CUSTOM_METRIC_DATA_POINTS", +"MISSING_LOAD_BALANCING_DATA_POINTS", +"MODE_OFF", +"MODE_ONLY_SCALE_OUT", +"MODE_ONLY_UP", +"MORE_THAN_ONE_BACKEND_SERVICE", +"NOT_ENOUGH_QUOTA_AVAILABLE", +"REGION_RESOURCE_STOCKOUT", +"SCALING_TARGET_DOES_NOT_EXIST", +"SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX", +"SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN", +"UNKNOWN", +"UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION", +"ZONE_RESOURCE_STOCKOUT" +], +"enumDescriptions": [ +"All instances in the instance group are unhealthy (not in RUNNING state).", +"There is no backend service attached to the instance group.", +"Autoscaler recommends a size greater than maxNumReplicas.", +"The custom metric samples are not exported often enough to be a credible\nbase for autoscaling.", +"The custom metric that was specified does not exist or does not have the\nnecessary labels.", +"The minNumReplicas is equal to maxNumReplicas. This means the autoscaler\ncannot add or remove instances from the instance group.", +"The autoscaler did not receive any data from the custom metric configured\nfor autoscaling.", +"The autoscaler is configured to scale based on a load balancing signal\nbut the instance group has not received any requests from the load\nbalancer.", +"Autoscaling is turned off. The number of instances in the group won't\nchange automatically. The autoscaling configuration is preserved.", +"Autoscaling is in the \"Autoscale only scale out\" mode.\nInstances in the group will be only added.", +"Autoscaling is in the \"Autoscale only out\" mode. Instances in the group\nwill be only added.", +"The instance group cannot be autoscaled because it has more than one\nbackend service attached to it.", +"There is insufficient quota for the necessary resources, such as CPU or\nnumber of instances.", +"Showed only for regional autoscalers: there is a resource stockout in\nthe chosen region.", +"The target to be scaled does not exist.", +"For some scaling schedules minRequiredReplicas is greater than\nmaxNumReplicas. Autoscaler always recommends at most maxNumReplicas\ninstances.", +"For some scaling schedules minRequiredReplicas is less than\nminNumReplicas. Autoscaler always recommends at least minNumReplicas\ninstances.", +"", +"Autoscaling does not work with an HTTP/S load balancer that has been\nconfigured for maxRate.", +"For zonal autoscalers: there is a resource stockout in the chosen zone.\nFor regional autoscalers: in at least one of the zones you're using there\nis a resource stockout." +], +"type": "string" +} +}, +"type": "object" +}, +"AutoscalersScopedList": { +"id": "AutoscalersScopedList", +"properties": { +"autoscalers": { +"description": "[Output Only] A list of autoscalers contained in this scope.", +"items": { +"$ref": "Autoscaler" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of autoscalers\nwhen 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.", +"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" +}, +"AutoscalingPolicy": { +"description": "Cloud Autoscaler policy.", +"id": "AutoscalingPolicy", +"properties": { +"coolDownPeriodSec": { +"description": "The number of seconds that your application takes to initialize on a VM\ninstance. This is referred to as the\n[initialization period](/compute/docs/autoscaler#cool_down_period).\nSpecifying an accurate initialization period improves\nautoscaler decisions. For example, when scaling out, the autoscaler ignores\ndata from VMs that are still initializing because those VMs might not yet\nrepresent normal usage of your application. The default initialization\nperiod is 60 seconds.\n\nInitialization periods might vary because of numerous\nfactors. We recommend that you test how long your application takes to\ninitialize. To do this, create a VM and time your application's startup\nprocess.", +"format": "int32", +"type": "integer" +}, +"cpuUtilization": { +"$ref": "AutoscalingPolicyCpuUtilization", +"description": "Defines the CPU utilization policy that allows the autoscaler to scale\nbased on the average CPU utilization of a managed instance group." +}, +"customMetricUtilizations": { +"description": "Configuration parameters of autoscaling based on a custom metric.", +"items": { +"$ref": "AutoscalingPolicyCustomMetricUtilization" +}, +"type": "array" +}, +"loadBalancingUtilization": { +"$ref": "AutoscalingPolicyLoadBalancingUtilization", +"description": "Configuration parameters of autoscaling based on load balancer." +}, +"maxNumReplicas": { +"description": "The maximum number of instances that the autoscaler can scale out to. This\nis required when creating or updating an autoscaler. The maximum number\nof replicas must not be lower than minimal number of replicas.", +"format": "int32", +"type": "integer" +}, +"minNumReplicas": { +"description": "The minimum number of replicas that the autoscaler can scale in to.\nThis cannot be less than 0. If not provided, autoscaler chooses a\ndefault value depending on maximum number of instances allowed.", +"format": "int32", +"type": "integer" +}, +"mode": { +"description": "Defines the operating mode for this policy.\nThe following modes are available:\n \n - OFF: Disables the autoscaler but maintains its\n configuration.\n - ONLY_SCALE_OUT: Restricts the autoscaler to add\n VM instances only.\n - ON: Enables all autoscaler activities according to its\n policy.\n\n\nFor more information, see \n\"Turning off or restricting an autoscaler\"", +"enum": [ +"OFF", +"ON", +"ONLY_SCALE_OUT", +"ONLY_UP" +], +"enumDescriptions": [ +"Do not automatically scale the MIG in or out.\nThe recommended_size field contains the size of MIG that would be set if\nthe actuation mode was enabled.", +"Automatically scale the MIG in and out according to the policy.", +"Automatically create VMs according to the policy, but do not scale\nthe MIG in.", +"Automatically create VMs according to the policy, but do not scale\nthe MIG in.\nIt's recommended to use ONLY_SCALE_OUT instead of ONLY_UP." +], +"type": "string" +}, +"scaleInControl": { +"$ref": "AutoscalingPolicyScaleInControl" +}, +"scalingSchedules": { +"additionalProperties": { +"$ref": "AutoscalingPolicyScalingSchedule" +}, +"description": "Scaling schedules defined for an autoscaler. Multiple schedules\ncan be set on an autoscaler, and they can overlap. During overlapping\nperiods the greatest min_required_replicas of all scaling schedules is\napplied. Up to 128 scaling schedules are allowed.", +"type": "object" +}, +"stabilizationPeriodSec": { +"description": "The number of seconds that autoscaler waits for load stabilization before\nmaking scale-in decisions. This is referred to as the\n[stabilization period](/compute/docs/autoscaler#stabilization_period).\nThis might appear as a delay in scaling in but it is an important mechanism\nfor your application to not have fluctuating size due to short term load\nfluctuations.\n\nThe default stabilization period is 600 seconds.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"AutoscalingPolicyCpuUtilization": { +"description": "CPU utilization policy.", +"id": "AutoscalingPolicyCpuUtilization", +"properties": { +"predictiveMethod": { +"description": "Indicates whether predictive autoscaling based on CPU metric is enabled.\nValid values are:\n\n* NONE (default). No predictive method is used. The autoscaler scales the\ngroup to meet current demand based on real-time metrics.\n* OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by\nmonitoring daily and weekly load patterns and scaling out ahead of\nanticipated demand.", +"enum": [ +"NONE", +"OPTIMIZE_AVAILABILITY" +], +"enumDescriptions": [ +"No predictive method is used. The autoscaler scales the group to meet\ncurrent demand based on real-time metrics", +"Predictive autoscaling improves availability by monitoring daily and\nweekly load patterns and scaling out ahead of anticipated demand." +], +"type": "string" +}, +"utilizationTarget": { +"description": "The target CPU utilization that the autoscaler maintains. Must be\na float value in the range (0, 1]. If not specified, the default is0.6.\n\nIf the CPU level is below the target utilization, the autoscaler scales\nin the number of instances until it reaches the minimum number of\ninstances you specified or until the average CPU of your instances\nreaches the target utilization.\n\nIf the average CPU is above the target utilization, the autoscaler\nscales out until it reaches the maximum number of instances you\nspecified or until the average utilization reaches the target\nutilization.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"AutoscalingPolicyCustomMetricUtilization": { +"description": "Custom utilization metric policy.", +"id": "AutoscalingPolicyCustomMetricUtilization", +"properties": { +"filter": { +"description": "A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is\nused to select a specific TimeSeries for the purpose of autoscaling and\nto determine whether the metric is exporting per-instance or\nper-group data.\n\nFor the filter to be valid for autoscaling purposes, the following rules\napply:\n \n \n - You can only use the AND operator for joining\n selectors.\n - You can only use direct equality comparison operator\n (=) without any functions for each selector.\n - You can specify the metric in both the filter string and in the\n metric field. However, if specified in both places, the metric must\n be identical.\n - The monitored resource type\n determines what kind of values are expected for the metric. If it is\n a gce_instance, the autoscaler expects the metric to\n include a separate TimeSeries for each instance in a group. In such a\n case, you cannot filter on resource labels.\n \n \n If the resource type is any other value, the autoscaler expects\n this metric to contain values that apply to the entire autoscaled\n instance group and resource label filtering can be performed to\n point autoscaler at the correct TimeSeries to scale upon. This is\n called a *per-group metric* for the purpose of autoscaling.\n \n If not specified, the type defaults to\n gce_instance.\n\n\n\nTry to provide a filter that is selective enough to pick just one\nTimeSeries for the autoscaled group or for each of the instances (if you\nare using gce_instance resource type). If multiple\nTimeSeries are returned upon the query execution, the autoscaler will sum\ntheir respective values to obtain its scaling value.", +"type": "string" +}, +"metric": { +"description": "The identifier (type) of the Stackdriver Monitoring metric. The metric\ncannot have negative values.\n\nThe metric must have a value type of INT64 orDOUBLE.", +"type": "string" +}, +"singleInstanceAssignment": { +"description": "If scaling is based on a per-group metric value that represents the\ntotal amount of work to be done or resource usage, set this value to an\namount assigned for a single instance of the scaled group. Autoscaler\nkeeps the number of instances proportional to the value of this\nmetric. The metric itself does not change value due to group\nresizing.\n\nA good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages\nor a custom metric exporting the total number of requests coming to\nyour instances.\n\nA bad example would be a metric exporting an average or median latency,\nsince this value can't include a chunk assignable to a single instance,\nit could be better used with utilization_target instead.", +"format": "double", +"type": "number" +}, +"utilizationTarget": { +"description": "The target value of the metric that autoscaler maintains. This\nmust be a positive value. A utilization metric scales number of\nvirtual machines handling requests to increase or decrease\nproportionally to the metric.\n\nFor example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.\nThe autoscaler works to keep this value constant for each of the\ninstances.", +"format": "double", +"type": "number" +}, +"utilizationTargetType": { +"description": "Defines how target utilization value is expressed for a Stackdriver\nMonitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.", +"enum": [ +"DELTA_PER_MINUTE", +"DELTA_PER_SECOND", +"GAUGE" +], +"enumDescriptions": [ +"Sets the utilization target value for a cumulative or delta metric,\nexpressed as the rate of growth per minute.", +"Sets the utilization target value for a cumulative or delta metric,\nexpressed as the rate of growth per second.", +"Sets the utilization target value for a gauge metric. The autoscaler\nwill collect the average utilization of the virtual machines from the\nlast couple of minutes, and compare the value to the utilization\ntarget value to perform autoscaling." +], +"type": "string" +} +}, +"type": "object" +}, +"AutoscalingPolicyLoadBalancingUtilization": { +"description": "Configuration parameters of autoscaling based on load balancing.", +"id": "AutoscalingPolicyLoadBalancingUtilization", +"properties": { +"utilizationTarget": { +"description": "Fraction of backend capacity utilization (set in HTTP(S) load balancing\nconfiguration) that the autoscaler maintains. Must be a positive float\nvalue. If not defined, the default is 0.8.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"AutoscalingPolicyScaleInControl": { +"description": "Configuration that allows for slower scale in so that even if Autoscaler\nrecommends an abrupt scale in of a MIG, it will be throttled as specified\nby the parameters below.", +"id": "AutoscalingPolicyScaleInControl", +"properties": { +"maxScaledInReplicas": { +"$ref": "FixedOrPercent", +"description": "Maximum allowed number (or %) of VMs that can be deducted from the peak\nrecommendation during the window autoscaler looks at when computing\nrecommendations. Possibly all these VMs can be deleted at once so user\nservice needs to be prepared to lose that many VMs in one step." +}, +"timeWindowSec": { +"description": "How far back autoscaling looks when computing recommendations to\ninclude directives regarding slower scale in, as described above.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"AutoscalingPolicyScalingSchedule": { +"description": "Scaling based on user-defined schedule. The message describes a single\nscaling schedule. A scaling schedule changes the minimum number of VM\ninstances an autoscaler can recommend, which can trigger scaling out.", +"id": "AutoscalingPolicyScalingSchedule", +"properties": { +"description": { +"description": "A description of a scaling schedule.", +"type": "string" +}, +"disabled": { +"description": "A boolean value that specifies whether a scaling schedule can influence\nautoscaler recommendations. If set to true, then a scaling schedule has\nno effect. This field is optional, and its value is false by default.", +"type": "boolean" +}, +"durationSec": { +"description": "The duration of time intervals, in seconds, for which this\nscaling schedule is to run. The minimum allowed value is 300.\nThis field is required.", +"format": "int32", +"type": "integer" +}, +"minRequiredReplicas": { +"description": "The minimum number of VM instances that the autoscaler will\nrecommend in time intervals starting according to schedule. This field is\nrequired.", +"format": "int32", +"type": "integer" +}, +"schedule": { +"description": "The start timestamps of time intervals when this scaling\nschedule is to provide a scaling signal. This field uses the extended\ncron format (with an optional year field). The expression can describe a\nsingle timestamp if the optional year is set, in which case the scaling\nschedule runs once. The schedule is interpreted with respect to\ntime_zone. This field is required. Note: These timestamps only describe\nwhen autoscaler starts providing the scaling signal. The VMs\nneed additional time to become serving.", +"type": "string" +}, +"timeZone": { +"description": "The time zone to use when interpreting the schedule.\nThe value of this field must be a time zone name from the tz database:\nhttps://en.wikipedia.org/wiki/Tz_database. This field is assigned a\ndefault value of \"UTC\" if left empty.", +"type": "string" +} +}, +"type": "object" +}, +"Backend": { +"description": "Message containing information of one individual backend.", +"id": "Backend", +"properties": { +"balancingMode": { +"description": "Specifies how to determine whether the backend of a load balancer can\nhandle additional traffic or is fully loaded. For usage guidelines, see\nConnection balancing mode.\n\nBackends must use compatible balancing modes. Backends of a backend\nservice may use different balancing modes. For more information, see \nSupported balancing modes and target capacity settings and\nRestrictions and guidance for instance groups.\n\nNote: Currently, if you use the API to configure incompatible balancing\nmodes, the configuration might be accepted even though it has no impact\nand is ignored. Specifically, Backend.maxUtilization is ignored when\nBackend.balancingMode is RATE. In the future, this incompatible combination\nwill be rejected.", +"enum": [ +"CONNECTION", +"CUSTOM_METRICS", +"IN_FLIGHT", +"RATE", +"UTILIZATION" +], +"enumDescriptions": [ +"Balance based on the number of simultaneous connections.", +"Based on custom defined and reported metrics.", +"Balance based on the number of in-flight requests.", +"Balance based on requests per second (RPS).", +"Balance based on the backend utilization." +], +"type": "string" +}, +"capacityScaler": { +"description": "A multiplier applied to the backend's target capacity of its balancing\nmode.\nThe default value is 1, which means the group serves up to\n100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is\ncompletely drained, offering 0% of its available capacity. The valid ranges\nare 0.0 and [0.1,1.0].\nYou cannot configure a setting larger than 0 and smaller than0.1.\nYou cannot configure a setting of 0 when there is only one\nbackend attached to the backend service.\n\nNot available with backends that don't support using abalancingMode. This includes backends such as global\ninternet NEGs, regional serverless NEGs, and PSC NEGs.", +"format": "float", +"type": "number" +}, +"customMetrics": { +"description": "List of custom metrics that are used for CUSTOM_METRICS\nBalancingMode.", +"items": { +"$ref": "BackendCustomMetric" +}, +"type": "array" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"failover": { +"description": "This field designates whether this is a failover backend. More than one\nfailover backend can be configured for a given BackendService.\n\nThis field can only be used for a regional external Passthrough Network\nLoad Balancer or a regional internal Passthrough Network Load Balancer.", +"type": "boolean" +}, +"group": { +"description": "The fully-qualified URL of aninstance\ngroup or network endpoint\ngroup (NEG) resource. To determine what types of backends a load\nbalancer supports, see the [Backend services\noverview](https://cloud.google.com/load-balancing/docs/backend-service#backends).\n\nYou must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group\nor NEG. Partial URLs are not supported.\n\nIf haPolicy is specified, backends must refer to NEG resources of type\nGCE_VM_IP.", +"type": "string" +}, +"maxConnections": { +"description": "Defines a target maximum number of simultaneous connections. For usage\nguidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode. Not available if the backend'sbalancingMode is RATE.", +"format": "int32", +"type": "integer" +}, +"maxConnectionsPerEndpoint": { +"description": "Defines a target maximum number of simultaneous connections. For usage\nguidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isRATE.", +"format": "int32", +"type": "integer" +}, +"maxConnectionsPerInstance": { +"description": "Defines a target maximum number of simultaneous connections.\nFor usage guidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isRATE.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequests": { +"description": "Defines a maximum number of in-flight requests for the whole NEG or\ninstance group. Not available if backend's balancingMode isRATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerEndpoint": { +"description": "Defines a maximum number of in-flight requests for a single endpoint.\nNot available if backend's balancingMode is RATE\nor CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerInstance": { +"description": "Defines a maximum number of in-flight requests for a single VM.\nNot available if backend's balancingMode is RATE\nor CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxRate": { +"description": "Defines a maximum number of HTTP requests per second (RPS). For\nusage guidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxRatePerEndpoint": { +"description": "Defines a maximum target for requests per second (RPS). For usage\nguidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", +"format": "float", +"type": "number" +}, +"maxRatePerInstance": { +"description": "Defines a maximum target for requests per second (RPS). For usage\nguidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", +"format": "float", +"type": "number" +}, +"maxUtilization": { +"description": "Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].\n\nFor usage guidelines, seeUtilization\nbalancing mode.", +"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\n\n\n\nFor global external Passthrough Network Load Balancers, the following\nrestrictions apply:\n \n - At most one backend can be marked as PREFERRED.\n - PREFERRED and DEFAULT backends cannot reside\n in the same Cloud region.", +"enum": [ +"DEFAULT", +"PREFERENCE_UNSPECIFIED", +"PREFERRED" +], +"enumDescriptions": [ +"No preference.", +"If preference is unspecified, we set it to the DEFAULT value", +"Traffic will be sent to this backend first." +], +"type": "string" +}, +"trafficDuration": { +"enum": [ +"LONG", +"SHORT", +"TRAFFIC_DURATION_UNSPECIFIED" +], +"enumDescriptions": [ +"Most of the requests are expected to take more than multiple seconds to\nfinish.", +"Most requests are expected to finish with a sub-second latency.", +"Traffic duration is unspecified." +], +"type": "string" +} +}, +"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", +"properties": { +"bucketName": { +"description": "Cloud Storage bucket name.", +"type": "string" +}, +"cdnPolicy": { +"$ref": "BackendBucketCdnPolicy", +"description": "Cloud CDN configuration for this BackendBucket." +}, +"compressionMode": { +"description": "Compress text responses using Brotli or gzip compression, based on\nthe client's Accept-Encoding header.", +"enum": [ +"AUTOMATIC", +"DISABLED" +], +"enumDescriptions": [ +"Automatically uses the best compression based on the Accept-Encoding\nheader sent by the client.", +"Disables compression. Existing compressed responses cached by\nCloud CDN will not be served to clients." +], +"type": "string" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"customResponseHeaders": { +"description": "Headers that the Application Load Balancer should add to proxied responses.", +"items": { +"type": "string" +}, +"type": "array" +}, +"description": { +"description": "An optional textual description of the resource; provided by the client\nwhen the resource is created.", +"type": "string" +}, +"edgeSecurityPolicy": { +"description": "[Output Only] The resource URL for the edge security policy associated with\nthis backend bucket.", +"type": "string" +}, +"enableCdn": { +"description": "If true, enable Cloud CDN for this BackendBucket.", +"type": "boolean" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#backendBucket", +"description": "Output only. Type of the resource.", +"readOnly": true, +"type": "string" +}, +"loadBalancingScheme": { +"description": "The value can only be INTERNAL_MANAGED for cross-region internal layer 7\nload balancer.\n\nIf loadBalancingScheme is not specified, the backend bucket can be used by\nclassic global external load balancers, or global application external load\nbalancers, or both.", +"enum": [ +"EXTERNAL_MANAGED", +"INTERNAL_MANAGED" +], +"enumDescriptions": [ +"Signifies that this will be used for regional external Application Load\nBalancers.", +"Signifies that this will be used for internal Application Load Balancers." +], +"type": "string" +}, +"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.\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" +}, +"params": { +"$ref": "BackendBucketParams", +"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 regional backend bucket\nresides. This field is not applicable to global backend buckets.\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] Server-defined URL for the resource.", +"type": "string" +}, +"usedBy": { +"description": "Output only. [Output Only] List of resources referencing that backend bucket.", +"items": { +"$ref": "BackendBucketUsedBy" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"BackendBucketAggregatedList": { +"id": "BackendBucketAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "BackendBucketsScopedList", +"description": "Name of the scope containing this set of BackendBuckets." +}, +"description": "A list of BackendBucketsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#backendBucketAggregatedList", +"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.", +"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" +}, +"BackendBucketCdnPolicy": { +"description": "Message containing Cloud CDN configuration for a backend bucket.", +"id": "BackendBucketCdnPolicy", +"properties": { +"bypassCacheOnRequestHeaders": { +"description": "Bypass the cache when the specified request headers are matched - e.g.\nPragma or Authorization headers. Up to 5 headers can be specified.\nThe cache is bypassed for all cdnPolicy.cacheMode settings.", +"items": { +"$ref": "BackendBucketCdnPolicyBypassCacheOnRequestHeader" +}, +"type": "array" +}, +"cacheKeyPolicy": { +"$ref": "BackendBucketCdnPolicyCacheKeyPolicy", +"description": "The CacheKeyPolicy for this CdnPolicy." +}, +"cacheMode": { +"description": "Specifies the cache setting for all responses from this backend.\nThe possible values are:\nUSE_ORIGIN_HEADERS Requires the origin to set valid caching\nheaders to cache content. Responses without these headers will not be\ncached at Google's edge, and will require a full trip to the origin on\nevery request, potentially impacting performance and increasing load on\nthe origin server.\nFORCE_CACHE_ALL Cache all content, ignoring any \"private\",\n\"no-store\" or \"no-cache\" directives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.\nCACHE_ALL_STATIC Automatically cache static content,\nincluding common image formats, media (video and audio), and web assets\n(JavaScript and CSS). Requests and responses that are marked as\nuncacheable, as well as dynamic content (including HTML), will not be\ncached.\n\nIf no value is provided for cdnPolicy.cacheMode, it defaults\nto CACHE_ALL_STATIC.", +"enum": [ +"CACHE_ALL_STATIC", +"FORCE_CACHE_ALL", +"INVALID_CACHE_MODE", +"USE_ORIGIN_HEADERS" +], +"enumDescriptions": [ +"Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", +"Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", +"", +"Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at Google's edge,\nand will require a full trip to the origin on every request,\npotentially impacting performance and increasing load on the\norigin server." +], +"type": "string" +}, +"clientTtl": { +"description": "Specifies a separate client (e.g. browser client) maximum TTL. This is\nused to clamp the max-age (or Expires) value sent to the client. With\nFORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the\nresponse max-age directive, along with a \"public\" directive. For\ncacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age\nfrom the origin (if specified), or else sets the response max-age\ndirective to the lesser of the client_ttl and default_ttl, and also\nensures a \"public\" cache-control directive is present.\nIf a client TTL is not specified, a default value (1 hour) will be used.\nThe maximum allowed value is 31,622,400s (1 year).", +"format": "int32", +"type": "integer" +}, +"defaultTtl": { +"description": "Specifies the default TTL for cached content served by this origin for\nresponses that do not have an existing valid TTL (max-age or s-maxage).\nSetting a TTL of \"0\" means \"always revalidate\".\nThe value of defaultTTL cannot be set to a value greater than that of\nmaxTTL, but can be equal.\nWhen the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL\nwill overwrite the TTL set in all responses. The maximum allowed value is\n31,622,400s (1 year), noting that infrequently accessed objects may be\nevicted from the cache before the defined TTL.", +"format": "int32", +"type": "integer" +}, +"maxTtl": { +"description": "Specifies the maximum allowed TTL for cached content served by this\norigin.\nCache directives that attempt to set a max-age or s-maxage higher than\nthis, or an Expires header more than maxTTL seconds in the future will\nbe capped at the value of maxTTL, as if it were the value of an\ns-maxage Cache-Control directive.\nHeaders sent to the client will not be modified.\nSetting a TTL of \"0\" means \"always revalidate\".\nThe maximum allowed value is 31,622,400s (1 year), noting that\ninfrequently accessed objects may be evicted from the cache before\nthe defined TTL.", +"format": "int32", +"type": "integer" +}, +"negativeCaching": { +"description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,\nnegative caching applies to responses with the specified response code\nthat lack any Cache-Control, Expires, or Pragma: no-cache directives.\nWhen the cache mode is set to FORCE_CACHE_ALL, negative caching applies\nto all responses with the specified response code, and override any\ncaching headers.\nBy default, Cloud CDN will apply the following default TTLs to these\nstatus codes:\nHTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\nHTTP 404 (Not Found), 410 (Gone),\n451 (Unavailable For Legal Reasons): 120s\nHTTP 405 (Method Not Found), 501 (Not Implemented): 60s.\nThese defaults can be overridden in negative_caching_policy.", +"type": "boolean" +}, +"negativeCachingPolicy": { +"description": "Sets a cache TTL for the specified HTTP status code.\nnegative_caching must be enabled to configure negative_caching_policy.\nOmitting the policy and leaving negative_caching enabled will use\nCloud CDN's default cache TTLs.\nNote that when specifying an explicit negative_caching_policy, you\nshould take care to specify a cache TTL for all response codes\nthat you wish to cache. Cloud CDN will not apply any default\nnegative caching when a policy exists.", +"items": { +"$ref": "BackendBucketCdnPolicyNegativeCachingPolicy" +}, +"type": "array" +}, +"requestCoalescing": { +"description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin.", +"type": "boolean" +}, +"serveWhileStale": { +"description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale.", +"format": "int32", +"type": "integer" +}, +"signedUrlCacheMaxAgeSec": { +"description": "Maximum number of seconds the response to a signed URL request will be\nconsidered fresh. After this time period, the response will be\nrevalidated before being served. Defaults to 1hr (3600s). When serving\nresponses to signed URL requests, Cloud CDN will internally behave as\nthough all responses from this backend had a \"Cache-Control:\npublic, max-age=[TTL]\" header, regardless of any existing\nCache-Control header. The actual headers served in responses will not be\naltered.", +"format": "int64", +"type": "string" +}, +"signedUrlKeyNames": { +"description": "[Output Only] Names of the keys for signing request URLs.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"BackendBucketCdnPolicyBypassCacheOnRequestHeader": { +"description": "Bypass the cache when the specified request headers are present,\ne.g. Pragma or Authorization headers. Values are case insensitive.\nThe presence of such a header overrides the cache_mode setting.", +"id": "BackendBucketCdnPolicyBypassCacheOnRequestHeader", +"properties": { +"headerName": { +"description": "The header field name to match on when bypassing cache.\nValues are case-insensitive.", +"type": "string" +} +}, +"type": "object" +}, +"BackendBucketCdnPolicyCacheKeyPolicy": { +"description": "Message containing what to include in the cache key for a request for\nCloud CDN.", +"id": "BackendBucketCdnPolicyCacheKeyPolicy", +"properties": { +"includeHttpHeaders": { +"description": "Allows HTTP request headers (by name) to be used in the cache key.", +"items": { +"type": "string" +}, +"type": "array" +}, +"queryStringWhitelist": { +"description": "Names of query string parameters to include in cache keys. Default\nparameters are always included. '&' and '=' will be percent encoded\nand not treated as delimiters.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"BackendBucketCdnPolicyNegativeCachingPolicy": { +"description": "Specify CDN TTLs for response error codes.", +"id": "BackendBucketCdnPolicyNegativeCachingPolicy", +"properties": { +"code": { +"description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", +"format": "int32", +"type": "integer" +}, +"ttl": { +"description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes), noting that\ninfrequently accessed objects may be evicted from the cache before the\ndefined TTL.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"BackendBucketList": { +"description": "Contains a list of BackendBucket resources.", +"id": "BackendBucketList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of BackendBucket resources.", +"items": { +"$ref": "BackendBucket" +}, +"type": "array" +}, +"kind": { +"default": "compute#backendBucketList", +"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.", +"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" +}, +"BackendBucketListUsable": { +"id": "BackendBucketListUsable", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of BackendBucket resources.", +"items": { +"$ref": "BackendBucket" +}, +"type": "array" +}, +"kind": { +"default": "compute#usableBackendBucketList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#usableBackendBucketList for lists of usable backend\nbuckets.", +"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.", +"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" +}, +"BackendBucketParams": { +"description": "Additional Backend Bucket parameters.", +"id": "BackendBucketParams", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"BackendBucketUsedBy": { +"id": "BackendBucketUsedBy", +"properties": { +"reference": { +"description": "Output only. [Output Only] Server-defined URL for UrlMaps referencing that\nBackendBucket.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BackendBucketsScopedList": { +"id": "BackendBucketsScopedList", +"properties": { +"backendBuckets": { +"description": "A list of BackendBuckets contained in this scope.", +"items": { +"$ref": "BackendBucket" +}, +"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.", +"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" +}, +"BackendCustomMetric": { +"description": "Custom Metrics are used for CUSTOM_METRICS balancing_mode.", +"id": "BackendCustomMetric", +"properties": { +"dryRun": { +"description": "If true, the metric data is collected and reported to Cloud\nMonitoring, but is not used for load balancing.", +"type": "boolean" +}, +"maxUtilization": { +"description": "Optional parameter to define a target utilization for the Custom Metrics\nbalancing mode. The valid range is [0.0, 1.0].", +"format": "float", +"type": "number" +}, +"name": { +"description": "Name of a custom utilization signal. The name must be 1-64 characters\nlong and match the regular expression\n`[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the\nfirst character must be a lowercase letter, and all following\ncharacters must be a dash, period, underscore, lowercase letter, or\ndigit, except the last character, which cannot be a dash, period, or\nunderscore. For usage guidelines, see Custom Metrics balancing mode. This\nfield can only be used for a global or regional backend service with the\nloadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", +"type": "string" +} +}, +"type": "object" +}, +"BackendService": { +"description": "Represents a Backend Service resource.\n\nA backend service defines how Google Cloud load balancers distribute traffic.\nThe backend service configuration contains a set of values, such as the\nprotocol used to connect to backends, various distribution and session\nsettings, health checks, and timeouts. These settings provide fine-grained\ncontrol over how your load balancer behaves. Most of the settings have\ndefault values that allow for easy configuration if you need to get started\nquickly.\n\nBackend services in Google Compute Engine can be either regionally or\nglobally scoped.\n\n* [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)\n* [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)\n\nFor more information, seeBackend\nServices.", +"id": "BackendService", +"properties": { +"affinityCookieTtlSec": { +"description": "Lifetime of cookies in seconds. This setting is applicable to Application\nLoad Balancers and Traffic Director and requires\nGENERATED_COOKIE or HTTP_COOKIE session affinity.\n\nIf set to 0, the cookie is non-persistent and lasts only until\nthe end of the browser session (or equivalent). The maximum allowed value\nis two weeks (1,209,600).\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.", +"format": "int32", +"type": "integer" +}, +"backends": { +"description": "The list of backends that serve this BackendService.", +"items": { +"$ref": "Backend" +}, +"type": "array" +}, +"cdnPolicy": { +"$ref": "BackendServiceCdnPolicy", +"description": "Cloud CDN configuration for this BackendService. Only available for\nspecified load balancer types." +}, +"circuitBreakers": { +"$ref": "CircuitBreakers" +}, +"compressionMode": { +"description": "Compress text responses using Brotli or gzip compression, based on\nthe client's Accept-Encoding header.", +"enum": [ +"AUTOMATIC", +"DISABLED" +], +"enumDescriptions": [ +"Automatically uses the best compression based on the Accept-Encoding\nheader sent by the client.", +"Disables compression. Existing compressed responses cached by\nCloud CDN will not be served to clients." +], +"type": "string" +}, +"connectionDraining": { +"$ref": "ConnectionDraining", +"description": "connectionDraining cannot be specified with haPolicy." +}, +"connectionTrackingPolicy": { +"$ref": "BackendServiceConnectionTrackingPolicy", +"description": "Connection Tracking configuration for this BackendService. Connection\ntracking policy settings are only available for external passthrough\nNetwork Load Balancers and internal passthrough Network Load Balancers.\n\nconnectionTrackingPolicy cannot be specified with haPolicy." +}, +"consistentHash": { +"$ref": "ConsistentHashLoadBalancerSettings", +"description": "Consistent Hash-based load balancing can be used to provide soft session\naffinity based on HTTP headers, cookies or other properties. This load\nbalancing policy is applicable only for HTTP connections. The affinity to a\nparticular destination host will be lost when one or more hosts are\nadded/removed from the destination service. This field specifies parameters\nthat control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.\n\nThis field is applicable to either:\n \n - A regional backend service with the service protocol set to HTTP,\n HTTPS, HTTP2 or H2C, and load_balancing_scheme set to\n INTERNAL_MANAGED. \n - A global backend service with the\n load_balancing_scheme set to INTERNAL_SELF_MANAGED." +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"customMetrics": { +"description": "List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.", +"items": { +"$ref": "BackendServiceCustomMetric" +}, +"type": "array" +}, +"customRequestHeaders": { +"description": "Headers that the load balancer adds to proxied requests. See [Creating\ncustom\nheaders](https://cloud.google.com/load-balancing/docs/custom-headers).", +"items": { +"type": "string" +}, +"type": "array" +}, +"customResponseHeaders": { +"description": "Headers that the load balancer adds to proxied responses. See [Creating\ncustom\nheaders](https://cloud.google.com/load-balancing/docs/custom-headers).", +"items": { +"type": "string" +}, +"type": "array" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"edgeSecurityPolicy": { +"description": "[Output Only] The resource URL for the edge security policy associated with\nthis backend service.", +"type": "string" +}, +"enableCDN": { +"description": "If true, enables Cloud CDN for the backend service of a\nglobal external Application Load Balancer.", +"type": "boolean" +}, +"externalManagedMigrationState": { +"description": "Specifies the canary migration state. Possible values are PREPARE,\nTEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.\n\nTo begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be\nchanged to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before\nthe loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using\nexternalManagedMigrationTestingPercentage.\n\nRolling back a migration requires the states to be set in reverse order. So\nchanging the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to\nbe set to TEST_ALL_TRAFFIC at the same time. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate some traffic back to\nEXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", +"enum": [ +"PREPARE", +"TEST_ALL_TRAFFIC", +"TEST_BY_PERCENTAGE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"externalManagedMigrationTestingPercentage": { +"description": "Determines the fraction of requests that should be processed by the Global\nexternal Application Load Balancer.\n\nThe value of this field must be in the range [0, 100].\n\nSession affinity options will slightly affect this routing behavior, for\nmore details, see:Session\nAffinity.\n\nThis value can only be set if the loadBalancingScheme in the BackendService\nis set to EXTERNAL (when using the classic Application Load Balancer) and\nthe migration state is TEST_BY_PERCENTAGE.", +"format": "float", +"type": "number" +}, +"failoverPolicy": { +"$ref": "BackendServiceFailoverPolicy", +"description": "Requires at least one backend instance group to be defined\nas a backup (failover) backend.\nFor load balancers that have configurable failover:\n[Internal passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nfailoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough\nNetwork Load Balancers." +}, +"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 BackendService. An up-to-date fingerprint must be provided in\norder to update the BackendService, otherwise the request will\nfail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a BackendService.", +"format": "byte", +"type": "string" +}, +"haPolicy": { +"$ref": "BackendServiceHAPolicy", +"description": "Configures self-managed High Availability (HA) for External and Internal\nProtocol Forwarding.\n\nThe backends of this regional backend service must only specify zonal\nnetwork endpoint groups (NEGs) of type GCE_VM_IP.\n\nWhen haPolicy is set for an Internal Passthrough Network Load Balancer, the\nregional backend service must set the network field. All zonal NEGs must\nbelong to the same network. However, individual NEGs can\nbelong to different subnetworks of that network.\n\nWhen haPolicy is specified, the set of attached network endpoints across\nall backends comprise an High Availability domain from which one endpoint\nis selected as the active endpoint (the leader) that receives all\ntraffic.\n\nhaPolicy can be added only at backend service creation time. Once set up,\nit cannot be deleted.\n\nNote that haPolicy is not for load balancing, and therefore cannot be\nspecified with sessionAffinity, connectionTrackingPolicy, and\nfailoverPolicy.\n\nhaPolicy requires customers to be responsible for tracking backend\nendpoint health and electing a leader among the healthy endpoints.\nTherefore, haPolicy cannot be specified with healthChecks.\nhaPolicy can only be specified for External Passthrough\nNetwork Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network\nLoad Balancers." +}, +"healthChecks": { +"description": "The list of URLs to the healthChecks, httpHealthChecks (legacy), or\nhttpsHealthChecks (legacy) resource for health checking this backend\nservice. Not all backend services support legacy health checks. See\nLoad balancer guide. Currently, at most one health check can be\nspecified for each backend service. Backend services with\ninstance group or zonal NEG backends must have a health check unless\nhaPolicy is specified. Backend services with internet or serverless NEG\nbackends must not have a health check.\n\nhealthChecks[] cannot be specified with haPolicy.", +"items": { +"type": "string" +}, +"type": "array" +}, +"iap": { +"$ref": "BackendServiceIAP", +"description": "The configurations for Identity-Aware Proxy on this resource.\nNot available for internal passthrough Network Load Balancers and external\npassthrough Network Load Balancers." +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"ipAddressSelectionPolicy": { +"description": "Specifies a preference for traffic sent from the proxy to the backend (or\nfrom the client to the backend for proxyless gRPC).\nThe possible values are:\n \n - IPV4_ONLY: Only send IPv4 traffic to the backends of the\n backend service (Instance Group, Managed Instance Group, Network Endpoint\n Group), regardless of traffic from the client to the proxy. Only IPv4\n health checks are used to check the health of the backends. This is the\n default setting.\n - PREFER_IPV6: Prioritize the connection to the endpoint's\n IPv6 address over its IPv4 address (provided there is a healthy IPv6\n address).\n - IPV6_ONLY: Only send IPv6 traffic to the backends of the\n backend service (Instance Group, Managed Instance Group, Network Endpoint\n Group), regardless of traffic from the client to the proxy. Only IPv6\n health checks are used to check the health of the backends.\n\n\n\nThis field is applicable to either:\n \n - Advanced global external Application Load Balancer (load balancing\n scheme EXTERNAL_MANAGED), \n - Regional external Application Load\n Balancer, \n - Internal proxy Network Load Balancer (load balancing\n scheme INTERNAL_MANAGED), \n - Regional internal Application Load\n Balancer (load balancing scheme INTERNAL_MANAGED), \n - Traffic\n Director with Envoy proxies and proxyless gRPC (load balancing scheme\n INTERNAL_SELF_MANAGED).", +"enum": [ +"IPV4_ONLY", +"IPV6_ONLY", +"IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED", +"PREFER_IPV6" +], +"enumDescriptions": [ +"Only send IPv4 traffic to the backends of the Backend Service\n(Instance Group, Managed Instance Group, Network Endpoint Group)\nregardless of traffic from the client to the proxy.\nOnly IPv4 health-checks are used to check the health of the backends.\nThis is the default setting.", +"Only send IPv6 traffic to the backends of the Backend Service\n(Instance Group, Managed Instance Group, Network Endpoint Group)\nregardless of traffic from the client to the proxy. Only IPv6\nhealth-checks are used to check the health of the backends.", +"Unspecified IP address selection policy.", +"Prioritize the connection to the endpoints IPv6 address\nover its IPv4 address (provided there is a healthy IPv6 address)." +], +"type": "string" +}, +"kind": { +"default": "compute#backendService", +"description": "Output only. [Output Only] Type of resource. Always compute#backendService\nfor backend services.", +"readOnly": true, +"type": "string" +}, +"loadBalancingScheme": { +"description": "Specifies the load balancer type. A backend service\ncreated for one type of load balancer cannot be used with another.\nFor more information, refer to\nBackend services product and scheme table.", +"enum": [ +"EXTERNAL", +"EXTERNAL_MANAGED", +"INTERNAL", +"INTERNAL_MANAGED", +"INTERNAL_SELF_MANAGED", +"INVALID_LOAD_BALANCING_SCHEME" +], +"enumDescriptions": [ +"Signifies that this will be used for classic Application Load Balancers,\nglobal external proxy Network Load Balancers,\nor external passthrough Network Load Balancers.", +"Signifies that this will be used for global external Application Load\nBalancers, regional external Application Load Balancers, or regional\nexternal proxy Network Load Balancers.", +"Signifies that this will be used for internal passthrough Network Load\nBalancers.", +"Signifies that this will be used for internal Application Load Balancers.", +"Signifies that this will be used by Traffic Director.", +"" +], +"type": "string" +}, +"localityLbPolicies": { +"description": "A list of locality load-balancing policies to be used in order of\npreference. When you use localityLbPolicies, you must set at least one\nvalue for either the localityLbPolicies[].policy or the\nlocalityLbPolicies[].customPolicy field. localityLbPolicies overrides any\nvalue set in the localityLbPolicy field.\n\nFor an example of how to use this field, seeDefine\na list of preferred policies.\n\nCaution: This field and its children are intended for use in a service mesh\nthat includes gRPC clients only. Envoy proxies can't use backend services\nthat have this configuration.", +"items": { +"$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" +}, +"type": "array" +}, +"localityLbPolicy": { +"description": "The load balancing algorithm used within the scope of the locality. The\npossible values are:\n \n - ROUND_ROBIN: This is a simple policy in which each healthy\n backend is selected in round robin order. This is the default.\n - LEAST_REQUEST: An O(1) algorithm which\n selects two random healthy hosts and picks the host which has fewer active\n requests.\n - RING_HASH: The ring/modulo hash load balancer implements\n consistent hashing to backends. The algorithm has the property that the\n addition/removal of a host from a set of N hosts only affects 1/N of the\n requests.\n - RANDOM: The load balancer selects a random healthy\n host.\n - ORIGINAL_DESTINATION: Backend host is selected\n based on the client connection metadata, i.e., connections are opened to\n the same address as the destination address of the incoming connection\n before the connection was redirected to the load balancer.\n - MAGLEV: used as a drop in replacement for the ring hash\n load balancer. Maglev is not as stable as ring hash but has faster table\n lookup build times and host selection times. For more information about\n Maglev, see Maglev:\n A Fast and Reliable Software Network Load Balancer.\n - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin\n Load Balancing using weights computed from Backend reported Custom Metrics.\n If set, the Backend Service responses are expected to contain non-standard\n HTTP response header field Endpoint-Load-Metrics. The reported\n metrics to use for computing the weights are specified via thecustomMetrics field.\n - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via\n health check reported weights. If set, the backend service must configure\n an HTTP-based Health Check, and health check replies are expected to\n contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint\n weights. If set, load balancing is weighted based on the per-endpoint\n weights reported in the last processed health check replies, as long as\n every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.\n Otherwise, load balancing remains equal-weight.\n\n\n\nThis field is applicable to either:\n \n - A regional backend service with the service protocol set to HTTP,\n HTTPS, HTTP2 or H2C, and load_balancing_scheme set to\n INTERNAL_MANAGED. \n - A global backend service with the\n load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or\n EXTERNAL_MANAGED.\n\n\n\nIf sessionAffinity is not configured\u2014that is, if session\naffinity remains at the default value of NONE\u2014then the\ndefault value for localityLbPolicy\nis ROUND_ROBIN. If session affinity is set to a value other\nthan NONE,\nthen the default value for localityLbPolicy isMAGLEV.\n\nOnly ROUND_ROBIN and RING_HASH are supported\nwhen the backend service is referenced by a URL map that is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n\nlocalityLbPolicy cannot be specified with haPolicy.", +"enum": [ +"INVALID_LB_POLICY", +"LEAST_REQUEST", +"MAGLEV", +"ORIGINAL_DESTINATION", +"RANDOM", +"RING_HASH", +"ROUND_ROBIN", +"WEIGHTED_GCP_RENDEZVOUS", +"WEIGHTED_MAGLEV", +"WEIGHTED_ROUND_ROBIN" +], +"enumDescriptions": [ +"", +"An O(1) algorithm which selects two random healthy hosts and\npicks the host which has fewer active requests.", +"This algorithm implements consistent hashing to backends. Maglev can be\nused as a drop in replacement for the ring hash load balancer. Maglev is\nnot as stable as ring hash but has faster table lookup build times and\nhost selection times. For more information about Maglev, seeMaglev:\nA Fast and Reliable Software Network Load Balancer.", +"Backend host is selected based on the client connection metadata, i.e.,\nconnections are opened to the same address as the destination address of\nthe incoming connection before the connection was redirected to the load\nbalancer.", +"The load balancer selects a random healthy host.", +"The ring/modulo hash load balancer implements consistent hashing to\nbackends. The algorithm has the property that the addition/removal\nof a host from a set of N hosts only affects 1/N of the requests.", +"This is a simple policy in which each healthy backend is selected\nin round robin order. This is the default.", +"Per-instance weighted Load Balancing via health check reported weights.\nIn internal passthrough network load balancing, it is weighted\nrendezvous hashing.\nThis option is only supported in internal passthrough network load\nbalancing.", +"Per-instance weighted Load Balancing via health check reported weights.\nIf set, the Backend Service must configure a non legacy HTTP-based Health\nCheck, and health check replies are expected to contain non-standard HTTP\nresponse header field X-Load-Balancing-Endpoint-Weight to specify the\nper-instance weights.\nIf set, Load Balancing is weighted based on the\nper-instance weights reported in the last processed health check replies,\nas long as every instance either reported a valid weight or had\nUNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight.\nThis option is only supported in Network Load Balancing.", +"Per-endpoint weighted round-robin Load Balancing using weights computed\nfrom Backend reported Custom Metrics. If set, the Backend Service\nresponses are expected to contain non-standard HTTP response header field\nEndpoint-Load-Metrics. The reported metrics\nto use for computing the weights are specified via the\ncustomMetrics fields." +], +"type": "string" +}, +"logConfig": { +"$ref": "BackendServiceLogConfig", +"description": "This field denotes the logging options for the load balancer traffic served\nby this backend service. If logging is enabled, logs will be exported to\nStackdriver." +}, +"maxStreamDuration": { +"$ref": "Duration", +"description": "Specifies the default maximum duration (timeout) for streams to this\nservice. Duration is computed from the beginning of the stream until the\nresponse has been completely processed, including all retries. A stream\nthat does not complete in this duration is closed.\n\nIf not specified, there will be no timeout limit, i.e. the maximum\nduration is infinite.\n\nThis value can be overridden in the PathMatcher configuration of the\nUrlMap that references this backend service.\n\nThis field is only allowed when the loadBalancingScheme of\nthe backend service is INTERNAL_SELF_MANAGED." +}, +"metadatas": { +"additionalProperties": { +"type": "string" +}, +"description": "Deployment metadata associated with the resource to be set by a GKE hub\ncontroller and read by the backend RCTH", +"type": "object" +}, +"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.\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" +}, +"network": { +"description": "The URL of the network to which this backend service belongs.\n\nThis field must be set for Internal Passthrough Network Load Balancers when\nthe haPolicy is enabled, and for External Passthrough Network Load\nBalancers when the haPolicy fastIpMove is enabled.\n\nThis field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.", +"type": "string" +}, +"networkPassThroughLbTrafficPolicy": { +"$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 service protocol 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." +}, +"params": { +"$ref": "BackendServiceParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"port": { +"deprecated": true, +"description": "Deprecated in favor of portName. The TCP port to connect on\nthe backend. The default value is 80.\nFor internal passthrough Network Load Balancers and external passthrough\nNetwork Load Balancers, omit port.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "A named port on a backend instance group representing the port for\ncommunication to the backend VMs in that group. The\nnamed port must be [defined on each backend instance\ngroup](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).\nThis parameter has no meaning if the backends are NEGs. For internal\npassthrough Network Load Balancers and external passthrough Network Load\nBalancers, omit port_name.", +"type": "string" +}, +"protocol": { +"description": "The protocol this BackendService uses to communicate with backends.\n\nPossible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or\nUNSPECIFIED, depending on the chosen load balancer or Traffic Director\nconfiguration.\nRefer to \nLoad balancing features for more information.\n\nMust be set to GRPC when the backend service is referenced by a URL map\nthat is bound to target gRPC proxy.", +"enum": [ +"GRPC", +"H2C", +"HTTP", +"HTTP2", +"HTTPS", +"SSL", +"TCP", +"UDP", +"UNSPECIFIED" +], +"enumDescriptions": [ +"gRPC (available for Traffic Director).", +"HTTP2 over cleartext", +"", +"HTTP/2 with SSL.", +"", +"TCP proxying with SSL.", +"TCP proxying or TCP pass-through.", +"UDP.", +"If a Backend Service has UNSPECIFIED as its protocol, it can be used with\nany L3/L4 Forwarding Rules." +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional backend service\nresides. This field is not applicable to global backend 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" +}, +"securityPolicy": { +"description": "[Output Only] The resource URL for the security policy associated with this\nbackend service.", +"type": "string" +}, +"securitySettings": { +"$ref": "SecuritySettings", +"description": "This field specifies the security settings that apply to this backend\nservice. This field is applicable to a global backend service with the\nload_balancing_scheme set to INTERNAL_SELF_MANAGED." +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"serviceBindings": { +"description": "URLs of networkservices.ServiceBinding resources.\n\nCan only be set if load balancing scheme is INTERNAL_SELF_MANAGED.\nIf set, lists of backends and health checks must be both empty.", +"items": { +"type": "string" +}, +"type": "array" +}, +"serviceLbPolicy": { +"description": "URL to networkservices.ServiceLbPolicy resource.\n\nCan only be set if load balancing scheme is EXTERNAL_MANAGED,\nINTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and\nEXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a\nglobal backend service, the service lb policy must be global. For a\nregional backend service, the service lb policy must be regional and in the\nsame region.", +"type": "string" +}, +"sessionAffinity": { +"description": "Type of session affinity to use. The default is NONE.\n\nOnly NONE and HEADER_FIELD are supported\nwhen the backend service is referenced by a URL map that is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n\nFor more details, see:\n[Session\nAffinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).\n\nsessionAffinity cannot be specified with haPolicy.", +"enum": [ +"CLIENT_IP", +"CLIENT_IP_NO_DESTINATION", +"CLIENT_IP_PORT_PROTO", +"CLIENT_IP_PROTO", +"GENERATED_COOKIE", +"HEADER_FIELD", +"HTTP_COOKIE", +"NONE", +"STRONG_COOKIE_AFFINITY" +], +"enumDescriptions": [ +"2-tuple hash on packet's source and destination IP addresses. Connections\nfrom the same source IP address to the same destination IP address will be\nserved by the same backend VM while that VM remains healthy.", +"1-tuple hash only on packet's source IP address. Connections from the\nsame source IP address will be served by the same backend VM while that VM\nremains healthy. This option can only be used for Internal TCP/UDP\nLoad Balancing.", +"5-tuple hash on packet's source and destination IP addresses, IP protocol,\nand source and destination ports. Connections for the same IP protocol\nfrom the same source IP address and port to the same destination IP address\nand port will be served by the same backend VM while that VM remains\nhealthy. This option cannot be used for HTTP(S) load balancing.", +"3-tuple hash on packet's source and destination IP addresses, and IP\nprotocol. Connections for the same IP protocol from the same source IP\naddress to the same destination IP address will be served by the same\nbackend VM while that VM remains healthy. This option cannot be used for\nHTTP(S) load balancing.", +"Hash based on a cookie generated by the L7 loadbalancer.\nOnly valid for HTTP(S) load balancing.", +"The hash is based on a user specified header field.", +"The hash is based on a user provided cookie.", +"No session affinity. Connections from the same client IP may go\nto any instance in the pool.", +"Strong cookie-based affinity. Connections bearing the same cookie will be\nserved by the same backend VM while that VM remains healthy, as long as the\ncookie has not expired." +], +"type": "string" +}, +"strongSessionAffinityCookie": { +"$ref": "BackendServiceHttpCookie", +"description": "Describes the HTTP cookie used for stateful session affinity. This field is\napplicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY." +}, +"subsetting": { +"$ref": "Subsetting", +"description": "subsetting cannot be specified with haPolicy." +}, +"timeoutSec": { +"description": "The backend service timeout has a different meaning depending on the\ntype of load balancer. For more information see,\nBackend service settings.\nThe default is 30 seconds.\nThe full range of timeout values allowed goes from 1\nthrough 2,147,483,647 seconds.\n\nThis value can be overridden in the PathMatcher configuration of the\nUrlMap that references this backend service.\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.\nInstead, use maxStreamDuration.", +"format": "int32", +"type": "integer" +}, +"tlsSettings": { +"$ref": "BackendServiceTlsSettings", +"description": "Configuration for Backend Authenticated TLS and mTLS. May only be specified\nwhen the backend protocol is SSL, HTTPS or HTTP2." +}, +"usedBy": { +"description": "Output only. [Output Only] List of resources referencing given backend service.", +"items": { +"$ref": "BackendServiceUsedBy" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"BackendServiceAggregatedList": { +"description": "Contains a list of BackendServicesScopedList.", +"id": "BackendServiceAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "BackendServicesScopedList", +"description": "Name of the scope containing this set of BackendServices." +}, +"description": "A list of BackendServicesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#backendServiceAggregatedList", +"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" +}, +"BackendServiceCdnPolicy": { +"description": "Message containing Cloud CDN configuration for a backend service.", +"id": "BackendServiceCdnPolicy", +"properties": { +"bypassCacheOnRequestHeaders": { +"description": "Bypass the cache when the specified request headers are matched - e.g.\nPragma or Authorization headers. Up to 5 headers can be specified.\nThe cache is bypassed for all cdnPolicy.cacheMode settings.", +"items": { +"$ref": "BackendServiceCdnPolicyBypassCacheOnRequestHeader" +}, +"type": "array" +}, +"cacheKeyPolicy": { +"$ref": "CacheKeyPolicy", +"description": "The CacheKeyPolicy for this CdnPolicy." +}, +"cacheMode": { +"description": "Specifies the cache setting for all responses from this backend.\nThe possible values are:\nUSE_ORIGIN_HEADERS Requires the origin to set valid caching\nheaders to cache content. Responses without these headers will not be\ncached at Google's edge, and will require a full trip to the origin on\nevery request, potentially impacting performance and increasing load on\nthe origin server.\nFORCE_CACHE_ALL Cache all content, ignoring any \"private\",\n\"no-store\" or \"no-cache\" directives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.\nCACHE_ALL_STATIC Automatically cache static content,\nincluding common image formats, media (video and audio), and web assets\n(JavaScript and CSS). Requests and responses that are marked as\nuncacheable, as well as dynamic content (including HTML), will not be\ncached.\n\nIf no value is provided for cdnPolicy.cacheMode, it defaults\nto CACHE_ALL_STATIC.", +"enum": [ +"CACHE_ALL_STATIC", +"FORCE_CACHE_ALL", +"INVALID_CACHE_MODE", +"USE_ORIGIN_HEADERS" +], +"enumDescriptions": [ +"Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", +"Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", +"", +"Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at Google's edge,\nand will require a full trip to the origin on every request,\npotentially impacting performance and increasing load on the\norigin server." +], +"type": "string" +}, +"clientTtl": { +"description": "Specifies a separate client (e.g. browser client) maximum TTL. This is\nused to clamp the max-age (or Expires) value sent to the client. With\nFORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the\nresponse max-age directive, along with a \"public\" directive. For\ncacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age\nfrom the origin (if specified), or else sets the response max-age\ndirective to the lesser of the client_ttl and default_ttl, and also\nensures a \"public\" cache-control directive is present.\nIf a client TTL is not specified, a default value (1 hour) will be used.\nThe maximum allowed value is 31,622,400s (1 year).", +"format": "int32", +"type": "integer" +}, +"defaultTtl": { +"description": "Specifies the default TTL for cached content served by this origin for\nresponses that do not have an existing valid TTL (max-age or s-maxage).\nSetting a TTL of \"0\" means \"always revalidate\".\nThe value of defaultTTL cannot be set to a value greater than that of\nmaxTTL, but can be equal.\nWhen the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL\nwill overwrite the TTL set in all responses. The maximum allowed value is\n31,622,400s (1 year), noting that infrequently accessed objects may be\nevicted from the cache before the defined TTL.", +"format": "int32", +"type": "integer" +}, +"maxTtl": { +"description": "Specifies the maximum allowed TTL for cached content served by this\norigin.\nCache directives that attempt to set a max-age or s-maxage higher than\nthis, or an Expires header more than maxTTL seconds in the future will\nbe capped at the value of maxTTL, as if it were the value of an\ns-maxage Cache-Control directive.\nHeaders sent to the client will not be modified.\nSetting a TTL of \"0\" means \"always revalidate\".\nThe maximum allowed value is 31,622,400s (1 year), noting that\ninfrequently accessed objects may be evicted from the cache before\nthe defined TTL.", +"format": "int32", +"type": "integer" +}, +"negativeCaching": { +"description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,\nnegative caching applies to responses with the specified response code\nthat lack any Cache-Control, Expires, or Pragma: no-cache directives.\nWhen the cache mode is set to FORCE_CACHE_ALL, negative caching applies\nto all responses with the specified response code, and override any\ncaching headers.\nBy default, Cloud CDN will apply the following default TTLs to these\nstatus codes:\nHTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\nHTTP 404 (Not Found), 410 (Gone),\n451 (Unavailable For Legal Reasons): 120s\nHTTP 405 (Method Not Found), 501 (Not Implemented): 60s.\nThese defaults can be overridden in negative_caching_policy.", +"type": "boolean" +}, +"negativeCachingPolicy": { +"description": "Sets a cache TTL for the specified HTTP status code.\nnegative_caching must be enabled to configure negative_caching_policy.\nOmitting the policy and leaving negative_caching enabled will use\nCloud CDN's default cache TTLs.\nNote that when specifying an explicit negative_caching_policy, you\nshould take care to specify a cache TTL for all response codes\nthat you wish to cache. Cloud CDN will not apply any default\nnegative caching when a policy exists.", +"items": { +"$ref": "BackendServiceCdnPolicyNegativeCachingPolicy" +}, +"type": "array" +}, +"requestCoalescing": { +"description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin.", +"type": "boolean" +}, +"serveWhileStale": { +"description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale.", +"format": "int32", +"type": "integer" +}, +"signedUrlCacheMaxAgeSec": { +"description": "Maximum number of seconds the response to a signed URL request will be\nconsidered fresh. After this time period, the response will be\nrevalidated before being served. Defaults to 1hr (3600s). When serving\nresponses to signed URL requests, Cloud CDN will internally behave as\nthough all responses from this backend had a \"Cache-Control:\npublic, max-age=[TTL]\" header, regardless of any existing\nCache-Control header. The actual headers served in responses will not be\naltered.", +"format": "int64", +"type": "string" +}, +"signedUrlKeyNames": { +"description": "[Output Only] Names of the keys for signing request URLs.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"BackendServiceCdnPolicyBypassCacheOnRequestHeader": { +"description": "Bypass the cache when the specified request headers are present,\ne.g. Pragma or Authorization headers. Values are case insensitive.\nThe presence of such a header overrides the cache_mode setting.", +"id": "BackendServiceCdnPolicyBypassCacheOnRequestHeader", +"properties": { +"headerName": { +"description": "The header field name to match on when bypassing cache.\nValues are case-insensitive.", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceCdnPolicyNegativeCachingPolicy": { +"description": "Specify CDN TTLs for response error codes.", +"id": "BackendServiceCdnPolicyNegativeCachingPolicy", +"properties": { +"code": { +"description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", +"format": "int32", +"type": "integer" +}, +"ttl": { +"description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes), noting that\ninfrequently accessed objects may be evicted from the cache before the\ndefined TTL.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"BackendServiceConnectionTrackingPolicy": { +"description": "Connection Tracking configuration for this BackendService.", +"id": "BackendServiceConnectionTrackingPolicy", +"properties": { +"connectionPersistenceOnUnhealthyBackends": { +"description": "Specifies connection persistence when backends are unhealthy. The default\nvalue is DEFAULT_FOR_PROTOCOL.\n\nIf set to DEFAULT_FOR_PROTOCOL, the existing connections\npersist on unhealthy backends only for connection-oriented protocols\n(TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session\nAffinity is configured for 5-tuple. They do not persist forUDP.\n\nIf set to NEVER_PERSIST, after a backend becomes unhealthy,\nthe existing connections on the unhealthy backend are never persisted on\nthe unhealthy backend. They are always diverted to newly selected healthy\nbackends (unless all backends are unhealthy).\n\nIf set to ALWAYS_PERSIST, existing connections always\npersist on unhealthy backends regardless of protocol and session\naffinity. It is generally not recommended to use this mode overriding the\ndefault.\n\nFor more details, see [Connection Persistence for Network Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)\nand [Connection Persistence for Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).", +"enum": [ +"ALWAYS_PERSIST", +"DEFAULT_FOR_PROTOCOL", +"NEVER_PERSIST" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"enableStrongAffinity": { +"description": "Enable Strong Session Affinity for external passthrough Network Load\nBalancers. This option is not available publicly.", +"type": "boolean" +}, +"idleTimeoutSec": { +"description": "Specifies how long to keep a Connection Tracking entry while there is no\nmatching traffic (in seconds).\n\nFor internal passthrough Network Load Balancers:\n \n - The minimum (default) is 10 minutes and the maximum is 16 hours.\n - It can be set only if Connection Tracking is less than 5-tuple\n (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking\n Mode is PER_SESSION).\n\n\n\nFor external passthrough Network Load Balancers the default is 60\nseconds. This option is not available publicly.", +"format": "int32", +"type": "integer" +}, +"trackingMode": { +"description": "Specifies the key used for connection tracking. There are two\noptions:\n \n - PER_CONNECTION: This is the default mode. The Connection\n Tracking is performed as per the Connection Key (default Hash Method) for\n the specific protocol.\n - PER_SESSION: The Connection Tracking is performed as per\n the configured Session Affinity. It matches the configured Session\n Affinity.\n\n\n\nFor more details, see [Tracking Mode for Network Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)\nand [Tracking Mode for Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).", +"enum": [ +"INVALID_TRACKING_MODE", +"PER_CONNECTION", +"PER_SESSION" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceCustomMetric": { +"description": "Custom Metrics are used for WEIGHTED_ROUND_ROBIN\nlocality_lb_policy.", +"id": "BackendServiceCustomMetric", +"properties": { +"dryRun": { +"description": "If true, the metric data is not used for load balancing.", +"type": "boolean" +}, +"name": { +"description": "Name of a custom utilization signal. The name must be 1-64 characters\nlong and match the regular expression\n`[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the\nfirst character must be a lowercase letter, and all following\ncharacters must be a dash, period, underscore, lowercase letter, or\ndigit, except the last character, which cannot be a dash, period, or\nunderscore. For usage guidelines, see Custom Metrics balancing mode. This\nfield can only be used for a global or regional backend service with the\nloadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceFailoverPolicy": { +"description": "For load balancers that have configurable\nfailover:\n[Internal passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nOn failover or failback, this field indicates whether connection draining\nwill be honored. Google Cloud has a fixed connection draining timeout of\n10 minutes. A setting of true terminates existing TCP\nconnections to the active pool during failover and failback, immediately\ndraining traffic. A setting of false allows existing TCP\nconnections to persist, even on VMs no longer in the active pool, for up\nto the duration of the connection draining timeout (10 minutes).", +"id": "BackendServiceFailoverPolicy", +"properties": { +"disableConnectionDrainOnFailover": { +"description": "This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.\n\nThe default is false.", +"type": "boolean" +}, +"dropTrafficIfUnhealthy": { +"description": "If set to true, connections to the\nload balancer are dropped when all primary and all backup backend VMs are\nunhealthy.If set to false, connections are distributed\namong all primary VMs when all primary and all backup backend VMs are\n unhealthy.\nFor load balancers that have configurable\nfailover:\n[Internal passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nThe default is false.", +"type": "boolean" +}, +"failoverRatio": { +"description": "The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a\nfailover when the number of healthy primary VMs equals zero.\nFor all other values, the load balancer performs a failover when the\ntotal number of healthy primary VMs is less than this ratio.\nFor load balancers that have configurable\nfailover:\n[Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", +"format": "float", +"type": "number" +} +}, +"type": "object" +}, +"BackendServiceGroupHealth": { +"id": "BackendServiceGroupHealth", +"properties": { +"annotations": { +"additionalProperties": { +"type": "string" +}, +"description": "Metadata defined as annotations on the network endpoint group.", +"type": "object" +}, +"healthStatus": { +"description": "Health state of the backend instances or endpoints in requested instance or\nnetwork endpoint group, determined based on configured health checks.", +"items": { +"$ref": "HealthStatus" +}, +"type": "array" +}, +"kind": { +"default": "compute#backendServiceGroupHealth", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend\nservices.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceHAPolicy": { +"id": "BackendServiceHAPolicy", +"properties": { +"fastIPMove": { +"description": "Specifies whether fast IP move is enabled, and if so, the mechanism to\nachieve it.\n\nSupported values are:\n \n - DISABLED: Fast IP Move is disabled. You can only use the\n haPolicy.leader API to update the leader.\n - >GARP_RA: Provides a method to very quickly define a new network\n endpoint as the leader. This method is faster than updating the leader\n using the haPolicy.leader API. Fast IP move works as follows: The VM\n hosting the network endpoint that should become the new leader sends\n either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router\n Advertisement(RA) packet (IPv6). Google Cloud immediately but\n temporarily associates the forwarding rule IP address with that VM, and\n both new and in-flight packets are quickly delivered to that VM.\n\n\n\nNote the important properties of the Fast IP Move functionality:\n \n - The GARP/RA-initiated re-routing stays active for approximately 20\n minutes. After triggering fast failover, you must also\n appropriately set the haPolicy.leader.\n - The new leader instance should continue to send GARP/RA packets\n periodically every 10 seconds until at least 10 minutes after updating\n the haPolicy.leader (but stop immediately if it is no longer the leader).\n - After triggering a fast failover, we recommend that you wait at least\n 3 seconds before sending another GARP/RA packet from a different VM\n instance to avoid race conditions.\n - Don't send GARP/RA packets from different VM\n instances at the same time. If multiple instances continue to send\n GARP/RA packets, traffic might be routed to different destinations in an\n alternating order. This condition ceases when a single instance\n issues a GARP/RA packet.\n - The GARP/RA request always takes priority over the leader API.\n Using the haPolicy.leader API to change the leader to a different\n instance will have no effect until the GARP/RA request becomes\n inactive.\n - The GARP/RA packets should follow the GARP/RA\n Packet Specifications..\n - When multiple forwarding rules refer to a regional backend service,\n you need only send a GARP or RA packet for a single forwarding rule\n virtual IP. The virtual IPs for all forwarding rules targeting the same\n backend service will also be moved to the sender of the GARP or RA\n packet. \n\n\n\nThe following are the Fast IP Move limitations (that is, when fastIPMove\nis not DISABLED):\n \n - Multiple forwarding rules cannot use the same IP address if one of\n them refers to a regional backend service with fastIPMove.\n - The regional backend service must set the network field, and all\n NEGs must belong to that network. However, individual\n NEGs can belong to different subnetworks of that network. \n - The maximum number of network endpoints across all backends of a\n backend service with fastIPMove is 32.\n - The maximum number of backend services with fastIPMove that can have\n the same network endpoint attached to one of its backends is 64.\n - The maximum number of backend services with fastIPMove in a VPC in a\n region is 64.\n - The network endpoints that are attached to a backend of a backend\n service with fastIPMove cannot resolve to Gen3+ machines for IPv6.\n - Traffic directed to the leader by a static route next hop will not be\n redirected to a new leader by fast failover. Such traffic will only be\n redirected once an haPolicy.leader update has taken effect. Only traffic\n to the forwarding rule's virtual IP will be redirected to a new leader by\n fast failover.\n\n\nhaPolicy.fastIPMove can be set only at backend service creation time.\nOnce set, it cannot be updated.\n\nBy default, fastIpMove is set to DISABLED.", +"enum": [ +"DISABLED", +"GARP_RA" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"leader": { +"$ref": "BackendServiceHAPolicyLeader", +"description": "Selects one of the network endpoints attached to the backend NEGs of\nthis service as the active endpoint (the leader) that receives all\ntraffic.\n\nWhen the leader changes, there is no connection draining to persist\nexisting connections on the old leader.\n\nYou are responsible for selecting a suitable endpoint as the\nleader. For example, preferring a healthy endpoint over unhealthy ones.\nNote that this service does not track backend endpoint health, and\nselects the configured leader unconditionally." +} +}, +"type": "object" +}, +"BackendServiceHAPolicyLeader": { +"id": "BackendServiceHAPolicyLeader", +"properties": { +"backendGroup": { +"description": "A fully-qualified URL (starting with https://www.googleapis.com/)\nof the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints\nthat the leader is attached to.\n\nThe leader's backendGroup must already be specified as a backend of\nthis backend service. Removing a backend that is designated as the\nleader's backendGroup is not permitted.", +"type": "string" +}, +"networkEndpoint": { +"$ref": "BackendServiceHAPolicyLeaderNetworkEndpoint", +"description": "The network endpoint within the leader.backendGroup that is\ndesignated as the leader.\n\nThis network endpoint cannot be detached from the NEG specified in\nthe haPolicy.leader.backendGroup until the leader is updated with\nanother network endpoint, or the leader is removed from the haPolicy." +} +}, +"type": "object" +}, +"BackendServiceHAPolicyLeaderNetworkEndpoint": { +"id": "BackendServiceHAPolicyLeaderNetworkEndpoint", +"properties": { +"instance": { +"description": "The name of the VM instance of the leader network endpoint. The\ninstance must already be attached to the NEG specified in the\nhaPolicy.leader.backendGroup.\n\nThe value must be a valid RFC1035 name (1-63 characters) or a valid\ninstance URL.\nAuthorization requires the following IAM permission on the\nspecified resource instance: compute.instances.use", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceHttpCookie": { +"description": "The HTTP cookie used for stateful session affinity.", +"id": "BackendServiceHttpCookie", +"properties": { +"name": { +"description": "Name of the cookie.", +"type": "string" +}, +"path": { +"description": "Path to set for the cookie.", +"type": "string" +}, +"ttl": { +"$ref": "Duration", +"description": "Lifetime of the cookie." +} +}, +"type": "object" +}, +"BackendServiceIAP": { +"description": "Identity-Aware Proxy", +"id": "BackendServiceIAP", +"properties": { +"enabled": { +"description": "Whether the serving infrastructure will authenticate and authorize all\nincoming requests.", +"type": "boolean" +}, +"oauth2ClientId": { +"description": "OAuth2 client ID to use for the authentication flow.", +"type": "string" +}, +"oauth2ClientSecret": { +"description": "OAuth2 client secret to use for the authentication flow.\nFor security reasons, this value cannot be retrieved via the API.\nInstead, the SHA-256 hash of the value is returned in the\noauth2ClientSecretSha256 field.\n\n@InputOnly", +"type": "string" +}, +"oauth2ClientSecretSha256": { +"description": "Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceList": { +"description": "Contains a list of BackendService resources.", +"id": "BackendServiceList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of BackendService resources.", +"items": { +"$ref": "BackendService" +}, +"type": "array" +}, +"kind": { +"default": "compute#backendServiceList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services.", +"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.", +"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" +}, +"BackendServiceListUsable": { +"description": "Contains a list of usable BackendService resources.", +"id": "BackendServiceListUsable", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of BackendService resources.", +"items": { +"$ref": "BackendService" +}, +"type": "array" +}, +"kind": { +"default": "compute#usableBackendServiceList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend\nservices.", +"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.", +"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" +}, +"BackendServiceLocalityLoadBalancingPolicyConfig": { +"description": "Container for either a built-in LB policy supported by gRPC or Envoy or\na custom one implemented by the end user.", +"id": "BackendServiceLocalityLoadBalancingPolicyConfig", +"properties": { +"customPolicy": { +"$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" +}, +"policy": { +"$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" +} +}, +"type": "object" +}, +"BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { +"description": "The configuration for a custom policy implemented by the user and\ndeployed with the client.", +"id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", +"properties": { +"data": { +"description": "An optional, arbitrary JSON object with configuration data, understood\nby a locally installed custom policy implementation.", +"type": "string" +}, +"name": { +"description": "Identifies the custom policy.\n\nThe value should match the name of a custom implementation registered\non the gRPC clients. It should follow protocol buffer message naming\nconventions and include the full path (for example,\nmyorg.CustomLbPolicy). The maximum length is 256 characters.\n\nDo not specify the same custom policy more than once for a\nbackend. If you do, the configuration is rejected.\n\nFor an example of how to use this field, seeUse\na custom policy.", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { +"description": "The configuration for a built-in load balancing policy.", +"id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", +"properties": { +"name": { +"description": "The name of a locality load-balancing policy. Valid values include\nROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information\nabout these values, see the description of localityLbPolicy.\n\nDo not specify the same policy more than once for a\nbackend. If you do, the configuration is rejected.", +"enum": [ +"INVALID_LB_POLICY", +"LEAST_REQUEST", +"MAGLEV", +"ORIGINAL_DESTINATION", +"RANDOM", +"RING_HASH", +"ROUND_ROBIN", +"WEIGHTED_GCP_RENDEZVOUS", +"WEIGHTED_MAGLEV", +"WEIGHTED_ROUND_ROBIN" +], +"enumDescriptions": [ +"", +"An O(1) algorithm which selects two random healthy hosts and\npicks the host which has fewer active requests.", +"This algorithm implements consistent hashing to backends. Maglev can be\nused as a drop in replacement for the ring hash load balancer. Maglev is\nnot as stable as ring hash but has faster table lookup build times and\nhost selection times. For more information about Maglev, seeMaglev:\nA Fast and Reliable Software Network Load Balancer.", +"Backend host is selected based on the client connection metadata, i.e.,\nconnections are opened to the same address as the destination address of\nthe incoming connection before the connection was redirected to the load\nbalancer.", +"The load balancer selects a random healthy host.", +"The ring/modulo hash load balancer implements consistent hashing to\nbackends. The algorithm has the property that the addition/removal\nof a host from a set of N hosts only affects 1/N of the requests.", +"This is a simple policy in which each healthy backend is selected\nin round robin order. This is the default.", +"Per-instance weighted Load Balancing via health check reported weights.\nIn internal passthrough network load balancing, it is weighted\nrendezvous hashing.\nThis option is only supported in internal passthrough network load\nbalancing.", +"Per-instance weighted Load Balancing via health check reported weights.\nIf set, the Backend Service must configure a non legacy HTTP-based Health\nCheck, and health check replies are expected to contain non-standard HTTP\nresponse header field X-Load-Balancing-Endpoint-Weight to specify the\nper-instance weights.\nIf set, Load Balancing is weighted based on the\nper-instance weights reported in the last processed health check replies,\nas long as every instance either reported a valid weight or had\nUNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight.\nThis option is only supported in Network Load Balancing.", +"Per-endpoint weighted round-robin Load Balancing using weights computed\nfrom Backend reported Custom Metrics. If set, the Backend Service\nresponses are expected to contain non-standard HTTP response header field\nEndpoint-Load-Metrics. The reported metrics\nto use for computing the weights are specified via the\ncustomMetrics fields." +], +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceLogConfig": { +"description": "The available logging options for the load balancer traffic served by this\nbackend service.", +"id": "BackendServiceLogConfig", +"properties": { +"enable": { +"description": "Denotes whether to enable logging for the load balancer\ntraffic served by this backend service. The default value is false.", +"type": "boolean" +}, +"loggingHttpRequestHeaders": { +"description": "The list of request headers that will be logged to Stackdriver.", +"items": { +"$ref": "BackendServiceLogConfigLoggingHttpHeader" +}, +"type": "array" +}, +"loggingHttpResponseHeaders": { +"description": "The list of response headers that will be logged to Stackdriver.", +"items": { +"$ref": "BackendServiceLogConfigLoggingHttpHeader" +}, +"type": "array" +}, +"optionalFields": { +"description": "This field can only be specified if logging is enabled for this backend\nservice and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list\nof optional fields you want to include in the logs. For example:\nserverInstance, serverGkeDetails.cluster,\nserverGkeDetails.pod.podNamespace", +"items": { +"type": "string" +}, +"type": "array" +}, +"optionalMode": { +"description": "This field can only be specified if logging is enabled for this backend\nservice. Configures whether all, none or a subset of optional fields\nshould be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,\nEXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.", +"enum": [ +"CUSTOM", +"EXCLUDE_ALL_OPTIONAL", +"INCLUDE_ALL_OPTIONAL" +], +"enumDescriptions": [ +"A subset of optional fields.", +"None optional fields.", +"All optional fields." +], +"type": "string" +}, +"sampleRate": { +"description": "This field can only be specified if logging is enabled for this backend\nservice. The value of the field must be in [0, 1]. This configures the\nsampling rate of requests to the load balancer where 1.0 means all logged\nrequests are reported and 0.0 means no logged requests are reported. The\ndefault value is 1.0.", +"format": "float", +"type": "number" +} +}, +"type": "object" +}, +"BackendServiceLogConfigLoggingHttpHeader": { +"description": "Determines which HTTP headers will be logged to Stackdriver.", +"id": "BackendServiceLogConfigLoggingHttpHeader", +"properties": { +"headerName": { +"description": "The name of the header to be logged.", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceNetworkPassThroughLbTrafficPolicy": { +"id": "BackendServiceNetworkPassThroughLbTrafficPolicy", +"properties": { +"zonalAffinity": { +"$ref": "BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity", +"description": "When configured, new connections are load balanced across healthy backend\nendpoints in the local zone." +} +}, +"type": "object" +}, +"BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity": { +"id": "BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity", +"properties": { +"spillover": { +"description": "This field indicates whether zonal affinity is enabled or not. The\npossible values are:\n \n - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity\n is disabled. The load balancer distributes new connections to all\n healthy backend endpoints across all zones.\n - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is\n enabled. The load balancer distributes new connections to all healthy\n backend endpoints in the local zone only. If there are no healthy\n backend endpoints in the local zone, the load balancer distributes\n new connections to all backend endpoints in the local zone.\n - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is\n enabled. The load balancer distributes new connections to all healthy\n backend endpoints in the local zone only. If there aren't enough\n healthy backend endpoints in the local zone, the load balancer\n distributes new connections to all healthy backend endpoints across all\n zones.", +"enum": [ +"ZONAL_AFFINITY_DISABLED", +"ZONAL_AFFINITY_SPILL_CROSS_ZONE", +"ZONAL_AFFINITY_STAY_WITHIN_ZONE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"spilloverRatio": { +"description": "The value of the field must be in [0, 1]. When the ratio of the count\nof healthy backend endpoints in a zone to the count of backend\nendpoints in that same zone is equal to or above this threshold, the\nload balancer distributes new connections to all healthy endpoints in\nthe local zone only. When the ratio of the count of healthy backend\nendpoints in a zone to the count of backend endpoints in that same\nzone is below this threshold, the load balancer distributes all new\nconnections to all healthy endpoints across all zones.", +"format": "float", +"type": "number" +} +}, +"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", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"BackendServiceReference": { +"id": "BackendServiceReference", +"properties": { +"backendService": { +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceTlsSettings": { +"id": "BackendServiceTlsSettings", +"properties": { +"authenticationConfig": { +"description": "Reference to the BackendAuthenticationConfig resource from the\nnetworksecurity.googleapis.com namespace. Can be used in authenticating\nTLS connections to the backend, as specified by the authenticationMode\nfield. Can only be specified if authenticationMode is not NONE.", +"type": "string" +}, +"identity": { +"description": "Assigns the Managed Identity for the BackendService Workload.\n\n\nUse this property to configure the load balancer back-end to use\ncertificates and roots of trust provisioned by the Managed Workload\nIdentity system. \n\n The `identity` property is the\nfully-specified SPIFFE ID to use in the SVID presented by the Load\nBalancer Workload. \n\n The SPIFFE ID must be a resource starting with the\n`trustDomain` property value, followed by the path to the Managed\nWorkload Identity. \n\n Supported SPIFFE ID format: \n \n - ///ns//sa/\n\n\nThe Trust Domain within the Managed Identity must refer to a valid\nWorkload Identity Pool. The TrustConfig and CertificateIssuanceConfig\nwill be inherited from the Workload Identity Pool. \n\n Restrictions: \n \n - If you set the `identity` property, you cannot manually set\n the following fields: \n - tlsSettings.sni\n - tlsSettings.subjectAltNames\n - tlsSettings.authenticationConfig\n \n\nWhen defining a `identity` for a RegionBackendServices, the\ncorresponding Workload Identity Pool must have a ca_pool\nconfigured in the same region. \n\n The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.", +"type": "string" +}, +"sni": { +"description": "Server Name Indication - see RFC3546 section 3.1. If set, the load\nbalancer sends this string as the SNI hostname in the TLS connection to\nthe backend, and requires that this string match a Subject Alternative\nName (SAN) in the backend's server certificate. With a Regional Internet\nNEG backend, if the SNI is specified here, the load balancer uses it\nregardless of whether the Regional Internet NEG is specified with FQDN or\nIP address and port. When both sni and subjectAltNames[] are specified,\nthe load balancer matches the backend certificate's SAN only to\nsubjectAltNames[].", +"type": "string" +}, +"subjectAltNames": { +"description": "A list of Subject Alternative Names (SANs) that the Load Balancer\nverifies during a TLS handshake with the backend. When the server\npresents its X.509 certificate to the Load Balancer, the Load Balancer\ninspects the certificate's SAN field, and requires that at least one SAN\nmatch one of the subjectAltNames in the list. This field is limited to 5\nentries. When both sni and subjectAltNames[] are specified, the load\nbalancer matches the backend certificate's SAN only to subjectAltNames[].", +"items": { +"$ref": "BackendServiceTlsSettingsSubjectAltName" +}, +"type": "array" +} +}, +"type": "object" +}, +"BackendServiceTlsSettingsSubjectAltName": { +"description": "A Subject Alternative Name that the load balancer matches against the SAN\nfield in the TLS certificate provided by the backend, specified as either\na DNS name or a URI, in accordance with RFC 5280 4.2.1.6", +"id": "BackendServiceTlsSettingsSubjectAltName", +"properties": { +"dnsName": { +"description": "The SAN specified as a DNS Name.", +"type": "string" +}, +"uniformResourceIdentifier": { +"description": "The SAN specified as a URI.", +"type": "string" +} +}, +"type": "object" +}, +"BackendServiceUsedBy": { +"id": "BackendServiceUsedBy", +"properties": { +"reference": { +"description": "Output only. [Output Only] Server-defined URL for resources referencing given\nBackendService like UrlMaps, TargetTcpProxies, TargetSslProxies\nand ForwardingRule.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BackendServicesScopedList": { +"id": "BackendServicesScopedList", +"properties": { +"backendServices": { +"description": "A list of BackendServices contained in this scope.", +"items": { +"$ref": "BackendService" +}, +"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.", +"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" +}, +"BfdPacket": { +"id": "BfdPacket", +"properties": { +"authenticationPresent": { +"description": "The Authentication Present bit of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"type": "boolean" +}, +"controlPlaneIndependent": { +"description": "The Control Plane Independent bit of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"type": "boolean" +}, +"demand": { +"description": "The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880", +"type": "boolean" +}, +"diagnostic": { +"description": "The diagnostic code specifies the local system's reason for the last change\nin session state. This allows remote systems to determine the reason that\nthe previous session failed, for example. These diagnostic codes are\nspecified in section 4.1 ofRFC5880", +"enum": [ +"ADMINISTRATIVELY_DOWN", +"CONCATENATED_PATH_DOWN", +"CONTROL_DETECTION_TIME_EXPIRED", +"DIAGNOSTIC_UNSPECIFIED", +"ECHO_FUNCTION_FAILED", +"FORWARDING_PLANE_RESET", +"NEIGHBOR_SIGNALED_SESSION_DOWN", +"NO_DIAGNOSTIC", +"PATH_DOWN", +"REVERSE_CONCATENATED_PATH_DOWN" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"final": { +"description": "The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880", +"type": "boolean" +}, +"length": { +"description": "The length of the BFD Control packet in bytes. This is specified in section\n4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"minEchoRxIntervalMs": { +"description": "The Required Min Echo RX Interval value in the BFD packet. This is\nspecified in section 4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"minRxIntervalMs": { +"description": "The Required Min RX Interval value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"minTxIntervalMs": { +"description": "The Desired Min TX Interval value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"multiplier": { +"description": "The detection time multiplier of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"multipoint": { +"description": "The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880", +"type": "boolean" +}, +"myDiscriminator": { +"description": "The My Discriminator value in the BFD packet. This is specified in section\n4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +}, +"poll": { +"description": "The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880", +"type": "boolean" +}, +"state": { +"description": "The current BFD session state as seen by the transmitting system. These\nstates are specified in section 4.1 ofRFC5880", +"enum": [ +"ADMIN_DOWN", +"DOWN", +"INIT", +"STATE_UNSPECIFIED", +"UP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"version": { +"description": "The version number of the BFD protocol, as specified in section 4.1 ofRFC5880.", +"format": "uint32", +"type": "integer" +}, +"yourDiscriminator": { +"description": "The Your Discriminator value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"BfdStatus": { +"description": "Next free: 15", +"id": "BfdStatus", +"properties": { +"bfdSessionInitializationMode": { +"description": "The BFD session initialization mode for this BGP peer.\nIf set to ACTIVE, the Cloud Router will initiate the BFD session for\nthis BGP peer. If set to PASSIVE, the Cloud Router will wait for the\npeer router to initiate the BFD session for this BGP peer. If set to\nDISABLED, BFD is disabled for this BGP peer.", +"enum": [ +"ACTIVE", +"DISABLED", +"PASSIVE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"configUpdateTimestampMicros": { +"description": "Unix timestamp of the most recent config update.", +"format": "int64", +"type": "string" +}, +"controlPacketCounts": { +"$ref": "BfdStatusPacketCounts", +"description": "Control packet counts for the current BFD session." +}, +"controlPacketIntervals": { +"description": "Inter-packet time interval statistics for control packets.", +"items": { +"$ref": "PacketIntervals" +}, +"type": "array" +}, +"localDiagnostic": { +"description": "The diagnostic code specifies the local system's reason for the last change\nin session state. This allows remote systems to determine the reason that\nthe previous session failed, for example. These diagnostic codes are\nspecified in section 4.1 ofRFC5880", +"enum": [ +"ADMINISTRATIVELY_DOWN", +"CONCATENATED_PATH_DOWN", +"CONTROL_DETECTION_TIME_EXPIRED", +"DIAGNOSTIC_UNSPECIFIED", +"ECHO_FUNCTION_FAILED", +"FORWARDING_PLANE_RESET", +"NEIGHBOR_SIGNALED_SESSION_DOWN", +"NO_DIAGNOSTIC", +"PATH_DOWN", +"REVERSE_CONCATENATED_PATH_DOWN" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"localState": { +"description": "The current BFD session state as seen by the transmitting system. These\nstates are specified in section 4.1 ofRFC5880", +"enum": [ +"ADMIN_DOWN", +"DOWN", +"INIT", +"STATE_UNSPECIFIED", +"UP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"negotiatedLocalControlTxIntervalMs": { +"description": "Negotiated transmit interval for control packets.", +"format": "uint32", +"type": "integer" +}, +"rxPacket": { +"$ref": "BfdPacket", +"description": "The most recent Rx control packet for this BFD session." +}, +"txPacket": { +"$ref": "BfdPacket", +"description": "The most recent Tx control packet for this BFD session." +}, +"uptimeMs": { +"description": "Session uptime in milliseconds. Value will be 0 if session is not up.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"BfdStatusPacketCounts": { +"id": "BfdStatusPacketCounts", +"properties": { +"numRx": { +"description": "Number of packets received since the beginning of the current BFD\nsession.", +"format": "uint32", +"type": "integer" +}, +"numRxRejected": { +"description": "Number of packets received that were rejected because of errors since the\nbeginning of the current BFD session.", +"format": "uint32", +"type": "integer" +}, +"numRxSuccessful": { +"description": "Number of packets received that were successfully processed since the\nbeginning of the current BFD session.", +"format": "uint32", +"type": "integer" +}, +"numTx": { +"description": "Number of packets transmitted since the beginning of the current BFD\nsession.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"BgpRoute": { +"id": "BgpRoute", +"properties": { +"asPaths": { +"description": "Output only. [Output only] AS-PATH for the route", +"items": { +"$ref": "BgpRouteAsPath" +}, +"readOnly": true, +"type": "array" +}, +"communities": { +"description": "Output only. [Output only] BGP communities in human-readable A:B format.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"destination": { +"$ref": "BgpRouteNetworkLayerReachabilityInformation", +"description": "Output only. [Output only] Destination IP range for the route, in human-readable CIDR\nformat", +"readOnly": true +}, +"med": { +"description": "Output only. [Output only] BGP multi-exit discriminator", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"origin": { +"description": "Output only. [Output only] BGP origin (EGP, IGP or INCOMPLETE)", +"enum": [ +"BGP_ORIGIN_EGP", +"BGP_ORIGIN_IGP", +"BGP_ORIGIN_INCOMPLETE" +], +"enumDescriptions": [ +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BgpRouteAsPath": { +"id": "BgpRouteAsPath", +"properties": { +"asns": { +"description": "Output only. [Output only] ASNs in the path segment. When type is SEQUENCE, these are\nordered.", +"items": { +"format": "int32", +"type": "integer" +}, +"readOnly": true, +"type": "array" +}, +"asns32": { +"description": "Output only. [Output only] ASNs in the path segment. This field is for better\nsupport of 32 bit ASNs as the other asns field suffers from overflow when\nthe ASN is larger. When type is SEQUENCE, these are ordered.", +"items": { +"format": "uint32", +"type": "integer" +}, +"readOnly": true, +"type": "array" +}, +"type": { +"description": "Output only. [Output only] Type of AS-PATH segment (SEQUENCE or SET)", +"enum": [ +"AS_PATH_TYPE_SEQUENCE", +"AS_PATH_TYPE_SET" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BgpRouteNetworkLayerReachabilityInformation": { +"description": "Network Layer Reachability Information (NLRI) for a route.", +"id": "BgpRouteNetworkLayerReachabilityInformation", +"properties": { +"pathId": { +"description": "If the BGP session supports multiple paths (RFC 7911), the path\nidentifier for this route.", +"format": "uint32", +"type": "integer" +}, +"prefix": { +"description": "Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16.", +"type": "string" +} +}, +"type": "object" +}, +"Binding": { +"description": "Associates `members`, or principals, with a `role`.", +"id": "Binding", +"properties": { +"condition": { +"$ref": "Expr", +"description": "The condition that is associated with this binding.\n\nIf the condition evaluates to `true`, then this binding applies to the\ncurrent request.\n\nIf the condition evaluates to `false`, then this binding does not apply to\nthe current request. However, a different role binding might grant the same\nrole to one or more of the principals in this binding.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies)." +}, +"members": { +"description": "Specifies the principals requesting access for a Google Cloud resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n Does not include identities that come from external identity providers\n (IdPs) through identity federation.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@example.com` .\n\n\n* `serviceAccount:{emailid}`: An email address that represents a Google\n service account. For example,\n `my-other-app@appspot.gserviceaccount.com`.\n\n* `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An\n identifier for a\n [Kubernetes service\n account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).\n For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n\n* `domain:{domain}`: The G Suite domain (primary) that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n\n\n\n* `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:\n A single identity in a workforce identity pool.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:\n All workforce identities in a group.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:\n All workforce identities with a specific attribute value.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:\n All identities in a workforce identity pool.\n\n* `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:\n A single identity in a workload identity pool.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:\n A workload identity pool group.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:\n All identities in a workload identity pool with a certain attribute.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:\n All identities in a workload identity pool.\n\n* `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a user that has been recently deleted. For\n example, `alice@example.com?uid=123456789012345678901`. If the user is\n recovered, this value reverts to `user:{emailid}` and the recovered user\n retains the role in the binding.\n\n* `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus\n unique identifier) representing a service account that has been recently\n deleted. For example,\n `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.\n If the service account is undeleted, this value reverts to\n `serviceAccount:{emailid}` and the undeleted service account retains the\n role in the binding.\n\n* `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a Google group that has been recently\n deleted. For example, `admins@example.com?uid=123456789012345678901`. If\n the group is recovered, this value reverts to `group:{emailid}` and the\n recovered group retains the role in the binding.\n\n* `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:\n Deleted single identity in a workforce identity pool. For example,\n `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", +"items": { +"type": "string" +}, +"type": "array" +}, +"role": { +"description": "Role that is assigned to the list of `members`, or principals.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.\n\nFor an overview of the IAM roles and permissions, see the\n[IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For\na list of the available pre-defined roles, see\n[here](https://cloud.google.com/iam/docs/understanding-roles).", +"type": "string" +} +}, +"type": "object" +}, +"BulkInsertDiskResource": { +"description": "A transient resource used in compute.disks.bulkInsert and\ncompute.regionDisks.bulkInsert. It is only used to process\nrequests and is not persisted.", +"id": "BulkInsertDiskResource", +"properties": { +"instantSnapshotGroupParameters": { +"$ref": "InstantSnapshotGroupParameters", +"description": "The parameters for the instant snapshot group." +}, +"snapshotGroupParameters": { +"$ref": "SnapshotGroupParameters", +"description": "The parameters for the snapshot group. The usage of snapshot group feature\nis restricted." +}, +"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" +} +}, +"type": "object" +}, +"BulkInsertInstanceResource": { +"description": "A transient resource used in compute.instances.bulkInsert and\ncompute.regionInstances.bulkInsert . This resource is not persisted\nanywhere, it is used only for processing the requests.", +"id": "BulkInsertInstanceResource", +"properties": { +"count": { +"description": "The maximum number of instances to create.", +"format": "int64", +"type": "string" +}, +"instanceFlexibilityPolicy": { +"$ref": "InstanceFlexibilityPolicy", +"description": "A flexible specification of machine type of instances to create." +}, +"instanceProperties": { +"$ref": "InstanceProperties", +"description": "The instance properties defining the VM instances to be created. Required\nif sourceInstanceTemplate is not provided." +}, +"locationPolicy": { +"$ref": "LocationPolicy", +"description": "Policy for choosing target zone. For more information, seeCreate VMs in\nbulk." +}, +"minCount": { +"description": "The minimum number of instances to create. If no min_count is\nspecified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will\nbe created and instances already created will be deleted.", +"format": "int64", +"type": "string" +}, +"namePattern": { +"description": "The string pattern used for the names of the VMs.\nEither name_pattern or per_instance_properties\nmust be set. The pattern must contain one continuous sequence of\nplaceholder hash characters (#) with each character corresponding to one\ndigit of the generated instance name. Example: a name_pattern\nof inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances\nin the same project and zone have names that match the name pattern\nthen the generated instance numbers start after the biggest\nexisting number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern\nplaceholder #...# can contain up to 18 characters.", +"type": "string" +}, +"perInstanceProperties": { +"additionalProperties": { +"$ref": "BulkInsertInstanceResourcePerInstanceProperties" +}, +"description": "Per-instance properties to be set on individual instances.\nKeys of this map specify requested instance names.\nCan be empty if name_pattern is used.", +"type": "object" +}, +"sourceInstanceTemplate": { +"description": "Specifies the instance template from which to create instances. You may\ncombine sourceInstanceTemplate withinstanceProperties to override specific values from an\nexisting instance template. Bulk API follows the semantics of JSON Merge\nPatch described by RFC\n7396.\n\nIt can be a full or partial URL. For example, the following are\nall valid URLs to an instance template: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate\n\n\n\nThis field is optional.", +"type": "string" +} +}, +"type": "object" +}, +"BulkInsertInstanceResourcePerInstanceProperties": { +"description": "Per-instance properties to be set on individual instances.\nTo be extended in the future.", +"id": "BulkInsertInstanceResourcePerInstanceProperties", +"properties": { +"hostname": { +"description": "Specifies the hostname of the instance. More details in:\nhttps://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", +"type": "string" +}, +"name": { +"description": "Output only. This field is only temporary. It will be removed. Do not use it.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"BulkInsertOperationStatus": { +"id": "BulkInsertOperationStatus", +"properties": { +"createdVmCount": { +"description": "[Output Only] Count of VMs successfully created so far.", +"format": "int32", +"type": "integer" +}, +"deletedVmCount": { +"description": "[Output Only] Count of VMs that got deleted during rollback.", +"format": "int32", +"type": "integer" +}, +"failedToCreateVmCount": { +"description": "[Output Only] Count of VMs that started creating but encountered an\nerror.", +"format": "int32", +"type": "integer" +}, +"status": { +"description": "[Output Only] Creation status of BulkInsert operation - information\nif the flow is rolling forward or rolling back.", +"enum": [ +"CREATING", +"DONE", +"ROLLING_BACK", +"STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"Rolling forward - creating VMs.", +"Done", +"Rolling back - cleaning up after an error.", +"" +], +"type": "string" +}, +"targetVmCount": { +"description": "[Output Only] Count of VMs originally planned to be created.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"BulkSetLabelsRequest": { +"id": "BulkSetLabelsRequest", +"properties": { +"labelFingerprint": { +"description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You may\noptionally provide an up-to-date fingerprint hash in order to update or\nchange labels. Make a get() request to the resource to get the\nlatest fingerprint.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The labels to set for this resource.", +"type": "object" +} +}, +"type": "object" +}, +"BulkZoneSetLabelsRequest": { +"id": "BulkZoneSetLabelsRequest", +"properties": { +"requests": { +"items": { +"$ref": "BulkSetLabelsRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BundledLocalSsds": { +"id": "BundledLocalSsds", +"properties": { +"defaultInterface": { +"description": "The default disk interface if the interface is not specified.", +"type": "string" +}, +"partitionCount": { +"description": "The number of partitions.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"CacheInvalidationRule": { +"id": "CacheInvalidationRule", +"properties": { +"cacheTags": { +"description": "A list of cache tags used to identify cached objects.\n\n \n - Cache tags are specified when the response is first cached, by setting\n the `Cache-Tag` response header at the origin.\n - Multiple cache tags in the same invalidation request are treated as\n Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.\n - If other fields are also specified, these are treated as Boolean `AND`\n with any tags.\n\n\nUp to 10 tags can be specified in a single invalidation request.", +"items": { +"type": "string" +}, +"type": "array" +}, +"host": { +"description": "If set, this invalidation rule will only apply to requests with a Host\nheader matching host.", +"type": "string" +}, +"path": { +"type": "string" +} +}, +"type": "object" +}, +"CacheKeyPolicy": { +"description": "Message containing what to include in the cache key for a request for Cloud\nCDN.", +"id": "CacheKeyPolicy", +"properties": { +"includeHost": { +"description": "If true, requests to different hosts will be cached separately.", +"type": "boolean" +}, +"includeHttpHeaders": { +"description": "Allows HTTP request headers (by name) to be used in the cache key.", +"items": { +"type": "string" +}, +"type": "array" +}, +"includeNamedCookies": { +"description": "Allows HTTP cookies (by name) to be used in the cache key.\nThe name=value pair will be used in the cache key Cloud CDN generates.", +"items": { +"type": "string" +}, +"type": "array" +}, +"includeProtocol": { +"description": "If true, http and https requests will be cached separately.", +"type": "boolean" +}, +"includeQueryString": { +"description": "If true, include query string parameters in the cache key according to\nquery_string_whitelist and query_string_blacklist. If neither is set, the\nentire query string will be included. If false, the query string will be\nexcluded from the cache key entirely.", +"type": "boolean" +}, +"queryStringBlacklist": { +"description": "Names of query string parameters to exclude in cache keys. All other\nparameters will be included. Either specify query_string_whitelist or\nquery_string_blacklist, not both. '&' and '=' will be percent encoded and\nnot treated as delimiters.", +"items": { +"type": "string" +}, +"type": "array" +}, +"queryStringWhitelist": { +"description": "Names of query string parameters to include in cache keys. All other\nparameters will be excluded. Either specify query_string_whitelist or\nquery_string_blacklist, not both. '&' and '=' will be percent encoded and\nnot treated as delimiters.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"CachePolicy": { +"description": "Message containing CachePolicy configuration for URL Map's Route Action.", +"id": "CachePolicy", +"properties": { +"cacheBypassRequestHeaderNames": { +"description": "Bypass the cache when the specified request headers are matched by name,\ne.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5\nheader names can be specified. The cache is bypassed for all `cacheMode`\nvalues.", +"items": { +"type": "string" +}, +"type": "array" +}, +"cacheKeyPolicy": { +"$ref": "CachePolicyCacheKeyPolicy", +"description": "The cache key configuration. If not specified, the default behavior depends\non the backend type: for Backend Services, the complete request URI is\nused; for Backend Buckets, the request URI is used without the protocol or\nhost, and only query parameters known to Cloud Storage are included." +}, +"cacheMode": { +"description": "Specifies the cache setting for all responses from this route. If not\nspecified, Cloud CDN uses `CACHE_ALL_STATIC` mode.", +"enum": [ +"CACHE_ALL_STATIC", +"FORCE_CACHE_ALL", +"USE_ORIGIN_HEADERS" +], +"enumDescriptions": [ +"Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", +"Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", +"Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at the edge, and will\nrequire a full trip to the origin on every request, potentially impacting\nperformance and increasing load on the origin server." +], +"type": "string" +}, +"clientTtl": { +"$ref": "Duration", +"description": "Specifies a separate client (e.g. browser client) maximum TTL for cached\ncontent. This is used to clamp the max-age (or Expires) value sent to the\nclient. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`\nis used for the response max-age directive, along with a \"public\"\ndirective. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`\nclamps the max-age from the origin (if specified), or else sets the\nresponse max-age directive to the lesser of the `clientTtl` and\n`defaultTtl`, and also ensures a \"public\" cache-control directive is\npresent. The maximum allowed value is 31,622,400s (1 year). If not\nspecified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.\nCannot exceed `maxTtl`. Cannot be specified when `cacheMode` is\n`USE_ORIGIN_HEADERS`." +}, +"defaultTtl": { +"$ref": "Duration", +"description": "Specifies the default TTL for cached content for responses that do not have\nan existing valid TTL (max-age or s-maxage). Setting a TTL of \"0\" means\n\"always revalidate\". The value of `defaultTtl` cannot be set to a value\ngreater than that of `maxTtl`. When the `cacheMode` is set to\n`FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all\nresponses. The maximum allowed value is 31,622,400s (1 year). Infrequently\naccessed objects may be evicted from the cache before the defined TTL. If\nnot specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and\n`FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is\n`USE_ORIGIN_HEADERS`." +}, +"maxTtl": { +"$ref": "Duration", +"description": "Specifies the maximum allowed TTL for cached content. Cache directives that\nattempt to set a max-age or s-maxage higher than this, or an Expires header\nmore than `maxTtl` seconds in the future will be capped at the value of\n`maxTtl`, as if it were the value of an s-maxage Cache-Control directive.\nHeaders sent to the client will not be modified. Setting a TTL of \"0\" means\n\"always revalidate\". The maximum allowed value is 31,622,400s (1 year).\nInfrequently accessed objects may be evicted from the cache before the\ndefined TTL. If not specified, Cloud CDN uses 86400s (1 day) for\n`CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache\nmode." +}, +"negativeCaching": { +"description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the `cacheMode` is set to `CACHE_ALL_STATIC` or\n`USE_ORIGIN_HEADERS`, negative caching applies to responses with\nthe specified response code that lack any Cache-Control, Expires, or\nPragma: no-cache directives. When the `cacheMode` is set to\n`FORCE_CACHE_ALL`, negative caching applies to all responses\nwith the specified response code, and overrides any caching headers. By\ndefault, Cloud CDN applies the following TTLs to these HTTP status codes:\n\n* 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\n* 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s\n* 405 (Method Not Found), 501 (Not Implemented): 60s\n\nThese defaults can be overridden in `negativeCachingPolicy`.\nIf not specified, Cloud CDN applies negative caching by default.", +"type": "boolean" +}, +"negativeCachingPolicy": { +"description": "Sets a cache TTL for the specified HTTP status code.\n`negativeCaching` must be enabled to configure `negativeCachingPolicy`.\nOmitting the policy and leaving `negativeCaching` enabled will use Cloud\nCDN's default cache TTLs. Note that when specifying an explicit\n`negativeCachingPolicy`, you should take care to specify a cache TTL for\nall response codes that you wish to cache. Cloud CDN will not apply any\ndefault negative caching when a policy exists.", +"items": { +"$ref": "CachePolicyNegativeCachingPolicy" +}, +"type": "array" +}, +"requestCoalescing": { +"description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin. If not specified,\nCloud CDN applies request coalescing by default.", +"type": "boolean" +}, +"serveWhileStale": { +"$ref": "Duration", +"description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale." +} +}, +"type": "object" +}, +"CachePolicyCacheKeyPolicy": { +"description": "Message containing what to include in the cache key for a request for Cache\nPolicy defined on Route Action.", +"id": "CachePolicyCacheKeyPolicy", +"properties": { +"excludedQueryParameters": { +"description": "Names of query string parameters to exclude in cache keys. All other\nparameters will be included. Either specify `excludedQueryParameters`\nor `includedQueryParameters`, not both. '&' and '=' will be percent\nencoded and not treated as delimiters.\n\nNote: This field applies to routes that use backend services. Attempting\nto set it on a route that points exclusively to Backend Buckets will\nresult in a configuration error. For routes that point to a Backend\nBucket, use `includedQueryParameters` to define which parameters should\nbe part of the cache key.", +"items": { +"type": "string" +}, +"type": "array" +}, +"includeHost": { +"description": "If true, requests to different hosts will be cached separately.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket, as the\nhost is never included in a Backend Bucket's cache key. Attempting to set\nit on a route that points exclusively to Backend Buckets will result in a\nconfiguration error.", +"type": "boolean" +}, +"includeProtocol": { +"description": "If true, http and https requests will be cached separately.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket, as the\nprotocol is never included in a Backend Bucket's cache key. Attempting to\nset on a route that points exclusively to Backend Buckets will result in\na configuration error.", +"type": "boolean" +}, +"includeQueryString": { +"description": "If true, include query string parameters in the cache key according to\n`includedQueryParameters` and `excludedQueryParameters`. If neither\nis set, the entire query string will be included. If false, the query\nstring will be excluded from the cache key entirely.\n\nNote: This field applies to routes that use backend services. Attempting\nto set it on a route that points exclusively to Backend Buckets will\nresult in a configuration error. For routes that point to a Backend\nBucket, use `includedQueryParameters` to define which parameters should\nbe part of the cache key.", +"type": "boolean" +}, +"includedCookieNames": { +"description": "Allows HTTP cookies (by name) to be used in the cache key.\nThe name=value pair will be used in the cache key Cloud CDN generates.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket.\nAttempting to set it on a route that points exclusively to Backend\nBuckets will result in a configuration error. Up to 5 cookie names can be\nspecified.", +"items": { +"type": "string" +}, +"type": "array" +}, +"includedHeaderNames": { +"description": "Allows HTTP request headers (by name) to be used in the cache key.", +"items": { +"type": "string" +}, +"type": "array" +}, +"includedQueryParameters": { +"description": "Names of query string parameters to include in cache keys. All other\nparameters will be excluded. Either specify `includedQueryParameters`\nor `excludedQueryParameters`, not both. '&' and '=' will be percent\nencoded and not treated as delimiters.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"CachePolicyNegativeCachingPolicy": { +"description": "Specify CDN TTLs for response error codes.", +"id": "CachePolicyNegativeCachingPolicy", +"properties": { +"code": { +"description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", +"format": "int32", +"type": "integer" +}, +"ttl": { +"$ref": "Duration", +"description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes). Infrequently accessed\nobjects may be evicted from the cache before the defined TTL." +} +}, +"type": "object" +}, +"CalendarModeAdviceRequest": { +"description": "A request to recommend the best way to consume the specified resources in the\nfuture.", +"id": "CalendarModeAdviceRequest", +"properties": { +"futureResourcesSpecs": { +"additionalProperties": { +"$ref": "FutureResourcesSpec" +}, +"description": "Specification of resources to create in the future.\nThe key of the map is an arbitrary string specified by the caller.\nValue of the map is a specification of required resources and their\nconstraints. Currently only one value is allowed in this map.", +"type": "object" +} +}, +"type": "object" +}, +"CalendarModeAdviceResponse": { +"description": "A response containing the recommended way of creating the specified resources\nin the future. It contains (will contain) multiple recommendations that can\nbe analyzed by the customer and the best one can be picked.", +"id": "CalendarModeAdviceResponse", +"properties": { +"recommendations": { +"description": "Recommendations where, how and when to create the requested resources\nin order to maximize their obtainability and minimize cost.", +"items": { +"$ref": "CalendarModeRecommendation" +}, +"type": "array" +} +}, +"type": "object" +}, +"CalendarModeRecommendation": { +"description": "A single recommendation to create requested resources. Contains detailed\nrecommendations for every future resources specification specified in\nCalendarModeAdviceRequest.", +"id": "CalendarModeRecommendation", +"properties": { +"recommendationsPerSpec": { +"additionalProperties": { +"$ref": "FutureResourcesRecommendation" +}, +"description": "Recommendations for every future resource specification passed in\nCalendarModeAdviceRequest. Keys of the map correspond to keys\nspecified in the request.", +"type": "object" +} +}, +"type": "object" +}, +"CapacityAdviceRequest": { +"description": "A request to provide Assistant Scores. These scores determine VM\nobtainability and preemption likelihood.", +"id": "CapacityAdviceRequest", +"properties": { +"distributionPolicy": { +"$ref": "CapacityAdviceRequestDistributionPolicy", +"description": "Policy specifying the distribution of instances across\nzones within the requested region." +}, +"instanceFlexibilityPolicy": { +"$ref": "CapacityAdviceRequestInstanceFlexibilityPolicy", +"description": "Policy for instance selectors." +}, +"instanceProperties": { +"$ref": "CapacityAdviceRequestInstanceProperties", +"description": "Instance properties for this request." +}, +"size": { +"description": "The number of VM instances to request.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"CapacityAdviceRequestDistributionPolicy": { +"description": "Distribution policy.", +"id": "CapacityAdviceRequestDistributionPolicy", +"properties": { +"targetShape": { +"description": "Target distribution shape. You can specify the following values:ANY, ANY_SINGLE_ZONE, or BALANCED.", +"enum": [ +"ANY", +"ANY_SINGLE_ZONE", +"BALANCED", +"TARGET_SHAPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Picks zones for creating VM instances to fulfill the requested number\nof VMs within present resource constraints.", +"Creates all VM instances within a single zone. The zone is selected\nbased on the present resource constraints.", +"Prioritizes acquisition of resources, scheduling VMs in zones where\nresources are available while distributing VMs as evenly as possible\nacross selected zones to minimize the impact of zonal failure.", +"Default value, unused." +], +"type": "string" +}, +"zones": { +"description": "Zones where Capacity Advisor looks for capacity.", +"items": { +"$ref": "CapacityAdviceRequestDistributionPolicyZoneConfiguration" +}, +"type": "array" +} +}, +"type": "object" +}, +"CapacityAdviceRequestDistributionPolicyZoneConfiguration": { +"description": "Zone configuration for the distribution policy.", +"id": "CapacityAdviceRequestDistributionPolicyZoneConfiguration", +"properties": { +"zone": { +"description": "The URL of the zone. It can be a\npartial or full URL. For example, the following are valid values: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone", +"type": "string" +} +}, +"type": "object" +}, +"CapacityAdviceRequestInstanceFlexibilityPolicy": { +"description": "Specification of alternative, flexible instance configurations.", +"id": "CapacityAdviceRequestInstanceFlexibilityPolicy", +"properties": { +"instanceSelections": { +"additionalProperties": { +"$ref": "CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelection" +}, +"description": "Named instance selections to configure properties.\nThe key is an arbitrary, unique RFC1035 string that identifies the\ninstance selection.", +"type": "object" +} +}, +"type": "object" +}, +"CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelection": { +"description": "Machine specification.", +"id": "CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelection", +"properties": { +"disks": { +"description": "Local SSDs.", +"items": { +"$ref": "CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelectionAttachedDisk" +}, +"type": "array" +}, +"guestAccelerators": { +"description": "Accelerators configuration.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"machineTypes": { +"description": "Full machine-type names, e.g. \"n1-standard-16\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"rank": { +"description": "Optional. Rank when prioritizing the shape flexibilities.\nThe instance selections are considered in the ascending order of the\nrank. If not set, defaults to 0.", +"format": "int64", +"minimum": "0", +"type": "string" +} +}, +"type": "object" +}, +"CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelectionAttachedDisk": { +"description": "Attached disk configuration.", +"id": "CapacityAdviceRequestInstanceFlexibilityPolicyInstanceSelectionAttachedDisk", +"properties": { +"type": { +"description": "Specifies the type of the disk.", +"enum": [ +"DISK_TYPE_UNSPECIFIED", +"SCRATCH" +], +"enumDescriptions": [ +"Default value, unspecified disk type.", +"Scratch disk (Local SSD)." +], +"type": "string" +} +}, +"type": "object" +}, +"CapacityAdviceRequestInstanceProperties": { +"description": "Instance provisioning properties.", +"id": "CapacityAdviceRequestInstanceProperties", +"properties": { +"scheduling": { +"$ref": "CapacityAdviceRequestInstancePropertiesScheduling", +"description": "Specifies the scheduling options." +} +}, +"type": "object" +}, +"CapacityAdviceRequestInstancePropertiesScheduling": { +"description": "Defines the instance scheduling options.", +"id": "CapacityAdviceRequestInstancePropertiesScheduling", +"properties": { +"provisioningModel": { +"description": "Specifies the provisioning model.", +"enum": [ +"FLEX_START", +"RESERVATION_BOUND", +"SPOT", +"STANDARD" +], +"enumDescriptions": [ +"Instance is provisioned using the Flex Start provisioning model and\nhas a limited runtime.", +"Bound to the lifecycle of the reservation in which it is provisioned.", +"Heavily discounted, no guaranteed runtime.", +"Standard provisioning with user controlled runtime, no discounts." +], +"type": "string" +} +}, +"type": "object" +}, +"CapacityAdviceResponse": { +"description": "A response contains scoring recommendations.", +"id": "CapacityAdviceResponse", +"properties": { +"recommendations": { +"description": "Initially the API will provide one recommendation which balances the\nindividual scores according to the service provider's preference.", +"items": { +"$ref": "CapacityAdviceResponseRecommendation" +}, +"type": "array" +} +}, +"type": "object" +}, +"CapacityAdviceResponseRecommendation": { +"description": "Recommendation.", +"id": "CapacityAdviceResponseRecommendation", +"properties": { +"scores": { +"$ref": "CapacityAdviceResponseRecommendationScores", +"description": "Scores for the recommendation." +}, +"shards": { +"description": "Shards represent blocks of uniform capacity in recommendations.", +"items": { +"$ref": "CapacityAdviceResponseRecommendationShard" +}, +"type": "array" +} +}, +"type": "object" +}, +"CapacityAdviceResponseRecommendationScores": { +"description": "Groups information about a shard of capacity.", +"id": "CapacityAdviceResponseRecommendationScores", +"properties": { +"estimatedUptime": { +"description": "The estimated run time of the majority of Spot VMs in the request\nbefore preemption. The estimate is best-effort only. It is based on\nhistorical data and current conditions.", +"format": "google-duration", +"type": "string" +}, +"obtainability": { +"description": "The obtainability score indicates the likelihood of successfully\nobtaining (provisioning) the requested number of VMs.\nThe score range is 0.0 through 1.0. Higher is better.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"CapacityAdviceResponseRecommendationShard": { +"description": "Shards represent blocks of uniform capacity in recommendations.\nEach shard is for a single zone and a single machine shape. Each shard\ndefines a size expressed as the number of VMs.", +"id": "CapacityAdviceResponseRecommendationShard", +"properties": { +"instanceCount": { +"description": "The number of instances.", +"format": "int32", +"type": "integer" +}, +"machineType": { +"description": "The machine type corresponds to the instance selection in the request.", +"type": "string" +}, +"provisioningModel": { +"description": "The provisioning model that you want to view recommendations for.", +"enum": [ +"FLEX_START", +"RESERVATION_BOUND", +"SPOT", +"STANDARD" +], +"enumDescriptions": [ +"Instance is provisioned using the Flex Start provisioning model and\nhas a limited runtime.", +"Bound to the lifecycle of the reservation in which it is provisioned.", +"Heavily discounted, no guaranteed runtime.", +"Standard provisioning with user controlled runtime, no discounts." +], +"type": "string" +}, +"zone": { +"description": "Output only. The zone name for this shard.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"CapacityHistoryRequest": { +"description": "A request to get the capacity history.", +"id": "CapacityHistoryRequest", +"properties": { +"instanceProperties": { +"$ref": "CapacityHistoryRequestInstanceProperties", +"description": "Instance properties for this request." +}, +"locationPolicy": { +"$ref": "CapacityHistoryRequestLocationPolicy", +"description": "Location policy for this request." +}, +"types": { +"description": "List of history types to get capacity history for.", +"items": { +"enum": [ +"HISTORY_TYPE_UNSPECIFIED", +"PREEMPTION", +"PRICE" +], +"enumDescriptions": [ +"Default value, unused.", +"Preemption history.", +"Price history." +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"CapacityHistoryRequestInstanceProperties": { +"description": "Instance properties for this request.", +"id": "CapacityHistoryRequestInstanceProperties", +"properties": { +"disks": { +"description": "Local SSDs.", +"items": { +"$ref": "CapacityHistoryRequestInstancePropertiesAttachedDisk" +}, +"type": "array" +}, +"guestAccelerators": { +"description": "Accelerators configuration.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"machineType": { +"description": "The machine type for the VM, such as `n2-standard-4`.", +"type": "string" +}, +"scheduling": { +"$ref": "CapacityHistoryRequestInstancePropertiesScheduling", +"description": "Specifies the scheduling options." +} +}, +"type": "object" +}, +"CapacityHistoryRequestInstancePropertiesAttachedDisk": { +"description": "AttachedDisk modeled after Instance's AttachedDisk.", +"id": "CapacityHistoryRequestInstancePropertiesAttachedDisk", +"properties": { +"type": { +"description": "Specifies the type of the disk.", +"enum": [ +"DISK_TYPE_UNSPECIFIED", +"SCRATCH" +], +"enumDescriptions": [ +"Default value, unused.", +"Scratch disk (Local SSD)." +], +"type": "string" +} +}, +"type": "object" +}, +"CapacityHistoryRequestInstancePropertiesScheduling": { +"description": "Scheduling options.", +"id": "CapacityHistoryRequestInstancePropertiesScheduling", +"properties": { +"provisioningModel": { +"description": "The provisioning model to get capacity history for.\nThis field must be set to SPOT.\n\nFor more information, see\nCompute Engine instances provisioning models.", +"enum": [ +"FLEX_START", +"RESERVATION_BOUND", +"SPOT", +"STANDARD" +], +"enumDescriptions": [ +"Instance is provisioned using the Flex Start provisioning model and\nhas a limited runtime.", +"Bound to the lifecycle of the reservation in which it is provisioned.", +"Heavily discounted, no guaranteed runtime.", +"Standard provisioning with user controlled runtime, no discounts." +], +"type": "string" +} +}, +"type": "object" +}, +"CapacityHistoryRequestLocationPolicy": { +"description": "Location policy for this request.", +"id": "CapacityHistoryRequestLocationPolicy", +"properties": { +"location": { +"description": "The region or zone to get capacity history for.\n\nIt can be a partial or full URL. For example, the following are valid\nvalues: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone\n\n\n\nThis field is optional.", +"type": "string" +} +}, +"type": "object" +}, +"CapacityHistoryResponse": { +"description": "Contains the capacity history.", +"id": "CapacityHistoryResponse", +"properties": { +"location": { +"description": "Output only. The location (region or zone) for which the capacity history is returned.\nIt is returned as a URL - For example,https://www.googleapis.com/compute/v1/projects/project/zones/zone.", +"readOnly": true, +"type": "string" +}, +"machineType": { +"description": "The machine type for which the capacity history is returned.", +"type": "string" +}, +"preemptionHistory": { +"description": "The preemption history for the requested machine type and location.", +"items": { +"$ref": "CapacityHistoryResponsePreemptionRecord" +}, +"type": "array" +}, +"priceHistory": { +"description": "The price history for the requested machine type and location.", +"items": { +"$ref": "CapacityHistoryResponsePriceRecord" +}, +"type": "array" +} +}, +"type": "object" +}, +"CapacityHistoryResponsePreemptionRecord": { +"description": "A record of Spot VM preemption history.", +"id": "CapacityHistoryResponsePreemptionRecord", +"properties": { +"interval": { +"$ref": "Interval", +"description": "The time interval for this preemption record." +}, +"preemptionRate": { +"description": "The preemption rate during the interval, representing the fraction of\nSpot VMs that were preempted. Range: 0.0 to 1.0. Preemption rate is\ncalculated as (total preempted Spots) / (total Spots that stopped\nrunning).", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"CapacityHistoryResponsePriceRecord": { +"description": "A record of price history.", +"id": "CapacityHistoryResponsePriceRecord", +"properties": { +"interval": { +"$ref": "Interval", +"description": "The time interval for this price record." +}, +"listPrice": { +"$ref": "Money", +"description": "The Spot VM list price during the interval." +} +}, +"type": "object" +}, +"CircuitBreakers": { +"description": "Settings controlling the volume of requests, connections and retries to this\nbackend service.", +"id": "CircuitBreakers", +"properties": { +"maxConnections": { +"description": "The maximum number of connections to the backend service. If not specified,\nthere is no limit.\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.", +"format": "int32", +"type": "integer" +}, +"maxPendingRequests": { +"description": "The maximum number of pending requests allowed to the backend service. If\nnot specified, there is no limit.\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.", +"format": "int32", +"type": "integer" +}, +"maxRequests": { +"description": "The maximum number of parallel requests that allowed to the backend\nservice. If not specified, there is no limit.", +"format": "int32", +"type": "integer" +}, +"maxRequestsPerConnection": { +"description": "Maximum requests for a single connection to the backend service.\nThis parameter is respected by both the HTTP/1.1 and HTTP/2\nimplementations. If not specified, there is no limit. Setting this\nparameter to 1 will effectively disable keep alive.\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.", +"format": "int32", +"type": "integer" +}, +"maxRetries": { +"description": "The maximum number of parallel retries allowed to the backend cluster. If\nnot specified, the default is 1.\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.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"Commitment": { +"description": "Represents a regional resource-based commitment resource.\n\nCreating this commitment resource means that you are purchasing a\nresource-based committed use contract, with an explicit start and end time.\nYou can purchase resource-based commitments for both hardware and software\nresources. For more information, read\nResource-based committed use discounts", +"id": "Commitment", +"properties": { +"autoRenew": { +"description": "Specifies whether to automatically renew the commitment at the end of its\ncurrent term. The default value is false. If you set the field\nto true, each time your commitment reaches the end of its\nterm, Compute Engine automatically renews it for another term. You can\nupdate this field anytime before the commitment expires. For example, if\nthe commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can\nupdate this field until 11:59 PM UTC-8 on January 2, 2027.", +"type": "boolean" +}, +"category": { +"description": "The category of the commitment; specifies whether the commitment is for\nhardware or software resources. Category MACHINE specifies\nthat you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.\nCategory LICENSE specifies that you are committing to software\nlicenses, listed in licenseResources.\nNote that if you specify MACHINE commitments, then you must\nalso specify a type to indicate the machine series of the\nhardware resource that you are committing to.", +"enum": [ +"CATEGORY_UNSPECIFIED", +"LICENSE", +"MACHINE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"customEndTimestamp": { +"description": "[Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired\ncommitment's end date is later than the start date + term duration.", +"type": "string" +}, +"description": { +"description": "An optional description of the commitment. You can provide this property\nwhen you create the resource.", +"type": "string" +}, +"endTimestamp": { +"description": "Output only. [Output Only] Commitment end time inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"existingReservations": { +"items": { +"type": "string" +}, +"type": "array" +}, +"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#commitment", +"description": "Output only. [Output Only] Type of the resource. Always compute#commitment\nfor commitments.", +"readOnly": true, +"type": "string" +}, +"licenseResource": { +"$ref": "LicenseResourceCommitment", +"description": "The license specification required as part of a license commitment." +}, +"mergeSourceCommitments": { +"description": "The list of source commitments that you are merging to create the new\nmerged commitment. For more information, see\nMerging commitments.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"description": "Name of the commitment. You must specify a name when you purchase the\ncommitment. The 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" +}, +"params": { +"$ref": "CommitmentParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"plan": { +"description": "The minimum time duration that you commit to purchasing resources.\nThe plan that you choose determines the preset term length of the\ncommitment (which is 1 year or 3 years) and affects the discount rate that\nyou receive for your resources. Committing to a longer time duration\ntypically gives you a higher discount rate. The supported values for this\nfield are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).", +"enum": [ +"INVALID", +"THIRTY_SIX_MONTH", +"TWELVE_MONTH" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the commitment and committed\nresources are located.", +"readOnly": true, +"type": "string" +}, +"reservations": { +"description": "The list of new reservations that you want to create and attach to this\ncommitment.\n\nYou must attach reservations to your commitment if your commitment\nspecifies any GPUs or Local SSD disks. For more information, see \nAttach reservations to resource-based commitments.\n\nSpecify this property only if you want to create new\nreservations to attach. To attach existing reservations, specify theexistingReservations property instead.", +"items": { +"$ref": "Reservation" +}, +"type": "array" +}, +"resourceStatus": { +"$ref": "CommitmentResourceStatus", +"description": "Output only. [Output Only] Status information for Commitment resource.", +"readOnly": true +}, +"resources": { +"description": "The list of all the hardware resources, with their types and amounts, that\nyou want to commit to. Specify as a separate entry in the list for each\nindividual resource type.", +"items": { +"$ref": "ResourceCommitment" +}, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"splitSourceCommitment": { +"description": "The source commitment from which you are transferring resources to create\nthe new split commitment. For more information, see \nSplit commitments.", +"type": "string" +}, +"startTimestamp": { +"description": "Output only. [Output Only] Commitment start time inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] Status of the commitment with regards to eventual expiration\n(each commitment has an end date defined). Status can be one of the\nfollowing values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.", +"enum": [ +"ACTIVE", +"CANCELLED", +"CREATING", +"EXPIRED", +"NOT_YET_ACTIVE" +], +"enumDescriptions": [ +"", +"Deprecate CANCELED status. Will use separate status to differentiate\ncancel by mergeCud or manual cancellation.", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"statusMessage": { +"description": "Output only. [Output Only] An optional, human-readable explanation of the status.", +"readOnly": true, +"type": "string" +}, +"type": { +"description": "The type of commitment; specifies the\nmachine series for which you want to commit to purchasing resources.\nThe choice of machine series affects the discount rate and the eligible\nresource types.\n\n The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,\n COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3,STORAGE_OPTIMIZED_Z4DS, STORAGE_OPTIMIZED_Z4DH,STORAGE_OPTIMIZED_Z4D4T. For\nexample, type MEMORY_OPTIMIZED specifies a commitment that\napplies only to eligible resources of memory optimized M1 and M2 machine\nseries. Type GENERAL_PURPOSE specifies a commitment that\napplies only to eligible resources of general purpose N1 machine series.", +"enum": [ +"ACCELERATOR_OPTIMIZED", +"ACCELERATOR_OPTIMIZED_A3", +"ACCELERATOR_OPTIMIZED_A3_MEGA", +"ACCELERATOR_OPTIMIZED_A3_ULTRA", +"ACCELERATOR_OPTIMIZED_A4", +"COMPUTE_OPTIMIZED", +"COMPUTE_OPTIMIZED_C2D", +"COMPUTE_OPTIMIZED_C3", +"COMPUTE_OPTIMIZED_C3D", +"COMPUTE_OPTIMIZED_H3", +"COMPUTE_OPTIMIZED_H4D", +"GENERAL_PURPOSE", +"GENERAL_PURPOSE_C4", +"GENERAL_PURPOSE_C4A", +"GENERAL_PURPOSE_C4D", +"GENERAL_PURPOSE_E2", +"GENERAL_PURPOSE_N2", +"GENERAL_PURPOSE_N2D", +"GENERAL_PURPOSE_N4", +"GENERAL_PURPOSE_N4A", +"GENERAL_PURPOSE_N4D", +"GENERAL_PURPOSE_T2D", +"GRAPHICS_OPTIMIZED", +"GRAPHICS_OPTIMIZED_G4", +"GRAPHICS_OPTIMIZED_G4_VGPU", +"MEMORY_OPTIMIZED", +"MEMORY_OPTIMIZED_M3", +"MEMORY_OPTIMIZED_M4", +"MEMORY_OPTIMIZED_M4_6TB", +"MEMORY_OPTIMIZED_X4_1440_24T", +"MEMORY_OPTIMIZED_X4_16TB", +"MEMORY_OPTIMIZED_X4_1920_32T", +"MEMORY_OPTIMIZED_X4_24TB", +"MEMORY_OPTIMIZED_X4_32TB", +"MEMORY_OPTIMIZED_X4_480_6T", +"MEMORY_OPTIMIZED_X4_480_8T", +"MEMORY_OPTIMIZED_X4_960_12T", +"MEMORY_OPTIMIZED_X4_960_16T", +"NETWORK_OPTIMIZED_C4N", +"NETWORK_OPTIMIZED_U4C", +"NETWORK_OPTIMIZED_U4P", +"NETWORK_OPTIMIZED_U4S", +"STORAGE_OPTIMIZED_Z3", +"STORAGE_OPTIMIZED_Z4D4T", +"STORAGE_OPTIMIZED_Z4DH", +"STORAGE_OPTIMIZED_Z4DS", +"TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"CUD bucket for X4 machine with 1440 vCPUs and 24TB of memory.", +"", +"CUD bucket for X4 machine with 1920 vCPUs and 32TB of memory.", +"", +"", +"CUD bucket for X4 machine with 480 vCPUs and 6TB of memory.", +"CUD bucket for X4 machine with 480 vCPUs and 8TB of memory.", +"CUD bucket for X4 machine with 960 vCPUs and 12TB of memory.", +"CUD bucket for X4 machine with 960 vCPUs and 16TB of memory.", +"CUD bucket for C4N (dual Diorite) machines.", +"CUD bucket for NETWORK_OPTIMIZED_U4C machines.", +"CUD bucket for NETWORK_OPTIMIZED_U4P machines.", +"CUD bucket for NETWORK_OPTIMIZED_U4S machines.", +"", +"CUD bucket for Z4D-4T machines.", +"CUD bucket for Z4DH machines.", +"CUD bucket for Z4DS machines.", +"Note for internal users: When adding a new enum Type for v1, make sure\nto also add it in the comment for the `optional Type type` definition.\nThis ensures that the public documentation displays the new enum Type." +], +"type": "string" +} +}, +"type": "object" +}, +"CommitmentAggregatedList": { +"id": "CommitmentAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "CommitmentsScopedList", +"description": "[Output Only] Name of the scope containing this set of commitments." +}, +"description": "A list of CommitmentsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#commitmentAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of\ncommitments.", +"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" +}, +"CommitmentList": { +"description": "Contains a list of Commitment resources.", +"id": "CommitmentList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Commitment resources.", +"items": { +"$ref": "Commitment" +}, +"type": "array" +}, +"kind": { +"default": "compute#commitmentList", +"description": "Output only. [Output Only] Type of resource. Always compute#commitmentList\nfor lists of commitments.", +"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.", +"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" +}, +"CommitmentParams": { +"description": "Additional commitment params.", +"id": "CommitmentParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the commitment. 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" +}, +"CommitmentResourceStatus": { +"description": "[Output Only] Contains output only fields.", +"id": "CommitmentResourceStatus", +"properties": { +"customTermEligibilityEndTimestamp": { +"description": "Output only. [Output Only] Indicates the end time of customer's eligibility to send\ncustom term requests in RFC3339 text format. Term extension requests that\n(not the end time in the request) after this time will be rejected.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"CommitmentsScopedList": { +"id": "CommitmentsScopedList", +"properties": { +"commitments": { +"description": "[Output Only] The list of commitments contained in this scope.", +"items": { +"$ref": "Commitment" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of commitments\nwhen 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.", +"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" +}, +"CompositeHealthCheck": { +"description": "Represents a composite health check.\n\nA composite health check resource specifies the health source resources and\nthe health destination resource to which the aggregated health result from\nthe health source resources is delivered.", +"id": "CompositeHealthCheck", +"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 CompositeHealthCheck. An up-to-date fingerprint\nmust be provided in order to patch the CompositeHealthCheck; Otherwise,\nthe request will fail with error 412 conditionNotMet. To see\nthe latest fingerprint, make a get() request to retrieve the\nCompositeHealthCheck.", +"format": "byte", +"type": "string" +}, +"healthDestination": { +"description": "URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have\nload balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region\nas the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.", +"type": "string" +}, +"healthSources": { +"description": "URLs to the HealthSource resources whose results are AND'ed.\nI.e. he aggregated result is is HEALTHY only if all sources\nare HEALTHY. Must have at least 1. Must not have more than 10.\nMust be regional and in the same region as theCompositeHealthCheck. Can be mutated.", +"items": { +"type": "string" +}, +"type": "array" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#compositeHealthCheck", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the composite health check resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"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 with id for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"CompositeHealthCheckAggregatedList": { +"description": "Contains a list of CompositeHealthChecksScopedList.", +"id": "CompositeHealthCheckAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "CompositeHealthChecksScopedList", +"description": "Name of the scope containing this set of CompositeHealthChecks." +}, +"description": "A list of CompositeHealthChecksScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#compositeHealthCheckAggregatedList", +"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" +}, +"CompositeHealthCheckHealth": { +"description": "Response message for RegionCompositeHealthChecks.GetHealth", +"id": "CompositeHealthCheckHealth", +"properties": { +"healthSources": { +"description": "Health sources and their corresponding health states.", +"items": { +"$ref": "CompositeHealthChecksGetHealthResponseHealthSourceHealth" +}, +"type": "array" +}, +"healthState": { +"description": "Health state of the CompositeHealthCheck.", +"enum": [ +"HEALTHY", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"kind": { +"default": "compute#compositeHealthCheckHealth", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#compositeHealthCheckHealth for the health of\ncomposite health checks.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"CompositeHealthCheckList": { +"id": "CompositeHealthCheckList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of CompositeHealthCheck resources.", +"items": { +"$ref": "CompositeHealthCheck" +}, +"type": "array" +}, +"kind": { +"default": "compute#compositeHealthCheckList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.", +"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] Server-defined URL for this resource.", +"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" +}, +"CompositeHealthChecksGetHealthResponseHealthSourceHealth": { +"id": "CompositeHealthChecksGetHealthResponseHealthSourceHealth", +"properties": { +"healthState": { +"description": "Health state of the associated HealthSource resource.", +"enum": [ +"HEALTHY", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"source": { +"description": "Fully qualified URL of the associated HealthSource resource.", +"type": "string" +} +}, +"type": "object" +}, +"CompositeHealthChecksScopedList": { +"id": "CompositeHealthChecksScopedList", +"properties": { +"compositeHealthChecks": { +"description": "A list of CompositeHealthChecks contained in this scope.", +"items": { +"$ref": "CompositeHealthCheck" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of composite health checks\nwhen 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.", +"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" +}, +"ConfidentialInstanceConfig": { +"description": "A set of Confidential Instance options.", +"id": "ConfidentialInstanceConfig", +"properties": { +"confidentialInstanceType": { +"description": "Defines the type of technology used by the confidential instance.", +"enum": [ +"BMSAI", +"CCA", +"CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", +"SEV", +"SEV_SNP", +"TDX" +], +"enumDescriptions": [ +"Bare Metal Secure AI.", +"Arm Confidential Compute Architecture.", +"No type specified. Do not use this value.", +"AMD Secure Encrypted Virtualization.", +"AMD Secure Encrypted Virtualization - Secure Nested Paging.", +"Intel Trust Domain eXtension." +], +"type": "string" +}, +"enableConfidentialCompute": { +"description": "Defines whether the instance should have confidential compute enabled.", +"type": "boolean" +} +}, +"type": "object" +}, +"ConnectionDraining": { +"description": "Message containing connection draining configuration.", +"id": "ConnectionDraining", +"properties": { +"drainingTimeoutSec": { +"description": "Configures a duration timeout for existing requests on a removed backend\ninstance. For supported load balancers and protocols, as described inEnabling\nconnection draining.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"ConsistentHashLoadBalancerSettings": { +"description": "This message defines settings for a consistent hash style load balancer.", +"id": "ConsistentHashLoadBalancerSettings", +"properties": { +"httpCookie": { +"$ref": "ConsistentHashLoadBalancerSettingsHttpCookie", +"description": "Hash is based on HTTP Cookie. This field describes a HTTP cookie that will\nbe used as the hash key for the consistent hash load balancer. If the\ncookie is not present, it will be generated. This field is applicable if\nthe sessionAffinity is set to HTTP_COOKIE.\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." +}, +"httpHeaderName": { +"description": "The hash based on the value of the specified header field. This field is\napplicable if the sessionAffinity is set toHEADER_FIELD.", +"type": "string" +}, +"minimumRingSize": { +"description": "The minimum number of virtual nodes to use for the hash ring. Defaults to\n1024. Larger ring sizes result in more granular load distributions. If the\nnumber of hosts in the load balancing pool is larger than the ring size,\neach host will be assigned a single virtual node.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"ConsistentHashLoadBalancerSettingsHttpCookie": { +"description": "The information about the HTTP Cookie on which the hash function is based\nfor load balancing policies that use a consistent hash.", +"id": "ConsistentHashLoadBalancerSettingsHttpCookie", +"properties": { +"name": { +"description": "Name of the cookie.", +"type": "string" +}, +"path": { +"description": "Path to set for the cookie.", +"type": "string" +}, +"ttl": { +"$ref": "Duration", +"description": "Lifetime of the cookie." +} +}, +"type": "object" +}, +"CorsPolicy": { +"description": "The specification for allowing client-side cross-origin requests. For more\ninformation about the W3C recommendation for cross-origin resource sharing\n(CORS), see Fetch API Living\nStandard.", +"id": "CorsPolicy", +"properties": { +"allowCredentials": { +"description": "In response to a preflight request, setting this to true\nindicates that\nthe actual request can include user credentials. This field translates to\nthe Access-Control-Allow-Credentials header.\n\nDefault is false.", +"type": "boolean" +}, +"allowHeaders": { +"description": "Specifies the content for the Access-Control-Allow-Headers\nheader.", +"items": { +"type": "string" +}, +"type": "array" +}, +"allowMethods": { +"description": "Specifies the content for the Access-Control-Allow-Methods\nheader.", +"items": { +"type": "string" +}, +"type": "array" +}, +"allowOriginRegexes": { +"description": "Specifies a regular expression that matches allowed origins. For\nmore information, see regular expression syntax. \n\nAn origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED.", +"items": { +"type": "string" +}, +"type": "array" +}, +"allowOrigins": { +"description": "Specifies the list of origins that is allowed to do CORS requests.\n\nAn origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.", +"items": { +"type": "string" +}, +"type": "array" +}, +"disabled": { +"description": "If true, disables the CORS policy.\nThe default value is false, which indicates that the CORS\npolicy is in effect.", +"type": "boolean" +}, +"exposeHeaders": { +"description": "Specifies the content for the Access-Control-Expose-Headers\nheader.", +"items": { +"type": "string" +}, +"type": "array" +}, +"maxAge": { +"description": "Specifies how long results of a preflight request can be cached in\nseconds. This field translates to the Access-Control-Max-Age\nheader.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"CrossSiteNetwork": { +"description": "A resource that represents a cross-site network.\n\nYou can use cross-site networks to connect your on-premises networks to\neach other through Interconnect connections.", +"id": "CrossSiteNetwork", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of the cross-site network.", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#crossSiteNetwork", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"CrossSiteNetworkList": { +"description": "Response to the list request that contains a list of cross-site networks.", +"id": "CrossSiteNetworkList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of CrossSiteNetwork resources.", +"items": { +"$ref": "CrossSiteNetwork" +}, +"type": "array" +}, +"kind": { +"default": "compute#crossSiteNetwork", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.", +"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] Server-defined URL for this resource.", +"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" +}, +"CustomErrorResponsePolicy": { +"description": "Specifies the custom error response policy that must be applied when the\nbackend service or backend bucket responds with an error.", +"id": "CustomErrorResponsePolicy", +"properties": { +"errorResponseRules": { +"description": "Specifies rules for returning error responses.\n\nIn a given policy, if you specify rules for both a range of error codes\nas well as rules for specific error codes then rules with specific error\ncodes have a higher priority. For example, assume that you configure a rule\nfor 401 (Un-authorized) code, and another for all 4 series\nerror codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.\nHowever if the backend service returns a 403, the rule for4xx takes effect.", +"items": { +"$ref": "CustomErrorResponsePolicyCustomErrorResponseRule" +}, +"type": "array" +}, +"errorService": { +"description": "The full or partial URL to the BackendBucket resource that\ncontains the custom error content. Examples are:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket\n - compute/v1/projects/project/global/backendBuckets/myBackendBucket\n - global/backendBuckets/myBackendBucket\n\nIf errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,\nan errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. \n\nIf load balancer cannot reach\nthe backendBucket, a simple Not Found Error will\nbe returned, with the original response code (oroverrideResponseCode if configured).\n\nerrorService is not supported for internal or regionalHTTP/HTTPS load balancers.", +"type": "string" +} +}, +"type": "object" +}, +"CustomErrorResponsePolicyCustomErrorResponseRule": { +"description": "Specifies the mapping between the response code that will be returned along\nwith the custom error content and the response code returned by the backend\nservice.", +"id": "CustomErrorResponsePolicyCustomErrorResponseRule", +"properties": { +"matchResponseCodes": { +"description": "Valid values include:\n \n \n - A number between 400 and 599: For example\n 401 or 503, in which case the load balancer\n applies the policy if the error code exactly matches this value.\n - 5xx: Load Balancer will apply the policy if the\n backend service responds with any response code in the range of\n 500 to 599. \n - 4xx: Load\n Balancer will apply the policy if the backend service responds with any\n response code in the range of 400 to\n 499.\n\nValues must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.", +"items": { +"type": "string" +}, +"type": "array" +}, +"overrideResponseCode": { +"description": "The HTTP status code returned with the response containing the custom\nerror content. If overrideResponseCode is not supplied, the\nsame response code returned by the original backend bucket or backend\nservice is returned to the client.", +"format": "int32", +"type": "integer" +}, +"path": { +"description": "The full path to a file within backendBucket . For example:/errors/defaultError.html \n\npath must start\nwith a leading slash. path cannot have trailing slashes.\n\nIf the file is not available in backendBucket or the\nload balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. \n\nThe value must\nbe from 1 to 1024 characters", +"type": "string" +} +}, +"type": "object" +}, +"CustomerEncryptionKey": { +"id": "CustomerEncryptionKey", +"properties": { +"kmsKeyName": { +"description": "The name of the encryption key that is stored in Google Cloud KMS.\nFor example:\n\n\"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n\nThe fully-qualifed key name may be returned for resource GET requests. For \nexample: \n\n\"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n/cryptoKeyVersions/1", +"type": "string" +}, +"kmsKeyServiceAccount": { +"description": "The service account being used for the encryption request for the given KMS\nkey. If absent, the Compute Engine default service account is used.\nFor example:\n\n\"kmsKeyServiceAccount\": \"name@project_id.iam.gserviceaccount.com/", +"type": "string" +}, +"rawKey": { +"deprecated": true, +"description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\nSpecifies a 256-bit customer-supplied\nencryption key, encoded in RFC\n4648 base64 to either encrypt or decrypt this resource. You can\nprovide either the rawKey or thersaEncryptedKey.\nFor example:\n\n\"rawKey\":\n\"SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=\"", +"type": "string" +}, +"rsaEncryptedKey": { +"deprecated": true, +"description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\nSpecifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit\ncustomer-supplied encryption key to either encrypt or decrypt this\nresource. You can provide either the rawKey or thersaEncryptedKey.\nFor example:\n\n\"rsaEncryptedKey\":\n\"ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH\nz0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD\nD6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==\"\n\nThe key must meet the following requirements before you can provide it to \nCompute Engine: \n \n 1. The key is wrapped using a RSA public key certificate provided by \n Google. \n 2. After being wrapped, the key must be encoded in RFC 4648 base64 \n encoding. \n\nGets the RSA public key certificate provided by Google at: \n\n\nhttps://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem", +"type": "string" +}, +"sha256": { +"deprecated": true, +"description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\n[Output only] TheRFC\n4648 base64 encoded SHA-256 hash of the customer-supplied\nencryption key that protects this resource.", +"type": "string" +} +}, +"type": "object" +}, +"CustomerEncryptionKeyProtectedDisk": { +"id": "CustomerEncryptionKeyProtectedDisk", +"properties": { +"diskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Decrypts data associated with the disk with acustomer-supplied\nencryption key." +}, +"source": { +"description": "Specifies a valid partial or full URL to an existing Persistent Disk\nresource. This field is only applicable for persistent disks.\nFor example:\n\n\"source\": \"/compute/v1/projects/project_id/zones/zone/disks/\ndisk_name", +"type": "string" +} +}, +"type": "object" +}, +"Date": { +"description": "Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:\n\n* A full date, with non-zero year, month, and day values.\n* A month and day, with a zero year (for example, an anniversary).\n* A year on its own, with a zero month and a zero day.\n* A year and month, with a zero day (for example, a credit card expiration\n date).\n\nRelated types:\n\n* google.type.TimeOfDay\n* google.type.DateTime\n* google.protobuf.Timestamp", +"id": "Date", +"properties": { +"day": { +"description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant.", +"format": "int32", +"type": "integer" +}, +"month": { +"description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day.", +"format": "int32", +"type": "integer" +}, +"year": { +"description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"DateTime": { +"description": "Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year, month, or day are 0, the DateTime is considered not to have a\nspecific year, month, or day respectively.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations.", +"id": "DateTime", +"properties": { +"day": { +"description": "Optional. Day of month. Must be from 1 to 31 and valid for the year and\nmonth, or 0 if specifying a datetime without a day.", +"format": "int32", +"type": "integer" +}, +"hours": { +"description": "Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults\nto 0 (midnight). An API may choose to allow the value \"24:00:00\" for\nscenarios like business closing time.", +"format": "int32", +"type": "integer" +}, +"minutes": { +"description": "Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.", +"format": "int32", +"type": "integer" +}, +"month": { +"description": "Optional. Month of year. Must be from 1 to 12, or 0 if specifying a\ndatetime without a month.", +"format": "int32", +"type": "integer" +}, +"nanos": { +"description": "Optional. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999, defaults to 0.", +"format": "int32", +"type": "integer" +}, +"seconds": { +"description": "Optional. Seconds of minutes of the time. Must normally be from 0 to 59,\ndefaults to 0. An API may allow the value 60 if it allows leap-seconds.", +"format": "int32", +"type": "integer" +}, +"timeZone": { +"$ref": "TimeZone", +"description": "Time zone." +}, +"utcOffset": { +"description": "UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }.", +"format": "google-duration", +"type": "string" +}, +"year": { +"description": "Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"DeprecationStatus": { +"description": "Deprecation status for a public resource.", +"id": "DeprecationStatus", +"properties": { +"deleted": { +"description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to DELETED. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", +"type": "string" +}, +"deprecated": { +"description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to DEPRECATED. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", +"type": "string" +}, +"obsolete": { +"description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to OBSOLETE. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", +"type": "string" +}, +"replacement": { +"description": "The URL of the suggested replacement for a deprecated resource.\nThe suggested replacement resource must be the same kind of resource as the\ndeprecated resource.", +"type": "string" +}, +"state": { +"description": "The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.\nOperations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a\nwarning indicating the deprecated resource and recommending its\nreplacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.", +"enum": [ +"ACTIVE", +"DELETED", +"DEPRECATED", +"OBSOLETE" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"Disk": { +"description": "Represents a Persistent Disk resource.\n\nGoogle Compute Engine has two Disk resources:\n\n* [Zonal](/compute/docs/reference/rest/v1/disks)\n* [Regional](/compute/docs/reference/rest/v1/regionDisks)\n\nPersistent disks are required for running your VM instances.\nCreate both boot and non-boot (data) persistent disks. For more information,\nread Persistent Disks. For more\nstorage options, read Storage options.\n\nThe disks resource represents a zonal persistent disk.\nFor more information, readZonal persistent disks.\n\nThe regionDisks resource represents a\nregional persistent disk. For more information, read\nRegional resources.", +"id": "Disk", +"properties": { +"accessMode": { +"description": "The access mode of the disk.\n \n \n - READ_WRITE_SINGLE: The default AccessMode, means the\n disk can be attached to single instance in RW mode.\n - READ_WRITE_MANY: The AccessMode means the disk can be\n attached to multiple instances in RW mode.\n - READ_ONLY_MANY: The AccessMode means the disk can be\n attached to multiple instances in RO mode.\n\n\nThe AccessMode is only valid for Hyperdisk disk types.", +"enum": [ +"READ_ONLY_MANY", +"READ_WRITE_MANY", +"READ_WRITE_SINGLE" +], +"enumDescriptions": [ +"The AccessMode means the disk can be attached to multiple instances in RO\nmode.", +"The AccessMode means the disk can be attached to multiple instances in RW\nmode.", +"The default AccessMode, means the disk can be attached to single instance\nin RW mode." +], +"type": "string" +}, +"architecture": { +"description": "The architecture of the disk. Valid values are\nARM64 or X86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"type": "string" +}, +"asyncPrimaryDisk": { +"$ref": "DiskAsyncReplication", +"description": "Disk asynchronously replicated into this disk." +}, +"asyncSecondaryDisks": { +"additionalProperties": { +"$ref": "DiskAsyncReplicationList" +}, +"description": "Output only. [Output Only] A list of disks this disk is asynchronously replicated to.", +"readOnly": true, +"type": "object" +}, +"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" +}, +"diskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Encrypts the disk using a\ncustomer-supplied encryption key or a \ncustomer-managed encryption key.\n\nEncryption keys do not protect access to metadata of the disk.\n\nAfter you encrypt a disk with a customer-supplied key, you must provide the\nsame key if you use the disk later. For example, to create a disk snapshot,\nto create a disk image, to create a machine image, or to attach the disk to\na virtual machine.\n\nAfter you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*\nname once the disk is created. The disk is encrypted with this version of\nthe key. In the response, diskEncryptionKey.kmsKeyName appears\nin the following format:\n\n\"diskEncryptionKey.kmsKeyName\":\n\"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n/cryptoKeysVersions/version\n\nIf you do not provide an encryption key when creating the disk, then the \ndisk is encrypted using an automatically generated key and you don't need \nto provide a key to use the disk later." +}, +"enableConfidentialCompute": { +"description": "Whether this disk is using confidential compute mode.", +"type": "boolean" +}, +"guestOsFeatures": { +"description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", +"items": { +"$ref": "GuestOsFeature" +}, +"type": "array" +}, +"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#disk", +"description": "Output only. [Output Only] Type of the resource. Always compute#disk for\ndisks.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this disk, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a disk.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this disk. These can be later modified by\nthe setLabels method.", +"type": "object" +}, +"lastAttachTimestamp": { +"description": "Output only. [Output Only] Last attach timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"lastDetachTimestamp": { +"description": "Output only. [Output Only] Last detach timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"licenseCodes": { +"description": "Integer license codes indicating which licenses are attached to this disk.", +"items": { +"format": "int64", +"type": "string" +}, +"type": "array" +}, +"licenses": { +"description": "A list of publicly visible licenses. Reserved for Google's use.", +"items": { +"type": "string" +}, +"type": "array" +}, +"locationHint": { +"description": "An opaque location hint used to place the disk close to other resources.\nThis field is for use by internal tools that use the public API.", +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.disks.insert" +] +}, +"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])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"options": { +"description": "Internal use only.", +"type": "string" +}, +"params": { +"$ref": "DiskParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"physicalBlockSizeBytes": { +"description": "Physical block size of the persistent disk, in bytes.\nIf not present in a request, a default value is used.\nThe currently supported size is 4096, other sizes may be added in\nthe future.\nIf an unsupported value is requested, the error message will list\nthe supported values for the caller's project.", +"format": "int64", +"type": "string" +}, +"provisionedIops": { +"description": "Indicates how many IOPS to provision for the disk. This sets the number\nof I/O operations per second that the disk can handle. Values must be\nbetween 10,000 and 120,000. For more details, see theExtreme persistent\ndisk documentation.", +"format": "int64", +"type": "string" +}, +"provisionedThroughput": { +"description": "Indicates how much throughput to provision for the disk. This sets the\nnumber of throughput mb per second that the disk can handle. Values must be\ngreater than or equal to 1.", +"format": "int64", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the disk resides. Only applicable for\nregional resources.\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" +}, +"replicaZones": { +"description": "URLs of the zones where the disk should be replicated to. Only applicable\nfor regional resources.", +"items": { +"type": "string" +}, +"type": "array" +}, +"resourcePolicies": { +"description": "Resource policies applied to this disk for automatic snapshot creations.", +"items": { +"type": "string" +}, +"type": "array" +}, +"resourceStatus": { +"$ref": "DiskResourceStatus", +"description": "Output only. [Output Only] Status information for the disk resource.", +"readOnly": true +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"sizeGb": { +"description": "Size, in GB, of the persistent disk. You can specify\nthis field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty\npersistent disk.\n\nIf you specify this field along with a source, the value ofsizeGb must not be less than the size of the\nsource.\nAcceptable values are greater than 0.", +"format": "int64", +"type": "string" +}, +"sourceConsistencyGroupPolicy": { +"description": "Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk\nthat was created using a consistency group.", +"readOnly": true, +"type": "string" +}, +"sourceConsistencyGroupPolicyId": { +"description": "Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk\nthat was created using a consistency group.", +"readOnly": true, +"type": "string" +}, +"sourceDisk": { +"description": "The source disk used to create this disk. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", +"type": "string" +}, +"sourceDiskId": { +"description": "Output only. [Output Only] The unique ID of the disk used to create this disk. This\nvalue identifies the exact disk that was used to create this persistent\ndisk. For example, if you created the persistent disk from a disk that\nwas later deleted and recreated under the same name, the source disk ID\nwould identify the exact version of the disk that was used.", +"readOnly": true, +"type": "string" +}, +"sourceImage": { +"description": "The source image used to create this disk. If the source image is\ndeleted, this field will not be set.\n\nTo create a disk with one of the public operating system images, specify\nthe image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:\n\nprojects/debian-cloud/global/images/family/debian-9\n\n\nAlternatively, use a specific version of a public operating system image:\n\nprojects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD\n\n\nTo create a disk with a custom image that you created, specify the\nimage name in the following format:\n\nglobal/images/my-custom-image\n\n\nYou can also specify a custom image by its image family, which returns\nthe latest version of the image in that family. Replace the image name\nwith family/family-name:\n\nglobal/images/family/my-image-family", +"type": "string" +}, +"sourceImageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source image. Required if the source image is\nprotected by a customer-supplied encryption key." +}, +"sourceImageId": { +"description": "Output only. [Output Only] The ID value of the image used to create this disk. This\nvalue identifies the exact image that was used to create this persistent\ndisk. For example, if you created the persistent disk from an image that\nwas later deleted and recreated under the same name, the source image ID\nwould identify the exact version of the image that was used.", +"readOnly": true, +"type": "string" +}, +"sourceInstantSnapshot": { +"description": "The source instant snapshot used to create this disk. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot\n - projects/project/zones/zone/instantSnapshots/instantSnapshot \n - zones/zone/instantSnapshots/instantSnapshot", +"type": "string" +}, +"sourceInstantSnapshotId": { +"description": "Output only. [Output Only] The unique ID of the instant snapshot used to create this\ndisk. This value identifies the exact instant snapshot that was used to\ncreate this persistent disk. For example, if you created the persistent\ndisk from an instant snapshot that was later deleted and recreated under\nthe same name, the source instant snapshot ID would identify the exact\nversion of the instant snapshot that was used.", +"readOnly": true, +"type": "string" +}, +"sourceSnapshot": { +"description": "The source snapshot used to create this disk. 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/snapshots/snapshot \n - projects/project/global/snapshots/snapshot\n - global/snapshots/snapshot", +"type": "string" +}, +"sourceSnapshotEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source snapshot. Required if the source snapshot\nis protected by a customer-supplied encryption key." +}, +"sourceSnapshotId": { +"description": "Output only. [Output Only] The unique ID of the snapshot used to create this disk. This\nvalue identifies the exact snapshot that was used to create this persistent\ndisk. For example, if you created the persistent disk from a snapshot that\nwas later deleted and recreated under the same name, the source snapshot ID\nwould identify the exact version of the snapshot that was used.", +"readOnly": true, +"type": "string" +}, +"sourceStorageObject": { +"description": "The full Google Cloud Storage URI where the disk image is stored. This file\nmust be a gzip-compressed tarball whose name ends in .tar.gz or virtual\nmachine disk whose name ends in vmdk. Valid URIs may start with gs:// or\nhttps://storage.googleapis.com/. This flag is not optimized for creating\nmultiple disks from a source storage object. To create many disks from a\nsource storage object, use gcloud compute images\nimport instead.", +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of disk creation.\n \n \n - CREATING: Disk is provisioning.\n - RESTORING: Source data is being copied into the\n disk.\n - FAILED: Disk creation failed.\n - READY: Disk is ready for use.\n - DELETING: Disk is deleting.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY", +"RESTORING", +"UNAVAILABLE" +], +"enumDescriptions": [ +"Disk is provisioning", +"Disk is deleting.", +"Disk creation failed.", +"Disk is ready for use.", +"Source data is being copied into the disk.", +"Disk is currently unavailable and cannot be accessed, attached or\ndetached." +], +"readOnly": true, +"type": "string" +}, +"storagePool": { +"description": "The storage pool in which the new disk is created. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool\n - projects/project/zones/zone/storagePools/storagePool \n - zones/zone/storagePools/storagePool", +"type": "string" +}, +"type": { +"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" +}, +"users": { +"description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the disk resides.\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" +} +}, +"type": "object" +}, +"DiskAggregatedList": { +"id": "DiskAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "DisksScopedList", +"description": "[Output Only] Name of the scope containing this set of disks." +}, +"description": "A list of DisksScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#diskAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent\ndisks.", +"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" +}, +"DiskAsyncReplication": { +"id": "DiskAsyncReplication", +"properties": { +"consistencyGroupPolicy": { +"description": "Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was\nstarted on the disk as a member of a group.", +"readOnly": true, +"type": "string" +}, +"consistencyGroupPolicyId": { +"description": "Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was\nstarted on the disk as a member of a group.", +"readOnly": true, +"type": "string" +}, +"disk": { +"description": "The other disk asynchronously replicated to or from the current disk.\nYou can provide this as a partial or full URL to the resource.\nFor example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", +"type": "string" +}, +"diskId": { +"description": "Output only. [Output Only] The unique ID of the other disk asynchronously replicated\nto or from the current disk. This value identifies the exact disk that\nwas used to create this replication. For example, if you started\nreplicating the persistent disk from a disk that was later deleted and\nrecreated under the same name, the disk ID would identify the exact\nversion of the disk that was used.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"DiskAsyncReplicationList": { +"id": "DiskAsyncReplicationList", +"properties": { +"asyncReplicationDisk": { +"$ref": "DiskAsyncReplication" +} +}, +"type": "object" +}, +"DiskInstantiationConfig": { +"description": "A specification of the desired way to instantiate a disk in the instance\ntemplate when its created from a source instance.", +"id": "DiskInstantiationConfig", +"properties": { +"autoDelete": { +"description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (but not when the disk is detached from the instance).", +"type": "boolean" +}, +"customImage": { +"description": "The custom source image to be used to restore this disk when instantiating\nthis instance template.", +"type": "string" +}, +"deviceName": { +"description": "Specifies the device name of the disk to which the configurations apply to.", +"type": "string" +}, +"instantiateFrom": { +"description": "Specifies whether to include the disk and what image to use. Possible\nvalues are:\n \n \n - source-image: to use the same image that was used to\n create the source instance's corresponding disk. Applicable to the boot\n disk and additional read-write disks.\n - source-image-family: to use the same image family that\n was used to create the source instance's corresponding disk. Applicable\n to the boot disk and additional read-write disks.\n - custom-image: to use a user-provided image url for disk\n creation. Applicable to the boot disk and additional read-write\n disks. \n - attach-read-only: to attach a read-only\n disk. Applicable to read-only disks.\n - do-not-include: to exclude a disk from the template.\n Applicable to additional read-write disks, local SSDs, and read-only\n disks.", +"enum": [ +"ATTACH_READ_ONLY", +"BLANK", +"CUSTOM_IMAGE", +"DEFAULT", +"DO_NOT_INCLUDE", +"SOURCE_IMAGE", +"SOURCE_IMAGE_FAMILY" +], +"enumDescriptions": [ +"Attach the existing disk in read-only mode. The request will fail if the\ndisk was attached in read-write mode on the source instance. Applicable\nto: read-only disks.", +"Create a blank disk. The disk will be created unformatted. Applicable to:\nadditional read-write disks, local SSDs.", +"Use the custom image specified in the custom_image field. Applicable to:\nboot disk, additional read-write disks.", +"Use the default instantiation option for the corresponding type of disk.\nFor boot disk and any other R/W disks, new custom images will be created\nfrom each disk. For read-only disks, they will be attached in read-only\nmode. Local SSD disks will be created as blank volumes.", +"Do not include the disk in the instance template. Applicable to:\nadditional read-write disks, local SSDs, read-only disks.", +"Use the same source image used for creation of the source instance's\ncorresponding disk. The request will fail if the source VM's disk was\ncreated from a snapshot. Applicable to: boot disk, additional read-write\ndisks.", +"Use the same source image family used for creation of the source\ninstance's corresponding disk. The request will fail if the source image\nof the source disk does not belong to any image family. Applicable to:\nboot disk, additional read-write disks." +], +"type": "string" +} +}, +"type": "object" +}, +"DiskList": { +"description": "A list of Disk resources.", +"id": "DiskList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Disk resources.", +"items": { +"$ref": "Disk" +}, +"type": "array" +}, +"kind": { +"default": "compute#diskList", +"description": "Output only. [Output Only] Type of resource. Always compute#diskList for\nlists of disks.", +"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.", +"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" +}, +"DiskMoveRequest": { +"id": "DiskMoveRequest", +"properties": { +"destinationZone": { +"description": "The URL of the destination zone to move the disk. This can be a full or\npartial URL. For example, the following are all valid URLs to a zone:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone", +"type": "string" +}, +"targetDisk": { +"description": "The URL of the target disk to move. This can be a full or partial URL.\nFor example, the following are all valid URLs to a disk:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", +"type": "string" +} +}, +"type": "object" +}, +"DiskParams": { +"description": "Additional disk params.", +"id": "DiskParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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" +}, +"DiskResourceStatus": { +"id": "DiskResourceStatus", +"properties": { +"asyncPrimaryDisk": { +"$ref": "DiskResourceStatusAsyncReplicationStatus" +}, +"asyncSecondaryDisks": { +"additionalProperties": { +"$ref": "DiskResourceStatusAsyncReplicationStatus" +}, +"description": "Key: disk, value: AsyncReplicationStatus message", +"type": "object" +} +}, +"type": "object" +}, +"DiskResourceStatusAsyncReplicationStatus": { +"id": "DiskResourceStatusAsyncReplicationStatus", +"properties": { +"state": { +"enum": [ +"ACTIVE", +"CREATED", +"STARTING", +"STATE_UNSPECIFIED", +"STOPPED", +"STOPPING" +], +"enumDescriptions": [ +"Replication is active.", +"Secondary disk is created and is waiting for replication to start.", +"Replication is starting.", +"", +"Replication is stopped.", +"Replication is stopping." +], +"type": "string" +} +}, +"type": "object" +}, +"DiskType": { +"description": "Represents a Disk Type resource.\n\nGoogle Compute Engine has two Disk Type resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)\n* [Zonal](/compute/docs/reference/rest/v1/diskTypes)\n\nYou can choose from a variety of disk types based on your needs.\nFor more information, readStorage options.\n\nThe diskTypes resource represents disk types for a zonal\npersistent disk.\nFor more information, readZonal persistent disks.\n\nThe regionDiskTypes resource represents disk types for a\nregional persistent disk. For more information, read Regional persistent disks.", +"id": "DiskType", +"properties": { +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"defaultDiskSizeGb": { +"description": "[Output Only] Server-defined default disk size in GB.", +"format": "int64", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this disk type." +}, +"description": { +"description": "[Output Only] An optional description of this resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#diskType", +"description": "Output only. [Output Only] Type of the resource. Always compute#diskType\nfor disk types.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"region": { +"description": "[Output Only] URL of the region where the disk type resides. Only\napplicable for regional resources.\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" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"validDiskSize": { +"description": "[Output Only] An optional textual description of the valid disk size,\nsuch as \"10GB-10TB\".", +"type": "string" +}, +"zone": { +"description": "[Output Only] URL of the zone where the disk type 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" +} +}, +"type": "object" +}, +"DiskTypeAggregatedList": { +"id": "DiskTypeAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "DiskTypesScopedList", +"description": "[Output Only] Name of the scope containing this set of disk types." +}, +"description": "A list of DiskTypesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#diskTypeAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList.", +"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" +}, +"DiskTypeList": { +"description": "Contains a list of disk types.", +"id": "DiskTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of DiskType resources.", +"items": { +"$ref": "DiskType" +}, +"type": "array" +}, +"kind": { +"default": "compute#diskTypeList", +"description": "Output only. [Output Only] Type of resource. Always compute#diskTypeList\nfor disk types.", +"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.", +"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" +}, +"DiskTypesScopedList": { +"id": "DiskTypesScopedList", +"properties": { +"diskTypes": { +"description": "[Output Only] A list of disk types contained in this scope.", +"items": { +"$ref": "DiskType" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of disk types\nwhen 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.", +"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" +}, +"DiskUpdateKmsKeyRequest": { +"id": "DiskUpdateKmsKeyRequest", +"properties": { +"kmsKeyName": { +"description": "Optional. The new KMS key to replace the current one on the disk. If empty, the disk\nwill be re-encrypted using the primary version of the disk's current KMS\nkey.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key\n\n\nWhere project is the project ID or\nproject number.", +"type": "string" +} +}, +"type": "object" +}, +"DisksAddResourcePoliciesRequest": { +"id": "DisksAddResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Full or relative path to the resource policy to be added to this disk. You\ncan only specify one resource policy.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"DisksRemoveResourcePoliciesRequest": { +"id": "DisksRemoveResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Resource policies to be removed from this disk.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"DisksResizeRequest": { +"id": "DisksResizeRequest", +"properties": { +"sizeGb": { +"description": "The new size of the persistent disk, which is specified in GB.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"DisksScopedList": { +"id": "DisksScopedList", +"properties": { +"disks": { +"description": "[Output Only] A list of disks contained in this scope.", +"items": { +"$ref": "Disk" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of disks when\nthe 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.", +"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" +}, +"DisksStartAsyncReplicationRequest": { +"id": "DisksStartAsyncReplicationRequest", +"properties": { +"asyncSecondaryDisk": { +"description": "The secondary disk to start asynchronous replication to.\nYou can provide this as a partial or full URL to the resource. For example,\nthe following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", +"type": "string" +} +}, +"type": "object" +}, +"DisksStopGroupAsyncReplicationResource": { +"description": "A transient resource used in compute.disks.stopGroupAsyncReplication and\ncompute.regionDisks.stopGroupAsyncReplication. It is only used to process\nrequests and is not persisted.", +"id": "DisksStopGroupAsyncReplicationResource", +"properties": { +"resourcePolicy": { +"description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.\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" +} +}, +"type": "object" +}, +"DisplayDevice": { +"description": "A set of Display Device options", +"id": "DisplayDevice", +"properties": { +"enableDisplay": { +"description": "Defines whether the instance has Display enabled.", +"type": "boolean" +} +}, +"type": "object" +}, +"DistributionPolicy": { +"id": "DistributionPolicy", +"properties": { +"targetShape": { +"description": "The distribution shape to which the group converges either proactively or\non resize events (depending on the value set inupdatePolicy.instanceRedistributionType).", +"enum": [ +"ANY", +"ANY_SINGLE_ZONE", +"BALANCED", +"EVEN" +], +"enumDescriptions": [ +"The group picks zones for creating VM instances to fulfill the requested\nnumber of VMs within present resource constraints and to maximize\nutilization of unused zonal reservations. Recommended for batch workloads\nthat do not require high availability.", +"The group creates all VM instances within a single zone. The zone is\nselected based on the present resource constraints and to maximize\nutilization of unused zonal reservations.\nRecommended for batch workloads with heavy interprocess communication.", +"The group prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across selected zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads.", +"The group schedules VM instance creation and deletion to achieve and\nmaintain an even number of managed instances across the selected zones.\nThe distribution is even when the number of managed instances does not\ndiffer by more than 1 between any two zones. Recommended for highly\navailable serving workloads." +], +"type": "string" +}, +"zones": { +"description": "Zones where the regional managed instance group will create and manage\nits instances.\nBy default, a regional MIG doesn't automatically select an AI zone to create\ninstances, even if an AI zone is available in the specified region. To\ncreate instances in an AI zone in the selected region, you must explicitly\nspecify it in the distribution policy together with the other preferred\nzones.", +"items": { +"$ref": "DistributionPolicyZoneConfiguration" +}, +"type": "array" +} +}, +"type": "object" +}, +"DistributionPolicyZoneConfiguration": { +"id": "DistributionPolicyZoneConfiguration", +"properties": { +"zone": { +"annotations": { +"required": [ +"compute.regionInstanceGroupManagers.insert" +] +}, +"description": "The URL of thezone.\nThe zone must exist in the region where the managed instance group is\nlocated.", +"type": "string" +} +}, +"type": "object" +}, +"Duration": { +"description": "A Duration represents a fixed-length span of time represented\nas a count of seconds and fractions of seconds at nanosecond\nresolution. It is independent of any calendar and concepts like \"day\"\nor \"month\". Range is approximately 10,000 years.", +"id": "Duration", +"properties": { +"nanos": { +"description": "Span of time that's a fraction of a second at nanosecond resolution.\nDurations less than one second are represented with a 0\n`seconds` field and a positive `nanos` field. Must be from 0\nto 999,999,999 inclusive.", +"format": "int32", +"type": "integer" +}, +"seconds": { +"description": "Span of time at a resolution of a second. Must be from 0\nto 315,576,000,000 inclusive. Note: these bounds are computed from:\n60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"ErrorInfo": { +"description": "Describes the cause of the error with structured details.\n\nExample of an error when contacting the \"pubsub.googleapis.com\" API when it\nis not enabled:\n\n { \"reason\": \"API_DISABLED\"\n \"domain\": \"googleapis.com\"\n \"metadata\": {\n \"resource\": \"projects/123\",\n \"service\": \"pubsub.googleapis.com\"\n }\n }\n\nThis response indicates that the pubsub.googleapis.com API is not enabled.\n\nExample of an error that is returned when attempting to create a Spanner\ninstance in a region that is out of stock:\n\n { \"reason\": \"STOCKOUT\"\n \"domain\": \"spanner.googleapis.com\",\n \"metadata\": {\n \"availableRegions\": \"us-central1,us-east2\"\n }\n }", +"id": "ErrorInfo", +"properties": { +"domain": { +"description": "The logical grouping to which the \"reason\" belongs. The error domain\nis typically the registered service name of the tool or product that\ngenerates the error. Example: \"pubsub.googleapis.com\". If the error is\ngenerated by some common infrastructure, the error domain must be a\nglobally unique value that identifies the infrastructure. For Google API\ninfrastructure, the error domain is \"googleapis.com\".", +"type": "string" +}, +"metadatas": { +"additionalProperties": { +"type": "string" +}, +"description": "Additional structured details about this error.\n\nKeys must match a regular expression of `a-z+` but should\nideally be lowerCamelCase. Also, they must be limited to 64 characters in\nlength. When identifying the current value of an exceeded limit, the units\nshould be contained in the key, not the value. For example, rather than\n`{\"instanceLimit\": \"100/request\"}`, should be returned as,\n`{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of\ninstances that can be created in a single (batch) request.", +"type": "object" +}, +"reason": { +"description": "The reason of the error. This is a constant value that identifies the\nproximate cause of the error. Error reasons are unique within a particular\ndomain of errors. This should be at most 63 characters and match a\nregular expression of `A-Z+[A-Z0-9]`, which represents\nUPPER_SNAKE_CASE.", +"type": "string" +} +}, +"type": "object" +}, +"ExchangedPeeringRoute": { +"id": "ExchangedPeeringRoute", +"properties": { +"destRange": { +"description": "The destination range of the route.", +"type": "string" +}, +"imported": { +"description": "True if the peering route has been imported from a peer. The actual import\nhappens if the field networkPeering.importCustomRoutes is true\nfor this network, and networkPeering.exportCustomRoutes is\ntrue for the peer network, and the import does not result in a route\nconflict.", +"type": "boolean" +}, +"nextHopRegion": { +"description": "The region of peering route next hop, only applies to dynamic routes.", +"type": "string" +}, +"priority": { +"description": "The priority of the peering route.", +"format": "uint32", +"type": "integer" +}, +"type": { +"description": "The type of the peering route.", +"enum": [ +"DYNAMIC_PEERING_ROUTE", +"STATIC_PEERING_ROUTE", +"SUBNET_PEERING_ROUTE" +], +"enumDescriptions": [ +"For routes exported from local network.", +"The peering route.", +"The peering route corresponding to subnetwork range." +], +"type": "string" +} +}, +"type": "object" +}, +"ExchangedPeeringRoutesList": { +"id": "ExchangedPeeringRoutesList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of ExchangedPeeringRoute resources.", +"items": { +"$ref": "ExchangedPeeringRoute" +}, +"type": "array" +}, +"kind": { +"default": "compute#exchangedPeeringRoutesList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering\nroutes lists.", +"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.", +"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" +}, +"Expr": { +"description": "Represents a textual expression in the Common Expression Language (CEL)\nsyntax. CEL is a C-like expression language. The syntax and semantics of CEL\nare documented at https://github.com/google/cel-spec.\n\nExample (Comparison):\n\n title: \"Summary size limit\"\n description: \"Determines if a summary is less than 100 chars\"\n expression: \"document.summary.size() < 100\"\n\nExample (Equality):\n\n title: \"Requestor is owner\"\n description: \"Determines if requestor is the document owner\"\n expression: \"document.owner == request.auth.claims.email\"\n\nExample (Logic):\n\n title: \"Public documents\"\n description: \"Determine whether the document should be publicly visible\"\n expression: \"document.type != 'private' && document.type != 'internal'\"\n\nExample (Data Manipulation):\n\n title: \"Notification string\"\n description: \"Create a notification string with a timestamp.\"\n expression: \"'New message received at ' + string(document.create_time)\"\n\nThe exact variables and functions that may be referenced within an expression\nare determined by the service that evaluates it. See the service\ndocumentation for additional information.", +"id": "Expr", +"properties": { +"description": { +"description": "Optional. Description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.", +"type": "string" +}, +"expression": { +"description": "Textual representation of an expression in Common Expression Language\nsyntax.", +"type": "string" +}, +"location": { +"description": "Optional. String indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.", +"type": "string" +}, +"title": { +"description": "Optional. Title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.", +"type": "string" +} +}, +"type": "object" +}, +"ExternalVpnGateway": { +"description": "Represents an external VPN gateway.\n\nExternal VPN gateway is the on-premises VPN gateway(s) or another cloud\nprovider's VPN gateway that connects to your Google Cloud VPN gateway.\n\nTo create a highly available VPN from Google Cloud Platform to your\nVPN gateway or another cloud provider's VPN gateway, you must create a\nexternal VPN gateway resource with information about the other gateway.\n\nFor more information about using external VPN gateways, see\nCreating an HA VPN gateway and tunnel pair to a peer VPN.", +"id": "ExternalVpnGateway", +"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" +}, +"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" +}, +"interfaces": { +"description": "A list of interfaces for this external VPN gateway.\n\nIf your peer-side gateway is an on-premises gateway and non-AWS cloud\nproviders' gateway, at most two interfaces can be provided for an external\nVPN gateway. If your peer side is an AWS virtual private gateway, four\ninterfaces should be provided for an external VPN gateway.", +"items": { +"$ref": "ExternalVpnGatewayInterface" +}, +"type": "array" +}, +"kind": { +"default": "compute#externalVpnGateway", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this ExternalVpnGateway,\nwhich is essentially a hash of the labels set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an ExternalVpnGateway.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.externalVpnGateways.insert" +] +}, +"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 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" +}, +"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": [ +"FOUR_IPS_REDUNDANCY", +"SINGLE_IP_INTERNALLY_REDUNDANT", +"TWO_IPS_REDUNDANCY" +], +"enumDescriptions": [ +"The external VPN gateway has four public IP addresses; at the time of\nwriting this API, the AWS virtual private gateway is an example which has\nfour public IP addresses for high availability connections; there should\nbe two VPN connections in the AWS virtual private gateway , each AWS VPN\nconnection has two public IP addresses; please make sure to put two\npublic IP addresses from one AWS VPN connection into interfaces 0 and 1\nof this external VPN gateway, and put the other two public IP addresses\nfrom another AWS VPN connection into interfaces 2 and 3 of this external\nVPN gateway. When displaying highly available configuration status\nfor the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN\ngateway, Google will always detect whether interfaces 0 and 1 are\nconnected on one interface of HA Cloud VPN gateway, and detect whether\ninterfaces 2 and 3 are connected to another interface of the HA Cloud VPN\ngateway.", +"The external VPN gateway has only one public IP address which internally\nprovide redundancy or failover.", +"The external VPN gateway has two public IP addresses which are redundant\nwith each other, the following two types of setup on your on-premises\nside would have this type of redundancy:\n(1) Two separate on-premises gateways, each with one public IP address,\n the two on-premises gateways are redundant with each other.\n(2) A single on-premise gateway with two public IP addresses that are\n redundant with eatch other." +], +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ExternalVpnGatewayInterface": { +"description": "The interface for the external VPN gateway.", +"id": "ExternalVpnGatewayInterface", +"properties": { +"id": { +"description": "The numeric ID of this interface.\nThe allowed input values for this id for different redundancy types of\nexternal VPN gateway:\n \n - SINGLE_IP_INTERNALLY_REDUNDANT - 0\n - TWO_IPS_REDUNDANCY - 0, 1\n - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3", +"format": "uint32", +"type": "integer" +}, +"ipAddress": { +"description": "IP address of the interface in the external VPN gateway. Only IPv4 is\nsupported. This IP address can be either from your on-premise gateway or\nanother Cloud provider's VPN gateway, it cannot be an IP address from\nGoogle Compute Engine.", +"type": "string" +}, +"ipv6Address": { +"description": "IPv6 address of the interface in the external VPN gateway. This IPv6\naddress can be either from your on-premise gateway or another Cloud\nprovider's VPN gateway, it cannot be an IP address from Google Compute\nEngine. Must specify an IPv6 address (not IPV4-mapped) using any format\ndescribed in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format\nis RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", +"type": "string" +} +}, +"type": "object" +}, +"ExternalVpnGatewayList": { +"description": "Response to the list request, and contains a list of externalVpnGateways.", +"id": "ExternalVpnGatewayList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of ExternalVpnGateway resources.", +"items": { +"$ref": "ExternalVpnGateway" +}, +"type": "array" +}, +"kind": { +"default": "compute#externalVpnGatewayList", +"description": "Output only. [Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways.", +"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.", +"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" +}, +"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": { +"content": { +"description": "The raw content in the secure keys file.", +"format": "byte", +"type": "string" +}, +"fileType": { +"description": "The file type of source file.", +"enum": [ +"BIN", +"UNDEFINED", +"X509" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"Firewall": { +"description": "Represents a Firewall Rule resource.\n\nFirewall rules allow or deny ingress traffic to, and egress traffic from your\ninstances. For more information, readFirewall rules.", +"id": "Firewall", +"properties": { +"allowed": { +"description": "The list of ALLOW rules specified by this firewall. Each rule specifies a\nprotocol and port-range tuple that describes a permitted connection.", +"items": { +"properties": { +"IPProtocol": { +"description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be one of the\nfollowing well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.", +"type": "string" +}, +"ports": { +"description": "An optional list of ports to which this rule applies.\nThis field is only applicable for the UDP or TCP protocol.\nEach entry must be either an integer or a range.\nIf not specified, this rule applies to connections through any port.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"],\nand [\"12345-12349\"].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"denied": { +"description": "The list of DENY rules specified by this firewall. Each rule specifies a\nprotocol and port-range tuple that describes a denied connection.", +"items": { +"properties": { +"IPProtocol": { +"description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be one of the\nfollowing well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.", +"type": "string" +}, +"ports": { +"description": "An optional list of ports to which this rule applies.\nThis field is only applicable for the UDP or TCP protocol.\nEach entry must be either an integer or a range.\nIf not specified, this rule applies to connections through any port.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"],\nand [\"12345-12349\"].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"type": "array" +}, +"description": { +"description": "An optional description of this resource. Provide this field when you\ncreate the resource.", +"type": "string" +}, +"destinationRanges": { +"description": "If destination ranges are specified, the firewall rule applies only to\ntraffic that has destination IP address in these ranges. These ranges must\nbe expressed inCIDR format. Both IPv4 and IPv6 are supported.", +"items": { +"type": "string" +}, +"type": "array" +}, +"direction": { +"description": "Direction of traffic to which this firewall applies, either `INGRESS` or\n`EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot\nspecify the sourceTags fields.", +"enum": [ +"EGRESS", +"INGRESS" +], +"enumDescriptions": [ +"Indicates that firewall should apply to outgoing traffic.", +"Indicates that firewall should apply to incoming traffic." +], +"type": "string" +}, +"disabled": { +"description": "Denotes whether the firewall rule is disabled. When set to true, the\nfirewall rule is not enforced and the network behaves as if it did not\nexist. If this is unspecified, the firewall rule will be enabled.", +"type": "boolean" +}, +"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#firewall", +"description": "Output only. [Output Only] Type of the resource. Always compute#firewall\nfor firewall rules.", +"readOnly": true, +"type": "string" +}, +"logConfig": { +"$ref": "FirewallLogConfig", +"description": "This field denotes the logging options for a particular firewall rule. If\nlogging is enabled, logs will be exported to Cloud Logging." +}, +"name": { +"annotations": { +"required": [ +"compute.firewalls.insert", +"compute.firewalls.patch" +] +}, +"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])?`. The first character\nmust be a lowercase letter, and all following characters (except for the\nlast character) must be a dash, lowercase letter, or digit. The last\ncharacter must be a lowercase letter or digit.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"network": { +"description": "URL of the network resource for this firewall rule. If not\nspecified when creating a firewall rule, the default network\nis used:\n\nglobal/networks/default\n\nIf you choose to specify this field, you can specify the network as a full \nor partial URL. For example, the following are all valid URLs: \n \n - \n https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network \n - projects/myproject/global/networks/my-network \n - global/networks/default", +"type": "string" +}, +"params": { +"$ref": "FirewallParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"priority": { +"description": "Priority for this rule.\nThis is an integer between `0` and `65535`, both inclusive.\nThe default value is `1000`.\nRelative priorities determine which rule takes effect if multiple rules\napply. Lower values indicate higher priority. For example, a rule with\npriority `0` has higher precedence than a rule with priority `1`.\nDENY rules take precedence over ALLOW rules if they have equal priority.\nNote that VPC networks have implied\nrules with a priority of `65535`. To avoid conflicts with the implied\nrules, use a priority number less than `65535`.", +"format": "int32", +"type": "integer" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"sourceRanges": { +"description": "If source ranges are specified, the firewall rule applies only to traffic\nthat has a source IP address in these ranges. These ranges must be\nexpressed inCIDR format. One or both of sourceRanges\nand sourceTags may be set.\nIf both fields are set, the rule applies to traffic that has a\nsource IP address within sourceRanges OR a source IP\nfrom a resource with a matching tag listed in thesourceTags field. The connection does not need to match\nboth fields for the rule to\napply. Both IPv4 and IPv6 are supported.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceServiceAccounts": { +"description": "If source service accounts are specified, the firewall rules apply only to\ntraffic originating from an instance with a service account in this list.\nSource service accounts cannot be used to control traffic to an instance's\nexternal IP address because service accounts are associated with an\ninstance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.\nIf both are set, the firewall applies to traffic that\nhas a source IP address within the sourceRanges OR a source\nIP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match\nboth fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceTags": { +"description": "If source tags are specified, the firewall rule applies only to traffic\nwith source IPs that match the primary network interfaces of VM instances\nthat have the tag and are in the same VPC network.\nSource tags cannot be used to control traffic to an instance's external IP\naddress, it only applies to traffic between instances in the same virtual\nnetwork. Because tags are associated with instances, not IP addresses.\nOne or both of sourceRanges and sourceTags may be\nset. If both fields are set, the firewall applies to traffic that has a\nsource IP address within sourceRanges OR a source IP from a\nresource with a matching tag listed in the sourceTags\nfield. The connection does not need to match both fields for the\nfirewall to apply.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetServiceAccounts": { +"description": "A list of service accounts indicating sets of instances located in the\nnetwork that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.\nIf neither targetServiceAccounts nor targetTags\nare specified, the firewall rule applies to all instances on the specified\nnetwork.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetTags": { +"description": "A list of tags that controls which instances the firewall rule\napplies to. If targetTags are specified, then the firewall\nrule applies only to instances in the VPC network that have one of those\ntags. If no targetTags are specified, the firewall rule\napplies to all instances on the specified network.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"FirewallList": { +"description": "Contains a list of firewalls.", +"id": "FirewallList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Firewall resources.", +"items": { +"$ref": "Firewall" +}, +"type": "array" +}, +"kind": { +"default": "compute#firewallList", +"description": "Output only. [Output Only] Type of resource. Always compute#firewallList\nfor lists of firewalls.", +"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.", +"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" +}, +"FirewallLogConfig": { +"description": "The available logging options for a firewall rule.", +"id": "FirewallLogConfig", +"properties": { +"enable": { +"description": "This field denotes whether to enable logging for a particular firewall\nrule.", +"type": "boolean" +}, +"metadata": { +"description": "This field can only be specified for a particular firewall rule if\nlogging is enabled for that rule. This field denotes whether to include\nor exclude metadata for firewall logs.", +"enum": [ +"EXCLUDE_ALL_METADATA", +"INCLUDE_ALL_METADATA" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"FirewallParams": { +"description": "Additional firewall parameters.", +"id": "FirewallParams", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"FirewallPoliciesListAssociationsResponse": { +"id": "FirewallPoliciesListAssociationsResponse", +"properties": { +"associations": { +"description": "A list of associations.", +"items": { +"$ref": "FirewallPolicyAssociation" +}, +"type": "array" +}, +"kind": { +"default": "compute#firewallPoliciesListAssociationsResponse", +"description": "Output only. [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of\nfirewallPolicy associations.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FirewallPoliciesScopedList": { +"id": "FirewallPoliciesScopedList", +"properties": { +"firewallPolicies": { +"description": "A list of firewall policies contained in this scope.", +"items": { +"$ref": "FirewallPolicy" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of firewall policies when\nthe 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.", +"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" +}, +"FirewallPolicy": { +"description": "Represents a Firewall Policy resource.", +"id": "FirewallPolicy", +"properties": { +"associations": { +"description": "A list of associations that belong to this firewall policy.", +"items": { +"$ref": "FirewallPolicyAssociation" +}, +"type": "array" +}, +"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" +}, +"displayName": { +"deprecated": true, +"description": "Deprecated, please use short name instead. User-provided name of the\nOrganization firewall policy. The name should be unique in the organization\nin which the firewall policy is created.\nThis field is not applicable to network firewall policies.\nThis name must be set on creation and cannot be changed.\nThe 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 `[a-z]([-a-z0-9]*[a-z0-9])?` which\nmeans the first character must be a lowercase letter, and all following\ncharacters must be a dash, lowercase letter, or digit, except the last\ncharacter, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"fingerprint": { +"description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make get() request to the\nfirewall policy.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#firewallPolicy", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Name of the resource. For Organization Firewall Policies it's a\n[Output Only] numeric ID allocated by Google Cloud which uniquely\nidentifies the Organization Firewall Policy.", +"type": "string" +}, +"packetMirroringRules": { +"description": "A list of packet mirroring rules that belong to this policy.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"type": "array" +}, +"parent": { +"description": "Output only. [Output Only] The parent of the firewall policy.\nThis field is not applicable to network firewall policies.", +"readOnly": true, +"type": "string" +}, +"policyType": { +"description": "The type of the firewall policy. This field can be one of\nVPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.\n\nNote: if not specified then VPC_POLICY will be used.", +"enum": [ +"RDMA_ROCE_POLICY", +"ULL_POLICY", +"VPC_POLICY" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional firewall policy resides.\nThis field is not applicable to global firewall policies.\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" +}, +"ruleTupleCount": { +"description": "Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall\npolicy can not exceed a set number of tuples.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"rules": { +"description": "A list of rules that belong to this policy.\nThere must always be a default rule (rule with priority 2147483647 and\nmatch \"*\"). If no rules are provided when creating a firewall policy, a\ndefault rule with action \"allow\" will be added.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"type": "array" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"shortName": { +"description": "User-provided name of the Organization firewall policy. The name should be\nunique in the organization in which the firewall policy is created.\nThis field is not applicable to network firewall policies.\nThis name must be set on creation and cannot be changed. The name must be\n1-63 characters long, and comply with RFC1035.\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" +} +}, +"type": "object" +}, +"FirewallPolicyAssociation": { +"id": "FirewallPolicyAssociation", +"properties": { +"attachmentTarget": { +"description": "The target that the firewall policy is attached to.", +"type": "string" +}, +"displayName": { +"deprecated": true, +"description": "[Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy of the association.", +"type": "string" +}, +"firewallPolicyId": { +"description": "Output only. [Output Only] The firewall policy ID of the association.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "The name for an association.", +"type": "string" +}, +"priority": { +"description": "An integer indicating the priority of an association. The priority\nmust be a positive value between 1 and 2147483647.\nFirewall Policies are evaluated from highest to lowest priority where 1\nis the highest priority and 2147483647 is the lowest priority.\nThe default value is `1000`. If two associations have the same priority\nthen lexicographical order on association names is applied.", +"format": "int32", +"type": "integer" +}, +"shortName": { +"description": "Output only. [Output Only] The short name of the firewall policy of the association.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FirewallPolicyList": { +"id": "FirewallPolicyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of FirewallPolicy resources.", +"items": { +"$ref": "FirewallPolicy" +}, +"type": "array" +}, +"kind": { +"default": "compute#firewallPolicyList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies", +"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" +}, +"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" +}, +"FirewallPolicyRule": { +"description": "Represents a rule that describes one or more match conditions along with\nthe action to be taken when traffic matches this condition (allow or deny).", +"id": "FirewallPolicyRule", +"properties": { +"action": { +"description": "The Action to perform when the client connection triggers the rule.\nValid actions for firewall rules are: \"allow\", \"deny\",\n\"apply_security_profile_group\" and \"goto_next\" (\n\"apply_security_profile_group\" can be specified only for global\nnetwork firewall policies or hierarchical firewall policies).\nValid actions for packet mirroring rules are: \"mirror\", \"do_not_mirror\"\nand \"goto_next\".", +"type": "string" +}, +"description": { +"description": "An optional description for this resource.", +"type": "string" +}, +"direction": { +"description": "The direction in which this rule applies.", +"enum": [ +"EGRESS", +"INGRESS" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"disabled": { +"description": "Denotes whether the firewall policy rule is disabled. When set to true,\nthe firewall policy rule is not enforced and traffic behaves as if it did\nnot exist. If this is unspecified, the firewall policy rule will be\nenabled.", +"type": "boolean" +}, +"enableLogging": { +"description": "Denotes whether to enable logging for a particular rule. If logging is\nenabled, logs will be exported to the configured export destination in\nStackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you\ncannot enable logging on \"goto_next\" rules.", +"type": "boolean" +}, +"kind": { +"default": "compute#firewallPolicyRule", +"description": "Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.", +"readOnly": true, +"type": "string" +}, +"match": { +"$ref": "FirewallPolicyRuleMatcher", +"description": "A match condition that incoming traffic is evaluated against.\nIf it evaluates to true, the corresponding 'action' is enforced." +}, +"priority": { +"description": "An integer indicating the priority of a rule in the list. The priority\nmust be a positive value between 0 and 2147483647.\nRules are evaluated from highest to lowest priority where 0 is the\nhighest priority and 2147483647 is the lowest priority.", +"format": "int32", +"type": "integer" +}, +"ruleName": { +"description": "An optional name for the rule. This field is not a unique identifier\nand can be updated.", +"type": "string" +}, +"ruleTupleCount": { +"description": "Output only. [Output Only] Calculation of the complexity of a single firewall policy\nrule.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"securityProfileGroup": { +"description": "A fully-qualified URL of a SecurityProfileGroup resource instance.\nExample:\nhttps://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group\nMust be specified if action is one of 'apply_security_profile_group' or\n'mirror'. Cannot be specified for other actions. Can be specified only\nfor global network firewall policies or hierarchical firewall policies.", +"type": "string" +}, +"targetForwardingRules": { +"description": "A list of forwarding rules to which this rule applies.\nThis field allows you to control which load balancers get this rule.\nFor example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule\n - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule\n - projects/project/global/\n forwardingRules/forwardingRule\n - projects/project/regions/region/forwardingRules/\n forwardingRule", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetResources": { +"description": "A list of network resource URLs to which this rule applies. This field\nallows you to control which network's VMs get this rule. If this field\nis left blank, all VMs within the organization will receive the rule.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetSecureTags": { +"description": "A list of secure tags that controls which instances the firewall rule\napplies to. If targetSecureTag are specified, then the\nfirewall rule applies only to instances in the VPC network that have one\nof those EFFECTIVE secure tags, if all the target_secure_tag are in\nINEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.\nIf neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies\nto all instances on the specified network.\nMaximum number of target label tags allowed is 256.", +"items": { +"$ref": "FirewallPolicyRuleSecureTag" +}, +"type": "array" +}, +"targetServiceAccounts": { +"description": "A list of service accounts indicating the sets of instances that are\napplied with this rule.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetType": { +"description": "Target types of the firewall policy rule.\nDefault value is INSTANCES.", +"enum": [ +"INSTANCES", +"INTERNAL_MANAGED_LB" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"tlsInspect": { +"description": "Boolean flag indicating if the traffic should be TLS decrypted.\nCan be set only if action = 'apply_security_profile_group' and cannot\nbe set for other actions.", +"type": "boolean" +} +}, +"type": "object" +}, +"FirewallPolicyRuleMatcher": { +"description": "Represents a match condition that incoming traffic is evaluated against.\nExactly one field must be specified.", +"id": "FirewallPolicyRuleMatcher", +"properties": { +"destAddressGroups": { +"description": "Address groups which should be matched against the traffic destination.\nMaximum number of destination address groups is 10.", +"items": { +"type": "string" +}, +"type": "array" +}, +"destFqdns": { +"description": "Fully Qualified Domain Name (FQDN) which should be matched against\ntraffic destination.\nMaximum number of destination fqdn allowed is 100.", +"items": { +"type": "string" +}, +"type": "array" +}, +"destIpRanges": { +"description": "CIDR IP address range.\nMaximum number of destination CIDR IP ranges allowed is 5000.", +"items": { +"type": "string" +}, +"type": "array" +}, +"destNetworkContext": { +"description": "Network context of the traffic destination. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - NON_INTERNET", +"enum": [ +"INTERNET", +"INTRA_VPC", +"NON_INTERNET", +"UNSPECIFIED", +"VPC_NETWORKS" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"destNetworkType": { +"description": "Network type of the traffic destination. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - NON_INTERNET", +"enum": [ +"INTERNET", +"INTRA_VPC", +"NON_INTERNET", +"UNSPECIFIED", +"VPC_NETWORKS" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"destRegionCodes": { +"description": "Region codes whose IP addresses will be used to match for destination\nof traffic. Should be specified as 2 letter country code defined as per\nISO 3166 alpha-2 country codes. ex.\"US\"\nMaximum number of dest region codes allowed is 5000.", +"items": { +"type": "string" +}, +"type": "array" +}, +"destThreatIntelligences": { +"description": "Names of Network Threat Intelligence lists.\nThe IPs in these lists will be matched against traffic destination.", +"items": { +"type": "string" +}, +"type": "array" +}, +"layer4Configs": { +"description": "Pairs of IP protocols and ports that the rule should match.", +"items": { +"$ref": "FirewallPolicyRuleMatcherLayer4Config" +}, +"type": "array" +}, +"srcAddressGroups": { +"description": "Address groups which should be matched against the traffic source.\nMaximum number of source address groups is 10.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcFqdns": { +"description": "Fully Qualified Domain Name (FQDN) which should be matched against\ntraffic source.\nMaximum number of source fqdn allowed is 100.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcIpRanges": { +"description": "CIDR IP address range.\nMaximum number of source CIDR IP ranges allowed is 5000.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcNetworkContext": { +"description": "Network context of the traffic source. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - INTRA_VPC\n - NON_INTERNET\n - VPC_NETWORKS", +"enum": [ +"INTERNET", +"INTRA_VPC", +"NON_INTERNET", +"UNSPECIFIED", +"VPC_NETWORKS" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"srcNetworkType": { +"description": "Network type of the traffic source. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - INTRA_VPC\n - NON_INTERNET\n - VPC_NETWORKS", +"enum": [ +"INTERNET", +"INTRA_VPC", +"NON_INTERNET", +"UNSPECIFIED", +"VPC_NETWORKS" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"srcNetworks": { +"description": "Networks of the traffic source. It can be either a full or partial url.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcRegionCodes": { +"description": "Region codes whose IP addresses will be used to match for source\nof traffic. Should be specified as 2 letter country code defined as per\nISO 3166 alpha-2 country codes. ex.\"US\"\nMaximum number of source region codes allowed is 5000.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcSecureTags": { +"description": "List of secure tag values, which should be matched at the source\nof the traffic.\nFor INGRESS rule, if all the srcSecureTag are INEFFECTIVE,\nand there is no srcIpRange, this rule will be ignored.\nMaximum number of source tag values allowed is 256.", +"items": { +"$ref": "FirewallPolicyRuleSecureTag" +}, +"type": "array" +}, +"srcThreatIntelligences": { +"description": "Names of Network Threat Intelligence lists.\nThe IPs in these lists will be matched against traffic source.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"FirewallPolicyRuleMatcherLayer4Config": { +"id": "FirewallPolicyRuleMatcherLayer4Config", +"properties": { +"ipProtocol": { +"description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be\none of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP\nprotocol number.", +"type": "string" +}, +"ports": { +"description": "An optional list of ports to which this rule applies. This field is\nonly applicable for UDP or TCP protocol. Each entry must be either\nan integer or a range. If not specified, this rule applies to\nconnections through any port.\n\nExample inputs include: [\"22\"],[\"80\",\"443\"], and [\"12345-12349\"].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"FirewallPolicyRuleSecureTag": { +"id": "FirewallPolicyRuleSecureTag", +"properties": { +"name": { +"description": "Name of the secure tag, created with TagManager's TagValue API.", +"pattern": "tagValues/[0-9]+", +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or\n`INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted\nor its network is deleted.", +"enum": [ +"EFFECTIVE", +"INEFFECTIVE" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FixedOrPercent": { +"description": "Encapsulates numeric value that can be either absolute or relative.", +"id": "FixedOrPercent", +"properties": { +"calculated": { +"description": "Output only. Absolute value of VM instances calculated based on the specific mode.\n\n \n \n - If the value is fixed, then the calculated\n value is equal to the fixed value.\n - If the value is a percent, then the\n calculated\n value is percent/100 * targetSize. For example,\n the calculated value of a 80% of a managed instance group\n with 150 instances would be (80/100 * 150) = 120 VM instances. If there\n is a remainder, the number is rounded.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"fixed": { +"description": "Specifies a fixed number of VM instances. This must be a positive integer.", +"format": "int32", +"type": "integer" +}, +"percent": { +"description": "Specifies a percentage of instances between 0 to 100%, inclusive. For\nexample, specify 80 for 80%.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"FlexibleTimeRange": { +"description": "Specifies a flexible time range with flexible start time and duration.\n\nIt is possible to specify a contradictory time range that cannot be matched\nby any Interval. This causes a validation error.", +"id": "FlexibleTimeRange", +"properties": { +"maxDuration": { +"format": "google-duration", +"type": "string" +}, +"minDuration": { +"format": "google-duration", +"type": "string" +}, +"startTimeNotEarlierThan": { +"format": "google-datetime", +"type": "string" +}, +"startTimeNotLaterThan": { +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"ForwardingRule": { +"description": "Represents a Forwarding Rule resource.\n\nForwarding rule resources in Google Cloud can be either regional or global in\nscope:\n\n* [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)\n* [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)\n\nA forwarding rule and its corresponding IP address represent the frontend\nconfiguration of a Google Cloud load balancer.\nForwarding rules can also reference target instances and Cloud VPN Classic\ngateways (targetVpnGateway).\n\nFor more information, read\nForwarding rule concepts and\nUsing protocol forwarding.", +"id": "ForwardingRule", +"properties": { +"IPAddress": { +"description": "IP address for which this forwarding rule accepts traffic. When a client\nsends traffic to this IP address, the forwarding rule directs the traffic\nto the referenced target or backendService.\nWhile creating a forwarding rule, specifying an IPAddress is\nrequired under the following circumstances:\n\n \n - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.\n - When the target is a Private Service Connect Google APIs\n bundle, you must specify an IPAddress.\n\n\nOtherwise, you can optionally specify an IP address that references an\nexisting static (reserved) IP address resource. When omitted, Google Cloud\nassigns an ephemeral IP address.\n\nUse one of the following formats to specify an IP address while creating a\nforwarding rule:\n\n* IP address number, as in `100.1.2.3`\n* IPv6 address range, as in `2600:1234::/96`\n* Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name\n* Partial URL or by name, as in:\n \n - projects/project_id/regions/region/addresses/address-name\n - regions/region/addresses/address-name\n - global/addresses/address-name\n - address-name\n\n\n\nThe IP address can only be set at creation. Once set, it cannot be updated.\n\nThe forwarding rule's target or backendService,\nand in most cases, also the loadBalancingScheme, determine the\ntype of IP address that you can use. For detailed information, see\n[IP address\nspecifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n\nWhen reading an IPAddress, the API always returns the IP\naddress number.\n\nWhen creating a global external Passthrough Network Load Balancer\nforwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child\nforwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.", +"type": "string" +}, +"IPProtocol": { +"description": "The IP protocol to which this rule applies.\n\nFor protocol forwarding, valid\noptions are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.\n\nThe valid IP protocols are different for different load balancing products\nas described in [Load balancing\nfeatures](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).", +"enum": [ +"AH", +"ESP", +"ICMP", +"L3_DEFAULT", +"SCTP", +"TCP", +"UDP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"allPorts": { +"description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe allPorts field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, SCTP, or L3_DEFAULT.\n - It's applicable only to the following products: internal passthrough\n Network Load Balancers, backend service-based external passthrough Network\n Load Balancers, and internal and external protocol forwarding.\n - Set this field to true to allow packets addressed to any port or\n packets lacking destination port information (for example, UDP fragments\n after the first fragment) to be forwarded to the backends configured with\n this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.", +"type": "boolean" +}, +"allowGlobalAccess": { +"description": "If set to true, clients can access the internal passthrough Network Load\nBalancers, the regional internal Application Load Balancer, and the\nregional internal proxy Network Load Balancer from all regions.\nIf false, only allows access from the local region the load balancer is\nlocated at. Note that for INTERNAL_MANAGED forwarding rules, this field\ncannot be changed after the forwarding rule is created.", +"type": "boolean" +}, +"allowPscGlobalAccess": { +"description": "This is used in PSC consumer ForwardingRule to control whether the PSC\nendpoint can be accessed from another region.", +"type": "boolean" +}, +"attachedExtensions": { +"description": "Output only. [Output Only]. The extensions that are attached to this ForwardingRule.", +"items": { +"$ref": "ForwardingRuleAttachedExtension" +}, +"readOnly": true, +"type": "array" +}, +"backendService": { +"description": "Identifies the backend service to which the forwarding rule sends traffic.\n\nIt is a required field for the following load balancers:\n \n - Internal passthrough Network Load Balancers\n - Backend service-based regional external passthrough Network Load\n Balancers\n - Global external passthrough Network Load Balancers\n\n\n\nIt cannot be set by other load balancer types and protocol forwarding\nrules.", +"type": "string" +}, +"baseForwardingRule": { +"description": "Output only. [Output Only] The URL for the corresponding base forwarding rule. By base\nforwarding rule, we mean the forwarding rule that has the same IP address,\nprotocol, and port settings with the current forwarding rule, but without\nsourceIPRanges specified.\nAlways empty if the current forwarding rule does not have sourceIPRanges\nspecified.", +"readOnly": true, +"type": "string" +}, +"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" +}, +"externalManagedBackendBucketMigrationState": { +"description": "Specifies the canary migration state for the backend buckets attached to\nthis forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and\nTEST_ALL_TRAFFIC.\n\nTo begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be\nchanged to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before\nthe loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets\nattached to this forwarding rule by percentage using\nexternalManagedBackendBucketMigrationTestingPercentage.\n\nRolling back a migration requires the states to be set in reverse order. So\nchanging the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to\nbe set to TEST_ALL_TRAFFIC at the same time. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate some traffic back to\nEXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", +"enum": [ +"PREPARE", +"TEST_ALL_TRAFFIC", +"TEST_BY_PERCENTAGE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"externalManagedBackendBucketMigrationTestingPercentage": { +"description": "Determines the fraction of requests to backend buckets that should be\nprocessed by the global external Application Load Balancer.\n\nThe value of this field must be in the range [0, 100].\n\nThis value can only be set if the loadBalancingScheme in the BackendService\nis set to EXTERNAL (when using the classic Application Load Balancer) and\nthe migration state is TEST_BY_PERCENTAGE.", +"format": "float", +"type": "number" +}, +"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 ForwardingRule. Include the fingerprint in patch request to\nensure that you do not overwrite changes that were applied from another\nconcurrent request.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a ForwardingRule.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"ipCollection": { +"description": "Resource reference of a PublicDelegatedPrefix. The PDP must\nbe a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.\n\nUse one of the following formats to specify a sub-PDP when creating an IPv6\nNetLB forwarding rule using BYOIP:\nFull resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name\nPartial URL, as in:\n \n - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - regions/region/publicDelegatedPrefixes/sub-pdp-name", +"type": "string" +}, +"ipVersion": { +"description": "The IP Version that will be used by this forwarding rule. Valid options\nare IPV4 or IPV6.", +"enum": [ +"IPV4", +"IPV6", +"UNSPECIFIED_VERSION" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"isMirroringCollector": { +"description": "Indicates whether or not this load balancer can be used as a collector for\npacket mirroring. To prevent mirroring loops, instances behind this\nload balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.\nThis can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.", +"type": "boolean" +}, +"kind": { +"default": "compute#forwardingRule", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this resource, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a ForwardingRule.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"loadBalancingScheme": { +"description": "Specifies the forwarding rule type.\n\nFor more information, refer to \nForwarding rule product and scheme table.", +"enum": [ +"EXTERNAL", +"EXTERNAL_MANAGED", +"INTERNAL", +"INTERNAL_MANAGED", +"INTERNAL_SELF_MANAGED", +"INVALID" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"metadataFilters": { +"description": "Opaque filter criteria used by load balancer to restrict routing\nconfiguration to a limited set of xDS\ncompliant clients. In their xDS requests to load balancer, xDS clients\npresent node\nmetadata. When there is a match, the relevant configuration\nis made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)\nreferenced by the ForwardingRule are not visible to\nthose proxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied\nin order to be considered a match.\n\nmetadataFilters specified here will be applifed before\nthose specified in the UrlMap that thisForwardingRule references.\n\nmetadataFilters only applies to Loadbalancers that have\ntheir loadBalancingScheme set toINTERNAL_SELF_MANAGED.", +"items": { +"$ref": "MetadataFilter" +}, +"type": "array" +}, +"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.\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.\n\nFor Private Service Connect forwarding rules that forward traffic to Google\nAPIs, the forwarding rule name must be a 1-20 characters string with\nlowercase letters and numbers and must start with a letter.\n\nFor global external Passthrough Network Load Balancer forwarding rules, the\nforwarding rule name must be 1-43 characters long. For each global external\nPassthrough Network Load Balancer forwarding rule (a parent forwarding\nrule) that you create, Google Cloud generates two output-only child\nforwarding rules that are named by concatenating the parent forwarding rule\nname with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"network": { +"description": "This field is not used for global external load balancing.\n\nFor internal passthrough Network Load Balancers, this field identifies the\nnetwork that the load balanced IP should belong to for this forwarding\nrule.\nIf the subnetwork is specified, the network of the subnetwork will be used.\nIf neither subnetwork nor this field is specified, the default network will\nbe used.\n\nFor Private Service Connect forwarding rules that forward traffic to Google\nAPIs, a network must be provided.", +"type": "string" +}, +"networkTier": { +"description": "This signifies the networking tier used for configuring\nthis load balancer and can only take the following values:PREMIUM, STANDARD.\n\nFor regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.\n\nIf this field is not specified, it is assumed to be PREMIUM.\nIf IPAddress is specified, this value must be equal to the\nnetworkTier of the Address.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +}, +"noAutomateDnsZone": { +"description": "This is used in PSC consumer ForwardingRule to control whether it should\ntry to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use\nthis field. Once set, this field is not mutable.", +"type": "boolean" +}, +"portRange": { +"description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe portRange field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, or SCTP, and\n - It's applicable only to the following products: external passthrough\n Network Load Balancers, internal and external proxy Network Load Balancers,\n internal and external Application Load Balancers, external protocol\n forwarding, and Classic VPN.\n - Some products have restrictions on what ports can be used. See \n port specifications for details.\n\n\n\nFor external forwarding rules, two or more forwarding rules cannot use the\nsame [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol\nfields) if they have overlapping portRanges.\n\nFor internal forwarding rules within the same VPC network, two or more\nforwarding rules cannot use the same [IPAddress, IPProtocol]\npair, and cannot have overlapping portRanges.\n\n@pattern: \\\\d+(?:-\\\\d+)?", +"type": "string" +}, +"ports": { +"description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe ports field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, or SCTP, and\n - It's applicable only to the following products: internal passthrough\n Network Load Balancers, backend service-based external passthrough Network\n Load Balancers, and internal protocol forwarding.\n - You can specify a list of up to five ports by number, separated by\n commas. The ports can be contiguous or discontiguous.\n\n\n\nFor external forwarding rules, two or more forwarding rules cannot use the\nsame [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol\nfields) if they share at least one port number.\n\nFor internal forwarding rules within the same VPC network, two or more\nforwarding rules cannot use the same [IPAddress, IPProtocol]\npair if they share at least one port number.\n\n@pattern: \\\\d+(?:-\\\\d+)?", +"items": { +"type": "string" +}, +"type": "array" +}, +"pscConnectionId": { +"description": "[Output Only] The PSC connection id of the PSC forwarding rule.", +"format": "uint64", +"type": "string" +}, +"pscConnectionStatus": { +"enum": [ +"ACCEPTED", +"CLOSED", +"NEEDS_ATTENTION", +"PENDING", +"REJECTED", +"STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The connection has been accepted by the producer.", +"The connection has been closed by the producer and will not serve traffic\ngoing forward.", +"The connection has been accepted by the producer, but the producer needs\nto take further action before the forwarding rule can serve traffic.", +"The connection is pending acceptance by the producer.", +"The connection has been rejected by the producer.", +"" +], +"readOnly": true, +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional forwarding rule resides.\nThis field is not applicable to global forwarding rules.\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] Server-defined URL for the resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"serviceDirectoryRegistrations": { +"description": "Service Directory resources to register this forwarding rule with.\nCurrently, only supports a single Service Directory resource.", +"items": { +"$ref": "ForwardingRuleServiceDirectoryRegistration" +}, +"type": "array" +}, +"serviceLabel": { +"description": "An optional prefix to the service name for this forwarding rule.\nIf specified, the prefix is the first label of the fully qualified service\nname.\n\nThe label must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the label 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.\n\nThis field is only used for internal load balancing.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"serviceName": { +"description": "[Output Only]\nThe internal fully qualified service name for this forwarding rule.\n\nThis field is only used for internal load balancing.", +"type": "string" +}, +"sourceIpRanges": { +"description": "If not empty, this forwarding rule will only forward the traffic when the\nsource IP address matches one of the IP addresses or CIDR ranges set here.\nNote that a forwarding rule can only have up to 64 source IP ranges, and\nthis field can only be used with a regional forwarding rule whose scheme isEXTERNAL.\nEach source_ip_range entry should be either an IP address (for\nexample, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).", +"items": { +"type": "string" +}, +"type": "array" +}, +"subnetwork": { +"description": "This field identifies the subnetwork that the load balanced IP should\nbelong to for this forwarding rule, used with internal load balancers and\nexternal passthrough Network Load Balancers with IPv6.\n\nIf the network specified is in auto subnet mode, this field is optional.\nHowever, a subnetwork must be specified if the network is in custom subnet\nmode or when creating external forwarding rule with IPv6.", +"type": "string" +}, +"target": { +"description": "The URL of the target resource to receive the matched traffic. For\nregional forwarding rules, this target must be in the same region as the\nforwarding rule. For global forwarding rules, this target must be a global\nload balancing resource.\n\nThe forwarded traffic must be of a type appropriate to the target object.\n \n \n - For load balancers, see the \"Target\" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:\n \n \n - vpc-sc - APIs that support VPC Service Controls. \n - all-apis - All supported Google APIs. \n \n \n - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. \n\n\n\nThe following load balancers cannot set the target field (they should set the backendService field instead):\n \n - Internal passthrough Network Load Balancers\n - Backend service-based regional external passthrough Network Load\n Balancers\n - Global external passthrough Network Load Balancers", +"type": "string" +} +}, +"type": "object" +}, +"ForwardingRuleAggregatedList": { +"id": "ForwardingRuleAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "ForwardingRulesScopedList", +"description": "Name of the scope containing this set of addresses." +}, +"description": "A list of ForwardingRulesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#forwardingRuleAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules.", +"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" +}, +"ForwardingRuleAttachedExtension": { +"description": "Reference to an extension resource that is attached to this ForwardingRule.", +"id": "ForwardingRuleAttachedExtension", +"properties": { +"reference": { +"description": "Output only. The resource name.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ForwardingRuleList": { +"description": "Contains a list of ForwardingRule resources.", +"id": "ForwardingRuleList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of ForwardingRule resources.", +"items": { +"$ref": "ForwardingRule" +}, +"type": "array" +}, +"kind": { +"default": "compute#forwardingRuleList", +"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.", +"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" +}, +"ForwardingRuleReference": { +"id": "ForwardingRuleReference", +"properties": { +"forwardingRule": { +"type": "string" +} +}, +"type": "object" +}, +"ForwardingRuleServiceDirectoryRegistration": { +"description": "Describes the auto-registration of the forwarding rule to Service Directory.\nThe region and project of the Service Directory resource generated from\nthis registration will be the same as this forwarding rule.", +"id": "ForwardingRuleServiceDirectoryRegistration", +"properties": { +"namespace": { +"description": "Service Directory namespace to register the forwarding rule under.", +"type": "string" +}, +"service": { +"description": "Service Directory service to register the forwarding rule under.", +"type": "string" +}, +"serviceDirectoryRegion": { +"description": "[Optional] Service Directory region to register this global forwarding\nrule under. Default to \"us-central1\". Only used for PSC for Google APIs.\nAll PSC for Google APIs forwarding rules on the same network should use\nthe same Service Directory region.", +"type": "string" +} +}, +"type": "object" +}, +"ForwardingRulesScopedList": { +"id": "ForwardingRulesScopedList", +"properties": { +"forwardingRules": { +"description": "A list of forwarding rules contained in this scope.", +"items": { +"$ref": "ForwardingRule" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of forwarding rules when\nthe 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.", +"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" +}, +"FutureReservation": { +"id": "FutureReservation", +"properties": { +"aggregateReservation": { +"$ref": "AllocationAggregateReservation", +"description": "Aggregate reservation details for the future reservation." +}, +"autoCreatedReservationsDeleteTime": { +"description": "Future timestamp when the FR auto-created reservations will be deleted by\nCompute Engine. Format of this field must be a valid\nhref=\"https://www.ietf.org/rfc/rfc3339.txt\">RFC3339 value.", +"type": "string" +}, +"autoCreatedReservationsDuration": { +"$ref": "Duration", +"description": "Specifies the duration of auto-created reservations.\nIt represents relative time to future reservation start_time when\nauto-created reservations will be automatically deleted by Compute\nEngine. Duration time unit is represented as a count of seconds\nand fractions of seconds at nanosecond resolution." +}, +"autoDeleteAutoCreatedReservations": { +"description": "Setting for enabling or disabling automatic deletion for auto-created\nreservation. If set to true, auto-created reservations will be\ndeleted at Future Reservation's end time (default) or at user's defined\ntimestamp if any of the\n[auto_created_reservations_delete_time, auto_created_reservations_duration]\nvalues is specified.\nFor keeping auto-created reservation indefinitely, this value should be set\nto false.", +"type": "boolean" +}, +"colocationResource": { +"description": "Full or partial URL of an existing future reservation to indicate\nintent for reserving capacity in the same cluster as the colocation\nresource.", +"type": "string" +}, +"commitmentInfo": { +"$ref": "FutureReservationCommitmentInfo", +"description": "If not present, then FR will not deliver a new commitment or update an\nexisting commitment." +}, +"confidentialComputeType": { +"enum": [ +"CONFIDENTIAL_COMPUTE_TYPE_BMSAI", +"CONFIDENTIAL_COMPUTE_TYPE_TDX", +"CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Bare Metal Secure AI.", +"Intel Trust Domain Extensions.", +"" +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] The creation timestamp for this future reservation inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"deploymentType": { +"description": "Type of the deployment requested as part of future reservation.", +"enum": [ +"DENSE", +"DEPLOYMENT_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"The reserved capacity is made up of densely deployed reservation blocks.", +"" +], +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the future reservation.", +"type": "string" +}, +"enableEmergentMaintenance": { +"description": "Indicates if this group of VMs have emergent maintenance enabled.", +"type": "boolean" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this future reservation. The server\ndefines this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#futureReservation", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instances.insert" +] +}, +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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" +}, +"namePrefix": { +"description": "Name prefix for the reservations to be created at the time of\ndelivery. The name prefix must comply with RFC1035.\nMaximum allowed length for name prefix is 20. Automatically created\nreservations name format will be -date-####.", +"type": "string" +}, +"params": { +"$ref": "FutureReservationParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"planningStatus": { +"description": "Planning state before being submitted for evaluation", +"enum": [ +"DRAFT", +"PLANNING_STATUS_UNSPECIFIED", +"SUBMITTED" +], +"enumDescriptions": [ +"Future Reservation is being drafted.", +"", +"Future Reservation has been submitted for evaluation by GCP." +], +"type": "string" +}, +"reservationMode": { +"description": "The reservation mode which determines reservation-termination behavior and\nexpected pricing.", +"enum": [ +"CALENDAR", +"DEFAULT", +"RESERVATION_MODE_UNSPECIFIED" +], +"enumDescriptions": [ +"The delivered reservations will delivered at specified start time and\nterminated at specified end time along with terminating the VMs running\non it.", +"The delivered reservations do not terminate VMs at the end of\nreservations. This is default mode.", +"" +], +"type": "string" +}, +"reservationName": { +"description": "Name of reservations where the capacity is provisioned at the time of\ndelivery of future reservations. If the reservation with the given name\ndoes not exist already, it is created automatically at the time of Approval\nwith INACTIVE state till specified start-time. Either provide the\nreservation_name or a name_prefix.", +"type": "string" +}, +"resourceMetadata": { +"$ref": "ResourceMetadata", +"description": "Output only. Contains standard resource metadata for an FutureReservation\nresource. It is populated for each instance of the FutureReservation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", +"readOnly": true +}, +"resourceName": { +"description": "Name of the resource intended to be delivered. Name should conform to\nRFC1035. This will be the name of storage pool or Exapool for persistent\ndisk FRs.", +"type": "string" +}, +"schedulingType": { +"description": "Maintenance information for this reservation", +"enum": [ +"GROUPED", +"GROUP_MAINTENANCE_TYPE_UNSPECIFIED", +"INDEPENDENT" +], +"enumDescriptions": [ +"Maintenance on all reserved instances in the reservation is synchronized.", +"Unknown maintenance type.", +"Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." +], +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"shareSettings": { +"$ref": "ShareSettings", +"description": "List of Projects/Folders to share with." +}, +"specificReservationRequired": { +"description": "Indicates whether the auto-created reservation can be consumed by VMs with\naffinity for \"any\" reservation. If the field is set, then only VMs that\ntarget the reservation by name can consume from the delivered reservation.", +"type": "boolean" +}, +"specificSkuProperties": { +"$ref": "FutureReservationSpecificSKUProperties", +"description": "Future Reservation configuration to indicate instance properties and\ntotal count." +}, +"status": { +"$ref": "FutureReservationStatus", +"description": "Output only. [Output only] Status of the Future Reservation", +"readOnly": true +}, +"storagePoolProperties": { +"$ref": "FutureReservationStoragePoolProperties", +"description": "Storage pool details for the future reservation." +}, +"timeWindow": { +"$ref": "FutureReservationTimeWindow", +"description": "Time window for this Future Reservation." +}, +"zone": { +"description": "Output only. [Output Only] URL of the Zone where this future reservation resides.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationCommitmentInfo": { +"id": "FutureReservationCommitmentInfo", +"properties": { +"commitmentName": { +"description": "name of the commitment where capacity is being delivered to.", +"type": "string" +}, +"commitmentPlan": { +"description": "Indicates if a Commitment needs to be created as part of FR delivery. If\nthis field is not present, then no\ncommitment needs to be created.", +"enum": [ +"INVALID", +"THIRTY_SIX_MONTH", +"TWELVE_MONTH" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"previousCommitmentTerms": { +"description": "Only applicable if FR is delivering to the same reservation. If set, all\nparent commitments will be extended to match the end date of the plan for\nthis commitment.", +"enum": [ +"EXTEND", +"PREVIOUSCOMMITMENTTERM_UNSPECIFIED" +], +"enumDescriptions": [ +"All associated parent Committed Used Discount(s) end-date/term will be\nextended to the end-time of this future reservation. Default is to\nextend previous commitment(s) time to the end_time of the reservation.", +"No changes to associated parents Committed Used Discount(s) terms." +], +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationParams": { +"description": "Additional future reservation params.", +"id": "FutureReservationParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the future 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" +}, +"FutureReservationSpecificSKUProperties": { +"id": "FutureReservationSpecificSKUProperties", +"properties": { +"instanceProperties": { +"$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties", +"description": "Properties of the SKU instances being reserved." +}, +"sourceInstanceTemplate": { +"description": "The instance template that will be used to populate the\nReservedInstanceProperties of the future reservation", +"type": "string" +}, +"totalCount": { +"description": "Total number of instances for which capacity assurance is requested at a\nfuture time period.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationStatus": { +"description": "[Output only] Represents status related to the future reservation.", +"id": "FutureReservationStatus", +"properties": { +"amendmentStatus": { +"description": "Output only. [Output Only] The current status of the requested amendment.", +"enum": [ +"AMENDMENT_APPROVED", +"AMENDMENT_DECLINED", +"AMENDMENT_IN_REVIEW", +"AMENDMENT_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The requested amendment to the Future Resevation has been approved and\napplied by GCP.", +"The requested amendment to the Future Reservation has been declined by\nGCP and the original state was restored.", +"The requested amendment to the Future Reservation is currently being\nreviewd by GCP.", +"" +], +"readOnly": true, +"type": "string" +}, +"autoCreatedReservations": { +"description": "Output only. Fully qualified urls of the automatically created reservations at\nstart_time.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"exapoolProvisionedCapacityGb": { +"$ref": "StoragePoolExapoolProvisionedCapacityGb", +"description": "Output only. Exapool provisioned capacities for each SKU type.", +"readOnly": true +}, +"existingMatchingUsageInfo": { +"$ref": "FutureReservationStatusExistingMatchingUsageInfo", +"description": "Output only. [Output Only] Represents the existing matching usage for the future\nreservation.", +"readOnly": true +}, +"fulfilledCount": { +"description": "Output only. This count indicates the fulfilled capacity so far. This is set during\n\"PROVISIONING\" state. This count also includes capacity delivered as part\nof existing matching reservations.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"lastKnownGoodState": { +"$ref": "FutureReservationStatusLastKnownGoodState", +"description": "Output only. [Output Only] This field represents the future reservation before an\namendment was requested. If the amendment is declined, the Future\nReservation will be reverted to the last known good state. The last known\ngood state is not set when updating a future reservation whose\nProcurement Status is DRAFTING.", +"readOnly": true +}, +"lockTime": { +"description": "Output only. Time when Future Reservation would become LOCKED, after which no\nmodifications to Future Reservation will be allowed. Applicable only\nafter the Future Reservation is in the APPROVED state. The lock_time is\nan RFC3339 string. The procurement_status will transition to PROCURING\nstate at this time.", +"readOnly": true, +"type": "string" +}, +"procurementStatus": { +"description": "Output only. Current state of this Future Reservation", +"enum": [ +"APPROVED", +"CANCELLED", +"COMMITTED", +"DECLINED", +"DRAFTING", +"FAILED", +"FAILED_PARTIALLY_FULFILLED", +"FULFILLED", +"PENDING_AMENDMENT_APPROVAL", +"PENDING_APPROVAL", +"PROCUREMENT_STATUS_UNSPECIFIED", +"PROCURING", +"PROVISIONING" +], +"enumDescriptions": [ +"Future reservation is approved by GCP.", +"Future reservation is cancelled by the customer.", +"Future reservation is committed by the customer.", +"Future reservation is rejected by GCP.", +"Related status for PlanningStatus.Draft. Transitions to\nPENDING_APPROVAL upon user submitting FR.", +"Future reservation failed. No additional reservations were provided.", +"Future reservation is partially fulfilled. Additional reservations were\nprovided but did not reach total_count reserved instance slots.", +"Future reservation is fulfilled completely.", +"An Amendment to the Future Reservation has been requested. If the\nAmendment is declined, the Future Reservation will be restored to the\nlast known good state.", +"Future reservation is pending approval by GCP.", +"", +"Future reservation is being procured by GCP. Beyond this point, Future\nreservation is locked and no further modifications are allowed.", +"Future reservation capacity is being provisioned. This state will be\nentered after start_time, while reservations are being created to\nprovide total_count reserved instance slots. This state will not\npersist past start_time + 24h." +], +"readOnly": true, +"type": "string" +}, +"specificSkuProperties": { +"$ref": "FutureReservationStatusSpecificSKUProperties" +}, +"storagePoolProvisionedCapacity": { +"$ref": "FutureReservationStoragePoolProvisionedCapacity", +"description": "Output only. Storage pool provisioned capacities for each SKU type.", +"readOnly": true +} +}, +"type": "object" +}, +"FutureReservationStatusExistingMatchingUsageInfo": { +"description": "[Output Only] Represents the existing matching usage for the future\nreservation.", +"id": "FutureReservationStatusExistingMatchingUsageInfo", +"properties": { +"count": { +"description": "Output only. Count to represent min(FR total_count,\nmatching_reserved_capacity+matching_unreserved_instances)", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"timestamp": { +"description": "Output only. Timestamp when the matching usage was calculated", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationStatusLastKnownGoodState": { +"description": "The state that the future reservation will be reverted to should the\namendment be declined.", +"id": "FutureReservationStatusLastKnownGoodState", +"properties": { +"description": { +"description": "Output only. [Output Only] The description of the FutureReservation before an\namendment was requested.", +"readOnly": true, +"type": "string" +}, +"existingMatchingUsageInfo": { +"$ref": "FutureReservationStatusExistingMatchingUsageInfo", +"description": "Output only. [Output Only] Represents the matching usage for the future\nreservation before an amendment was requested.", +"readOnly": true +}, +"futureReservationSpecs": { +"$ref": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs", +"readOnly": true +}, +"lockTime": { +"description": "Output only. [Output Only] The lock time of the FutureReservation before an\namendment was requested.", +"readOnly": true, +"type": "string" +}, +"namePrefix": { +"description": "Output only. [Output Only] The name prefix of the Future Reservation before an\namendment was requested.", +"readOnly": true, +"type": "string" +}, +"procurementStatus": { +"description": "Output only. [Output Only] The status of the last known good state for the Future\nReservation.", +"enum": [ +"APPROVED", +"CANCELLED", +"COMMITTED", +"DECLINED", +"DRAFTING", +"FAILED", +"FAILED_PARTIALLY_FULFILLED", +"FULFILLED", +"PENDING_AMENDMENT_APPROVAL", +"PENDING_APPROVAL", +"PROCUREMENT_STATUS_UNSPECIFIED", +"PROCURING", +"PROVISIONING" +], +"enumDescriptions": [ +"Future reservation is approved by GCP.", +"Future reservation is cancelled by the customer.", +"Future reservation is committed by the customer.", +"Future reservation is rejected by GCP.", +"Related status for PlanningStatus.Draft. Transitions to\nPENDING_APPROVAL upon user submitting FR.", +"Future reservation failed. No additional reservations were provided.", +"Future reservation is partially fulfilled. Additional reservations were\nprovided but did not reach total_count reserved instance slots.", +"Future reservation is fulfilled completely.", +"An Amendment to the Future Reservation has been requested. If the\nAmendment is declined, the Future Reservation will be restored to the\nlast known good state.", +"Future reservation is pending approval by GCP.", +"", +"Future reservation is being procured by GCP. Beyond this point, Future\nreservation is locked and no further modifications are allowed.", +"Future reservation capacity is being provisioned. This state will be\nentered after start_time, while reservations are being created to\nprovide total_count reserved instance slots. This state will not\npersist past start_time + 24h." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationStatusLastKnownGoodStateFutureReservationSpecs": { +"description": "The properties of the last known good state for the Future Reservation.", +"id": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs", +"properties": { +"shareSettings": { +"$ref": "ShareSettings", +"description": "Output only. [Output Only] The previous share settings of the Future Reservation.", +"readOnly": true +}, +"specificSkuProperties": { +"$ref": "FutureReservationSpecificSKUProperties", +"description": "Output only. [Output Only] The previous instance related properties of the\nFuture Reservation.", +"readOnly": true +}, +"timeWindow": { +"$ref": "FutureReservationTimeWindow", +"description": "Output only. [Output Only] The previous time window of the Future Reservation.", +"readOnly": true +} +}, +"type": "object" +}, +"FutureReservationStatusSpecificSKUProperties": { +"description": "Properties to be set for the Future Reservation.", +"id": "FutureReservationStatusSpecificSKUProperties", +"properties": { +"sourceInstanceTemplateId": { +"description": "ID of the instance template used to populate the Future Reservation\nproperties.", +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationStoragePoolProperties": { +"description": "Storage pool properties for the future reservation.", +"id": "FutureReservationStoragePoolProperties", +"properties": { +"requestedExapoolProvisionedCapacityGb": { +"$ref": "StoragePoolExapoolProvisionedCapacityGb", +"description": "Requested exapool provisioned capacity in GiB." +}, +"requestedStoragePoolProvisionedCapacity": { +"$ref": "FutureReservationStoragePoolProvisionedCapacity", +"description": "Requested storage pool provisioned capacity." +}, +"storagePoolType": { +"description": "Type of the storage pool.", +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationStoragePoolProvisionedCapacity": { +"description": "Storage pool provisioned capacities for each SKU type.", +"id": "FutureReservationStoragePoolProvisionedCapacity", +"properties": { +"poolProvisionedCapacityGb": { +"description": "Size of the storage pool in GiB.", +"format": "int64", +"type": "string" +}, +"poolProvisionedIops": { +"description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool\ntype is hyperdisk-balanced.", +"format": "int64", +"type": "string" +}, +"poolProvisionedThroughput": { +"description": "Provisioned throughput of the storage pool in MiB/s. Only relevant if\nthe storage pool type is hyperdisk-balanced or hyperdisk-throughput.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationTimeWindow": { +"id": "FutureReservationTimeWindow", +"properties": { +"duration": { +"$ref": "Duration" +}, +"endTime": { +"type": "string" +}, +"startTime": { +"description": "Start time of the Future Reservation. The start_time is an RFC3339\nstring.", +"type": "string" +} +}, +"type": "object" +}, +"FutureReservationsAggregatedListResponse": { +"description": "Contains a list of future reservations.", +"id": "FutureReservationsAggregatedListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "FutureReservationsScopedList", +"description": "Name of the scope containing this set of future reservations." +}, +"description": "A list of Future reservation resources.", +"type": "object" +}, +"kind": { +"default": "compute#futureReservationsAggregatedListResponse", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future\nresevation aggregated list response.", +"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" +}, +"FutureReservationsListResponse": { +"id": "FutureReservationsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"description": "[Output Only] A list of future reservation resources.", +"items": { +"$ref": "FutureReservation" +}, +"type": "array" +}, +"kind": { +"default": "compute#futureReservationsListResponse", +"description": "Output only. [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of\nreservations", +"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" +}, +"FutureReservationsScopedList": { +"id": "FutureReservationsScopedList", +"properties": { +"futureReservations": { +"description": "A list of future reservations contained in this scope.", +"items": { +"$ref": "FutureReservation" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of future reservations when\nthe 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.", +"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" +}, +"FutureResourcesRecommendation": { +"description": "Recommendation for single resources specification, to be created in the\nfuture.", +"id": "FutureResourcesRecommendation", +"properties": { +"endTime": { +"format": "google-datetime", +"type": "string" +}, +"location": { +"description": "The advised location for resource usage. When a zone, in format\n'zones/'.\nIf not set, it means that no location is recommended - see\nother_locations for details.", +"type": "string" +}, +"otherLocations": { +"additionalProperties": { +"$ref": "FutureResourcesRecommendationOtherLocation" +}, +"description": "List of locations in the request scope that were not\nrecommended. Keys of the map are zones, in format 'zones/'.\nThe values are status information indicating the recommendation status.", +"type": "object" +}, +"recommendationId": { +"description": "Unique id of the recommendation, a UUID string generated by the API.", +"type": "string" +}, +"recommendationType": { +"description": "Type of recommendation. Currently only FUTURE_RESERVATION is supported.", +"enum": [ +"FUTURE_RESERVATION", +"RECOMMENDATION_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"A Future Reservation is recommended.", +"Default value, unused." +], +"type": "string" +}, +"startTime": { +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesRecommendationOtherLocation": { +"description": "Information about recommendation status for locations\nthat were allowed but not used by the response.", +"id": "FutureResourcesRecommendationOtherLocation", +"properties": { +"details": { +"description": "Details (human readable) describing the situation.\nFor example, if status is CONDITION_NOT_MET, then\ndetails contain information about the parameters of the time window\nthat did not meet the required conditions.", +"type": "string" +}, +"status": { +"description": "Status of recommendation in this location.", +"enum": [ +"CONDITIONS_NOT_MET", +"NOT_SUPPORTED", +"NO_CAPACITY", +"OTHER_LOCATION_STATUS_UNDEFINED", +"RECOMMENDED" +], +"enumDescriptions": [ +"The requested resources are offered in this location\nbut the requested time window is does not meet the required conditions.", +"The requested resources are not offered in this location.\nRetrying the request will not change this status.", +"The requested resources are offered in this location\nand the requested time window is accepted\nbut there is no capacity within the requested time window.", +"Default value, unused.", +"The requested resources are offered in this location\nand it is possible to request them. However, another location\nwas better and was recommended." +], +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesSpec": { +"description": "Specification of resources to be created at some time in the future within an\noptionally specified set of locations, and within the specified time range.", +"id": "FutureResourcesSpec", +"properties": { +"deploymentType": { +"description": "Indicates if the reservation allocation strategy is static (DENSE) or\ndynamic (STANDARD). Defaults to DENSE.", +"enum": [ +"DENSE", +"DEPLOYMENT_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"The reserved capacity is made up of densely deployed reservation blocks.", +"" +], +"type": "string" +}, +"locationPolicy": { +"$ref": "FutureResourcesSpecLocationPolicy", +"description": "Optional location policy allowing to exclude some zone(s) in which\nthe resources must not be created." +}, +"targetResources": { +"$ref": "FutureResourcesSpecTargetResources", +"description": "Specification of the reserved resources." +}, +"timeRangeSpec": { +"$ref": "FlexibleTimeRange", +"description": "Specification of a time range in which the resources may be created.\nThe time range specifies start of resource use and planned end of resource\nuse." +} +}, +"type": "object" +}, +"FutureResourcesSpecAggregateResources": { +"id": "FutureResourcesSpecAggregateResources", +"properties": { +"acceleratorCount": { +"description": "Size of the request, in accelerator (chip) count.", +"format": "int64", +"type": "string" +}, +"vmFamily": { +"description": "The VM family that all instances scheduled against this reservation\nmust belong to. Use for TPU reservations.", +"enum": [ +"VM_FAMILY_CLOUD_TPU_DEVICE_CT3", +"VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L", +"VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP", +"VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"workloadType": { +"description": "Workload type. Use for TPU reservations.", +"enum": [ +"BATCH", +"SERVING", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Reserved resources will be optimized for BATCH workloads, such as ML\ntraining.", +"Reserved resources will be optimized for SERVING workloads, such as ML\ninference.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesSpecLocalSsdPartition": { +"id": "FutureResourcesSpecLocalSsdPartition", +"properties": { +"diskInterface": { +"description": "Disk interface. Defaults to SCSI.", +"enum": [ +"NVME", +"SCSI" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"diskSizeGb": { +"description": "The size of the disk in GB.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesSpecLocationPolicy": { +"description": "Specification of locations to create resources in.", +"id": "FutureResourcesSpecLocationPolicy", +"properties": { +"locations": { +"additionalProperties": { +"$ref": "FutureResourcesSpecLocationPolicyLocation" +}, +"description": "Preferences for specified locations.\nKeys of the map are locations - zones, in format of 'zones/'.\nValues are preferences for the zones.\nIf a zone is not specified in this map, it is ALLOWed.", +"type": "object" +} +}, +"type": "object" +}, +"FutureResourcesSpecLocationPolicyLocation": { +"description": "Preference for a single specified location.", +"id": "FutureResourcesSpecLocationPolicyLocation", +"properties": { +"preference": { +"description": "Preference for this location.", +"enum": [ +"ALLOW", +"DENY", +"PREFERENCE_UNSPECIFIED" +], +"enumDescriptions": [ +"Location is allowed for use.", +"Location is prohibited.", +"Default value, unused." +], +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesSpecSpecificSKUResources": { +"id": "FutureResourcesSpecSpecificSKUResources", +"properties": { +"instanceCount": { +"description": "Size of the request, in instance count.", +"format": "int64", +"type": "string" +}, +"localSsdPartitions": { +"description": "Local SSD partitions. You do not have to include SSD partitions that\nare built in the machine type.", +"items": { +"$ref": "FutureResourcesSpecLocalSsdPartition" +}, +"type": "array" +}, +"machineType": { +"description": "The machine type to use for instances that will use the reservation.\nThis field only accepts machine type names. e.g. n2-standard-4\nand does not accept machine type full or partial url. e.g.\nprojects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4.\nUse for GPU reservations.", +"type": "string" +} +}, +"type": "object" +}, +"FutureResourcesSpecTargetResources": { +"description": "Specification of reserved resources.", +"id": "FutureResourcesSpecTargetResources", +"properties": { +"aggregateResources": { +"$ref": "FutureResourcesSpecAggregateResources" +}, +"specificSkuResources": { +"$ref": "FutureResourcesSpecSpecificSKUResources" +} +}, +"type": "object" +}, +"GRPCHealthCheck": { +"id": "GRPCHealthCheck", +"properties": { +"grpcServiceName": { +"description": "The gRPC service name for the health check. This field is optional. The\nvalue of grpc_service_name has the following meanings by convention: \n\n- Empty service_name means the overall status of all services at the\nbackend. \n\n- Non-empty service_name means the health of that gRPC service, as defined\nby the owner of the service. \n\nThe grpc_service_name can only be ASCII.", +"type": "string" +}, +"port": { +"description": "The TCP port number to which the health check prober sends packets. Valid\nvalues are 1 through 65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +} +}, +"type": "object" +}, +"GRPCTLSHealthCheck": { +"id": "GRPCTLSHealthCheck", +"properties": { +"grpcServiceName": { +"description": "The gRPC service name for the health check. This field is optional. The\nvalue of grpc_service_name has the following meanings by convention: \n\n- Empty service_name means the overall status of all services at the\nbackend. \n\n- Non-empty service_name means the health of that gRPC service, as defined\nby the owner of the service. \n\nThe grpc_service_name can only be ASCII.", +"type": "string" +}, +"port": { +"description": "The TCP port number to which the health check prober sends packets. Valid\nvalues are 1 through 65535.", +"format": "int32", +"type": "integer" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +} +}, +"type": "object" +}, +"GetHealthOperationMetadata": { +"description": "Metadata for GetHealth operations.", +"id": "GetHealthOperationMetadata", +"properties": { +"healthInfo": { +"$ref": "GetHealthOperationMetadataHealthInfo", +"description": "Output only. The health information.", +"readOnly": true +} +}, +"type": "object" +}, +"GetHealthOperationMetadataHealthInfo": { +"description": "Health information.", +"id": "GetHealthOperationMetadataHealthInfo", +"properties": { +"availabilitySloStatus": { +"description": "Output only. The availability SLO status.", +"enum": [ +"AVAILABILITY_SLO_STATUS_IN_SLO", +"AVAILABILITY_SLO_STATUS_OUT_OF_SLO", +"AVAILABILITY_SLO_STATUS_SLO_UNKNOWN", +"AVAILABILITY_SLO_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The slot availability is in SLO.", +"The slot availability is out of SLO.", +"The slot availability is unknown.", +"Unspecified availability SLO status." +], +"readOnly": true, +"type": "string" +}, +"healthStatus": { +"description": "Output only. The health status.", +"enum": [ +"HEALTH_STATUS_HEALTHY", +"HEALTH_STATUS_UNHEALTHY", +"HEALTH_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The reservation slot is healthy.", +"The reservation slot is unhealthy.", +"Unspecified health status." +], +"readOnly": true, +"type": "string" +}, +"repairCategory": { +"description": "Output only. The repair category.", +"enum": [ +"REPAIR_CATEGORY_CRITICAL_FAILURE", +"REPAIR_CATEGORY_EMERGENT_MAINTENANCE", +"REPAIR_CATEGORY_PLANNED_MAINTENANCE", +"REPAIR_CATEGORY_UNSPECIFIED", +"REPAIR_CATEGORY_USER_REPORTED_FAULT" +], +"enumDescriptions": [ +"The repair is because of critical failures, that are scoped outside\nemergent maintenance", +"The repair is because of an emergent maintenance", +"The repair is because of a planned maintenance", +"Unspecified repair category.", +"The repair is because of a user reported fault" +], +"readOnly": true, +"type": "string" +}, +"unhealthyReason": { +"description": "Output only. The reason for unhealthy status.", +"enum": [ +"UNHEALTHY_REASON_PENDING_USER_APPROVAL", +"UNHEALTHY_REASON_REPAIRING", +"UNHEALTHY_REASON_UNSCHEDULABLE", +"UNHEALTHY_REASON_UNSPECIFIED" +], +"enumDescriptions": [ +"The slot is unhealthy because there is a pending repair, waiting for\ncustomer approval", +"The slot is unhealthy because repair is in progress", +"The slot is unhealthy because a vm cannot be scheduled on it, and no\nrepairs are running on the slot", +"Unspecified unhealthy reason." +], +"readOnly": true, +"type": "string" +}, +"updateTime": { +"description": "Output only. The time when health info was updated.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GetVersionOperationMetadata": { +"id": "GetVersionOperationMetadata", +"properties": { +"inlineSbomInfo": { +"$ref": "GetVersionOperationMetadataSbomInfo" +} +}, +"type": "object" +}, +"GetVersionOperationMetadataSbomInfo": { +"id": "GetVersionOperationMetadataSbomInfo", +"properties": { +"currentComponentVersions": { +"additionalProperties": { +"type": "string" +}, +"description": "A mapping of components to their currently-applied versions or other\nappropriate identifiers.", +"type": "object" +}, +"targetComponentVersions": { +"additionalProperties": { +"type": "string" +}, +"description": "A mapping of components to their target versions or other appropriate\nidentifiers.", +"type": "object" +} +}, +"type": "object" +}, +"GlobalAddressesMoveRequest": { +"id": "GlobalAddressesMoveRequest", +"properties": { +"description": { +"description": "An optional destination address description if intended to be different\nfrom the source.", +"type": "string" +}, +"destinationAddress": { +"description": "The URL of the destination address to move to. This can be a full or\npartial URL. For example, the following are all valid URLs to a address:\n \n - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address \n - projects/project/global/addresses/address\n\n\nNote that destination project must be different from the source project. So/global/addresses/address is not valid partial url.", +"type": "string" +} +}, +"type": "object" +}, +"GlobalFrontendSettings": { +"description": "Represents the Global Frontend Bundle settings for a single project.", +"id": "GlobalFrontendSettings", +"properties": { +"bundleType": { +"description": "Customer-settable bundle type.", +"enum": [ +"BUNDLE_TYPE_UNSPECIFIED", +"GLOBAL_FRONT_END", +"INDIVIDUAL" +], +"enumDescriptions": [ +"Bundling is not active.", +"Standard Global Frontend bundle.", +"Ala Carte mode." +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp in RFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. [Output Only] An optional description of this resource.", +"readOnly": true, +"type": "string" +}, +"etag": { +"description": "Output only. For optimistic locking.", +"readOnly": true, +"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" +}, +"name": { +"description": "Output only. OUTPUT_ONLY fields\n[Output Only] Name of the resource. Must be 1-63 characters long and match\nthe regular expression `[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.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GlobalFrontendSettingsPatchResponse": { +"description": "Response to an UpdateGlobalFrontendSettingsRequest.", +"id": "GlobalFrontendSettingsPatchResponse", +"properties": { +"operation": { +"$ref": "Operation", +"description": "The Operation resource for this long-running operation." +} +}, +"type": "object" +}, +"GlobalNetworkEndpointGroupsAttachEndpointsRequest": { +"id": "GlobalNetworkEndpointGroupsAttachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be attached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"GlobalNetworkEndpointGroupsDetachEndpointsRequest": { +"id": "GlobalNetworkEndpointGroupsDetachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be detached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"GlobalOrganizationSetPolicyRequest": { +"id": "GlobalOrganizationSetPolicyRequest", +"properties": { +"bindings": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", +"format": "byte", +"type": "string" +}, +"policy": { +"$ref": "Policy", +"description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." +} +}, +"type": "object" +}, +"GlobalSetLabelsRequest": { +"id": "GlobalSetLabelsRequest", +"properties": { +"labelFingerprint": { +"description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash when updating or changing\nlabels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the\nresource to get the latest fingerprint.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "A list of labels to apply for this resource. Each label must comply with\nthe\nrequirements for labels. For example,\"webserver-frontend\": \"images\". A label value can also be\nempty (e.g. \"my-label\": \"\").", +"type": "object" +} +}, +"type": "object" +}, +"GlobalSetPolicyRequest": { +"id": "GlobalSetPolicyRequest", +"properties": { +"bindings": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", +"format": "byte", +"type": "string" +}, +"policy": { +"$ref": "Policy", +"description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicy": { +"description": "Message describing GlobalVmExtensionPolicy object.", +"id": "GlobalVmExtensionPolicy", +"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" +}, +"extensionPolicies": { +"additionalProperties": { +"$ref": "GlobalVmExtensionPolicyExtensionPolicy" +}, +"description": "Required. Map from extension (eg: \"cloudops\") to its policy configuration.\nThe key is the name of the extension.", +"type": "object" +}, +"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" +}, +"instanceSelectors": { +"description": "Optional. Selector to target VMs for a policy.\nThere is a logical \"AND\" between instance_selectors.", +"items": { +"$ref": "GlobalVmExtensionPolicyInstanceSelector" +}, +"type": "array" +}, +"kind": { +"default": "compute#globalVmExtensionPolicy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.", +"readOnly": true, +"type": "string" +}, +"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.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"priority": { +"description": "Optional. Used to resolve conflicts when multiple policies are active for the same\nextension. Defaults to 0.\n\nLarger the number, higher the priority. When the priority is the same,\nthe policy with the newer create time has higher priority.", +"format": "int32", +"type": "integer" +}, +"rolloutOperation": { +"$ref": "GlobalVmExtensionPolicyRolloutOperation", +"description": "Required. The rollout strategy and status." +}, +"scopedResourceStatus": { +"description": "Output only. [Output Only] The scoped resource status. It's only for tracking the\npurging status of the policy.", +"enum": [ +"SCOPED_RESOURCE_STATUS_DELETING", +"SCOPED_RESOURCE_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The zonal policies are being deleted.", +"Default value. This value is unused." +], +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"updateTimestamp": { +"description": "Output only. [Output Only] Update timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyExtensionPolicy": { +"description": "Policy for a single extension.", +"id": "GlobalVmExtensionPolicyExtensionPolicy", +"properties": { +"pinnedVersion": { +"description": "Optional. The version pinning for the extension.\nIf empty, the extension will be installed with the latest version\nreleased by the extension producer.", +"type": "string" +}, +"stringConfig": { +"description": "Optional. String configuration. Any string payload that the extension\nunderstands.", +"type": "string" +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyInstanceSelector": { +"description": "Selector to target VMs for a zone VM extension policy.", +"id": "GlobalVmExtensionPolicyInstanceSelector", +"properties": { +"labelSelector": { +"$ref": "GlobalVmExtensionPolicyLabelSelector", +"description": "Optional. Labels within the LabelSelector are OR'd." +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyLabelSelector": { +"description": "A LabelSelector is applicable for a VM only if it matches all labels in\nthe LabelSelector.", +"id": "GlobalVmExtensionPolicyLabelSelector", +"properties": { +"inclusionLabels": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Labels as key value pairs.\nA VM should contain all the pairs specified in this map to be selected;\nLabels within the LabelSelector are OR'ed.", +"type": "object" +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyList": { +"description": "Response to list global VM extension policy resources.", +"id": "GlobalVmExtensionPolicyList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of GlobalVmExtensionPolicy resources.", +"items": { +"$ref": "GlobalVmExtensionPolicy" +}, +"type": "array" +}, +"kind": { +"default": "compute#globalVmExtensionPolicyList", +"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" +}, +"GlobalVmExtensionPolicyRolloutOperation": { +"description": "Represents the rollout operation", +"id": "GlobalVmExtensionPolicyRolloutOperation", +"properties": { +"rolloutInput": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutInput", +"description": "Required. The rollout input which defines the rollout plan." +}, +"rolloutStatus": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatus", +"description": "Output only. [Output Only] The rollout status of the policy.", +"readOnly": true +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyRolloutOperationRolloutInput": { +"id": "GlobalVmExtensionPolicyRolloutOperationRolloutInput", +"properties": { +"conflictBehavior": { +"description": "Optional. Specifies the behavior of the rollout if a conflict is detected in a\nproject during a rollout. This only applies to `insert` and `update`\nmethods.\n\nA conflict occurs in the following cases:\n\n* `insert` method: If the zonal policy already exists when the insert\n happens.\n* `update` method: If the zonal policy was modified by a zonal API call\n outside of this rollout.\n\nPossible values are the following:\n\n* `\"\"` (empty string): If a conflict occurs, the local value is not\n overwritten. This is the default behavior.\n* `\"overwrite\"`: If a conflict occurs, the local value is overwritten\n with the rollout value.", +"type": "string" +}, +"name": { +"description": "Optional. The name of the rollout plan.\nEx.\nprojects//locations/global/rolloutPlans/.", +"type": "string" +}, +"predefinedRolloutPlan": { +"description": "Optional. Specifies the predefined rollout plan for the policy. Valid values\nare `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is\n`SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout\nplans for global policies.", +"enum": [ +"FAST_ROLLOUT", +"ROLLOUT_PLAN_UNSPECIFIED", +"SLOW_ROLLOUT" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"retryUuid": { +"description": "Optional. The UUID that identifies a policy rollout retry attempt for update and\ndelete operations. Set this field only when retrying a rollout for an\nexisting extension policy.\n\n* `update` method: Lets you retry policy rollout without changes.\nAn error occurs if you set retry_uuid but the policy is modified.\n* `delete` method: Lets you retry policy deletion rollout if the\nprevious deletion rollout is not finished and the policy is in the\nDELETING state. If you set this field when the policy is not in the\nDELETING state, an error occurs.", +"type": "string" +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyRolloutOperationRolloutStatus": { +"id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatus", +"properties": { +"currentRollouts": { +"description": "Output only. [Output Only] The current rollouts for the latest version of the\nresource. There should be only one current rollout, but for\nscalability, we make it repeated.", +"items": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata" +}, +"readOnly": true, +"type": "array" +}, +"previousRollout": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata", +"description": "Output only. [Output Only] The last completed rollout resource. This field will not\nbe populated until the first rollout is completed.", +"readOnly": true +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata": { +"id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata", +"properties": { +"locationRolloutStatus": { +"additionalProperties": { +"$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus" +}, +"description": "Output only. [Output Only] The rollout status for each location. The list of the\nlocations is the same as the list of locations in the rollout plan.", +"readOnly": true, +"type": "object" +}, +"rollout": { +"description": "Output only. [Output Only] The name of the rollout.\nEx. projects//locations/global/rollouts/.", +"readOnly": true, +"type": "string" +}, +"rolloutPlan": { +"description": "Output only. [Output Only] The name of the rollout plan.\nEx.\nprojects//locations/global/rolloutPlans/.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] The overall state of the rollout.", +"enum": [ +"STATE_CANCELLED", +"STATE_COMPLETED", +"STATE_FAILED", +"STATE_PAUSED", +"STATE_PROCESSING", +"STATE_UNKNOWN", +"STATE_UNSPECIFIED" +], +"enumDescriptions": [ +"Iteration was explicitly cancelled.", +"Iteration completed, with all actions being successful.", +"Iteration completed, with failures.", +"The rollout is paused.", +"Iteration is in progress.", +"Impossible to determine current state of the iteration.", +"Default value. This value is unused." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus": { +"id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus", +"properties": { +"state": { +"description": "Output only. [Output Only] The state of the location rollout.", +"enum": [ +"LOCATION_ROLLOUT_STATE_COMPLETED", +"LOCATION_ROLLOUT_STATE_FAILED", +"LOCATION_ROLLOUT_STATE_NOT_STARTED", +"LOCATION_ROLLOUT_STATE_SKIPPED", +"LOCATION_ROLLOUT_STATE_UNSPECIFIED" +], +"enumDescriptions": [ +"The location rollout is completed.", +"The location rollout has failed.", +"The location rollout has not started.", +"The location rollout is skipped.", +"Default value. This value is unused." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GroupMaintenanceInfo": { +"description": "Maintenance Info for ReservationBlocks.", +"id": "GroupMaintenanceInfo", +"properties": { +"instanceMaintenanceOngoingCount": { +"description": "Describes number of instances that have ongoing maintenance.", +"format": "int32", +"type": "integer" +}, +"instanceMaintenancePendingCount": { +"description": "Describes number of instances that have pending maintenance.", +"format": "int32", +"type": "integer" +}, +"maintenanceOngoingCount": { +"description": "Progress for ongoing maintenance for this group of VMs/hosts.\nDescribes number of hosts in the block that have ongoing maintenance.", +"format": "int32", +"type": "integer" +}, +"maintenancePendingCount": { +"description": "Progress for ongoing maintenance for this group of VMs/hosts.\nDescribes number of hosts in the block that have pending maintenance.", +"format": "int32", +"type": "integer" +}, +"schedulingType": { +"description": "The type of maintenance for the reservation.", +"enum": [ +"GROUPED", +"GROUP_MAINTENANCE_TYPE_UNSPECIFIED", +"INDEPENDENT" +], +"enumDescriptions": [ +"Maintenance on all reserved instances in the reservation is synchronized.", +"Unknown maintenance type.", +"Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." +], +"type": "string" +}, +"subblockInfraMaintenanceOngoingCount": { +"description": "Describes number of subblock Infrastructure that has ongoing maintenance.\nHere, Subblock Infrastructure Maintenance pertains to upstream hardware\ncontained in the Subblock that is necessary for a VM Family(e.g. NVLink\nDomains). Not all VM Families will support this field.", +"format": "int32", +"type": "integer" +}, +"subblockInfraMaintenancePendingCount": { +"description": "Describes number of subblock Infrastructure that has pending maintenance.\n Here, Subblock Infrastructure Maintenance pertains to upstream hardware\n contained in the Subblock that is necessary for a VM Family (e.g. NVLink\n Domains). Not all VM Families will support this field.", +"format": "int32", +"type": "integer" +}, +"upcomingGroupMaintenance": { +"$ref": "UpcomingMaintenance", +"description": "Maintenance information on this group of VMs." +} +}, +"type": "object" +}, +"GuestAttributes": { +"description": "A guest attributes entry.", +"id": "GuestAttributes", +"properties": { +"kind": { +"default": "compute#guestAttributes", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry.", +"readOnly": true, +"type": "string" +}, +"queryPath": { +"description": "The path to be queried. This can be the default namespace ('') or a\nnested namespace ('\\/') or a specified key\n('\\/\\').", +"type": "string" +}, +"queryValue": { +"$ref": "GuestAttributesValue", +"description": "Output only. [Output Only] The value of the requested queried path.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"variableKey": { +"description": "The key to search for.", +"type": "string" +}, +"variableValue": { +"description": "Output only. [Output Only] The value found for the requested key.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GuestAttributesEntry": { +"description": "A guest attributes namespace/key/value entry.", +"id": "GuestAttributesEntry", +"properties": { +"key": { +"description": "Key for the guest attribute entry.", +"type": "string" +}, +"namespace": { +"description": "Namespace for the guest attribute entry.", +"type": "string" +}, +"value": { +"description": "Value for the guest attribute entry.", +"type": "string" +} +}, +"type": "object" +}, +"GuestAttributesValue": { +"description": "Array of guest attribute namespace/key/value tuples.", +"id": "GuestAttributesValue", +"properties": { +"items": { +"items": { +"$ref": "GuestAttributesEntry" +}, +"type": "array" +} +}, +"type": "object" +}, +"GuestOsFeature": { +"description": "Guest OS features.", +"id": "GuestOsFeature", +"properties": { +"type": { +"description": "The ID of a supported feature. To add multiple values, use commas to\nseparate values. Set to one or more of the following values:\n \n - VIRTIO_SCSI_MULTIQUEUE\n - WINDOWS\n - MULTI_IP_SUBNET\n - UEFI_COMPATIBLE\n - GVNIC\n - SEV_CAPABLE\n - SUSPEND_RESUME_COMPATIBLE\n - SEV_LIVE_MIGRATABLE_V2\n - SEV_SNP_CAPABLE\n - TDX_CAPABLE\n - IDPF\n - SNP_SVSM_CAPABLE\n - CCA_CAPABLE\n - SUSPEND_SAFE_FPR\n\n\nFor more information, see\nEnabling guest operating system features.", +"enum": [ +"BARE_METAL_LINUX_COMPATIBLE", +"BMSAI_CAPABLE", +"CCA_CAPABLE", +"FEATURE_TYPE_UNSPECIFIED", +"GVNIC", +"IDPF", +"MULTI_IP_SUBNET", +"SECURE_BOOT", +"SEV_CAPABLE", +"SEV_LIVE_MIGRATABLE", +"SEV_LIVE_MIGRATABLE_V2", +"SEV_SNP_CAPABLE", +"SNP_SVSM_CAPABLE", +"SUSPEND_SAFE_FPR", +"TDX_CAPABLE", +"UEFI_COMPATIBLE", +"VIRTIO_SCSI_MULTIQUEUE", +"WINDOWS" +], +"enumDescriptions": [ +"", +"Indicates the guest OS is capable of Bare Metal Secure AI (BMSAI)\nconfidential computing.", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"Indicates the guest OS is safe for free page reporting (FPR) during\nsuspend.", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"HTTP2HealthCheck": { +"id": "HTTP2HealthCheck", +"properties": { +"host": { +"description": "The value of the host header in the HTTP/2 health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", +"type": "string" +}, +"port": { +"description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"requestPath": { +"description": "The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.", +"type": "string" +}, +"response": { +"description": "Creates a content-based HTTP/2 health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", +"type": "string" +} +}, +"type": "object" +}, +"HTTPHealthCheck": { +"id": "HTTPHealthCheck", +"properties": { +"host": { +"description": "The value of the host header in the HTTP health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", +"type": "string" +}, +"port": { +"description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 80. Valid values are 1 through65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Also supported in legacy HTTP health checks for target pools.\nThe health check supports all backends supported by the backend service\nprovided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT\nnetwork endpoint groups, and instance group backends. \nUSE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for pass-through load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"requestPath": { +"description": "The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.", +"type": "string" +}, +"response": { +"description": "Creates a content-based HTTP health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", +"type": "string" +} +}, +"type": "object" +}, +"HTTPSHealthCheck": { +"id": "HTTPSHealthCheck", +"properties": { +"host": { +"description": "The value of the host header in the HTTPS health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", +"type": "string" +}, +"port": { +"description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"requestPath": { +"description": "The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.", +"type": "string" +}, +"response": { +"description": "Creates a content-based HTTPS health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", +"type": "string" +} +}, +"type": "object" +}, +"HaController": { +"description": "HaController handles failover for a VM Instance.", +"id": "HaController", +"properties": { +"backendServices": { +"description": "Advanced configuration option. If specified, these Backend Services need to\nbe pre-created.\n\nCurrently, only one backend service can be specified, and it must be L4\nInternal Load Balancer (ILB).", +"items": { +"type": "string" +}, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp in RFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"failoverInitiation": { +"description": "Indicates how failover should be initiated.", +"enum": [ +"AUTOMATIC", +"FAILOVER_INITIATION_UNSPECIFIED", +"MANUAL_ONLY" +], +"enumDescriptions": [ +"Failover will be initiated automatically in case of an outage", +"", +"Failover will be initiated only when compute.haControllers.failover\nmethod is called." +], +"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" +}, +"instanceName": { +"description": "Name of the instance that HaController is in charge of.\nIf not specified the HaController's resource name will be used instead.\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 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" +}, +"kind": { +"default": "compute#HaController", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#haController for HaControllers.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Name of the resource.\nProvided 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 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" +}, +"networkingAutoConfiguration": { +"$ref": "HaControllerNetworkingAutoConfiguration", +"description": "Basic networking configuration. Required backend services and forwarding\nrules will be automatically created with default parameters." +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the resource resides.\nYou must specify this field as part of the HTTP request URL.\nIt is not 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" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The current state of the HA Controller.", +"enum": [ +"ACTIVE", +"CREATING", +"DELETING", +"FAILOVER_IN_PROGRESS", +"FAILOVER_UNAVAILABLE", +"MULTI_ZONE_FAILURE", +"PENDING_FAILOVER", +"STARTING", +"STATE_UNSPECIFIED", +"STOPPED", +"STOPPING", +"UPDATING" +], +"enumDescriptions": [ +"The HA Controller is active and ready to perform failover.", +"The HA Controller is being created.", +"The HA Controller is being deleted.", +"The HA Controller is in the process of failing over.", +"The HA Controller is not ready to perform failover.", +"The HA Controller requires a failover operation to be performed but the\nsecondary zone is not available to failover to.", +"The HA Controller requires a failover operation to be performed.", +"The HA Controller is being started.", +"Unspecified state.", +"The HA Controller is stopped.", +"The HA Controller is being stopped.", +"The HA Controller is being updated." +], +"readOnly": true, +"type": "string" +}, +"status": { +"$ref": "HaControllerStatus", +"description": "Output only. [Output Only] Status information for the HaController resource.", +"readOnly": true +}, +"zoneConfigurations": { +"additionalProperties": { +"$ref": "HaControllerZoneConfiguration" +}, +"description": "Map of zone configurations\nKey: name of the zone\nValue: ZoneConfiguration", +"type": "object" +} +}, +"type": "object" +}, +"HaControllerNetworkingAutoConfiguration": { +"description": "Basic networking configuration. Required backend services and forwarding\nrules will be automatically created with default parameters.", +"id": "HaControllerNetworkingAutoConfiguration", +"properties": { +"internal": { +"$ref": "HaControllerNetworkingAutoConfigurationInternal", +"description": "Internal networking configuration" +} +}, +"type": "object" +}, +"HaControllerNetworkingAutoConfigurationInternal": { +"description": "Internal networking configuration", +"id": "HaControllerNetworkingAutoConfigurationInternal", +"properties": { +"ipAddress": { +"description": "Optional. IP addresses will be automatically allocated according to\nStackType if not provided.", +"type": "string" +}, +"ipv6Address": { +"type": "string" +}, +"stackType": { +"description": "Determine which IP addresses to automatically create. Field and option\nnaming consistent with NetworkInterface configuration on Instances.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"The HA Controller Networking Endpoint will be assigned with both IPv4\nand IPv6 addresses.", +"The HA Controller Networking Endpoint will only be assigned with IPv4\naddress.", +"The HA Controller Networking Endpoint will only be assigned with IPv6\naddress." +], +"type": "string" +} +}, +"type": "object" +}, +"HaControllerStatus": { +"description": "Contains information about current status of the HaController.", +"id": "HaControllerStatus", +"properties": { +"failoverProgress": { +"$ref": "HaControllerStatusFailoverProgress", +"description": "Output only. [Output Only] Contains the details of the ongoing failover. This message\nis not displayed if failover is NOT in progress.", +"readOnly": true +}, +"lastFailoverInfo": { +"$ref": "HaControllerStatusFailoverProgress", +"description": "Output only. [Output Only] Contains the details of the last successful failover.", +"readOnly": true +}, +"ongoingFailover": { +"description": "Output only. [Output Only] Indicates if the failover is currently in-progress.", +"readOnly": true, +"type": "boolean" +}, +"primaryInstance": { +"description": "Output only. [Output Only] The URL to the instance that is intended to be primary at\nthis moment. Primary instance will be changed at the very beginning of a\nfailover operation.", +"readOnly": true, +"type": "string" +}, +"primaryZone": { +"description": "Output only. [Output Only] The name of the zone that is intended to be primary at this\nmoment. Primary zone will be changed at the very beginning of a failover\noperation. The zone may not be operational in the middle of a failover\noperation.", +"readOnly": true, +"type": "string" +}, +"readyForFailover": { +"description": "Output only. [Output Only] Indicates if the resource is ready for initiating a\nfailover to the secondary zone.", +"readOnly": true, +"type": "boolean" +}, +"zoneStatus": { +"additionalProperties": { +"$ref": "HaControllerStatusZoneStatus" +}, +"description": "Output only. [Output Only] Map of zone statuses.\nKey: name of the zone\nValue: ZoneStatus", +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"HaControllerStatusFailoverProgress": { +"description": "Contains information about the current failover operation.", +"id": "HaControllerStatusFailoverProgress", +"properties": { +"failoverCompleteTimestamp": { +"description": "Output only. [Output Only] Timestamp of the failover completion.\nFilled only if the failover is completed, in lastFailoverInfo.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"failoverDuration": { +"description": "Output only. The duration of the last failover.", +"format": "google-duration", +"readOnly": true, +"type": "string" +}, +"failoverTrigger": { +"description": "Output only. [Output Only] Indicates if failover has been triggered automatically or\nmanually.", +"enum": [ +"AUTOMATIC", +"FAILOVER_TRIGGER_UNSPECIFIED", +"MANUAL" +], +"enumDescriptions": [ +"Failover has been triggered automatically.", +"", +"Failover has been triggered manually." +], +"readOnly": true, +"type": "string" +}, +"failoverTriggerTimestamp": { +"description": "Output only. [Output Only] Timestamp of the last failover trigger.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"lastFailoverAttempt": { +"$ref": "HaControllerStatusFailoverProgressLastFailoverAttempt", +"description": "Output only. [Output Only] Contains details of the last failed failover. This field\nis filled only if the current failover is failing", +"readOnly": true +} +}, +"type": "object" +}, +"HaControllerStatusFailoverProgressLastFailoverAttempt": { +"id": "HaControllerStatusFailoverProgressLastFailoverAttempt", +"properties": { +"errors": { +"description": "Output only. [Output Only] Encountered errors during the last attempt to process\nfailover.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"timestamp": { +"description": "Output only. [Output Only] Show timestamp only if there is an error.RFC3339\ntext format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"HaControllerStatusZoneStatus": { +"description": "Contains the status of a specific zone.", +"id": "HaControllerStatusZoneStatus", +"properties": { +"isPrimary": { +"description": "Output only. [Output Only] Indicates if the zone is primary at this moment.", +"readOnly": true, +"type": "boolean" +}, +"isZoneReady": { +"description": "Output only. [Output Only] Indicates if the zone is ready for initiating a failover.", +"readOnly": true, +"type": "boolean" +}, +"lastError": { +"$ref": "HaControllerStatusZoneStatusLastError", +"description": "Output only. [Output Only] This field is filled only if the current operation is\nfailing.", +"readOnly": true +} +}, +"type": "object" +}, +"HaControllerStatusZoneStatusLastError": { +"description": "Contains details of the last failed operation.", +"id": "HaControllerStatusZoneStatusLastError", +"properties": { +"errors": { +"description": "Output only. [Output Only] Encountered errors.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"timestamp": { +"description": "Output only. [Output Only] Show timestamp only if there is an error.RFC3339\ntext format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"HaControllerZoneConfiguration": { +"description": "Config for a zone that the HaController may use for running the VM\ninstance.", +"id": "HaControllerZoneConfiguration", +"properties": { +"nodeAffinities": { +"description": "A set of node affinity configurations. Refer toConfiguring node\naffinity for more information.\nOverrides reservationAffinity.", +"items": { +"$ref": "HaControllerZoneConfigurationNodeAffinity" +}, +"type": "array" +}, +"reservationAffinity": { +"$ref": "HaControllerZoneConfigurationReservationAffinity", +"description": "Specifies the reservations that the instance can consume from." +} +}, +"type": "object" +}, +"HaControllerZoneConfigurationNodeAffinity": { +"description": "Node Affinity: the configuration of desired nodes onto which the\n Instance could be scheduled.\n This message should be an exact copy of the Instances representation\n of NodeAffinity.", +"id": "HaControllerZoneConfigurationNodeAffinity", +"properties": { +"key": { +"description": "Corresponds to the label key of Node resource.", +"type": "string" +}, +"operator": { +"description": "Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.", +"enum": [ +"IN", +"NOT_IN", +"OPERATOR_UNSPECIFIED" +], +"enumDescriptions": [ +"Requires Compute Engine to seek for matched nodes.", +"Requires Compute Engine to avoid certain nodes.", +"" +], +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of Node resource.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HaControllerZoneConfigurationReservationAffinity": { +"description": "Specifies the reservations that this instance can consume from.\nThis message should be an exact copy of the Instances representation\nof AllocationAffinity.", +"id": "HaControllerZoneConfigurationReservationAffinity", +"properties": { +"consumeReservationType": { +"description": "Specifies the type of reservation from which this instance can consume\nresources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See\nConsuming reserved instances for examples.", +"enum": [ +"ANY_RESERVATION", +"ANY_RESERVATION_THEN_FAIL", +"NO_RESERVATION", +"SPECIFIC_RESERVATION", +"SPECIFIC_THEN_ANY_RESERVATION", +"SPECIFIC_THEN_NO_RESERVATION", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Consume any allocation available.", +"Consume any reservation available, but fail if no reservation is\navailable. Will not consume from the on-demand pool.", +"Do not consume from any allocated capacity.", +"Must consume from a specific reservation. Must specify key value\nfields for specifying the reservations.", +"Prefer to consume from a specific reservation, but still consume any\nreservation available if the specified reservation is not available\nor exhausted. Must specify key value fields for specifying the\nreservations.", +"Prefer to consume from a specific reservation, but still consume\nfrom the on-demand pool if the specified reservation is exhausted.\nMust specify key value fields for specifying the reservations.", +"" +], +"type": "string" +}, +"key": { +"description": "Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify\nthe name of your reservation as its value.", +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of a reservation resource. This can be\neither a name to a reservation in the same project or\n\"projects/different-project/reservations/some-reservation-name\" to\ntarget a shared reservation in the same zone but in a different\nproject.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HaControllersAggregatedList": { +"id": "HaControllersAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HaControllersScopedList", +"description": "Name of the scope containing this set of ha controllers." +}, +"description": "A list of HaControllersScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#haControllersAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#haControllersAggregatedList for lists of\nHaControllers.", +"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" +}, +"HaControllersFailoverRequest": { +"id": "HaControllersFailoverRequest", +"properties": { +"failoverToZone": { +"description": "Name of the destination zone for the failover.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +} +}, +"type": "object" +}, +"HaControllersList": { +"id": "HaControllersList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HaControllers in the specified project and region.", +"items": { +"$ref": "HaController" +}, +"type": "array" +}, +"nextPageToken": { +"description": "This token allows you to get the next page of results formaxResults, 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": "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" +}, +"HaControllersScopedList": { +"id": "HaControllersScopedList", +"properties": { +"haControllers": { +"description": "List of HaControllers contained in this scope.", +"items": { +"$ref": "HaController" +}, +"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.", +"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" +}, +"HealthAggregationPoliciesScopedList": { +"id": "HealthAggregationPoliciesScopedList", +"properties": { +"healthAggregationPolicies": { +"description": "A list of HealthAggregationPolicys contained in this scope.", +"items": { +"$ref": "HealthAggregationPolicy" +}, +"type": "array" +}, +"warning": { +"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.", +"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" +}, +"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.", +"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 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" +}, +"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.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"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. 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" +}, +"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" +}, +"region": { +"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" +}, +"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 with id for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"HealthAggregationPolicyAggregatedList": { +"description": "Contains a list of HealthAggregationPoliciesScopedList.", +"id": "HealthAggregationPolicyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HealthAggregationPoliciesScopedList", +"description": "Name of the scope containing this set of HealthAggregationPolicies." +}, +"description": "A list of HealthAggregationPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#healthAggregationPolicyAggregatedList", +"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" +}, +"HealthAggregationPolicyList": { +"id": "HealthAggregationPolicyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HealthAggregationPolicy resources.", +"items": { +"$ref": "HealthAggregationPolicy" +}, +"type": "array" +}, +"kind": { +"default": "compute#healthAggregationPolicyList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", +"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] Server-defined URL for this resource.", +"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" +}, +"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": { +"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, GRPC, and GRPC_WITH_TLS 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, GRPC or GRPC_WITH_TLS.\nExactly one of the protocol-specific health check fields must be specified,\nwhich must match type 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.", +"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" +}, +"HealthCheckServiceAggregatedList": { +"description": "Contains a list of HealthCheckServicesScopedList.", +"id": "HealthCheckServiceAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HealthCheckServicesScopedList", +"description": "Name of the scope containing this set of HealthCheckServices." +}, +"description": "A list of HealthCheckServicesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#healthCheckServiceAggregatedList", +"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" +}, +"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" +}, +"HealthCheckServicesScopedList": { +"id": "HealthCheckServicesScopedList", +"properties": { +"resources": { +"description": "A list of HealthCheckServices contained in this scope.", +"items": { +"$ref": "HealthCheckService" +}, +"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.", +"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.", +"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" +}, +"HealthSource": { +"description": "Represents a health source.\n\nA health source resource specifies the source resources and the health\naggregation policy applied to the source resources to determine the\naggregated health status.", +"id": "HealthSource", +"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 HealthSource. An up-to-date fingerprint\nmust be provided in order to patch the HealthSource; Otherwise, the request\nwill fail with error 412 conditionNotMet. To see the latest\nfingerprint, make a get() request to retrieve the\nHealthSource.", +"format": "byte", +"type": "string" +}, +"healthAggregationPolicy": { +"description": "URL to the HealthAggregationPolicy resource. Must be set. Must\nbe regional and in the same region as the HealthSource. Can be\nmutated.", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#healthSource", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the health source resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"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 with id for the resource.", +"readOnly": true, +"type": "string" +}, +"sourceType": { +"description": "Specifies the type of the HealthSource. The only allowed value\nis BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.", +"enum": [ +"BACKEND_SERVICE" +], +"enumDescriptions": [ +"" +], +"type": "string" +}, +"sources": { +"description": "URLs to the source resources. Must be size 1. Must be aBackendService if\nthe sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional\nand in the same region as the HealthSource (cross-region\ndeployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be\nmutated.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HealthSourceAggregatedList": { +"description": "Contains a list of HealthSourcesScopedList.", +"id": "HealthSourceAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HealthSourcesScopedList", +"description": "Name of the scope containing this set of HealthSources." +}, +"description": "A list of HealthSourcesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#healthSourceAggregatedList", +"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" +}, +"HealthSourceHealth": { +"description": "Response message for RegionHealthSources.GetHealth", +"id": "HealthSourceHealth", +"properties": { +"healthState": { +"description": "Health state of the HealthSource.", +"enum": [ +"HEALTHY", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"kind": { +"default": "compute#healthSourceHealth", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#healthSourceHealth for the health of health sources.", +"readOnly": true, +"type": "string" +}, +"sources": { +"description": "Health state details of the sources.", +"items": { +"$ref": "HealthSourcesGetHealthResponseSourceInfo" +}, +"type": "array" +} +}, +"type": "object" +}, +"HealthSourceList": { +"id": "HealthSourceList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HealthSource resources.", +"items": { +"$ref": "HealthSource" +}, +"type": "array" +}, +"kind": { +"default": "compute#healthSourceList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.", +"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] Server-defined URL for this resource.", +"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" +}, +"HealthSourcesGetHealthResponseSourceInfo": { +"id": "HealthSourcesGetHealthResponseSourceInfo", +"properties": { +"backends": { +"description": "Represents an instance group or network endpoint group behind the source\nbackend service. Only used if the sourceType of the regionHealthSource\nis BACKEND_SERVICE.", +"items": { +"$ref": "HealthSourcesGetHealthResponseSourceInfoBackendInfo" +}, +"type": "array" +}, +"forwardingRule": { +"description": "Fully qualified URL of the forwarding rule associated with the source\nresource if it is a L4ILB backend service.", +"type": "string" +}, +"source": { +"description": "Fully qualified URL of the associated source resource. This is always a\nbackend service URL.", +"type": "string" +} +}, +"type": "object" +}, +"HealthSourcesGetHealthResponseSourceInfoBackendInfo": { +"id": "HealthSourcesGetHealthResponseSourceInfoBackendInfo", +"properties": { +"endpointCount": { +"description": "Total number of endpoints when determining the health of the\nregionHealthSource.", +"format": "int32", +"type": "integer" +}, +"group": { +"description": "Fully qualified URL of an instance group or network endpoint group\nbehind the source backend service.", +"type": "string" +}, +"healthyEndpointCount": { +"description": "Number of endpoints considered healthy when determining health of the\nregionHealthSource.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"HealthSourcesScopedList": { +"id": "HealthSourcesScopedList", +"properties": { +"healthSources": { +"description": "A list of HealthSources contained in this scope.", +"items": { +"$ref": "HealthSource" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nhealth sources 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.", +"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" +}, +"HealthStatus": { +"id": "HealthStatus", +"properties": { +"annotations": { +"additionalProperties": { +"type": "string" +}, +"description": "Metadata defined as annotations for network endpoint.", +"type": "object" +}, +"forwardingRule": { +"description": "URL of the forwarding rule associated with the health status of the\ninstance.", +"type": "string" +}, +"forwardingRuleIp": { +"description": "A forwarding rule IP address assigned to this instance.", +"type": "string" +}, +"healthState": { +"description": "Health state of the IPv4 address of the instance.", +"enum": [ +"HEALTHY", +"UNHEALTHY" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"instance": { +"description": "URL of the instance resource.", +"type": "string" +}, +"ipAddress": { +"description": "For target pool based Network Load Balancing, it indicates the forwarding\nrule's IP address assigned to this instance. For other types of load\nbalancing, the field indicates VM internal ip.", +"type": "string" +}, +"ipv6Address": { +"type": "string" +}, +"ipv6HealthState": { +"description": "Health state of the IPv6 address of the instance.", +"enum": [ +"HEALTHY", +"UNHEALTHY" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"port": { +"description": "The named port of the instance group, not necessarily the port that is\nhealth-checked.", +"format": "int32", +"type": "integer" +}, +"weight": { +"type": "string" +}, +"weightError": { +"enum": [ +"INVALID_WEIGHT", +"MISSING_WEIGHT", +"UNAVAILABLE_WEIGHT", +"WEIGHT_NONE" +], +"enumDescriptions": [ +"The response to a Health Check probe had the HTTP response header field\nX-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not\na non-negative single-precision floating-point number in decimal string\nrepresentation).", +"The response to a Health Check probe did not have the HTTP response\nheader field X-Load-Balancing-Endpoint-Weight.", +"This is the value when the accompanied health status is either TIMEOUT\n(i.e.,the Health Check probe was not able to get a response in time) or\nUNKNOWN. For the latter, it should be typically because there has not\nbeen sufficient time to parse and report the weight for a new backend\n(which is with 0.0.0.0 ip address). However, it can be also due to an\noutage case for which the health status is explicitly reset to UNKNOWN.", +"This is the default value when WeightReportMode is DISABLE,\nand is also the initial value when WeightReportMode has just updated to\nENABLE or DRY_RUN and there has not been\nsufficient time to parse and report the backend weight." +], +"type": "string" +} +}, +"type": "object" +}, +"HealthStatusForNetworkEndpoint": { +"id": "HealthStatusForNetworkEndpoint", +"properties": { +"backendService": { +"$ref": "BackendServiceReference", +"description": "URL of the backend service associated with the health state of the network\nendpoint." +}, +"forwardingRule": { +"$ref": "ForwardingRuleReference", +"description": "URL of the forwarding rule associated with the health state of the network\nendpoint." +}, +"healthCheck": { +"$ref": "HealthCheckReference", +"description": "URL of the health check associated with the health state of the network\nendpoint." +}, +"healthCheckService": { +"$ref": "HealthCheckServiceReference", +"description": "URL of the health check service associated with the health state of the\nnetwork endpoint." +}, +"healthState": { +"description": "Health state of the network endpoint determined based on the health checks\nconfigured.", +"enum": [ +"DRAINING", +"HEALTHY", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"Endpoint is being drained.", +"Endpoint is healthy.", +"Endpoint is unhealthy.", +"Health status of the endpoint is unknown." +], +"type": "string" +}, +"ipv6HealthState": { +"description": "Health state of the ipv6 network endpoint determined based on the health\nchecks configured.", +"enum": [ +"DRAINING", +"HEALTHY", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"Endpoint is being drained.", +"Endpoint is healthy.", +"Endpoint is unhealthy.", +"Health status of the endpoint is unknown." +], +"type": "string" +} +}, +"type": "object" +}, +"Help": { +"description": "Provides links to documentation or for performing an out of band action.\n\nFor example, if a quota check failed with an error indicating the calling\nproject hasn't enabled the accessed service, this can contain a URL pointing\ndirectly to the right place in the developer console to flip the bit.", +"id": "Help", +"properties": { +"links": { +"description": "URL(s) pointing to additional information on handling the current error.", +"items": { +"$ref": "HelpLink" +}, +"type": "array" +} +}, +"type": "object" +}, +"HelpLink": { +"description": "Describes a URL link.", +"id": "HelpLink", +"properties": { +"description": { +"description": "Describes what the link offers.", +"type": "string" +}, +"url": { +"description": "The URL of the link.", +"type": "string" +} +}, +"type": "object" +}, +"Host": { +"description": "Represents a host resource.", +"id": "Host", +"properties": { +"aliasLinks": { +"description": "Output only. All aliases for this resource.\ne.g.\nprojects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. The creation timestamp, formatted asRFC3339 text.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource.", +"type": "string" +}, +"id": { +"description": "Output only. The unique identifier for this resource. This identifier is\ndefined by the server.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#host", +"description": "Output only. The type of resource. Alwayscompute#host for hosts.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. The name of the host.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. The self link of the host.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. The self link with id of the host.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The state of the host.", +"enum": [ +"ACTIVE", +"CREATING", +"DELETING", +"STATE_UNSPECIFIED", +"UNAVAILABLE" +], +"enumDescriptions": [ +"The host has allocated all its resources.", +"The resources are being allocated for the host.", +"The host is currently being deleted.", +"", +"The host is currently unavailable." +], +"readOnly": true, +"type": "string" +}, +"status": { +"$ref": "HostStatus", +"description": "Output only. The status of the host", +"readOnly": true +}, +"zone": { +"description": "Output only. The zone in which the host resides.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"HostPhysicalTopology": { +"id": "HostPhysicalTopology", +"properties": { +"block": { +"description": "The unique identifier of the capacity block within the cluster.", +"type": "string" +}, +"cluster": { +"description": "The cluster name of the reservation sub-block.", +"type": "string" +}, +"host": { +"description": "The unique identifier of the capacity host within the capacity sub-block.", +"type": "string" +}, +"subBlock": { +"description": "The unique identifier of the capacity sub-block within the capacity\nblock.", +"type": "string" +} +}, +"type": "object" +}, +"HostRule": { +"description": "UrlMaps\nA host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.", +"id": "HostRule", +"properties": { +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"hosts": { +"description": "The list of host patterns to match. They must be valid hostnames with\noptional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In\nthat case, * must be the first character, and if followed by\nanything, the immediate following character must be either -\nor ..\n\n* based matching is not supported when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true.", +"items": { +"type": "string" +}, +"type": "array" +}, +"pathMatcher": { +"description": "The name of the PathMatcher to use to match the path portion\nof the URL if the hostRule matches the URL's host portion.", +"type": "string" +} +}, +"type": "object" +}, +"HostStatus": { +"id": "HostStatus", +"properties": { +"physicalTopology": { +"$ref": "HostPhysicalTopology", +"description": "Output only. The physical topology of the reservation sub-block, if\npresent", +"readOnly": true +}, +"runningInstances": { +"description": "Output only. The URIs of the instances currently running on this host.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"HostsGetVersionRequest": { +"id": "HostsGetVersionRequest", +"properties": { +"sbomSelections": { +"description": "The SBOM selection to return. Duplicate values in the list will be ignored.", +"items": { +"enum": [ +"SBOM_SELECTION_CURRENT", +"SBOM_SELECTION_TARGET", +"SBOM_SELECTION_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HostsListResponse": { +"id": "HostsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "The unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of host resources.", +"items": { +"$ref": "Host" +}, +"type": "array" +}, +"kind": { +"default": "compute#hostList", +"description": "The type of resource. Always compute#host for a list of hosts.", +"type": "string" +}, +"nextPageToken": { +"description": "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": "The server-defined URL for this resource.", +"type": "string" +}, +"unreachables": { +"description": "Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", +"items": { +"type": "string" +}, +"type": "array" +}, +"warning": { +"description": "An 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" +}, +"HttpFaultAbort": { +"description": "Specification for how requests are aborted as part of fault injection.", +"id": "HttpFaultAbort", +"properties": { +"httpStatus": { +"description": "The HTTP status code used to abort the request.\n\nThe value must be from 200 to 599 inclusive.\n\nFor gRPC protocol, the gRPC status code is mapped to HTTP status code\naccording to this \nmapping table. HTTP status 200 is mapped to gRPC status\nUNKNOWN. Injecting an OK status is currently not supported by\nTraffic Director.", +"format": "uint32", +"type": "integer" +}, +"percentage": { +"description": "The percentage of traffic for connections, operations, or requests\nthat is aborted as part of fault injection.\n\nThe value must be from 0.0 to 100.0 inclusive.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"HttpFaultDelay": { +"description": "Specifies the delay introduced by the load balancer before forwarding the\nrequest to the backend service as part of fault injection.", +"id": "HttpFaultDelay", +"properties": { +"fixedDelay": { +"$ref": "Duration", +"description": "Specifies the value of the fixed delay interval." +}, +"percentage": { +"description": "The percentage of traffic for connections, operations, or requests for\nwhich a delay is introduced as part of fault injection.\n\nThe value must be from 0.0 to 100.0 inclusive.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"HttpFaultInjection": { +"description": "The specification for fault injection introduced into traffic to test\nthe resiliency of clients to backend service failure. As part of fault\ninjection, when clients send requests to a backend service, delays can be\nintroduced by the load balancer on a percentage of requests before sending\nthose request to the backend service. Similarly requests from clients can be\naborted by the load balancer for a percentage of requests.", +"id": "HttpFaultInjection", +"properties": { +"abort": { +"$ref": "HttpFaultAbort", +"description": "The specification for how client requests are aborted as part of fault\ninjection." +}, +"delay": { +"$ref": "HttpFaultDelay", +"description": "The specification for how client requests are delayed as part of fault\ninjection, before being sent to a backend service." +} +}, +"type": "object" +}, +"HttpHeaderAction": { +"description": "The request and response header transformations that take effect before\nthe request is passed along to the selected backendService.", +"id": "HttpHeaderAction", +"properties": { +"requestHeadersToAdd": { +"description": "Headers to add to a matching request before forwarding the request to thebackendService.", +"items": { +"$ref": "HttpHeaderOption" +}, +"type": "array" +}, +"requestHeadersToRemove": { +"description": "A list of header names for headers that need to be removed from the\nrequest before forwarding the request to the backendService.", +"items": { +"type": "string" +}, +"type": "array" +}, +"responseHeadersToAdd": { +"description": "Headers to add the response before sending the response back to the\nclient.", +"items": { +"$ref": "HttpHeaderOption" +}, +"type": "array" +}, +"responseHeadersToRemove": { +"description": "A list of header names for headers that need to be removed from the\nresponse before sending the response back to the client.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HttpHeaderMatch": { +"description": "matchRule criteria for request header matches.", +"id": "HttpHeaderMatch", +"properties": { +"exactMatch": { +"description": "The value should exactly match contents of exactMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", +"type": "string" +}, +"headerName": { +"description": "The name of the HTTP header to match.\n\nFor matching against the HTTP request's authority, use a headerMatch\nwith the header name \":authority\".\n\nFor matching a request's method, use the headerName \":method\".\n\nWhen the URL map is bound to a target gRPC proxy that has\nthe validateForProxyless field set to true, only\nnon-binary\nuser-specified custom metadata and the `content-type` header are supported.\nThe following transport-level headers cannot be used in header matching\nrules:\n`:authority`, `:method`, `:path`, `:scheme`, `user-agent`,\n`accept-encoding`, `content-encoding`, `grpc-accept-encoding`,\n`grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,\n`grpc-timeout` and `grpc-trace-bin`.", +"type": "string" +}, +"invertMatch": { +"description": "If set to false, the headerMatch is considered a\nmatch if the preceding match criteria are met. If set to true,\nthe headerMatch is considered a match if the preceding\nmatch criteria are NOT met.\n\nThe default setting is false.", +"type": "boolean" +}, +"prefixMatch": { +"description": "The value of the header must start with the contents ofprefixMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", +"type": "string" +}, +"presentMatch": { +"description": "A header with the contents of headerName must exist. The\nmatch takes place whether or not the request's header has a value.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", +"type": "boolean" +}, +"rangeMatch": { +"$ref": "Int64RangeMatch", +"description": "The header value must be an integer and its value must be in the range\nspecified in rangeMatch. If the header does not contain an\ninteger, number or is empty, the match fails.\n\nFor example for a range [-5, 0]\n \n \n - -3 will match.\n - 0 will not match.\n - 0.25 will not match.\n - -3someString will not match.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.\n\nrangeMatch is not supported for load balancers\nthat have loadBalancingScheme set to EXTERNAL." +}, +"regexMatch": { +"description": "The value of the header must match the regular expression specified inregexMatch.\nFor more information about regular expression syntax, see Syntax.\n\nFor matching against a port specified in the HTTP request, use a\nheaderMatch with headerName set to PORT and a regular expression that\nsatisfies the RFC2616 Host header's port specifier.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", +"type": "string" +}, +"suffixMatch": { +"description": "The value of the header must end with the contents ofsuffixMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", +"type": "string" +} +}, +"type": "object" +}, +"HttpHeaderOption": { +"description": "Specification determining how headers are added to requests or responses.", +"id": "HttpHeaderOption", +"properties": { +"headerName": { +"description": "The name of the header.", +"type": "string" +}, +"headerValue": { +"description": "The value of the header to add.", +"type": "string" +}, +"replace": { +"description": "If false, headerValue is appended to any values\nthat already\nexist for the header. If true, headerValue is set for the\nheader, discarding any values that were set for that header.\n\nThe default value is true,\nunless a variable is present in headerValue,\nin which case the default value is false.\n.", +"type": "boolean" +} +}, +"type": "object" +}, +"HttpHealthCheck": { +"description": "Represents a legacy HTTP Health Check resource.\n\nLegacy HTTP health checks are now only required by target pool-based network\nload balancers. For all other load balancers, including backend service-based\nnetwork load balancers, and for managed instance group auto-healing, you must\nuse modern (non-legacy) health checks.\n\nFor more information, seeHealth checks\noverview.", +"id": "HttpHealthCheck", +"properties": { +"checkIntervalSec": { +"description": "How often (in seconds) to send a health check. The default value is5 seconds.", +"format": "int32", +"type": "integer" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"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" +}, +"host": { +"description": "The value of the host header in the HTTP health check request. If left\nempty (default value), the public IP on behalf of which this health check\nis performed will be used.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#httpHealthCheck", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"port": { +"description": "The TCP port number for the HTTP health check request. The default value is80.", +"format": "int32", +"type": "integer" +}, +"requestPath": { +"description": "The request path of the HTTP health check request. The default value is/. This field does not support query\nparameters. Must comply withRFC3986.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"timeoutSec": { +"description": "How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have\ngreater value than checkIntervalSec.", +"format": "int32", +"type": "integer" +}, +"unhealthyThreshold": { +"description": "A so-far healthy instance will be marked unhealthy after this\nmany consecutive failures. The default value is 2.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"HttpHealthCheckList": { +"description": "Contains a list of HttpHealthCheck resources.", +"id": "HttpHealthCheckList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HttpHealthCheck resources.", +"items": { +"$ref": "HttpHealthCheck" +}, +"type": "array" +}, +"kind": { +"default": "compute#httpHealthCheckList", +"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.", +"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" +}, +"HttpQueryParameterMatch": { +"description": "HttpRouteRuleMatch criteria for a request's query parameter.", +"id": "HttpQueryParameterMatch", +"properties": { +"exactMatch": { +"description": "The queryParameterMatch matches if the value of the\nparameter exactly matches the contents of exactMatch.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.", +"type": "string" +}, +"name": { +"description": "The name of the query parameter to match. The query parameter must exist in\nthe request, in the absence of which the request match fails.", +"type": "string" +}, +"presentMatch": { +"description": "Specifies that the queryParameterMatch matches if the\nrequest contains the query parameter, irrespective of whether the\nparameter has a value or not.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.", +"type": "boolean" +}, +"regexMatch": { +"description": "The queryParameterMatch matches if the value of the\nparameter matches the regular expression specified byregexMatch. For\nmore information about regular expression syntax, see Syntax.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", +"type": "string" +} +}, +"type": "object" +}, +"HttpRedirectAction": { +"description": "Specifies settings for an HTTP redirect.", +"id": "HttpRedirectAction", +"properties": { +"hostRedirect": { +"description": "The host that is used in the redirect response instead of the one that\nwas supplied in the request.\n\nThe value must be from 1 to 255\ncharacters.", +"type": "string" +}, +"httpsRedirect": { +"description": "If set to true, the URL scheme in the redirected request is\nset to HTTPS.\nIf set to false, the URL scheme of the redirected request\nremains the same as that of the request.\n\nThis must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.\n\nThe default is set to false.", +"type": "boolean" +}, +"pathRedirect": { +"description": "The path that is used in the redirect response instead of the one\nthat was supplied in the request.\n\npathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is\nsupplied, the path of the original request is used for the redirect.\n\nThe value must be from 1 to 1024 characters.", +"type": "string" +}, +"prefixRedirect": { +"description": "The prefix that replaces the prefixMatch specified in\nthe HttpRouteRuleMatch, retaining the remaining portion\nof the URL before redirecting the request.\n\nprefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is\nsupplied, the path of the original request is used for the redirect.\n\nThe value must be from 1 to 1024 characters.", +"type": "string" +}, +"redirectResponseCode": { +"description": "The HTTP Status code to use for this RedirectAction.\n\nSupported values are:\n \n - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds\n to 301.\n - FOUND, which corresponds to 302.\n - SEE_OTHER which corresponds to 303.\n - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request\n method is retained.\n - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request\n method is retained.", +"enum": [ +"FOUND", +"MOVED_PERMANENTLY_DEFAULT", +"PERMANENT_REDIRECT", +"SEE_OTHER", +"TEMPORARY_REDIRECT" +], +"enumDescriptions": [ +"Http Status Code 302 - Found.", +"Http Status Code 301 - Moved Permanently.", +"Http Status Code 308 - Permanent Redirect maintaining HTTP method.", +"Http Status Code 303 - See Other.", +"Http Status Code 307 - Temporary Redirect maintaining HTTP method." +], +"type": "string" +}, +"stripQuery": { +"description": "If set to true, any accompanying query portion of the original\nURL is\nremoved before redirecting the request. If set to false, the\nquery portion of the original URL is retained.\n\nThe default is set to false.", +"type": "boolean" +} +}, +"type": "object" +}, +"HttpRetryPolicy": { +"description": "The retry policy associates with HttpRouteRule", +"id": "HttpRetryPolicy", +"properties": { +"numRetries": { +"description": "Specifies the allowed number retries. This number must be > 0.\nIf not specified, defaults to 1.", +"format": "uint32", +"type": "integer" +}, +"perTryTimeout": { +"$ref": "Duration", +"description": "Specifies a non-zero timeout per retry attempt.\n\nIf not specified, will use the timeout set in theHttpRouteAction field.\nIf timeout in the HttpRouteAction field is not set, this field\nuses the largest timeout\namong all backend services associated with the route.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." +}, +"retryConditions": { +"description": "Specifies one or more conditions when this retry policy applies. Valid\nvalues are:\n \n - 5xx: retry is attempted if the instance or endpoint\n responds with any 5xx response code, or if the instance or\n endpoint does not respond at all. For example, disconnects, reset, read\n timeout, connection failure, and refused streams.\n - gateway-error: Similar to 5xx, but only\n applies to response codes 502, 503 or504.\n - connect-failure: a retry is attempted on failures\n connecting to the instance or endpoint. For example, connection\n timeouts.\n - retriable-4xx: a retry is attempted if the instance\n or endpoint responds with a 4xx response code.\n The only error that you can retry is error code 409.\n - refused-stream: a retry is attempted if the instance\n or endpoint resets the stream with a REFUSED_STREAM error\n code. This reset type indicates that it is safe to retry.\n - cancelled: a retry is attempted if the gRPC status\n code in the response header is set to cancelled.\n - deadline-exceeded: a retry is attempted if the gRPC\n status code in the response header is set todeadline-exceeded.\n - internal: a retry is attempted if the gRPC\n status code in the response header is set tointernal.\n - resource-exhausted: a retry is attempted if the gRPC\n status code in the response header is set toresource-exhausted.\n - unavailable: a retry is attempted if the gRPC\n status code in the response header is set tounavailable.\n\nOnly the following codes are supported when the URL map is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n \n - cancelled\n - deadline-exceeded\n - internal\n - resource-exhausted\n - unavailable", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HttpRouteAction": { +"id": "HttpRouteAction", +"properties": { +"cachePolicy": { +"$ref": "CachePolicy", +"description": "Specifies the cache policy configuration for matched traffic. Available\nonly for Global `EXTERNAL_MANAGED` load balancer schemes. At least one\nproperty must be specified. This policy cannot be specified if any target\nbackend has Identity-Aware Proxy enabled." +}, +"corsPolicy": { +"$ref": "CorsPolicy", +"description": "The specification for allowing client-side cross-origin requests. For more\ninformation about the W3C recommendation for cross-origin resource sharing\n(CORS), see Fetch API Living\nStandard.\n\nNot supported when the URL map is bound to a target gRPC proxy." +}, +"faultInjectionPolicy": { +"$ref": "HttpFaultInjection", +"description": "The specification for fault injection introduced into traffic to test\nthe resiliency of clients to backend service failure. As part of fault\ninjection, when clients send requests to a backend service, delays can be\nintroduced by a load balancer on a percentage of requests before sending\nthose requests to the backend service. Similarly requests from clients can\nbe aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients\nthat are configured with a fault_injection_policy if:\n1. The traffic is generated by fault injection AND\n2. The fault injection is not a delay fault injection.\nFault injection is not supported with the classic Application Load Balancer\n. To see which load balancers support fault injection,\nsee Load\nbalancing: Routing and traffic management features." +}, +"maxStreamDuration": { +"$ref": "Duration", +"description": "Specifies the maximum duration (timeout) for streams on the selected route.\nUnlike the timeout field where the timeout duration starts\nfrom the time the request has been fully processed (known as*end-of-stream*),\nthe duration in this field is computed from the beginning of the stream\nuntil the response has been processed, including all retries. A\nstream that does not complete in this duration is closed.\n\nIf not specified, this field uses the maximummaxStreamDuration value among all backend services associated\nwith the route.\n\nThis field is only allowed if the Url map is used with backend services\nwith loadBalancingScheme set toINTERNAL_SELF_MANAGED." +}, +"requestMirrorPolicy": { +"$ref": "RequestMirrorPolicy", +"description": "Specifies the policy on how requests intended for the route's backends\nare shadowed to a separate mirrored backend service. The load balancer does\nnot wait for responses from the shadow service. Before sending traffic\nto the shadow service, the host / authority header is suffixed with-shadow.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." +}, +"retryPolicy": { +"$ref": "HttpRetryPolicy", +"description": "Specifies the retry policy associated with this route." +}, +"timeout": { +"$ref": "Duration", +"description": "Specifies the timeout for the selected route. Timeout is computed from the\ntime the request has been fully processed (known as *end-of-stream*)\nup until the response has been processed. Timeout includes\nall retries.\n\nIf not specified, this field uses the largest timeout among all backend\nservices associated with the route.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." +}, +"urlRewrite": { +"$ref": "UrlRewrite", +"description": "The spec to modify the URL of the request, before forwarding the request\nto the matched service.\n\n urlRewrite is the only action supported in UrlMaps\nfor classic Application Load Balancers.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." +}, +"weightedBackendServices": { +"description": "A list of weighted backend services to send traffic to when a route match\noccurs. The weights determine the fraction of traffic that flows to\ntheir corresponding backend service. If all traffic needs to\ngo to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.\n\nAfter a backend service is identified and before forwarding\nthe request to\nthe backend service, advanced routing actions such as URL rewrites and\nheader transformations are applied depending on additional settings\nspecified in this HttpRouteAction.", +"items": { +"$ref": "WeightedBackendService" +}, +"type": "array" +} +}, +"type": "object" +}, +"HttpRouteRule": { +"description": "The HttpRouteRule setting specifies how to match an HTTP request\nand the corresponding routing action that load balancing proxies perform.", +"id": "HttpRouteRule", +"properties": { +"customErrorResponsePolicy": { +"$ref": "CustomErrorResponsePolicy", +"description": "customErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nIf a policy for an\nerror code is not configured for the RouteRule, a policy for\nthe error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If\none is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy\nconfigured in UrlMap.defaultCustomErrorResponsePolicy takes\neffect. \n\nFor example, consider a UrlMap with the following configuration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy are configured\n with policies for 5xx and 4xx errors\n - A RouteRule for /coming_soon/ is configured for the\n error code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in RouteRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. \n\nWhen\nused in conjunction withrouteRules.routeAction.retryPolicy, retries take\nprecedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the customErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ncustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." +}, +"description": { +"description": "The short description conveying the intent of this routeRule.\n\n\nThe description can have a maximum length of 1024 characters.", +"type": "string" +}, +"headerAction": { +"$ref": "HttpHeaderAction", +"description": "Specifies changes to request and response headers that need to take effect\nfor the selected backendService.\n\nThe headerAction value specified here is applied before the\nmatching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction\n\nHeaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." +}, +"matchRules": { +"description": "The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches\nthis routeRule when any of thematchRules are satisfied. However predicates within\na given matchRule have AND semantics. All predicates\nwithin a matchRule must match for the request to\nmatch the rule.", +"items": { +"$ref": "HttpRouteRuleMatch" +}, +"type": "array" +}, +"priority": { +"description": "For routeRules within a given pathMatcher,\npriority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order\nof priority, from the lowest to highest number. The priority of a\nrule decreases as its number increases (1, 2, 3, N+1). The first rule\nthat matches the request is applied.\n\n\nYou cannot configure two or more routeRules with the same priority.\nPriority for each rule must be set to a number from 0 to 2147483647\ninclusive.\n\n\nPriority numbers can have gaps, which enable you to add or remove rules\nin the future without affecting the rest of the rules. For example, 1, 2,\n3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you\ncould add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future\nwithout any impact on existing rules.", +"format": "int32", +"type": "integer" +}, +"routeAction": { +"$ref": "HttpRouteAction", +"description": "In response to a matching matchRule, the load balancer\nperforms advanced routing actions, such as URL rewrites and header\ntransformations, before forwarding the request to the selected backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a route rule'srouteAction." +}, +"service": { +"description": "The full or partial URL of the backend service resource to which traffic\nis directed if this rule is matched. If routeAction is\nalso specified, advanced routing actions, such as URL rewrites,\ntake effect before sending the request to the backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.", +"type": "string" +}, +"urlRedirect": { +"$ref": "HttpRedirectAction", +"description": "When this rule is matched, the request is redirected to a URL\nspecified by urlRedirect.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." +} +}, +"type": "object" +}, +"HttpRouteRuleMatch": { +"description": "HttpRouteRuleMatch specifies a set of criteria for matching\nrequests to an HttpRouteRule. All specified criteria must\nbe satisfied for a match to occur.", +"id": "HttpRouteRuleMatch", +"properties": { +"fullPathMatch": { +"description": "For satisfying the matchRule condition, the path of the\nrequest must exactly match the value specified infullPathMatch after removing any query parameters and anchor\nthat may be part of the original URL.\n\nfullPathMatch must be from 1 to 1024 characters.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be\nspecified.", +"type": "string" +}, +"headerMatches": { +"description": "Specifies a list of header match criteria, all of which must match\ncorresponding headers in the request.", +"items": { +"$ref": "HttpHeaderMatch" +}, +"type": "array" +}, +"ignoreCase": { +"description": "Specifies that prefixMatch and fullPathMatch\nmatches are case sensitive.\n\nThe default value is false.\n\nignoreCase must not be used with regexMatch.\n\nNot supported when the URL map is bound to a target gRPC proxy.", +"type": "boolean" +}, +"metadataFilters": { +"description": "Opaque filter criteria used by the load balancer to restrict routing\nconfiguration to a limited set of xDS\ncompliant clients. In their xDS requests to the load balancer, xDS clients\npresent node\nmetadata. When there is a match, the relevant routing configuration\nis made available to those proxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata. If multiple\nmetadata filters are specified, all of them need to be\nsatisfied in order to be considered a match.\n\nmetadataFilters specified here is applied after those\nspecified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.\n\nmetadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true.", +"items": { +"$ref": "MetadataFilter" +}, +"type": "array" +}, +"pathTemplateMatch": { +"description": "If specified, this field defines a path template pattern that must match\nthe :path header after the query string is removed.\n\nA path template pattern can include variables and wildcards.\nVariables are enclosed in curly braces, for example{variable_name}. Wildcards include * that\nmatches a single path segment, and ** that matches zero or\nmore path segments. The pattern must follow these rules:\n\n \n - The value must be between 1 and 1024 characters.\n - The pattern must start with a leading slash (\"/\").\n - No more than 5 operators (variables or wildcards) may appear in\n the pattern.\n\nPrecisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be\nset.", +"type": "string" +}, +"prefixMatch": { +"description": "For satisfying the matchRule condition, the request's\npath must begin with the specified prefixMatch.prefixMatch must begin with a /.\n\nThe value must be from 1 to 1024 characters.\n\nThe * character inside a prefix match is\ntreated as a literal character, not as a wildcard.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be\nused within a matchRule.", +"type": "string" +}, +"queryParameterMatches": { +"description": "Specifies a list of query parameter match criteria, all of which must\nmatch corresponding query parameters in the request.\n\nNot supported when the URL map is bound to a target gRPC proxy.", +"items": { +"$ref": "HttpQueryParameterMatch" +}, +"type": "array" +}, +"regexMatch": { +"description": "For satisfying the matchRule condition, the path of the\nrequest must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor\nsupplied with the original URL. For\nmore information about regular expression syntax, see Syntax.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be\nspecified.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", +"type": "string" +} +}, +"type": "object" +}, +"HttpsHealthCheck": { +"description": "Represents a legacy HTTPS Health Check resource.\n\nLegacy HTTPS health checks have been deprecated. If you are using a target\npool-based network load balancer, you must use a legacy HTTP (not HTTPS)\nhealth check. For all other load balancers, including backend service-based\nnetwork load balancers, and for managed instance group auto-healing, you must\nuse modern (non-legacy) health checks.\n\nFor more information, seeHealth checks\noverview.", +"id": "HttpsHealthCheck", +"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] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"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" +}, +"host": { +"description": "The value of the host header in the HTTPS health check request. If left\nempty (default value), the public IP on behalf of which this health check\nis performed will be used.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#httpsHealthCheck", +"description": "Output only. Type of the resource.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"port": { +"description": "The TCP port number for the HTTPS health check request. The default value\nis 443.", +"format": "int32", +"type": "integer" +}, +"requestPath": { +"description": "The request path of the HTTPS health check request. The default value is\n\"/\". Must comply withRFC3986.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"timeoutSec": { +"description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have a greater value than\ncheckIntervalSec.", +"format": "int32", +"type": "integer" +}, +"unhealthyThreshold": { +"description": "A so-far healthy instance will be marked unhealthy after this\nmany consecutive failures. The default value is 2.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"HttpsHealthCheckList": { +"description": "Contains a list of HttpsHealthCheck resources.", +"id": "HttpsHealthCheckList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HttpsHealthCheck resources.", +"items": { +"$ref": "HttpsHealthCheck" +}, +"type": "array" +}, +"kind": { +"default": "compute#httpsHealthCheckList", +"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.", +"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" +}, +"Image": { +"description": "Represents an Image resource.\n\nYou can use images to create boot disks for your VM instances.\nFor more information, read Images.", +"id": "Image", +"properties": { +"architecture": { +"description": "The architecture of the image. Valid values are\nARM64 or X86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"type": "string" +}, +"archiveSizeBytes": { +"description": "Size of the image tar.gz archive stored in Google Cloud\nStorage (in bytes).", +"format": "int64", +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "Output only. The deprecation status associated with this image.", +"readOnly": true +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"diskSizeGb": { +"description": "Size of the image when restored onto a persistent disk (in GB).", +"format": "int64", +"type": "string" +}, +"enableConfidentialCompute": { +"description": "Output only. Whether this image is created from a confidential compute mode disk.\n[Output Only]: This field is not set by user, but from source disk.", +"readOnly": true, +"type": "boolean" +}, +"family": { +"description": "The name of the image family to which this image belongs. The image\nfamily name can be from a publicly managed image family provided by\nCompute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.\nFor more information, see Image\nfamily best practices.\n\nWhen creating disks, you can specify an image family instead of a specific\nimage name. The image family always returns its latest image that is not\ndeprecated. The name of the image family must comply with RFC1035.", +"type": "string" +}, +"guestOsFeatures": { +"description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.", +"items": { +"$ref": "GuestOsFeature" +}, +"type": "array" +}, +"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" +}, +"imageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Encrypts the image using acustomer-supplied\nencryption key.\n\nAfter you encrypt an image with a customer-supplied key, you must provide\nthe same key if you use the image later (e.g. to create a disk from\nthe image).\n\nCustomer-supplied encryption keys do not protect access to metadata\nof the disk.\n\nIf you do not provide an encryption key when creating the image, then the\ndisk will be encrypted using an automatically generated key and you do not\nneed to provide a key to use the image later." +}, +"kind": { +"default": "compute#image", +"description": "Output only. [Output Only] Type of the resource. Always compute#image for\nimages.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this image, which is\nessentially a hash of the labels used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an image.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this image. These can be later modified by\nthe setLabels method.", +"type": "object" +}, +"licenseCodes": { +"description": "Integer license codes indicating which licenses are attached to this image.", +"items": { +"format": "int64", +"type": "string" +}, +"type": "array" +}, +"licenses": { +"description": "Any applicable license URI.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"annotations": { +"required": [ +"compute.images.insert" +] +}, +"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 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" +}, +"params": { +"$ref": "ImageParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"rawDisk": { +"description": "The parameters of the raw disk image.", +"properties": { +"containerType": { +"description": "The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not\na runtime format. Provided by the client when the disk image is created.", +"enum": [ +"TAR" +], +"enumDescriptions": [ +"" +], +"type": "string" +}, +"sha1Checksum": { +"deprecated": true, +"description": "[Deprecated] This field is deprecated.\nAn optional SHA1 checksum of the disk image before unpackaging provided\nby the client when the disk image is created.", +"pattern": "[a-f0-9]{40}", +"type": "string" +}, +"source": { +"description": "The full Google Cloud Storage URL or Artifact Registry path where the raw\ndisk image archive is stored.\nThe following are valid formats:\n \n - https://storage.googleapis.com/bucket_name/image_archive_name\n - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name\n - projects/project/locations/location/repositories/repo/packages/package/versions/version_id\n - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", +"type": "string" +} +}, +"type": "object" +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"shieldedInstanceInitialState": { +"$ref": "InitialStateConfig", +"description": "Set the secure boot keys of shielded instance." +}, +"sourceDisk": { +"description": "URL of the source disk used to create this image.\nFor example, the following are valid values:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", +"type": "string" +}, +"sourceDiskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." +}, +"sourceDiskId": { +"description": "Output only. [Output Only]\nThe ID value of the disk used to create this image. This value may be used\nto determine whether the image was taken from the current or a previous\ninstance of a given disk name.", +"readOnly": true, +"type": "string" +}, +"sourceImage": { +"description": "URL of the source image used to create this image.\nThe following are valid formats for the URL:\n \n - https://www.googleapis.com/compute/v1/projects/project_id/global/\n images/image_name\n - projects/project_id/global/images/image_name\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", +"type": "string" +}, +"sourceImageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "The customer-supplied encryption key of the source image. Required if the\nsource image is protected by a customer-supplied encryption key." +}, +"sourceImageId": { +"description": "Output only. [Output Only]\nThe ID value of the image used to create this image. This value may be used\nto determine whether the image was taken from the current or a previous\ninstance of a given image name.", +"readOnly": true, +"type": "string" +}, +"sourceSnapshot": { +"description": "URL of the source snapshot used to create this image.\nThe following are valid formats for the URL:\n \n - https://www.googleapis.com/compute/v1/projects/project_id/global/\n snapshots/snapshot_name\n - projects/project_id/global/snapshots/snapshot_name\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", +"type": "string" +}, +"sourceSnapshotEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "The customer-supplied encryption key of the source snapshot. Required if\nthe source snapshot is protected by a customer-supplied encryption key." +}, +"sourceSnapshotId": { +"description": "Output only. [Output Only]\nThe ID value of the snapshot used to create this image. This value may be\nused to determine whether the snapshot was taken from the current or a\nprevious instance of a given snapshot name.", +"readOnly": true, +"type": "string" +}, +"sourceType": { +"default": "RAW", +"description": "The type of the image used to create this disk. The\ndefault and only valid value is RAW.", +"enum": [ +"RAW" +], +"enumDescriptions": [ +"" +], +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of the image. An image can be used to create other\nresources, such as instances, only after the image has been successfully\ncreated and the status is set to READY. Possible\nvalues are FAILED, PENDING, orREADY.", +"enum": [ +"DELETING", +"FAILED", +"PENDING", +"READY" +], +"enumDescriptions": [ +"Image is deleting.", +"Image creation failed due to an error.", +"Image hasn't been created as yet.", +"Image has been successfully created." +], +"readOnly": true, +"type": "string" +}, +"storageLocations": { +"description": "Cloud Storage bucket storage location of the image (regional or\nmulti-regional).", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ImageFamilyView": { +"id": "ImageFamilyView", +"properties": { +"image": { +"$ref": "Image", +"description": "The latest image that is part of the specified image family in the\nrequested location, and that is not deprecated." +} +}, +"type": "object" +}, +"ImageList": { +"description": "Contains a list of images.", +"id": "ImageList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Image resources.", +"items": { +"$ref": "Image" +}, +"type": "array" +}, +"kind": { +"default": "compute#imageList", +"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.", +"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" +}, +"ImageParams": { +"description": "Additional image params.", +"id": "ImageParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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" +}, +"ImageView": { +"description": "Represents a read-only view of a global Image resource.", +"id": "ImageView", +"properties": { +"image": { +"$ref": "Image", +"description": "The Image resource." +} +}, +"type": "object" +}, +"ImageViewsListResponse": { +"description": "Response message for ImageViewsService.List", +"id": "ImageViewsListResponse", +"properties": { +"etag": { +"description": "Etag of the resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Image resources.", +"items": { +"$ref": "ImageView" +}, +"type": "array" +}, +"kind": { +"default": "compute#imageViewList", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"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" +}, +"InitialStateConfig": { +"description": "Initial State for shielded instance,\nthese are public keys which are safe to store in public", +"id": "InitialStateConfig", +"properties": { +"dbs": { +"description": "The Key Database (db).", +"items": { +"$ref": "FileContentBuffer" +}, +"type": "array" +}, +"dbxs": { +"description": "The forbidden key database (dbx).", +"items": { +"$ref": "FileContentBuffer" +}, +"type": "array" +}, +"keks": { +"description": "The Key Exchange Key (KEK).", +"items": { +"$ref": "FileContentBuffer" +}, +"type": "array" +}, +"pk": { +"$ref": "FileContentBuffer", +"description": "The Platform Key (PK)." +} +}, +"type": "object" +}, +"Instance": { +"description": "Represents an Instance resource.\n\nAn instance is a virtual machine that is hosted on Google Cloud Platform.\nFor more information, readVirtual Machine Instances.", +"id": "Instance", +"properties": { +"advancedMachineFeatures": { +"$ref": "AdvancedMachineFeatures", +"description": "Controls for advanced machine-related behavior features." +}, +"canIpForward": { +"description": "Allows this instance to send and receive packets with non-matching\ndestination or source IPs. This is required if you plan to use this\ninstance to forward routes. For more information, seeEnabling IP Forwarding.", +"type": "boolean" +}, +"confidentialInstanceConfig": { +"$ref": "ConfidentialInstanceConfig" +}, +"cpuPlatform": { +"description": "Output only. [Output Only] The CPU platform used by this instance.", +"readOnly": true, +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"deletionProtection": { +"description": "Whether the resource should be protected against deletion.", +"type": "boolean" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"disks": { +"description": "Array of disks associated with this instance. Persistent disks must be\ncreated before you can assign them.", +"items": { +"$ref": "AttachedDisk" +}, +"type": "array" +}, +"displayDevice": { +"$ref": "DisplayDevice", +"description": "Enables display device for the instance." +}, +"fingerprint": { +"description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe instance's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update the instance. You must always provide an\nup-to-date fingerprint hash in order to update the instance.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", +"format": "byte", +"type": "string" +}, +"guestAccelerators": { +"description": "A list of the type and count of accelerator cards attached to the instance.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"hostname": { +"description": "Specifies the hostname of the instance. The specified hostname must be\nRFC1035 compliant. If hostname is not specified, the default hostname is\n[INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and\n[INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.", +"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" +}, +"instanceEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Encrypts suspended data for an instance with acustomer-managed\nencryption key.\n\nIf you are creating a new instance, this field will encrypt the local SSD\nand in-memory contents of the instance during the suspend operation.\n\nIf you do not provide an encryption key when creating the instance, then\nthe local SSD and in-memory contents will be encrypted using\nan automatically generated key during the suspend operation." +}, +"keyRevocationActionType": { +"description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", +"enum": [ +"KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", +"NONE", +"STOP" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Indicates user chose no operation.", +"Indicates user chose to opt for VM shutdown on key revocation." +], +"type": "string" +}, +"kind": { +"default": "compute#instance", +"description": "Output only. [Output Only] Type of the resource. Always compute#instance\nfor instances.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for this request, which is essentially a hash of\nthe label's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this instance. These can be later modified by\nthe setLabels method.", +"type": "object" +}, +"lastStartTimestamp": { +"description": "Output only. [Output Only] Last start timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"lastStopTimestamp": { +"description": "Output only. [Output Only] Last stop timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"lastSuspendedTimestamp": { +"description": "Output only. [Output Only] Last suspended timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"localSsdEncryptionMode": { +"description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", +"enum": [ +"EPHEMERAL_KEY_ENCRYPTION", +"LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", +"STANDARD_ENCRYPTION" +], +"enumDescriptions": [ +"The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", +"The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", +"The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." +], +"type": "string" +}, +"machineType": { +"description": "Full or partial URL of the machine type resource to use for this instance,\nin the format:zones/zone/machineTypes/machine-type. This is provided by the client\nwhen the instance is created. For example, the following is a valid partial\nurl to a predefined\nmachine type:\n\nzones/us-central1-f/machineTypes/n1-standard-1\n\n\nTo create acustom\nmachine type, provide a URL to a machine type in the following format,\nwhere CPUS is 1 or an even number up to 32 (2,\n4, 6, ... 24, etc), and MEMORY is the total\nmemory for this instance. Memory must be a multiple of 256 MB and must\nbe supplied in MB (e.g. 5 GB of memory is 5120 MB):\n\nzones/zone/machineTypes/custom-CPUS-MEMORY\n\n\nFor example: zones/us-central1-f/machineTypes/custom-4-5120\n\nFor a full list of restrictions, read theSpecifications\nfor custom machine types.", +"type": "string" +}, +"metadata": { +"$ref": "Metadata", +"description": "The metadata key/value pairs assigned\nto this instance. This includes metadata keys that were explicitly defined\nfor the instance." +}, +"minCpuPlatform": { +"description": "Specifies aminimum CPU\nplatform for the VM instance. Applicable values are the friendly names\nof CPU platforms, such as minCpuPlatform: \"Intel\nHaswell\" or minCpuPlatform: \"Intel Sandy\nBridge\".", +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instances.insert" +] +}, +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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" +}, +"networkInterfaces": { +"description": "An array of network configurations for this instance. These specify how\ninterfaces are configured to interact with other network services, such as\nconnecting to the internet. Multiple interfaces are supported\nper instance.", +"items": { +"$ref": "NetworkInterface" +}, +"type": "array" +}, +"networkPerformanceConfig": { +"$ref": "NetworkPerformanceConfig" +}, +"params": { +"$ref": "InstanceParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"privateIpv6GoogleAccess": { +"description": "The private IPv6 google access type for the VM.\nIf not specified, use INHERIT_FROM_SUBNETWORK as default.", +"enum": [ +"ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", +"ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", +"INHERIT_FROM_SUBNETWORK" +], +"enumDescriptions": [ +"Bidirectional private IPv6 access to/from Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", +"Outbound private IPv6 access from VMs in this subnet to Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", +"Each network interface inherits PrivateIpv6GoogleAccess from its\nsubnetwork." +], +"type": "string" +}, +"reservationAffinity": { +"$ref": "ReservationAffinity", +"description": "Specifies the reservations that this instance can consume from." +}, +"resourcePolicies": { +"description": "Resource policies applied to this instance.", +"items": { +"type": "string" +}, +"type": "array" +}, +"resourceStatus": { +"$ref": "ResourceStatus", +"description": "Output only. [Output Only] Specifies values set for instance attributes as\ncompared to the values requested by user in the corresponding input only\nfield.", +"readOnly": true +}, +"satisfiesPzi": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"scheduling": { +"$ref": "Scheduling", +"description": "Sets the scheduling options for this instance." +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"serviceAccounts": { +"description": "A list of service accounts, with their specified scopes, authorized for\nthis instance. Only one service account per VM instance is supported.\n\nService accounts generate access tokens that can be accessed\nthrough the metadata server and used to authenticate applications on the\ninstance. SeeService Accounts\nfor more information.", +"items": { +"$ref": "ServiceAccount" +}, +"type": "array" +}, +"shieldedInstanceConfig": { +"$ref": "ShieldedInstanceConfig" +}, +"shieldedInstanceIntegrityPolicy": { +"$ref": "ShieldedInstanceIntegrityPolicy" +}, +"sourceMachineImage": { +"description": "Source machine image", +"type": "string" +}, +"sourceMachineImageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Source machine image encryption key when creating an instance from a\nmachine image." +}, +"startRestricted": { +"description": "Output only. [Output Only] Whether a VM has been restricted for start because Compute\nEngine has detected suspicious activity.", +"readOnly": true, +"type": "boolean" +}, +"status": { +"description": "Output only. [Output Only] The status of the instance. One of the\nfollowing values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the\ninstance, see \nInstance life cycle.", +"enum": [ +"DEPROVISIONING", +"PENDING", +"PENDING_STOP", +"PROVISIONING", +"REPAIRING", +"RUNNING", +"STAGING", +"STOPPED", +"STOPPING", +"SUSPENDED", +"SUSPENDING", +"TERMINATED" +], +"enumDescriptions": [ +"The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", +"For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", +"The instance is gracefully shutting down.", +"Resources are being allocated for the instance.", +"The instance is in repair.", +"The instance is running.", +"All required resources have been allocated and the instance\nis being started.", +"The instance has stopped successfully.", +"The instance is currently stopping (either being deleted or killed).", +"The instance has suspended.", +"The instance is suspending.", +"The instance has stopped (either by explicit action or underlying\nfailure)." +], +"readOnly": true, +"type": "string" +}, +"statusMessage": { +"description": "Output only. [Output Only] An optional, human-readable explanation of the status.", +"readOnly": true, +"type": "string" +}, +"tags": { +"$ref": "Tags", +"description": "Tags to apply to this instance. Tags are used to identify valid\nsources or targets for network firewalls and are specified by the client\nduring instance creation. The tags can be later modified by the setTags\nmethod. Each tag within the list must comply withRFC1035.\nMultiple tags can be specified via the 'tags.items' field." +}, +"workloadIdentityConfig": { +"$ref": "WorkloadIdentityConfig" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the instance resides.\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" +} +}, +"type": "object" +}, +"InstanceAggregatedList": { +"id": "InstanceAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InstancesScopedList", +"description": "[Output Only] Name of the scope containing this set of instances." +}, +"description": "An object that contains a list of instances scoped by zone.", +"type": "object" +}, +"kind": { +"default": "compute#instanceAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of\nInstance resources.", +"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" +}, +"InstanceConsumptionData": { +"id": "InstanceConsumptionData", +"properties": { +"consumptionInfo": { +"$ref": "InstanceConsumptionInfo", +"description": "Output only. Resources consumed by the instance.", +"readOnly": true +}, +"instance": { +"description": "Output only. Server-defined URL for the instance.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceConsumptionInfo": { +"id": "InstanceConsumptionInfo", +"properties": { +"guestCpus": { +"description": "Output only. The number of virtual CPUs that are available to the instance.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"localSsdGb": { +"description": "Output only. The amount of local SSD storage available to the instance,\ndefined in GiB.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"memoryMb": { +"description": "Output only. The amount of physical memory available to the instance,\ndefined in MiB.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"minNodeCpus": { +"description": "Output only. The minimal guaranteed number of virtual CPUs that are reserved.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"InstanceFlexibilityPolicy": { +"description": "A flexible specification of machine types for instances to create.", +"id": "InstanceFlexibilityPolicy", +"properties": { +"instanceSelections": { +"additionalProperties": { +"$ref": "InstanceFlexibilityPolicyInstanceSelection" +}, +"description": "Specification of alternative, flexible instance subsets.\nOne of them will be selected to create the instances\nbased on various criteria, like:\n- ranks,\n- location policy,\n- current capacity,\n- available reservations (you can specify affinity in\nInstanceProperties),\n- SWAN/GOOSE limitations.\nKey is an arbitrary, unique RFC1035 string that identifies the instance\nselection.", +"type": "object" +} +}, +"type": "object" +}, +"InstanceFlexibilityPolicyInstanceSelection": { +"description": "Specification of machine type to use. Every position inside this message\nis an alternative.\nThe count specified in the shape flexibility must not exceed the number\nof entries in per_instance_properties or the capacity of the\nname_pattern, if used.", +"id": "InstanceFlexibilityPolicyInstanceSelection", +"properties": { +"disks": { +"description": "Disks to be attached to the instances created from in this selection.\nThey override the disks specified in the instance properties.", +"items": { +"$ref": "AttachedDisk" +}, +"type": "array" +}, +"machineTypes": { +"description": "Alternative machine types to use for instances that are created from\nthese properties. This field only accepts a machine type names, for\nexample `n2-standard-4` and not URLs or partial URLs.", +"items": { +"type": "string" +}, +"type": "array" +}, +"minCpuPlatform": { +"description": "Name of the minimum CPU platform to be used by this instance selection.\ne.g. 'Intel Ice Lake'.", +"type": "string" +}, +"rank": { +"description": "Rank when prioritizing the shape flexibilities.\nThe instance selections with rank are considered\nfirst, in the ascending order of the rank.\nIf not set, defaults to 0.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroup": { +"description": "Represents an Instance Group resource.\n\nInstance Groups can be used to configure a target forload\nbalancing.\n\nInstance groups can either be managed or unmanaged.\n\nTo create \nmanaged instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.\n\nUse zonal unmanaged instance groups if you need to applyload\nbalancing to groups of heterogeneous instances or if you need to manage\nthe instances yourself. You cannot create regional unmanaged instance groups.\n\nFor more information, readInstance\ngroups.", +"id": "InstanceGroup", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] The creation timestamp for this instance group 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": "Output only. [Output Only] The fingerprint of the named ports. The system\nuses this fingerprint to detect conflicts when multiple users change the\nnamed ports concurrently.", +"format": "byte", +"readOnly": true, +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this instance group, generated\nby the server.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#instanceGroup", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instanceGroups.insert" +] +}, +"description": "The name of the instance group. The name must be 1-63 characters\nlong, and comply withRFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"namedPorts": { +"description": "Optional. Assigns a name to a port number. For example:{name: \"http\", port: 80}\n\nThis\nallows the system to reference ports by the assigned name instead of a\nport number. Named ports can also contain multiple ports. For example:[{name: \"app1\", port: 8080}, {name:\n\"app1\", port: 8081}, {name: \"app2\", port:\n8082}]\n\nNamed ports apply to all instances in this instance group.", +"items": { +"$ref": "NamedPort" +}, +"type": "array" +}, +"network": { +"description": "[Output Only] The URL of the network to which all instances in the\ninstance group belong. If your instance has multiple network interfaces,\nthen the network and subnetwork fields only refer to the\nnetwork and subnet used by your primary interface (nic0).", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] The URL of theregion\nwhere the instance group is located (for regional resources).", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] The URL for this instance group. The server generates\nthis URL.", +"readOnly": true, +"type": "string" +}, +"size": { +"description": "Output only. [Output Only] The total number of instances in the instance group.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"subnetwork": { +"description": "Output only. [Output Only] The URL of the subnetwork to which all instances in the\ninstance group belong. If your instance has multiple network interfaces,\nthen the network and subnetwork fields only refer to the\nnetwork and subnet used by your primary interface (nic0).", +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] The URL of thezone\nwhere the instance group is located (for zonal resources).", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupAggregatedList": { +"id": "InstanceGroupAggregatedList", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InstanceGroupsScopedList", +"description": "The name of the scope that contains this set of instance groups." +}, +"description": "A list of InstanceGroupsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#instanceGroupAggregatedList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of\ninstance groups.", +"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" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "Output only. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupList": { +"description": "A list of InstanceGroup resources.", +"id": "InstanceGroupList", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceGroup resources.", +"items": { +"$ref": "InstanceGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceGroupList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists.", +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManager": { +"description": "Represents a Managed Instance Group resource.\n\nAn instance group is a collection of VM instances that you can manage as a\nsingle entity. For more information, readInstance groups.\n\nFor zonal Managed Instance Group, use the instanceGroupManagers\nresource.\n\nFor regional Managed Instance Group, use theregionInstanceGroupManagers resource.", +"id": "InstanceGroupManager", +"properties": { +"allInstancesConfig": { +"$ref": "InstanceGroupManagerAllInstancesConfig", +"description": "Specifies configuration that overrides the instance template configuration\nfor the group." +}, +"autoHealingPolicies": { +"description": "The autohealing policy for this managed instance group. You can specify\nonly one value.", +"items": { +"$ref": "InstanceGroupManagerAutoHealingPolicy" +}, +"type": "array" +}, +"baseInstanceName": { +"description": "The base instance name is a prefix that you want to attach to the names of\nall VMs in a MIG. The maximum character length is 58 and the name must\ncomply with RFC1035 format.\n\nWhen a VM is created in the group, the MIG appends a hyphen and a random\nfour-character string to the base instance name. If you want the MIG to\nassign sequential numbers instead of a random string, then end the base\ninstance name with a hyphen followed by one or more hash symbols. The hash\nsymbols indicate the number of digits. For example, a base instance name of\n\"vm-###\" results in \"vm-001\" as a VM name.\n@pattern\n[a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\\\[[0-9]{1,10}\\\\])?))", +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. The creation timestamp for this managed instance group inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"currentActions": { +"$ref": "InstanceGroupManagerActionsSummary", +"description": "Output only. The list of instance actions and the number of instances\nin this managed instance group that are scheduled for each of those\nactions.", +"readOnly": true +}, +"description": { +"description": "An optional description of this resource.", +"type": "string" +}, +"distributionPolicy": { +"$ref": "DistributionPolicy", +"description": "Policy specifying the intended distribution of managed instances across\nzones in a regional managed instance group." +}, +"fingerprint": { +"description": "Fingerprint of this resource. This field may be used in optimistic locking.\nIt will be ignored when inserting an InstanceGroupManager. An up-to-date\nfingerprint must be provided in order to update the InstanceGroupManager,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an InstanceGroupManager.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. A unique identifier for this resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"instanceFlexibilityPolicy": { +"$ref": "InstanceGroupManagerInstanceFlexibilityPolicy", +"description": "Instance flexibility allowing MIG to create VMs from multiple\ntypes of machines.\nInstance flexibility configuration on MIG overrides instance\ntemplate configuration." +}, +"instanceGroup": { +"description": "Output only. The URL of the Instance Group resource.", +"readOnly": true, +"type": "string" +}, +"instanceLifecyclePolicy": { +"$ref": "InstanceGroupManagerInstanceLifecyclePolicy", +"description": "The repair policy for this managed instance group." +}, +"instanceTemplate": { +"description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create all new instances\nin the managed instance group. The templates for existing instances in the\ngroup do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", +"type": "string" +}, +"kind": { +"default": "compute#instanceGroupManager", +"description": "Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.", +"readOnly": true, +"type": "string" +}, +"listManagedInstancesResults": { +"description": "Pagination behavior of the listManagedInstances API method for\nthis managed instance group.", +"enum": [ +"PAGELESS", +"PAGINATED" +], +"enumDescriptions": [ +"(Default) Pagination is disabled for the group'slistManagedInstances API method. maxResults\nand pageToken query parameters are ignored and all\ninstances are returned in a single response.", +"Pagination is enabled for the group's listManagedInstances\nAPI method. maxResults and pageToken query\nparameters are respected." +], +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instanceGroupManagers.insert", +"compute.regionInstanceGroupManagers.insert" +] +}, +"description": "The name of the managed instance group. The name must be 1-63 characters\nlong, and comply withRFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"namedPorts": { +"description": "[Output Only] Named ports configured on the Instance Groups complementary\nto this Instance Group Manager.", +"items": { +"$ref": "NamedPort" +}, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] The URL of theregion\nwhere the managed instance group resides (for regional resources).", +"readOnly": true, +"type": "string" +}, +"resourcePolicies": { +"$ref": "InstanceGroupManagerResourcePolicies", +"description": "Resource policies for this managed instance group." +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. The URL for this managed instance group. The server defines\nthis URL.", +"readOnly": true, +"type": "string" +}, +"standbyPolicy": { +"$ref": "InstanceGroupManagerStandbyPolicy", +"description": "Standby policy for stopped and suspended instances." +}, +"statefulPolicy": { +"$ref": "StatefulPolicy", +"description": "Stateful configuration for this Instanced Group Manager" +}, +"status": { +"$ref": "InstanceGroupManagerStatus", +"description": "Output only. The status of this managed instance group.", +"readOnly": true +}, +"targetPools": { +"description": "The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically\napply to all of the instances in the managed instance group.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetSize": { +"annotations": { +"required": [ +"compute.instanceGroupManagers.insert", +"compute.regionInstanceGroupManagers.insert" +] +}, +"description": "The target number of running instances for this managed instance group.\nYou can reduce this number by using the instanceGroupManager\ndeleteInstances or abandonInstances methods. Resizing the group also\nchanges this number.", +"format": "int32", +"type": "integer" +}, +"targetSizePolicy": { +"$ref": "InstanceGroupManagerTargetSizePolicy", +"description": "The policy that specifies how the MIG creates its VMs to achieve the target\nsize." +}, +"targetStoppedSize": { +"description": "The target number of stopped instances for this managed instance group.\nThis number changes when you: \n \n - Stop instance using the stopInstances\n method or start instances using the startInstances\n method.\n - Manually change the targetStoppedSize using the update\n method.", +"format": "int32", +"type": "integer" +}, +"targetSuspendedSize": { +"description": "The target number of suspended instances for this managed instance group.\nThis number changes when you: \n \n - Suspend instance using the suspendInstances\n method or resume instances using the resumeInstances\n method.\n - Manually change the targetSuspendedSize using the update\n method.", +"format": "int32", +"type": "integer" +}, +"updatePolicy": { +"$ref": "InstanceGroupManagerUpdatePolicy", +"description": "The update policy for this managed instance group." +}, +"versions": { +"description": "Specifies the instance templates used by this managed instance group to\ncreate instances.\n\nEach version is defined by an instanceTemplate and aname. Every version can appear at most once per instance\ngroup. This field overrides the top-level instanceTemplate\nfield. Read more about therelationships\nbetween these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all\nremaining instances. For more information, read aboutcanary\nupdates.", +"items": { +"$ref": "InstanceGroupManagerVersion" +}, +"type": "array" +}, +"zone": { +"description": "Output only. The URL of azone\nwhere the managed instance group is located (for zonal resources).", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerActionsSummary": { +"id": "InstanceGroupManagerActionsSummary", +"properties": { +"abandoning": { +"description": "Output only. The total number of instances in the managed instance group\nthat are scheduled to be abandoned. Abandoning an instance removes it\nfrom the managed instance group without deleting it.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"creating": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be created or are currently being created. If the group\nfails to create any of these instances, it tries again until it creates\nthe instance successfully.\n\nIf you have disabled creation retries, this field will not be populated;\ninstead, the creatingWithoutRetries field will be populated.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"creatingWithoutRetries": { +"description": "Output only. The number of instances that the managed instance group\nwill attempt to create. The group attempts to create each instance\nonly once. If the group fails to create any of these instances, it\ndecreases the group's targetSize value accordingly.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"deleting": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be deleted or are currently being deleted.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"none": { +"description": "Output only. The number of instances in the managed instance group that\nare running and have no scheduled actions.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"recreating": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be recreated or are currently being being recreated.\nRecreating an instance deletes the existing root persistent disk\nand creates a new disk from the image that is defined in the\ninstance template.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"refreshing": { +"description": "Output only. The number of instances in the managed instance group that\nare being reconfigured with properties that do not require a restart\nor a recreate action. For example, setting or removing target\npools for the instance.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"restarting": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be restarted or are currently being restarted.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"resuming": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be resumed or are currently being resumed.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"starting": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be started or are currently being started.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"stopping": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be stopped or are currently being stopped.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"suspending": { +"description": "Output only. The number of instances in the managed instance group that\nare scheduled to be suspended or are currently being suspended.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"verifying": { +"description": "Output only. The number of instances in the managed instance group that\nare being verified. See the managedInstances[].currentAction\nproperty in the listManagedInstances method documentation.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"InstanceGroupManagerAggregatedList": { +"id": "InstanceGroupManagerAggregatedList", +"properties": { +"id": { +"description": "Output only. Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InstanceGroupManagersScopedList", +"description": "Output only. The name of the scope that contains this set of managed instance groups." +}, +"description": "A list of InstanceGroupManagersScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#instanceGroupManagerAggregatedList", +"description": "Output only. The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated\nlist of managed instance groups.", +"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.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"unreachables": { +"description": "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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagerAllInstancesConfig": { +"id": "InstanceGroupManagerAllInstancesConfig", +"properties": { +"properties": { +"$ref": "InstancePropertiesPatch", +"description": "Properties to set on all instances in the group.\n\nYou can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's\ninstances to apply the configuration. To apply the configuration, set the\ngroup's updatePolicy.type field to use proactive updates or\nuse the applyUpdatesToInstances method." +} +}, +"type": "object" +}, +"InstanceGroupManagerAutoHealingPolicy": { +"id": "InstanceGroupManagerAutoHealingPolicy", +"properties": { +"healthCheck": { +"description": "The URL for the health check that signals autohealing.", +"type": "string" +}, +"initialDelaySec": { +"description": "The initial delay is the number of seconds that a new VM takes to\ninitialize and run its startup script. During a VM's initial delay\nperiod, the MIG ignores unsuccessful health checks because the VM might\nbe in the startup process. This prevents the MIG from prematurely\nrecreating a VM. If the health check receives a healthy response during\nthe initial delay, it indicates that the startup process is complete and\nthe VM is ready. The value of initial delay must be between 0 and 3600\nseconds. The default value is 0.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"InstanceGroupManagerInstanceFlexibilityPolicy": { +"id": "InstanceGroupManagerInstanceFlexibilityPolicy", +"properties": { +"instanceSelections": { +"additionalProperties": { +"$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" +}, +"description": "Named instance selections configuring properties that the group will use\nwhen creating new VMs.", +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection": { +"id": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection", +"properties": { +"disks": { +"description": "List of disks to be attached to the instances created from this\nselection.", +"items": { +"$ref": "AttachedDisk" +}, +"type": "array" +}, +"machineTypes": { +"description": "Full machine-type names, e.g. \"n1-standard-16\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"minCpuPlatform": { +"description": "Name of the minimum CPU platform to be used by this instance selection.\ne.g. 'Intel Ice Lake'.", +"type": "string" +}, +"rank": { +"description": "Preference of this instance selection. Lower number means higher\npreference. MIG will first try to create a VM based on the machine-type\nwith lowest rank and fallback to next rank based on availability.\nMachine types and instance selections with the same rank have the same\npreference.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"InstanceGroupManagerInstanceLifecyclePolicy": { +"id": "InstanceGroupManagerInstanceLifecyclePolicy", +"properties": { +"defaultActionOnFailure": { +"description": "The action that a MIG performs on a failed VM. If the value of the\nonFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also\napplies to the VMs on which your application fails a health check.\nValid values are \n \n - REPAIR (default): MIG automatically repairs a failed VM\n by recreating it. For more information, see About\n repairing VMs in a MIG.\n - DO_NOTHING: MIG does not repair a failed VM.", +"enum": [ +"DO_NOTHING", +"REPAIR" +], +"enumDescriptions": [ +"MIG does not repair a failed VM.", +"(default): MIG automatically repairs a failed VM by recreating it.\nFor more information, see About\nrepairing VMs in a MIG." +], +"type": "string" +}, +"forceUpdateOnRepair": { +"description": "A bit indicating whether to forcefully apply the group's latest\nconfiguration when repairing a VM. Valid options are:\n\n \n \n - NO (default): If configuration updates are available, they are not\n forcefully applied during repair. Instead, configuration updates are\n applied according to the group's update policy.\n \n - YES: If configuration updates are available, they are applied\n during repair.", +"enum": [ +"NO", +"YES" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"onFailedHealthCheck": { +"description": "The action that a MIG performs on an unhealthy VM. A VM is marked as\nunhealthy when the application running on that VM fails a health check.\nValid values are:\n \n - DEFAULT_ACTION (default): MIG uses the same action\n configured for instanceLifecyclePolicy.defaultActionOnFailure field.\n - REPAIR: MIG automatically repairs an unhealthy VM by\n recreating it.\n - DO_NOTHING: MIG doesn't repair an unhealthy VM.\n For more information, see \n About repairing VMs in a MIG.", +"enum": [ +"DEFAULT_ACTION", +"DO_NOTHING", +"REPAIR" +], +"enumDescriptions": [ +"(Default) MIG uses the same action configured for\ninstanceLifecyclePolicy.defaultActionOnFailure field.", +"MIG doesn't repair an unhealthy VM.", +"MIG automatically repairs an unhealthy VM by recreating it." +], +"type": "string" +}, +"onRepair": { +"$ref": "InstanceGroupManagerInstanceLifecyclePolicyOnRepair", +"description": "Configuration for VM repairs in the MIG." +} +}, +"type": "object" +}, +"InstanceGroupManagerInstanceLifecyclePolicyOnRepair": { +"description": "Configuration for VM repairs in the MIG.", +"id": "InstanceGroupManagerInstanceLifecyclePolicyOnRepair", +"properties": { +"allowChangingZone": { +"description": "Specifies whether the MIG can change a VM's zone during a repair.\nValid values are:\n \n - NO (default): MIG cannot change a VM's zone during a\n repair.\n - YES: MIG can select a different zone for the VM during\n a repair.", +"enum": [ +"NO", +"YES" +], +"enumDescriptions": [ +"[Default] MIG cannot change a VM's zone during a repair.", +"MIG can select a different zone for the VM during a repair." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerList": { +"description": "[Output Only] A list of managed instance groups.", +"id": "InstanceGroupManagerList", +"properties": { +"id": { +"description": "Output only. Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceGroupManager resources.", +"items": { +"$ref": "InstanceGroupManager" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceGroupManagerList", +"description": "Output only. The resource type, which is always compute#instanceGroupManagerList for a\nlist of managed instance groups.", +"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.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagerResizeRequest": { +"description": "InstanceGroupManagerResizeRequest represents a request to create\na number of VMs: either immediately or by queuing the request for the\nspecified time. This resize request is nested under InstanceGroupManager\nand the VMs created by this request are added to the owning\nInstanceGroupManager.", +"id": "InstanceGroupManagerResizeRequest", +"properties": { +"creationTimestamp": { +"description": "Output only. The creation timestamp for this resize request inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource.", +"type": "string" +}, +"id": { +"description": "Output only. A unique identifier for this resource type. The server generates this\nidentifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"instances": { +"description": "The names of instances to be created by this resize request. The number of\nnames specified determines the number of instances to create. The group's\ntarget size will be increased by this number. This field cannot be used\ntogether with 'resize_by'.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceGroupManagerResizeRequest", +"description": "Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instanceGroupManagerResizeRequests.insert" +] +}, +"description": "The name of this resize request. The name must be 1-63 characters\nlong, and comply withRFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"region": { +"description": "Output only. The URL of a region\nwhere the resize request is located. Populated only for regional resize\nrequests.", +"readOnly": true, +"type": "string" +}, +"requestedRunDuration": { +"$ref": "Duration", +"description": "Requested run duration for instances that will be created by this request.\nAt the end of the run duration instance will be deleted." +}, +"resizeBy": { +"description": "The number of instances to be created by this resize request. The group's\ntarget size will be increased by this number. This field cannot be used\ntogether with 'instances'.", +"format": "int32", +"type": "integer" +}, +"selfLink": { +"description": "Output only. The URL for this resize request. The server defines this URL.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. Current state of the request.", +"enum": [ +"ACCEPTED", +"CANCELLED", +"CREATING", +"FAILED", +"STATE_UNSPECIFIED", +"SUCCEEDED" +], +"enumDescriptions": [ +"The request was created successfully and was accepted for provisioning\nwhen the capacity becomes available.", +"The request is cancelled.", +"Resize request is being created and may still fail creation.", +"The request failed before or during provisioning. If the request fails\nduring provisioning, any VMs that were created during provisioning are\nrolled back and removed from the MIG.", +"Default value. This value should never be returned.", +"The request succeeded." +], +"readOnly": true, +"type": "string" +}, +"status": { +"$ref": "InstanceGroupManagerResizeRequestStatus", +"description": "Output only. Status of the request.", +"readOnly": true +}, +"zone": { +"description": "Output only. The URL of a zone\nwhere the resize request is located. Populated only for zonal resize\nrequests.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerResizeRequestStatus": { +"id": "InstanceGroupManagerResizeRequestStatus", +"properties": { +"error": { +"description": "Output only. Fatal errors encountered during the queueing or provisioning phases of\nthe ResizeRequest that caused the transition to the FAILED state.\nContrary to the last_attempt errors, this field is final and errors are\nnever removed from here, as the ResizeRequest is not going to retry.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"lastAttempt": { +"$ref": "InstanceGroupManagerResizeRequestStatusLastAttempt", +"description": "Output only. Information about the last attempt to fulfill the request. The value is\ntemporary since the ResizeRequest can retry, as long as it's still active\nand the last attempt value can either be cleared or replaced with a\ndifferent error. Since ResizeRequest retries infrequently, the value may\nbe stale and no longer show an active problem. The value is cleared when\nResizeRequest transitions to the final state (becomes inactive). If the\nfinal state is FAILED the error describing it will be stored in the\n\"error\" field only.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceGroupManagerResizeRequestStatusLastAttempt": { +"id": "InstanceGroupManagerResizeRequestStatusLastAttempt", +"properties": { +"error": { +"description": "Output only. Errors that prevented the ResizeRequest to be fulfilled.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagerResizeRequestsListResponse": { +"description": "[Output Only] A list of resize requests.", +"id": "InstanceGroupManagerResizeRequestsListResponse", +"properties": { +"id": { +"description": "Output only. Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of resize request resources.", +"items": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceGroupManagerResizeRequestList", +"description": "Output only. Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for\na list of resize requests.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "Output only. This token allows you to get the next page of results for list requests.\nIf the number of results is larger than maxResults, use thenextPageToken as a value for the query parameterpageToken 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. 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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagerResourcePolicies": { +"id": "InstanceGroupManagerResourcePolicies", +"properties": { +"workloadPolicy": { +"description": "The URL of the workload policy that is specified for this managed\ninstance group.\nIt can be a full or partial URL. For example, the following are\nall valid URLs to a workload policy: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n - projects/project/regions/region/resourcePolicies/resourcePolicy\n - regions/region/resourcePolicies/resourcePolicy", +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerStandbyPolicy": { +"id": "InstanceGroupManagerStandbyPolicy", +"properties": { +"initialDelaySec": { +"description": "Specifies the number of seconds that the MIG should wait to suspend or\nstop a VM after that VM was created. The initial delay gives the\ninitialization script the time to prepare your VM for a quick scale out.\nThe value of initial delay must be between 0 and 3600 seconds. The\ndefault value is 0.", +"format": "int32", +"type": "integer" +}, +"mode": { +"description": "Defines how a MIG resumes or starts VMs from a standby pool when the\ngroup scales out. The default mode is `MANUAL`.", +"enum": [ +"MANUAL", +"SCALE_OUT_POOL" +], +"enumDescriptions": [ +"MIG does not automatically resume or start VMs in the standby pool when\nthe group scales out.", +"MIG automatically resumes or starts VMs in the standby pool when the\ngroup scales out, and replenishes the standby pool afterwards." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatus": { +"id": "InstanceGroupManagerStatus", +"properties": { +"allInstancesConfig": { +"$ref": "InstanceGroupManagerStatusAllInstancesConfig", +"description": "Output only. Status of all-instances configuration on the group.", +"readOnly": true +}, +"appliedAcceleratorTopologies": { +"description": "Output only. The accelerator topology applied to this MIG.\nCurrently only one accelerator topology is supported.", +"items": { +"$ref": "InstanceGroupManagerStatusAcceleratorTopology" +}, +"readOnly": true, +"type": "array" +}, +"autoscaler": { +"description": "Output only. The URL of theAutoscaler\nthat targets this instance group manager.", +"readOnly": true, +"type": "string" +}, +"bulkInstanceOperation": { +"$ref": "InstanceGroupManagerStatusBulkInstanceOperation", +"description": "Output only. The status of bulk instance operation.", +"readOnly": true +}, +"currentInstanceStatuses": { +"$ref": "InstanceGroupManagerStatusInstanceStatusSummary", +"description": "Output only. The list of instance statuses and the number of instances\nin this managed instance group that have the status. Currently only shown\nfor TPU MIGs", +"readOnly": true +}, +"isStable": { +"description": "Output only. A bit indicating whether the managed instance group is in a\nstable state. A stable state means that: none of the instances in the\nmanaged instance group is currently undergoing any type of change (for\nexample, creation, restart, or deletion); no future changes are scheduled\nfor instances in the managed instance group; and the managed instance\ngroup itself is not being modified.", +"readOnly": true, +"type": "boolean" +}, +"stateful": { +"$ref": "InstanceGroupManagerStatusStateful", +"description": "Output only. Stateful status of the given Instance Group Manager.", +"readOnly": true +}, +"versionTarget": { +"$ref": "InstanceGroupManagerStatusVersionTarget", +"description": "Output only. A status of consistency of Instances' versions with their\ntarget version specified by version field on Instance Group\nManager.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusAcceleratorTopology": { +"id": "InstanceGroupManagerStatusAcceleratorTopology", +"properties": { +"acceleratorTopology": { +"description": "Output only. Topology in the format of: \"16x16\", \"4x4x4\", etc.\nThe value is the same as configured in the WorkloadPolicy.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The state of the accelerator topology.", +"enum": [ +"ACTIVATING", +"ACTIVE", +"DEACTIVATING", +"FAILED", +"INCOMPLETE", +"REACTIVATING" +], +"enumDescriptions": [ +"The accelerator topology is being activated.", +"The accelerator topology is active.", +"The accelerator topology is being deactivated.", +"The accelerator topology failed.", +"The configuration is incomplete and the accelerator topology cannot\nbe activated due to insufficient number of running VMs.", +"The accelerator topology is being reactivated." +], +"readOnly": true, +"type": "string" +}, +"stateDetails": { +"$ref": "InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails", +"description": "Output only. The result of the latest accelerator topology state\ncheck.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails": { +"id": "InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails", +"properties": { +"error": { +"description": "Output only. Encountered errors.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"timestamp": { +"description": "Output only. Timestamp is shown only if there is an error. The field\nhas // RFC3339 //\ntext format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusAllInstancesConfig": { +"id": "InstanceGroupManagerStatusAllInstancesConfig", +"properties": { +"currentRevision": { +"description": "Output only. Current all-instances configuration revision.\nThis value is in RFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"effective": { +"description": "Output only. A bit indicating whether this configuration has\nbeen applied to all managed instances in the group.", +"readOnly": true, +"type": "boolean" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusBulkInstanceOperation": { +"description": "Bulk instance operation is the creation of VMs in a MIG when the\ntargetSizePolicy.mode is set to BULK.", +"id": "InstanceGroupManagerStatusBulkInstanceOperation", +"properties": { +"inProgress": { +"description": "Output only. Informs whether bulk instance operation is in progress.", +"readOnly": true, +"type": "boolean" +}, +"lastProgressCheck": { +"$ref": "InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck", +"description": "Output only. Information from the last progress check of bulk instance\noperation.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck": { +"id": "InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck", +"properties": { +"error": { +"description": "Output only. Errors encountered during bulk instance operation.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"timestamp": { +"description": "Output only. Timestamp of the last progress check of bulk instance\noperation. Timestamp is in RFC3339 text format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusInstanceStatusSummary": { +"description": "The list of instance statuses and the number of instances in this managed\ninstance group that have the status. For more information about how to\ninterpret each status check the instance lifecycle documentation.\nCurrently only shown for TPU MIGs.", +"id": "InstanceGroupManagerStatusInstanceStatusSummary", +"properties": { +"deprovisioning": { +"description": "Output only. The number of instances in the managed instance group\nthat have DEPROVISIONING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"nonExistent": { +"description": "Output only. The number of instances that have not been created yet or\nhave been deleted. Includes only instances that would be shown in the\nlistManagedInstances method and not all instances that have been\ndeleted in the lifetime of the MIG.\nDoes not include FlexStart instances that are waiting for the resources\navailability, they are considered as 'pending'.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"pending": { +"description": "Output only. The number of instances in the managed instance group\nthat have PENDING status, that is FlexStart instances that are waiting\nfor resources. Instances that do not exist because of the other reasons\nare counted as 'non_existent'.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"pendingStop": { +"description": "Output only. The number of instances in the managed instance group\nthat have PENDING_STOP status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"provisioning": { +"description": "Output only. The number of instances in the managed instance group\nthat have PROVISIONING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"repairing": { +"description": "Output only. The number of instances in the managed instance group\nthat have REPAIRING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"running": { +"description": "Output only. The number of instances in the managed instance group\nthat have RUNNING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"staging": { +"description": "Output only. The number of instances in the managed instance group\nthat have STAGING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"stopped": { +"description": "Output only. The number of instances in the managed instance group\nthat have STOPPED status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"stopping": { +"description": "Output only. The number of instances in the managed instance group\nthat have STOPPING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"suspended": { +"description": "Output only. The number of instances in the managed instance group\nthat have SUSPENDED status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"suspending": { +"description": "Output only. The number of instances in the managed instance group\nthat have SUSPENDING status.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"terminated": { +"description": "Output only. The number of instances in the managed instance group\nthat have TERMINATED status.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusStateful": { +"id": "InstanceGroupManagerStatusStateful", +"properties": { +"hasStatefulConfig": { +"description": "Output only. A bit indicating whether the managed instance group\nhas stateful configuration, that is, if you have configured any items\nin a stateful policy or in per-instance configs.\nThe group might report that it has no stateful configuration even when\nthere is still some preserved state on a managed instance, for example,\nif you have deleted all PICs but not yet applied those deletions.", +"readOnly": true, +"type": "boolean" +}, +"perInstanceConfigs": { +"$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", +"description": "Output only. Status of per-instance configurations on the instances.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusStatefulPerInstanceConfigs": { +"id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", +"properties": { +"allEffective": { +"description": "Output only. A bit indicating if all of the group's per-instance configurations\n(listed in the output of a listPerInstanceConfigs API call) have\nstatus EFFECTIVE or there are no per-instance-configs.", +"readOnly": true, +"type": "boolean" +} +}, +"type": "object" +}, +"InstanceGroupManagerStatusVersionTarget": { +"id": "InstanceGroupManagerStatusVersionTarget", +"properties": { +"isReached": { +"description": "Output only. A bit indicating whether version target has been reached\nin this managed instance group, i.e. all instances are in their target\nversion. Instances' target version are specified byversion field on Instance Group Manager.", +"readOnly": true, +"type": "boolean" +} +}, +"type": "object" +}, +"InstanceGroupManagerTargetSizePolicy": { +"id": "InstanceGroupManagerTargetSizePolicy", +"properties": { +"mode": { +"description": "The mode of target size policy based on which the MIG creates its VMs\nindividually or all at once.", +"enum": [ +"BULK", +"INDIVIDUAL", +"UNSPECIFIED_MODE" +], +"enumDescriptions": [ +"The mode in which the MIG creates VMs all at once. In this mode, if the\nMIG is unable to create even one VM, the MIG waits until all VMs can be\ncreated at the same time.", +"The mode in which the MIG creates VMs individually. In this mode, if\nthe MIG is unable to create a VM, the MIG will continue to create the\nother VMs in the group. This is the default mode.", +"If mode is unspecified, MIG will behave as in the default `INDIVIDUAL`\nmode." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerUpdatePolicy": { +"id": "InstanceGroupManagerUpdatePolicy", +"properties": { +"instanceRedistributionType": { +"description": "The \ninstance redistribution policy for regional managed instance groups.\nValid values are: \n \n - PROACTIVE (default): The group attempts to maintain an\n even distribution of VM instances across zones in the region.\n - NONE: For non-autoscaled groups, proactive\n redistribution is disabled.", +"enum": [ +"NONE", +"PROACTIVE" +], +"enumDescriptions": [ +"No action is being proactively performed in order to bring this IGM\nto its target instance distribution.", +"This IGM will actively converge to its target instance distribution." +], +"type": "string" +}, +"maxSurge": { +"$ref": "FixedOrPercent", +"description": "The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be\neither a fixed number or, if the group has 10 or more instances, a\npercentage. If you set a percentage, the number of instances is rounded\nif necessary. The default value for maxSurge is a fixed\nvalue equal to the number of zones in which the managed instance group\noperates.\n\nAt least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge." +}, +"maxUnavailable": { +"$ref": "FixedOrPercent", +"description": "The maximum number of instances that can be unavailable during the update\nprocess. An instance is considered available if all of the following\nconditions are satisfied:\n\n \n \n - The instance's status is\n RUNNING. \n - If there is a health\n check on the instance group, the instance's health check status\n must be HEALTHY at least once. If there is no health check\n on the group, then the instance only needs to have a status of\n RUNNING to be considered available.\n\n\nThis value can be either a fixed number or, if the group has 10 or more\ninstances, a percentage. If you set a percentage, the number of instances\nis rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones\nin which the managed instance group operates.\n\nAt least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable." +}, +"minimalAction": { +"description": "Minimal action to be taken on an instance. Use this option to minimize\ndisruption as much as possible or to apply a more disruptive action than\nis necessary.\n \n - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,\n Compute Engine performs the necessary action to execute the update.\n - To apply a more disruptive action than is strictly necessary, set the\n minimal action to RESTART or REPLACE. For\n example, Compute Engine does not need to restart a VM to change its\n metadata. But if your application reads instance metadata only when a VM\n is restarted, you can set the minimal action to RESTART in\n order to pick up metadata changes.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +}, +"mostDisruptiveAllowedAction": { +"description": "Most disruptive action that is allowed to be taken on an instance.\nYou can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption\nas much as possible. RESTART to allow actions that can be\napplied without instance replacing or REPLACE to allow all\npossible actions. If the Updater determines that the minimal update\naction needed is more disruptive than most disruptive allowed action you\nspecify it will not perform the update at all.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +}, +"replacementMethod": { +"description": "What action should be used to replace instances.\nSee minimal_action.REPLACE", +"enum": [ +"RECREATE", +"SUBSTITUTE" +], +"enumDescriptions": [ +"Instances will be recreated (with the same name)", +"Default option: instances will be deleted and created (with a new name)" +], +"type": "string" +}, +"type": { +"description": "The type\nof update process. You can specify either PROACTIVE so\nthat the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want\nto update.", +"enum": [ +"OPPORTUNISTIC", +"PROACTIVE" +], +"enumDescriptions": [ +"MIG will apply new configurations\nto existing VMs only when you selectively target specific or all VMs to\nbe updated.", +"MIG will automatically apply new configurations\nto all or a subset of existing VMs and also to new VMs that are added\nto the group." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagerVersion": { +"id": "InstanceGroupManagerVersion", +"properties": { +"instanceTemplate": { +"description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create new instances in\nthe managed instance group until the `targetSize` for this version is\nreached. The templates for existing instances in the group do not change\nunless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,\nexisting instances are updated until the `targetSize` for this version is\nreached.", +"type": "string" +}, +"name": { +"description": "Name of the version. Unique among all versions in the scope of this\nmanaged instance group.", +"type": "string" +}, +"targetSize": { +"$ref": "FixedOrPercent", +"description": "Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created\nfrom the template will be equal to:\n \n \n - If expressed as a fixed number, the minimum of either\n targetSize.fixed or\n instanceGroupManager.targetSize is used.\n - if expressed as a percent, the targetSize\n would be (targetSize.percent/100 *\n InstanceGroupManager.targetSize) If there is a remainder, the\n number is rounded.\n \n If unset, this version will update any remaining instances not\nupdated by another version. ReadStarting\na canary update for more information." +} +}, +"type": "object" +}, +"InstanceGroupManagersAbandonInstancesRequest": { +"id": "InstanceGroupManagersAbandonInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to abandon. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersApplyUpdatesRequest": { +"description": "InstanceGroupManagers.applyUpdatesToInstances", +"id": "InstanceGroupManagersApplyUpdatesRequest", +"properties": { +"allInstances": { +"description": "Flag to update all instances instead of specified list of \"instances\".\nIf the flag is set to true then the instances may not be specified\nin the request.", +"type": "boolean" +}, +"instances": { +"description": "The list of URLs of one or more instances for which you want to apply\nupdates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +}, +"minimalAction": { +"description": "The minimal action that you want to perform on each instance during the\nupdate:\n \n \n - REPLACE: At minimum, delete the instance and create it\n again. \n - RESTART: Stop the instance and start it\n again. \n - REFRESH: Do not stop the instance and limit\n disruption as much as possible. \n - NONE: Do not\n disrupt the instance at all.\n\n\nBy default, the minimum action is NONE. If your update\nrequires a more disruptive action than you set with this flag, the\nnecessary action is performed to execute the update.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +}, +"mostDisruptiveAllowedAction": { +"description": "The most disruptive action that you want to perform on each instance during\nthe update:\n \n \n - REPLACE: Delete the instance and create it again.\n - RESTART: Stop the instance and start it again.\n - REFRESH: Do not stop the instance and limit disruption\n as much as possible. \n - NONE: Do not disrupt the\n instance at all.\n\n\nBy default, the most disruptive allowed action is REPLACE. If\nyour update requires a more disruptive action than you set with this flag,\nthe update request will fail.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagersCreateInstancesRequest": { +"description": "InstanceGroupManagers.createInstances", +"id": "InstanceGroupManagersCreateInstancesRequest", +"properties": { +"instances": { +"description": "[Required] List of specifications of per-instance configs.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersDeleteInstancesRequest": { +"id": "InstanceGroupManagersDeleteInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to delete. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].\nQueued instances do not have URL and can be deleted only by name.\nOne cannot specify both URLs and names in a single request.", +"items": { +"type": "string" +}, +"type": "array" +}, +"skipInstancesOnValidationError": { +"description": "Specifies whether the request should proceed despite the inclusion of\ninstances that are not members of the group or that are already in the\nprocess of being deleted or abandoned. If this field is set to `false` and\nsuch an instance is specified in the request, the operation fails. The\noperation always fails if the request contains a malformed instance URL or\na reference to an instance that exists in a zone or region other than the\ngroup's zone or region.", +"type": "boolean" +} +}, +"type": "object" +}, +"InstanceGroupManagersDeletePerInstanceConfigsReq": { +"description": "InstanceGroupManagers.deletePerInstanceConfigs", +"id": "InstanceGroupManagersDeletePerInstanceConfigsReq", +"properties": { +"names": { +"description": "The list of instance names for which we want to delete per-instance configs\non this managed instance group.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersListErrorsResponse": { +"id": "InstanceGroupManagersListErrorsResponse", +"properties": { +"items": { +"description": "Output only. The list of errors of the managed instance group.", +"items": { +"$ref": "InstanceManagedByIgmError" +}, +"readOnly": true, +"type": "array" +}, +"nextPageToken": { +"description": "Output only. This token allows you to get the next page of results for list requests.\nIf the number of results is larger than maxResults\n, then 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" +} +}, +"type": "object" +}, +"InstanceGroupManagersListManagedInstancesResponse": { +"id": "InstanceGroupManagersListManagedInstancesResponse", +"properties": { +"managedInstances": { +"description": "Output only. [Output Only] The list of instances in the managed instance group.", +"items": { +"$ref": "ManagedInstance" +}, +"readOnly": true, +"type": "array" +}, +"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" +} +}, +"type": "object" +}, +"InstanceGroupManagersListPerInstanceConfigsResp": { +"id": "InstanceGroupManagersListPerInstanceConfigsResp", +"properties": { +"items": { +"description": "Output only. [Output Only] The list of PerInstanceConfig.", +"items": { +"$ref": "PerInstanceConfig" +}, +"readOnly": true, +"type": "array" +}, +"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" +}, +"warning": { +"description": "Output only. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagersPatchPerInstanceConfigsReq": { +"description": "InstanceGroupManagers.patchPerInstanceConfigs", +"id": "InstanceGroupManagersPatchPerInstanceConfigsReq", +"properties": { +"perInstanceConfigs": { +"description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersRecreateInstancesRequest": { +"id": "InstanceGroupManagersRecreateInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to recreate. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersResumeInstancesRequest": { +"id": "InstanceGroupManagersResumeInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to resume. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersScopedList": { +"id": "InstanceGroupManagersScopedList", +"properties": { +"instanceGroupManagers": { +"description": "Output only. The list of managed instance groups that are contained in the specified\nproject and zone.", +"items": { +"$ref": "InstanceGroupManager" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "Output only. The warning that replaces the list of managed instance groups when the list\nis 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.", +"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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupManagersSetInstanceTemplateRequest": { +"id": "InstanceGroupManagersSetInstanceTemplateRequest", +"properties": { +"instanceTemplate": { +"description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create all new instances\nin the managed instance group. The templates for existing instances in the\ngroup do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagersSetTargetPoolsRequest": { +"id": "InstanceGroupManagersSetTargetPoolsRequest", +"properties": { +"fingerprint": { +"description": "The fingerprint of the target pools information. Use this optional\nproperty to prevent conflicts when multiple users change the target pools\nsettings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another\nconcurrent request.", +"format": "byte", +"type": "string" +}, +"targetPools": { +"description": "The list of target pool URLs that instances in this managed instance group\nbelong to. The managed instance group applies these target pools to all\nof the instances in the group. Existing instances and new instances in the\ngroup all receive these target pool settings.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersStartInstancesRequest": { +"id": "InstanceGroupManagersStartInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to start. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersStopInstancesRequest": { +"id": "InstanceGroupManagersStopInstancesRequest", +"properties": { +"forceStop": { +"description": "If this flag is set to true, the Instance Group Manager will proceed to\nstop the instances, skipping initialization on them.", +"type": "boolean" +}, +"instances": { +"description": "The URLs of one or more instances to stop. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersSuspendInstancesRequest": { +"id": "InstanceGroupManagersSuspendInstancesRequest", +"properties": { +"forceSuspend": { +"description": "If this flag is set to true, the Instance Group Manager will proceed to\nsuspend the instances, skipping initialization on them.", +"type": "boolean" +}, +"instances": { +"description": "The URLs of one or more instances to suspend. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupManagersUpdatePerInstanceConfigsReq": { +"description": "InstanceGroupManagers.updatePerInstanceConfigs", +"id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", +"properties": { +"perInstanceConfigs": { +"description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupsAddInstancesRequest": { +"id": "InstanceGroupsAddInstancesRequest", +"properties": { +"instances": { +"description": "The list of instances to add to the instance group.", +"items": { +"$ref": "InstanceReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupsListInstances": { +"id": "InstanceGroupsListInstances", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceWithNamedPorts resources.", +"items": { +"$ref": "InstanceWithNamedPorts" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceGroupsListInstances", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances\nin the specified instance group.", +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupsListInstancesRequest": { +"id": "InstanceGroupsListInstancesRequest", +"properties": { +"instanceState": { +"description": "A filter for the state of the instances in the instance group. Valid\noptions are ALL or RUNNING. If you do not specify\nthis parameter the list includes all instances regardless of their state.", +"enum": [ +"ALL", +"RUNNING" +], +"enumDescriptions": [ +"Includes all instances in the generated list regardless of their state.", +"Includes instances in the generated list only if they have a RUNNING\nstate." +], +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupsRemoveInstancesRequest": { +"id": "InstanceGroupsRemoveInstancesRequest", +"properties": { +"instances": { +"description": "The list of instances to remove from the instance group.", +"items": { +"$ref": "InstanceReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceGroupsScopedList": { +"id": "InstanceGroupsScopedList", +"properties": { +"instanceGroups": { +"description": "Output only. [Output Only] The list ofinstance\ngroups that are contained in this scope.", +"items": { +"$ref": "InstanceGroup" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "Output only. [Output Only] An informational warning that replaces the list of\ninstance groups 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.", +"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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"InstanceGroupsSetNamedPortsRequest": { +"id": "InstanceGroupsSetNamedPortsRequest", +"properties": { +"fingerprint": { +"description": "The fingerprint of the named ports information for this instance group.\nUse this optional property to prevent conflicts when multiple users change\nthe named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another concurrent request.\nA request with an incorrect fingerprint will fail with error412 conditionNotMet.", +"format": "byte", +"type": "string" +}, +"namedPorts": { +"description": "The list of named ports to set for this instance group.", +"items": { +"$ref": "NamedPort" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstanceList": { +"description": "Contains a list of instances.", +"id": "InstanceList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Instance resources.", +"items": { +"$ref": "Instance" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceList", +"description": "Output only. [Output Only] Type of resource. Always compute#instanceList\nfor lists of Instance resources.", +"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.", +"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" +}, +"InstanceListReferrers": { +"description": "Contains a list of instance referrers.", +"id": "InstanceListReferrers", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Reference resources.", +"items": { +"$ref": "Reference" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceListReferrers", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers.", +"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.", +"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" +}, +"InstanceManagedByIgmError": { +"id": "InstanceManagedByIgmError", +"properties": { +"error": { +"$ref": "InstanceManagedByIgmErrorManagedInstanceError", +"description": "Output only. Contents of the error.", +"readOnly": true +}, +"instanceActionDetails": { +"$ref": "InstanceManagedByIgmErrorInstanceActionDetails", +"description": "Output only. Details of the instance action that triggered this error.\nMay be null, if the error was not caused by an action on an instance.\nThis field is optional.", +"readOnly": true +}, +"timestamp": { +"description": "Output only. The time that this error occurred. This value is in RFC3339 text format.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceManagedByIgmErrorInstanceActionDetails": { +"id": "InstanceManagedByIgmErrorInstanceActionDetails", +"properties": { +"action": { +"description": "Output only. Action that managed instance group was executing on the instance when the\nerror occurred. Possible values:", +"enum": [ +"ABANDONING", +"CREATING", +"CREATING_WITHOUT_RETRIES", +"DELETING", +"NONE", +"RECREATING", +"REFRESHING", +"RESTARTING", +"RESUMING", +"STARTING", +"STOPPING", +"SUSPENDING", +"VERIFYING" +], +"enumDescriptions": [ +"The managed instance group is abandoning this instance. The instance\nwill be removed from the instance group and from any target pools that\nare associated with this group.", +"The managed instance group is creating this instance. If the group\nfails to create this instance, it will try again until it is\nsuccessful.", +"The managed instance group is attempting to create this instance\nonly once. If the group fails to create this instance, it does\nnot try again and the group's targetSize value is\ndecreased.", +"The managed instance group is permanently deleting this instance.", +"The managed instance group has not scheduled any actions for this\ninstance.", +"The managed instance group is recreating this instance.", +"The managed instance group is applying configuration changes to the\ninstance without stopping it. For example, the group can update the\ntarget pool list for an instance without stopping that instance.", +"The managed instance group is restarting this instance.", +"The managed instance group is resuming this instance.", +"The managed instance group is starting this instance.", +"The managed instance group is stopping this instance.", +"The managed instance group is suspending this instance.", +"The managed instance group is verifying this already created instance.\nVerification happens every time the instance is (re)created or restarted\nand consists of:\n 1. Waiting until health check specified as part of this managed instance\n group's autohealing policy reports HEALTHY.\n Note: Applies only if autohealing policy has a health check specified\n 2. Waiting for addition verification steps performed as post-instance\n creation (subject to future extensions)." +], +"readOnly": true, +"type": "string" +}, +"instance": { +"description": "Output only. The URL of the instance. The URL can be set even if the instance has not\nyet been created.", +"readOnly": true, +"type": "string" +}, +"version": { +"$ref": "ManagedInstanceVersion", +"description": "Output only. Version this instance was created from, or was being\ncreated from, but the creation failed. Corresponds to one of the versions\nthat were set on the Instance Group Manager resource at the time this\ninstance was being created.", +"readOnly": true +} +}, +"type": "object" +}, +"InstanceManagedByIgmErrorManagedInstanceError": { +"id": "InstanceManagedByIgmErrorManagedInstanceError", +"properties": { +"code": { +"description": "Output only. Error code.", +"readOnly": true, +"type": "string" +}, +"message": { +"description": "Output only. Error message.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceMoveRequest": { +"id": "InstanceMoveRequest", +"properties": { +"destinationZone": { +"description": "The URL of the destination zone to move the instance. This can be a full or\npartial URL. For example, the following are all valid URLs to a zone:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone", +"type": "string" +}, +"targetInstance": { +"description": "The URL of the target instance to move. This can be a full or partial URL.\nFor example, the following are all valid URLs to an instance:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance \n - zones/zone/instances/instance", +"type": "string" +} +}, +"type": "object" +}, +"InstanceParams": { +"description": "Additional instance params.", +"id": "InstanceParams", +"properties": { +"requestValidForDuration": { +"$ref": "Duration", +"description": "Relative deadline for waiting for capacity. Relevant only for\nInstances.Insert API." +}, +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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" +}, +"InstanceProperties": { +"id": "InstanceProperties", +"properties": { +"advancedMachineFeatures": { +"$ref": "AdvancedMachineFeatures", +"description": "Controls for advanced machine-related behavior features.\nNote that for MachineImage, this is not supported yet." +}, +"canIpForward": { +"description": "Enables instances created based on these properties to send packets with\nsource IP addresses other than their own and receive packets with\ndestination IP addresses other than their own. If these instances will be\nused as an IP gateway or it will be set as the next-hop in a Route\nresource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding\ndocumentation for more information.", +"type": "boolean" +}, +"confidentialInstanceConfig": { +"$ref": "ConfidentialInstanceConfig", +"description": "Specifies the Confidential Instance options.\nNote that for MachineImage, this is not supported yet." +}, +"description": { +"description": "An optional text description for the instances that are created from these\nproperties.", +"type": "string" +}, +"disks": { +"description": "An array of disks that are associated with the instances that are created\nfrom these properties.", +"items": { +"$ref": "AttachedDisk" +}, +"type": "array" +}, +"guestAccelerators": { +"description": "A list of guest accelerator cards' type and count to use for instances\ncreated from these properties.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"keyRevocationActionType": { +"description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", +"enum": [ +"KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", +"NONE", +"STOP" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Indicates user chose no operation.", +"Indicates user chose to opt for VM shutdown on key revocation." +], +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to instances that are created from these properties.", +"type": "object" +}, +"localSsdEncryptionMode": { +"description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", +"enum": [ +"EPHEMERAL_KEY_ENCRYPTION", +"LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", +"STANDARD_ENCRYPTION" +], +"enumDescriptions": [ +"The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", +"The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", +"The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." +], +"type": "string" +}, +"machineType": { +"annotations": { +"required": [ +"compute.instanceTemplates.insert" +] +}, +"description": "The machine type to use for instances that are created from these\nproperties.\nThis field only accepts a machine type name, for example `n2-standard-4`.\nIf you use the machine type full or partial URL, for example\n`projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,\nthe request will result in an `INTERNAL_ERROR`.", +"type": "string" +}, +"metadata": { +"$ref": "Metadata", +"description": "The metadata key/value pairs to assign to instances that are created from\nthese properties. These pairs can consist of custom metadata or predefined\nkeys. SeeProject and\ninstance metadata for more information." +}, +"minCpuPlatform": { +"description": "Minimum cpu/platform to be used by instances. The instance may be\nscheduled on the specified or newer cpu/platform. Applicable values are the\nfriendly names of CPU platforms, such asminCpuPlatform: \"Intel Haswell\" orminCpuPlatform: \"Intel Sandy Bridge\". For more\ninformation, read Specifying a\nMinimum CPU Platform.", +"type": "string" +}, +"networkInterfaces": { +"description": "An array of network access configurations for this interface.", +"items": { +"$ref": "NetworkInterface" +}, +"type": "array" +}, +"networkPerformanceConfig": { +"$ref": "NetworkPerformanceConfig", +"description": "Note that for MachineImage, this is not supported yet." +}, +"privateIpv6GoogleAccess": { +"description": "The private IPv6 google access type for VMs.\nIf not specified, use INHERIT_FROM_SUBNETWORK as default.\nNote that for MachineImage, this is not supported yet.", +"enum": [ +"ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", +"ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", +"INHERIT_FROM_SUBNETWORK" +], +"enumDescriptions": [ +"Bidirectional private IPv6 access to/from Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", +"Outbound private IPv6 access from VMs in this subnet to Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", +"Each network interface inherits PrivateIpv6GoogleAccess from its\nsubnetwork." +], +"type": "string" +}, +"reservationAffinity": { +"$ref": "ReservationAffinity", +"description": "Specifies the reservations that instances can consume from.\nNote that for MachineImage, this is not supported yet." +}, +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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" +}, +"resourcePolicies": { +"description": "Resource policies (names, not URLs) applied to instances created from\nthese properties.\nNote that for MachineImage, this is not supported yet.", +"items": { +"type": "string" +}, +"type": "array" +}, +"scheduling": { +"$ref": "Scheduling", +"description": "Specifies the scheduling options for the instances that are created from\nthese properties." +}, +"serviceAccounts": { +"description": "A list of service accounts with specified scopes. Access tokens for these\nservice accounts are available to the instances that are created from\nthese properties. Use metadata queries to obtain the access tokens for\nthese instances.", +"items": { +"$ref": "ServiceAccount" +}, +"type": "array" +}, +"shieldedInstanceConfig": { +"$ref": "ShieldedInstanceConfig", +"description": "Note that for MachineImage, this is not supported yet." +}, +"tags": { +"$ref": "Tags", +"description": "A list of tags to apply to the instances that are created from these\nproperties. The tags identify valid sources or targets for network\nfirewalls. The setTags method can modify this list of tags. Each tag within\nthe list must comply with RFC1035." +}, +"workloadIdentityConfig": { +"$ref": "WorkloadIdentityConfig" +} +}, +"type": "object" +}, +"InstancePropertiesPatch": { +"description": "Represents the change that you want to make to the instance properties.", +"id": "InstancePropertiesPatch", +"properties": { +"exposeHostTopology": { +"description": "This optional flag exposes the hashed physical host ID.", +"type": "boolean" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The label key-value pairs that you want to patch onto the instance.", +"type": "object" +}, +"metadata": { +"additionalProperties": { +"type": "string" +}, +"description": "The metadata key-value pairs that you want to patch onto the instance. For\nmore information, see Project and\ninstance metadata.", +"type": "object" +} +}, +"type": "object" +}, +"InstanceReference": { +"id": "InstanceReference", +"properties": { +"instance": { +"description": "The URL for a specific instance.\n@required compute.instancegroups.addInstances/removeInstances", +"type": "string" +} +}, +"type": "object" +}, +"InstanceSettings": { +"description": "Represents a Instance Settings resource. You can use instance settings to\nconfigure default settings for Compute Engine VM instances. For example, you\ncan use it to configure default machine type of Compute Engine VM instances.", +"id": "InstanceSettings", +"properties": { +"fingerprint": { +"description": "Specifies a fingerprint for instance settings, which is essentially a hash\nof the instance settings resource's contents and used for optimistic\nlocking. The fingerprint is initially generated by Compute Engine and\nchanges after every request to modify or update the instance settings\nresource. You must always provide an up-to-date fingerprint hash in order\nto update or change the resource, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve the resource.", +"format": "byte", +"type": "string" +}, +"kind": { +"default": "compute#instanceSettings", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings.", +"readOnly": true, +"type": "string" +}, +"metadata": { +"$ref": "InstanceSettingsMetadata", +"description": "The metadata key/value pairs assigned to all the instances in the\ncorresponding scope." +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the resource resides\nYou must specify this field as part of the HTTP request URL. It is not\nsettable as a field in the request body.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceSettingsMetadata": { +"id": "InstanceSettingsMetadata", +"properties": { +"items": { +"additionalProperties": { +"type": "string" +}, +"description": "A metadata key/value items map.\nThe total size of all keys and values must be less than 512KB.", +"type": "object" +}, +"kind": { +"default": "compute#metadata", +"description": "Output only. [Output Only] Type of the resource. Always compute#metadata\nfor metadata.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstanceTemplate": { +"description": "Represents an Instance Template resource.\n\nGoogle Compute Engine has two Instance Template resources:\n\n* [Global](/compute/docs/reference/rest/v1/instanceTemplates)\n* [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)\n\nYou can reuse a global instance template in\ndifferent regions whereas you can use a regional instance template in a\nspecified region only. If you want to reduce cross-region dependency or\nachieve data residency, use a regional instance template.\n\nTo create VMs, managed instance groups, and reservations, you can use either\nglobal or regional instance templates.\n\nFor more information, readInstance Templates.", +"id": "InstanceTemplate", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] The creation timestamp for this instance template 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" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this instance template. The server\ndefines this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#instanceTemplate", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instanceTemplates.insert" +] +}, +"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 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" +}, +"properties": { +"$ref": "InstanceProperties", +"description": "The instance properties for this instance template." +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the instance template resides. Only\napplicable for regional resources.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] The URL for this instance template. The server defines this\nURL.", +"readOnly": true, +"type": "string" +}, +"sourceInstance": { +"description": "The source instance used to create the template. 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/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance", +"type": "string" +}, +"sourceInstanceParams": { +"$ref": "SourceInstanceParams", +"description": "The source instance params to use to create this instance template." +} +}, +"type": "object" +}, +"InstanceTemplateAggregatedList": { +"description": "Contains a list of InstanceTemplatesScopedList.", +"id": "InstanceTemplateAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InstanceTemplatesScopedList", +"description": "The name of the scope that contains this set of instance templates." +}, +"description": "A list of InstanceTemplatesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#instanceTemplateAggregatedList", +"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.", +"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" +}, +"InstanceTemplateList": { +"description": "A list of instance templates.", +"id": "InstanceTemplateList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InstanceTemplate resources.", +"items": { +"$ref": "InstanceTemplate" +}, +"type": "array" +}, +"kind": { +"default": "compute#instanceTemplateList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template\nlists.", +"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.", +"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" +}, +"InstanceTemplatesScopedList": { +"id": "InstanceTemplatesScopedList", +"properties": { +"instanceTemplates": { +"description": "[Output Only] A list of instance templates that are contained within\nthe specified project and zone.", +"items": { +"$ref": "InstanceTemplate" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that replaces the list of instance\ntemplates 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.", +"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" +}, +"InstanceWithNamedPorts": { +"id": "InstanceWithNamedPorts", +"properties": { +"instance": { +"description": "Output only. [Output Only] The URL of the instance.", +"readOnly": true, +"type": "string" +}, +"namedPorts": { +"description": "Output only. [Output Only] The named ports that belong to this instance group.", +"items": { +"$ref": "NamedPort" +}, +"readOnly": true, +"type": "array" +}, +"status": { +"description": "Output only. [Output Only] The status of the instance.", +"enum": [ +"DEPROVISIONING", +"PENDING", +"PENDING_STOP", +"PROVISIONING", +"REPAIRING", +"RUNNING", +"STAGING", +"STOPPED", +"STOPPING", +"SUSPENDED", +"SUSPENDING", +"TERMINATED" +], +"enumDescriptions": [ +"The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", +"For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", +"The instance is gracefully shutting down.", +"Resources are being allocated for the instance.", +"The instance is in repair.", +"The instance is running.", +"All required resources have been allocated and the instance\nis being started.", +"The instance has stopped successfully.", +"The instance is currently stopping (either being deleted or killed).", +"The instance has suspended.", +"The instance is suspending.", +"The instance has stopped (either by explicit action or underlying\nfailure)." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstancesAddResourcePoliciesRequest": { +"id": "InstancesAddResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Resource policies to be added to this instance.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesBulkInsertOperationMetadata": { +"id": "InstancesBulkInsertOperationMetadata", +"properties": { +"perLocationStatus": { +"additionalProperties": { +"$ref": "BulkInsertOperationStatus" +}, +"description": "Status information per location (location name is key).\nExample key: zones/us-central1-a", +"type": "object" +} +}, +"type": "object" +}, +"InstancesGetEffectiveFirewallsResponse": { +"id": "InstancesGetEffectiveFirewallsResponse", +"properties": { +"firewallPolicys": { +"description": "[Output Only] Effective firewalls from firewall policies.", +"items": { +"$ref": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" +}, +"type": "array" +}, +"firewalls": { +"description": "Effective firewalls on the instance.", +"items": { +"$ref": "Firewall" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { +"id": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", +"properties": { +"displayName": { +"deprecated": true, +"description": "Output only. [Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"packetMirroringRules": { +"description": "Output only. [Output Only] The packet mirroring rules that apply to the instance.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"readOnly": true, +"type": "array" +}, +"priority": { +"description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"rules": { +"description": "[Output Only] The rules that apply to the instance. Only rules that\ntarget the specific VM instance are returned if target service accounts\nor target secure tags are specified in the rules.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"type": "array" +}, +"shortName": { +"description": "Output only. [Output Only] The short name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"type": { +"description": "Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,\nNETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", +"enum": [ +"HIERARCHY", +"NETWORK", +"NETWORK_REGIONAL", +"SYSTEM_GLOBAL", +"SYSTEM_REGIONAL", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstancesRemoveResourcePoliciesRequest": { +"id": "InstancesRemoveResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Resource policies to be removed from this instance.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesReportHostAsFaultyRequest": { +"id": "InstancesReportHostAsFaultyRequest", +"properties": { +"disruptionSchedule": { +"description": "The disruption schedule for the VM. Required field, only allows IMMEDIATE.", +"enum": [ +"DISRUPTION_SCHEDULE_UNSPECIFIED", +"FUTURE", +"IMMEDIATE" +], +"enumDescriptions": [ +"Not used. Required as per aip/126.", +"Delay disruption for caller control. Will be default soon.", +"Default value. Disrupt the VM immediately." +], +"type": "string" +}, +"faultReasons": { +"items": { +"$ref": "InstancesReportHostAsFaultyRequestFaultReason" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesReportHostAsFaultyRequestFaultReason": { +"id": "InstancesReportHostAsFaultyRequestFaultReason", +"properties": { +"behavior": { +"enum": [ +"BEHAVIOR_UNSPECIFIED", +"CHIP_ERROR", +"PERFORMANCE", +"SILENT_DATA_CORRUPTION", +"UNRECOVERABLE_GPU_ERROR" +], +"enumDescriptions": [ +"Public reportable behaviors", +"Any GPU or TPU errors or faults where the accelerator becomes unusable", +"", +"", +"Unrecoverable GPU error identified by an XID" +], +"type": "string" +}, +"description": { +"type": "string" +} +}, +"type": "object" +}, +"InstancesScopedList": { +"id": "InstancesScopedList", +"properties": { +"instances": { +"description": "[Output Only] A list of instances contained in this scope.", +"items": { +"$ref": "Instance" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of instances\nwhen 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.", +"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" +}, +"InstancesSetLabelsRequest": { +"id": "InstancesSetLabelsRequest", +"properties": { +"labelFingerprint": { +"description": "Fingerprint of the previous set of labels for this resource,\nused to prevent conflicts. Provide the latest fingerprint value when making\na request to add or change labels.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"type": "object" +} +}, +"type": "object" +}, +"InstancesSetMachineResourcesRequest": { +"id": "InstancesSetMachineResourcesRequest", +"properties": { +"guestAccelerators": { +"description": "A list of the type and count of accelerator cards attached to the instance.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesSetMachineTypeRequest": { +"id": "InstancesSetMachineTypeRequest", +"properties": { +"machineType": { +"description": "Full or partial URL of the machine type resource. See Machine Types for a full list of\nmachine types. For example:zones/us-central1-f/machineTypes/n1-standard-1", +"type": "string" +} +}, +"type": "object" +}, +"InstancesSetMinCpuPlatformRequest": { +"id": "InstancesSetMinCpuPlatformRequest", +"properties": { +"minCpuPlatform": { +"description": "Minimum cpu/platform this instance should be started at.", +"type": "string" +} +}, +"type": "object" +}, +"InstancesSetNameRequest": { +"id": "InstancesSetNameRequest", +"properties": { +"currentName": { +"description": "The current name of this resource, used to prevent conflicts. Provide the\nlatest name when making a request to change name.", +"type": "string" +}, +"name": { +"description": "The name to be applied to the instance. Needs to be RFC 1035 compliant.", +"type": "string" +} +}, +"type": "object" +}, +"InstancesSetSecurityPolicyRequest": { +"id": "InstancesSetSecurityPolicyRequest", +"properties": { +"networkInterfaces": { +"description": "The network interfaces that the security policy will be applied to. Network\ninterfaces use the nicN naming format. You can only set a\nsecurity policy for network interfaces with an access config.", +"items": { +"type": "string" +}, +"type": "array" +}, +"securityPolicy": { +"description": "A full or partial URL to a security policy to add to this instance.\nIf this field is set to an empty string it will remove the associated\nsecurity policy.", +"type": "string" +} +}, +"type": "object" +}, +"InstancesSetServiceAccountRequest": { +"id": "InstancesSetServiceAccountRequest", +"properties": { +"email": { +"description": "Email address of the service account.", +"type": "string" +}, +"scopes": { +"description": "The list of scopes to be made available for this service account.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstancesStartWithEncryptionKeyRequest": { +"id": "InstancesStartWithEncryptionKeyRequest", +"properties": { +"disks": { +"description": "Array of disks associated with this instance that are protected with acustomer-supplied\nencryption key.\n\nIn order to start the instance, the disk url and its corresponding key must\nbe provided.\n\nIf the disk is not protected with a customer-supplied encryption key it\nshould not be specified.", +"items": { +"$ref": "CustomerEncryptionKeyProtectedDisk" +}, +"type": "array" +} +}, +"type": "object" +}, +"InstantSnapshot": { +"description": "Represents a InstantSnapshot resource.\n\nYou can use instant snapshots to create disk rollback points quickly..", +"id": "InstantSnapshot", +"properties": { +"architecture": { +"description": "Output only. [Output Only] The architecture of the instant snapshot. Valid values are\nARM64 or X86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"readOnly": true, +"type": "string" +}, +"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" +}, +"diskSizeGb": { +"description": "Output only. [Output Only] Size of the source disk, specified in GB.", +"format": "int64", +"readOnly": true, +"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#instantSnapshot", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this InstantSnapshot, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a InstantSnapshot.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this InstantSnapshot. These can be later modified by\nthe setLabels method.\nLabel values may be empty.", +"type": "object" +}, +"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.\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" +}, +"params": { +"$ref": "InstantSnapshotParams", +"description": "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 instant snapshot resides.\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" +}, +"resourceStatus": { +"$ref": "InstantSnapshotResourceStatus", +"description": "Output only. [Output Only] Status information for the instant snapshot resource.", +"readOnly": true +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"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" +}, +"sourceDisk": { +"description": "URL of the source disk used to create this instant snapshot.\nNote that the source disk must be in the same zone/region as the\ninstant snapshot to be created. This can be a full or valid partial URL.\nFor example, the following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", +"type": "string" +}, +"sourceDiskId": { +"description": "Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.\nThis value may be used to determine whether the InstantSnapshot\nwas taken from the current or a previous instance of a given disk name.", +"readOnly": true, +"type": "string" +}, +"sourceInstantSnapshotGroup": { +"description": "Output only. [Output Only] URL of the source instant snapshot this instant snapshot is\npart of. Note that the source instant snapshot group must be in the same\nzone/region as the instant snapshot to be created. This can be a full or\nvalid partial URL.", +"readOnly": true, +"type": "string" +}, +"sourceInstantSnapshotGroupId": { +"description": "Output only. [Output Only] The ID value of the source instant snapshot group this\nInstantSnapshot is part of. This value may be used to determine whether the\nInstantSnapshot was created as part of an InstantSnapshotGroup creation.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY", +"UNAVAILABLE" +], +"enumDescriptions": [ +"InstantSnapshot creation is in progress.", +"InstantSnapshot is currently being deleted.", +"InstantSnapshot creation failed.", +"InstantSnapshot has been created successfully.", +"InstantSnapshot is currently unavailable and cannot be used for\nDisk restoration" +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the instant snapshot resides.\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" +} +}, +"type": "object" +}, +"InstantSnapshotAggregatedList": { +"id": "InstantSnapshotAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InstantSnapshotsScopedList", +"description": "[Output Only] Name of the scope containing this set of instantSnapshots." +}, +"description": "A list of InstantSnapshotsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#instantSnapshotAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of\ninstantSnapshots.", +"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" +}, +"InstantSnapshotGroup": { +"description": "Represents an InstantSnapshotGroup resource.\n\nAn instant snapshot group is a set of instant snapshots that represents a\npoint in time state of a consistency group.", +"id": "InstantSnapshotGroup", +"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#instantSnapshotGroup", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the instant snapshot group resides.\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" +}, +"resourceStatus": { +"$ref": "InstantSnapshotGroupResourceStatus", +"readOnly": true +}, +"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" +}, +"sourceConsistencyGroup": { +"type": "string" +}, +"status": { +"description": "Output only. [Output Only]", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"INVALID", +"READY", +"UNKNOWN" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the instant snapshot group resides.\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" +} +}, +"type": "object" +}, +"InstantSnapshotGroupParameters": { +"id": "InstantSnapshotGroupParameters", +"properties": { +"sourceInstantSnapshotGroup": { +"description": "The source instant snapshot group used to create disks. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup\n - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup\n - zones/zone/instantSnapshotGroups/instantSnapshotGroup", +"type": "string" +} +}, +"type": "object" +}, +"InstantSnapshotGroupResourceStatus": { +"id": "InstantSnapshotGroupResourceStatus", +"properties": { +"consistencyMembershipResolutionTime": { +"description": "Output only. [Output Only]", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"sourceInfo": { +"$ref": "InstantSnapshotGroupSourceInfo", +"description": "Output only. [Output Only]", +"readOnly": true +} +}, +"type": "object" +}, +"InstantSnapshotGroupSourceInfo": { +"id": "InstantSnapshotGroupSourceInfo", +"properties": { +"consistencyGroup": { +"readOnly": true, +"type": "string" +}, +"consistencyGroupId": { +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InstantSnapshotList": { +"description": "Contains a list of InstantSnapshot resources.", +"id": "InstantSnapshotList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InstantSnapshot resources.", +"items": { +"$ref": "InstantSnapshot" +}, +"type": "array" +}, +"kind": { +"default": "compute#instantSnapshotList", +"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.", +"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" +}, +"InstantSnapshotParams": { +"description": "Additional instant snapshot params.", +"id": "InstantSnapshotParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the instant snapshot. 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" +}, +"InstantSnapshotResourceStatus": { +"id": "InstantSnapshotResourceStatus", +"properties": { +"storageSizeBytes": { +"description": "[Output Only] The storage size of this instant snapshot.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"InstantSnapshotsScopedList": { +"id": "InstantSnapshotsScopedList", +"properties": { +"instantSnapshots": { +"description": "[Output Only] A list of instantSnapshots contained in this scope.", +"items": { +"$ref": "InstantSnapshot" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of\ninstantSnapshots 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.", +"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" +}, +"Int64RangeMatch": { +"description": "HttpRouteRuleMatch criteria for field values that must stay\nwithin the specified integer range.", +"id": "Int64RangeMatch", +"properties": { +"rangeEnd": { +"description": "The end of the range (exclusive) in signed long integer format.", +"format": "int64", +"type": "string" +}, +"rangeStart": { +"description": "The start of the range (inclusive) in signed long integer format.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"Interconnect": { +"description": "Represents an Interconnect resource.\n\nAn Interconnect resource is a dedicated connection between the Google\nCloud network and your on-premises network. For more information, read the\nDedicated Interconnect Overview.", +"id": "Interconnect", +"properties": { +"aaiEnabled": { +"description": "Enable or disable the application awareness feature on this Cloud\nInterconnect.", +"type": "boolean" +}, +"adminEnabled": { +"description": "Administrative status of the interconnect. When this is set to true, the\nInterconnect is functional and can carry traffic.\nWhen set to false, no packets can be carried over the interconnect and\nno BGP routes are exchanged over it. By default, the status is set to true.", +"type": "boolean" +}, +"applicationAwareInterconnect": { +"$ref": "InterconnectApplicationAwareInterconnect", +"description": "Configuration information for application awareness on this Cloud\nInterconnect." +}, +"availableFeatures": { +"description": "[Output only] List of features available for this Interconnect connection,\nwhich can take one of the following values:\n \n - IF_MACSEC: If present, then the Interconnect connection is\n provisioned on MACsec capable hardware ports. If not present, then the\n Interconnect connection is provisioned on non-MACsec capable ports. Any\n attempt to enable MACsec will fail.\n - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is\n provisioned exclusively for Cross-Site Networking. Any attempt to configure\n VLAN attachments will fail. If not present, then the Interconnect\n connection is not provisioned for Cross-Site Networking. Any attempt to use\n it for Cross-Site Networking will fail.", +"items": { +"enum": [ +"IF_CROSS_SITE_NETWORK", +"IF_L2_FORWARDING", +"IF_MACSEC" +], +"enumDescriptions": [ +"Cross-Site Networking", +"L2 Interconnect Attachment Forwarding", +"Media Access Control security (MACsec)" +], +"type": "string" +}, +"type": "array" +}, +"circuitInfos": { +"description": "Output only. [Output Only] A list of CircuitInfo objects, that describe the individual\ncircuits in this LAG.", +"items": { +"$ref": "InterconnectCircuitInfo" +}, +"readOnly": true, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"customerName": { +"description": "Customer name, to put in the Letter of Authorization as the party\nauthorized to request a crossconnect.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"effectiveLocation": { +"description": "Output only. URL of the InterconnectLocation object that represents where\nthis connection is to be provisioned. By default it will be the same as the\nlocation field.", +"readOnly": true, +"type": "string" +}, +"expectedOutages": { +"description": "Output only. [Output Only] A list of outages expected for this Interconnect.", +"items": { +"$ref": "InterconnectOutageNotification" +}, +"readOnly": true, +"type": "array" +}, +"googleIpAddress": { +"description": "Output only. [Output Only] IP address configured on the Google side of the Interconnect\nlink. This can be used only for ping tests.", +"readOnly": true, +"type": "string" +}, +"googleReferenceId": { +"description": "Output only. [Output Only] Google reference ID to be used when raising support tickets\nwith Google or otherwise to debug backend connectivity issues.", +"readOnly": true, +"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" +}, +"interconnectAttachments": { +"description": "Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured\nto use this Interconnect.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"interconnectGroups": { +"description": "Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.\nOrder is arbitrary and items are unique.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"interconnectType": { +"description": "Type of interconnect, which can take one of the following values:\n \n - PARTNER: A partner-managed interconnection shared between customers\n though a partner.\n - DEDICATED: A dedicated physical interconnection with the\n customer.\n\n\nNote that a value IT_PRIVATE has been deprecated in favor of DEDICATED.", +"enum": [ +"DEDICATED", +"IT_PRIVATE", +"PARTNER" +], +"enumDescriptions": [ +"A dedicated physical interconnection with the customer.", +"[Deprecated] A private, physical interconnection with the customer.", +"A partner-managed interconnection shared between customers via partner." +], +"type": "string" +}, +"kind": { +"default": "compute#interconnect", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this Interconnect, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an Interconnect.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"linkType": { +"description": "Type of link requested, which can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics\n - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.\n - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.\n\n\n Note that this field indicates the speed of each of\nthe links in the bundle, not the speed of the entire bundle.", +"enum": [ +"LINK_TYPE_ETHERNET_100G_LR", +"LINK_TYPE_ETHERNET_10G_LR", +"LINK_TYPE_ETHERNET_400G_LR4" +], +"enumDescriptions": [ +"100G Ethernet, LR Optics.", +"10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", +"400G Ethernet, LR4 Optics." +], +"type": "string" +}, +"location": { +"description": "URL of the InterconnectLocation object that represents where this\nconnection is to be provisioned.", +"type": "string" +}, +"macsec": { +"$ref": "InterconnectMacsec", +"description": "Configuration that enables Media Access Control security (MACsec) on the\nCloud Interconnect connection between Google and your on-premises router." +}, +"macsecEnabled": { +"description": "Enable or disable MACsec on this Interconnect connection. MACsec enablement\nfails if the MACsec object is not specified.", +"type": "boolean" +}, +"name": { +"annotations": { +"required": [ +"compute.interconnects.insert" +] +}, +"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 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" +}, +"nocContactEmail": { +"description": "Email address to contact the customer NOC for operations and maintenance\nnotifications regarding this Interconnect. If specified, this will be used\nfor notifications in addition to all other forms described, such as\nCloud Monitoring logs alerting and Cloud Notifications. This field is\nrequired for users who sign up for Cloud Interconnect using\nworkforce identity federation.", +"type": "string" +}, +"operationalStatus": { +"description": "Output only. [Output Only] The current status of this Interconnect's functionality,\nwhich can take one of the following values:\n \n - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to\n use. Attachments may be provisioned on this Interconnect.\n\n- OS_UNPROVISIONED: An Interconnect that has not completed turnup. No\nattachments may be provisioned on this Interconnect.\n- OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal\nmaintenance. No attachments may be provisioned or updated on this\nInterconnect.", +"enum": [ +"OS_ACTIVE", +"OS_UNPROVISIONED" +], +"enumDescriptions": [ +"The interconnect is valid, turned up, and ready to use. Attachments may\nbe provisioned on this interconnect.", +"The interconnect has not completed turnup. No attachments may be\nprovisioned on this interconnect." +], +"readOnly": true, +"type": "string" +}, +"params": { +"$ref": "InterconnectParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"peerIpAddress": { +"description": "Output only. [Output Only] IP address configured on the customer side of the\nInterconnect link. The customer should configure this IP address during\nturnup when prompted by Google NOC. This can be used only for ping tests.", +"readOnly": true, +"type": "string" +}, +"provisionedLinkCount": { +"description": "Output only. [Output Only] Number of links actually provisioned in this interconnect.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"remoteLocation": { +"description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies the\nlocation outside of Google's network that the interconnect is connected to.", +"type": "string" +}, +"requestedFeatures": { +"description": "Optional. This parameter can be provided only with Interconnect INSERT. It\nisn't valid for Interconnect PATCH. List of features requested for this\nInterconnect connection, which can take one of the following values:\n \n - IF_MACSEC: If specified, then the connection is created on MACsec\n capable hardware ports. If not specified, non-MACsec capable ports will\n also be considered.\n - IF_CROSS_SITE_NETWORK: If specified, then the connection is created\n exclusively for Cross-Site Networking. The connection can not be used for\n Cross-Site Networking unless this feature is specified.", +"items": { +"enum": [ +"IF_CROSS_SITE_NETWORK", +"IF_L2_FORWARDING", +"IF_MACSEC" +], +"enumDescriptions": [ +"Cross-Site Networking", +"L2 Interconnect Attachment Forwarding", +"Media Access Control security (MACsec)" +], +"type": "string" +}, +"type": "array" +}, +"requestedLinkCount": { +"description": "Target number of physical links in the link bundle, as requested by the\ncustomer.", +"format": "int32", +"type": "integer" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] The current state of Interconnect functionality, which can\ntake one of the following values:\n \n - ACTIVE: The Interconnect is valid, turned up and ready to use.\n Attachments may be provisioned on this Interconnect.\n - UNPROVISIONED: The Interconnect has not completed turnup. No\n attachments may be provisioned on this Interconnect.\n - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.\n No attachments may be provisioned or updated on this\n Interconnect.", +"enum": [ +"ACTIVE", +"UNPROVISIONED" +], +"enumDescriptions": [ +"The interconnect is valid, turned up, and ready to use. Attachments may\nbe provisioned on this interconnect.", +"The interconnect has not completed turnup. No attachments may be\nprovisioned on this interconnect." +], +"readOnly": true, +"type": "string" +}, +"subzone": { +"description": "To be deprecated.", +"enum": [ +"SUBZONE_A", +"SUBZONE_B" +], +"enumDescriptions": [ +"Subzone A.", +"Subzone B." +], +"type": "string" +}, +"wireGroups": { +"description": "Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups\nconfigured to use this Interconnect. The Interconnect cannot be deleted if\nthis list is non-empty.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnect": { +"description": "Configuration information for application awareness on this Cloud\nInterconnect.", +"id": "InterconnectApplicationAwareInterconnect", +"properties": { +"bandwidthPercentagePolicy": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy" +}, +"profileDescription": { +"description": "Description for the application awareness profile on this Cloud\nInterconnect.", +"type": "string" +}, +"shapeAveragePercentages": { +"description": "Optional field to specify a list of shape average percentages to be\napplied in conjunction with StrictPriorityPolicy or\nBandwidthPercentagePolicy.", +"items": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" +}, +"type": "array" +}, +"strictPriorityPolicy": { +"$ref": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectBandwidthPercentage": { +"description": "Specify bandwidth percentages [1-100] for various traffic classes in\nBandwidthPercentagePolicy. The sum of all percentages must equal 100.\nAll traffic classes must have a percentage value specified.", +"id": "InterconnectApplicationAwareInterconnectBandwidthPercentage", +"properties": { +"percentage": { +"description": "Bandwidth percentage for a specific traffic class.", +"format": "uint32", +"type": "integer" +}, +"trafficClass": { +"description": "TrafficClass whose bandwidth percentage is being specified.", +"enum": [ +"TC1", +"TC2", +"TC3", +"TC4", +"TC5", +"TC6" +], +"enumDescriptions": [ +"Traffic Class 1, corresponding to DSCP ranges (0-7) 000xxx.", +"Traffic Class 2, corresponding to DSCP ranges (8-15) 001xxx.", +"Traffic Class 3, corresponding to DSCP ranges (16-23) 010xxx.", +"Traffic Class 4, corresponding to DSCP ranges (24-31) 011xxx.", +"Traffic Class 5, corresponding to DSCP ranges (32-47) 10xxxx.", +"Traffic Class 6, corresponding to DSCP ranges (48-63) 11xxxx." +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy": { +"id": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy", +"properties": { +"bandwidthPercentages": { +"description": "Specify bandwidth percentages for various traffic classes for queuing\ntype Bandwidth Percent.", +"items": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" +}, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectStrictPriorityPolicy": { +"description": "Specify configuration for StrictPriorityPolicy.", +"id": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy", +"properties": {}, +"type": "object" +}, +"InterconnectAttachment": { +"description": "Represents an Interconnect Attachment (VLAN) resource.\n\nYou can use Interconnect attachments (VLANS) to connect your Virtual Private\nCloud networks to your on-premises networks through an Interconnect.\nFor more information, read\nCreating VLAN Attachments.", +"id": "InterconnectAttachment", +"properties": { +"adminEnabled": { +"description": "Determines whether this Attachment will carry packets.\nNot present for PARTNER_PROVIDER.", +"type": "boolean" +}, +"attachmentGroup": { +"description": "Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.", +"readOnly": true, +"type": "string" +}, +"bandwidth": { +"description": "Provisioned bandwidth capacity for the interconnect attachment. For\nattachments of type DEDICATED, the user can set the bandwidth.\nFor attachments of type PARTNER, the Google Partner that is operating\nthe interconnect must set the bandwidth.\nOutput only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,\nand can take one of the following values:\n \n - BPS_50M: 50 Mbit/s\n - BPS_100M: 100 Mbit/s\n - BPS_200M: 200 Mbit/s\n - BPS_300M: 300 Mbit/s\n - BPS_400M: 400 Mbit/s\n - BPS_500M: 500 Mbit/s\n - BPS_1G: 1 Gbit/s\n - BPS_2G: 2 Gbit/s\n - BPS_5G: 5 Gbit/s\n - BPS_10G: 10 Gbit/s\n - BPS_20G: 20 Gbit/s\n - BPS_50G: 50 Gbit/s\n - BPS_100G: 100 Gbit/s\n - BPS_400G: 400 Gbit/s", +"enum": [ +"BPS_100G", +"BPS_100M", +"BPS_10G", +"BPS_1G", +"BPS_200M", +"BPS_20G", +"BPS_2G", +"BPS_300M", +"BPS_400G", +"BPS_400M", +"BPS_500M", +"BPS_50G", +"BPS_50M", +"BPS_5G" +], +"enumDescriptions": [ +"100 Gbit/s", +"100 Mbit/s", +"10 Gbit/s", +"1 Gbit/s", +"200 Mbit/s", +"20 Gbit/s", +"2 Gbit/s", +"300 Mbit/s", +"400 Gbit/s", +"400 Mbit/s", +"500 Mbit/s", +"50 Gbit/s", +"50 Mbit/s", +"5 Gbit/s" +], +"type": "string" +}, +"candidateCloudRouterIpAddress": { +"description": "Single IPv4 address + prefix length to be configured on the cloud router\ninterface for this interconnect attachment.\n \n - Both candidate_cloud_router_ip_address and\n candidate_customer_router_ip_address fields must be set or both must be\n unset.\n - Prefix length of both candidate_cloud_router_ip_address and\n candidate_customer_router_ip_address must be the same.\n - Max prefix length is 31.", +"type": "string" +}, +"candidateCloudRouterIpv6Address": { +"description": "Single IPv6 address + prefix length to be configured on the cloud router\ninterface for this interconnect attachment.\n \n - Both candidate_cloud_router_ipv6_address and\n candidate_customer_router_ipv6_address fields must be set or both must be\n unset.\n - Prefix length of both candidate_cloud_router_ipv6_address and\n candidate_customer_router_ipv6_address must be the same.\n - Max prefix length is 126.", +"type": "string" +}, +"candidateCustomerRouterIpAddress": { +"description": "Single IPv4 address + prefix length to be configured on the customer router\ninterface for this interconnect attachment.", +"type": "string" +}, +"candidateCustomerRouterIpv6Address": { +"description": "Single IPv6 address + prefix length to be configured on the customer router\ninterface for this interconnect attachment.", +"type": "string" +}, +"candidateIpv6Subnets": { +"description": "This field is not available.", +"items": { +"type": "string" +}, +"type": "array" +}, +"candidateSubnets": { +"description": "Input only. Up to 16 candidate prefixes that can be used to restrict the allocation\nof cloudRouterIpAddress and customerRouterIpAddress for this attachment.\nAll prefixes must be within link-local address space (169.254.0.0/16) and\nmust be /29 or shorter (/28, /27, etc). Google will attempt to select an\nunused /29 from the supplied candidate prefix(es). The request will fail if\nall possible /29s are in use on Google's edge. If not supplied, Google will\nrandomly select an unused /29 from all of link-local space.", +"items": { +"type": "string" +}, +"type": "array" +}, +"cloudRouterIpAddress": { +"description": "Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router\nInterface for this interconnect attachment.", +"readOnly": true, +"type": "string" +}, +"cloudRouterIpv6Address": { +"description": "Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud\nRouter Interface for this interconnect attachment.", +"readOnly": true, +"type": "string" +}, +"cloudRouterIpv6InterfaceId": { +"description": "This field is not available.", +"type": "string" +}, +"configurationConstraints": { +"$ref": "InterconnectAttachmentConfigurationConstraints", +"description": "Output only. [Output Only] Constraints for this attachment, if any. The attachment does\nnot work if these constraints are not met.", +"readOnly": true +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"customerRouterIpAddress": { +"description": "Output only. [Output Only] IPv4 address + prefix length to be configured on the customer\nrouter subinterface for this interconnect attachment.", +"readOnly": true, +"type": "string" +}, +"customerRouterIpv6Address": { +"description": "Output only. [Output Only] IPv6 address + prefix length to be configured on the\ncustomer router subinterface for this interconnect attachment.", +"readOnly": true, +"type": "string" +}, +"customerRouterIpv6InterfaceId": { +"description": "This field is not available.", +"type": "string" +}, +"dataplaneVersion": { +"description": "Output only. [Output Only] Dataplane version for this InterconnectAttachment. This\nfield is only present for Dataplane version 2 and higher. Absence of this\nfield in the API output indicates that the Dataplane is version 1.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"description": { +"description": "An optional description of this resource.", +"type": "string" +}, +"edgeAvailabilityDomain": { +"description": "Input only. Desired availability domain for the attachment. Only available for type\nPARTNER, at creation time, and can take one of the following values:\n \n - AVAILABILITY_DOMAIN_ANY\n - AVAILABILITY_DOMAIN_1\n - AVAILABILITY_DOMAIN_2\n\n\nFor improved reliability, customers should configure a pair of attachments,\none per availability domain. The selected availability domain will be\nprovided to the Partner via the pairing key, so that the provisioned\ncircuit will lie in the specified domain. If not specified, the value will\ndefault to AVAILABILITY_DOMAIN_ANY.", +"enum": [ +"AVAILABILITY_DOMAIN_1", +"AVAILABILITY_DOMAIN_2", +"AVAILABILITY_DOMAIN_ANY" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"encryption": { +"description": "Indicates the user-supplied encryption option of this VLAN attachment\n(interconnectAttachment). Can only be specified at attachment creation\nfor PARTNER or DEDICATED attachments.\nPossible values are:\n \n - NONE - This is the default value, which means that the\n VLAN attachment carries unencrypted traffic. VMs are able to send\n traffic to, or receive traffic from, such a VLAN attachment.\n - IPSEC - The VLAN attachment carries only encrypted\n traffic that is encrypted by an IPsec device, such as an HA VPN gateway or\n third-party IPsec VPN. VMs cannot directly send traffic to, or receive\n traffic from, such a VLAN attachment. To use *HA VPN over Cloud\n Interconnect*, the VLAN attachment must be created with this\n option.", +"enum": [ +"IPSEC", +"NONE" +], +"enumDescriptions": [ +"The interconnect attachment will carry only encrypted traffic that is\nencrypted by an IPsec device such as HA VPN gateway;\nVMs cannot directly send traffic to or receive traffic from such an\ninterconnect attachment. To use HA VPN over Cloud Interconnect,\nthe interconnect attachment must be created with this option.", +"This is the default value, which means the Interconnect Attachment will\ncarry unencrypted traffic. VMs will be able to send traffic to or receive\ntraffic from such interconnect attachment." +], +"type": "string" +}, +"googleReferenceId": { +"deprecated": true, +"description": "Output only. [Output Only] Google reference ID, to be used when raising support tickets\nwith Google or otherwise to debug backend connectivity issues.\n[Deprecated] This field is not used.", +"readOnly": true, +"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" +}, +"interconnect": { +"description": "URL of the underlying Interconnect object that this attachment's traffic\nwill traverse through.", +"type": "string" +}, +"ipsecInternalAddresses": { +"description": "A list of URLs of addresses that have been reserved for the VLAN\nattachment. Used only for the VLAN attachment that has the encryption\noption as IPSEC. The addresses must be regional internal IP address ranges.\nWhen creating an HA VPN gateway over the VLAN attachment, if the attachment\nis configured to use a regional internal IP address, then the VPN gateway's\nIP address is allocated from the IP address range specified here. For\nexample, if the HA VPN gateway's interface 0 is paired to this VLAN\nattachment, then a regional internal IP address for the VPN gateway\ninterface 0 will be allocated from the IP address specified for this\nVLAN attachment.\nIf this field is not specified when creating the VLAN attachment, then\nlater on when creating an HA VPN gateway on this VLAN attachment, the HA\nVPN gateway's IP address is allocated from the regional external IP address\npool.", +"items": { +"type": "string" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectAttachment", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.", +"readOnly": true, +"type": "string" +}, +"l2Forwarding": { +"$ref": "InterconnectAttachmentL2Forwarding", +"description": "L2 Interconnect Attachment related config. This field is required if the\ntype is L2_DEDICATED.\n\nThe configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)\nwithin L2 packets are mapped to the destination appliances IP addresses.\nThe packet is then encapsulated with the appliance IP address and sent to\nthe edge appliance." +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this InterconnectAttachment,\nwhich is essentially a hash of the labels set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an InterconnectAttachment.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"mtu": { +"description": "Maximum Transmission Unit (MTU), in bytes, of packets passing through this\ninterconnect attachment.\nValid values are 1440, 1460, 1500, and 8896. If not specified,\nthe value will default to 1440.", +"format": "int32", +"type": "integer" +}, +"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.\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" +}, +"operationalStatus": { +"description": "Output only. [Output Only] The current status of whether or not this interconnect\nattachment is functional, which can take one of the following values:\n \n - OS_ACTIVE: The attachment has been turned up and is ready to\n use. \n - OS_UNPROVISIONED: The attachment is not ready to use yet,\n because turnup is not complete.", +"enum": [ +"OS_ACTIVE", +"OS_UNPROVISIONED" +], +"enumDescriptions": [ +"Indicates that attachment has been turned up and is ready to\nuse.", +"Indicates that attachment is not ready to use yet, because\nturnup is not complete." +], +"readOnly": true, +"type": "string" +}, +"pairingKey": { +"description": "[Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not\npresent for DEDICATED].\nThe opaque identifier of a PARTNER attachment used to initiate\nprovisioning with a selected partner.\nOf the form \"XXXXX/region/domain\"", +"type": "string" +}, +"params": { +"$ref": "InterconnectAttachmentParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"partnerAsn": { +"description": "Optional BGP ASN for the router supplied by a Layer 3 Partner if they\nconfigured BGP on behalf of the customer.\nOutput only for PARTNER type, input only for PARTNER_PROVIDER, not\navailable for DEDICATED.", +"format": "int64", +"type": "string" +}, +"partnerMetadata": { +"$ref": "InterconnectAttachmentPartnerMetadata", +"description": "Informational metadata about Partner attachments from Partners to display\nto customers.\nOutput only for PARTNER type, mutable for PARTNER_PROVIDER, not\navailable for DEDICATED." +}, +"privateInterconnectInfo": { +"$ref": "InterconnectAttachmentPrivateInfo", +"description": "Output only. [Output Only] Information specific to an InterconnectAttachment.\nThis property is populated if the interconnect that\nthis is attached to is of type DEDICATED.", +"readOnly": true +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional interconnect attachment\nresides.\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" +}, +"remoteService": { +"description": "Output only. [Output Only]\nIf the attachment is on a Cross-Cloud Interconnect connection, this field\ncontains the interconnect's remote location service provider. Example\nvalues: \"Amazon Web Services\" \"Microsoft Azure\".\n\nThe field is set only for attachments on Cross-Cloud Interconnect\nconnections. Its value is copied from the InterconnectRemoteLocation\nremoteService field.", +"readOnly": true, +"type": "string" +}, +"router": { +"description": "URL of the Cloud Router to be used for dynamic routing. This router must be\nin the same region as this InterconnectAttachment. The\nInterconnectAttachment will automatically connect the Interconnect to the\nnetwork & region within which the Cloud Router is configured.", +"type": "string" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"stackType": { +"description": "The stack type for this interconnect attachment to identify whether the\nIPv6 feature is enabled or not. If not specified, IPV4_ONLY\nwill be used.\n\nThis field can be both set at interconnect attachments creation and\nupdate interconnect attachment operations.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY" +], +"enumDescriptions": [ +"The interconnect attachment can have both IPv4 and IPv6 addresses.", +"The interconnect attachment will only be assigned IPv4 addresses." +], +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] The current state of this attachment's functionality.\nEnum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,\nPARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values\nPENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used\nfor only PARTNER and PARTNER_PROVIDER interconnect attachments.\nThis state can take one of the following values:\n \n - ACTIVE: The attachment has been turned up and is ready to use.\n - UNPROVISIONED: The attachment is not ready to use yet, because turnup\n is not complete.\n - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet\n been configured on the Partner side.\n - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of\n provisioning after a PARTNER_PROVIDER attachment was created that\n references it. \n - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER\n attachment that is waiting for a customer to activate it. \n - DEFUNCT:\n The attachment was deleted externally and is no longer functional. This\n could be because the associated Interconnect was removed, or because the\n other side of a Partner attachment was deleted.", +"enum": [ +"ACTIVE", +"DEFUNCT", +"PARTNER_REQUEST_RECEIVED", +"PENDING_CUSTOMER", +"PENDING_PARTNER", +"STATE_UNSPECIFIED", +"UNPROVISIONED" +], +"enumDescriptions": [ +"Indicates that attachment has been turned up and is ready to use.", +"The attachment was deleted externally and is no longer functional.\nThis could be because the associated Interconnect was wiped out,\nor because the other side of a Partner attachment was deleted.", +"A PARTNER attachment is in the process of provisioning after a\nPARTNER_PROVIDER attachment was created that references it.", +"PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer\nto activate.", +"A newly created PARTNER attachment that has not yet been configured on\nthe Partner side.", +"", +"Indicates that attachment is not ready to use yet, because turnup is not\ncomplete." +], +"readOnly": true, +"type": "string" +}, +"subnetLength": { +"description": "Input only. Length of the IPv4 subnet mask.\nAllowed values:\n \n \n - 29 (default)\n - 30\n\nThe default value is 29, except for Cross-Cloud Interconnect\nconnections that use an InterconnectRemoteLocation with a\nconstraints.subnetLengthRange.min equal to 30. For example,\nconnections that use an Azure remote location fall into this\ncategory. In these cases, the default value is 30, and requesting\n29 returns an error.\n\nWhere both 29 and 30 are allowed, 29 is preferred, because it gives\nGoogle Cloud Support more debugging visibility.", +"format": "int32", +"type": "integer" +}, +"type": { +"description": "The type of interconnect attachment this is, which can take one of the\nfollowing values:\n \n - DEDICATED: an attachment to a Dedicated Interconnect.\n - PARTNER: an attachment to a Partner Interconnect, created by the\n customer.\n - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by\n the partner.\n\n- L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.", +"enum": [ +"DEDICATED", +"L2_DEDICATED", +"PARTNER", +"PARTNER_PROVIDER" +], +"enumDescriptions": [ +"Attachment to a dedicated interconnect.", +"Attachment to a dedicated interconnect, forwarding L2 packets.", +"Attachment to a partner interconnect, created by the customer.", +"Attachment to a partner interconnect, created by the partner." +], +"type": "string" +}, +"vlanTag8021q": { +"description": "The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.\nOnly specified at creation time.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectAttachmentAggregatedList": { +"id": "InterconnectAttachmentAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "InterconnectAttachmentsScopedList", +"description": "Name of the scope containing this set of interconnect attachments." +}, +"description": "A list of InterconnectAttachmentsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#interconnectAttachmentAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated\nlists of interconnect attachments.", +"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" +}, +"InterconnectAttachmentConfigurationConstraints": { +"id": "InterconnectAttachmentConfigurationConstraints", +"properties": { +"bgpMd5": { +"description": "Output only. [Output Only] Whether the attachment's BGP session\nrequires/allows/disallows BGP MD5 authentication. This can take one of\nthe following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.\n\nFor example, a Cross-Cloud Interconnect connection to a remote cloud\nprovider that requires BGP MD5 authentication has the\ninterconnectRemoteLocation attachment_configuration_constraints.bgp_md5\nfield set to MD5_REQUIRED, and that property is propagated to the\nattachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is\nreturned if MD5 is requested.", +"enum": [ +"MD5_OPTIONAL", +"MD5_REQUIRED", +"MD5_UNSUPPORTED" +], +"enumDescriptions": [ +"MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be\nconfigured.", +"MD5_REQUIRED: BGP MD5 authentication must be configured.", +"MD5_UNSUPPORTED: BGP MD5 authentication must not be configured" +], +"readOnly": true, +"type": "string" +}, +"bgpPeerAsnRanges": { +"description": "Output only. [Output Only] List of ASN ranges that the remote location is known to\nsupport. Formatted as an array of inclusive ranges {min: min-value, max:\nmax-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]\nallows the peer ASN to be 123 or anything in the range 64512-65534.\n\nThis field is only advisory. Although the API accepts other ranges, these\nare the ranges that we recommend.", +"items": { +"$ref": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange": { +"id": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange", +"properties": { +"max": { +"format": "uint32", +"type": "integer" +}, +"min": { +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroup": { +"description": "An interconnect attachment group resource allows customers to create,\nanalyze, and expand highly available deployments.", +"id": "InterconnectAttachmentGroup", +"properties": { +"attachments": { +"additionalProperties": { +"$ref": "InterconnectAttachmentGroupAttachment" +}, +"description": "Attachments in the AttachmentGroup. Keys are arbitrary user-specified\nstrings. Users are encouraged, but not required, to use their preferred\nformat for resource links as keys.\nNote that there are add-members and remove-members methods in gcloud.\nThe size of this map is limited by an \"Attachments per group\" quota.", +"type": "object" +}, +"configured": { +"$ref": "InterconnectAttachmentGroupConfigured", +"readOnly": true +}, +"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" +}, +"etag": { +"description": "Opaque system-generated token that uniquely identifies the configuration.\nIf provided when patching a configuration in update mode, the provided\ntoken must match the current token or the update is rejected. This provides\na reliable means of doing read-modify-write (optimistic locking) as\ndescribed byAIP 154.", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"intent": { +"$ref": "InterconnectAttachmentGroupIntent" +}, +"interconnectGroup": { +"description": "The URL of an InterconnectGroup that groups these Attachments'\nInterconnects. Customers do not need to set this unless directed by\nGoogle Support.", +"type": "string" +}, +"kind": { +"default": "compute#interconnectAttachmentGroup", +"description": "Output only. [Output Only] Type of the resource. Always\ncompute#interconnectAttachmentGroup.", +"readOnly": true, +"type": "string" +}, +"logicalStructure": { +"$ref": "InterconnectAttachmentGroupLogicalStructure", +"readOnly": true +}, +"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.\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" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupAttachment": { +"description": "An Attachment in this AttachmentGroup.", +"id": "InterconnectAttachmentGroupAttachment", +"properties": { +"attachment": { +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupConfigured": { +"description": "[Output Only] The redundancy this group is configured to support. The way a\nuser queries what SLA their Attachment gets is by looking at this field of\nthe Attachment's AttachmentGroup.", +"id": "InterconnectAttachmentGroupConfigured", +"properties": { +"availabilitySla": { +"$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLA", +"readOnly": true +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupConfiguredAvailabilitySLA": { +"description": "[Output Only] Which SLA this group is configured to support, and why this\ngroup does or does not meet that SLA's requirements.", +"id": "InterconnectAttachmentGroupConfiguredAvailabilitySLA", +"properties": { +"effectiveSla": { +"enum": [ +"EFFECTIVE_SLA_UNSPECIFIED", +"NO_SLA", +"PRODUCTION_CRITICAL", +"PRODUCTION_NON_CRITICAL" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"intendedSlaBlockers": { +"items": { +"$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers": { +"description": "[Output Only] Reasons why configuration.availabilitySLA.sla differs from\nintent.availabilitySLA. This list is empty if and only if those are the\nsame.", +"id": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers", +"properties": { +"attachments": { +"description": "Output only. [Output Only] URLs of any particular Attachments to explain this\nblocker in more detail.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"blockerType": { +"enum": [ +"BLOCKER_TYPE_UNSPECIFIED", +"INCOMPATIBLE_METROS", +"INCOMPATIBLE_REGIONS", +"MISSING_GLOBAL_ROUTING", +"NO_ATTACHMENTS", +"NO_ATTACHMENTS_IN_METRO_AND_ZONE", +"OTHER" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"documentationLink": { +"description": "Output only. [Output Only] The url of Google Cloud public documentation explaining\nthis requirement. This is set for every type of requirement.", +"readOnly": true, +"type": "string" +}, +"explanation": { +"description": "Output only. [Output Only] A human-readable explanation of this requirement and\nwhy it's not met. This is set for every type of requirement.", +"readOnly": true, +"type": "string" +}, +"metros": { +"description": "Output only. [Output Only] Metros used to explain this blocker in more detail.\nThese are three-letter lowercase strings like \"iad\". This will be set\nfor some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does\nnot apply to others.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"regions": { +"description": "Output only. [Output Only] Regions used to explain this blocker in more\ndetail. These are region names formatted like \"us-central1\". This\nwill be set for some blockers (like INCOMPATIBLE_REGIONS) but does\nnot apply to others.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"zones": { +"description": "Output only. [Output Only] Zones used to explain this blocker in more detail.\nFormat is \"zone1\" and/or \"zone2\". This will be set for some blockers\n(like MISSING_ZONE) but does not apply to others.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupIntent": { +"description": "The user's intent for this AttachmentGroup. This is the only required field\nbesides the name that must be specified on group creation.", +"id": "InterconnectAttachmentGroupIntent", +"properties": { +"availabilitySla": { +"enum": [ +"AVAILABILITY_SLA_UNSPECIFIED", +"NO_SLA", +"PRODUCTION_CRITICAL", +"PRODUCTION_NON_CRITICAL" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupLogicalStructure": { +"description": "[Output Only] An analysis of the logical layout of Attachments in this\ngroup. Every Attachment in the group is shown once in this structure.", +"id": "InterconnectAttachmentGroupLogicalStructure", +"properties": { +"regions": { +"items": { +"$ref": "InterconnectAttachmentGroupLogicalStructureRegion" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupLogicalStructureRegion": { +"description": "[Output Only] The regions Attachments in this group are in.", +"id": "InterconnectAttachmentGroupLogicalStructureRegion", +"properties": { +"metros": { +"items": { +"$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetro" +}, +"readOnly": true, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] The name of a region, like \"us-central1\".", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupLogicalStructureRegionMetro": { +"description": "[Output Only] The metros of Attachments in this group in this region.", +"id": "InterconnectAttachmentGroupLogicalStructureRegionMetro", +"properties": { +"facilities": { +"items": { +"$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility" +}, +"readOnly": true, +"type": "array" +}, +"metro": { +"description": "Output only. [Output Only] The name of the metro, as a three-letter lowercase\nstring like \"iad\". This is the first component of the location of an\nInterconnect.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupLogicalStructureRegionMetroFacility": { +"description": "[Output Only] The facilities used for this group's Attachments'\nInterconnects.", +"id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility", +"properties": { +"facility": { +"description": "Output only. [Output Only] The name of a facility, like \"iad-1234\".", +"readOnly": true, +"type": "string" +}, +"zones": { +"items": { +"$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone": { +"description": "[Output Only] The zones that Attachments in this group are present\nin, in the given facilities. This is inherited from their\nInterconnects.", +"id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone", +"properties": { +"attachments": { +"description": "Output only. [Output Only] URLs of Attachments in the given zone, to the given\nregion, on Interconnects in the given facility and metro. Every\nAttachment in the AG has such an entry.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"zone": { +"description": "Output only. [Output Only] The name of a zone, either \"zone1\" or \"zone2\".", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupsGetOperationalStatusResponse": { +"description": "Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse.", +"id": "InterconnectAttachmentGroupsGetOperationalStatusResponse", +"properties": { +"etag": { +"type": "string" +}, +"result": { +"$ref": "InterconnectAttachmentGroupsOperationalStatus" +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupsListResponse": { +"id": "InterconnectAttachmentGroupsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InterconnectAttachmentGroup resources.", +"items": { +"$ref": "InterconnectAttachmentGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectAttachmentGroup", +"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] Server-defined URL for this resource.", +"type": "string" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.\nend_interface:\nMixerListResponseWithEtagBuilder", +"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" +}, +"InterconnectAttachmentGroupsOperationalStatus": { +"id": "InterconnectAttachmentGroupsOperationalStatus", +"properties": { +"attachmentStatuses": { +"items": { +"$ref": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus" +}, +"readOnly": true, +"type": "array" +}, +"configured": { +"$ref": "InterconnectAttachmentGroupConfigured", +"readOnly": true +}, +"groupStatus": { +"description": "Output only. Summarizes the status of the group.", +"enum": [ +"DEGRADED", +"FULLY_DOWN", +"FULLY_UP", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"intent": { +"$ref": "InterconnectAttachmentGroupIntent", +"readOnly": true +}, +"operational": { +"$ref": "InterconnectAttachmentGroupConfigured", +"description": "Output only. The operational state of the group, including only active Attachments.", +"readOnly": true +} +}, +"type": "object" +}, +"InterconnectAttachmentGroupsOperationalStatusAttachmentStatus": { +"description": "The status of one Attachment in the group. List order is arbitrary.", +"id": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus", +"properties": { +"adminEnabled": { +"description": "Output only. Whether this Attachment is enabled. This becomes false when the customer\ndrains their Attachment.", +"readOnly": true, +"type": "boolean" +}, +"attachment": { +"description": "Output only. The URL of the Attachment being described.", +"readOnly": true, +"type": "string" +}, +"isActive": { +"description": "Output only. Whether this Attachment is participating in the redundant configuration.\nThis will be ACTIVE if and only if the status below is CONNECTION_UP.\nAny INACTIVE Attachments are excluded from the analysis that generates\noperational.availabilitySLA.", +"enum": [ +"ACTIVE", +"INACTIVE", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. Whether this Attachment is active, and if so, whether BGP is up.", +"enum": [ +"ATTACHMENT_STATUS_UNKNOWN", +"CONNECTION_DISABLED", +"CONNECTION_DOWN", +"CONNECTION_UP", +"DEFUNCT", +"IPSEC_CONFIGURATION_NEEDED_STATUS", +"IPSEC_READY_TO_RESUME_FLOW_STATUS", +"IPV4_DOWN_IPV6_UP", +"IPV4_UP_IPV6_DOWN", +"PARTNER_REQUEST_RECEIVED", +"PENDING_CUSTOMER", +"PENDING_PARTNER", +"PROVISIONED", +"ROUTER_CONFIGURATION_BROKEN", +"UNPROVISIONED" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentL2Forwarding": { +"description": "L2 Interconnect Attachment related configuration.", +"id": "InterconnectAttachmentL2Forwarding", +"properties": { +"applianceMappings": { +"additionalProperties": { +"$ref": "InterconnectAttachmentL2ForwardingApplianceMapping" +}, +"description": "Optional. A map of VLAN tags to appliances and optional inner mapping\nrules. If VLANs are not explicitly mapped to any appliance, the\ndefaultApplianceIpAddress is used.\n\nEach VLAN tag can be a single number or a range of numbers in the range\nof 1 to 4094, e.g., \"1\" or \"4001-4094\". Non-empty and non-overlapping\nVLAN tag ranges are enforced, and violating operations will be rejected.\n\nThe VLAN tags in the Ethernet header must use an ethertype value of\n0x88A8 or 0x8100.", +"type": "object" +}, +"defaultApplianceIpAddress": { +"description": "Optional. A single IPv4 or IPv6 address used as the default destination\nIP when there is no VLAN mapping result found.\n\nUnset field (null-value) indicates the unmatched packet should be\ndropped.", +"type": "string" +}, +"geneveHeader": { +"$ref": "InterconnectAttachmentL2ForwardingGeneveHeader", +"description": "Optional. It represents the structure of a Geneve (Generic Network\nVirtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various\nprotocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization\nenvironments." +}, +"network": { +"description": "Required. Resource URL of the network to which this attachment belongs.", +"type": "string" +}, +"tunnelEndpointIpAddress": { +"description": "Required. A single IPv4 or IPv6 address. This address will be used as the\nsource IP address for packets sent to the appliances, and must be used as\nthe destination IP address for packets that should be sent out through\nthis attachment.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentL2ForwardingApplianceMapping": { +"description": "Two-level VLAN-to-Appliance mapping rule.", +"id": "InterconnectAttachmentL2ForwardingApplianceMapping", +"properties": { +"applianceIpAddress": { +"description": "Optional. A single IPv4 or IPv6 address used as the destination IP\naddress for ingress packets that match on a VLAN tag, but do not match\na more specific inner VLAN tag.\n\nUnset field (null-value) indicates both VLAN tags are required to be\nmapped. Otherwise, defaultApplianceIpAddress is used.", +"type": "string" +}, +"innerVlanToApplianceMappings": { +"description": "Optional. Used to match against the inner VLAN when the packet\ncontains two VLAN tags.\n\nA list of mapping rules from inner VLAN tags to IP addresses. If the\ninner VLAN is not explicitly mapped to an IP address range, the\napplianceIpAddress is used.", +"items": { +"$ref": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping" +}, +"type": "array" +}, +"name": { +"description": "Optional. The name of this appliance mapping rule.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping": { +"description": "The inner VLAN-to-Appliance mapping.", +"id": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping", +"properties": { +"innerApplianceIpAddress": { +"description": "Required in this object. A single IPv4 or IPv6 address used as the\ndestination IP address for ingress packets that match on both VLAN\ntags.", +"type": "string" +}, +"innerVlanTags": { +"description": "Required in this object. Used to match the inner VLAN tag on the\npacket. Each entry can be a single number or a range of numbers in\nthe range of 1 to 4094, e.g., [\"1\", \"4001-4094\"] is valid. Non-empty\nand Non-overlapping VLAN tag ranges are enforced, and violating\noperations will be rejected.\n\nThe inner VLAN tags must have an ethertype value of 0x8100.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectAttachmentL2ForwardingGeneveHeader": { +"description": "GeneveHeader related configurations.", +"id": "InterconnectAttachmentL2ForwardingGeneveHeader", +"properties": { +"vni": { +"description": "Optional. VNI is a 24-bit unique virtual network identifier, from 0 to\n16,777,215.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectAttachmentList": { +"description": "Response to the list request, and contains a list of interconnect\nattachments.", +"id": "InterconnectAttachmentList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InterconnectAttachment resources.", +"items": { +"$ref": "InterconnectAttachment" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectAttachmentList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect\nattachments.", +"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.", +"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" +}, +"InterconnectAttachmentParams": { +"description": "Additional interconnect attachment parameters.", +"id": "InterconnectAttachmentParams", +"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" +}, +"InterconnectAttachmentPartnerMetadata": { +"description": "Informational metadata about Partner attachments from Partners to display\nto customers. These fields are propagated from PARTNER_PROVIDER\nattachments to their corresponding PARTNER attachments.", +"id": "InterconnectAttachmentPartnerMetadata", +"properties": { +"interconnectName": { +"description": "Plain text name of the Interconnect this attachment is connected to, as\ndisplayed in the Partner's portal. For instance \"Chicago 1\".\nThis value may be validated to match approved Partner values.", +"type": "string" +}, +"partnerName": { +"description": "Plain text name of the Partner providing this attachment.\nThis value may be validated to match approved Partner values.", +"type": "string" +}, +"portalUrl": { +"description": "URL of the Partner's portal for this Attachment. Partners may customise\nthis to be a deep link to the specific resource on the Partner portal.\nThis value may be validated to match approved Partner values.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectAttachmentPrivateInfo": { +"description": "Information for an interconnect attachment when this belongs to an\ninterconnect of type DEDICATED.", +"id": "InterconnectAttachmentPrivateInfo", +"properties": { +"tag8021q": { +"description": "[Output Only] 802.1q encapsulation tag to be used for traffic between\nGoogle and the customer, going to and from this network and region.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectAttachmentsScopedList": { +"id": "InterconnectAttachmentsScopedList", +"properties": { +"interconnectAttachments": { +"description": "A list of interconnect attachments contained in this scope.", +"items": { +"$ref": "InterconnectAttachment" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of addresses when\nthe 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.", +"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" +}, +"InterconnectCircuitInfo": { +"description": "Describes a single physical circuit between the Customer and Google.\nCircuitInfo objects are created by Google, so all fields are output only.", +"id": "InterconnectCircuitInfo", +"properties": { +"customerDemarcId": { +"description": "Customer-side demarc ID for this circuit.", +"type": "string" +}, +"googleCircuitId": { +"description": "Google-assigned unique ID for this circuit. Assigned at circuit turn-up.", +"type": "string" +}, +"googleDemarcId": { +"description": "Google-side demarc ID for this circuit. Assigned at circuit turn-up and\nprovided by Google to the customer in the LOA.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectDiagnostics": { +"description": "Diagnostics information about the Interconnect connection, which contains\ndetailed and current technical information about Google's side of the\nconnection.", +"id": "InterconnectDiagnostics", +"properties": { +"arpCaches": { +"description": "A list of InterconnectDiagnostics.ARPEntry objects,\ndescribing individual neighbors currently seen by the Google router in\nthe ARP cache for the Interconnect.\nThis will be empty when the Interconnect is not bundled.", +"items": { +"$ref": "InterconnectDiagnosticsARPEntry" +}, +"type": "array" +}, +"bundleAggregationType": { +"description": "The aggregation type of the bundle interface.", +"enum": [ +"BUNDLE_AGGREGATION_TYPE_LACP", +"BUNDLE_AGGREGATION_TYPE_STATIC" +], +"enumDescriptions": [ +"LACP is enabled.", +"LACP is disabled." +], +"type": "string" +}, +"bundleOperationalStatus": { +"description": "The operational status of the bundle interface.", +"enum": [ +"BUNDLE_OPERATIONAL_STATUS_DOWN", +"BUNDLE_OPERATIONAL_STATUS_UP" +], +"enumDescriptions": [ +"If bundleAggregationType is LACP: LACP is not established and/or all\nlinks in the bundle have DOWN operational status. If\nbundleAggregationType is STATIC: one or more links in the bundle has\nDOWN operational status.", +"If bundleAggregationType is LACP: LACP is established and at least one\nlink in the bundle has UP operational status. If bundleAggregationType\nis STATIC: all links in the bundle (typically just one) have UP\noperational status." +], +"type": "string" +}, +"links": { +"description": "A list of InterconnectDiagnostics.LinkStatus objects,\ndescribing the status for each link on the Interconnect.", +"items": { +"$ref": "InterconnectDiagnosticsLinkStatus" +}, +"type": "array" +}, +"macAddress": { +"description": "The MAC address of the Interconnect's bundle interface.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectDiagnosticsARPEntry": { +"description": "Describing the ARP neighbor entries seen on this link", +"id": "InterconnectDiagnosticsARPEntry", +"properties": { +"ipAddress": { +"description": "The IP address of this ARP neighbor.", +"type": "string" +}, +"macAddress": { +"description": "The MAC address of this ARP neighbor.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectDiagnosticsLinkLACPStatus": { +"id": "InterconnectDiagnosticsLinkLACPStatus", +"properties": { +"googleSystemId": { +"description": "System ID of the port on Google's side of the LACP exchange.", +"type": "string" +}, +"neighborSystemId": { +"description": "System ID of the port on the neighbor's side of the LACP exchange.", +"type": "string" +}, +"state": { +"description": "The state of a LACP link, which can take one of the following values:\n \n - ACTIVE: The link is configured and active within the bundle.\n - DETACHED: The link is not configured within the bundle. This means\n that the rest of the object should be empty.", +"enum": [ +"ACTIVE", +"DETACHED" +], +"enumDescriptions": [ +"The link is configured and active within the bundle.", +"The link is not configured within the bundle, this means the rest of\nthe object should be empty." +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectDiagnosticsLinkOpticalPower": { +"id": "InterconnectDiagnosticsLinkOpticalPower", +"properties": { +"state": { +"description": "The status of the current value when compared to the warning and alarm\nlevels for the receiving or transmitting transceiver. Possible states\ninclude:\n \n \n - OK: The value has not crossed a warning threshold.\n - LOW_WARNING: The value has crossed below the low\n warning threshold. \n - HIGH_WARNING: The value has\n crossed above the high warning threshold.\n - LOW_ALARM: The value has crossed below the low alarm\n threshold.\n - HIGH_ALARM: The value has crossed above the high alarm\n threshold.", +"enum": [ +"HIGH_ALARM", +"HIGH_WARNING", +"LOW_ALARM", +"LOW_WARNING", +"OK" +], +"enumDescriptions": [ +"The value has crossed above the high alarm threshold.", +"The value of the current optical power has crossed above the high\nwarning threshold.", +"The value of the current optical power has crossed below the low alarm\nthreshold.", +"The value of the current optical power has crossed below the low\nwarning threshold.", +"The value of the current optical power has not crossed a warning\nthreshold." +], +"type": "string" +}, +"value": { +"description": "Value of the current receiving or transmitting optical power, read in\ndBm. Take a known good optical value, give it a 10% margin and trigger\nwarnings relative to that value. In general, a -7dBm warning and a -11dBm\nalarm are good optical value estimates for most links.", +"format": "float", +"type": "number" +} +}, +"type": "object" +}, +"InterconnectDiagnosticsLinkStatus": { +"id": "InterconnectDiagnosticsLinkStatus", +"properties": { +"arpCaches": { +"description": "A list of InterconnectDiagnostics.ARPEntry objects,\ndescribing the ARP neighbor entries seen on this link.\nThis will be empty if the link is bundled", +"items": { +"$ref": "InterconnectDiagnosticsARPEntry" +}, +"type": "array" +}, +"circuitId": { +"description": "The unique ID for this link assigned during turn up by Google.", +"type": "string" +}, +"googleDemarc": { +"description": "The Demarc address assigned by Google and provided in the LoA.", +"type": "string" +}, +"lacpStatus": { +"$ref": "InterconnectDiagnosticsLinkLACPStatus" +}, +"macsec": { +"$ref": "InterconnectDiagnosticsMacsecStatus", +"description": "Describes the status of MACsec encryption on this link." +}, +"operationalStatus": { +"description": "The operational status of the link.", +"enum": [ +"LINK_OPERATIONAL_STATUS_DOWN", +"LINK_OPERATIONAL_STATUS_UP" +], +"enumDescriptions": [ +"The interface is unable to communicate with the remote end.", +"The interface has low level communication with the remote end." +], +"type": "string" +}, +"receivingOpticalPower": { +"$ref": "InterconnectDiagnosticsLinkOpticalPower", +"description": "An InterconnectDiagnostics.LinkOpticalPower object,\ndescribing the current value and status of the received light level." +}, +"transmittingOpticalPower": { +"$ref": "InterconnectDiagnosticsLinkOpticalPower", +"description": "An InterconnectDiagnostics.LinkOpticalPower object,\ndescribing the current value and status of the transmitted light level." +} +}, +"type": "object" +}, +"InterconnectDiagnosticsMacsecStatus": { +"description": "Describes the status of MACsec encryption on the link.", +"id": "InterconnectDiagnosticsMacsecStatus", +"properties": { +"ckn": { +"description": "Indicates the Connectivity Association Key Name (CKN)\ncurrently being used if MACsec is operational.", +"type": "string" +}, +"operational": { +"description": "Indicates whether or not MACsec is operational on this link.", +"type": "boolean" +} +}, +"type": "object" +}, +"InterconnectGroup": { +"description": "An interconnect group resource allows customers to create, analyze, and\nexpand their redundant connections.", +"id": "InterconnectGroup", +"properties": { +"configured": { +"$ref": "InterconnectGroupConfigured", +"readOnly": true +}, +"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" +}, +"etag": { +"description": "Opaque system-generated token that uniquely identifies the configuration.\nIf provided when patching a configuration in update mode, the provided\ntoken must match the current token or the update is rejected. This provides\na reliable means of doing read-modify-write (optimistic locking) as\ndescribed by AIP 154.", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"intent": { +"$ref": "InterconnectGroupIntent" +}, +"interconnects": { +"additionalProperties": { +"$ref": "InterconnectGroupInterconnect" +}, +"description": "Interconnects in the InterconnectGroup. Keys are arbitrary user-specified\nstrings. Users are encouraged, but not required, to use their preferred\nformat for resource links as keys.\nNote that there are add-members and remove-members methods in gcloud.\nThe size of this map is limited by an \"Interconnects per group\" quota.", +"type": "object" +}, +"kind": { +"default": "compute#InterconnectGroup", +"description": "Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.interconnectGroups.insert" +] +}, +"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" +}, +"physicalStructure": { +"$ref": "InterconnectGroupPhysicalStructure", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupConfigured": { +"description": "[Output Only] The status of the group as configured. This has the same\nstructure as the operational field reported by the OperationalStatus\nmethod, but does not take into account the operational status of each\nresource.", +"id": "InterconnectGroupConfigured", +"properties": { +"topologyCapability": { +"$ref": "InterconnectGroupConfiguredTopologyCapability", +"readOnly": true +} +}, +"type": "object" +}, +"InterconnectGroupConfiguredTopologyCapability": { +"description": "[Output Only] How reliable this topology is configured to be, and why\nthis group does or does not meet the requirements for the intended\ncapability.", +"id": "InterconnectGroupConfiguredTopologyCapability", +"properties": { +"intendedCapabilityBlockers": { +"items": { +"$ref": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers" +}, +"readOnly": true, +"type": "array" +}, +"supportedSla": { +"enum": [ +"NO_SLA", +"PRODUCTION_CRITICAL", +"PRODUCTION_NON_CRITICAL", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers": { +"description": "[Output Only] Reasons why configuration.topologyCapability.sla differs\nfrom intent.topologyCapability. This list is empty if and only if those\nare the same.", +"id": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers", +"properties": { +"blockerType": { +"enum": [ +"INCOMPATIBLE_METROS", +"NOT_AVAILABLE", +"NO_INTERCONNECTS", +"NO_INTERCONNECTS_IN_METRO_AND_ZONE", +"OTHER", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"documentationLink": { +"description": "Output only. [Output Only] The url of Google Cloud public documentation explaining\nthis requirement. This is set for every type of requirement.", +"readOnly": true, +"type": "string" +}, +"explanation": { +"description": "Output only. [Output Only] A human-readable explanation of this requirement and\nwhy it's not met. This is set for every type of requirement.", +"readOnly": true, +"type": "string" +}, +"facilities": { +"description": "Output only. [Output Only] Facilities used to explain this blocker in more detail.\nLike physicalStructure.metros.facilities.facility, this is a numeric\nstring like \"5467\".", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"interconnects": { +"description": "Output only. [Output Only] Interconnects used to explain this blocker in more\ndetail.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"metros": { +"description": "Output only. [Output Only] Metros used to explain this blocker in more detail.\nThese are three-letter lowercase strings like \"iad\". A blocker like\nINCOMPATIBLE_METROS will specify the problematic metros in this\nfield.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"zones": { +"description": "Output only. [Output Only] Zones used to explain this blocker in more detail.\nZone names are \"zone1\" and/or \"zone2\".", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectGroupIntent": { +"description": "The user's intent for this group. This is the only required field besides\nthe name that must be specified on group creation.", +"id": "InterconnectGroupIntent", +"properties": { +"topologyCapability": { +"enum": [ +"NO_SLA", +"PRODUCTION_CRITICAL", +"PRODUCTION_NON_CRITICAL", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupInterconnect": { +"description": "An Interconnect in this InterconnectGroup.", +"id": "InterconnectGroupInterconnect", +"properties": { +"interconnect": { +"description": "The URL of an Interconnect in this group. All Interconnects in the group\nare unique.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupPhysicalStructure": { +"description": "[Output Only] An analysis of the physical layout of Interconnects in this\ngroup. Every Interconnect in the group is shown once in this structure.", +"id": "InterconnectGroupPhysicalStructure", +"properties": { +"metros": { +"items": { +"$ref": "InterconnectGroupPhysicalStructureMetros" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectGroupPhysicalStructureMetros": { +"description": "[Output Only] The metros Interconnects in this group are in.", +"id": "InterconnectGroupPhysicalStructureMetros", +"properties": { +"facilities": { +"items": { +"$ref": "InterconnectGroupPhysicalStructureMetrosFacilities" +}, +"readOnly": true, +"type": "array" +}, +"metro": { +"description": "Output only. [Output Only] The name of the metro, as a three-letter lowercase string\nlike \"iad\". This is the first component of the location of\nInterconnects underneath this.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupPhysicalStructureMetrosFacilities": { +"description": "[Output Only] The facilities Interconnects in this metro are present\nin.", +"id": "InterconnectGroupPhysicalStructureMetrosFacilities", +"properties": { +"facility": { +"description": "Output only. [Output Only] The ID of this facility, as a numeric string like\n\"5467\". This is the third component of the location of Interconnects\nin this facility.", +"readOnly": true, +"type": "string" +}, +"zones": { +"items": { +"$ref": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectGroupPhysicalStructureMetrosFacilitiesZones": { +"description": "[Output Only] The zones that Interconnects in this facility are\npresent in.", +"id": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones", +"properties": { +"interconnects": { +"description": "Output only. [Output Only] URLs of Interconnects in this redundancy group in the\ngiven metro, facility, and zone.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"zone": { +"description": "Output only. [Output Only] The name of the zone, either \"zone1\" or \"zone2\".\nThis is the second component of the location of Interconnects in\nthis facility.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectGroupsCreateMembers": { +"id": "InterconnectGroupsCreateMembers", +"properties": { +"intentMismatchBehavior": { +"description": "How to behave when configured.topologyCapability.supportedSLA would not\nequal intent.topologyCapability after this call.", +"enum": [ +"CREATE", +"REJECT", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"interconnects": { +"items": { +"$ref": "InterconnectGroupsCreateMembersInterconnectInput" +}, +"type": "array" +}, +"templateInterconnect": { +"$ref": "InterconnectGroupsCreateMembersInterconnectInput", +"description": "Parameters for the Interconnects to create." +} +}, +"type": "object" +}, +"InterconnectGroupsCreateMembersInterconnectInput": { +"id": "InterconnectGroupsCreateMembersInterconnectInput", +"properties": { +"adminEnabled": { +"description": "Administrative status of the interconnect. When this is set to true, the\nInterconnect is functional and can carry traffic.\nWhen set to false, no packets can be carried over the interconnect and\nno BGP routes are exchanged over it. By default, the status is set to\ntrue.", +"type": "boolean" +}, +"customerName": { +"description": "Customer name, to put in the Letter of Authorization as the party\nauthorized to request a crossconnect.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"facility": { +"description": "A zone-free location to use for all Interconnects created in this call,\nlike \"iad-1234\".", +"type": "string" +}, +"interconnectType": { +"description": "Type of interconnect, which can take one of the following values:\n \n - PARTNER: A partner-managed interconnection shared between\n customers though a partner. \n - DEDICATED: A dedicated physical\n interconnection with the customer.\n\n Note that a value IT_PRIVATE\nhas been deprecated in favor of DEDICATED.", +"enum": [ +"DEDICATED", +"IT_PRIVATE", +"PARTNER" +], +"enumDescriptions": [ +"A dedicated physical interconnection with the customer.", +"[Deprecated] A private, physical interconnection with the customer.", +"A partner-managed interconnection shared between customers via partner." +], +"type": "string" +}, +"linkType": { +"description": "Type of link requested, which can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics\n - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.\n - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4\n optics.\n\n Note that this field indicates the speed of each of the\nlinks in the bundle, not the speed of the entire bundle.", +"enum": [ +"LINK_TYPE_ETHERNET_100G_LR", +"LINK_TYPE_ETHERNET_10G_LR", +"LINK_TYPE_ETHERNET_400G_LR4" +], +"enumDescriptions": [ +"100G Ethernet, LR Optics.", +"10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", +"400G Ethernet, LR4 Optics." +], +"type": "string" +}, +"name": { +"description": "Name of the Interconnects to be created. This must be specified on the\ntemplate and/or on each individual interconnect. The name, if not empty,\nmust be 1-63 characters long, and comply with RFC1035.\nSpecifically, any nonempty name must be 1-63 characters long and match\nthe regular expression `[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.", +"type": "string" +}, +"nocContactEmail": { +"description": "Email address to contact the customer NOC for operations and maintenance\nnotifications regarding this Interconnect. If specified, this will be\nused for notifications in addition to all other forms described, such as\nCloud Monitoring logs alerting and Cloud Notifications. This field is\nrequired for users who sign up for Cloud Interconnect using\nworkforce identity federation.", +"type": "string" +}, +"remoteLocation": { +"description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies\nthe location outside of Google's network that the interconnect is\nconnected to.", +"type": "string" +}, +"requestedFeatures": { +"description": "Optional. List of features requested for this Interconnect connection,\nwhich can take one of the following values:\n \n - IF_MACSEC: If specified, then the connection is created on MACsec\n capable hardware ports. If not specified, non-MACsec capable ports will\n also be considered.\n - IF_CROSS_SITE_NETWORK: If specified, then the connection is created\n exclusively for Cross-Site Networking. The connection can not be used for\n Cross-Site Networking unless this feature is specified.", +"items": { +"enum": [ +"IF_CROSS_SITE_NETWORK", +"IF_L2_FORWARDING", +"IF_MACSEC" +], +"enumDescriptions": [ +"Cross-Site Networking", +"L2 Interconnect Attachment Forwarding", +"Media Access Control security (MACsec)" +], +"type": "string" +}, +"type": "array" +}, +"requestedLinkCount": { +"description": "Target number of physical links in the link bundle, as requested by the\ncustomer.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectGroupsCreateMembersRequest": { +"id": "InterconnectGroupsCreateMembersRequest", +"properties": { +"request": { +"$ref": "InterconnectGroupsCreateMembers" +} +}, +"type": "object" +}, +"InterconnectGroupsGetOperationalStatusResponse": { +"description": "Response for the InterconnectGroupsGetOperationalStatusResponse.", +"id": "InterconnectGroupsGetOperationalStatusResponse", +"properties": { +"etag": { +"type": "string" +}, +"result": { +"$ref": "InterconnectGroupsOperationalStatus" +} +}, +"type": "object" +}, +"InterconnectGroupsListResponse": { +"id": "InterconnectGroupsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InterconnectGroup resources.", +"items": { +"$ref": "InterconnectGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#InterconnectGroup", +"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] Server-defined URL for this resource.", +"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" +}, +"InterconnectGroupsOperationalStatus": { +"description": "Request to get the status of the interconnect group with extra detail.", +"id": "InterconnectGroupsOperationalStatus", +"properties": { +"configured": { +"$ref": "InterconnectGroupConfigured", +"description": "Output only. The configuration analysis, as returned by Get.", +"readOnly": true +}, +"groupStatus": { +"description": "Output only. Summarizes the status of the group.", +"enum": [ +"DEGRADED", +"FULLY_DOWN", +"FULLY_UP", +"GROUPS_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"intent": { +"$ref": "InterconnectGroupIntent", +"description": "Output only. The intent of the resource, as returned by Get.", +"readOnly": true +}, +"interconnectStatuses": { +"items": { +"$ref": "InterconnectGroupsOperationalStatusInterconnectStatus" +}, +"readOnly": true, +"type": "array" +}, +"operational": { +"$ref": "InterconnectGroupConfigured", +"description": "Output only. The operational state of the group, including only active Interconnects.", +"readOnly": true +} +}, +"type": "object" +}, +"InterconnectGroupsOperationalStatusInterconnectStatus": { +"description": "The status of one Interconnect in the group. The order is arbitrary.", +"id": "InterconnectGroupsOperationalStatusInterconnectStatus", +"properties": { +"adminEnabled": { +"description": "Output only. Whether the Interconnect is enabled.", +"readOnly": true, +"type": "boolean" +}, +"diagnostics": { +"$ref": "InterconnectDiagnostics", +"description": "Output only. The diagnostics of the Interconnect, as returned by the existing\nget-diagnostics method.", +"readOnly": true +}, +"interconnect": { +"description": "Output only. The URL of the Interconnect being described.", +"readOnly": true, +"type": "string" +}, +"isActive": { +"description": "Output only. Whether this interconnect is participating in the redundant\nconfiguration.", +"enum": [ +"ACTIVE", +"INACTIVE", +"IS_ACTIVE_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectList": { +"description": "Response to the list request, and contains a list of interconnects.", +"id": "InterconnectList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Interconnect resources.", +"items": { +"$ref": "Interconnect" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects.", +"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.", +"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" +}, +"InterconnectLocation": { +"description": "Represents an Interconnect Attachment (VLAN) Location resource.\n\nYou can use this resource to find location details about an Interconnect\nattachment (VLAN). For more information about interconnect attachments, read\nCreating VLAN Attachments.", +"id": "InterconnectLocation", +"properties": { +"address": { +"description": "Output only. [Output Only] The postal address of the Point of Presence, each line in\nthe address is separated by a newline character.", +"readOnly": true, +"type": "string" +}, +"availabilityZone": { +"description": "[Output Only] Availability zone for this InterconnectLocation. Within a\nmetropolitan area (metro), maintenance will not be simultaneously scheduled\nin more than one availability zone. Example: \"zone1\" or \"zone2\".", +"type": "string" +}, +"availableFeatures": { +"description": "[Output only] List of features available at this InterconnectLocation,\nwhich can take one of the following values:\n \n - IF_MACSEC\n - IF_CROSS_SITE_NETWORK", +"items": { +"enum": [ +"IF_CROSS_SITE_NETWORK", +"IF_L2_FORWARDING", +"IF_MACSEC" +], +"enumDescriptions": [ +"Cross-Site Networking", +"L2 Interconnect Attachment Forwarding", +"Media Access Control security (MACsec)" +], +"type": "string" +}, +"type": "array" +}, +"availableLinkTypes": { +"description": "[Output only] List of link types available at this InterconnectLocation,\nwhich can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR\n - LINK_TYPE_ETHERNET_100G_LR\n - LINK_TYPE_ETHERNET_400G_LR4", +"items": { +"enum": [ +"LINK_TYPE_ETHERNET_100G_LR", +"LINK_TYPE_ETHERNET_10G_LR", +"LINK_TYPE_ETHERNET_400G_LR4" +], +"enumDescriptions": [ +"100G Ethernet, LR Optics.", +"10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", +"400G Ethernet, LR4 Optics." +], +"type": "string" +}, +"type": "array" +}, +"city": { +"description": "[Output Only] Metropolitan area designator that indicates which city an\ninterconnect is located.\nFor example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", +"type": "string" +}, +"continent": { +"description": "[Output Only] Continent for this location, which can take one of the\nfollowing values:\n \n - AFRICA\n - ASIA_PAC\n - EUROPE\n - NORTH_AMERICA\n - SOUTH_AMERICA", +"enum": [ +"AFRICA", +"ASIA_PAC", +"C_AFRICA", +"C_ASIA_PAC", +"C_EUROPE", +"C_NORTH_AMERICA", +"C_SOUTH_AMERICA", +"EUROPE", +"NORTH_AMERICA", +"SOUTH_AMERICA" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"crossSiteInterconnectInfos": { +"description": "[Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo\nobjects, that describe where Cross-Site Interconnect wires may connect to\nfrom this location and associated connection parameters. Cross-Site\nInterconnect isn't allowed to locations which are not listed.", +"items": { +"$ref": "InterconnectLocationCrossSiteInterconnectInfo" +}, +"type": "array" +}, +"description": { +"description": "Output only. [Output Only] An optional description of the resource.", +"readOnly": true, +"type": "string" +}, +"facilityProvider": { +"description": "Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).", +"readOnly": true, +"type": "string" +}, +"facilityProviderFacilityId": { +"description": "Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,\nAshburn-DC1).", +"readOnly": true, +"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#interconnectLocation", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] Name of the resource.", +"readOnly": true, +"type": "string" +}, +"peeringdbFacilityId": { +"description": "Output only. [Output Only] The peeringdb identifier for this facility (corresponding\nwith a netfac type in peeringdb).", +"readOnly": true, +"type": "string" +}, +"regionInfos": { +"description": "Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that\ndescribe parameters pertaining to the relation between this\nInterconnectLocation and various Google Cloud regions.", +"items": { +"$ref": "InterconnectLocationRegionInfo" +}, +"readOnly": true, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"singleRegionProductionCriticalPeerLocations": { +"description": "Output only. [Output Only] URLs of the other locations that can pair up with this\nlocation to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and\niad-zone2-5467 are Single-Region 99.99% peer locations of each other.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"status": { +"description": "[Output Only] The status of this InterconnectLocation, which can take one\nof the following values:\n \n - CLOSED: The InterconnectLocation is closed and is unavailable for\n provisioning new Interconnects.\n - AVAILABLE: The InterconnectLocation is available for provisioning new\n Interconnects.", +"enum": [ +"AVAILABLE", +"CLOSED" +], +"enumDescriptions": [ +"The InterconnectLocation is available for provisioning new Interconnects.", +"The InterconnectLocation is closed for provisioning new Interconnects." +], +"type": "string" +}, +"supportsPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +} +}, +"type": "object" +}, +"InterconnectLocationCrossSiteInterconnectInfo": { +"description": "Information about Cross-Site Interconnect wires which may be created\nbetween the containing location and another remote location.", +"id": "InterconnectLocationCrossSiteInterconnectInfo", +"properties": { +"city": { +"description": "Output only. The remote location for Cross-Site Interconnect wires. This specifies an\nInterconnectLocation city (metropolitan area designator), which itself\nmay match multiple InterconnectLocations.", +"readOnly": true, +"type": "string" +}, +"maxDynamicPathBandwidthGbps": { +"description": "Output only. The maximum unmetered bandwidth for dynamic paths allowable per\nWireGroup for this metro.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"maxFixedPathBandwidthGbps": { +"description": "Output only. The maximum unmetered bandwidth for fixed paths allowable per WireGroup\nfor this metro.", +"format": "int64", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectLocationList": { +"description": "Response to the list request, and contains a list of interconnect locations.", +"id": "InterconnectLocationList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InterconnectLocation resources.", +"items": { +"$ref": "InterconnectLocation" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectLocationList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect\nlocations.", +"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.", +"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" +}, +"InterconnectLocationRegionInfo": { +"description": "Information about any potential InterconnectAttachments between an\nInterconnect at a specific InterconnectLocation, and a specific Cloud\nRegion.", +"id": "InterconnectLocationRegionInfo", +"properties": { +"expectedRttMs": { +"description": "Output only. Expected round-trip time in milliseconds, from this InterconnectLocation\nto a VM in this region.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"l2ForwardingEnabled": { +"description": "Output only. Identifies whether L2 Interconnect Attachments can be created in this\nregion for interconnects that are in this location.", +"readOnly": true, +"type": "boolean" +}, +"locationPresence": { +"description": "Output only. Identifies the network presence of this location.", +"enum": [ +"GLOBAL", +"LOCAL_REGION", +"LP_GLOBAL", +"LP_LOCAL_REGION" +], +"enumDescriptions": [ +"This region is not in any common network presence with this\nInterconnectLocation.", +"This region shares the same regional network presence as this\nInterconnectLocation.", +"[Deprecated] This region is not in any common network presence with\nthis InterconnectLocation.", +"[Deprecated] This region shares the same regional network presence as\nthis InterconnectLocation." +], +"readOnly": true, +"type": "string" +}, +"region": { +"description": "Output only. URL for the region of this location.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectMacsec": { +"description": "Configuration information for enabling Media Access Control security\n(MACsec) on this Cloud Interconnect connection between Google and your\non-premises router.", +"id": "InterconnectMacsec", +"properties": { +"failOpen": { +"description": "If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google\nrouter to fallback to cleartext traffic if the MKA session cannot be\nestablished. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the\nMKA session cannot be established with your router.", +"type": "boolean" +}, +"preSharedKeys": { +"description": "Required. A keychain placeholder describing a set of named key objects\nalong with their start times. A MACsec CKN/CAK is generated for each\nkey in the key chain. Google router automatically picks the key with\nthe most recent startTime when establishing or re-establishing a MACsec\nsecure link.", +"items": { +"$ref": "InterconnectMacsecPreSharedKey" +}, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectMacsecConfig": { +"description": "MACsec configuration information for the Interconnect connection. Contains\nthe generated Connectivity Association Key Name (CKN) and the key (CAK) for\nthis Interconnect connection.", +"id": "InterconnectMacsecConfig", +"properties": { +"preSharedKeys": { +"description": "A keychain placeholder describing a set of named key objects\nalong with their start times. A MACsec CKN/CAK is generated for each key in\nthe key chain. Google router automatically picks the key with the most\nrecent startTime when establishing or re-establishing a MACsec secure link.", +"items": { +"$ref": "InterconnectMacsecConfigPreSharedKey" +}, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectMacsecConfigPreSharedKey": { +"description": "Describes a pre-shared key used to setup MACsec in static connectivity\nassociation key (CAK) mode.", +"id": "InterconnectMacsecConfigPreSharedKey", +"properties": { +"cak": { +"description": "An auto-generated Connectivity Association Key (CAK) for this key.", +"type": "string" +}, +"ckn": { +"description": "An auto-generated Connectivity Association Key Name (CKN) for this key.", +"type": "string" +}, +"name": { +"description": "User provided name for this pre-shared key.", +"type": "string" +}, +"startTime": { +"description": "User provided timestamp on or after which this key is valid.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectMacsecPreSharedKey": { +"description": "Describes a pre-shared key used to setup MACsec in static connectivity\nassociation key (CAK) mode.", +"id": "InterconnectMacsecPreSharedKey", +"properties": { +"name": { +"description": "Required. A name for this pre-shared key.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be\na dash.", +"type": "string" +}, +"startTime": { +"description": "A RFC3339 timestamp on or after which the key is\nvalid. startTime can be in the future. If the keychain has a single\nkey, startTime can be omitted. If the keychain has multiple keys,\nstartTime is mandatory for each key. The start times of keys must be in\nincreasing order. The start times of two consecutive keys must be\nat least 6 hours apart.", +"type": "string" +} +}, +"type": "object" +}, +"InterconnectOutageNotification": { +"description": "Description of a planned outage on this Interconnect.", +"id": "InterconnectOutageNotification", +"properties": { +"affectedCircuits": { +"description": "If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit\nIDs that will be affected.", +"items": { +"type": "string" +}, +"type": "array" +}, +"description": { +"description": "A description about the purpose of the outage.", +"type": "string" +}, +"endTime": { +"description": "Scheduled end time for the outage (milliseconds since Unix\nepoch).", +"format": "int64", +"type": "string" +}, +"issueType": { +"description": "Form this outage is expected to take, which can take one of the following\nvalues:\n \n - OUTAGE: The Interconnect may be completely out of service for\n some or all of the specified window.\n - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole\n should remain up, but with reduced bandwidth.\n\n\nNote that the versions of this enum prefixed with \"IT_\" have been\ndeprecated in favor of the unprefixed values.", +"enum": [ +"IT_OUTAGE", +"IT_PARTIAL_OUTAGE", +"OUTAGE", +"PARTIAL_OUTAGE" +], +"enumDescriptions": [ +"[Deprecated] The Interconnect may be completely out of service for some\nor all of the specified window.", +"[Deprecated] Some circuits comprising the Interconnect will be out of\nservice during the expected window. The interconnect as a whole should\nremain up, albeit with reduced bandwidth.", +"The Interconnect may be completely out of service for some or all of\nthe specified window.", +"Some circuits comprising the Interconnect will be out of service during\nthe expected window. The interconnect as a whole should remain\nup, albeit with reduced bandwidth." +], +"type": "string" +}, +"name": { +"description": "Unique identifier for this outage notification.", +"type": "string" +}, +"source": { +"description": "The party that generated this notification, which can take the following\nvalue:\n \n - GOOGLE: this notification as generated by Google.\n\n\nNote that the value of NSRC_GOOGLE has been deprecated in favor of\nGOOGLE.", +"enum": [ +"GOOGLE", +"NSRC_GOOGLE" +], +"enumDescriptions": [ +"This notification was generated by Google.", +"[Deprecated] This notification was generated by Google." +], +"type": "string" +}, +"startTime": { +"description": "Scheduled start time for the outage (milliseconds since Unix\nepoch).", +"format": "int64", +"type": "string" +}, +"state": { +"description": "State of this notification, which can take one of the following values:\n \n - ACTIVE: This outage notification is active. The event could be in\n the past, present, or future. See start_time and end_time for\n scheduling.\n - CANCELLED: The outage associated with this notification was cancelled\n before the outage was due to start.\n - COMPLETED: The outage associated with this notification is complete.\n\n\nNote that the versions of this enum prefixed with \"NS_\" have been\ndeprecated in favor of the unprefixed values.", +"enum": [ +"ACTIVE", +"CANCELLED", +"COMPLETED", +"NS_ACTIVE", +"NS_CANCELED" +], +"enumDescriptions": [ +"This outage notification is active. The event could be in the future,\npresent, or past. See start_time and end_time for scheduling.", +"The outage associated with this notification was cancelled before the\noutage was due to start.", +"The outage associated with this notification is complete.", +"[Deprecated] This outage notification is active. The event could be in\nthe future, present, or past. See start_time and end_time for\nscheduling.", +"[Deprecated] The outage associated with this notification was canceled\nbefore the outage was due to start." +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectParams": { +"description": "Additional interconnect parameters.", +"id": "InterconnectParams", +"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" +}, +"InterconnectRemoteLocation": { +"description": "Represents a Cross-Cloud Interconnect Remote Location resource.\n\nYou can use this resource to find remote location details about an\nInterconnect attachment (VLAN).", +"id": "InterconnectRemoteLocation", +"properties": { +"address": { +"description": "Output only. [Output Only] The postal address of the Point of Presence, each line in\nthe address is separated by a newline character.", +"readOnly": true, +"type": "string" +}, +"attachmentConfigurationConstraints": { +"$ref": "InterconnectAttachmentConfigurationConstraints", +"description": "Output only. [Output Only] Subset of fields from InterconnectAttachment's\n|configurationConstraints| field that apply to all attachments for this\nremote location.", +"readOnly": true +}, +"city": { +"description": "Output only. [Output Only] Metropolitan area designator that indicates which city an\ninterconnect is located.\nFor example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", +"readOnly": true, +"type": "string" +}, +"constraints": { +"$ref": "InterconnectRemoteLocationConstraints", +"description": "Output only. [Output Only] Constraints on the parameters for creating Cross-Cloud\nInterconnect and associated InterconnectAttachments.", +"readOnly": true +}, +"continent": { +"description": "Output only. [Output Only] Continent for this location, which can take one of the\nfollowing values:\n \n - AFRICA\n - ASIA_PAC\n - EUROPE\n - NORTH_AMERICA\n - SOUTH_AMERICA", +"enum": [ +"AFRICA", +"ASIA_PAC", +"EUROPE", +"NORTH_AMERICA", +"SOUTH_AMERICA" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. [Output Only] An optional description of the resource.", +"readOnly": true, +"type": "string" +}, +"facilityProvider": { +"description": "Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).", +"readOnly": true, +"type": "string" +}, +"facilityProviderFacilityId": { +"description": "Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,\nAshburn-DC1).", +"readOnly": true, +"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#interconnectRemoteLocation", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote\nlocations.", +"readOnly": true, +"type": "string" +}, +"lacp": { +"description": "Output only. [Output Only] Link Aggregation Control Protocol (LACP) constraints, which\ncan take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED", +"enum": [ +"LACP_SUPPORTED", +"LACP_UNSUPPORTED" +], +"enumDescriptions": [ +"LACP_SUPPORTED: LACP is supported, and enabled by default on\nthe Cross-Cloud Interconnect.", +"LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this\nport. GetDiagnostics shows bundleAggregationType as \"static\". GCP does\nnot support LAGs without LACP, so requestedLinkCount must be 1." +], +"readOnly": true, +"type": "string" +}, +"maxLagSize100Gbps": { +"description": "Output only. [Output Only]\nThe maximum number of 100 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_100_gbps.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"maxLagSize10Gbps": { +"description": "Output only. [Output Only]\nThe maximum number of 10 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_10_gbps.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"maxLagSize400Gbps": { +"description": "Output only. [Output Only]\nThe maximum number of 400 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_400_gbps.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"name": { +"description": "Output only. [Output Only] Name of the resource.", +"readOnly": true, +"type": "string" +}, +"peeringdbFacilityId": { +"description": "Output only. [Output Only] The peeringdb identifier for this facility (corresponding\nwith a netfac type in peeringdb).", +"readOnly": true, +"type": "string" +}, +"permittedConnections": { +"description": "Output only. [Output Only] Permitted connections.", +"items": { +"$ref": "InterconnectRemoteLocationPermittedConnections" +}, +"readOnly": true, +"type": "array" +}, +"remoteService": { +"description": "Output only. [Output Only] Indicates the service provider present at the remote\nlocation. Example values: \"Amazon Web Services\", \"Microsoft Azure\".", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of this InterconnectRemoteLocation, which can take\none of the following values:\n \n - CLOSED: The InterconnectRemoteLocation is closed and is unavailable\n for provisioning new Cross-Cloud Interconnects. \n - AVAILABLE: The\n InterconnectRemoteLocation is available for provisioning new\n Cross-Cloud Interconnects.", +"enum": [ +"AVAILABLE", +"CLOSED" +], +"enumDescriptions": [ +"The InterconnectRemoteLocation is available for provisioning new\nCross-Cloud Interconnects.", +"The InterconnectRemoteLocation is closed for provisioning new\nCross-Cloud Interconnects." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectRemoteLocationConstraints": { +"id": "InterconnectRemoteLocationConstraints", +"properties": { +"portPairRemoteLocation": { +"description": "Output only. [Output Only] Port pair remote location constraints, which can take one\nof the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION,\nPORT_PAIR_MATCHING_REMOTE_LOCATION.\n\nGoogle Cloud API refers only to individual ports, but the UI uses this\nfield when ordering a pair of ports, to prevent users from accidentally\nordering something that is incompatible with their cloud provider.\nSpecifically, when ordering a redundant pair of Cross-Cloud Interconnect\nports, and one of them uses a remote location with\nportPairMatchingRemoteLocation set to matching, the UI requires that\nboth ports use the same remote location.", +"enum": [ +"PORT_PAIR_MATCHING_REMOTE_LOCATION", +"PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION" +], +"enumDescriptions": [ +"If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider\nallocates ports in pairs, and the user should choose the same remote\nlocation for both ports.", +"If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision\na redundant pair of Cross-Cloud Interconnects using two different\nremote locations in the same city." +], +"readOnly": true, +"type": "string" +}, +"portPairVlan": { +"description": "Output only. [Output Only] Port pair VLAN constraints, which can take one of the\nfollowing values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN", +"enum": [ +"PORT_PAIR_MATCHING_VLAN", +"PORT_PAIR_UNCONSTRAINED_VLAN" +], +"enumDescriptions": [ +"If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is\npart of a pair of ports that should have matching VLAN allocations.\nThis occurs with Cross-Cloud Interconnect to Azure remote locations.\nWhile GCP's API does not explicitly group pairs of ports, the UI uses\nthis field to ensure matching VLAN ids when configuring a redundant\nVLAN pair.", +"PORT_PAIR_UNCONSTRAINED_VLAN means there is no constraint." +], +"readOnly": true, +"type": "string" +}, +"subnetLengthRange": { +"$ref": "InterconnectRemoteLocationConstraintsSubnetLengthRange", +"description": "Output only. [Output Only]\n\n[min-length, max-length] \n\nThe minimum and maximum value (inclusive) for the IPv4 subnet\nlength.\n\n For example, an interconnectRemoteLocation for Azure has {min: 30,\nmax:\n30} because Azure requires /30 subnets. \n\nThis range specifies the values supported by both cloud providers.\nInterconnect currently supports /29 and /30 IPv4 subnet lengths. If a\nremote cloud has no constraint on IPv4 subnet length, the range would\nthus be {min: 29, max: 30}.", +"readOnly": true +} +}, +"type": "object" +}, +"InterconnectRemoteLocationConstraintsSubnetLengthRange": { +"id": "InterconnectRemoteLocationConstraintsSubnetLengthRange", +"properties": { +"max": { +"format": "int32", +"type": "integer" +}, +"min": { +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"InterconnectRemoteLocationList": { +"description": "Response to the list request, and contains a list of interconnect remote\nlocations.", +"id": "InterconnectRemoteLocationList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InterconnectRemoteLocation resources.", +"items": { +"$ref": "InterconnectRemoteLocation" +}, +"type": "array" +}, +"kind": { +"default": "compute#interconnectRemoteLocationList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of\ninterconnect remote locations.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token lets you 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.", +"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" +}, +"InterconnectRemoteLocationPermittedConnections": { +"id": "InterconnectRemoteLocationPermittedConnections", +"properties": { +"interconnectLocation": { +"description": "Output only. [Output Only] URL of an Interconnect location that is permitted to\nconnect to this Interconnect remote location.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"InterconnectsGetDiagnosticsResponse": { +"description": "Response for the InterconnectsGetDiagnosticsRequest.", +"id": "InterconnectsGetDiagnosticsResponse", +"properties": { +"result": { +"$ref": "InterconnectDiagnostics" +} +}, +"type": "object" +}, +"InterconnectsGetMacsecConfigResponse": { +"description": "Response for the InterconnectsGetMacsecConfigRequest.", +"id": "InterconnectsGetMacsecConfigResponse", +"properties": { +"etag": { +"description": "end_interface: MixerGetResponseWithEtagBuilder", +"type": "string" +}, +"result": { +"$ref": "InterconnectMacsecConfig" +} +}, +"type": "object" +}, +"Interval": { +"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a\nTimestamp end (exclusive).\n\nThe start must be less than or equal to the end.\nWhen the start equals the end, the interval is empty (matches no time).\nWhen both start and end are unspecified, the interval matches any time.", +"id": "Interval", +"properties": { +"endTime": { +"description": "Optional. Exclusive end of the interval.\n\nIf specified, a Timestamp matching this interval will have to be before the\nend.", +"format": "google-datetime", +"type": "string" +}, +"startTime": { +"description": "Optional. Inclusive start of the interval.\n\nIf specified, a Timestamp matching this interval will have to be the same\nor after the start.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"License": { +"description": "Represents a License resource.\n\nA License represents billing and aggregate usage data forpublic andmarketplace images.\n *Caution* This resource is intended for\nuse only by third-party partners who are creatingCloud Marketplace\nimages.", +"id": "License", +"properties": { +"allowedReplacementLicenses": { +"description": "Specifies licenseCodes of licenses that can replace this license. Note:\nsuch replacements are allowed even if removable_from_disk is false.", +"items": { +"type": "string" +}, +"type": "array" +}, +"appendableToDisk": { +"description": "If true, this license can be appended to an existing disk's set of\nlicenses.", +"type": "boolean" +}, +"chargesUseFee": { +"description": "[Output Only] Deprecated. This field no longer reflects whether a license\ncharges a usage fee.", +"type": "boolean" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional textual description of the resource; provided by the client\nwhen the resource is created.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"incompatibleLicenses": { +"description": "Specifies licenseCodes of licenses that are incompatible with this license.\nIf a license is incompatible with this license, it cannot be attached to\nthe same disk or image.", +"items": { +"type": "string" +}, +"type": "array" +}, +"kind": { +"default": "compute#license", +"description": "Output only. [Output Only] Type of resource. Always compute#license for\nlicenses.", +"readOnly": true, +"type": "string" +}, +"licenseCode": { +"description": "[Output Only] The unique code used to attach this license to images,\nsnapshots, and disks.", +"format": "uint64", +"type": "string" +}, +"minimumRetention": { +"$ref": "Duration", +"description": "If set, this license will be unable to be removed or replaced once attached\nto a disk until the minimum_retention period has passed." +}, +"multiTenantOnly": { +"description": "If true, this license can only be used on VMs on multi tenant nodes.", +"type": "boolean" +}, +"name": { +"annotations": { +"required": [ +"compute.images.insert" +] +}, +"description": "Name of the resource. The name must be 1-63 characters long and\ncomply withRFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"osLicense": { +"description": "If true, indicates this is an OS license. Only one OS license can be\nattached to a disk or image at a time.", +"type": "boolean" +}, +"params": { +"$ref": "LicenseParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"removableFromDisk": { +"description": "If true, this license can be removed from a disk's set of licenses, with no\nreplacement license needed.", +"type": "boolean" +}, +"requiredCoattachedLicenses": { +"description": "Specifies the set of permissible coattached licenseCodes of licenses that\nsatisfy the coattachment requirement of this license. At least one license\nfrom the set must be attached to the same disk or image as this license.", +"items": { +"type": "string" +}, +"type": "array" +}, +"resourceRequirements": { +"$ref": "LicenseResourceRequirements", +"description": "[Input Only] Deprecated." +}, +"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 with the resource id.", +"readOnly": true, +"type": "string" +}, +"soleTenantOnly": { +"description": "If true, this license can only be used on VMs on sole tenant nodes.", +"type": "boolean" +}, +"transferable": { +"description": "If false, licenses will not be copied from the source resource when\ncreating an image from a disk, disk from snapshot, or snapshot from disk.", +"type": "boolean" +}, +"updateTimestamp": { +"description": "Output only. [Output Only] Last update timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"LicenseCode": { +"description": "Represents a License Code resource.\n\nA License Code is a unique identifier used to represent alicense\nresource.\n *Caution* This resource is intended for\nuse only by third-party partners who are creatingCloud Marketplace\nimages.", +"id": "LicenseCode", +"properties": { +"allowedReplacementLicenses": { +"description": "Specifies licenseCodes of licenses that can replace this license. Note:\nsuch replacements are allowed even if removable_from_disk is false.", +"items": { +"type": "string" +}, +"type": "array" +}, +"appendableToDisk": { +"description": "If true, this license can be appended to an existing disk's set of\nlicenses.", +"type": "boolean" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. [Output Only] Description of this License Code.", +"readOnly": true, +"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" +}, +"incompatibleLicenses": { +"description": "Specifies licenseCodes of licenses that are incompatible with this license.\nIf a license is incompatible with this license, it cannot be attached to\nthe same disk or image.", +"items": { +"type": "string" +}, +"type": "array" +}, +"kind": { +"default": "compute#licenseCode", +"description": "Output only. [Output Only] Type of resource. Always compute#licenseCode for\nlicenses.", +"readOnly": true, +"type": "string" +}, +"licenseAlias": { +"description": "[Output Only] URL and description aliases of Licenses with the same\nLicense Code.", +"items": { +"$ref": "LicenseCodeLicenseAlias" +}, +"type": "array" +}, +"minimumRetention": { +"$ref": "Duration", +"description": "If set, this license will be unable to be removed or replaced once attached\nto a disk until the minimum_retention period has passed." +}, +"multiTenantOnly": { +"description": "If true, this license can only be used on VMs on multi tenant nodes.", +"type": "boolean" +}, +"name": { +"annotations": { +"required": [ +"compute.licenses.insert" +] +}, +"description": "Output only. [Output Only] Name of the resource. The name is 1-20 characters long and\nmust be a valid 64 bit integer.", +"pattern": "[0-9]{0,20}?", +"readOnly": true, +"type": "string" +}, +"osLicense": { +"description": "If true, indicates this is an OS license. Only one OS license can be\nattached to a disk or image at a time.", +"type": "boolean" +}, +"removableFromDisk": { +"description": "If true, this license can be removed from a disk's set of licenses, with no\nreplacement license needed.", +"type": "boolean" +}, +"requiredCoattachedLicenses": { +"description": "Specifies the set of permissible coattached licenseCodes of licenses that\nsatisfy the coattachment requirement of this license. At least one license\nfrom the set must be attached to the same disk or image as this license.", +"items": { +"type": "string" +}, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"soleTenantOnly": { +"description": "If true, this license can only be used on VMs on sole tenant nodes.", +"type": "boolean" +}, +"state": { +"description": "Output only. [Output Only] Current state of this License Code.", +"enum": [ +"DISABLED", +"ENABLED", +"RESTRICTED", +"STATE_UNSPECIFIED", +"TERMINATED" +], +"enumDescriptions": [ +"Machines are not allowed to attach boot disks with this License Code.\nRequests to create new resources with this license will be rejected.", +"Use is allowed for anyone with USE_READ_ONLY access to this License Code.", +"Use of this license is limited to a project whitelist.", +"", +"Reserved state." +], +"readOnly": true, +"type": "string" +}, +"transferable": { +"description": "Output only. [Output Only] If true, the license will remain attached when creating\nimages or snapshots from disks. Otherwise, the license is not transferred.", +"readOnly": true, +"type": "boolean" +}, +"updateTimestamp": { +"description": "Output only. [Output Only] Last update timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"LicenseCodeLicenseAlias": { +"id": "LicenseCodeLicenseAlias", +"properties": { +"description": { +"description": "Output only. [Output Only] Description of this License Code.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] URL of license corresponding to this License Code.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"LicenseParams": { +"description": "Additional license params.", +"id": "LicenseParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the license. 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/{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" +}, +"LicenseResourceCommitment": { +"description": "Commitment for a particular license resource.", +"id": "LicenseResourceCommitment", +"properties": { +"amount": { +"description": "The number of licenses you plan to purchase.", +"format": "int64", +"type": "string" +}, +"coresPerLicense": { +"description": "The number of cores per license.", +"type": "string" +}, +"license": { +"description": "The applicable license URI.", +"type": "string" +} +}, +"type": "object" +}, +"LicenseResourceRequirements": { +"id": "LicenseResourceRequirements", +"properties": { +"minGuestCpuCount": { +"description": "[Input Only] Deprecated. This field no longer reflects the minimum number\nof guest cpus required to use the Instance.", +"format": "int32", +"type": "integer" +}, +"minMemoryMb": { +"description": "[Input Only] Deprecated. This field no longer reflects the minimum memory\nrequired to use the Instance.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"LicensesListResponse": { +"id": "LicensesListResponse", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of License resources.", +"items": { +"$ref": "License" +}, +"type": "array" +}, +"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.", +"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" +}, +"ListInstantSnapshotGroups": { +"description": "Contains a list of InstantSnapshotGroup resources.", +"id": "ListInstantSnapshotGroups", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of InstantSnapshotGroup resources.", +"items": { +"$ref": "InstantSnapshotGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#instantSnapshotGroupsList", +"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": { +"diskCount": { +"description": "Specifies the number of such disks.", +"format": "int32", +"type": "integer" +}, +"diskSizeGb": { +"description": "Specifies the size of the disk in base-2 GB.", +"format": "int32", +"type": "integer" +}, +"diskType": { +"description": "Specifies the desired disk type on the node. This disk type must be a\nlocal storage type (e.g.: local-ssd).\nNote that for nodeTemplates, this should be the name of the disk type and\nnot its URL.", +"type": "string" +} +}, +"type": "object" +}, +"LocalizedMessage": { +"description": "Provides a localized error message that is safe to return to the user\nwhich can be attached to an RPC error.", +"id": "LocalizedMessage", +"properties": { +"locale": { +"description": "The locale used following the specification defined at\nhttps://www.rfc-editor.org/rfc/bcp/bcp47.txt.\nExamples are: \"en-US\", \"fr-CH\", \"es-MX\"", +"type": "string" +}, +"message": { +"description": "The localized error message in the above locale.", +"type": "string" +} +}, +"type": "object" +}, +"LocationPolicy": { +"description": "Configuration for location policy among multiple possible locations\n(e.g. preferences for zone selection among zones in a single region).", +"id": "LocationPolicy", +"properties": { +"locations": { +"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.\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": { +"description": "Strategy for distributing VMs across zones in a region.", +"enum": [ +"ANY", +"ANY_SINGLE_ZONE", +"BALANCED" +], +"enumDescriptions": [ +"GCE picks zones for creating VM instances to fulfill the requested\nnumber of VMs within present resource constraints and to maximize\nutilization of unused zonal reservations. Recommended for batch workloads\nthat do not require high availability.", +"GCE always selects a single zone for all the VMs, optimizing for resource\nquotas, available reservations and general capacity. Recommended for\nbatch workloads that cannot tollerate distribution over multiple zones.\nThis the default shape in Bulk Insert and Capacity Advisor APIs.", +"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" +}, +"LocationPolicyLocation": { +"id": "LocationPolicyLocation", +"properties": { +"constraints": { +"$ref": "LocationPolicyLocationConstraints", +"description": "Constraints that the caller requires on the result distribution\nin this zone." +}, +"preference": { +"description": "Preference for a given location. Set to either ALLOW orDENY.", +"enum": [ +"ALLOW", +"DENY", +"PREFERENCE_UNSPECIFIED" +], +"enumDescriptions": [ +"Location is allowed for use.", +"Location is prohibited.", +"Default value, unused." +], +"type": "string" +} +}, +"type": "object" +}, +"LocationPolicyLocationConstraints": { +"description": "Per-zone constraints on location policy for this zone.", +"id": "LocationPolicyLocationConstraints", +"properties": { +"maxCount": { +"description": "Maximum number of items that are allowed to be placed in this zone.\nThe value must be non-negative.", +"format": "int32", +"type": "integer" +} +}, +"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", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] The creation timestamp for this machine image 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" +}, +"guestFlush": { +"description": "[Input Only] Whether to attempt an application consistent machine image by\ninforming the OS to prepare for the snapshot process.", +"type": "boolean" +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this machine image. The server\ndefines this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"instanceProperties": { +"$ref": "InstanceProperties", +"description": "[Output Only] Properties of source instance" +}, +"kind": { +"default": "compute#machineImage", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this machine image, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\nmachine image.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this machine image. These can be later modified by\nthe setLabels method.", +"type": "object" +}, +"machineImageEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Encrypts the machine image using acustomer-supplied\nencryption key.\n\nAfter you encrypt a machine image using a customer-supplied key, you must\nprovide the same key if you use the machine image later. For example, you\nmust provide the encryption key when you create an instance from the\nencrypted machine image in a future request.\n\nCustomer-supplied encryption keys do not protect access to metadata of the\nmachine image.\n\nIf you do not provide an encryption key when creating the machine image,\nthen the machine image will be encrypted using an automatically generated\nkey and you do not need to provide a key to use the machine image later." +}, +"name": { +"annotations": { +"required": [ +"compute.machineImages.insert" +] +}, +"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 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" +}, +"params": { +"$ref": "MachineImageParams", +"description": "Input only. [Input Only] Additional parameters that are passed in the request, but are\nnot persisted in the resource." +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"savedDisks": { +"description": "Output only. An array of Machine Image specific properties for disks attached to the\nsource instance", +"items": { +"$ref": "SavedDisk" +}, +"readOnly": true, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] The URL for this machine image. The server defines this URL.", +"readOnly": true, +"type": "string" +}, +"sourceDiskEncryptionKeys": { +"description": "[Input Only] Thecustomer-supplied\nencryption key of the disks attached to the source instance. Required\nif the source disk is protected by a customer-supplied encryption key.", +"items": { +"$ref": "SourceDiskEncryptionKey" +}, +"type": "array" +}, +"sourceInstance": { +"description": "The source instance used to create the machine image. You can provide this\nas a partial or full URL to the resource. For example, the following are\nvalid values: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance", +"type": "string" +}, +"sourceInstanceProperties": { +"$ref": "SourceInstanceProperties", +"description": "Output only. [Output Only] DEPRECATED: Please use instance_properties\ninstead for source instance related properties. New properties will not be\nadded to this field.", +"readOnly": true +}, +"status": { +"description": "Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY", +"UPLOADING" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"storageLocations": { +"description": "The regional or multi-regional Cloud Storage bucket location where themachine image is\nstored.", +"items": { +"type": "string" +}, +"type": "array" +}, +"totalStorageBytes": { +"description": "Output only. [Output Only] Total size of the storage used by the machine image.", +"format": "int64", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"MachineImageList": { +"description": "A list of machine images.", +"id": "MachineImageList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of MachineImage resources.", +"items": { +"$ref": "MachineImage" +}, +"type": "array" +}, +"kind": { +"default": "compute#machineImageList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists.", +"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.", +"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" +}, +"MachineImageParams": { +"description": "Machine Image parameters", +"id": "MachineImageParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the machine image. 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/{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" +}, +"MachineType": { +"description": "Represents a Machine Type resource.\n\nYou can use specific machine types for your VM instances based on performance\nand pricing requirements. For more information, readMachine Types.", +"id": "MachineType", +"properties": { +"accelerators": { +"description": "[Output Only] A list of accelerator configurations assigned to this\nmachine type.", +"items": { +"properties": { +"guestAcceleratorCount": { +"description": "Number of accelerator cards exposed to the guest.", +"format": "int32", +"type": "integer" +}, +"guestAcceleratorType": { +"description": "The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"architecture": { +"description": "[Output Only] The architecture of the machine type.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"type": "string" +}, +"bundledLocalSsds": { +"$ref": "BundledLocalSsds", +"description": "[Output Only] The configuration of bundled local SSD for the machine type." +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this machine type.\nOnly applicable if the machine type is unavailable." +}, +"description": { +"description": "[Output Only] An optional textual description of the resource.", +"type": "string" +}, +"guestCpus": { +"description": "[Output Only] The number of virtual CPUs that are available to the\ninstance.", +"format": "int32", +"type": "integer" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"imageSpaceGb": { +"description": "[Deprecated] This property is deprecated and will never be populated with\nany relevant values.", +"format": "int32", +"type": "integer" +}, +"isSharedCpu": { +"description": "[Output Only] Whether this machine type has a shared CPU. SeeShared-core machine\ntypes for more information.", +"type": "boolean" +}, +"kind": { +"default": "compute#machineType", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.", +"readOnly": true, +"type": "string" +}, +"maximumPersistentDisks": { +"description": "[Output Only] Maximum persistent disks allowed.", +"format": "int32", +"type": "integer" +}, +"maximumPersistentDisksSizeGb": { +"description": "[Output Only] Maximum total persistent disks size (GB) allowed.", +"format": "int64", +"type": "string" +}, +"memoryMb": { +"description": "[Output Only] The amount of physical memory available to the instance,\ndefined in MB.", +"format": "int32", +"type": "integer" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"zone": { +"description": "[Output Only] The name of the zone where the machine type resides,\nsuch as us-central1-a.", +"type": "string" +} +}, +"type": "object" +}, +"MachineTypeAggregatedList": { +"id": "MachineTypeAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "MachineTypesScopedList", +"description": "[Output Only] Name of the scope containing this set of machine types." +}, +"description": "A list of MachineTypesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#machineTypeAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of\nmachine types.", +"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" +}, +"MachineTypeList": { +"description": "Contains a list of machine types.", +"id": "MachineTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of MachineType resources.", +"items": { +"$ref": "MachineType" +}, +"type": "array" +}, +"kind": { +"default": "compute#machineTypeList", +"description": "Output only. [Output Only] Type of resource. Always compute#machineTypeList\nfor lists of machine types.", +"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.", +"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" +}, +"MachineTypesScopedList": { +"id": "MachineTypesScopedList", +"properties": { +"machineTypes": { +"description": "[Output Only] A list of machine types contained in this scope.", +"items": { +"$ref": "MachineType" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that appears when the machine types\nlist 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.", +"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" +}, +"ManagedInstance": { +"description": "A Managed Instance resource.", +"id": "ManagedInstance", +"properties": { +"currentAction": { +"description": "Output only. [Output Only] The current action that the managed instance group has\nscheduled for the instance. Possible values:\n \n - NONE The instance is running, and the managed\n instance group does not have any scheduled actions for this instance.\n - CREATING The managed instance group is creating this\n instance. If the group fails to create this instance, it will try again\n until it is successful.\n - CREATING_WITHOUT_RETRIES The managed instance group\n is attempting to create this instance only once. If the group fails\n to create this instance, it does not try again and the group'stargetSize value is decreased instead.\n - RECREATING The managed instance group is recreating\n this instance.\n - DELETING The managed instance group is permanently\n deleting this instance.\n - ABANDONING The managed instance group is abandoning\n this instance. The instance will be removed from the instance group\n and from any target pools that are associated with this group.\n - RESTARTING The managed instance group is restarting\n the instance.\n - REFRESHING The managed instance group is applying\n configuration changes to the instance without stopping it. For example,\n the group can update the target pool list for an instance without\n stopping that instance.\n - VERIFYING The managed instance group has created the\n instance and it is in the process of being verified.", +"enum": [ +"ABANDONING", +"CREATING", +"CREATING_WITHOUT_RETRIES", +"DELETING", +"NONE", +"RECREATING", +"REFRESHING", +"RESTARTING", +"RESUMING", +"STARTING", +"STOPPING", +"SUSPENDING", +"VERIFYING" +], +"enumDescriptions": [ +"The managed instance group is abandoning this instance. The instance\nwill be removed from the instance group and from any target pools that\nare associated with this group.", +"The managed instance group is creating this instance. If the group\nfails to create this instance, it will try again until it is\nsuccessful.", +"The managed instance group is attempting to create this instance\nonly once. If the group fails to create this instance, it does\nnot try again and the group's targetSize value is\ndecreased.", +"The managed instance group is permanently deleting this instance.", +"The managed instance group has not scheduled any actions for this\ninstance.", +"The managed instance group is recreating this instance.", +"The managed instance group is applying configuration changes to the\ninstance without stopping it. For example, the group can update the\ntarget pool list for an instance without stopping that instance.", +"The managed instance group is restarting this instance.", +"The managed instance group is resuming this instance.", +"The managed instance group is starting this instance.", +"The managed instance group is stopping this instance.", +"The managed instance group is suspending this instance.", +"The managed instance group is verifying this already created instance.\nVerification happens every time the instance is (re)created or restarted\nand consists of:\n 1. Waiting until health check specified as part of this managed instance\n group's autohealing policy reports HEALTHY.\n Note: Applies only if autohealing policy has a health check specified\n 2. Waiting for addition verification steps performed as post-instance\n creation (subject to future extensions)." +], +"readOnly": true, +"type": "string" +}, +"id": { +"description": "Output only. [Output only] The unique identifier for this resource. This field is empty\nwhen instance does not exist.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"instance": { +"description": "Output only. [Output Only] The URL of the instance. The URL can exist even if the\ninstance has not yet been created.", +"readOnly": true, +"type": "string" +}, +"instanceHealth": { +"description": "Output only. [Output Only] Health state of the instance per health-check.", +"items": { +"$ref": "ManagedInstanceInstanceHealth" +}, +"readOnly": true, +"type": "array" +}, +"instanceStatus": { +"description": "Output only. [Output Only] The status of the instance. This field is empty when\nthe instance does not exist.", +"enum": [ +"DEPROVISIONING", +"PENDING", +"PENDING_STOP", +"PROVISIONING", +"REPAIRING", +"RUNNING", +"STAGING", +"STOPPED", +"STOPPING", +"SUSPENDED", +"SUSPENDING", +"TERMINATED" +], +"enumDescriptions": [ +"The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", +"For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", +"The instance is gracefully shutting down.", +"Resources are being allocated for the instance.", +"The instance is in repair.", +"The instance is running.", +"All required resources have been allocated and the instance\nis being started.", +"The instance has stopped successfully.", +"The instance is currently stopping (either being deleted or killed).", +"The instance has suspended.", +"The instance is suspending.", +"The instance has stopped (either by explicit action or underlying\nfailure)." +], +"readOnly": true, +"type": "string" +}, +"lastAttempt": { +"$ref": "ManagedInstanceLastAttempt", +"description": "Output only. [Output Only] Information about the last attempt to create or delete\nthe instance.", +"readOnly": true +}, +"name": { +"description": "Output only. [Output Only] The name of the instance. The name always exists even if the\ninstance has not yet been created.", +"readOnly": true, +"type": "string" +}, +"preservedStateFromConfig": { +"$ref": "PreservedState", +"description": "Output only. [Output Only] Preserved state applied from per-instance config\nfor this instance.", +"readOnly": true +}, +"preservedStateFromPolicy": { +"$ref": "PreservedState", +"description": "Output only. [Output Only] Preserved state generated based on stateful policy\nfor this instance.", +"readOnly": true +}, +"propertiesFromFlexibilityPolicy": { +"$ref": "ManagedInstancePropertiesFromFlexibilityPolicy", +"description": "Output only. [Output Only] Instance properties selected for this instance resulting from\nInstanceFlexibilityPolicy.", +"readOnly": true +}, +"scheduling": { +"$ref": "ManagedInstanceScheduling", +"description": "Output only. Information about the termination timestamp of the instance, if applicable.", +"readOnly": true +}, +"shutdownDetails": { +"$ref": "ManagedInstanceShutdownDetails", +"description": "Output only. Specifies the graceful shutdown details if the instance is in\n`PENDING_STOP` state or there is a programmed stop scheduled.", +"readOnly": true +}, +"targetStatus": { +"description": "Output only. The eventual status of the instance. The instance group\nmanager will not be identified as stable till each managed instance reaches\nits targetStatus.", +"enum": [ +"ABANDONED", +"DELETED", +"INVALID", +"RUNNING", +"STOPPED", +"SUSPENDED" +], +"enumDescriptions": [ +"The managed instance will eventually be ABANDONED, i.e. dissociated\nfrom the managed instance group.", +"The managed instance will eventually be DELETED.", +"Only present to map the STATUS_INVALID value.", +"The managed instance will eventually reach status RUNNING.", +"The managed instance will eventually reach status TERMINATED.", +"The managed instance will eventually reach status SUSPENDED." +], +"readOnly": true, +"type": "string" +}, +"version": { +"$ref": "ManagedInstanceVersion", +"description": "Output only. [Output Only] Intended version of this instance.", +"readOnly": true +} +}, +"type": "object" +}, +"ManagedInstanceInstanceHealth": { +"id": "ManagedInstanceInstanceHealth", +"properties": { +"detailedHealthState": { +"description": "Output only. [Output Only] The current detailed instance health state.", +"enum": [ +"DRAINING", +"HEALTHY", +"TIMEOUT", +"UNHEALTHY", +"UNKNOWN" +], +"enumDescriptions": [ +"The instance is being drained. The existing connections to the instance\nhave time to complete, but the new ones are being refused.", +"The instance is reachable i.e. a connection to the application health\nchecking endpoint can be established, and conforms to the requirements\ndefined by the health check.", +"The instance is unreachable i.e. a connection to the application health\nchecking endpoint cannot be established, or the server does not respond\nwithin the specified timeout.", +"The instance is reachable, but does not conform to the requirements\ndefined by the health check.", +"The health checking system is aware of the instance but its health is\nnot known at the moment." +], +"readOnly": true, +"type": "string" +}, +"healthCheck": { +"description": "Output only. [Output Only] The URL for the health check that verifies whether the\ninstance is healthy.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ManagedInstanceLastAttempt": { +"id": "ManagedInstanceLastAttempt", +"properties": { +"errors": { +"description": "Output only. [Output Only] Encountered errors during the last attempt to create or\ndelete the instance.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"ManagedInstancePropertiesFromFlexibilityPolicy": { +"id": "ManagedInstancePropertiesFromFlexibilityPolicy", +"properties": { +"disks": { +"description": "List of disks to be attached to the instance.", +"items": { +"$ref": "AttachedDisk" +}, +"type": "array" +}, +"machineType": { +"description": "Output only. The machine type to be used for this instance.", +"readOnly": true, +"type": "string" +}, +"minCpuPlatform": { +"description": "Name of the minimum CPU platform to be used by this instance.\ne.g. 'Intel Ice Lake'.", +"type": "string" +} +}, +"type": "object" +}, +"ManagedInstanceScheduling": { +"id": "ManagedInstanceScheduling", +"properties": { +"gracefulShutdownTimestamp": { +"description": "Output only. The timestamp at which the underlying instance will be\ntriggered for graceful shutdown if it is configured. This is in RFC3339 text format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"terminationTimestamp": { +"description": "Output only. The timestamp at which the managed instance will be terminated. This is\nin RFC3339 text\nformat.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ManagedInstanceShutdownDetails": { +"id": "ManagedInstanceShutdownDetails", +"properties": { +"maxDuration": { +"$ref": "Duration", +"description": "Output only. The duration for graceful shutdown. Only applicable when the instance is\nin `PENDING_STOP` state.", +"readOnly": true +}, +"requestTimestamp": { +"description": "Output only. Past timestamp indicating the beginning of `PENDING_STOP` state of\ninstance in RFC3339\ntext format.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ManagedInstanceVersion": { +"id": "ManagedInstanceVersion", +"properties": { +"instanceTemplate": { +"description": "Output only. [Output Only] The intended template of the instance. This field is empty\nwhen current_action is one of { DELETING, ABANDONING }.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] Name of the version.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ManagedRuleset": { +"description": "Represents a ManagedRuleset resource.\n\nManaged internally by Cloud Armor CLH for Managed Rules features.\nCustomers can only view these resources to modify their Security Policies.\nFor more information, see\nhttps://cloud.google.com/armor/docs/.", +"id": "ManagedRuleset", +"properties": { +"changeLog": { +"description": "Output only. [Output Only] The change log for this managed ruleset.", +"readOnly": true, +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp in RFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "[Output Only] An optional description of this 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" +}, +"name": { +"description": "Name of the resource. Generated internally 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" +}, +"ruleIds": { +"description": "Output only. [Output Only] The list of managed rule IDs that are included in\nthis managed ruleset.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"rulesetId": { +"description": "Output only. [Output Only] The managed ruleset identifier that can be configured in\nSecurity Policy rules.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ManagedRulesetList": { +"id": "ManagedRulesetList", +"properties": { +"id": { +"type": "string" +}, +"items": { +"description": "The list of managed rulesets.", +"items": { +"$ref": "ManagedRuleset" +}, +"type": "array" +}, +"nextPageToken": { +"type": "string" +}, +"warning": { +"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" +}, +"Metadata": { +"description": "A metadata key/value entry.", +"id": "Metadata", +"properties": { +"fingerprint": { +"description": "Specifies a fingerprint for this request, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve the resource.", +"format": "byte", +"type": "string" +}, +"items": { +"description": "Array of key/value pairs. The total size of all keys and values must be\nless than 512 KB.", +"items": { +"description": "Metadata", +"properties": { +"key": { +"annotations": { +"required": [ +"compute.instances.insert", +"compute.projects.setCommonInstanceMetadata" +] +}, +"description": "Key for the metadata entry. Keys must conform to the following\nregexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.\nThis is reflected as part of a URL in the metadata server. Additionally, to\navoid ambiguity, keys must not conflict with any other metadata keys\nfor the project.", +"pattern": "[a-zA-Z0-9-_]{1,128}", +"type": "string" +}, +"value": { +"annotations": { +"required": [ +"compute.instances.insert", +"compute.projects.setCommonInstanceMetadata" +] +}, +"description": "Value for the metadata entry. These are free-form strings, and only\nhave meaning as interpreted by the image running in the instance. The\nonly restriction placed on values is that their size must be less than\nor equal to 262144 bytes (256 KiB).", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"kind": { +"default": "compute#metadata", +"description": "Output only. [Output Only] Type of the resource. Always compute#metadata\nfor metadata.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"MetadataFilter": { +"description": "Opaque filter criteria used by load balancers to restrict routing\nconfiguration to a limited set of load balancing proxies. Proxies and\nsidecars involved in load balancing would typically present metadata to the\nload balancers that need to match criteria specified here. If a match takes\nplace, the relevant configuration is made available to those\nproxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least\none of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata.\n\nAn example for using metadataFilters would be: if\nload balancing involves\nEnvoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.", +"id": "MetadataFilter", +"properties": { +"filterLabels": { +"description": "The list of label value pairs that must match labels in the provided\nmetadata based on filterMatchCriteria\n\nThis list must not be empty and can have at the most 64 entries.", +"items": { +"$ref": "MetadataFilterLabelMatch" +}, +"type": "array" +}, +"filterMatchCriteria": { +"description": "Specifies how individual filter label matches\nwithin the list of filterLabels and contributes toward the\noverall metadataFilter match.\n\n Supported values are:\n \n - MATCH_ANY: at least one of the filterLabels\n must have a matching label in the provided metadata.\n - MATCH_ALL: all filterLabels must have\n matching labels in the provided metadata.", +"enum": [ +"MATCH_ALL", +"MATCH_ANY", +"NOT_SET" +], +"enumDescriptions": [ +"Specifies that all filterLabels must match for themetadataFilter to be considered a match.", +"Specifies that any filterLabel must match for themetadataFilter to be considered a match.", +"Indicates that the match criteria was not set. AmetadataFilter must never be created with this value." +], +"type": "string" +} +}, +"type": "object" +}, +"MetadataFilterLabelMatch": { +"description": "MetadataFilter label name value pairs that are expected\nto match corresponding labels presented as metadata to the load balancer.", +"id": "MetadataFilterLabelMatch", +"properties": { +"name": { +"description": "Name of metadata label.\n\n The name can have a maximum length of 1024 characters and must be at\nleast 1 character long.", +"type": "string" +}, +"value": { +"description": "The value of the label must match the specified value.\n\nvalue can have a maximum length of 1024 characters.", +"type": "string" +} +}, +"type": "object" +}, +"Money": { +"description": "Represents an amount of money with its currency type.", +"id": "Money", +"properties": { +"currencyCode": { +"description": "The three-letter currency code defined in ISO 4217.", +"type": "string" +}, +"nanos": { +"description": "Number of nano (10^-9) units of the amount.\nThe value must be between -999,999,999 and +999,999,999 inclusive.\nIf `units` is positive, `nanos` must be positive or zero.\nIf `units` is zero, `nanos` can be positive, zero, or negative.\nIf `units` is negative, `nanos` must be negative or zero.\nFor example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", +"format": "int32", +"type": "integer" +}, +"units": { +"description": "The whole units of the amount.\nFor example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"NamedPort": { +"description": "The named port. For example: <\"http\", 80>.", +"id": "NamedPort", +"properties": { +"name": { +"description": "The name for this named port.\nThe name must be 1-63 characters long, and comply withRFC1035.", +"type": "string" +}, +"port": { +"description": "The port number, which can be a value between 1 and 65535.", +"format": "int32", +"type": "integer" +} +}, +"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", +"properties": { +"natIpInfoMappings": { +"description": "Output only. A list of all NAT IPs assigned to this NAT config.", +"items": { +"$ref": "NatIpInfoNatIpInfoMapping" +}, +"readOnly": true, +"type": "array" +}, +"natName": { +"description": "Output only. Name of the NAT config which the NAT IP belongs to.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NatIpInfoNatIpInfoMapping": { +"description": "Contains information of a NAT IP.", +"id": "NatIpInfoNatIpInfoMapping", +"properties": { +"mode": { +"description": "Output only. Specifies whether NAT IP is auto or manual.", +"enum": [ +"AUTO", +"MANUAL" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +}, +"natIp": { +"description": "Output only. NAT IP address. For example: 203.0.113.11.", +"readOnly": true, +"type": "string" +}, +"usage": { +"description": "Output only. Specifies whether NAT IP is currently serving at least one endpoint or\nnot.", +"enum": [ +"IN_USE", +"UNUSED" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NatIpInfoResponse": { +"id": "NatIpInfoResponse", +"properties": { +"result": { +"description": "[Output Only] A list of NAT IP information.", +"items": { +"$ref": "NatIpInfo" +}, +"type": "array" +} +}, +"type": "object" +}, +"Network": { +"description": "Represents a VPC Network resource.\n\nNetworks connect resources to each other and to the internet. For more\ninformation, readVirtual Private Cloud (VPC) Network.", +"id": "Network", +"properties": { +"IPv4Range": { +"deprecated": true, +"description": "Deprecated in favor of subnet mode networks.\nThe range of internal addresses that are legal on this network. This\nrange is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is\ncreated.", +"pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}/[0-9]{1,2}", +"type": "string" +}, +"autoCreateSubnetworks": { +"description": "Must be set to create a VPC network. If not set, a legacy network is\ncreated.\n\nWhen set to true, the VPC network is created in auto mode.\nWhen set to false, the VPC network is created in custom mode.\n\nAn auto mode VPC network starts with one subnet per region. Each subnet\nhas a predetermined range as described inAuto mode VPC network IP ranges.\n\nFor custom mode VPC networks, you can add subnets using the subnetworksinsert\nmethod.", +"type": "boolean" +}, +"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 field when you\ncreate the resource.", +"type": "string" +}, +"enableUlaInternalIpv6": { +"description": "Enable ULA internal ipv6 on this network. Enabling this feature will assign\na /48 from google defined ULA prefix fd20::/20.\n.", +"type": "boolean" +}, +"firewallPolicy": { +"description": "Output only. [Output Only] URL of the firewall policy the network is associated with.", +"readOnly": true, +"type": "string" +}, +"gatewayIPv4": { +"description": "[Output Only] The gateway address for default routing out of the network,\nselected by Google Cloud.", +"pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}", +"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" +}, +"internalIpv6Range": { +"description": "When enabling ula internal ipv6, caller optionally can specify the /48\nrange they want from the google defined ULA prefix fd20::/20. The input\nmust be a valid /48 ULA IPv6 address and must be within the fd20::/20.\nOperation will fail if the speficied /48 is already in used by another\nresource. If the field is not speficied, then a /48 range will be randomly\nallocated from fd20::/20 and returned via this field.\n.", +"type": "string" +}, +"kind": { +"default": "compute#network", +"description": "Output only. [Output Only] Type of the resource. Always compute#network for\nnetworks.", +"readOnly": true, +"type": "string" +}, +"mtu": { +"description": "Maximum Transmission Unit in bytes.\nThe minimum value for this field is 1300 and the maximum value is 8896.\nThe suggested value is 1500, which is the default MTU used on the\nInternet, or 8896 if you want to use Jumbo frames. If unspecified, the\nvalue defaults to 1460.", +"format": "int32", +"type": "integer" +}, +"name": { +"annotations": { +"required": [ +"compute.networks.insert" +] +}, +"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])?`. The first character must be a\nlowercase letter, and all following characters (except for the last\ncharacter) must be a dash, lowercase letter, or digit. The last character\nmust be a lowercase letter or digit.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"networkFirewallPolicyEnforcementOrder": { +"description": "The network firewall policy enforcement order. Can be either\nAFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to\nAFTER_CLASSIC_FIREWALL if the field is not specified.", +"enum": [ +"AFTER_CLASSIC_FIREWALL", +"BEFORE_CLASSIC_FIREWALL" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"networkProfile": { +"description": "A full or partial URL of the network profile to apply to this network.\nThis field can be set only at resource creation time. For example, the\nfollowing are valid URLs: \n \n - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}\n - projects/{project_id}/global/networkProfiles/{network_profile_name}", +"type": "string" +}, +"params": { +"$ref": "NetworkParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"peerings": { +"description": "Output only. [Output Only] A list of network peerings for the resource.", +"items": { +"$ref": "NetworkPeering" +}, +"readOnly": true, +"type": "array" +}, +"routingConfig": { +"$ref": "NetworkRoutingConfig", +"description": "The network-level routing configuration for this network. Used by Cloud\nRouter to determine what type of network-wide routing behavior to enforce." +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"subnetworks": { +"description": "[Output Only] Server-defined fully-qualified URLs for all subnetworks\nin this VPC network.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"NetworkAttachment": { +"description": "NetworkAttachments\nA network attachment resource ...", +"id": "NetworkAttachment", +"properties": { +"connectionEndpoints": { +"description": "Output only. [Output Only] An array of connections for all the producers connected\nto this network attachment.", +"items": { +"$ref": "NetworkAttachmentConnectedEndpoint" +}, +"readOnly": true, +"type": "array" +}, +"connectionPreference": { +"enum": [ +"ACCEPT_AUTOMATIC", +"ACCEPT_MANUAL", +"INVALID" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"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\nin this object. This field is used in optimistic locking. An up-to-date\nfingerprint must be provided in order to patch.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#networkAttachment", +"description": "Output only. [Output Only] Type of the resource.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.networkAttachments.insert" +] +}, +"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" +}, +"network": { +"description": "Output only. [Output Only] The URL of the network which the Network Attachment\nbelongs to. Practically it is inferred by fetching the network of the first\nsubnetwork associated. Because it is required that all the subnetworks must\nbe from the same network, it is assured that the Network Attachment belongs\nto the same network as all the subnetworks.", +"readOnly": true, +"type": "string" +}, +"producerAcceptLists": { +"description": "Projects or service class ids that are allowed to connect to this network\nattachment. The project can be specified using its id or number. Service\nclass id can be specified as \"serviceclasses/{service_class_id}\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"producerRejectLists": { +"description": "Projects or service class ids that are not allowed to connect to this\nnetwork attachment. The project can be specified using its id or number.\nService class id can be specified as \"serviceclasses/{service_class_id}\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the network attachment resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"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" +}, +"subnetworks": { +"description": "An array of URLs where each entry is the URL of a subnet\nprovided by the service consumer to use for\nendpoints in the producers that connect to this network attachment.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"NetworkAttachmentAggregatedList": { +"description": "Contains a list of NetworkAttachmentsScopedList.", +"id": "NetworkAttachmentAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NetworkAttachmentsScopedList", +"description": "Name of the scope containing this set of NetworkAttachments." +}, +"description": "A list of NetworkAttachmentsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#networkAttachmentAggregatedList", +"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] Server-defined URL for this resource.", +"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" +}, +"NetworkAttachmentConnectedEndpoint": { +"description": "[Output Only] A connection connected to this network attachment.", +"id": "NetworkAttachmentConnectedEndpoint", +"properties": { +"ipAddress": { +"description": "The IPv4 address assigned to the producer instance network interface.\nThis value will be a range in case of Serverless.", +"type": "string" +}, +"ipv6Address": { +"description": "The IPv6 address assigned to the producer instance network interface.\nThis is only assigned when the stack types of both the instance network\ninterface and the consumer subnet are IPv4_IPv6.", +"type": "string" +}, +"projectIdOrNum": { +"description": "The project id or number of the interface to which the IP was assigned.", +"type": "string" +}, +"secondaryIpCidrRanges": { +"description": "Alias IP ranges from the same subnetwork.", +"items": { +"type": "string" +}, +"type": "array" +}, +"serviceClassId": { +"description": "The service class id of the producer service to which the IP was\nassigned.", +"type": "string" +}, +"status": { +"description": "The status of a connected endpoint to this network attachment.", +"enum": [ +"ACCEPTED", +"CLOSED", +"NEEDS_ATTENTION", +"PENDING", +"REJECTED", +"STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The consumer allows traffic from the producer to reach its VPC.", +"The consumer network attachment no longer exists.", +"The consumer needs to take further action before traffic can be served.", +"The consumer neither allows nor prohibits traffic\nfrom the producer to reach its VPC.", +"The consumer prohibits traffic from the producer to reach its VPC.", +"" +], +"type": "string" +}, +"subnetwork": { +"description": "The subnetwork used to assign the IP to the producer\ninstance network interface.", +"type": "string" +}, +"subnetworkCidrRange": { +"description": "Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal\nIP was allocated from.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworkAttachmentList": { +"id": "NetworkAttachmentList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NetworkAttachment resources.", +"items": { +"$ref": "NetworkAttachment" +}, +"type": "array" +}, +"kind": { +"default": "compute#networkAttachmentList", +"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] Server-defined URL for this resource.", +"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" +}, +"NetworkAttachmentsScopedList": { +"id": "NetworkAttachmentsScopedList", +"properties": { +"networkAttachments": { +"description": "A list of NetworkAttachments contained in this scope.", +"items": { +"$ref": "NetworkAttachment" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nnetwork attachments 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.", +"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" +}, +"NetworkEdgeSecurityService": { +"description": "Represents a Google Cloud Armor network edge security service resource.", +"id": "NetworkEdgeSecurityService", +"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 NetworkEdgeSecurityService. An up-to-date fingerprint must be\nprovided in order to update the NetworkEdgeSecurityService,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a NetworkEdgeSecurityService.", +"format": "byte", +"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#networkEdgeSecurityService", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for\nNetworkEdgeSecurityServices", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the resource resides. You must\nspecify this field as part of the HTTP request URL. It is not settable as a\nfield in the request body.", +"readOnly": true, +"type": "string" +}, +"securityPolicy": { +"description": "The resource URL for the network edge security service associated with this\nnetwork edge security service.", +"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 with the resource id.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworkEdgeSecurityServiceAggregatedList": { +"id": "NetworkEdgeSecurityServiceAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NetworkEdgeSecurityServicesScopedList", +"description": "Name of the scope containing this set of security policies." +}, +"description": "A list of NetworkEdgeSecurityServicesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#networkEdgeSecurityServiceAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of\nNetwork Edge Security Services.", +"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" +}, +"NetworkEdgeSecurityServicesScopedList": { +"id": "NetworkEdgeSecurityServicesScopedList", +"properties": { +"networkEdgeSecurityServices": { +"description": "A list of NetworkEdgeSecurityServices contained in this scope.", +"items": { +"$ref": "NetworkEdgeSecurityService" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nsecurity policies 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.", +"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" +}, +"NetworkEndpoint": { +"description": "The network endpoint.", +"id": "NetworkEndpoint", +"properties": { +"annotations": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional metadata defined as annotations on the network endpoint.", +"type": "object" +}, +"clientDestinationPort": { +"description": "Represents the port number to which PSC consumer sends packets.\n\nOptional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.", +"format": "int32", +"type": "integer" +}, +"fqdn": { +"description": "Optional fully qualified domain name of network endpoint. This can only be\nspecified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.", +"type": "string" +}, +"instance": { +"description": "The name or a URL of VM instance of this network endpoint.\nOptional, the field presence depends on the network endpoint type. The\nfield is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.\n\nThe instance must be in the same zone of network endpoint group (for zonal\nNEGs) or in the zone within the region of the NEG (for regional NEGs).\nIf the ipAddress is specified, it must belongs to the VM\ninstance.\n\nThe name must be 1-63 characters long, and comply withRFC1035\nor be a valid URL pointing to an existing instance.", +"type": "string" +}, +"ipAddress": { +"description": "Optional IPv4 address of network endpoint. The IP address must belong to a\nVM in Compute Engine (either the primary IP or as part of an aliased IP\nrange). If the IP address is not specified, then the primary IP address for\nthe VM instance in the network that the network endpoint group belongs to\nwill be used.\n\nThis field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP\naddress of the attached VM instance that matches the subnetwork of the NEG.\nThe primary internal IP address from any NIC of a multi-NIC VM instance can\nbe added to a NEG as long as it matches the NEG subnetwork.", +"type": "string" +}, +"ipv6Address": { +"description": "Optional IPv6 address of network endpoint.", +"type": "string" +}, +"port": { +"description": "Optional port number of network endpoint. If not specified, the\ndefaultPort for the network endpoint group will be used.\n\nThis field can not be set for network endpoints of typeGCE_VM_IP.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"NetworkEndpointGroup": { +"description": "Represents a collection of network endpoints.\n\nA network endpoint group (NEG) defines how a set of endpoints should be\nreached, whether they are reachable, and where they are located.\nFor more information about using NEGs for different use cases, seeNetwork endpoint groups overview.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", +"id": "NetworkEndpointGroup", +"properties": { +"annotations": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Metadata defined as annotations on the network endpoint group.", +"type": "object" +}, +"appEngine": { +"$ref": "NetworkEndpointGroupAppEngine", +"description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." +}, +"cloudFunction": { +"$ref": "NetworkEndpointGroupCloudFunction", +"description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." +}, +"cloudRun": { +"$ref": "NetworkEndpointGroupCloudRun", +"description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"defaultPort": { +"description": "The default port used if the port number is not specified in the network\nendpoint.\n\nOptional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this\nfield must not be specified.", +"format": "int32", +"type": "integer" +}, +"description": { +"description": "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#networkEndpointGroup", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group.", +"readOnly": true, +"type": "string" +}, +"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.\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.", +"type": "string" +}, +"network": { +"description": "The URL of the network to which all network endpoints in the NEG belong.\nFor networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,\nif this field is not specified, a default network will be used.\nThis field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for\nglobal NEGs.\nFor all other network endpoint types, this field is required.", +"type": "string" +}, +"networkEndpointType": { +"description": "Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.", +"enum": [ +"GCE_VM_IP", +"GCE_VM_IP_DEDICATED_BACKEND", +"GCE_VM_IP_PORT", +"GCE_VM_IP_PORTMAP", +"INTERNET_FQDN_PORT", +"INTERNET_IP_PORT", +"NON_GCP_PRIVATE_IP_PORT", +"PRIVATE_SERVICE_CONNECT", +"SERVERLESS" +], +"enumDescriptions": [ +"The network endpoint is represented by an IP address.", +"The network endpoint for targeting a specific network interface of a\nVM instance in configurations with multiple network interfaces on the\nsame network.", +"The network endpoint is represented by IP address and port pair.", +"The network endpoint is represented by an IP, Port and Client Destination\nPort.", +"The network endpoint is represented by fully qualified domain name and\nport.", +"The network endpoint is represented by an internet IP address and port.", +"The network endpoint is represented by an IP address and port. The\nendpoint belongs to a VM or pod running in a customer's on-premises.", +"The network endpoint is either public Google APIs or\nservices exposed by other GCP Project with a Service Attachment.\nThe connection is set up by private service connect", +"The network endpoint is handled by specified serverless infrastructure." +], +"type": "string" +}, +"pscData": { +"$ref": "NetworkEndpointGroupPscData", +"description": "Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT." +}, +"pscTargetService": { +"description": "The target service url used to set up private service connection to\na Google API or a PSC Producer Service Attachment.\nAn example value is: asia-northeast3-cloudkms.googleapis.com.\n\nOptional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] The URL of theregion\nwhere the network endpoint group is located.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"size": { +"description": "Output only. [Output only] Number of network endpoints in the network endpoint group.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"subnetwork": { +"description": "Optional URL of the subnetwork to which all network endpoints in the NEG\nbelong.", +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] The URL of thezone\nwhere the network endpoint group is located.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupAggregatedList": { +"id": "NetworkEndpointGroupAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NetworkEndpointGroupsScopedList", +"description": "The name of the scope that contains this set of network endpoint groups." +}, +"description": "A list of NetworkEndpointGroupsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#networkEndpointGroupAggregatedList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated\nlists of network endpoint groups.", +"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" +}, +"NetworkEndpointGroupAppEngine": { +"description": "Configuration for an App Engine network endpoint group (NEG).\nThe service is optional, may be provided explicitly or in the\nURL mask. The version is optional and can only be provided\nexplicitly or in the URL mask when service is present.\n\nNote: App Engine service must be in the same project and located in the\nsame region as the Serverless NEG.", +"id": "NetworkEndpointGroupAppEngine", +"properties": { +"service": { +"description": "Optional serving service.\n\nThe service name is case-sensitive and must be 1-63\ncharacters long.\n\nExample value: default, my-service.", +"type": "string" +}, +"urlMask": { +"description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse service and version fields\nfrom a request URL. URL mask allows for routing to multiple App Engine\nservices without having to create multiple Network Endpoint Groups and\nbackend services.\n\nFor example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same\nServerless NEG with URL mask-dot-appname.appspot.com/.\nThe URL mask will parse them to { service = \"foo1\", version = \"v1\"\n} and { service = \"foo1\", version = \"v2\" }\nrespectively.", +"type": "string" +}, +"version": { +"description": "Optional serving version.\n\nThe version name is case-sensitive and must be 1-100\ncharacters long.\n\nExample value: v1, v2.", +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupCloudFunction": { +"description": "Configuration for a Cloud Function network endpoint group (NEG).\nThe function must be provided explicitly or in the URL mask.\n\nNote: Cloud Function must be in the same project and located in the same\nregion as the Serverless NEG.", +"id": "NetworkEndpointGroupCloudFunction", +"properties": { +"function": { +"description": "A user-defined name of the Cloud Function.\n\nThe function name is case-sensitive and must be 1-63\ncharacters long.\n\nExample value: func1.", +"type": "string" +}, +"urlMask": { +"description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse function field from a request URL. URL\nmask allows for routing to multiple Cloud Functions without having to\ncreate multiple Network Endpoint Groups and backend services.\n\nFor example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same\nServerless NEG with URL mask /. The URL\nmask will parse them to { function = \"function1\" } and{ function = \"function2\" } respectively.", +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupCloudRun": { +"description": "Configuration for a Cloud Run network endpoint group (NEG).\nThe service must be provided explicitly or in the URL mask.\nThe tag is optional, may be provided explicitly or in the URL\nmask.\n\nNote: Cloud Run service must be in the same project and located in the same\nregion as the Serverless NEG.", +"id": "NetworkEndpointGroupCloudRun", +"properties": { +"service": { +"description": "Cloud Run service is the main resource of Cloud Run.\n\nThe service must be 1-63 characters long, and comply withRFC1035.\n\nExample value: \"run-service\".", +"type": "string" +}, +"tag": { +"description": "Optional Cloud Run tag represents the \"named-revision\" to provide additional\nfine-grained traffic routing information.\n\nThe tag must be 1-63 characters long, and comply withRFC1035.\n\nExample value: \"revision-0010\".", +"type": "string" +}, +"urlMask": { +"description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse and fields from a request URL. URL mask allows for\nrouting to multiple Run services without having to create multiple\nnetwork endpoint groups and backend services.\n\nFor example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless\nNetwork Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will\nparse them to { service=\"bar1\", tag=\"foo1\" } and {\nservice=\"bar2\", tag=\"foo2\" } respectively.", +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupList": { +"id": "NetworkEndpointGroupList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NetworkEndpointGroup resources.", +"items": { +"$ref": "NetworkEndpointGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#networkEndpointGroupList", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group\nlists.", +"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.", +"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" +}, +"NetworkEndpointGroupPscData": { +"description": "All data that is specifically relevant to only network endpoint groups of\ntype PRIVATE_SERVICE_CONNECT.", +"id": "NetworkEndpointGroupPscData", +"properties": { +"consumerPscAddress": { +"description": "Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP\naddress acts as a VIP for a PSC NEG, allowing it to act as an endpoint in\nL7 PSC-XLB.", +"readOnly": true, +"type": "string" +}, +"producerPort": { +"description": "The psc producer port is used to connect PSC NEG with specific port on\nthe PSC Producer side; should only be used for the\nPRIVATE_SERVICE_CONNECT NEG type", +"format": "int32", +"type": "integer" +}, +"pscConnectionId": { +"description": "Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group\nConsumer.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"pscConnectionStatus": { +"description": "Output only. [Output Only] The connection status of the PSC Forwarding Rule.", +"enum": [ +"ACCEPTED", +"CLOSED", +"NEEDS_ATTENTION", +"PENDING", +"REJECTED", +"STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The connection has been accepted by the producer.", +"The connection has been closed by the producer and will not serve\ntraffic going forward.", +"The connection has been accepted by the producer, but the producer\nneeds to take further action before the forwarding rule can serve\ntraffic.", +"The connection is pending acceptance by the producer.", +"The connection has been rejected by the producer.", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupsAttachEndpointsRequest": { +"id": "NetworkEndpointGroupsAttachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be attached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"NetworkEndpointGroupsDetachEndpointsRequest": { +"id": "NetworkEndpointGroupsDetachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be detached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"NetworkEndpointGroupsListEndpointsRequest": { +"id": "NetworkEndpointGroupsListEndpointsRequest", +"properties": { +"healthStatus": { +"description": "Optional query parameter for showing the health status of each network\nendpoint. Valid options are SKIP or SHOW. If you\ndon't specify this parameter, the health status of network endpoints will\nnot be provided.", +"enum": [ +"SHOW", +"SKIP" +], +"enumDescriptions": [ +"Show the health status for each network endpoint. Impacts latency of the\ncall.", +"Health status for network endpoints will not be provided." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkEndpointGroupsListNetworkEndpoints": { +"id": "NetworkEndpointGroupsListNetworkEndpoints", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NetworkEndpointWithHealthStatus resources.", +"items": { +"$ref": "NetworkEndpointWithHealthStatus" +}, +"type": "array" +}, +"kind": { +"default": "compute#networkEndpointGroupsListNetworkEndpoints", +"description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list\nof network endpoints in the specified network endpoint group.", +"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" +}, +"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" +}, +"NetworkEndpointGroupsScopedList": { +"id": "NetworkEndpointGroupsScopedList", +"properties": { +"networkEndpointGroups": { +"description": "Output only. [Output Only] The list ofnetwork\nendpoint groups that are contained in this scope.", +"items": { +"$ref": "NetworkEndpointGroup" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "Output only. [Output Only] An informational warning that replaces the list of network\nendpoint groups 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.", +"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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"NetworkEndpointWithHealthStatus": { +"id": "NetworkEndpointWithHealthStatus", +"properties": { +"healths": { +"description": "Output only. [Output only] The health status of network endpoint.\n\nOptional. Displayed only if the network endpoint has centralized health\nchecking configured.", +"items": { +"$ref": "HealthStatusForNetworkEndpoint" +}, +"readOnly": true, +"type": "array" +}, +"networkEndpoint": { +"$ref": "NetworkEndpoint", +"description": "Output only. [Output only] The network endpoint.", +"readOnly": true +} +}, +"type": "object" +}, +"NetworkFirewallPolicyAggregatedList": { +"id": "NetworkFirewallPolicyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "FirewallPoliciesScopedList", +"description": "Name of the scope containing this set of addresses." +}, +"description": "A list of FirewallPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#networkFirewallPolicyAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of\nnetwork firewall policies.", +"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" +}, +"NetworkInterface": { +"description": "A network interface resource attached to an instance.", +"id": "NetworkInterface", +"properties": { +"accessConfigs": { +"description": "An array of configurations for this interface. Currently, only one access\nconfig, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have\nno external internet access.", +"items": { +"$ref": "AccessConfig" +}, +"type": "array" +}, +"aliasIpRanges": { +"description": "An array of alias IP ranges for this network interface.\nYou can only specify this field for network interfaces in VPC networks.", +"items": { +"$ref": "AliasIpRange" +}, +"type": "array" +}, +"aliasIpv6Ranges": { +"description": "An array of alias IPv6 ranges for this network interface.\nYou can only specify this field for network interfaces in VPC networks.", +"items": { +"$ref": "AliasIpRange" +}, +"type": "array" +}, +"enableVpcScopedDns": { +"description": "Optional. If true, DNS resolution will be enabled over this interface. Only valid\nwith network_attachment.", +"type": "boolean" +}, +"fingerprint": { +"description": "Fingerprint hash of contents stored in this network interface.\nThis field will be ignored when inserting an Instance or\nadding a NetworkInterface. An up-to-date\nfingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.", +"format": "byte", +"type": "string" +}, +"igmpQuery": { +"description": "Indicate whether igmp query is enabled on the network interface\nor not. If enabled, also indicates the version of IGMP supported.", +"enum": [ +"IGMP_QUERY_DISABLED", +"IGMP_QUERY_V2" +], +"enumDescriptions": [ +"The network interface has disabled IGMP query.", +"The network interface has enabled IGMP query - v2." +], +"type": "string" +}, +"internalIpv6PrefixLength": { +"description": "The prefix length of the primary internal IPv6 range.", +"format": "int32", +"type": "integer" +}, +"ipv6AccessConfigs": { +"description": "An array of IPv6 access configurations for this interface. Currently, only\none IPv6 access config, DIRECT_IPV6, is supported. If there\nis no ipv6AccessConfig specified, then this instance will\nhave no external IPv6 Internet access.", +"items": { +"$ref": "AccessConfig" +}, +"type": "array" +}, +"ipv6AccessType": { +"description": "Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be\naccessed from the Internet. This field is always inherited from its\nsubnetwork.\n\nValid only if stackType is IPV4_IPV6.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"This network interface can have external IPv6.", +"This network interface can have internal IPv6." +], +"readOnly": true, +"type": "string" +}, +"ipv6Address": { +"description": "An IPv6 internal network address for this network interface. To\nuse a static internal IP address, it must be unused and in the same region\nas the instance's zone. If not specified, Google Cloud will automatically\nassign an internal IPv6 address from the instance's subnetwork.", +"type": "string" +}, +"kind": { +"default": "compute#networkInterface", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "[Output Only] The name of the network interface, which is generated by the\nserver. For a VM, the network interface uses the nicN naming\nformat. Where N is a value between 0 and7. The default interface value is nic0.", +"type": "string" +}, +"network": { +"description": "URL of the VPC network resource for this instance. When creating an\ninstance, if neither the network nor the subnetwork is specified, the\ndefault network global/networks/default is used. If the\nselected project doesn't have the default network, you must specify a\nnetwork or subnet. If the network is not specified but the subnetwork is\nspecified, the network is inferred.\n\nIf you specify this property, you can specify the network as\na full or partial URL. For example, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/networks/network\n - projects/project/global/networks/network\n - global/networks/default", +"type": "string" +}, +"networkAttachment": { +"description": "The URL of the network attachment that this interface should connect\nto in the following format:\nprojects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.", +"type": "string" +}, +"networkIP": { +"description": "An IPv4 internal IP address to assign to the instance for this network\ninterface. If not specified by the user, an unused internal IP is\nassigned by the system.", +"type": "string" +}, +"nicType": { +"description": "The type of vNIC to be used on this interface. This may be gVNIC or\nVirtioNet.", +"enum": [ +"GVNIC", +"IDPF", +"IRDMA", +"MRDMA", +"UNSPECIFIED_NIC_TYPE", +"VIRTIO_NET" +], +"enumDescriptions": [ +"GVNIC", +"IDPF", +"IRDMA", +"MRDMA", +"No type specified.", +"VIRTIO" +], +"type": "string" +}, +"parentNicName": { +"description": "Name of the parent network interface of a dynamic network interface.", +"type": "string" +}, +"queueCount": { +"description": "The networking queue count that's specified by users for the network\ninterface. Both Rx and Tx queues will be set to this number. It'll be empty\nif not specified by the users.", +"format": "int32", +"type": "integer" +}, +"serviceClassId": { +"description": "Optional. Producer Service's Service class Id for the region of this network\ninterface. Can only be used with network_attachment. It is not possible to\nuse on its own however, network_attachment can be used without\nservice_class_id.", +"type": "string" +}, +"stackType": { +"description": "The stack type for this network interface. To assign only IPv4 addresses,\nuse IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at instance creation and update network\ninterface operations.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"The network interface can have both IPv4 and IPv6 addresses.", +"The network interface will only be assigned IPv4 addresses.", +"The network interface will only be assigned IPv6 addresses." +], +"type": "string" +}, +"subnetwork": { +"description": "The URL of the Subnetwork resource for this instance. If the network\nresource is inlegacy\nmode, do not specify this field. If the network is in auto subnet\nmode, specifying the subnetwork is optional. If the network is in custom\nsubnet mode, specifying the subnetwork is required. If you specify this\nfield, you can specify the subnetwork as a full or partial URL. For\nexample, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork \n - regions/region/subnetworks/subnetwork", +"type": "string" +}, +"vlan": { +"description": "VLAN tag of a dynamic network interface, must be an integer in the range\nfrom 2 to 255 inclusively.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"NetworkList": { +"description": "Contains a list of networks.", +"id": "NetworkList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Network resources.", +"items": { +"$ref": "Network" +}, +"type": "array" +}, +"kind": { +"default": "compute#networkList", +"description": "Output only. [Output Only] Type of resource. Always compute#networkList for\nlists of networks.", +"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.", +"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" +}, +"NetworkParams": { +"description": "Additional network parameters.", +"id": "NetworkParams", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"NetworkPeering": { +"description": "A network peering attached to a network resource. The message includes the\npeering name, peer network, peering state, and a flag indicating whether\nGoogle Compute Engine should automatically create routes for the peering.", +"id": "NetworkPeering", +"properties": { +"autoCreateRoutes": { +"description": "This field will be deprecated soon. Use theexchange_subnet_routes field instead.\nIndicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", +"type": "boolean" +}, +"connectionStatus": { +"$ref": "NetworkPeeringConnectionStatus", +"description": "Output only. [Output Only] The effective state of the peering connection\nas a whole.", +"readOnly": true +}, +"exchangeSubnetRoutes": { +"description": "Indicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", +"type": "boolean" +}, +"exportCustomRoutes": { +"description": "Whether to export the custom routes to peer network. The default value is\nfalse.", +"type": "boolean" +}, +"exportSubnetRoutesWithPublicIp": { +"description": "Whether subnet routes with public IP range are exported. The default value\nis true, all subnet routes are exported.IPv4\nspecial-use ranges are always\nexported to peers and are not controlled by this field.", +"type": "boolean" +}, +"importCustomRoutes": { +"description": "Whether to import the custom routes from peer network. The default value is\nfalse.", +"type": "boolean" +}, +"importSubnetRoutesWithPublicIp": { +"description": "Whether subnet routes with public IP range are imported. The default value\nis false.IPv4\nspecial-use ranges are always\nimported from peers and are not controlled by this field.", +"type": "boolean" +}, +"name": { +"description": "Name of this peering. Provided by the client when the peering is created.\nThe name must comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a\nlowercase letter, and all the following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", +"type": "string" +}, +"network": { +"description": "The URL of the peer network. It can be either full URL or partial URL. The\npeer network may belong to a different project. If the partial URL does not\ncontain project, it is assumed that the peer network is in the same project\nas the current network.", +"type": "string" +}, +"peerMtu": { +"description": "Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"stackType": { +"description": "Which IP version(s) of traffic and routes are allowed to be imported or\nexported between peer networks. The default value is IPV4_ONLY.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY" +], +"enumDescriptions": [ +"This Peering will allow IPv4 traffic and routes to be\nexchanged. Additionally if the matching peering is\nIPV4_IPV6, IPv6 traffic and routes will be exchanged as\nwell.", +"This Peering will only allow IPv4 traffic and routes to be\nexchanged, even if the matching peering is IPV4_IPV6." +], +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] State for the peering.", +"enum": [ +"ACTIVE", +"INACTIVE" +], +"enumDescriptions": [ +"Matching configuration exists on the peer.", +"There is no matching configuration on the peer, including the case when\npeer does not exist." +], +"readOnly": true, +"type": "string" +}, +"stateDetails": { +"description": "Output only. [Output Only] Details about the current state of the peering.", +"readOnly": true, +"type": "string" +}, +"updateStrategy": { +"description": "The update strategy determines the semantics for updates and deletes to the\npeering connection configuration.", +"enum": [ +"CONSENSUS", +"INDEPENDENT", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Updates are reflected in the local peering but aren't applied to the\npeering connection until a complementary change is made to the\nmatching peering.\nTo delete a peering with the consensus update strategy, both the peerings\nmust request the deletion of the peering before the peering can be\ndeleted.", +"In this mode, changes to the peering configuration can\nbe unilaterally altered by changing either side of the peering.\nThis is the default value if the field is unspecified.", +"Peerings with update strategy UNSPECIFIED are created with\nupdate strategy INDEPENDENT." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatus": { +"description": "[Output Only] Describes the state of a peering connection, not just the\nlocal peering. This field provides information about the effective settings\nfor the connection as a whole, including pending delete/update requests for\nCONSENSUS peerings.", +"id": "NetworkPeeringConnectionStatus", +"properties": { +"consensusState": { +"$ref": "NetworkPeeringConnectionStatusConsensusState", +"description": "The consensus state contains information about the status of update\nand delete for a consensus peering connection." +}, +"trafficConfiguration": { +"$ref": "NetworkPeeringConnectionStatusTrafficConfiguration", +"description": "The active connectivity settings for the peering connection based on the\nsettings of the network peerings." +}, +"updateStrategy": { +"description": "The update strategy determines the update/delete semantics for this\npeering connection.", +"enum": [ +"CONSENSUS", +"INDEPENDENT", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Updates are reflected in the local peering but aren't applied to the\npeering connection until a complementary change is made to the\nmatching peering.\nTo delete a peering with the consensus update strategy, both the peerings\nmust request the deletion of the peering before the peering can be\ndeleted.", +"In this mode, changes to the peering configuration can\nbe unilaterally altered by changing either side of the peering.\nThis is the default value if the field is unspecified.", +"Peerings with update strategy UNSPECIFIED are created with\nupdate strategy INDEPENDENT." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatusConsensusState": { +"description": "The status of update/delete for a consensus peering connection. Only set\nwhen connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the\nstrategy to CONSENSUS.", +"id": "NetworkPeeringConnectionStatusConsensusState", +"properties": { +"deleteStatus": { +"description": "The status of the delete request.", +"enum": [ +"DELETE_ACKNOWLEDGED", +"DELETE_STATUS_UNSPECIFIED", +"LOCAL_CANCEL_REQUESTED", +"LOCAL_DELETE_REQUESTED", +"PEER_CANCEL_REQUESTED", +"PEER_DELETE_REQUESTED" +], +"enumDescriptions": [ +"Both network admins have agreed this consensus peering connection can\nbe deleted.", +"", +"The local network admin requested to cancel their delete request\nafter DELETE_ACKNOWLEDGED.", +"Network admin has requested deletion of this peering connection.", +"The peer network admin requested to cancel their delete request after\nDELETE_ACKNOWLEDGED.", +"The peer network admin has requested deletion of this peering\nconnection." +], +"type": "string" +}, +"updateStatus": { +"description": "The status of the update request.", +"enum": [ +"IN_SYNC", +"PENDING_LOCAL_ACKNOWLEDMENT", +"PENDING_PEER_ACKNOWLEDGEMENT", +"UPDATE_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"No pending configuration update proposals to the peering connection.", +"The peer network admin has made an updatePeering call. The change is\nawaiting acknowledgment from this peering's network admin.", +"The local network admin has made an updatePeering call. The change\nis awaiting acknowledgment from the peer network admin.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatusTrafficConfiguration": { +"id": "NetworkPeeringConnectionStatusTrafficConfiguration", +"properties": { +"exportCustomRoutesToPeer": { +"description": "Whether custom routes are being exported to the peer network.", +"type": "boolean" +}, +"exportSubnetRoutesWithPublicIpToPeer": { +"description": "Whether subnet routes with public IP ranges are being exported to the\npeer network.", +"type": "boolean" +}, +"importCustomRoutesFromPeer": { +"description": "Whether custom routes are being imported from the peer network.", +"type": "boolean" +}, +"importSubnetRoutesWithPublicIpFromPeer": { +"description": "Whether subnet routes with public IP ranges are being imported\nfrom the peer network.", +"type": "boolean" +}, +"stackType": { +"description": "Which IP version(s) of traffic and routes are being imported or\nexported between peer networks.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY" +], +"enumDescriptions": [ +"This Peering will allow IPv4 traffic and routes to be\nexchanged. Additionally if the matching peering is\nIPV4_IPV6, IPv6 traffic and routes will be exchanged as\nwell.", +"This Peering will only allow IPv4 traffic and routes to be\nexchanged, even if the matching peering is IPV4_IPV6." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPerformanceConfig": { +"id": "NetworkPerformanceConfig", +"properties": { +"totalEgressBandwidthTier": { +"enum": [ +"DEFAULT", +"TIER_1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfile": { +"description": "NetworkProfile represents a Google managed network profile resource.", +"id": "NetworkProfile", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. [Output Only] An optional description of this resource.", +"readOnly": true, +"type": "string" +}, +"features": { +"$ref": "NetworkProfileNetworkFeatures", +"description": "Output only. [Output Only] Features supported by the network.", +"readOnly": true +}, +"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#networkProfile", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles.", +"readOnly": true, +"type": "string" +}, +"location": { +"$ref": "NetworkProfileLocation", +"description": "Output only. [Output Only] Location to which the network is restricted.", +"readOnly": true +}, +"name": { +"description": "Output only. [Output Only] Name of the resource.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"readOnly": true, +"type": "string" +}, +"profileType": { +"$ref": "NetworkProfileProfileType", +"description": "Output only. [Output Only] Type of the network profile.", +"readOnly": true +}, +"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 with the resource id.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfileLocation": { +"id": "NetworkProfileLocation", +"properties": { +"name": { +"type": "string" +}, +"scope": { +"enum": [ +"REGION", +"ZONE" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfileNetworkFeatures": { +"id": "NetworkProfileNetworkFeatures", +"properties": { +"addressPurposes": { +"description": "Specifies what address purposes are supported. If empty, all address\npurposes are supported.", +"items": { +"enum": [ +"DNS_RESOLVER", +"GCE_ENDPOINT", +"IPSEC_INTERCONNECT", +"NAT_AUTO", +"PRIVATE_SERVICE_CONNECT", +"SERVERLESS", +"SHARED_LOADBALANCER_VIP", +"VPC_PEERING" +], +"enumDescriptions": [ +"DNS resolver address in the subnetwork.", +"VM internal/alias IP, Internal LB service IP, etc.", +"A regional internal IP address range reserved for the VLAN attachment\nthat is used in HA VPN over Cloud Interconnect. This regional\ninternal IP address range must not overlap with any IP address range\nof subnet/route in the VPC network and its peering networks. After the\nVLAN attachment is created with the reserved IP address range, when\ncreating a new VPN gateway, its interface IP address is allocated\nfrom the associated VLAN attachment's IP address range.", +"External IP automatically reserved for Cloud NAT.", +"A private network IP address that can be used to configure Private\nService Connect. This purpose can be specified only forGLOBAL addresses of Type INTERNAL", +"A regional internal IP address range reserved for Serverless.", +"A private network IP address that can be shared by multiple Internal\nLoad Balancer forwarding rules.", +"IP range for peer networks." +], +"type": "string" +}, +"type": "array" +}, +"allowAddressCreation": { +"description": "Specifies whether address creation is allowed.", +"enum": [ +"ADDRESS_CREATION_ALLOWED", +"ADDRESS_CREATION_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowAliasIpRanges": { +"description": "Specifies whether alias IP ranges (and secondary address ranges) are\nallowed.", +"enum": [ +"ALIAS_IP_RANGES_ALLOWED", +"ALIAS_IP_RANGES_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowAutoModeSubnet": { +"description": "Specifies whether auto mode subnet creation is allowed.", +"enum": [ +"AUTO_MODE_SUBNET_ALLOWED", +"AUTO_MODE_SUBNET_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowClassDFirewalls": { +"description": "Specifies whether firewalls for Class D address ranges are supported.", +"enum": [ +"CLASS_D_FIREWALLS_ALLOWED", +"CLASS_D_FIREWALLS_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowCloudNat": { +"description": "Specifies whether cloud NAT creation is allowed.", +"enum": [ +"CLOUD_NAT_ALLOWED", +"CLOUD_NAT_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowCloudRouter": { +"description": "Specifies whether cloud router creation is allowed.", +"enum": [ +"CLOUD_ROUTER_ALLOWED", +"CLOUD_ROUTER_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowDefaultNicAttachment": { +"description": "Specifies whether default NIC attachment is allowed.", +"enum": [ +"DEFAULT_NIC_ATTACHMENT_ALLOWED", +"DEFAULT_NIC_ATTACHMENT_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowExternalIpAccess": { +"description": "Specifies whether VMs are allowed to have external IP access on network\ninterfaces connected to this VPC.", +"enum": [ +"EXTERNAL_IP_ACCESS_ALLOWED", +"EXTERNAL_IP_ACCESS_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowFirewallPolicy": { +"description": "Specifies whether firewall policy can be attached to the network.", +"enum": [ +"FIREWALL_POLICY_ALLOWED", +"FIREWALL_POLICY_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowInterconnect": { +"description": "Specifies whether Cloud Interconnect creation is allowed.", +"enum": [ +"INTERCONNECT_ALLOWED", +"INTERCONNECT_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowIpForwarding": { +"description": "Specifies whether IP forwarding is allowed.", +"enum": [ +"IP_FORWARDING_ALLOWED", +"IP_FORWARDING_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowLoadBalancing": { +"description": "Specifies whether cloud load balancing is allowed.", +"enum": [ +"LOAD_BALANCING_ALLOWED", +"LOAD_BALANCING_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowMultiNicInSameNetwork": { +"description": "Specifies whether multi-nic in the same network is allowed.", +"enum": [ +"MULTI_NIC_IN_SAME_NETWORK_ALLOWED", +"MULTI_NIC_IN_SAME_NETWORK_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowMultiNicInSameSubnetwork": { +"description": "Specifies whether multi-nic in the same subnetwork is allowed.", +"enum": [ +"MULTI_NIC_IN_SAME_SUBNETWORK_ALLOWED", +"MULTI_NIC_IN_SAME_SUBNETWORK_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowMulticast": { +"description": "Specifies whether multicast is allowed.", +"enum": [ +"MULTICAST_ALLOWED", +"MULTICAST_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowNcc": { +"description": "Specifies whether NCC is allowed.", +"enum": [ +"NCC_ALLOWED", +"NCC_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowNetworkMigration": { +"description": "Specifies whether VM network migration is allowed.", +"enum": [ +"NETWORK_MIGRATION_ALLOWED", +"NETWORK_MIGRATION_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowPacketMirroring": { +"description": "Specifies whether Packet Mirroring 1.0 is supported.", +"enum": [ +"PACKET_MIRRORING_ALLOWED", +"PACKET_MIRRORING_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowPrivateGoogleAccess": { +"description": "Specifies whether private Google access is allowed.", +"enum": [ +"PRIVATE_GOOGLE_ACCESS_ALLOWED", +"PRIVATE_GOOGLE_ACCESS_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowPsc": { +"description": "Specifies whether PSC creation is allowed.", +"enum": [ +"PSC_ALLOWED", +"PSC_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowSameNetworkUnicast": { +"description": "Specifies whether unicast within the same network is allowed.", +"enum": [ +"SAME_NETWORK_UNICAST_ALLOWED", +"SAME_NETWORK_UNICAST_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowStaticRoutes": { +"description": "Specifies whether static route creation is allowed.", +"enum": [ +"STATIC_ROUTES_ALLOWED", +"STATIC_ROUTES_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowSubInterfaces": { +"description": "Specifies whether sub interfaces are allowed.", +"enum": [ +"SUBINTERFACES_ALLOWED", +"SUBINTERFACES_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowSubnetworkCreation": { +"description": "Specifies whether subnetwork creation is allowed.", +"enum": [ +"SUBNETWORK_CREATION_ALLOWED", +"SUBNETWORK_CREATION_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowVpcFirewallRules": { +"description": "Specifies whether VPC firewall rules can be created under the network.", +"enum": [ +"VPC_FIREWALL_RULES_ALLOWED", +"VPC_FIREWALL_RULES_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowVpcPeering": { +"description": "Specifies whether VPC peering is allowed.", +"enum": [ +"VPC_PEERING_ALLOWED", +"VPC_PEERING_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"allowVpn": { +"description": "Specifies whether VPN creation is allowed.", +"enum": [ +"VPN_ALLOWED", +"VPN_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"firewallPolicyTypes": { +"items": { +"enum": [ +"RDMA_ROCE_POLICY", +"ULL_POLICY", +"VPC_POLICY" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +}, +"interfaceTypes": { +"description": "If set, limits the interface types that the network supports. If\nempty, all interface types are supported.", +"items": { +"enum": [ +"GVNIC", +"IDPF", +"IRDMA", +"MRDMA", +"UNSPECIFIED_NIC_TYPE", +"VIRTIO_NET" +], +"enumDescriptions": [ +"GVNIC", +"IDPF", +"IRDMA", +"MRDMA", +"No type specified.", +"VIRTIO" +], +"type": "string" +}, +"type": "array" +}, +"multicast": { +"description": "Specifies which type of multicast is supported.", +"enum": [ +"MULTICAST_SDN", +"MULTICAST_ULL" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"predefinedNetworkInternalIpv6Range": { +"description": "Specifies a predefined internal IPv6 range for the network.", +"type": "string" +}, +"predefinedSubnetworkRanges": { +"description": "Predefined subnetwork ranges for the network.", +"items": { +"$ref": "NetworkProfileNetworkFeaturesPredefinedSubnetworkRange" +}, +"type": "array" +}, +"subnetPurposes": { +"description": "Specifies which subnetwork purposes are supported.", +"items": { +"enum": [ +"SUBNET_PURPOSE_CUSTOM_HARDWARE", +"SUBNET_PURPOSE_PRIVATE" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"type": "array" +}, +"subnetStackTypes": { +"description": "Specifies which subnetwork stack types are supported.", +"items": { +"enum": [ +"SUBNET_STACK_TYPE_IPV4_IPV6", +"SUBNET_STACK_TYPE_IPV4_ONLY", +"SUBNET_STACK_TYPE_IPV6_ONLY" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +}, +"subnetworkPurposes": { +"description": "Output only. Specifies which subnetwork purposes are supported.", +"items": { +"enum": [ +"GLOBAL_MANAGED_PROXY", +"INTERNAL_HTTPS_LOAD_BALANCER", +"PEER_MIGRATION", +"PRIVATE", +"PRIVATE_NAT", +"PRIVATE_RFC_1918", +"PRIVATE_SERVICE_CONNECT", +"REGIONAL_MANAGED_PROXY" +], +"enumDescriptions": [ +"Subnet reserved for Global Envoy-based Load Balancing.", +"Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", +"Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", +"Regular user created or automatically created subnet.", +"Subnetwork used as source range for Private NAT Gateways.", +"Regular user created or automatically created subnet.", +"Subnetworks created for Private Service Connect in the producer network.", +"Subnetwork used for Regional Envoy-based Load Balancing." +], +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"subnetworkStackTypes": { +"description": "Output only. Specifies which subnetwork stack types are supported.", +"items": { +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"New VMs in this subnet can have both IPv4 and IPv6 addresses.", +"New VMs in this subnet will only be assigned IPv4 addresses.", +"New VMs in this subnet will only be assigned IPv6 addresses." +], +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"unicast": { +"description": "Specifies which type of unicast is supported.", +"enum": [ +"UNICAST_SDN", +"UNICAST_ULL" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfileNetworkFeaturesPredefinedSubnetworkRange": { +"id": "NetworkProfileNetworkFeaturesPredefinedSubnetworkRange", +"properties": { +"ipv6Range": { +"description": "The IPv6 range of the predefined subnetwork.", +"type": "string" +}, +"namePrefix": { +"description": "The naming prefix of the predefined subnetwork.", +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfileProfileType": { +"id": "NetworkProfileProfileType", +"properties": { +"networkType": { +"enum": [ +"RDMA", +"ULL", +"VPC" +], +"enumDescriptions": [ +"RDMA network.", +"ULL network.", +"VPC network." +], +"type": "string" +}, +"rdmaSubtype": { +"enum": [ +"FALCON", +"ROCE", +"ROCE_METAL" +], +"enumDescriptions": [ +"RDMA over Falcon.", +"RDMA over Converged Ethernet (RoCE).", +"RDMA over Converged Ethernet (RoCE) for Bare Metal." +], +"type": "string" +}, +"ullSubtype": { +"enum": [ +"OPERATOR", +"PARTICIPANT" +], +"enumDescriptions": [ +"Exchange operator.", +"Exchange participant." +], +"type": "string" +}, +"vpcSubtype": { +"enum": [ +"REGIONAL" +], +"enumDescriptions": [ +"Regionally bound VPC network." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkProfilesListResponse": { +"description": "Contains a list of network profiles.", +"id": "NetworkProfilesListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NetworkProfile resources.", +"items": { +"$ref": "NetworkProfile" +}, +"type": "array" +}, +"kind": { +"default": "compute#networkProfileList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles.", +"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\nfor\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken\nto\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" +}, +"NetworkRoutingConfig": { +"description": "A routing configuration attached to a network resource. The message\nincludes the list of routers associated with the network, and a flag\nindicating the type of routing behavior to enforce network-wide.", +"id": "NetworkRoutingConfig", +"properties": { +"bgpAlwaysCompareMed": { +"description": "Enable comparison of Multi-Exit Discriminators (MED) across routes with\ndifferent neighbor ASNs when using the STANDARD BGP best path selection\nalgorithm.", +"type": "boolean" +}, +"bgpBestPathSelectionMode": { +"description": "The BGP best path selection algorithm to be employed within this network\nfor dynamic routes learned by Cloud Routers. Can be LEGACY\n(default) or STANDARD.", +"enum": [ +"LEGACY", +"STANDARD" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"bgpInterRegionCost": { +"description": "Allows to define a preferred approach for handling inter-region cost in\nthe selection process when using the STANDARD BGP best path\nselection algorithm. Can be DEFAULT orADD_COST_TO_MED.", +"enum": [ +"ADD_COST_TO_MED", +"DEFAULT" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"effectiveBgpAlwaysCompareMed": { +"description": "Output only. [Output Only] Effective value of the bgp_always_compare_med\nfield.", +"readOnly": true, +"type": "boolean" +}, +"effectiveBgpInterRegionCost": { +"description": "Output only. [Output Only] Effective value of the bgp_inter_region_cost\nfield.", +"enum": [ +"ADD_COST_TO_MED", +"DEFAULT" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +}, +"routingMode": { +"description": "The network-wide routing mode to use. If set to REGIONAL,\nthis network's Cloud Routers will only advertise routes with subnets\nof this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise\nroutes with all subnets of this network, across regions.", +"enum": [ +"GLOBAL", +"REGIONAL" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworksAddPeeringRequest": { +"id": "NetworksAddPeeringRequest", +"properties": { +"autoCreateRoutes": { +"description": "This field will be deprecated soon. Useexchange_subnet_routes in network_peering\ninstead.\nIndicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", +"type": "boolean" +}, +"name": { +"annotations": { +"required": [ +"compute.networks.addPeering" +] +}, +"description": "Name of the peering, which should conform to RFC1035.", +"type": "string" +}, +"networkPeering": { +"$ref": "NetworkPeering", +"description": "Network peering parameters.\nIn order to specify route policies for peering using import and export\ncustom routes, you must specify all peering related parameters\n(name, peer network,exchange_subnet_routes) in the network_peering\nfield.\nThe corresponding fields in NetworksAddPeeringRequest will be\ndeprecated soon." +}, +"peerNetwork": { +"description": "URL of the peer network. It can be either full URL or partial URL. The\npeer network may belong to a different project. If the partial URL does not\ncontain project, it is assumed that the peer network is in the same project\nas the current network.", +"type": "string" +} +}, +"type": "object" +}, +"NetworksCancelRequestRemovePeeringRequest": { +"id": "NetworksCancelRequestRemovePeeringRequest", +"properties": { +"name": { +"description": "Name of the peering, which should conform to RFC1035.", +"type": "string" +} +}, +"type": "object" +}, +"NetworksGetEffectiveFirewallsResponse": { +"id": "NetworksGetEffectiveFirewallsResponse", +"properties": { +"firewallPolicys": { +"description": "[Output Only] Effective firewalls from firewall policy. It returns Global\nNetwork Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get\nRegional Network Firewall Policies as well.", +"items": { +"$ref": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy" +}, +"type": "array" +}, +"firewalls": { +"description": "Effective firewalls on the network.", +"items": { +"$ref": "Firewall" +}, +"type": "array" +} +}, +"type": "object" +}, +"NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { +"id": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", +"properties": { +"displayName": { +"deprecated": true, +"description": "Output only. [Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"packetMirroringRules": { +"description": "Output only. [Output Only] The packet mirroring rules that apply to the network.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"readOnly": true, +"type": "array" +}, +"priority": { +"description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"rules": { +"description": "[Output Only] The rules that apply to the network.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"type": "array" +}, +"shortName": { +"description": "Output only. [Output Only] The short name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"type": { +"description": "Output only. [Output Only] The type of the firewall policy.", +"enum": [ +"HIERARCHY", +"NETWORK", +"SYSTEM", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetworksRemovePeeringRequest": { +"id": "NetworksRemovePeeringRequest", +"properties": { +"name": { +"description": "Name of the peering, which should conform to RFC1035.", +"type": "string" +} +}, +"type": "object" +}, +"NetworksRequestRemovePeeringRequest": { +"id": "NetworksRequestRemovePeeringRequest", +"properties": { +"name": { +"description": "Name of the peering, which should conform to RFC1035.", +"type": "string" +} +}, +"type": "object" +}, +"NetworksUpdatePeeringRequest": { +"id": "NetworksUpdatePeeringRequest", +"properties": { +"networkPeering": { +"$ref": "NetworkPeering" +} +}, +"type": "object" +}, +"NodeGroup": { +"description": "Represents a sole-tenant Node Group resource.\n\nA sole-tenant node is a physical server that is dedicated to\nhosting VM instances only for your specific project. Use sole-tenant nodes to\nkeep your instances physically separated from instances in other projects, or\nto group your instances together on the same host hardware. For more\ninformation, readSole-tenant nodes.", +"id": "NodeGroup", +"properties": { +"autoscalingPolicy": { +"$ref": "NodeGroupAutoscalingPolicy", +"description": "Specifies how autoscaling should behave." +}, +"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": { +"format": "byte", +"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#nodeGroup", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.", +"readOnly": true, +"type": "string" +}, +"locationHint": { +"description": "An opaque location hint used to place the Node close to other\nresources.\nThis field is for use by internal tools that use the public API.\nThe location hint here on the NodeGroup overrides any location_hint\npresent in the NodeTemplate.", +"type": "string" +}, +"maintenanceInterval": { +"description": "Specifies the frequency of planned maintenance events. The accepted values\nare: `AS_NEEDED` and `RECURRENT`.", +"enum": [ +"AS_NEEDED", +"RECURRENT" +], +"enumDescriptions": [ +"VMs are eligible to receive infrastructure and hypervisor updates as they\nbecome available. This may result in more maintenance operations (live\nmigrations or terminations) for the VM than the PERIODIC andRECURRENT options.", +"VMs receive infrastructure and hypervisor updates on a periodic basis,\nminimizing the number of maintenance operations (live migrations or\nterminations) on an individual VM. This may mean a VM will take longer\nto receive an update than if it was configured forAS_NEEDED. Security updates will still be applied as soon\nas they are available. RECURRENT is used for GEN3 and Slice\nof Hardware VMs." +], +"type": "string" +}, +"maintenancePolicy": { +"description": "Specifies how to handle instances when a node in the group undergoes\nmaintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.\nThe default value is DEFAULT. For more information, see\nMaintenance policies.", +"enum": [ +"DEFAULT", +"MAINTENANCE_POLICY_UNSPECIFIED", +"MIGRATE_WITHIN_NODE_GROUP", +"RESTART_IN_PLACE" +], +"enumDescriptions": [ +"Allow the node and corresponding instances to retain default\nmaintenance behavior.", +"", +"When maintenance must be done on a node, the instances on that node will\nbe moved to other nodes in the group.\nInstances with onHostMaintenance = MIGRATE will live migrate to their\ndestinations while instances with onHostMaintenance = TERMINATE will\nterminate and then restart on their destination nodes if\nautomaticRestart = true.", +"Instances in this group will restart on the same node when maintenance\nhas completed. Instances must have onHostMaintenance = TERMINATE, and\nthey will only restart if automaticRestart = true." +], +"type": "string" +}, +"maintenanceWindow": { +"$ref": "NodeGroupMaintenanceWindow" +}, +"name": { +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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.", +"type": "string" +}, +"nodeTemplate": { +"description": "URL of the node template to create the node group from.", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"shareSettings": { +"$ref": "ShareSettings", +"description": "Share-settings for the node group" +}, +"size": { +"description": "Output only. [Output Only] The total number of nodes in the node group.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"status": { +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] The name of the zone where the node group resides,\nsuch as us-central1-a.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NodeGroupAggregatedList": { +"id": "NodeGroupAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NodeGroupsScopedList", +"description": "[Output Only] Name of the scope containing this set of node groups." +}, +"description": "A list of NodeGroupsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#nodeGroupAggregatedList", +"description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node\ngroups.", +"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" +}, +"NodeGroupAutoscalingPolicy": { +"id": "NodeGroupAutoscalingPolicy", +"properties": { +"maxNodes": { +"description": "The maximum number of nodes that the group should have. Must be set if\nautoscaling is enabled. Maximum value allowed is 100.", +"format": "int32", +"type": "integer" +}, +"minNodes": { +"description": "The minimum number of nodes that the group should have.", +"format": "int32", +"type": "integer" +}, +"mode": { +"description": "The autoscaling mode. Set to one of: ON, OFF,\nor ONLY_SCALE_OUT. For more information, see \nAutoscaler modes.", +"enum": [ +"MODE_UNSPECIFIED", +"OFF", +"ON", +"ONLY_SCALE_OUT" +], +"enumDescriptions": [ +"", +"Autoscaling is disabled.", +"Autocaling is fully enabled.", +"Autoscaling will only scale out and will not remove nodes." +], +"type": "string" +} +}, +"type": "object" +}, +"NodeGroupList": { +"description": "Contains a list of nodeGroups.", +"id": "NodeGroupList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NodeGroup resources.", +"items": { +"$ref": "NodeGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#nodeGroupList", +"description": "Output only. [Output Only] Type of resource.Always compute#nodeGroupList\nfor lists of node groups.", +"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.", +"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" +}, +"NodeGroupMaintenanceWindow": { +"description": "Time window specified for daily maintenance operations. GCE's internal\nmaintenance will be performed within this window.", +"id": "NodeGroupMaintenanceWindow", +"properties": { +"maintenanceDuration": { +"$ref": "Duration", +"description": "Output only. [Output only] A predetermined duration for the window, automatically\nchosen to be the smallest possible in the given scenario.", +"readOnly": true +}, +"startTime": { +"description": "Start time of the window. This must be in UTC format that resolves to one\nof 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For\nexample, both 13:00-5 and 08:00 are valid.", +"type": "string" +} +}, +"type": "object" +}, +"NodeGroupNode": { +"id": "NodeGroupNode", +"properties": { +"accelerators": { +"description": "Accelerators for this node.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"consumedResources": { +"$ref": "InstanceConsumptionInfo", +"description": "Output only. Node resources that are reserved by all instances.", +"readOnly": true +}, +"cpuOvercommitType": { +"description": "CPU overcommit.", +"enum": [ +"CPU_OVERCOMMIT_TYPE_UNSPECIFIED", +"ENABLED", +"NONE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"disks": { +"description": "Local disk configurations.", +"items": { +"$ref": "LocalDisk" +}, +"type": "array" +}, +"instanceConsumptionData": { +"description": "Output only. Instance data that shows consumed resources on the node.", +"items": { +"$ref": "InstanceConsumptionData" +}, +"readOnly": true, +"type": "array" +}, +"instances": { +"description": "Instances scheduled on this node.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"description": "The name of the node.", +"type": "string" +}, +"nodeType": { +"description": "The type of this node.", +"type": "string" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"serverBinding": { +"$ref": "ServerBinding", +"description": "Binding properties for the physical server." +}, +"serverId": { +"description": "Server ID associated with this node.", +"type": "string" +}, +"status": { +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY", +"REPAIRING" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"totalResources": { +"$ref": "InstanceConsumptionInfo", +"description": "Output only. Total amount of available resources on the node.", +"readOnly": true +}, +"upcomingMaintenance": { +"$ref": "UpcomingMaintenance", +"description": "Output only. [Output Only] The information about an upcoming maintenance event.", +"readOnly": true +} +}, +"type": "object" +}, +"NodeGroupsAddNodesRequest": { +"id": "NodeGroupsAddNodesRequest", +"properties": { +"additionalNodeCount": { +"description": "Count of additional nodes to be added to the node group.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"NodeGroupsDeleteNodesRequest": { +"id": "NodeGroupsDeleteNodesRequest", +"properties": { +"nodes": { +"description": "Names of the nodes to delete.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"NodeGroupsListNodes": { +"id": "NodeGroupsListNodes", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of Node resources.", +"items": { +"$ref": "NodeGroupNode" +}, +"type": "array" +}, +"kind": { +"default": "compute#nodeGroupsListNodes", +"description": "Output only. [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the\nspecified node group.", +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"NodeGroupsPerformMaintenanceRequest": { +"id": "NodeGroupsPerformMaintenanceRequest", +"properties": { +"nodes": { +"description": "[Required] List of nodes affected by the call.", +"items": { +"type": "string" +}, +"type": "array" +}, +"startTime": { +"description": "The start time of the schedule. The timestamp is an RFC3339 string.", +"type": "string" +} +}, +"type": "object" +}, +"NodeGroupsScopedList": { +"id": "NodeGroupsScopedList", +"properties": { +"nodeGroups": { +"description": "[Output Only] A list of node groups contained in this scope.", +"items": { +"$ref": "NodeGroup" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that appears when the nodeGroup\nlist 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.", +"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" +}, +"NodeGroupsSetNodeTemplateRequest": { +"id": "NodeGroupsSetNodeTemplateRequest", +"properties": { +"nodeTemplate": { +"description": "Full or partial URL of the node template resource to be updated for this\nnode group.", +"type": "string" +} +}, +"type": "object" +}, +"NodeGroupsSimulateMaintenanceEventRequest": { +"id": "NodeGroupsSimulateMaintenanceEventRequest", +"properties": { +"nodes": { +"description": "Names of the nodes to go under maintenance simulation.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"NodeTemplate": { +"description": "Represent a sole-tenant Node Template resource.\n\nYou can use a template to define properties for nodes in a node group. For\nmore information, readCreating node groups\nand instances.", +"id": "NodeTemplate", +"properties": { +"accelerators": { +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"cpuOvercommitType": { +"description": "CPU overcommit.", +"enum": [ +"CPU_OVERCOMMIT_TYPE_UNSPECIFIED", +"ENABLED", +"NONE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"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" +}, +"disks": { +"items": { +"$ref": "LocalDisk" +}, +"type": "array" +}, +"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#nodeTemplate", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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\ncannot be a dash.", +"type": "string" +}, +"nodeAffinityLabels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to use for node affinity, which will be used in instance scheduling.", +"type": "object" +}, +"nodeType": { +"description": "The node type to use for nodes group that are created from this template.", +"type": "string" +}, +"nodeTypeFlexibility": { +"$ref": "NodeTemplateNodeTypeFlexibility", +"description": "Do not use. Instead, use the node_type property." +}, +"region": { +"description": "Output only. [Output Only] The name of the region where the node template resides,\nsuch as us-central1.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"serverBinding": { +"$ref": "ServerBinding", +"description": "Sets the binding properties for the physical server. Valid values include:\n \n - *[Default]* RESTART_NODE_ON_ANY_SERVER:\n Restarts VMs on any available\n physical server\n - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same\n physical server whenever possible\n\n\n\nSee Sole-tenant\nnode options for more information." +}, +"status": { +"description": "Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY" +], +"enumDescriptions": [ +"Resources are being allocated.", +"The node template is currently being deleted.", +"Invalid status.", +"The node template is ready." +], +"readOnly": true, +"type": "string" +}, +"statusMessage": { +"description": "Output only. [Output Only] An optional, human-readable explanation of the status.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NodeTemplateAggregatedList": { +"id": "NodeTemplateAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NodeTemplatesScopedList", +"description": "[Output Only] Name of the scope containing this set of node templates." +}, +"description": "A list of NodeTemplatesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#nodeTemplateAggregatedList", +"description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of\nnode templates.", +"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" +}, +"NodeTemplateList": { +"description": "Contains a list of node templates.", +"id": "NodeTemplateList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NodeTemplate resources.", +"items": { +"$ref": "NodeTemplate" +}, +"type": "array" +}, +"kind": { +"default": "compute#nodeTemplateList", +"description": "Output only. [Output Only] Type of resource.Always compute#nodeTemplateList\nfor lists of node templates.", +"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.", +"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" +}, +"NodeTemplateNodeTypeFlexibility": { +"id": "NodeTemplateNodeTypeFlexibility", +"properties": { +"cpus": { +"type": "string" +}, +"localSsd": { +"type": "string" +}, +"memory": { +"type": "string" +} +}, +"type": "object" +}, +"NodeTemplatesScopedList": { +"id": "NodeTemplatesScopedList", +"properties": { +"nodeTemplates": { +"description": "[Output Only] A list of node templates contained in this scope.", +"items": { +"$ref": "NodeTemplate" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that appears when the node templates\nlist 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.", +"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" +}, +"NodeType": { +"description": "Represent a sole-tenant Node Type resource.\n\nEach node within a node group must have a node type. A node type specifies\nthe total amount of cores and memory for that node. Currently, the only\navailable node type is n1-node-96-624 node type that has 96\nvCPUs and 624 GB of memory, available in multiple zones. For more information\nreadNode types.", +"id": "NodeType", +"properties": { +"cpuPlatform": { +"description": "[Output Only] The CPU platform used by this node type.", +"type": "string" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this node type." +}, +"description": { +"description": "[Output Only] An optional textual description of the resource.", +"type": "string" +}, +"guestCpus": { +"description": "[Output Only] The number of virtual CPUs that are available to the node\ntype.", +"format": "int32", +"type": "integer" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#nodeType", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeType for node types.", +"readOnly": true, +"type": "string" +}, +"localSsdGb": { +"description": "[Output Only] Local SSD available to the node type, defined in GB.", +"format": "int32", +"type": "integer" +}, +"maxVms": { +"description": "Output only. [Output Only] Maximum number of VMs that can be created for this node type.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"memoryMb": { +"description": "[Output Only] The amount of physical memory available to the node type,\ndefined in MB.", +"format": "int32", +"type": "integer" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"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" +}, +"zone": { +"description": "Output only. [Output Only] The name of the zone where the node type resides,\nsuch as us-central1-a.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NodeTypeAggregatedList": { +"id": "NodeTypeAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NodeTypesScopedList", +"description": "[Output Only] Name of the scope containing this set of node types." +}, +"description": "A list of NodeTypesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#nodeTypeAggregatedList", +"description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node\ntypes.", +"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" +}, +"NodeTypeList": { +"description": "Contains a list of node types.", +"id": "NodeTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NodeType resources.", +"items": { +"$ref": "NodeType" +}, +"type": "array" +}, +"kind": { +"default": "compute#nodeTypeList", +"description": "Output only. [Output Only] Type of resource.Always compute#nodeTypeList for\nlists of node types.", +"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.", +"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" +}, +"NodeTypesScopedList": { +"id": "NodeTypesScopedList", +"properties": { +"nodeTypes": { +"description": "[Output Only] A list of node types contained in this scope.", +"items": { +"$ref": "NodeType" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] An informational warning that appears when the node types\nlist 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.", +"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" +}, +"NotificationEndpoint": { +"description": "Represents a notification endpoint.\n\nA notification endpoint resource defines an endpoint to receive notifications\nwhen there are status changes detected by the associated health check\nservice.\n\nFor more information, see\nHealth checks overview.", +"id": "NotificationEndpoint", +"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" +}, +"grpcSettings": { +"$ref": "NotificationEndpointGrpcSettings", +"description": "Settings of the gRPC notification endpoint including the endpoint URL and\nthe retry duration." +}, +"id": { +"description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#notificationEndpoint", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the notification endpoint resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NotificationEndpointAggregatedList": { +"description": "Contains a list of NotificationEndpointsScopedList.", +"id": "NotificationEndpointAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "NotificationEndpointsScopedList", +"description": "Name of the scope containing this set of NotificationEndpoints." +}, +"description": "A list of NotificationEndpointsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#notificationEndpointAggregatedList", +"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" +}, +"NotificationEndpointGrpcSettings": { +"description": "Represents a gRPC setting that describes one gRPC notification endpoint and\nthe retry duration attempting to send notification to this endpoint.", +"id": "NotificationEndpointGrpcSettings", +"properties": { +"authority": { +"description": "Optional. If specified, this field is used to set the authority header by\nthe sender of notifications. See\nhttps://tools.ietf.org/html/rfc7540#section-8.1.2.3", +"type": "string" +}, +"endpoint": { +"description": "Endpoint to which gRPC notifications are sent. This must be a valid\ngRPCLB DNS name.", +"type": "string" +}, +"payloadName": { +"description": "Optional. If specified, this field is used to populate the \"name\" field\nin gRPC requests.", +"type": "string" +}, +"resendInterval": { +"$ref": "Duration", +"description": "Optional. This field is used to configure how often to send a full update\nof all non-healthy backends. If unspecified, full updates are not sent.\nIf specified, must be in the range between 600 seconds to 3600 seconds.\nNanos are disallowed. Can only be set for regional notification\nendpoints." +}, +"retryDurationSec": { +"description": "How much time (in seconds) is spent attempting notification retries\nuntil a successful response is received. Default is 30s. Limit is 20m\n(1200s). Must be a positive number.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"NotificationEndpointList": { +"id": "NotificationEndpointList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of NotificationEndpoint resources.", +"items": { +"$ref": "NotificationEndpoint" +}, +"type": "array" +}, +"kind": { +"default": "compute#notificationEndpointList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.", +"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] Server-defined URL for this resource.", +"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" +}, +"NotificationEndpointsScopedList": { +"id": "NotificationEndpointsScopedList", +"properties": { +"resources": { +"description": "A list of NotificationEndpoints contained in this scope.", +"items": { +"$ref": "NotificationEndpoint" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nnotification endpoints 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.", +"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" +}, +"Operation": { +"description": "Represents an Operation resource.\n\nGoogle Compute Engine has three Operation resources:\n\n* [Global](/compute/docs/reference/rest/v1/globalOperations)\n* [Regional](/compute/docs/reference/rest/v1/regionOperations)\n* [Zonal](/compute/docs/reference/rest/v1/zoneOperations)\n\nYou can use an operation resource to manage asynchronous API requests.\nFor more information, readHandling\nAPI responses.\n\nOperations can be global, regional or zonal.\n \n - For global operations, use the `globalOperations`\n resource. \n - For regional operations, use the\n `regionOperations` resource. \n - For zonal operations, use\n the `zoneOperations` resource.\n\n\n\nFor more information, read\nGlobal, Regional, and Zonal Resources.\n\nNote that completed Operation resources have a limited \nretention period.", +"id": "Operation", +"properties": { +"clientOperationId": { +"description": "[Output Only] The value of `requestId` if you provided it in the request.\nNot present otherwise.", +"type": "string" +}, +"creationTimestamp": { +"description": "[Deprecated] This field is deprecated.", +"type": "string" +}, +"description": { +"description": "[Output Only] A textual description of the operation, which is\nset when the operation is created.", +"type": "string" +}, +"endTime": { +"description": "[Output Only] The time that this operation was completed. This value is inRFC3339\ntext format.", +"type": "string" +}, +"error": { +"description": "[Output Only] If errors are generated during processing of the operation,\nthis field will be populated.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"description": "Represents a single error encountered during the processing of an\noperation.", +"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": { +"description": "Container for structured error details providing additional context\nspecific to the encountered error code.", +"properties": { +"errorInfo": { +"$ref": "ErrorInfo", +"description": "Error information containing structured domain, reason, and metadata." +}, +"help": { +"$ref": "Help", +"description": "Links and information to help the user resolve the error." +}, +"localizedMessage": { +"$ref": "LocalizedMessage", +"description": "A localized human-readable error message intended for end users." +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo", +"description": "Details about quota limits and metrics when a quota is exceeded." +} +}, +"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" +}, +"getHealthOperationMetadata": { +"$ref": "GetHealthOperationMetadata", +"description": "Output only. Metadata for GetHealth operations.", +"readOnly": true +}, +"getVersionOperationMetadata": { +"$ref": "GetVersionOperationMetadata" +}, +"httpErrorMessage": { +"description": "[Output Only] If the operation fails, this field contains the HTTP error\nmessage that was returned, such as `NOT FOUND`.", +"type": "string" +}, +"httpErrorStatusCode": { +"description": "[Output Only] If the operation fails, this field contains the HTTP error\nstatus code that was returned. For example, a `404` means the\nresource was not found.", +"format": "int32", +"type": "integer" +}, +"id": { +"description": "[Output Only] The unique identifier for the operation. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"insertTime": { +"description": "[Output Only] The time that this operation was requested.\nThis value is inRFC3339\ntext format.", +"type": "string" +}, +"instancesBulkInsertOperationMetadata": { +"$ref": "InstancesBulkInsertOperationMetadata" +}, +"kind": { +"default": "compute#operation", +"description": "Output only. [Output Only] Type of the resource. Always `compute#operation` for\nOperation resources.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "[Output Only] Name of the operation.", +"type": "string" +}, +"operationGroupId": { +"description": "Output only. [Output Only] An ID that represents a group of operations, such as when a\ngroup of operations results from a `bulkInsert` API request.", +"readOnly": true, +"type": "string" +}, +"operationType": { +"description": "[Output Only] The type of operation, such as `insert`,\n`update`, or `delete`, and so on.", +"type": "string" +}, +"progress": { +"description": "[Output Only] An optional progress indicator that ranges from 0 to 100.\nThere is no requirement that this be linear or support any granularity of\noperations. This should not be used to guess when the operation will be\ncomplete. This number should monotonically increase as the operation\nprogresses.", +"format": "int32", +"type": "integer" +}, +"region": { +"description": "[Output Only] The URL of the region where the operation resides. Only\napplicable when performing regional operations.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"setCommonInstanceMetadataOperationMetadata": { +"$ref": "SetCommonInstanceMetadataOperationMetadata", +"description": "Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,\nthis field will contain information on all underlying zonal actions and\ntheir state.", +"readOnly": true +}, +"startTime": { +"description": "[Output Only] The time that this operation was started by the server.\nThis value is inRFC3339\ntext format.", +"type": "string" +}, +"status": { +"description": "[Output Only] The status of the operation, which can be one of the\nfollowing:\n`PENDING`, `RUNNING`, or `DONE`.", +"enum": [ +"DONE", +"PENDING", +"RUNNING" +], +"enumDescriptions": [ +"The operation has completed processing successfully or with an error.", +"The operation is waiting to be processed.", +"The operation is actively being processed." +], +"type": "string" +}, +"statusMessage": { +"description": "[Output Only] An optional textual description of the current status of the\noperation.", +"type": "string" +}, +"targetId": { +"description": "[Output Only] The unique target ID, which identifies a specific incarnation\nof the target resource.", +"format": "uint64", +"type": "string" +}, +"targetLink": { +"description": "[Output Only] The URL of the resource that the operation modifies. For\noperations related to creating a snapshot, this points to the disk\nthat the snapshot was created from.", +"type": "string" +}, +"user": { +"description": "[Output Only] User who requested the operation, for example:\n`user@example.com` or\n`alice_smith_identifier (global/workforcePools/example-com-us-employees)`.", +"type": "string" +}, +"warnings": { +"description": "[Output Only] If warning messages are generated during processing of the\noperation, this field will be populated.", +"items": { +"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": "array" +}, +"zone": { +"description": "[Output Only] The URL of the zone where the operation resides. Only\napplicable when performing per-zone operations.", +"type": "string" +} +}, +"type": "object" +}, +"OperationAggregatedList": { +"id": "OperationAggregatedList", +"properties": { +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "OperationsScopedList", +"description": "[Output Only] Name of the scope containing this set of operations." +}, +"description": "[Output Only] A map of scoped operation lists.", +"type": "object" +}, +"kind": { +"default": "compute#operationAggregatedList", +"description": "Output only. [Output Only] Type of resource. Always `compute#operationAggregatedList`\nfor aggregated lists of operations.", +"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 than\n`maxResults`, 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] Server-defined URL for this resource.", +"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" +}, +"OperationList": { +"description": "Contains a list of Operation resources.", +"id": "OperationList", +"properties": { +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"description": "[Output Only] A list of Operation resources.", +"items": { +"$ref": "Operation" +}, +"type": "array" +}, +"kind": { +"default": "compute#operationList", +"description": "Output only. [Output Only] Type of resource. Always `compute#operations` for Operations\nresource.", +"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 than\n`maxResults`, 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] Server-defined URL for this resource.", +"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" +}, +"OperationsScopedList": { +"id": "OperationsScopedList", +"properties": { +"operations": { +"description": "[Output Only] A list of operations contained in this scope.", +"items": { +"$ref": "Operation" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of operations\nwhen 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.", +"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" +}, +"OrganizationSecurityPoliciesListAssociationsResponse": { +"id": "OrganizationSecurityPoliciesListAssociationsResponse", +"properties": { +"associations": { +"description": "A list of associations.", +"items": { +"$ref": "SecurityPolicyAssociation" +}, +"type": "array" +}, +"kind": { +"default": "compute#organizationSecurityPoliciesListAssociationsResponse", +"description": "Output only. [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists\nof securityPolicy associations.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"OutlierDetection": { +"description": "Settings controlling the eviction of unhealthy hosts from the load balancing\npool for the backend service.", +"id": "OutlierDetection", +"properties": { +"baseEjectionTime": { +"$ref": "Duration", +"description": "The base time that a backend endpoint is ejected for. Defaults to 30000ms\nor 30s.\n\nAfter a backend endpoint is returned back to the load balancing pool, it\ncan be ejected again in another ejection analysis. Thus, the total ejection\ntime is equal to the base ejection time multiplied by the number of times\nthe backend endpoint has been ejected. Defaults to 30000ms or 30s." +}, +"consecutiveErrors": { +"description": "Number of consecutive errors before a backend endpoint is ejected from the\nload balancing pool. When the backend endpoint is accessed over HTTP, a 5xx\nreturn code qualifies as an error. Defaults to 5.", +"format": "int32", +"type": "integer" +}, +"consecutiveGatewayFailure": { +"description": "The number of consecutive gateway failures (502, 503, 504 status or\nconnection errors that are mapped to one of those status codes) before a\nconsecutive gateway failure ejection occurs. Defaults to 3.", +"format": "int32", +"type": "integer" +}, +"enforcingConsecutiveErrors": { +"description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through consecutive 5xx. This setting can be\nused to disable ejection or to ramp it up slowly. Defaults to 0.", +"format": "int32", +"type": "integer" +}, +"enforcingConsecutiveGatewayFailure": { +"description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through consecutive gateway failures. This\nsetting can be used to disable ejection or to ramp it up slowly. Defaults\nto 100.", +"format": "int32", +"type": "integer" +}, +"enforcingSuccessRate": { +"description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through success rate statistics. This setting\ncan be used to disable ejection or to ramp it up slowly. Defaults to 100.\n\nNot supported when the backend service uses Serverless NEG.", +"format": "int32", +"type": "integer" +}, +"interval": { +"$ref": "Duration", +"description": "Time interval between ejection analysis sweeps. This can result in both new\nejections and backend endpoints being returned to service. The interval is\nequal to the number of seconds as defined in\noutlierDetection.interval.seconds plus the number of nanoseconds as defined\nin outlierDetection.interval.nanos. Defaults to 1 second." +}, +"maxEjectionPercent": { +"description": "Maximum percentage of backend endpoints in the load balancing pool for the\nbackend service that can be ejected if the ejection conditions are met.\nDefaults to 50%.", +"format": "int32", +"type": "integer" +}, +"successRateMinimumHosts": { +"description": "The number of backend endpoints in the load balancing pool that must have\nenough request volume to detect success rate outliers. If the number of\nbackend endpoints is fewer than this setting, outlier detection via success\nrate statistics is not performed for any backend endpoint in the load\nbalancing pool. Defaults to 5.\n\nNot supported when the backend service uses Serverless NEG.", +"format": "int32", +"type": "integer" +}, +"successRateRequestVolume": { +"description": "The minimum number of total requests that must be collected in one interval\n(as defined by the interval duration above) to include this backend\nendpoint in success rate based outlier detection. If the volume is lower\nthan this setting, outlier detection via success rate statistics is not\nperformed for that backend endpoint. Defaults to 100.\n\nNot supported when the backend service uses Serverless NEG.", +"format": "int32", +"type": "integer" +}, +"successRateStdevFactor": { +"description": "This factor is used to determine the ejection threshold for success rate\noutlier ejection. The ejection threshold is the difference between the mean\nsuccess rate, and the product of this factor and the standard deviation of\nthe mean success rate: mean - (stdev * successRateStdevFactor). This factor\nis divided by a thousand to get a double. That is, if the desired factor\nis 1.9, the runtime value should be 1900. Defaults to 1900.\n\nNot supported when the backend service uses Serverless NEG.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"PacketIntervals": { +"description": "Next free: 7", +"id": "PacketIntervals", +"properties": { +"avgMs": { +"description": "Average observed inter-packet interval in milliseconds.", +"format": "int64", +"type": "string" +}, +"duration": { +"description": "From how long ago in the past these intervals were observed.", +"enum": [ +"DURATION_UNSPECIFIED", +"HOUR", +"MAX", +"MINUTE" +], +"enumDescriptions": [ +"", +"", +"From BfdSession object creation time.", +"" +], +"type": "string" +}, +"maxMs": { +"description": "Maximum observed inter-packet interval in milliseconds.", +"format": "int64", +"type": "string" +}, +"minMs": { +"description": "Minimum observed inter-packet interval in milliseconds.", +"format": "int64", +"type": "string" +}, +"numIntervals": { +"description": "Number of inter-packet intervals from which these statistics were derived.", +"format": "int64", +"type": "string" +}, +"type": { +"description": "The type of packets for which inter-packet intervals were computed.", +"enum": [ +"LOOPBACK", +"RECEIVE", +"TRANSMIT", +"TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Only applies to Echo packets. This shows the intervals between sending\nand receiving the same packet.", +"Intervals between received packets.", +"Intervals between transmitted packets.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroring": { +"description": "Represents a Packet Mirroring resource.\n\nPacket Mirroring clones the traffic of specified instances in your Virtual\nPrivate Cloud (VPC) network and forwards it to a collector destination,\nsuch as an instance group of an internal TCP/UDP load balancer, for analysis\nor examination.\nFor more information about setting up Packet Mirroring, seeUsing Packet Mirroring.", +"id": "PacketMirroring", +"properties": { +"collectorIlb": { +"$ref": "PacketMirroringForwardingRuleInfo", +"description": "The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector\nfor mirrored traffic.\nThe specified forwarding rule must have isMirroringCollector\nset to true." +}, +"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" +}, +"enable": { +"description": "Indicates whether or not this packet mirroring takes effect.\nIf set to FALSE, this packet mirroring policy will not be enforced on the\nnetwork.\n\nThe default is TRUE.", +"enum": [ +"FALSE", +"TRUE" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"filter": { +"$ref": "PacketMirroringFilter", +"description": "Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored." +}, +"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#packetMirroring", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.", +"readOnly": true, +"type": "string" +}, +"mirroredResources": { +"$ref": "PacketMirroringMirroredResourceInfo", +"description": "PacketMirroring mirroredResourceInfos.\nMirroredResourceInfo specifies a set of mirrored VM instances, subnetworks\nand/or tags for which traffic from/to all VM instances will be mirrored." +}, +"name": { +"annotations": { +"required": [ +"compute.packetMirrorings.insert" +] +}, +"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 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" +}, +"network": { +"$ref": "PacketMirroringNetworkInfo", +"annotations": { +"required": [ +"compute.packetMirrorings.insert" +] +}, +"description": "Specifies the mirrored VPC network. Only packets in this network will be\nmirrored. All mirrored VMs should have a NIC in the given network.\nAll mirrored subnetworks should belong to the given network." +}, +"priority": { +"description": "The priority of applying this configuration. Priority is used to break ties\nin cases where there is more than one matching rule. In the case of two\nrules that apply for a given Instance, the one with the lowest-numbered\npriority value wins.\n\nDefault value is 1000. Valid range is 0 through 65535.", +"format": "uint32", +"type": "integer" +}, +"region": { +"description": "[Output Only] URI of the region where the packetMirroring resides.", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringAggregatedList": { +"description": "Contains a list of packetMirrorings.", +"id": "PacketMirroringAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "PacketMirroringsScopedList", +"description": "Name of the scope containing this set of packetMirrorings." +}, +"description": "A list of PacketMirroring resources.", +"type": "object" +}, +"kind": { +"default": "compute#packetMirroringAggregatedList", +"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" +}, +"PacketMirroringFilter": { +"id": "PacketMirroringFilter", +"properties": { +"IPProtocols": { +"description": "Protocols that apply as filter on mirrored traffic.\nIf no protocols are specified, all traffic that matches the specified\nCIDR ranges is mirrored.\nIf neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is\nmirrored.", +"items": { +"type": "string" +}, +"type": "array" +}, +"cidrRanges": { +"description": "One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source\n(ingress) or destination (egress) IP in the IP header. If no ranges are\nspecified, all IPv4 traffic that matches the specified IPProtocols is\nmirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4\ntraffic is mirrored. To mirror all IPv4 and IPv6 traffic, use\n\"0.0.0.0/0,::/0\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"direction": { +"description": "Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.\nThe default is BOTH.", +"enum": [ +"BOTH", +"EGRESS", +"INGRESS" +], +"enumDescriptions": [ +"Default, both directions are mirrored.", +"Only egress traffic is mirrored.", +"Only ingress traffic is mirrored." +], +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringForwardingRuleInfo": { +"id": "PacketMirroringForwardingRuleInfo", +"properties": { +"canonicalUrl": { +"description": "Output only. [Output Only] Unique identifier for the forwarding rule; defined by the\nserver.", +"readOnly": true, +"type": "string" +}, +"url": { +"description": "Resource URL to the forwarding rule representing the ILB\nconfigured as destination of the mirrored traffic.", +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringList": { +"description": "Contains a list of PacketMirroring resources.", +"id": "PacketMirroringList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of PacketMirroring resources.", +"items": { +"$ref": "PacketMirroring" +}, +"type": "array" +}, +"kind": { +"default": "compute#packetMirroringList", +"description": "Output only. [Output Only] Type of resource. Always compute#packetMirroring\nfor packetMirrorings.", +"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.", +"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" +}, +"PacketMirroringMirroredResourceInfo": { +"id": "PacketMirroringMirroredResourceInfo", +"properties": { +"instances": { +"description": "A set of virtual machine instances that are being mirrored.\nThey must live in zones contained in the same region as this\npacketMirroring.\n\nNote that this config will apply only to those network interfaces of the\nInstances that belong to the network specified in this packetMirroring.\n\nYou may specify a maximum of 50 Instances.", +"items": { +"$ref": "PacketMirroringMirroredResourceInfoInstanceInfo" +}, +"type": "array" +}, +"subnetworks": { +"description": "A set of subnetworks for which traffic from/to all VM instances will be\nmirrored. They must live in the same region as this packetMirroring.\n\nYou may specify a maximum of 5 subnetworks.", +"items": { +"$ref": "PacketMirroringMirroredResourceInfoSubnetInfo" +}, +"type": "array" +}, +"tags": { +"description": "A set of mirrored tags. Traffic from/to all VM instances that have one or\nmore of these tags will be mirrored.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"PacketMirroringMirroredResourceInfoInstanceInfo": { +"id": "PacketMirroringMirroredResourceInfoInstanceInfo", +"properties": { +"canonicalUrl": { +"description": "Output only. [Output Only] Unique identifier for the instance; defined by the\nserver.", +"readOnly": true, +"type": "string" +}, +"url": { +"description": "Resource URL to the virtual machine instance which is being mirrored.", +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringMirroredResourceInfoSubnetInfo": { +"id": "PacketMirroringMirroredResourceInfoSubnetInfo", +"properties": { +"canonicalUrl": { +"description": "Output only. [Output Only] Unique identifier for the subnetwork; defined by the\nserver.", +"readOnly": true, +"type": "string" +}, +"url": { +"description": "Resource URL to the subnetwork for which\ntraffic from/to all VM instances will be mirrored.", +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringNetworkInfo": { +"id": "PacketMirroringNetworkInfo", +"properties": { +"canonicalUrl": { +"description": "Output only. [Output Only] Unique identifier for the network; defined by the server.", +"readOnly": true, +"type": "string" +}, +"url": { +"description": "URL of the network resource.", +"type": "string" +} +}, +"type": "object" +}, +"PacketMirroringsScopedList": { +"id": "PacketMirroringsScopedList", +"properties": { +"packetMirrorings": { +"description": "A list of packetMirrorings contained in this scope.", +"items": { +"$ref": "PacketMirroring" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of packetMirrorings when the\nlist 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.", +"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" +}, +"PathMatcher": { +"description": "A matcher for the path portion of the URL. The BackendService\nfrom the longest-matched rule will serve the URL. If no rule was matched, the\ndefault service is used.", +"id": "PathMatcher", +"properties": { +"defaultCustomErrorResponsePolicy": { +"$ref": "CustomErrorResponsePolicy", +"description": "defaultCustomErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nThis policy takes\neffect at the PathMatcher level and applies only when no\npolicy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined\nin defaultCustomErrorResponsePolicy, then a policy defined for\nthe error code in UrlMap.defaultCustomErrorResponsePolicy\ntakes effect. \n\nFor example, consider a UrlMap with the following\nconfiguration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy is configured\n with policies for 5xx and 4xx errors\n - A RouteRule for /coming_soon/ is configured for the\n error code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in RouteRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. \n\nWhen\nused in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take\nprecedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the defaultCustomErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ndefaultCustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." +}, +"defaultRouteAction": { +"$ref": "HttpRouteAction", +"description": "defaultRouteAction takes effect when none of the \npathRules or routeRules match. The load balancer\nperforms advanced routing actions, such as URL rewrites and\nheader transformations, before forwarding the request to the\nselected backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a path matcher'sdefaultRouteAction." +}, +"defaultService": { +"description": "The full or partial URL to the BackendService resource. This\nURL is used if none of the pathRules orrouteRules defined by this PathMatcher are\nmatched. For example, the\nfollowing are all valid URLs to a BackendService resource:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService\n - compute/v1/projects/project/global/backendServices/backendService\n - global/backendServices/backendService\n\n\nIf defaultRouteAction is also specified, advanced\nrouting actions, such as URL rewrites, take effect before sending the\nrequest to the backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nAuthorization requires one or more of the following Google IAM permissions on the\nspecified resource default_service: \n \n \n - compute.backendBuckets.use\n - compute.backendServices.use", +"type": "string" +}, +"defaultUrlRedirect": { +"$ref": "HttpRedirectAction", +"description": "When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified\nby defaultUrlRedirect.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"headerAction": { +"$ref": "HttpHeaderAction", +"description": "Specifies changes to request and response headers that need to take effect\nfor the selected backend service.\n\nHeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap\n\nHeaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." +}, +"name": { +"description": "The name to which this PathMatcher is referred by theHostRule.", +"type": "string" +}, +"pathRules": { +"description": "The list of path rules. Use this list instead of routeRules\nwhen routing based on simple path matching is all that's required. A path\nrule can only include a wildcard character (*) after a\nforward slash character (\"/\").\n\nThe order by which path rules are specified does not matter.\nMatches are always done on the longest-path-first basis.\n\nFor example: a pathRule with a path /a/b/c/* will match\nbefore /a/b/* irrespective of the order in which those paths appear in this\nlist.\n\nWithin a given pathMatcher, only one ofpathRules or routeRules must be set.", +"items": { +"$ref": "PathRule" +}, +"type": "array" +}, +"routeRules": { +"description": "The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are\ndesired. routeRules are evaluated in order of priority, from\nthe lowest to highest number.\n\nWithin a given pathMatcher, you can set only one ofpathRules or routeRules.", +"items": { +"$ref": "HttpRouteRule" +}, +"type": "array" +} +}, +"type": "object" +}, +"PathRule": { +"description": "A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.", +"id": "PathRule", +"properties": { +"customErrorResponsePolicy": { +"$ref": "CustomErrorResponsePolicy", +"description": "customErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nIf a policy for an\nerror code is not configured for the PathRule, a policy for\nthe error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If\none is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy\nconfigured in UrlMap.defaultCustomErrorResponsePolicy takes\neffect. \n\nFor example, consider a UrlMap with the following configuration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy are configured\n with policies for 5xx and 4xx errors\n - A PathRule for /coming_soon/ is configured for the error\n code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in PathRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.\n\ncustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." +}, +"paths": { +"description": "The list of path patterns to match. Each must start with /\nand the only place a * is allowed is at the end following\na /. The string fed to the path matcher does not include\nany text after the first ? or #, and\nthose chars are not allowed here.", +"items": { +"type": "string" +}, +"type": "array" +}, +"routeAction": { +"$ref": "HttpRouteAction", +"description": "In response to a matching path, the load balancer\nperforms advanced routing actions, such as URL rewrites and header\ntransformations, before forwarding the request to the selected\nbackend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a path rule'srouteAction." +}, +"service": { +"description": "The full or partial URL of the backend service resource to which traffic\nis directed if this rule is matched. If routeAction is\nalso specified, advanced routing actions, such as URL rewrites,\ntake effect before sending the request to the backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.", +"type": "string" +}, +"urlRedirect": { +"$ref": "HttpRedirectAction", +"description": "When a path pattern is matched, the request is redirected to a URL\nspecified by urlRedirect.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." +} +}, +"type": "object" +}, +"PerInstanceConfig": { +"id": "PerInstanceConfig", +"properties": { +"fingerprint": { +"description": "Fingerprint of this per-instance config. This field can be used in\noptimistic locking. It is ignored when inserting a per-instance\nconfig. An up-to-date fingerprint must be provided in order to update an\nexisting per-instance configuration or the field needs to be unset.", +"format": "byte", +"type": "string" +}, +"name": { +"description": "The name of a per-instance configuration and its corresponding instance.\nServes as a merge key during UpdatePerInstanceConfigs\noperations, that is, if a per-instance configuration with the same name\nexists then it will be updated, otherwise a new one will be created for the\nVM instance with the same name. An attempt to create a per-instance\nconfiguration for a VM instance that either doesn't exist or is not part\nof the group will result in an error.", +"type": "string" +}, +"preservedState": { +"$ref": "PreservedState", +"description": "The intended preserved state for the given instance. Does not contain\npreserved state generated from a stateful policy." +}, +"status": { +"description": "The status of applying this per-instance configuration on the corresponding\nmanaged instance.", +"enum": [ +"APPLYING", +"DELETING", +"EFFECTIVE", +"NONE", +"UNAPPLIED", +"UNAPPLIED_DELETION" +], +"enumDescriptions": [ +"The per-instance configuration is being applied to the instance, but is\nnot yet effective, possibly waiting for the instance to, for example,REFRESH.", +"The per-instance configuration deletion is being applied on the instance,\npossibly waiting for the instance to, for example, REFRESH.", +"The per-instance configuration is effective on the instance, meaning that\nall disks, ips and metadata specified in this configuration are attached\nor set on the instance.", +"*[Default]* The default status, when no per-instance configuration\nexists.", +"The per-instance configuration is set on an instance but not been applied\nyet.", +"The per-instance configuration has been deleted, but the deletion is not\nyet applied." +], +"type": "string" +} +}, +"type": "object" +}, +"PeriodicPartialMaintenanceSchedule": { +"description": "The periodic partial maintenance schedule includes 52 weeks worth of\nmaintenance windows.\nLINT.IfChange(PeriodicPartialMaintenanceSchedule)", +"id": "PeriodicPartialMaintenanceSchedule", +"properties": { +"subType": { +"description": "The maintenance type in which the zone is during the given window.", +"enum": [ +"MAINTENANCE_SUBTYPE_UNSPECIFIED", +"MAINTENANCE_TYPE_CUSTOMER_MAINTENANCE", +"MAINTENANCE_TYPE_DISRUPTIVE_UPGRADE", +"MAINTENANCE_TYPE_STABLE", +"MAINTENANCE_TYPE_TRANSITION" +], +"enumDescriptions": [ +"Default value.", +"A dedicated window for customers to perform their own maintenance. This\noften runs concurrently with a DISRUPTIVE_UPGRADE.", +"For disruptive updates, including host machine kernel or firmware\nupgrades.", +"A post-maintenance window for customers to conduct final testing and\nperformance validation before resuming full business operations.", +"For preliminary, non-disruptive tasks such as key rotations." +], +"type": "string" +}, +"targetResource": { +"description": "The target resource that the maintenance window is for.\nFor example, \"projects/my-project/zones/us-central1-a\".", +"type": "string" +}, +"type": { +"enum": [ +"MAINTENANCE_TYPE_UNSPECIFIED", +"PRIVATE_ZONE_MAINTENANCE" +], +"enumDescriptions": [ +"Default value.", +"The zone is in a private maintenance window." +], +"type": "string" +}, +"windowEndTime": { +"$ref": "DateTime", +"description": "The end civil timestamp of the window (not inclusive).\nThis contains a time zone." +}, +"windowStartTime": { +"$ref": "DateTime", +"description": "The start civil timestamp of the window.\nThis contains a time zone." +} +}, +"type": "object" +}, +"Policy": { +"description": "An Identity and Access Management (IAM) policy, which specifies access\ncontrols for Google Cloud resources.\n\n\nA `Policy` is a collection of `bindings`. A `binding` binds one or more\n`members`, or principals, to a single `role`. Principals can be user\naccounts, service accounts, Google groups, and domains (such as G Suite). A\n`role` is a named list of permissions; each `role` can be an IAM predefined\nrole or a user-created custom role.\n\nFor some types of Google Cloud resources, a `binding` can also specify a\n`condition`, which is a logical expression that allows access to a resource\nonly if the expression evaluates to `true`. A condition can add constraints\nbased on attributes of the request, the resource, or both. To learn which\nresources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).\n\n**JSON example:**\n\n```\n {\n \"bindings\": [\n {\n \"role\": \"roles/resourcemanager.organizationAdmin\",\n \"members\": [\n \"user:mike@example.com\",\n \"group:admins@example.com\",\n \"domain:google.com\",\n \"serviceAccount:my-project-id@appspot.gserviceaccount.com\"\n ]\n },\n {\n \"role\": \"roles/resourcemanager.organizationViewer\",\n \"members\": [\n \"user:eve@example.com\"\n ],\n \"condition\": {\n \"title\": \"expirable access\",\n \"description\": \"Does not grant access after Sep 2020\",\n \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\",\n }\n }\n ],\n \"etag\": \"BwWWja0YfJA=\",\n \"version\": 3\n }\n```\n\n**YAML example:**\n\n```\n bindings:\n - members:\n - user:mike@example.com\n - group:admins@example.com\n - domain:google.com\n - serviceAccount:my-project-id@appspot.gserviceaccount.com\n role: roles/resourcemanager.organizationAdmin\n - members:\n - user:eve@example.com\n role: roles/resourcemanager.organizationViewer\n condition:\n title: expirable access\n description: Does not grant access after Sep 2020\n expression: request.time < timestamp('2020-10-01T00:00:00.000Z')\n etag: BwWWja0YfJA=\n version: 3\n```\n\nFor a description of IAM and its features, see the\n[IAM documentation](https://cloud.google.com/iam/docs/).", +"id": "Policy", +"properties": { +"auditConfigs": { +"description": "Specifies cloud audit logging configuration for this policy.", +"items": { +"$ref": "AuditConfig" +}, +"type": "array" +}, +"bindings": { +"description": "Associates a list of `members`, or principals, with a `role`. Optionally,\nmay specify a `condition` that determines how and when the `bindings` are\napplied. Each of the `bindings` must contain at least one principal.\n\nThe `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250\nof these principals can be Google groups. Each occurrence of a principal\ncounts towards these limits. For example, if the `bindings` grant 50\ndifferent roles to `user:alice@example.com`, and not to any other\nprincipal, then you can add another 1,450 principals to the `bindings` in\nthe `Policy`.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "`etag` is used for optimistic concurrency control as a way to help\nprevent simultaneous updates of a policy from overwriting each other.\nIt is strongly suggested that systems make use of the `etag` in the\nread-modify-write cycle to perform policy updates in order to avoid race\nconditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that their change will be applied to the same version of the policy.\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.", +"format": "byte", +"type": "string" +}, +"version": { +"description": "Specifies the format of the policy.\n\nValid values are `0`, `1`, and `3`. Requests that specify an invalid value\nare rejected.\n\nAny operation that affects conditional role bindings must specify version\n`3`. This requirement applies to the following operations:\n\n* Getting a policy that includes a conditional role binding\n* Adding a conditional role binding to a policy\n* Changing a conditional role binding in a policy\n* Removing any role binding, with or without a condition, from a policy\n that includes conditions\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.\n\nIf a policy does not include any conditions, operations on that policy may\nspecify any valid version or leave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"PreconfiguredWafSet": { +"id": "PreconfiguredWafSet", +"properties": { +"expressionSets": { +"description": "List of entities that are currently supported for WAF rules.", +"items": { +"$ref": "WafExpressionSet" +}, +"type": "array" +} +}, +"type": "object" +}, +"PreservedState": { +"description": "Preserved state for a given instance.", +"id": "PreservedState", +"properties": { +"disks": { +"additionalProperties": { +"$ref": "PreservedStatePreservedDisk" +}, +"description": "Preserved disks defined for this instance.\nThis map is keyed with the device names of the disks.", +"type": "object" +}, +"externalIPs": { +"additionalProperties": { +"$ref": "PreservedStatePreservedNetworkIp" +}, +"description": "Preserved external IPs defined for this instance.\nThis map is keyed with the name of the network interface.", +"type": "object" +}, +"internalIPs": { +"additionalProperties": { +"$ref": "PreservedStatePreservedNetworkIp" +}, +"description": "Preserved internal IPs defined for this instance.\nThis map is keyed with the name of the network interface.", +"type": "object" +}, +"metadata": { +"additionalProperties": { +"type": "string" +}, +"description": "Preserved metadata defined for this instance.", +"type": "object" +} +}, +"type": "object" +}, +"PreservedStatePreservedDisk": { +"id": "PreservedStatePreservedDisk", +"properties": { +"autoDelete": { +"description": "These stateful disks will never be deleted during autohealing,\nupdate, instance recreate operations. This flag is used to configure\nif the disk should be deleted after it is no longer used by the group,\ne.g. when the given instance or the whole MIG is deleted.\nNote: disks attached in READ_ONLY mode cannot be\nauto-deleted.", +"enum": [ +"NEVER", +"ON_PERMANENT_INSTANCE_DELETION" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"mode": { +"description": "The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the\ndisk in READ_WRITE mode.", +"enum": [ +"READ_ONLY", +"READ_WRITE" +], +"enumDescriptions": [ +"Attaches this disk in read-only mode. Multiple VM instances can use\na disk in READ_ONLY mode at a time.", +"*[Default]* Attaches this disk in READ_WRITE mode. Only\none VM instance at a time can be attached to a disk inREAD_WRITE mode." +], +"type": "string" +}, +"source": { +"description": "The URL of the disk resource that is stateful and should be attached\nto the VM instance.", +"type": "string" +} +}, +"type": "object" +}, +"PreservedStatePreservedNetworkIp": { +"id": "PreservedStatePreservedNetworkIp", +"properties": { +"autoDelete": { +"description": "These stateful IPs will never be released during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the IP reservation should be deleted\nafter it is no longer used by the group, e.g. when the given instance\nor the whole group is deleted.", +"enum": [ +"NEVER", +"ON_PERMANENT_INSTANCE_DELETION" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"ipAddress": { +"$ref": "PreservedStatePreservedNetworkIpIpAddress", +"description": "Ip address representation" +} +}, +"type": "object" +}, +"PreservedStatePreservedNetworkIpIpAddress": { +"id": "PreservedStatePreservedNetworkIpIpAddress", +"properties": { +"address": { +"description": "The URL of the reservation for this IP address.", +"type": "string" +}, +"literal": { +"description": "An IPv4 internal network address to assign to the instance for this\nnetwork interface.", +"type": "string" +} +}, +"type": "object" +}, +"PreviewFeature": { +"description": "Represents a single Google Compute Engine preview feature.", +"id": "PreviewFeature", +"properties": { +"activationStatus": { +"description": "Specifies whether the feature is enabled or disabled.", +"enum": [ +"ACTIVATION_STATE_UNSPECIFIED", +"DISABLED", +"ENABLED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. [Output Only] Description of the feature.", +"readOnly": true, +"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#previewFeature", +"description": "Output only. [Output only] The type of the feature. Always \"compute#previewFeature\" for\npreview features.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Name of the feature.", +"type": "string" +}, +"rolloutOperation": { +"$ref": "PreviewFeatureRolloutOperation", +"description": "Rollout operation of the feature." +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"status": { +"$ref": "PreviewFeatureStatus", +"description": "Output only. [Output only] Status of the feature.", +"readOnly": true +} +}, +"type": "object" +}, +"PreviewFeatureList": { +"id": "PreviewFeatureList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of PreviewFeature resources.", +"items": { +"$ref": "PreviewFeature" +}, +"type": "array" +}, +"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" +}, +"PreviewFeatureRolloutOperation": { +"description": "Represents the rollout operation", +"id": "PreviewFeatureRolloutOperation", +"properties": { +"rolloutInput": { +"$ref": "PreviewFeatureRolloutOperationRolloutInput", +"description": "Input only. The input for the rollout operation." +} +}, +"type": "object" +}, +"PreviewFeatureRolloutOperationRolloutInput": { +"description": "Represents the input for the rollout operation.", +"id": "PreviewFeatureRolloutOperationRolloutInput", +"properties": { +"name": { +"description": "The name of the rollout plan\nEx.\norganizations//locations/global/rolloutPlans/\nEx.\nfolders//locations/global/rolloutPlans/\nEx.\nprojects//locations/global/rolloutPlans/.", +"type": "string" +}, +"predefinedRolloutPlan": { +"description": "Predefined rollout plan.", +"enum": [ +"ROLLOUT_PLAN_FAST_ROLLOUT", +"ROLLOUT_PLAN_TWO_DAY_ROLLOUT", +"ROLLOUT_PLAN_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"PreviewFeatureStatus": { +"description": "[Output Only] The status of the feature.", +"id": "PreviewFeatureStatus", +"properties": { +"description": { +"description": "Output only. [Output Only] The description of the feature.", +"readOnly": true, +"type": "string" +}, +"helpLink": { +"description": "Output only. [Output Only] Link to the public documentation for the feature.", +"readOnly": true, +"type": "string" +}, +"releaseStatus": { +"$ref": "PreviewFeatureStatusReleaseStatus" +} +}, +"type": "object" +}, +"PreviewFeatureStatusReleaseStatus": { +"description": "[Output Only] The release status of the feature.", +"id": "PreviewFeatureStatusReleaseStatus", +"properties": { +"stage": { +"description": "Output only. [Output Only] The stage of the feature.", +"enum": [ +"DEPRECATED", +"GA", +"PREVIEW", +"STAGE_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"updateDate": { +"$ref": "Date", +"description": "Output only. The last date when a feature transitioned between ReleaseStatuses.", +"readOnly": true +} +}, +"type": "object" +}, +"Project": { +"description": "Represents a Project resource.\n\nA project is used to organize resources in a Google Cloud Platform\nenvironment. For more information, read about the \nResource Hierarchy.", +"id": "Project", +"properties": { +"cloudArmorTier": { +"description": "Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the\nfollowing values: CA_STANDARD,CA_ENTERPRISE_PAYGO.\n\nIf this field is not specified, it is assumed to beCA_STANDARD.", +"enum": [ +"CA_ENTERPRISE_ANNUAL", +"CA_ENTERPRISE_PAYGO", +"CA_STANDARD" +], +"enumDescriptions": [ +"Enterprise tier protection billed annually.", +"Enterprise tier protection billed monthly.", +"Standard protection." +], +"readOnly": true, +"type": "string" +}, +"commonInstanceMetadata": { +"$ref": "Metadata", +"description": "Metadata key/value pairs available to all instances contained in this\nproject. See Custom\nmetadata for more information." +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"defaultNetworkTier": { +"description": "This signifies the default network tier used for configuring resources of\nthe project and can only take the following values:PREMIUM, STANDARD. Initially the default network\ntier is PREMIUM.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +}, +"defaultServiceAccount": { +"description": "[Output Only] Default service account used by VMs running in this project.", +"type": "string" +}, +"description": { +"description": "An optional textual description of the resource.", +"type": "string" +}, +"enabledFeatures": { +"description": "An optional list of restricted features enabled for use on this project.", +"items": { +"type": "string" +}, +"type": "array" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server. This is *not* the project ID, and is\njust a unique ID used by Compute Engine to identify resources.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#project", +"description": "Output only. [Output Only] Type of the resource. Always compute#project for\nprojects.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "The project ID. For example: my-example-project. Use the\nproject ID to make requests to Compute Engine.", +"type": "string" +}, +"quotas": { +"description": "[Output Only] Quotas assigned to this project.", +"items": { +"$ref": "Quota" +}, +"type": "array" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"usageExportLocation": { +"$ref": "UsageExportLocation", +"description": "An optional naming prefix for daily usage reports and the Google Cloud\nStorage bucket where they are stored." +}, +"vmDnsSetting": { +"description": "Output only. [Output Only] Default internal DNS setting used by VMs running in\nthis project.", +"enum": [ +"GLOBAL_DEFAULT", +"UNSPECIFIED_VM_DNS_SETTING", +"ZONAL_DEFAULT", +"ZONAL_ONLY" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"xpnProjectStatus": { +"description": "[Output Only] The role this project has in a shared VPC configuration.\nCurrently, only projects with the host role, which is specified by the\nvalue HOST, are differentiated.", +"enum": [ +"HOST", +"UNSPECIFIED_XPN_PROJECT_STATUS" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ProjectView": { +"description": "Represents a ProjectView resource.\n\nA ProjectView resource contains read-only project data which is available\nglobally.", +"id": "ProjectView", +"properties": { +"project": { +"$ref": "Project", +"description": "The project data.\nThe returned Project data does not contain regional or zonal quota\nusage data. Global quota limits are present. For accurate, real-time quota\nusage numbers, query the global\n[projects.get](https://cloud.google.com/compute/docs/reference/rest/v1/projects/get)\nendpoint." +} +}, +"type": "object" +}, +"ProjectsDisableXpnResourceRequest": { +"id": "ProjectsDisableXpnResourceRequest", +"properties": { +"xpnResource": { +"$ref": "XpnResourceId", +"description": "Service resource (a.k.a service project) ID." +} +}, +"type": "object" +}, +"ProjectsEnableXpnResourceRequest": { +"id": "ProjectsEnableXpnResourceRequest", +"properties": { +"xpnResource": { +"$ref": "XpnResourceId", +"description": "Service resource (a.k.a service project) ID." +} +}, +"type": "object" +}, +"ProjectsGetXpnResources": { +"id": "ProjectsGetXpnResources", +"properties": { +"kind": { +"default": "compute#projectsGetXpnResources", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources\n(a.k.a service projects)", +"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" +}, +"resources": { +"description": "Service resources (a.k.a service projects) attached to this project as\ntheir shared VPC host.", +"items": { +"$ref": "XpnResourceId" +}, +"type": "array" +} +}, +"type": "object" +}, +"ProjectsListXpnHostsRequest": { +"id": "ProjectsListXpnHostsRequest", +"properties": { +"organization": { +"description": "Optional organization ID managed by Cloud Resource Manager, for which to\nlist shared VPC host projects. If not specified, the organization will be\ninferred from the project.", +"type": "string" +} +}, +"type": "object" +}, +"ProjectsSetCloudArmorTierRequest": { +"id": "ProjectsSetCloudArmorTierRequest", +"properties": { +"cloudArmorTier": { +"description": "Managed protection tier to be set.", +"enum": [ +"CA_ENTERPRISE_ANNUAL", +"CA_ENTERPRISE_PAYGO", +"CA_STANDARD" +], +"enumDescriptions": [ +"Enterprise tier protection billed annually.", +"Enterprise tier protection billed monthly.", +"Standard protection." +], +"type": "string" +} +}, +"type": "object" +}, +"ProjectsSetDefaultNetworkTierRequest": { +"id": "ProjectsSetDefaultNetworkTierRequest", +"properties": { +"networkTier": { +"description": "Default network tier to be set.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +} +}, +"type": "object" +}, +"PublicAdvertisedPrefix": { +"description": "A public advertised prefix represents an aggregated IP prefix or netblock\nwhich customers bring to cloud. The IP prefix is a single unit of route\nadvertisement and is announced globally to the internet.", +"id": "PublicAdvertisedPrefix", +"properties": { +"byoipApiVersion": { +"description": "Output only. [Output Only] The version of BYOIP API.", +"enum": [ +"V1", +"V2" +], +"enumDescriptions": [ +"This public advertised prefix can be used to create both regional and\nglobal public delegated prefixes. It usually takes 4 weeks to create or\ndelete a public delegated prefix. The BGP status cannot be changed.", +"This public advertised prefix can only be used to create regional public\ndelegated prefixes. Public delegated prefix creation and deletion takes\nminutes and the BGP status can be modified." +], +"readOnly": true, +"type": "string" +}, +"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" +}, +"dnsVerificationIp": { +"description": "The address to be used for reverse DNS verification.", +"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 new PublicAdvertisedPrefix. An up-to-date\nfingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a PublicAdvertisedPrefix.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"ipCidrRange": { +"description": "The address range, in CIDR format, represented by this public advertised\nprefix.", +"type": "string" +}, +"ipv6AccessType": { +"description": "The internet access type for IPv6 Public Advertised Prefixes.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"Default IPv6 access type. The prefix will be announced to the internet.\nAll children Public Delegated Prefixes will have IPv6 access type as\nEXTERNAL.", +"The prefix will not be announced to the internet. Prefix will be used\nprivately within Cloud. All children Public Delegated Prefixes\nwill have IPv6 access type as INTERNAL." +], +"type": "string" +}, +"kind": { +"default": "compute#publicAdvertisedPrefix", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.publicAdvertisedPrefixes.insert" +] +}, +"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" +}, +"pdpScope": { +"description": "Specifies how child public delegated prefix will be scoped. It could\nbe one of following values:\n \n \n - `REGIONAL`: The public delegated prefix is regional only. The\n provisioning will take a few minutes.\n - `GLOBAL`: The public delegated prefix is global only. The\n provisioning will take ~4 weeks.\n - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is\n BYOIP V1 legacy prefix. This is output only value and no longer\n supported in BYOIP V2.", +"enum": [ +"GLOBAL", +"GLOBAL_AND_REGIONAL", +"REGIONAL" +], +"enumDescriptions": [ +"The public delegated prefix is global only. The provisioning will take ~4\nweeks.", +"The public delegated prefixes is BYOIP V1 legacy prefix. This is output\nonly value and no longer supported in BYOIP V2.", +"The public delegated prefix is regional only. The provisioning will take\na few minutes." +], +"type": "string" +}, +"publicDelegatedPrefixs": { +"description": "Output only. [Output Only] The list of public delegated prefixes that exist for this\npublic advertised prefix.", +"items": { +"$ref": "PublicAdvertisedPrefixPublicDelegatedPrefix" +}, +"readOnly": true, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"sharedSecret": { +"description": "[Output Only] The shared secret to be used for reverse DNS verification.", +"type": "string" +}, +"status": { +"description": "The status of the public advertised prefix. Possible values include:\n \n \n - `INITIAL`: RPKI validation is complete.\n - `PTR_CONFIGURED`: User has configured the PTR.\n - `VALIDATED`: Reverse DNS lookup is successful.\n - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.\n - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being\n configured.\n - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.\n - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.", +"enum": [ +"ANNOUNCED_TO_INTERNET", +"INITIAL", +"PREFIX_CONFIGURATION_COMPLETE", +"PREFIX_CONFIGURATION_IN_PROGRESS", +"PREFIX_REMOVAL_IN_PROGRESS", +"PTR_CONFIGURED", +"READY_TO_ANNOUNCE", +"REVERSE_DNS_LOOKUP_FAILED", +"VALIDATED" +], +"enumDescriptions": [ +"The prefix is announced to Internet.", +"RPKI validation is complete.", +"The prefix is fully configured.", +"The prefix is being configured.", +"The prefix is being removed.", +"User has configured the PTR.", +"The prefix is currently withdrawn but ready to be announced.", +"Reverse DNS lookup failed.", +"Reverse DNS lookup is successful." +], +"type": "string" +} +}, +"type": "object" +}, +"PublicAdvertisedPrefixList": { +"id": "PublicAdvertisedPrefixList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of PublicAdvertisedPrefix resources.", +"items": { +"$ref": "PublicAdvertisedPrefix" +}, +"type": "array" +}, +"kind": { +"default": "compute#publicAdvertisedPrefixList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.", +"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] Server-defined URL for this resource.", +"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" +}, +"PublicAdvertisedPrefixPublicDelegatedPrefix": { +"description": "Represents a CIDR range which can be used to assign addresses.", +"id": "PublicAdvertisedPrefixPublicDelegatedPrefix", +"properties": { +"ipRange": { +"description": "The IP address range of the public delegated prefix", +"type": "string" +}, +"name": { +"description": "The name of the public delegated prefix", +"type": "string" +}, +"project": { +"description": "The project number of the public delegated prefix", +"type": "string" +}, +"region": { +"description": "The region of the public delegated prefix if it is regional. If absent,\nthe prefix is global.", +"type": "string" +}, +"status": { +"description": "The status of the public delegated prefix. Possible values are:\n INITIALIZING: The public delegated prefix is being initialized and\n addresses cannot be created yet.\n ANNOUNCED: The public delegated prefix is active.", +"type": "string" +} +}, +"type": "object" +}, +"PublicDelegatedPrefix": { +"description": "A PublicDelegatedPrefix resource represents an IP block within a\nPublicAdvertisedPrefix that is configured within a single cloud scope\n(global or region). IPs in the block can be allocated to resources within\nthat scope. Public delegated prefixes may be further broken up into\nsmaller IP blocks in the same scope as the parent block.", +"id": "PublicDelegatedPrefix", +"properties": { +"allocatablePrefixLength": { +"description": "The allocatable prefix length supported by this public delegated prefix.\nThis field is optional and cannot be set for prefixes in DELEGATION mode.\nIt cannot be set for IPv4 prefixes either, and it always defaults to 32.", +"format": "int32", +"type": "integer" +}, +"byoipApiVersion": { +"description": "Output only. [Output Only] The version of BYOIP API.", +"enum": [ +"V1", +"V2" +], +"enumDescriptions": [ +"This public delegated prefix usually takes 4 weeks to delete, and the BGP\nstatus cannot be changed. Announce and Withdraw APIs can not be used on\nthis prefix.", +"This public delegated prefix takes minutes to delete. Announce and\nWithdraw APIs can be used on this prefix to change the BGP status." +], +"readOnly": true, +"type": "string" +}, +"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" +}, +"enableEnhancedIpv4Allocation": { +"description": "Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.\nApplicable for IPv4 PDPs only.", +"readOnly": true, +"type": "boolean" +}, +"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 new PublicDelegatedPrefix. An up-to-date\nfingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a PublicDelegatedPrefix.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"ipCidrRange": { +"description": "The IP address range, in CIDR format, represented by this public\ndelegated prefix.", +"type": "string" +}, +"ipv6AccessType": { +"description": "Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.\nInherited from parent prefix.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"The parent public advertised prefix will be announced to the internet.\nAll children public delegated prefixes will have IPv6 access type as\nEXTERNAL.", +"The parent public advertised prefix will not be announced to the\ninternet. Prefix will be used privately within Cloud. All children\npublic delegated prefixes will have IPv6 access type as INTERNAL." +], +"readOnly": true, +"type": "string" +}, +"isLiveMigration": { +"description": "If true, the prefix will be live migrated.", +"type": "boolean" +}, +"kind": { +"default": "compute#publicDelegatedPrefix", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.", +"readOnly": true, +"type": "string" +}, +"mode": { +"description": "The public delegated prefix mode for IPv6 only.", +"enum": [ +"DELEGATION", +"EXTERNAL_IPV6_FORWARDING_RULE_CREATION", +"EXTERNAL_IPV6_SUBNETWORK_CREATION", +"INTERNAL_IPV6_SUBNETWORK_CREATION" +], +"enumDescriptions": [ +"The public delegated prefix is used for further sub-delegation only. Such\nprefixes cannot set allocatablePrefixLength.", +"The public delegated prefix is used for creating forwarding rules only.\nSuch prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", +"The public delegated prefix is used for creating dual-mode subnetworks\nonly. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", +"The public delegated prefix is used for creating dual stack or IPv6-only\nsubnetwork with internal access only. Such prefixes cannot set\npublicDelegatedSubPrefixes and allocatablePrefixLength. Parent public\ndelegated prefix must have IPv6 access type as INTERNAL." +], +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.publicDelegatedPrefixes.insert" +] +}, +"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" +}, +"parentPrefix": { +"description": "The URL of parent prefix. Either PublicAdvertisedPrefix or\nPublicDelegatedPrefix.", +"type": "string" +}, +"publicDelegatedSubPrefixs": { +"description": "The list of sub public delegated prefixes that exist for this public\ndelegated prefix.", +"items": { +"$ref": "PublicDelegatedPrefixPublicDelegatedSubPrefix" +}, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the public delegated prefix resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "[Output Only] The status of the public delegated prefix, which can be one\nof following values:\n \n \n - `INITIALIZING` The public delegated prefix is being initialized and\n addresses cannot be created yet.\n - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration\n prefix and is active.\n - `ANNOUNCED` The public delegated prefix is announced and ready to\n use.\n - `DELETING` The public delegated prefix is being deprovsioned.\n - `ACTIVE` The public delegated prefix is ready to use.", +"enum": [ +"ACTIVE", +"ANNOUNCED", +"ANNOUNCED_TO_GOOGLE", +"ANNOUNCED_TO_INTERNET", +"DELETING", +"INITIALIZING", +"READY_TO_ANNOUNCE" +], +"enumDescriptions": [ +"The public delegated prefix is ready to use.", +"The public delegated prefix is announced and ready to use.", +"The prefix is announced within Google network.", +"The prefix is announced to Internet and within Google.", +"The public delegated prefix is being deprovsioned.", +"The public delegated prefix is being initialized and addresses cannot be\ncreated yet.", +"The public delegated prefix is currently withdrawn but ready to be\nannounced." +], +"type": "string" +} +}, +"type": "object" +}, +"PublicDelegatedPrefixAggregatedList": { +"id": "PublicDelegatedPrefixAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "PublicDelegatedPrefixesScopedList", +"description": "[Output Only] Name of the scope containing this set of\nPublicDelegatedPrefixes." +}, +"description": "A list of PublicDelegatedPrefixesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#publicDelegatedPrefixAggregatedList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated\nlists of public delegated prefixes.", +"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] Server-defined URL for this resource.", +"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" +}, +"PublicDelegatedPrefixList": { +"id": "PublicDelegatedPrefixList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of PublicDelegatedPrefix resources.", +"items": { +"$ref": "PublicDelegatedPrefix" +}, +"type": "array" +}, +"kind": { +"default": "compute#publicDelegatedPrefixList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated\nprefixes.", +"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] Server-defined URL for this resource.", +"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" +}, +"PublicDelegatedPrefixPublicDelegatedSubPrefix": { +"description": "Represents a sub PublicDelegatedPrefix.", +"id": "PublicDelegatedPrefixPublicDelegatedSubPrefix", +"properties": { +"allocatablePrefixLength": { +"description": "The allocatable prefix length supported by this PublicDelegatedSubPrefix.", +"format": "int32", +"type": "integer" +}, +"delegateeProject": { +"description": "Name of the project scoping this PublicDelegatedSubPrefix.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"enableEnhancedIpv4Allocation": { +"description": "Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.\nApplicable for IPv4 PDPs only.", +"readOnly": true, +"type": "boolean" +}, +"ipCidrRange": { +"description": "The IP address range, in CIDR format, represented by this sub public\ndelegated prefix.", +"type": "string" +}, +"ipv6AccessType": { +"description": "Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub\nPrefixes. Inherited from parent prefix.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"The parent public advertised prefix will be announced to the internet.\nAll children public delegated prefixes will have IPv6 access type as\nEXTERNAL.", +"The parent public advertised prefix will not be announced to the\ninternet. Prefix will be used privately within Cloud. All children\npublic delegated prefixes will have IPv6 access type as INTERNAL." +], +"readOnly": true, +"type": "string" +}, +"isAddress": { +"description": "Whether the sub prefix is delegated to create Address resources in the\ndelegatee project.", +"type": "boolean" +}, +"mode": { +"description": "The PublicDelegatedSubPrefix mode for IPv6 only.", +"enum": [ +"DELEGATION", +"EXTERNAL_IPV6_FORWARDING_RULE_CREATION", +"EXTERNAL_IPV6_SUBNETWORK_CREATION", +"INTERNAL_IPV6_SUBNETWORK_CREATION" +], +"enumDescriptions": [ +"The public delegated prefix is used for further sub-delegation only. Such\nprefixes cannot set allocatablePrefixLength.", +"The public delegated prefix is used for creating forwarding rules only.\nSuch prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", +"The public delegated prefix is used for creating dual-mode subnetworks\nonly. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", +"The public delegated prefix is used for creating dual stack or IPv6-only\nsubnetwork with internal access only. Such prefixes cannot set\npublicDelegatedSubPrefixes and allocatablePrefixLength. Parent public\ndelegated prefix must have IPv6 access type as INTERNAL." +], +"type": "string" +}, +"name": { +"description": "The name of the sub public delegated prefix.", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] The region of the sub public delegated prefix if it is\nregional. If absent, the sub prefix is global.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of the sub public delegated prefix.", +"enum": [ +"ACTIVE", +"INACTIVE" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"PublicDelegatedPrefixesScopedList": { +"id": "PublicDelegatedPrefixesScopedList", +"properties": { +"publicDelegatedPrefixes": { +"description": "[Output Only] A list of PublicDelegatedPrefixes contained in this scope.", +"items": { +"$ref": "PublicDelegatedPrefix" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of\npublic delegated prefixes 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.", +"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" +}, +"Quota": { +"description": "A quotas entry.", +"id": "Quota", +"properties": { +"limit": { +"description": "[Output Only] Quota limit for this metric.", +"format": "double", +"type": "number" +}, +"metric": { +"description": "[Output Only] Name of the quota metric.", +"enum": [ +"A2_CPUS", +"AFFINITY_GROUPS", +"AUTOSCALERS", +"BACKEND_BUCKETS", +"BACKEND_SERVICES", +"C2D_CPUS", +"C2_CPUS", +"C3_CPUS", +"COMMITMENTS", +"COMMITTED_A2_CPUS", +"COMMITTED_C2D_CPUS", +"COMMITTED_C2_CPUS", +"COMMITTED_C3_CPUS", +"COMMITTED_CPUS", +"COMMITTED_E2_CPUS", +"COMMITTED_LICENSES", +"COMMITTED_LOCAL_SSD_TOTAL_GB", +"COMMITTED_M3_CPUS", +"COMMITTED_MEMORY_OPTIMIZED_CPUS", +"COMMITTED_N2A_CPUS", +"COMMITTED_N2D_CPUS", +"COMMITTED_N2_CPUS", +"COMMITTED_NVIDIA_A100_80GB_GPUS", +"COMMITTED_NVIDIA_A100_GPUS", +"COMMITTED_NVIDIA_H100_GPUS", +"COMMITTED_NVIDIA_K80_GPUS", +"COMMITTED_NVIDIA_L4_GPUS", +"COMMITTED_NVIDIA_P100_GPUS", +"COMMITTED_NVIDIA_P4_GPUS", +"COMMITTED_NVIDIA_T4_GPUS", +"COMMITTED_NVIDIA_V100_GPUS", +"COMMITTED_T2A_CPUS", +"COMMITTED_T2D_CPUS", +"COMMITTED_Z3_CPUS", +"CPUS", +"CPUS_ALL_REGIONS", +"DISKS_TOTAL_GB", +"E2_CPUS", +"EXTERNAL_MANAGED_FORWARDING_RULES", +"EXTERNAL_NETWORK_LB_FORWARDING_RULES", +"EXTERNAL_PROTOCOL_FORWARDING_RULES", +"EXTERNAL_VPN_GATEWAYS", +"FIREWALLS", +"FORWARDING_RULES", +"GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES", +"GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES", +"GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES", +"GLOBAL_INTERNAL_ADDRESSES", +"GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES", +"GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", +"GPUS_ALL_REGIONS", +"HDB_TOTAL_GB", +"HDB_TOTAL_IOPS", +"HDB_TOTAL_THROUGHPUT", +"HEALTH_CHECKS", +"IMAGES", +"INSTANCES", +"INSTANCE_GROUPS", +"INSTANCE_GROUP_MANAGERS", +"INSTANCE_TEMPLATES", +"INTERCONNECTS", +"INTERCONNECT_ATTACHMENTS_PER_REGION", +"INTERCONNECT_ATTACHMENTS_TOTAL_MBPS", +"INTERCONNECT_TOTAL_GBPS", +"INTERNAL_ADDRESSES", +"INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES", +"IN_PLACE_SNAPSHOTS", +"IN_USE_ADDRESSES", +"IN_USE_BACKUP_SCHEDULES", +"IN_USE_SNAPSHOT_SCHEDULES", +"LOCAL_SSD_TOTAL_GB", +"M1_CPUS", +"M2_CPUS", +"M3_CPUS", +"MACHINE_IMAGES", +"N2A_CPUS", +"N2D_CPUS", +"N2_CPUS", +"NETWORKS", +"NETWORK_ATTACHMENTS", +"NETWORK_ENDPOINT_GROUPS", +"NETWORK_FIREWALL_POLICIES", +"NET_LB_SECURITY_POLICIES_PER_REGION", +"NET_LB_SECURITY_POLICY_RULES_PER_REGION", +"NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION", +"NODE_GROUPS", +"NODE_TEMPLATES", +"NVIDIA_A100_80GB_GPUS", +"NVIDIA_A100_GPUS", +"NVIDIA_K80_GPUS", +"NVIDIA_L4_GPUS", +"NVIDIA_P100_GPUS", +"NVIDIA_P100_VWS_GPUS", +"NVIDIA_P4_GPUS", +"NVIDIA_P4_VWS_GPUS", +"NVIDIA_T4_GPUS", +"NVIDIA_T4_VWS_GPUS", +"NVIDIA_V100_GPUS", +"PACKET_MIRRORINGS", +"PD_EXTREME_TOTAL_PROVISIONED_IOPS", +"PREEMPTIBLE_CPUS", +"PREEMPTIBLE_LOCAL_SSD_GB", +"PREEMPTIBLE_NVIDIA_A100_80GB_GPUS", +"PREEMPTIBLE_NVIDIA_A100_GPUS", +"PREEMPTIBLE_NVIDIA_H100_GPUS", +"PREEMPTIBLE_NVIDIA_K80_GPUS", +"PREEMPTIBLE_NVIDIA_L4_GPUS", +"PREEMPTIBLE_NVIDIA_P100_GPUS", +"PREEMPTIBLE_NVIDIA_P100_VWS_GPUS", +"PREEMPTIBLE_NVIDIA_P4_GPUS", +"PREEMPTIBLE_NVIDIA_P4_VWS_GPUS", +"PREEMPTIBLE_NVIDIA_T4_GPUS", +"PREEMPTIBLE_NVIDIA_T4_VWS_GPUS", +"PREEMPTIBLE_NVIDIA_V100_GPUS", +"PREEMPTIBLE_TPU_LITE_DEVICE_V5", +"PREEMPTIBLE_TPU_LITE_PODSLICE_V5", +"PREEMPTIBLE_TPU_PODSLICE_V4", +"PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK", +"PSC_INTERNAL_LB_FORWARDING_RULES", +"PUBLIC_ADVERTISED_PREFIXES", +"PUBLIC_DELEGATED_PREFIXES", +"REGIONAL_AUTOSCALERS", +"REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES", +"REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES", +"REGIONAL_INSTANCE_GROUP_MANAGERS", +"REGIONAL_INTERNAL_LB_BACKEND_SERVICES", +"REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES", +"REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", +"RESERVATIONS", +"RESOURCE_POLICIES", +"ROUTERS", +"ROUTES", +"SECURITY_POLICIES", +"SECURITY_POLICIES_PER_REGION", +"SECURITY_POLICY_ADVANCED_RULES_PER_REGION", +"SECURITY_POLICY_CEVAL_RULES", +"SECURITY_POLICY_RULES", +"SECURITY_POLICY_RULES_PER_REGION", +"SERVICE_ATTACHMENTS", +"SNAPSHOTS", +"SSD_TOTAL_GB", +"SSL_CERTIFICATES", +"SSL_POLICIES", +"STATIC_ADDRESSES", +"STATIC_BYOIP_ADDRESSES", +"STATIC_EXTERNAL_IPV6_ADDRESS_RANGES", +"SUBNETWORKS", +"T2A_CPUS", +"T2D_CPUS", +"TARGET_HTTPS_PROXIES", +"TARGET_HTTP_PROXIES", +"TARGET_INSTANCES", +"TARGET_POOLS", +"TARGET_SSL_PROXIES", +"TARGET_TCP_PROXIES", +"TARGET_VPN_GATEWAYS", +"TPU_LITE_DEVICE_V5", +"TPU_LITE_PODSLICE_V5", +"TPU_PODSLICE_V4", +"URL_MAPS", +"VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES", +"VPN_GATEWAYS", +"VPN_TUNNELS", +"XPN_SERVICE_PROJECTS" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"Guest CPUs", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"The total number of snapshots allowed for a single project.", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"owner": { +"description": "[Output Only] Owning resource. This is the resource on which this quota\nis applied.", +"type": "string" +}, +"usage": { +"description": "[Output Only] Current usage of this metric.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"QuotaExceededInfo": { +"description": "Additional details for quota exceeded error for resource quota.", +"id": "QuotaExceededInfo", +"properties": { +"dimensions": { +"additionalProperties": { +"type": "string" +}, +"description": "The map holding related quota dimensions.", +"type": "object" +}, +"futureLimit": { +"description": "Future quota limit being rolled out. The limit's unit depends on the quota\n type or metric.", +"format": "double", +"type": "number" +}, +"limit": { +"description": "Current effective quota limit. The limit's unit depends on the quota type\nor metric.", +"format": "double", +"type": "number" +}, +"limitName": { +"description": "The name of the quota limit.", +"type": "string" +}, +"metricName": { +"description": "The Compute Engine quota metric name.", +"type": "string" +}, +"rolloutStatus": { +"description": "Rollout status of the future quota limit.", +"enum": [ +"IN_PROGRESS", +"ROLLOUT_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"IN_PROGRESS - A rollout is in process which will change the limit value\nto future limit.", +"ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default\nvalue." +], +"type": "string" +} +}, +"type": "object" +}, +"Reference": { +"description": "Represents a reference to a resource.", +"id": "Reference", +"properties": { +"kind": { +"default": "compute#reference", +"description": "Output only. [Output Only] Type of the resource. Always compute#reference\nfor references.", +"readOnly": true, +"type": "string" +}, +"referenceType": { +"description": "A description of the reference type with no implied semantics. Possible\nvalues include:\n \n \n 1. MEMBER_OF", +"type": "string" +}, +"referrer": { +"description": "URL of the resource which refers to the target.", +"type": "string" +}, +"target": { +"description": "URL of the resource to which this reference points.", +"type": "string" +} +}, +"type": "object" +}, +"RegexRewrite": { +"description": "The spec for modifying the path using a regular expression.", +"id": "RegexRewrite", +"properties": { +"pathPattern": { +"description": "Required. The regular expression used to match against the URL path.\nIt uses RE2 syntax with the following constraints:\n \n \n - Any single character operators\n - Groups are allowed to have only submatch operator inside\n - Groups are allowed only without any char repetition, e.g.\n .*\n - Any char repetition, e.g. .*, is\n only allowed to be used in a single regex together with:\n \n \n - Empty string operators\n - Other repetitions\n - Ranges\n - Repetitions of ranges\n \n \n - Ranges are only allowed to have:\n \n \n - Character range\n - Digits range\n - Symbols listed in characters allowed for ranges", +"type": "string" +}, +"pathSubstitution": { +"description": "Required. Required when path pattern is specified. Used to rewrite matching parts of\nthe path.", +"type": "string" +} +}, +"type": "object" +}, +"Region": { +"description": "Represents a Region resource.\n\nA region is a geographical area where a resource is located. For more\ninformation, readRegions\nand Zones.", +"id": "Region", +"properties": { +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this region." +}, +"description": { +"description": "[Output Only] Textual description of the resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#region", +"description": "Output only. [Output Only] Type of the resource. Always compute#region for\nregions.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"type": "string" +}, +"quotaStatusWarning": { +"description": "Output only. [Output Only] Warning of fetching the `quotas` field for this region. This\nfield is populated only if fetching of the `quotas` field fails.", +"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" +} +}, +"readOnly": true, +"type": "object" +}, +"quotas": { +"description": "[Output Only] Quotas assigned to this region.", +"items": { +"$ref": "Quota" +}, +"type": "array" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"status": { +"description": "[Output Only] Status of the region, either UP orDOWN.", +"enum": [ +"DOWN", +"UP" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"supportsPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"zones": { +"description": "[Output Only] A list of zones available in this region, in the form of\nresource URLs.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionAddressesMoveRequest": { +"id": "RegionAddressesMoveRequest", +"properties": { +"description": { +"description": "An optional destination address description if intended to be different\nfrom the source.", +"type": "string" +}, +"destinationAddress": { +"description": "The URL of the destination address to move to. This can be a full or\npartial URL. For example, the following are all valid URLs to a address:\n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address \n - projects/project/regions/region/addresses/address\n\n\nNote that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url.", +"type": "string" +} +}, +"type": "object" +}, +"RegionAutoscalerList": { +"description": "Contains a list of autoscalers.", +"id": "RegionAutoscalerList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Autoscaler resources.", +"items": { +"$ref": "Autoscaler" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionAutoscalerList", +"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.", +"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" +}, +"RegionDiskTypeList": { +"id": "RegionDiskTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of DiskType resources.", +"items": { +"$ref": "DiskType" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionDiskTypeList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types.", +"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.", +"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" +}, +"RegionDiskUpdateKmsKeyRequest": { +"id": "RegionDiskUpdateKmsKeyRequest", +"properties": { +"kmsKeyName": { +"description": "Optional. The new KMS key to replace the current one on the disk. If empty, the disk\nwill be re-encrypted using the primary version of the disk's current KMS\nkey.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key\n\n\nWhere project is the project ID or\nproject number.", +"type": "string" +} +}, +"type": "object" +}, +"RegionDisksAddResourcePoliciesRequest": { +"id": "RegionDisksAddResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Resource policies to be added to this disk.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionDisksRemoveResourcePoliciesRequest": { +"id": "RegionDisksRemoveResourcePoliciesRequest", +"properties": { +"resourcePolicies": { +"description": "Resource policies to be removed from this disk.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionDisksResizeRequest": { +"id": "RegionDisksResizeRequest", +"properties": { +"sizeGb": { +"description": "The new size of the regional persistent disk, which is specified in GB.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RegionDisksStartAsyncReplicationRequest": { +"id": "RegionDisksStartAsyncReplicationRequest", +"properties": { +"asyncSecondaryDisk": { +"description": "The secondary disk to start asynchronous replication to.\nYou can provide this as a partial or full URL to the resource. For example,\nthe following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", +"type": "string" +} +}, +"type": "object" +}, +"RegionInstanceGroupList": { +"description": "Contains a list of InstanceGroup resources.", +"id": "RegionInstanceGroupList", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceGroup resources.", +"items": { +"$ref": "InstanceGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionInstanceGroupList", +"description": "Output only. The resource type.", +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagerDeleteInstanceConfigReq": { +"description": "RegionInstanceGroupManagers.deletePerInstanceConfigs", +"id": "RegionInstanceGroupManagerDeleteInstanceConfigReq", +"properties": { +"names": { +"description": "The list of instance names for which we want to delete per-instance configs\non this managed instance group.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagerList": { +"description": "Contains a list of managed instance groups.", +"id": "RegionInstanceGroupManagerList", +"properties": { +"id": { +"description": "Output only. Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceGroupManager resources.", +"items": { +"$ref": "InstanceGroupManager" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionInstanceGroupManagerList", +"description": "Output only. The resource type, which is always compute#instanceGroupManagerList for a\nlist of managed instance groups that exist in th regional scope.", +"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.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagerPatchInstanceConfigReq": { +"description": "RegionInstanceGroupManagers.patchPerInstanceConfigs", +"id": "RegionInstanceGroupManagerPatchInstanceConfigReq", +"properties": { +"perInstanceConfigs": { +"description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagerResizeRequestsListResponse": { +"id": "RegionInstanceGroupManagerResizeRequestsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "Output only. Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of Resize Request resources.", +"items": { +"$ref": "InstanceGroupManagerResizeRequest" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionInstanceGroupManagerResizeRequestList", +"description": "Output only. Type of the resource. Alwayscompute#regionInstanceGroupManagerResizeRequestList for\na list of Resize Requests.", +"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.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"unreachables": { +"description": "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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagerUpdateInstanceConfigReq": { +"description": "RegionInstanceGroupManagers.updatePerInstanceConfigs", +"id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", +"properties": { +"perInstanceConfigs": { +"description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersAbandonInstancesRequest": { +"id": "RegionInstanceGroupManagersAbandonInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to abandon. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersApplyUpdatesRequest": { +"description": "RegionInstanceGroupManagers.applyUpdatesToInstances", +"id": "RegionInstanceGroupManagersApplyUpdatesRequest", +"properties": { +"allInstances": { +"description": "Flag to update all instances instead of specified list of \"instances\".\nIf the flag is set to true then the instances may not be specified\nin the request.", +"type": "boolean" +}, +"instances": { +"description": "The list of URLs of one or more instances for which you want to apply\nupdates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +}, +"minimalAction": { +"description": "The minimal action that you want to perform on each instance during the\nupdate:\n \n \n - REPLACE: At minimum, delete the instance and create it\n again. \n - RESTART: Stop the instance and start it\n again. \n - REFRESH: Do not stop the instance and limit\n disruption as much as possible. \n - NONE: Do not\n disrupt the instance at all.\n\n\nBy default, the minimum action is NONE. If your update\nrequires a more disruptive action than you set with this flag, the\nnecessary action is performed to execute the update.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +}, +"mostDisruptiveAllowedAction": { +"description": "The most disruptive action that you want to perform on each instance during\nthe update:\n \n \n - REPLACE: Delete the instance and create it again.\n - RESTART: Stop the instance and start it again.\n - REFRESH: Do not stop the instance and limit disruption\n as much as possible. \n - NONE: Do not disrupt the\n instance at all.\n\n\nBy default, the most disruptive allowed action is REPLACE. If\nyour update requires a more disruptive action than you set with this flag,\nthe update request will fail.", +"enum": [ +"NONE", +"REFRESH", +"REPLACE", +"RESTART" +], +"enumDescriptions": [ +"Do not perform any action.", +"Do not stop the instance.", +"(Default.) Replace the instance according to the replacement method\noption.", +"Stop the instance and start it again." +], +"type": "string" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersCreateInstancesRequest": { +"description": "RegionInstanceGroupManagers.createInstances", +"id": "RegionInstanceGroupManagersCreateInstancesRequest", +"properties": { +"instances": { +"description": "[Required] List of specifications of per-instance configs.", +"items": { +"$ref": "PerInstanceConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersDeleteInstancesRequest": { +"id": "RegionInstanceGroupManagersDeleteInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to delete. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +}, +"skipInstancesOnValidationError": { +"description": "Specifies whether the request should proceed despite the inclusion of\ninstances that are not members of the group or that are already in the\nprocess of being deleted or abandoned. If this field is set to `false` and\nsuch an instance is specified in the request, the operation fails. The\noperation always fails if the request contains a malformed instance URL or\na reference to an instance that exists in a zone or region other than the\ngroup's zone or region.", +"type": "boolean" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersListErrorsResponse": { +"id": "RegionInstanceGroupManagersListErrorsResponse", +"properties": { +"items": { +"description": "[Output Only] The list of errors of the managed instance group.", +"items": { +"$ref": "InstanceManagedByIgmError" +}, +"type": "array" +}, +"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" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersListInstanceConfigsResp": { +"id": "RegionInstanceGroupManagersListInstanceConfigsResp", +"properties": { +"items": { +"description": "Output only. [Output Only] The list of PerInstanceConfig.", +"items": { +"$ref": "PerInstanceConfig" +}, +"readOnly": true, +"type": "array" +}, +"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" +}, +"warning": { +"description": "Output only. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersListInstancesResponse": { +"id": "RegionInstanceGroupManagersListInstancesResponse", +"properties": { +"managedInstances": { +"description": "A list of managed instances.", +"items": { +"$ref": "ManagedInstance" +}, +"type": "array" +}, +"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" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersRecreateRequest": { +"id": "RegionInstanceGroupManagersRecreateRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to recreate. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersResumeInstancesRequest": { +"id": "RegionInstanceGroupManagersResumeInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to resume. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersSetTargetPoolsRequest": { +"id": "RegionInstanceGroupManagersSetTargetPoolsRequest", +"properties": { +"fingerprint": { +"description": "Fingerprint of the target pools information, which is a hash of the\ncontents. This field is used for optimistic locking when you update the\ntarget pool entries. This field is optional.", +"format": "byte", +"type": "string" +}, +"targetPools": { +"description": "The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically\napply to all of the instances in the managed instance group.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersSetTemplateRequest": { +"id": "RegionInstanceGroupManagersSetTemplateRequest", +"properties": { +"instanceTemplate": { +"description": "URL of the InstanceTemplate resource from which all new instances will be\ncreated.", +"type": "string" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersStartInstancesRequest": { +"id": "RegionInstanceGroupManagersStartInstancesRequest", +"properties": { +"instances": { +"description": "The URLs of one or more instances to start. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersStopInstancesRequest": { +"id": "RegionInstanceGroupManagersStopInstancesRequest", +"properties": { +"forceStop": { +"description": "If this flag is set to true, the Instance Group Manager will proceed to\nstop the instances, skipping initialization on them.", +"type": "boolean" +}, +"instances": { +"description": "The URLs of one or more instances to stop. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupManagersSuspendInstancesRequest": { +"id": "RegionInstanceGroupManagersSuspendInstancesRequest", +"properties": { +"forceSuspend": { +"description": "If this flag is set to true, the Instance Group Manager will proceed to\nsuspend the instances, skipping initialization on them.", +"type": "boolean" +}, +"instances": { +"description": "The URLs of one or more instances to suspend. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionInstanceGroupsListInstances": { +"id": "RegionInstanceGroupsListInstances", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of InstanceWithNamedPorts resources.", +"items": { +"$ref": "InstanceWithNamedPorts" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionInstanceGroupsListInstances", +"description": "Output only. The resource type.", +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RegionInstanceGroupsListInstancesRequest": { +"id": "RegionInstanceGroupsListInstancesRequest", +"properties": { +"instanceState": { +"description": "Instances in which state should be returned. Valid options are:\n'ALL', 'RUNNING'. By default, it lists all instances.", +"enum": [ +"ALL", +"RUNNING" +], +"enumDescriptions": [ +"Matches any status of the instances, running, non-running and others.", +"Instance is in RUNNING state if it is running." +], +"type": "string" +}, +"portName": { +"description": "Name of port user is interested in. It is optional. If it is set, only\ninformation about this ports will be returned. If it is not set, all the\nnamed ports will be returned.\nAlways lists all instances.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +} +}, +"type": "object" +}, +"RegionInstanceGroupsSetNamedPortsRequest": { +"id": "RegionInstanceGroupsSetNamedPortsRequest", +"properties": { +"fingerprint": { +"description": "The fingerprint of the named ports information for this instance group.\nUse this optional property to prevent conflicts when multiple users change\nthe named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another\nconcurrent request.", +"format": "byte", +"type": "string" +}, +"namedPorts": { +"description": "The list of named ports to set for this instance group.", +"items": { +"$ref": "NamedPort" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionList": { +"description": "Contains a list of region resources.", +"id": "RegionList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Region resources.", +"items": { +"$ref": "Region" +}, +"type": "array" +}, +"kind": { +"default": "compute#regionList", +"description": "Output only. [Output Only] Type of resource. Always compute#regionList for\nlists of regions.", +"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.", +"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" +}, +"RegionNetworkEndpointGroupsAttachEndpointsRequest": { +"id": "RegionNetworkEndpointGroupsAttachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be attached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionNetworkEndpointGroupsDetachEndpointsRequest": { +"id": "RegionNetworkEndpointGroupsDetachEndpointsRequest", +"properties": { +"networkEndpoints": { +"description": "The list of network endpoints to be detached.", +"items": { +"$ref": "NetworkEndpoint" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse": { +"id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse", +"properties": { +"firewallPolicys": { +"description": "Output only. [Output only] Effective firewalls from firewall policy. It applies to\nRegional Network Firewall Policies in the specified region, Global Network\nFirewall Policies and Hierachial Firewall Policies which are associated\nwith the network.", +"items": { +"$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" +}, +"readOnly": true, +"type": "array" +}, +"firewalls": { +"description": "Effective firewalls on the network.", +"items": { +"$ref": "Firewall" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { +"id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", +"properties": { +"displayName": { +"description": "Output only. [Output Only] The display name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of the firewall policy.", +"readOnly": true, +"type": "string" +}, +"packetMirroringRules": { +"description": "Output only. [Output only] The packet mirroring rules that apply to the network.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"readOnly": true, +"type": "array" +}, +"priority": { +"description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"rules": { +"description": "Output only. [Output only] The rules that apply to the network.", +"items": { +"$ref": "FirewallPolicyRule" +}, +"readOnly": true, +"type": "array" +}, +"type": { +"description": "Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,\nNETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", +"enum": [ +"HIERARCHY", +"NETWORK", +"NETWORK_REGIONAL", +"SYSTEM_GLOBAL", +"SYSTEM_REGIONAL", +"UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"RegionSetLabelsRequest": { +"id": "RegionSetLabelsRequest", +"properties": { +"labelFingerprint": { +"description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash in order to update or change\nlabels. Make a get() request to the resource to get the latest\nfingerprint.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The labels to set for this resource.", +"type": "object" +} +}, +"type": "object" +}, +"RegionSetPolicyRequest": { +"id": "RegionSetPolicyRequest", +"properties": { +"bindings": { +"description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", +"format": "byte", +"type": "string" +}, +"policy": { +"$ref": "Policy", +"description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." +} +}, +"type": "object" +}, +"RegionSnapshotUpdateKmsKeyRequest": { +"id": "RegionSnapshotUpdateKmsKeyRequest", +"properties": { +"kmsKeyName": { +"description": "Optional. The new KMS key to replace the current one on the snapshot. If empty, the\nsnapshot will be re-encrypted using the primary version of the snapshot's\ncurrent KMS key.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/region/keyRings/region/cryptoKeys/key", +"type": "string" +} +}, +"type": "object" +}, +"RegionTargetHttpsProxiesSetSslCertificatesRequest": { +"id": "RegionTargetHttpsProxiesSetSslCertificatesRequest", +"properties": { +"sslCertificates": { +"description": "New set of SslCertificate resources to associate\nwith this TargetHttpsProxy resource.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RegionUrlMapsValidateRequest": { +"id": "RegionUrlMapsValidateRequest", +"properties": { +"resource": { +"$ref": "UrlMap", +"description": "Content of the UrlMap to be validated." +} +}, +"type": "object" +}, +"ReliabilityRisk": { +"description": "Represents a ReliabilityRisk resource.", +"id": "ReliabilityRisk", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp in RFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional textual description of the resource; provided when the\nresource is created.", +"type": "string" +}, +"details": { +"$ref": "RiskDetails", +"description": "[Output Only] Details of the reliability risk resource" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#reliabilityRisk", +"description": "Output only. [Output Only] Type of resource. Always compute#reliabilityRisk\nfor reliability risks.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Name of the resource. The name must be 1-63 characters long and\ncomply with RFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"recommendation": { +"$ref": "RiskRecommendation", +"description": "The recommendation to mitigate the risk." +}, +"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 with the resource id.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ReliabilityRisksListResponse": { +"description": "Response message for the List method of ReliabilityRisksService.", +"id": "ReliabilityRisksListResponse", +"properties": { +"etag": { +"description": "[Output Only] An ETag of the resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of ReliabilityRisk resources.", +"items": { +"$ref": "ReliabilityRisk" +}, +"type": "array" +}, +"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" +}, +"RequestMirrorPolicy": { +"description": "A policy that specifies how requests intended for the route's backends\nare shadowed to a separate mirrored backend service. The load balancer\ndoesn't wait for responses from the shadow service. Before sending traffic\nto the shadow service, the host or authority header is suffixed with-shadow.", +"id": "RequestMirrorPolicy", +"properties": { +"backendService": { +"description": "The full or partial URL to the BackendService resource being\nmirrored to.\n\nThe backend service configured for a mirroring\npolicy must reference backends that are of the same type as the original\nbackend service matched in the URL map.\n\nServerless NEG backends are not currently supported as a mirrored\nbackend service.", +"type": "string" +}, +"mirrorPercent": { +"description": "The percentage of requests to be mirrored to `backend_service`.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"Reservation": { +"description": "Represents a reservation resource. A reservation ensures that capacity is\nheld in a specific zone even if the reserved VMs are not running. For more\ninformation, read Reserving zonal\nresources.", +"id": "Reservation", +"properties": { +"advancedDeploymentControl": { +"$ref": "ReservationAdvancedDeploymentControl", +"description": "Advanced control for cluster management, applicable only to DENSE\ndeployment type reservations." +}, +"aggregateReservation": { +"$ref": "AllocationAggregateReservation", +"description": "Reservation for aggregated resources, providing shape flexibility." +}, +"commitment": { +"description": "Output only. [Output Only] Full or partial URL to a parent commitment. This field\ndisplays for reservations that are tied to a commitment.", +"readOnly": true, +"type": "string" +}, +"confidentialComputeType": { +"enum": [ +"CONFIDENTIAL_COMPUTE_TYPE_BMSAI", +"CONFIDENTIAL_COMPUTE_TYPE_TDX", +"CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Bare Metal Secure AI.", +"Intel Trust Domain Extensions.", +"" +], +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"deleteAfterDuration": { +"$ref": "Duration", +"description": "Duration time relative to reservation creation when Compute Engine will\nautomatically delete this resource." +}, +"deleteAtTime": { +"description": "Absolute time in future when the reservation will be\n auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.", +"type": "string" +}, +"deploymentType": { +"description": "Specifies the deployment strategy for this reservation.", +"enum": [ +"DENSE", +"DEPLOYMENT_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"The reserved capacity is made up of densely deployed reservation blocks.", +"" +], +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"earlyAccessMaintenance": { +"description": "Indicates the early access maintenance for the reservation.\nIf this field is absent or set to NO_EARLY_ACCESS, the reservation is not\nenrolled in early access maintenance and the standard notice applies.", +"enum": [ +"NO_EARLY_ACCESS", +"WAVE1", +"WAVE2" +], +"enumDescriptions": [ +"No early access.", +"Wave 1: Fastest notification period", +"Wave 2: Medium notification period" +], +"type": "string" +}, +"enableEmergentMaintenance": { +"description": "Indicates whether Compute Engine allows unplanned maintenance for your VMs;\nfor example, to fix hardware errors.", +"type": "boolean" +}, +"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#reservation", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.", +"readOnly": true, +"type": "string" +}, +"linkedCommitments": { +"description": "Output only. [Output Only] Full or partial URL to parent commitments. This field\ndisplays for reservations that are tied to multiple commitments.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"name": { +"annotations": { +"required": [ +"compute.instances.insert" +] +}, +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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" +}, +"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": [ +"CAPACITY_OPTIMIZED", +"PROTECTION_TIER_UNSPECIFIED", +"STANDARD" +], +"enumDescriptions": [ +"CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power, cooling)\nat the data center during normal operating conditions. In the event of\ninfrastructure failures at data center (e.g. power and/or cooling\nfailures), this workload may be disrupted. As a consequence, it has a\nweaker availability SLO than STANDARD.", +"Unspecified protection tier.", +"STANDARD protection for workload that should be protected by redundancies\n(e.g. power, cooling) at the data center level. In the event of\ninfrastructure failures at data center (e.g. power and/or cooling\nfailures), this workload is expected to continue as normal using the\nredundancies." +], +"type": "string" +}, +"reservationSharingPolicy": { +"$ref": "AllocationReservationSharingPolicy", +"description": "Specify the reservation sharing policy. If unspecified, the reservation\nwill not be shared with Google Cloud managed services." +}, +"resourceMetadata": { +"$ref": "ResourceMetadata", +"description": "Output only. [Output Only] Contains standard resource metadata for an Allocation\nresource. It is populated for each instance of the Allocation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", +"readOnly": true +}, +"resourcePolicies": { +"additionalProperties": { +"type": "string" +}, +"description": "Resource policies to be added to this reservation. The key is defined by\nuser, and the value is resource policy url. This is to define placement\npolicy with reservation.", +"type": "object" +}, +"resourceStatus": { +"$ref": "AllocationResourceStatus", +"description": "Output only. [Output Only] Status information for Reservation resource.", +"readOnly": true +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"schedulingType": { +"description": "The type of maintenance for the reservation.", +"enum": [ +"GROUPED", +"GROUP_MAINTENANCE_TYPE_UNSPECIFIED", +"INDEPENDENT" +], +"enumDescriptions": [ +"Maintenance on all reserved instances in the reservation is synchronized.", +"Unknown maintenance type.", +"Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." +], +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"shareSettings": { +"$ref": "ShareSettings", +"description": "Specify share-settings to create a shared reservation. This property is\noptional. For more information about the syntax and options for this\nfield and its subfields, see the guide for creating\na shared reservation." +}, +"specificReservation": { +"$ref": "AllocationSpecificSKUReservation", +"description": "Reservation for instances with specific machine shapes." +}, +"specificReservationRequired": { +"description": "Indicates whether the reservation can be consumed by VMs with affinity\nfor \"any\" reservation. If the field is set, then only VMs that target\nthe reservation by name can consume from this reservation.", +"type": "boolean" +}, +"status": { +"description": "Output only. [Output Only] The status of the reservation.\n \n \n - CREATING: Reservation resources are being\n allocated.\n - READY: Reservation resources have been allocated,\n and the reservation is ready for use.\n - DELETING: Reservation deletion is in progress.\n - UPDATING: Reservation update is in progress.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY", +"UPDATING" +], +"enumDescriptions": [ +"Reservation resources are being allocated.", +"Reservation deletion is in progress.", +"", +"Reservation resources have been allocated, and the reservation is ready\nfor use.", +"Reservation update is in progress." +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Zone in which the reservation resides. A zone must be provided if the\nreservation is created within a commitment.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationAdvancedDeploymentControl": { +"description": "Advance control for cluster management, applicable only to DENSE deployment\ntype reservations.", +"id": "ReservationAdvancedDeploymentControl", +"properties": { +"reservationOperationalMode": { +"description": "Indicates chosen reservation operational mode for the reservation.", +"enum": [ +"ALL_CAPACITY", +"HIGHLY_AVAILABLE_CAPACITY", +"RESERVATION_OPERATIONAL_MODE_UNSPECIFIED" +], +"enumDescriptions": [ +"Google Cloud does not manage the failure of machines, but provides\nadditional capacity, which is not guaranteed to be available.", +"Google Cloud manages the failure of machines to provide high\navailability.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ReservationAffinity": { +"description": "Specifies the reservations that this instance can consume from.", +"id": "ReservationAffinity", +"properties": { +"consumeReservationType": { +"description": "Specifies the type of reservation from which this instance can consume\nresources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See\nConsuming reserved instances for examples.", +"enum": [ +"ANY_RESERVATION", +"NO_RESERVATION", +"SPECIFIC_RESERVATION", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Consume any allocation available.", +"Do not consume from any allocated capacity.", +"Must consume from a specific reservation. Must specify key value fields\nfor specifying the reservations.", +"" +], +"type": "string" +}, +"key": { +"description": "Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify\nthe name of your reservation as its value.", +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of a reservation resource. This can be\neither a name to a reservation in the same project or\n\"projects/different-project/reservations/some-reservation-name\" to target a\nshared reservation in the same zone but in a different project.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ReservationAggregatedList": { +"description": "Contains a list of reservations.", +"id": "ReservationAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "ReservationsScopedList", +"description": "Name of the scope containing this set of reservations." +}, +"description": "A list of Allocation resources.", +"type": "object" +}, +"kind": { +"default": "compute#reservationAggregatedList", +"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" +}, +"ReservationBlock": { +"description": "Represents a reservation block resource.", +"id": "ReservationBlock", +"properties": { +"count": { +"description": "Output only. [Output Only] The number of resources that are allocated in this\nreservation block.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"healthInfo": { +"$ref": "ReservationBlockHealthInfo", +"description": "Output only. [Output Only] Health information for the reservation block.", +"readOnly": true +}, +"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" +}, +"inUseCount": { +"description": "Output only. [Output Only] The number of instances that are currently in use on this\nreservation block.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"inUseHostCount": { +"description": "Output only. Number of hosts currently in use. If there is one or more Instances running\non the host, it is considered in use.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"kind": { +"default": "compute#reservationBlock", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of this reservation block generated by Google\nCompute Engine. The name must be 1-63 characters long, and comply with\nRFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"readOnly": true, +"type": "string" +}, +"physicalTopology": { +"$ref": "ReservationBlockPhysicalTopology", +"description": "Output only. [Output Only] The physical topology of the reservation block.", +"readOnly": true +}, +"reservationMaintenance": { +"$ref": "GroupMaintenanceInfo", +"description": "Output only. [Output Only] Maintenance information for this reservation block.", +"readOnly": true +}, +"reservationSubBlockCount": { +"description": "Output only. [Output Only] The number of reservation subBlocks associated with this\nreservation block.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"reservationSubBlockInUseCount": { +"description": "Output only. [Output Only] The number of in-use reservation subBlocks associated with\nthis reservation block. If at least one VM is running on a subBlock, it is\nconsidered in-use.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] Status of the reservation block.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY" +], +"enumDescriptions": [ +"Resources are being allocated for the reservation block.", +"Reservation block is currently being deleted.", +"", +"Reservation block has allocated all its resources." +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] Zone in which the reservation block resides.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ReservationBlockHealthInfo": { +"description": "Health information for the reservation block.", +"id": "ReservationBlockHealthInfo", +"properties": { +"degradedSubBlockCount": { +"description": "The number of subBlocks that are degraded.", +"format": "int32", +"type": "integer" +}, +"healthStatus": { +"description": "The health status of the reservation block.", +"enum": [ +"DEGRADED", +"HEALTHY", +"HEALTH_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The reservation block is degraded.", +"The reservation block is healthy.", +"The health status of the reservation block is unspecified." +], +"type": "string" +}, +"healthySubBlockCount": { +"description": "The number of subBlocks that are healthy.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"ReservationBlockPhysicalTopology": { +"id": "ReservationBlockPhysicalTopology", +"properties": { +"block": { +"description": "The hash of the capacity block within the cluster.", +"type": "string" +}, +"cluster": { +"description": "The cluster name of the reservation block.", +"type": "string" +}, +"instances": { +"description": "Output only. The detailed instances information for a given Block", +"items": { +"$ref": "ReservationBlockPhysicalTopologyInstance" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"ReservationBlockPhysicalTopologyInstance": { +"description": "The instances information for a given Block", +"id": "ReservationBlockPhysicalTopologyInstance", +"properties": { +"instanceId": { +"description": "The InstanceId of the instance", +"format": "uint64", +"type": "string" +}, +"physicalHostTopology": { +"$ref": "ReservationBlockPhysicalTopologyInstancePhysicalHostTopology", +"description": "Output only. The PhysicalHostTopology of instances within a Block resource.", +"readOnly": true +}, +"projectId": { +"description": "Project where the instance lives", +"format": "uint64", +"type": "string" +} +}, +"type": "object" +}, +"ReservationBlockPhysicalTopologyInstancePhysicalHostTopology": { +"description": "The PhysicalHostTopology of the instance within a Block resource.", +"id": "ReservationBlockPhysicalTopologyInstancePhysicalHostTopology", +"properties": { +"host": { +"description": "Host hash for a given instance", +"type": "string" +}, +"subBlock": { +"description": "Sub block hash for a given instance", +"type": "string" +} +}, +"type": "object" +}, +"ReservationBlocksGetResponse": { +"id": "ReservationBlocksGetResponse", +"properties": { +"resource": { +"$ref": "ReservationBlock" +} +}, +"type": "object" +}, +"ReservationBlocksListResponse": { +"description": "A list of reservation blocks under a single reservation.", +"id": "ReservationBlocksListResponse", +"properties": { +"id": { +"description": "Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of reservation block resources.", +"items": { +"$ref": "ReservationBlock" +}, +"type": "array" +}, +"kind": { +"default": "compute#reservationBlock", +"description": "Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks.", +"type": "string" +}, +"nextPageToken": { +"description": "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": "Server-defined URL for this resource.", +"type": "string" +}, +"warning": { +"description": "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" +}, +"ReservationList": { +"id": "ReservationList", +"properties": { +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"description": "[Output Only] A list of Allocation resources.", +"items": { +"$ref": "Reservation" +}, +"type": "array" +}, +"kind": { +"default": "compute#reservationList", +"description": "Output only. [Output Only] Type of resource.Always compute#reservationsList\nfor listsof reservations", +"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.", +"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" +}, +"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", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] The creation timestamp, formatted asRFC3339 text.", +"readOnly": true, +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for this resource. This identifier is\ndefined by the server.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#reservationSlot", +"description": "Output only. [Output Only] The type of resource. Alwayscompute#reservationSlot for reservation slots.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of the reservation slot.", +"readOnly": true, +"type": "string" +}, +"physicalTopology": { +"$ref": "ReservationSlotPhysicalTopology", +"deprecated": true, +"description": "Output only. [Output Only] The physical topology of the reservation slot.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] A server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] A server-defined URL for this resource with the resource ID.", +"readOnly": true, +"type": "string" +}, +"shareSettings": { +"$ref": "ShareSettings", +"description": "Specify share settings to create a shared slot. Set to empty\nto inherit the share settings from a parent resource." +}, +"state": { +"description": "Output only. [Output Only] The state of the reservation slot.", +"enum": [ +"ACTIVE", +"CREATING", +"DELETING", +"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" +}, +"status": { +"$ref": "ReservationSlotStatus", +"description": "Output only. [Output Only] The status of the reservation slot.", +"readOnly": true +}, +"zone": { +"description": "Output only. [Output Only] The zone in which the reservation slot resides.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ReservationSlotPhysicalTopology": { +"id": "ReservationSlotPhysicalTopology", +"properties": { +"block": { +"description": "The unique identifier of the capacity block within the cluster.", +"type": "string" +}, +"cluster": { +"description": "The cluster name of the reservation sub-block.", +"type": "string" +}, +"host": { +"description": "The unique identifier of the capacity host within the capacity sub-block.", +"type": "string" +}, +"subBlock": { +"description": "The unique identifier of the capacity sub-block within the capacity\nblock.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationSlotStatus": { +"id": "ReservationSlotStatus", +"properties": { +"physicalTopology": { +"$ref": "ReservationSlotPhysicalTopology", +"description": "Output only. [Output Only] The physical topology of the reservation sub-block.", +"readOnly": true +}, +"rdmaIpAddresses": { +"description": "Output only. The RDMA IP address of the physical host.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"runningInstances": { +"description": "Output only. The URIs of the instances currently running on this slot.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"ReservationSlotsGetResponse": { +"id": "ReservationSlotsGetResponse", +"properties": { +"resource": { +"$ref": "ReservationSlot" +} +}, +"type": "object" +}, +"ReservationSlotsGetVersionRequest": { +"id": "ReservationSlotsGetVersionRequest", +"properties": { +"sbomSelections": { +"description": "The SBOM selection to return. Duplicate values in the list will be ignored.", +"items": { +"enum": [ +"SBOM_SELECTION_CURRENT", +"SBOM_SELECTION_TARGET", +"SBOM_SELECTION_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ReservationSlotsListResponse": { +"description": "A list of reservation slots within a single reservation.", +"id": "ReservationSlotsListResponse", +"properties": { +"id": { +"description": "The unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of reservation slot resources.", +"items": { +"$ref": "ReservationSlot" +}, +"type": "array" +}, +"kind": { +"default": "compute#reservationSlot", +"description": "The type of resource. Alwayscompute#reservationSlot for a list of reservation\nslots.", +"type": "string" +}, +"nextPageToken": { +"description": "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": "The server-defined URL for this resource.", +"type": "string" +}, +"warning": { +"description": "An 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" +}, +"ReservationSubBlock": { +"description": "Represents a reservation subBlock resource.", +"id": "ReservationSubBlock", +"properties": { +"acceleratorTopologiesInfo": { +"$ref": "AcceleratorTopologiesInfo", +"description": "Output only. [Output Only] Slice info for the reservation subBlock.", +"readOnly": true +}, +"count": { +"description": "Output only. [Output Only] The number of hosts that are allocated in this\nreservation subBlock.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"healthInfo": { +"$ref": "ReservationSubBlockHealthInfo", +"description": "Output only. [Output Only] Health information for the reservation subBlock.", +"readOnly": true +}, +"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" +}, +"inUseCount": { +"description": "Output only. [Output Only] The number of instances that are currently in use on this\nreservation subBlock.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"inUseHostCount": { +"description": "Output only. Number of hosts currently in use. If there is one or more Instances running\non the host, it is considered in use.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"kind": { +"default": "compute#reservationSubBlock", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of this reservation subBlock generated by Google\nCompute Engine. The name must be 1-63 characters long, and comply with\nRFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"readOnly": true, +"type": "string" +}, +"physicalTopology": { +"$ref": "ReservationSubBlockPhysicalTopology", +"description": "Output only. [Output Only] The physical topology of the reservation subBlock.", +"readOnly": true +}, +"reservationSubBlockMaintenance": { +"$ref": "GroupMaintenanceInfo", +"description": "Output only. Maintenance information for this reservation subBlock.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] Status of the reservation subBlock.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY" +], +"enumDescriptions": [ +"Resources are being allocated for the reservation subBlock.", +"Reservation subBlock is currently being deleted.", +"", +"Reservation subBlock has allocated all its resources." +], +"readOnly": true, +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] Zone in which the reservation subBlock resides.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ReservationSubBlockHealthInfo": { +"description": "Health information for the reservation subBlock.", +"id": "ReservationSubBlockHealthInfo", +"properties": { +"degradedHostCount": { +"description": "The number of degraded hosts in the reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"degradedInfraCount": { +"description": "The number of degraded infrastructure (e.g NV link domain) in the\nreservation subblock.", +"format": "int32", +"type": "integer" +}, +"healthStatus": { +"description": "The health status of the reservation subBlock.", +"enum": [ +"DEGRADED", +"HEALTHY", +"HEALTH_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The reservation subBlock is degraded.", +"The reservation subBlock is healthy.", +"The health status of the reservation subBlock is unspecified." +], +"type": "string" +}, +"healthyHostCount": { +"description": "The number of healthy hosts in the reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"healthyInfraCount": { +"description": "The number of healthy infrastructure (e.g NV link domain) in the\nreservation subblock.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"ReservationSubBlockPhysicalTopology": { +"id": "ReservationSubBlockPhysicalTopology", +"properties": { +"block": { +"description": "The hash of the capacity block within the cluster.", +"type": "string" +}, +"cluster": { +"description": "The cluster name of the reservation subBlock.", +"type": "string" +}, +"subBlock": { +"description": "The hash of the capacity sub-block within the capacity block.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationSubBlocksGetResponse": { +"id": "ReservationSubBlocksGetResponse", +"properties": { +"resource": { +"$ref": "ReservationSubBlock" +} +}, +"type": "object" +}, +"ReservationSubBlocksGetVersionRequest": { +"id": "ReservationSubBlocksGetVersionRequest", +"properties": { +"sbomSelections": { +"description": "The SBOM selection to return.", +"items": { +"enum": [ +"SBOM_SELECTION_CURRENT", +"SBOM_SELECTION_TARGET", +"SBOM_SELECTION_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ReservationSubBlocksListResponse": { +"description": "A list of reservation subBlocks under a single reservation.", +"id": "ReservationSubBlocksListResponse", +"properties": { +"id": { +"description": "Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of reservation subBlock resources.", +"items": { +"$ref": "ReservationSubBlock" +}, +"type": "array" +}, +"kind": { +"default": "compute#reservationSubBlock", +"description": "Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation\nsubBlocks.", +"type": "string" +}, +"nextPageToken": { +"description": "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": "Server-defined URL for this resource.", +"type": "string" +}, +"warning": { +"description": "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" +}, +"ReservationSubBlocksReportFaultyRequest": { +"id": "ReservationSubBlocksReportFaultyRequest", +"properties": { +"disruptionSchedule": { +"description": "The disruption schedule for the subBlock.", +"enum": [ +"DISRUPTION_SCHEDULE_UNSPECIFIED", +"IMMEDIATE" +], +"enumDescriptions": [ +"", +"All VMs will be disrupted immediately." +], +"type": "string" +}, +"failureComponent": { +"description": "The component that experienced the fault.", +"enum": [ +"FAILURE_COMPONENT_UNSPECIFIED", +"MULTIPLE_FAULTY_HOSTS", +"NVLINK_SWITCH" +], +"enumDescriptions": [ +"", +"Multiple hosts experienced the fault.", +"The NVLink switch experienced the fault." +], +"type": "string" +}, +"faultReasons": { +"description": "The reasons for the fault experienced with the subBlock.", +"items": { +"$ref": "ReservationSubBlocksReportFaultyRequestFaultReason" +}, +"type": "array" +} +}, +"type": "object" +}, +"ReservationSubBlocksReportFaultyRequestFaultReason": { +"description": "The reason for the fault experienced with the subBlock.", +"id": "ReservationSubBlocksReportFaultyRequestFaultReason", +"properties": { +"behavior": { +"description": "The behavior of the fault experienced with the subBlock.", +"enum": [ +"FAULT_BEHAVIOR_UNSPECIFIED", +"GPU_ERROR", +"NVSWITCH_FAULT_CONTROLLER_ERROR", +"NVSWITCH_FAULT_DEGRADED_BANDWIDTH", +"NVSWITCH_FAULT_SWITCH_ERROR", +"PERFORMANCE", +"SILENT_DATA_CORRUPTION", +"SWITCH_FAILURE" +], +"enumDescriptions": [ +"", +"The subBlock experienced a GPU error.", +"The subBlock experienced an NVSwitch controller error.", +"The subBlock experienced NVSwitch degraded bandwidth.", +"The subBlock experienced an NVSwitch switch error.", +"The subBlock experienced performance issues.", +"The subBlock experienced silent data corruption.", +"The subBlock experienced a switch failure." +], +"type": "string" +}, +"description": { +"description": "The description of the fault experienced with the subBlock.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationsBlocksPerformMaintenanceRequest": { +"id": "ReservationsBlocksPerformMaintenanceRequest", +"properties": { +"maintenanceScope": { +"description": "Specifies if all, running or unused hosts are in scope for this request.", +"enum": [ +"ALL", +"MAINTENANCE_SCOPE_UNSPECIFIED", +"RUNNING_VMS", +"UNUSED_CAPACITY" +], +"enumDescriptions": [ +"Trigger maintenance for all hosts belonging to this reservation\nirrespective of whether VMs are running on them or not.", +"Internal only", +"Trigger maintenance only on the hosts belonging to this reservation which\nhave VMs running on them.", +"Trigger maintenance only on the hosts belonging to this reservation which\ndo not have any VMs running on them. This is not allowed for Standard ExR" +], +"type": "string" +} +}, +"type": "object" +}, +"ReservationsPerformMaintenanceRequest": { +"id": "ReservationsPerformMaintenanceRequest", +"properties": { +"maintenanceScope": { +"description": "Specifies if all, running or unused hosts are in scope for this request.", +"enum": [ +"ALL", +"MAINTENANCE_SCOPE_UNSPECIFIED", +"RUNNING_VMS", +"UNUSED_CAPACITY" +], +"enumDescriptions": [ +"Trigger maintenance for all hosts belonging to this reservation\nirrespective of whether VMs are running on them or not.", +"Internal only", +"Trigger maintenance only on the hosts belonging to this reservation which\nhave VMs running on them.", +"Trigger maintenance only on the hosts belonging to this reservation which\ndo not have any VMs running on them. This is not allowed for Standard ExR" +], +"type": "string" +} +}, +"type": "object" +}, +"ReservationsResizeRequest": { +"id": "ReservationsResizeRequest", +"properties": { +"specificSkuCount": { +"description": "Number of allocated resources can be resized with minimum = 1 and\nmaximum = 1000.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"ReservationsScopedList": { +"id": "ReservationsScopedList", +"properties": { +"reservations": { +"description": "A list of reservations contained in this scope.", +"items": { +"$ref": "Reservation" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of reservations when\nthe 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.", +"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" +}, +"ResourceCommitment": { +"description": "Commitment for a particular hardware resource (a commitment is composed of\none or more of these).", +"id": "ResourceCommitment", +"properties": { +"acceleratorType": { +"description": "Name of the accelerator type or GPU resource. Specify this field only when\nthe type of hardware resource is ACCELERATOR.", +"type": "string" +}, +"amount": { +"description": "The quantity of the hardware resource that you want to commit to purchasing\n(in a type-dependent unit).\n \n - For vCPUs, you must specify an integer value.\n - For memory, you specify the amount of MB that you want. The value you\n specify must be a multiple of 256 MB, with up to 6.5 GB of\n memory per every vCPU.\n - For GPUs, you must specify an integer value.\n - For Local SSD disks, you must specify the amount in GB. The size of a\n single Local SSD disk is 375 GB.", +"format": "int64", +"type": "string" +}, +"type": { +"description": "The type of hardware resource that you want to specify.\nYou can specify any of the following values:\n \n - VCPU\n - MEMORY\n - LOCAL_SSD\n - ACCELERATOR\n\n\n\nSpecify as a separate entry in the list for each\nindividual resource type.", +"enum": [ +"ACCELERATOR", +"LOCAL_SSD", +"MEMORY", +"UNSPECIFIED", +"VCPU" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ResourceGroupReference": { +"id": "ResourceGroupReference", +"properties": { +"group": { +"description": "A URI referencing one of the instance groups or network endpoint groups\nlisted in the backend service.", +"type": "string" +} +}, +"type": "object" +}, +"ResourceMetadata": { +"description": "Standardized resource metadata common to all compute resources.", +"id": "ResourceMetadata", +"properties": { +"apiVersion": { +"description": "The version of the API interface that this resource was retrieved through.\nFor example, `\"2025-01-01\"` or `\"2025-01-01-preview\"`.", +"type": "string" +}, +"resourceType": { +"description": "The canonical resource type name in the format of a resource type\nas defined by [AIP-123](https://google.aip.dev/123).\nFor example, `\"compute.googleapis.com/Instance\"`.", +"type": "string" +} +}, +"type": "object" +}, +"ResourcePoliciesScopedList": { +"id": "ResourcePoliciesScopedList", +"properties": { +"resourcePolicies": { +"description": "A list of resourcePolicies contained in this scope.", +"items": { +"$ref": "ResourcePolicy" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of resourcePolicies when\nthe 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.", +"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" +}, +"ResourcePolicy": { +"description": "Represents a Resource Policy resource. You can use resource policies to\nschedule actions for some Compute Engine resources. For example, you can\nuse them toschedule persistent disk\nsnapshots.", +"id": "ResourcePolicy", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"type": "string" +}, +"diskConsistencyGroupPolicy": { +"$ref": "ResourcePolicyDiskConsistencyGroupPolicy", +"description": "Resource policy for disk consistency groups." +}, +"groupPlacementPolicy": { +"$ref": "ResourcePolicyGroupPlacementPolicy", +"description": "Resource policy for instances for placement configuration." +}, +"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" +}, +"instanceSchedulePolicy": { +"$ref": "ResourcePolicyInstanceSchedulePolicy", +"description": "Resource policy for scheduling instance operations." +}, +"kind": { +"default": "compute#resourcePolicy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.instances.insert" +] +}, +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\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" +}, +"region": { +"readOnly": true, +"type": "string" +}, +"resourceStatus": { +"$ref": "ResourcePolicyResourceStatus", +"description": "Output only. [Output Only] The system status of the resource policy.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"snapshotSchedulePolicy": { +"$ref": "ResourcePolicySnapshotSchedulePolicy", +"description": "Resource policy for persistent disks for creating snapshots." +}, +"status": { +"description": "Output only. [Output Only] The status of resource policy creation.", +"enum": [ +"CREATING", +"DELETING", +"EXPIRED", +"INVALID", +"READY" +], +"enumDescriptions": [ +"Resource policy is being created.", +"Resource policy is being deleted.", +"Resource policy is expired and will not run again.", +"", +"Resource policy is ready to be used." +], +"readOnly": true, +"type": "string" +}, +"workloadPolicy": { +"$ref": "ResourcePolicyWorkloadPolicy", +"description": "Resource policy for defining instance placement for MIGs." +} +}, +"type": "object" +}, +"ResourcePolicyAggregatedList": { +"description": "Contains a list of resourcePolicies.", +"id": "ResourcePolicyAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "ResourcePoliciesScopedList", +"description": "Name of the scope containing this set of resourcePolicies." +}, +"description": "A list of ResourcePolicy resources.", +"type": "object" +}, +"kind": { +"default": "compute#resourcePolicyAggregatedList", +"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" +}, +"ResourcePolicyDailyCycle": { +"description": "Time window specified for daily operations.", +"id": "ResourcePolicyDailyCycle", +"properties": { +"daysInCycle": { +"description": "Defines a schedule with units measured in days. The value determines\nhow many days pass between the start of each cycle.", +"format": "int32", +"type": "integer" +}, +"duration": { +"description": "Output only. [Output only] A predetermined duration for the window, automatically\nchosen to be the smallest possible in the given scenario.", +"readOnly": true, +"type": "string" +}, +"startTime": { +"description": "Start time of the window. This must be in UTC format that resolves to one\nof 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For\nexample, both 13:00-5 and 08:00 are valid.", +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicyDiskConsistencyGroupPolicy": { +"description": "Resource policy for disk consistency groups.", +"id": "ResourcePolicyDiskConsistencyGroupPolicy", +"properties": {}, +"type": "object" +}, +"ResourcePolicyGroupPlacementPolicy": { +"description": "A GroupPlacementPolicy specifies resource placement configuration.\nIt specifies the failure bucket separation", +"id": "ResourcePolicyGroupPlacementPolicy", +"properties": { +"acceleratorTopologyMode": { +"description": "Specifies the connection mode for the accelerator topology. If not\nspecified, the default is AUTO_CONNECT.", +"enum": [ +"AUTO_CONNECT", +"PROVISION_ONLY" +], +"enumDescriptions": [ +"The interconnected chips are pre-configured at the time of VM creation.", +"The interconnected chips are connected on demand. At the time of VM\ncreation, the chips are not connected." +], +"type": "string" +}, +"availabilityDomainCount": { +"description": "The number of availability domains to spread instances across. If two\ninstances are in different availability domain, they are not in the same\nlow latency network.", +"format": "int32", +"type": "integer" +}, +"collocation": { +"description": "Specifies network collocation", +"enum": [ +"COLLOCATED", +"UNSPECIFIED_COLLOCATION" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"gpuTopology": { +"description": "Specifies the shape of the GPU slice, in slice based GPU families eg.\nA4X.", +"type": "string" +}, +"vmCount": { +"description": "Number of VMs in this placement group. Google does not recommend that you\nuse this field unless you use a compact policy and you want your policy\nto work only if it contains this exact number of VMs.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"ResourcePolicyHourlyCycle": { +"description": "Time window specified for hourly operations.", +"id": "ResourcePolicyHourlyCycle", +"properties": { +"duration": { +"description": "Output only. [Output only] Duration of the time window, automatically chosen to be\nsmallest possible in the given scenario.", +"readOnly": true, +"type": "string" +}, +"hoursInCycle": { +"description": "Defines a schedule with units measured in hours. The value determines\nhow many hours pass between the start of each cycle.", +"format": "int32", +"type": "integer" +}, +"startTime": { +"description": "Time within the window to start the operations.\nIt must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicyInstanceSchedulePolicy": { +"description": "An InstanceSchedulePolicy specifies when and how frequent certain\noperations are performed on the instance.", +"id": "ResourcePolicyInstanceSchedulePolicy", +"properties": { +"expirationTime": { +"description": "The expiration time of the schedule. The timestamp is an RFC3339 string.", +"type": "string" +}, +"startTime": { +"description": "The start time of the schedule. The timestamp is an RFC3339 string.", +"type": "string" +}, +"timeZone": { +"description": "Specifies the time zone to be used in interpreting Schedule.schedule.\nThe value of this field must be a time zone name from the tz database:\nhttps://wikipedia.org/wiki/Tz_database.", +"type": "string" +}, +"vmStartSchedule": { +"$ref": "ResourcePolicyInstanceSchedulePolicySchedule", +"description": "Specifies the schedule for starting instances." +}, +"vmStopSchedule": { +"$ref": "ResourcePolicyInstanceSchedulePolicySchedule", +"description": "Specifies the schedule for stopping instances." +} +}, +"type": "object" +}, +"ResourcePolicyInstanceSchedulePolicySchedule": { +"description": "Schedule for an instance operation.", +"id": "ResourcePolicyInstanceSchedulePolicySchedule", +"properties": { +"schedule": { +"description": "Specifies the frequency for the operation, using the unix-cron format.", +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicyList": { +"id": "ResourcePolicyList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"description": "[Output Only] A list of ResourcePolicy resources.", +"items": { +"$ref": "ResourcePolicy" +}, +"type": "array" +}, +"kind": { +"default": "compute#resourcePolicyList", +"description": "Output only. [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies", +"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.", +"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" +}, +"ResourcePolicyResourceStatus": { +"description": "Contains output only fields.\nUse this sub-message for all output fields set on ResourcePolicy.\nThe internal structure of this \"status\" field should mimic the structure\nof ResourcePolicy proto specification.", +"id": "ResourcePolicyResourceStatus", +"properties": { +"instanceSchedulePolicy": { +"$ref": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", +"description": "Output only. [Output Only] Specifies a set of output values reffering to\nthe instance_schedule_policy system status.\nThis field should have the same name as corresponding policy field.", +"readOnly": true +} +}, +"type": "object" +}, +"ResourcePolicyResourceStatusInstanceSchedulePolicyStatus": { +"id": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", +"properties": { +"lastRunStartTime": { +"description": "Output only. [Output Only] The last time the schedule successfully ran.\nThe timestamp is an RFC3339 string.", +"readOnly": true, +"type": "string" +}, +"nextRunStartTime": { +"description": "Output only. [Output Only] The next time the schedule is planned to run.\nThe actual time might be slightly different.\nThe timestamp is an RFC3339 string.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicySnapshotSchedulePolicy": { +"description": "A snapshot schedule policy specifies when and how frequently snapshots are\nto be created for the target disk. Also specifies how many and how long\nthese scheduled snapshots should be retained.", +"id": "ResourcePolicySnapshotSchedulePolicy", +"properties": { +"retentionPolicy": { +"$ref": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", +"description": "Retention policy applied to snapshots created by this resource policy." +}, +"schedule": { +"$ref": "ResourcePolicySnapshotSchedulePolicySchedule", +"description": "A Vm Maintenance Policy specifies what kind of infrastructure\nmaintenance we are allowed to perform on this VM and when. Schedule\nthat is applied to disks covered by this policy." +}, +"snapshotProperties": { +"$ref": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", +"description": "Properties with which snapshots are created such as labels, encryption\nkeys." +} +}, +"type": "object" +}, +"ResourcePolicySnapshotSchedulePolicyRetentionPolicy": { +"description": "Policy for retention of scheduled snapshots.", +"id": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", +"properties": { +"maxRetentionDays": { +"description": "Maximum age of the snapshot that is allowed to be kept.", +"format": "int32", +"type": "integer" +}, +"onSourceDiskDelete": { +"description": "Specifies the behavior to apply to scheduled snapshots when\nthe source disk is deleted.", +"enum": [ +"APPLY_RETENTION_POLICY", +"KEEP_AUTO_SNAPSHOTS", +"UNSPECIFIED_ON_SOURCE_DISK_DELETE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicySnapshotSchedulePolicySchedule": { +"description": "A schedule for disks where the schedueled operations are performed.", +"id": "ResourcePolicySnapshotSchedulePolicySchedule", +"properties": { +"dailySchedule": { +"$ref": "ResourcePolicyDailyCycle" +}, +"hourlySchedule": { +"$ref": "ResourcePolicyHourlyCycle" +}, +"weeklySchedule": { +"$ref": "ResourcePolicyWeeklyCycle" +} +}, +"type": "object" +}, +"ResourcePolicySnapshotSchedulePolicySnapshotProperties": { +"description": "Specified snapshot properties for scheduled snapshots created by this\npolicy.", +"id": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", +"properties": { +"chainName": { +"description": "Chain name that the snapshot is created in.", +"type": "string" +}, +"guestFlush": { +"description": "Indication to perform a 'guest aware' snapshot.", +"type": "boolean" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to scheduled snapshots. These can be later modified\nby the setLabels method. Label values may be empty.", +"type": "object" +}, +"storageLocations": { +"description": "Cloud Storage bucket storage location of the auto snapshot (regional or\nmulti-regional).", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ResourcePolicyWeeklyCycle": { +"description": "Time window specified for weekly operations.", +"id": "ResourcePolicyWeeklyCycle", +"properties": { +"dayOfWeeks": { +"description": "Up to 7 intervals/windows, one for each day of the week.", +"items": { +"$ref": "ResourcePolicyWeeklyCycleDayOfWeek" +}, +"type": "array" +} +}, +"type": "object" +}, +"ResourcePolicyWeeklyCycleDayOfWeek": { +"id": "ResourcePolicyWeeklyCycleDayOfWeek", +"properties": { +"day": { +"description": "Defines a schedule that runs on specific days of the week. Specify\none or more days. The following options are available:\nMONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.", +"enum": [ +"FRIDAY", +"INVALID", +"MONDAY", +"SATURDAY", +"SUNDAY", +"THURSDAY", +"TUESDAY", +"WEDNESDAY" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"duration": { +"description": "Output only. [Output only] Duration of the time window, automatically chosen to be\nsmallest possible in the given scenario.", +"readOnly": true, +"type": "string" +}, +"startTime": { +"description": "Time within the window to start the operations.\nIt must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", +"type": "string" +} +}, +"type": "object" +}, +"ResourcePolicyWorkloadPolicy": { +"description": "Represents the workload policy.", +"id": "ResourcePolicyWorkloadPolicy", +"properties": { +"acceleratorTopology": { +"description": "Specifies the topology required to create a partition for VMs that have\ninterconnected GPUs.", +"type": "string" +}, +"acceleratorTopologyMode": { +"description": "Specifies the connection mode for the accelerator topology. If not\nspecified, the default is AUTO_CONNECT.", +"enum": [ +"AUTO_CONNECT", +"PROVISION_ONLY" +], +"enumDescriptions": [ +"The interconnected chips are pre-configured at the time of VM creation.", +"The interconnected chips are connected on demand. At the time of VM\ncreation, the chips are not connected." +], +"type": "string" +}, +"maxTopologyDistance": { +"description": "Specifies the maximum distance between instances.", +"enum": [ +"BLOCK", +"CLUSTER", +"SUBBLOCK" +], +"enumDescriptions": [ +"VMs must be provisioned in the same block.", +"VMs must be provisioned in the same cluster.", +"VMs must be provisioned in the same subblock." +], +"type": "string" +}, +"type": { +"description": "Specifies the intent of the instance placement in the MIG.", +"enum": [ +"HIGH_AVAILABILITY", +"HIGH_THROUGHPUT" +], +"enumDescriptions": [ +"MIG spreads out the instances as much as possible for high availability.", +"MIG provisions instances as close to each other as possible for high\nthroughput." +], +"type": "string" +} +}, +"type": "object" +}, +"ResourceStatus": { +"description": "Contains output only fields.\nUse this sub-message for actual values set on Instance attributes as compared\nto the value requested by the user (intent) in their instance CRUD calls.", +"id": "ResourceStatus", +"properties": { +"effectiveInstanceMetadata": { +"$ref": "ResourceStatusEffectiveInstanceMetadata", +"description": "Output only. [Output Only] Effective metadata is a field that consolidates project,\nzonal instance settings, and instance-level predefined metadata keys to\nprovide the overridden value for those metadata keys at the instance level.", +"readOnly": true +}, +"physicalHost": { +"description": "Output only. [Output Only] The precise location of your instance within the zone's data\ncenter, including the block, sub-block, and host. The field is formatted as\nfollows: blockId/subBlockId/hostId.", +"readOnly": true, +"type": "string" +}, +"physicalHostTopology": { +"$ref": "ResourceStatusPhysicalHostTopology", +"description": "Output only. [Output Only] A series of fields containing the global name of the Compute\nEngine cluster, as well as the ID of the block, sub-block, and host on\nwhich the running instance is located.", +"readOnly": true +}, +"reservationConsumptionInfo": { +"$ref": "ResourceStatusReservationConsumptionInfo", +"description": "Output only. [Output Only] Reservation information that the instance is consuming from.", +"readOnly": true +}, +"scheduling": { +"$ref": "ResourceStatusScheduling" +}, +"shutdownDetails": { +"$ref": "ResourceStatusShutdownDetails", +"description": "Output only. [Output Only] Details about the instance stopping state.", +"readOnly": true +}, +"upcomingMaintenance": { +"$ref": "UpcomingMaintenance", +"readOnly": true +} +}, +"type": "object" +}, +"ResourceStatusEffectiveInstanceMetadata": { +"description": "Effective values of predefined metadata keys for an instance.", +"id": "ResourceStatusEffectiveInstanceMetadata", +"properties": { +"blockProjectSshKeysMetadataValue": { +"description": "Effective block-project-ssh-keys value at Instance level.", +"type": "boolean" +}, +"enableGuestAttributesMetadataValue": { +"description": "Effective enable-guest-attributes value at Instance level.", +"type": "boolean" +}, +"enableOsInventoryMetadataValue": { +"description": "Effective enable-os-inventory value at Instance level.", +"type": "boolean" +}, +"enableOsconfigMetadataValue": { +"description": "Effective enable-osconfig value at Instance level.", +"type": "boolean" +}, +"enableOsloginMetadataValue": { +"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" +}, +"serialPortLoggingEnableMetadataValue": { +"description": "Effective serial-port-logging-enable value at Instance level.", +"type": "boolean" +}, +"vmDnsSettingMetadataValue": { +"description": "Effective VM DNS setting at Instance level.", +"type": "string" +} +}, +"type": "object" +}, +"ResourceStatusPhysicalHostTopology": { +"description": "Represents the physical host topology of the host on which the VM is\nrunning.", +"id": "ResourceStatusPhysicalHostTopology", +"properties": { +"additionalAttributes": { +"$ref": "ResourceStatusPhysicalHostTopologyAdditionalAttributes", +"description": "Output only. [Output Only] Additional location information of the running instance.", +"readOnly": true +}, +"block": { +"description": "[Output Only] The ID of the block in which the running instance is\nlocated. Instances within the same block experience low network latency.", +"type": "string" +}, +"cluster": { +"description": "[Output Only] The global name of the Compute Engine cluster where the\nrunning instance is located.", +"type": "string" +}, +"host": { +"description": "[Output Only] The ID of the host on which the running instance is located.\nInstances on the same host experience the lowest possible network\nlatency.", +"type": "string" +}, +"subblock": { +"description": "[Output Only] The ID of the sub-block in which the running instance is\nlocated. Instances in the same sub-block experience lower network latency\nthan instances in the same block.", +"type": "string" +} +}, +"type": "object" +}, +"ResourceStatusPhysicalHostTopologyAdditionalAttributes": { +"description": "Additional location information of the running instance.", +"id": "ResourceStatusPhysicalHostTopologyAdditionalAttributes", +"properties": { +"acceleratorTopologyIds": { +"additionalProperties": { +"type": "string" +}, +"description": "Output only. The IDs of the accelerator topologies the instance belongs to. For\nexample\nThe key will be topologies like \"4x4\", \"2x2x2\" and the value will be\nthe location ID of the topologies.", +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"ResourceStatusReservationConsumptionInfo": { +"description": "Reservation consumption information that the instance is consuming from.", +"id": "ResourceStatusReservationConsumptionInfo", +"properties": { +"consumedReservation": { +"description": "Output only. [Output Only] The full resource name of the reservation that this\ninstance is consuming from.", +"readOnly": true, +"type": "string" +}, +"consumedReservationBlock": { +"description": "Output only. [Output Only] The full resource name of the reservation block that this\ninstance is consuming from.", +"readOnly": true, +"type": "string" +}, +"consumedReservationSubBlock": { +"description": "Output only. [Output Only] The full resource name of the reservation sub-block that\nthis instance is consuming from.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ResourceStatusScheduling": { +"id": "ResourceStatusScheduling", +"properties": { +"availabilityDomain": { +"description": "Specifies the availability domain to place the instance in. The value\nmust be a number between 1 and the number of availability domains\nspecified in the spread placement policy attached to the instance.", +"format": "int32", +"type": "integer" +}, +"gracefulShutdownTimestamp": { +"description": "Output only. Specifies the timestamp, when the instance will start graceful shutdown\nprocess, in RFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"terminationTimestamp": { +"description": "Time in future when the instance will be terminated inRFC3339 text format.", +"type": "string" +} +}, +"type": "object" +}, +"ResourceStatusShutdownDetails": { +"description": "Specifies if the instance is in `PENDING_STOP` state or there is a\nprogrammed stop scheduled.", +"id": "ResourceStatusShutdownDetails", +"properties": { +"maxDuration": { +"$ref": "Duration", +"description": "The duration for graceful shutdown. Only applicable when\n`stop_state=PENDING_STOP`." +}, +"requestTimestamp": { +"description": "Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.", +"type": "string" +}, +"stopState": { +"description": "Current stopping state of the instance.", +"enum": [ +"PENDING_STOP", +"STOPPING" +], +"enumDescriptions": [ +"The instance is gracefully shutting down.", +"The instance is stopping." +], +"type": "string" +}, +"targetState": { +"description": "Target instance state.", +"enum": [ +"DELETED", +"STOPPED" +], +"enumDescriptions": [ +"The instance will be deleted.", +"The instance will be stopped." +], +"type": "string" +} +}, +"type": "object" +}, +"RiskDetails": { +"description": "Detailed insights and metrics about a detected reliability risk.", +"id": "RiskDetails", +"properties": { +"duration": { +"description": "The duration of the risk since it was detected.", +"format": "google-duration", +"type": "string" +}, +"globalDnsInsight": { +"$ref": "RiskDetailsGlobalDnsInsight", +"description": "Insight details for global DNS risk." +}, +"lastUpdateTimestamp": { +"description": "The last time the risk was updated.", +"format": "google-datetime", +"type": "string" +}, +"severity": { +"description": "The severity of the risk.", +"enum": [ +"CRITICAL", +"HIGH", +"LOW", +"MEDIUM", +"SEVERITY_UNSPECIFIED" +], +"enumDescriptions": [ +"Critical severity.", +"High severity.", +"Low severity.", +"Medium severity.", +"No severity specified. The default value." +], +"type": "string" +}, +"type": { +"description": "The type of risk.", +"enum": [ +"GLOBAL_DNS", +"RISK_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Risk type related to global DNS.", +"Default value. This value is unused." +], +"type": "string" +} +}, +"type": "object" +}, +"RiskDetailsGlobalDnsInsight": { +"description": "Detailed insights for a global DNS reliability risk.", +"id": "RiskDetailsGlobalDnsInsight", +"properties": { +"projectDefaultIsGlobalDns": { +"description": "Indicates whether the project's default DNS setting is global DNS.", +"type": "boolean" +}, +"queryObservationWindow": { +"description": "The observation window for the query counts.", +"format": "google-duration", +"type": "string" +}, +"riskyQueryCount": { +"description": "The number of queries that are risky. This is always less than or\nequal to total_query_count.", +"format": "int64", +"type": "string" +}, +"totalQueryCount": { +"description": "The total number of queries in the observation window.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RiskRecommendation": { +"description": "Recommendation for mitigating a reliability risk, including a reference URL.", +"id": "RiskRecommendation", +"properties": { +"content": { +"description": "Mitigation guide for the risk.", +"type": "string" +}, +"referenceUrl": { +"description": "URL referencing a more detailed mitigation guide.", +"type": "string" +} +}, +"type": "object" +}, +"Rollout": { +"description": "Rollout resource.\n\nA Rollout is a specific instance of a RolloutPlan. It represents a single\nexecution of a strategy to roll out a specific resource. It also provides\nAPIs to interact with the rollout.", +"id": "Rollout", +"properties": { +"cancellationTime": { +"description": "Output only. The timestamp at which the Rollout was cancelled.", +"readOnly": true, +"type": "string" +}, +"completionTime": { +"description": "Output only. The timestamp at which the Rollout was completed.", +"readOnly": true, +"type": "string" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"currentWaveNumber": { +"description": "Output only. The number of the currently running wave.\nEx. 1", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"etag": { +"description": "Output only. etag of the Rollout\nEx. abc1234", +"readOnly": true, +"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#rollout", +"description": "Output only. [Output Only] Type of the resource. Always compute#rollout\nfor rollouts.", +"readOnly": true, +"type": "string" +}, +"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.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"pauseTime": { +"description": "Output only. The timestamp at which the Rollout was paused.", +"readOnly": true, +"type": "string" +}, +"resumeTime": { +"description": "Output only. The timestamp at which the Rollout was resumed.", +"readOnly": true, +"type": "string" +}, +"rolloutEntity": { +"$ref": "RolloutRolloutEntity", +"description": "Required. The resource being rolled out." +}, +"rolloutPlan": { +"description": "Required. Rollout Plan used to model the Rollout.\nEx. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The current state of the Rollout.", +"enum": [ +"CANCELLED", +"CANCELLING", +"CANCEL_FAILED", +"COMPLETED", +"COMPLETE_FAILED", +"COMPLETING", +"FAILED", +"PAUSED", +"PAUSE_FAILED", +"PAUSING", +"PROCESSING", +"READY", +"RESUMING", +"ROLLBACK_WAVE_FAILED", +"ROLLING_BACK", +"STATE_UNSPECIFIED", +"UNINITIALIZED", +"WAVE_FAILED" +], +"enumDescriptions": [ +"The rollout is in a failure terminal state.", +"The rollout is being cancelled.", +"An attempted cancel operation was unsuccessful.", +"The rollout is in a successful terminal state.", +"An attempted complete operation was unsuccessful.", +"The rollout is being marked as completed.", +"The rollout completed with failures.", +"The rollout is paused.", +"An attempted pause operation was unsuccessful.", +"The rollout is being paused.", +"A wave is being processed by the product.", +"The rollout has been successfully initialized and is ready to start.", +"The rollout is being resumed after being paused.", +"An attempted rollback operation failed to complete successfully.", +"A wave rollback is in progress for this rollout.", +"Undefined default state. Should never be exposed to users.", +"The rollout has been created but is not yet ready to be started.", +"The product failed to process the wave." +], +"readOnly": true, +"type": "string" +}, +"waveDetails": { +"description": "Output only. Details about each wave of the rollout.", +"items": { +"$ref": "RolloutWaveDetails" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"RolloutPlan": { +"description": "RolloutPlan resource.\n\nA RolloutPlan is the customer-defined strategy to divide a large-scale change\ninto smaller increments, referred to as \"waves\". Each wave targets a specific\nportion of the overall affected area and defines criteria that must be met\nbefore progressing to the subsequent wave.", +"id": "RolloutPlan", +"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" +}, +"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#rolloutPlan", +"description": "Output only. [Output Only] Type of the resource. Always compute#rolloutPlan\nfor rolloutPlans.", +"readOnly": true, +"type": "string" +}, +"locationScope": { +"description": "The location scope of the rollout plan. If not specified, the location\nscope is considered as ZONAL.", +"enum": [ +"LOCATION_SCOPE_UNSPECIFIED", +"REGIONAL", +"ZONAL" +], +"enumDescriptions": [ +"Unspecified value. Considered as ZONAL.", +"Regional scope.", +"Zonal scope." +], +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.rolloutPlans.insert" +] +}, +"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])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"waves": { +"description": "Required. The waves included in this rollout plan.", +"items": { +"$ref": "RolloutPlanWave" +}, +"type": "array" +} +}, +"type": "object" +}, +"RolloutPlanWave": { +"description": "A single wave in a rollout plan.", +"id": "RolloutPlanWave", +"properties": { +"displayName": { +"description": "Optional. The display name of this wave of the rollout plan.", +"type": "string" +}, +"number": { +"description": "Output only. The wave number.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"orchestrationOptions": { +"$ref": "RolloutPlanWaveOrchestrationOptions", +"description": "Optional. The orchestration options for this wave." +}, +"selectors": { +"description": "Required. The selectors for this wave. There is a logical AND between each selector\ndefined in a wave, so a resource must satisfy the criteria of *all* the\nspecified selectors to be in scope for the wave.", +"items": { +"$ref": "RolloutPlanWaveSelector" +}, +"type": "array" +}, +"validation": { +"$ref": "RolloutPlanWaveValidation", +"description": "Required. The validation to be performed at the end of this wave." +} +}, +"type": "object" +}, +"RolloutPlanWaveOrchestrationOptions": { +"description": "Options to control the pace of orchestration of a wave. These options are\nrequired only if the resource being rolled out follows the Orchestrated\npattern.", +"id": "RolloutPlanWaveOrchestrationOptions", +"properties": { +"delays": { +"description": "Optional. Delays, if any, to be added between batches of projects. We allow\nmultiple Delays to be specified, letting users set separate delays\nbetween batches of projects corresponding to different locations and\nbatches of projects corresponding to the same location.", +"items": { +"$ref": "RolloutPlanWaveOrchestrationOptionsDelay" +}, +"type": "array" +}, +"maxConcurrentLocations": { +"description": "Optional. Maximum number of locations to be orchestrated in parallel.", +"format": "int64", +"type": "string" +}, +"maxConcurrentResourcesPerLocation": { +"description": "Optional. Maximum number of resources to be orchestrated per location in\nparallel.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RolloutPlanWaveOrchestrationOptionsDelay": { +"description": "Options to control the delay, if any, between batches of projects.", +"id": "RolloutPlanWaveOrchestrationOptionsDelay", +"properties": { +"delimiter": { +"description": "Optional. Controls whether the delay should only be added between batches of\nprojects corresponding to different locations, or also between\nbatches of projects corresponding to the same location.\n\nMust be set to DELIMITER_UNSPECIFIED if no delay is to be added.", +"enum": [ +"DELIMITER_BATCH", +"DELIMITER_LOCATION", +"DELIMITER_UNSPECIFIED" +], +"enumDescriptions": [ +"The delay will also be added between batches of projects\ncorresponding to the same location.", +"The delay will only be added between batches of projects\ncorresponding to different locations.", +"No delay will be added between batches of projects. Processing will\ncontinue with the next batch as soon as the previous batch of LROs\nis done." +], +"type": "string" +}, +"duration": { +"description": "Optional. The duration of the delay, if any, to be added between batches of\nprojects. A zero duration corresponds to no delay.", +"format": "google-duration", +"type": "string" +}, +"type": { +"description": "Optional. Controls whether the specified duration is to be added at the end of\neach batch, or if the total processing time for each batch will be\npadded if needed to meet the specified duration.\n\nMust be set to TYPE_UNSPECIFIED if no delay is to be added.", +"enum": [ +"TYPE_MINIMUM", +"TYPE_OFFSET", +"TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"The total processing time for each batch of projects will be padded\nif needed to meet the specified delay duration.", +"The specified delay will directly be added after each batch of\nprojects as specified by the delimiter.", +"No delay will be added between batches of projects. Processing will\ncontinue with the next batch as soon as the previous batch of LROs\nis done." +], +"type": "string" +} +}, +"type": "object" +}, +"RolloutPlanWaveSelector": { +"description": "A selector which specifies what resource(s) are included in a given wave.", +"id": "RolloutPlanWaveSelector", +"properties": { +"locationSelector": { +"$ref": "RolloutPlanWaveSelectorLocationSelector", +"description": "Optional. Roll out to resources by Cloud locations." +}, +"resourceHierarchySelector": { +"$ref": "RolloutPlanWaveSelectorResourceHierarchySelector", +"description": "Optional. Roll out to resources by Cloud Resource Manager resource hierarchy." +} +}, +"type": "object" +}, +"RolloutPlanWaveSelectorLocationSelector": { +"description": "Roll out to resources by location.", +"id": "RolloutPlanWaveSelectorLocationSelector", +"properties": { +"includedLocations": { +"description": "Optional. Example: \"us-central1-a\"", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RolloutPlanWaveSelectorResourceHierarchySelector": { +"description": "Roll out to resources by Cloud Resource Manager resource hierarchy\nnodes such as projects, folders, orgs.", +"id": "RolloutPlanWaveSelectorResourceHierarchySelector", +"properties": { +"includedFolders": { +"description": "Optional. Format: \"folders/{folder_id}\"", +"items": { +"type": "string" +}, +"type": "array" +}, +"includedOrganizations": { +"description": "Optional. Format: \"organizations/{organization_id}\"", +"items": { +"type": "string" +}, +"type": "array" +}, +"includedProjects": { +"description": "Optional. Format: \"projects/{project_id}\"", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RolloutPlanWaveValidation": { +"description": "The validation to be performed before progressing to the next wave.", +"id": "RolloutPlanWaveValidation", +"properties": { +"timeBasedValidationMetadata": { +"$ref": "RolloutPlanWaveValidationTimeBasedValidationMetadata", +"description": "Optional. Metadata required if type = \"time\"." +}, +"type": { +"description": "Required. The type of the validation. If a type of validation is associated with\na metadata object, the appropriate metadata field mapping to the\nvalidation type must be provided in the validation message. Possible\nvalues are in quotes below alongside an explanation:\n \"manual\": The system waits for an end-user approval API before\n progressing to the next wave.\n \"time\": The system waits for a user specified duration before\n progressing to the next wave. TimeBasedValidation must be provided.", +"type": "string" +} +}, +"type": "object" +}, +"RolloutPlanWaveValidationTimeBasedValidationMetadata": { +"description": "Metadata required if type = \"time\".", +"id": "RolloutPlanWaveValidationTimeBasedValidationMetadata", +"properties": { +"waitDuration": { +"description": "Optional. The duration that the system waits in between waves. This wait starts\nafter all changes in the wave are rolled out.", +"format": "google-duration", +"type": "string" +} +}, +"type": "object" +}, +"RolloutPlansListResponse": { +"description": "Contains a list of RolloutPlan resources.", +"id": "RolloutPlansListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of RolloutPlan resources.", +"items": { +"$ref": "RolloutPlan" +}, +"type": "array" +}, +"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" +}, +"RolloutRolloutEntity": { +"description": "Specifications of the resource to roll out.", +"id": "RolloutRolloutEntity", +"properties": { +"orchestratedEntity": { +"$ref": "RolloutRolloutEntityOrchestratedEntity", +"description": "Optional. Entity details for products using the Orchestrated Integration model." +} +}, +"type": "object" +}, +"RolloutRolloutEntityOrchestratedEntity": { +"description": "This message is used if the resource type follows the Orchestrated\nintegration model with ProgressiveRollout.", +"id": "RolloutRolloutEntityOrchestratedEntity", +"properties": { +"conflictBehavior": { +"description": "Required. Specifies the behavior of the Rollout if an out of band update is\ndetected in a project during a Rollout. It can be one of the following\nvalues:\n1) overwrite : Overwrite the local value with the rollout value.\n2) no_overwrite : Do not overwrite the local value with the rollout\nvalue.", +"type": "string" +}, +"orchestrationAction": { +"description": "Required. Orchestration action during the Rollout. It can be one of the following\nvalues:\n1) \"update\": Resources will be updated by the rollout.\n2) \"delete\": Resources will be deleted by the rollout.", +"type": "string" +}, +"orchestrationSource": { +"description": "Required. Fully qualified resource name of the resource which contains the source\nof truth of the configuration being rolled out across\nlocations/projects. For example, in the case of a global Rollout which\nis applied across regions, this contains the name of the global\nresource created by the user which contains a payload for a resource\nthat is orchestrated across regions. This follows the following format:\n//.googleapis.com/projects//locations/global//\ne.g.\n//osconfig.googleapis.com/projects/1/locations/global/policyOrchestrators/po1", +"type": "string" +} +}, +"type": "object" +}, +"RolloutWaveDetails": { +"description": "Additional metadata about the status of each wave provided by the server.", +"id": "RolloutWaveDetails", +"properties": { +"orchestratedWaveDetails": { +"$ref": "RolloutWaveDetailsOrchestratedWaveDetails", +"description": "Output only. Additional details of the wave for products using the Orchestrated\nIntegration model.", +"readOnly": true +}, +"waveDisplayName": { +"description": "Output only. Wave name.\nEx. wave1", +"readOnly": true, +"type": "string" +}, +"waveNumber": { +"description": "Output only. System generated number for the wave.", +"format": "int64", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"RolloutWaveDetailsOrchestratedWaveDetails": { +"description": "Details of the wave for products using the Orchestrated integration\nmodel.", +"id": "RolloutWaveDetailsOrchestratedWaveDetails", +"properties": { +"completedResourcesCount": { +"description": "Output only. Resource completed so far.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"estimatedCompletionTime": { +"description": "Output only. Estimated timestamp at which the wave will complete. Extrapolated from\ncurrent progress.", +"readOnly": true, +"type": "string" +}, +"estimatedTotalResourcesCount": { +"description": "Output only. Estimated total count of resources.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"failedLocations": { +"description": "Output only. Locations that failed during orchestration, and ProgressiveRollout\nstopped retrying. There may be some successful resources rolled out in\nthe wave as the location may have failed later in the Rollout.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"failedResourcesCount": { +"description": "Output only. Resources failed.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"locationStatus": { +"additionalProperties": { +"$ref": "RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus" +}, +"description": "Output only. Status of each location in the wave. Map keys (locations) must be\nspecified like \"us-east1\" or \"asia-west1-a\".", +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus": { +"description": "Represents the status of a location in a wave.", +"id": "RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus", +"properties": { +"state": { +"description": "Output only. Location state of the wave.", +"enum": [ +"STATE_FAILED", +"STATE_IN_PROGRESS", +"STATE_PENDING", +"STATE_SKIPPED", +"STATE_SUCCEEDED", +"STATE_UNSPECIFIED" +], +"enumDescriptions": [ +"Work on the wave failed.", +"Work on the wave is in progress.", +"Work on the wave is pending.", +"Work on the wave was canceled or skipped.", +"Work on the wave succeeded.", +"Undefined default state. Should never be exposed to users." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"RolloutsListResponse": { +"id": "RolloutsListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Rollout resources.", +"items": { +"$ref": "Rollout" +}, +"type": "array" +}, +"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" +}, +"Route": { +"description": "Represents a Route resource.\n\nA route defines a path from VM instances in the VPC network to a specific\ndestination. This destination can be inside or outside the VPC network.\nFor more information, read theRoutes overview.", +"id": "Route", +"properties": { +"asPaths": { +"description": "Output only. [Output Only] AS path.", +"items": { +"$ref": "RouteAsPath" +}, +"readOnly": true, +"type": "array" +}, +"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 field when you\ncreate the resource.", +"type": "string" +}, +"destRange": { +"annotations": { +"required": [ +"compute.routes.insert" +] +}, +"description": "The destination range of outgoing packets that this route applies to. Both\nIPv4 and IPv6 are supported.\nMust specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291\nformat (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952\ncompressed format.", +"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#route", +"description": "Output only. [Output Only] Type of this resource. Always compute#routes for\nRoute resources.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.routes.insert" +] +}, +"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])?`. The first character must be a\nlowercase letter, and all following characters (except for the last\ncharacter) must be a dash, lowercase letter, or digit. The last character\nmust be a lowercase letter or digit.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"network": { +"annotations": { +"required": [ +"compute.routes.insert" +] +}, +"description": "Fully-qualified URL of the network that this route applies to.", +"type": "string" +}, +"nextHopGateway": { +"description": "The URL to a gateway that should handle matching packets.\nYou can only specify the internet gateway using a full or\npartial valid URL: projects/project/global/gateways/default-internet-gateway", +"type": "string" +}, +"nextHopHub": { +"description": "Output only. [Output Only] The full resource name of the Network Connectivity Center hub\nthat will handle matching packets.", +"readOnly": true, +"type": "string" +}, +"nextHopIlb": { +"description": "The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching\npackets or the IP address of the forwarding Rule.\nFor example, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule \n - regions/region/forwardingRules/forwardingRule\n\n\nIf an IP address is provided, must specify an IPv4 address in dot-decimal\nnotation or an IPv6 address in RFC 4291 format. For example, the following\nare all valid IP addresses:\n \n \n - 10.128.0.56\n - 2001:db8::2d9:51:0:0\n - 2001:db8:0:0:2d9:51:0:0\n\n\nIPv6 addresses will be displayed using RFC 5952 compressed format (e.g.\n2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", +"type": "string" +}, +"nextHopInstance": { +"description": "The URL to an instance that should handle matching packets. You can specify\nthis as a full or partial URL.\nFor example: \nhttps://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/", +"type": "string" +}, +"nextHopInterRegionCost": { +"description": "Output only. [Output only] Internal fixed region-to-region cost that Google Cloud\ncalculates based on factors such as network performance, distance, and\navailable bandwidth between regions.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"nextHopInterconnectAttachment": { +"description": "Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop\nfor the route.\nThis field will only be populated for dynamic routes generated by\nCloud Router with a linked interconnectAttachment or the static route\ngenerated by each L2 Interconnect Attachment.", +"readOnly": true, +"type": "string" +}, +"nextHopIp": { +"description": "The network IP address of an instance that should handle matching packets.\nBoth IPv6 address and IPv4 addresses are supported.\nMust specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or\nan IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or\n2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952\ncompressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an\nIPv4-mapped IPv6 address.", +"type": "string" +}, +"nextHopMed": { +"description": "Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates\nthe desirability of a particular route in a network.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"nextHopNetwork": { +"description": "The URL of the local network if it should handle matching packets.", +"type": "string" +}, +"nextHopOrigin": { +"description": "Output only. [Output Only] Indicates the origin of the route. Can be IGP\n(Interior Gateway Protocol), EGP (Exterior Gateway Protocol),\nor INCOMPLETE.", +"enum": [ +"EGP", +"IGP", +"INCOMPLETE" +], +"enumDescriptions": [ +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"nextHopPeering": { +"description": "Output only. [Output Only] The network peering name that should handle matching packets,\nwhich should conform to RFC1035.", +"readOnly": true, +"type": "string" +}, +"nextHopVpnTunnel": { +"description": "The URL to a VpnTunnel that should handle matching packets.", +"type": "string" +}, +"params": { +"$ref": "RouteParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"priority": { +"annotations": { +"required": [ +"compute.routes.insert" +] +}, +"description": "The priority of this route. Priority is used to break ties in cases\nwhere there is more than one matching route of equal prefix length. In\ncases where multiple routes have equal prefix length, the one with the\nlowest-numbered priority value wins. The default value is `1000`. The\npriority value must be from `0` to `65535`, inclusive.", +"format": "uint32", +"type": "integer" +}, +"routeStatus": { +"description": "[Output only] The status of the route. This status applies to\ndynamic routes learned by Cloud Routers. It is also applicable to routes\nundergoing migration.", +"enum": [ +"ACTIVE", +"DROPPED", +"INACTIVE", +"PENDING" +], +"enumDescriptions": [ +"This route is processed and active.", +"The route is dropped due to the VPC exceeding the dynamic route limit.\n For dynamic route limit, please refer to the\nLearned route example", +"This route is processed but inactive due to failure from the backend. The\nbackend may have rejected the route", +"This route is being processed internally. The status will change once\nprocessed." +], +"type": "string" +}, +"routeType": { +"description": "Output only. [Output Only] The type of this route, which can be one of the following\nvalues:\n- 'TRANSIT' for a transit route that this router learned from\nanother Cloud Router and will readvertise to one of its BGP peers \n- 'SUBNET' for a route from a subnet of the VPC \n- 'BGP' for a route learned from a BGP peer of this router \n- 'STATIC' for a static route", +"enum": [ +"BGP", +"STATIC", +"SUBNET", +"TRANSIT" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined fully-qualified URL for this resource.", +"type": "string" +}, +"tags": { +"description": "A list of instance tags to which this route applies.", +"items": { +"type": "string" +}, +"type": "array" +}, +"warnings": { +"description": "Output only. [Output Only] If potential misconfigurations are detected for this\nroute, this field will be populated with warning messages.", +"items": { +"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" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"RouteAsPath": { +"id": "RouteAsPath", +"properties": { +"asLists": { +"description": "[Output Only] The AS numbers of the AS Path.", +"items": { +"format": "uint32", +"type": "integer" +}, +"type": "array" +}, +"pathSegmentType": { +"description": "[Output Only] The type of the AS Path, which can be one of the following\nvalues: \n- 'AS_SET': unordered set of autonomous systems that the route\nin has traversed \n- 'AS_SEQUENCE': ordered set of autonomous\nsystems that the route has traversed \n- 'AS_CONFED_SEQUENCE':\nordered set of Member Autonomous Systems in the local confederation that\nthe route has traversed \n- 'AS_CONFED_SET': unordered set of\nMember Autonomous Systems in the local confederation that the route has\ntraversed", +"enum": [ +"AS_CONFED_SEQUENCE", +"AS_CONFED_SET", +"AS_SEQUENCE", +"AS_SET" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"RouteList": { +"description": "Contains a list of Route resources.", +"id": "RouteList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Route resources.", +"items": { +"$ref": "Route" +}, +"type": "array" +}, +"kind": { +"default": "compute#routeList", +"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.", +"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" +}, +"RouteParams": { +"description": "Additional route parameters.", +"id": "RouteParams", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"RoutePolicy": { +"id": "RoutePolicy", +"properties": { +"description": { +"description": "An optional description of route policy.", +"type": "string" +}, +"fingerprint": { +"description": "A fingerprint for the Route Policy being applied to this Router, which is\nessentially a hash of the Route Policy used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes\nafter every request to modify or update Route Policy. 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 getRoutePolicy() request\nto retrieve a Route Policy.", +"format": "byte", +"type": "string" +}, +"name": { +"description": "Route Policy name, which must be a resource ID segment and unique\nwithin all the router's Route Policies. Name should conform to RFC1035.", +"type": "string" +}, +"terms": { +"description": "List of terms (the order in the list is not important, they are evaluated\nin order of priority). Order of policies is not retained and might change\nwhen getting policy later.", +"items": { +"$ref": "RoutePolicyPolicyTerm" +}, +"type": "array" +}, +"type": { +"enum": [ +"ROUTE_POLICY_TYPE_EXPORT", +"ROUTE_POLICY_TYPE_IMPORT" +], +"enumDescriptions": [ +"The Route Policy is an Export Policy.", +"The Route Policy is an Import Policy." +], +"type": "string" +} +}, +"type": "object" +}, +"RoutePolicyPolicyTerm": { +"id": "RoutePolicyPolicyTerm", +"properties": { +"actions": { +"description": "CEL expressions to evaluate to modify a route when this term matches.", +"items": { +"$ref": "Expr" +}, +"type": "array" +}, +"match": { +"$ref": "Expr", +"description": "CEL expression evaluated against a route to determine if this term\napplies. When not set, the term applies to all\nroutes." +}, +"priority": { +"description": "The evaluation priority for this term, which must be between 0\n(inclusive) and 2^31 (exclusive), and unique within the list.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"Router": { +"description": "Represents a Cloud Router resource.\n\nFor more information about Cloud Router, read theCloud\nRouter overview.", +"id": "Router", +"properties": { +"bgp": { +"$ref": "RouterBgp", +"description": "BGP information specific to this router." +}, +"bgpPeers": { +"description": "BGP information that must be configured into the routing stack to\nestablish BGP peering. This information must specify the peer ASN and\neither the interface name, IP address, or peer IP address. Please refer toRFC4273.", +"items": { +"$ref": "RouterBgpPeer" +}, +"type": "array" +}, +"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" +}, +"encryptedInterconnectRouter": { +"description": "Indicates if a router is dedicated for use with encrypted VLAN\nattachments (interconnectAttachments).", +"type": "boolean" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"interfaces": { +"description": "Router interfaces.\nTo create a BGP peer that uses a router interface,\nthe interface must have one of the following fields specified:\n \n - linkedVpnTunnel\n - linkedInterconnectAttachment\n - subnetwork\n\n\nYou can create a router interface without any of these fields specified.\nHowever, you cannot create a BGP peer that uses that interface.", +"items": { +"$ref": "RouterInterface" +}, +"type": "array" +}, +"kind": { +"default": "compute#router", +"description": "Output only. [Output Only] Type of resource. Always compute#router for\nrouters.", +"readOnly": true, +"type": "string" +}, +"md5AuthenticationKeys": { +"description": "Keys used for MD5 authentication.", +"items": { +"$ref": "RouterMd5AuthenticationKey" +}, +"type": "array" +}, +"name": { +"annotations": { +"required": [ +"compute.routers.insert" +] +}, +"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" +}, +"nats": { +"description": "A list of NAT services created in this router.", +"items": { +"$ref": "RouterNat" +}, +"type": "array" +}, +"nccGateway": { +"description": "URI of the ncc_gateway to which this router associated.", +"type": "string" +}, +"network": { +"annotations": { +"required": [ +"compute.routers.insert", +"compute.routers.update" +] +}, +"description": "URI of the network to which this router belongs.", +"type": "string" +}, +"params": { +"$ref": "RouterParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"region": { +"description": "[Output Only] URI of the region where the router 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" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +} +}, +"type": "object" +}, +"RouterAdvertisedIpRange": { +"description": "Description-tagged IP ranges for the router to advertise.", +"id": "RouterAdvertisedIpRange", +"properties": { +"description": { +"description": "User-specified description for the IP range.", +"type": "string" +}, +"range": { +"description": "The IP range to advertise. The value must be a CIDR-formatted string.", +"type": "string" +} +}, +"type": "object" +}, +"RouterAggregatedList": { +"description": "Contains a list of routers.", +"id": "RouterAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "RoutersScopedList", +"description": "Name of the scope containing this set of routers." +}, +"description": "A list of Router resources.", +"type": "object" +}, +"kind": { +"default": "compute#routerAggregatedList", +"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" +}, +"RouterBgp": { +"id": "RouterBgp", +"properties": { +"advertiseMode": { +"description": "User-specified flag to indicate which mode to use for advertisement.\nThe options are DEFAULT or CUSTOM.", +"enum": [ +"CUSTOM", +"DEFAULT" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"advertisedGroups": { +"description": "User-specified list of prefix groups to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\nis advertised to all peers of the router.\nThese groups will be advertised in addition to any specified prefixes.\nLeave this field blank to advertise no custom groups.", +"items": { +"enum": [ +"ALL_SUBNETS" +], +"enumDescriptions": [ +"Advertise all available subnets (including peer VPC subnets)." +], +"type": "string" +}, +"type": "array" +}, +"advertisedIpRanges": { +"description": "User-specified list of individual IP ranges to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\nis advertised to all peers of the router.\nThese IP ranges will be advertised in addition to any specified groups.\nLeave this field blank to advertise no custom IP ranges.", +"items": { +"$ref": "RouterAdvertisedIpRange" +}, +"type": "array" +}, +"asn": { +"description": "Local BGP Autonomous System Number (ASN).\nMust be anRFC6996 private ASN, either 16-bit or 32-bit. The\nvalue will be fixed for this router resource. All VPN tunnels that link\nto this router will have the same local ASN.", +"format": "uint32", +"type": "integer" +}, +"identifierRange": { +"description": "Explicitly specifies a range of valid BGP Identifiers for this Router. It\nis provided as a link-local IPv4 range (from 169.254.0.0/16), of size at\nleast /30, even if the BGP sessions are over IPv6. It must not overlap\nwith any IPv4 BGP session ranges.\n\n\nOther vendors commonly call this \"router ID\".", +"type": "string" +}, +"keepaliveInterval": { +"description": "The interval in seconds between BGP keepalive messages that are\nsent to the peer.\n\n\nHold time is three times the interval at which keepalive messages are\nsent, and the hold time is the maximum number of seconds allowed to\nelapse between successive keepalive messages that BGP receives from a\npeer.\n\n\nBGP will use the smaller of either the local hold time value or the\npeer's hold time value as the hold time for the BGP connection between\nthe two peers.\n\n\nIf set, this value must be between 20 and 60. The default is 20.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"RouterBgpPeer": { +"id": "RouterBgpPeer", +"properties": { +"advertiseMode": { +"description": "User-specified flag to indicate which mode to use for advertisement.", +"enum": [ +"CUSTOM", +"DEFAULT" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"advertisedGroups": { +"description": "User-specified list of prefix groups to advertise in custom mode,\nwhich currently supports the following option:\n \n - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This\n excludes any routes learned for subnets that use\n VPC Network Peering.\n\n\nNote that this field can only be populated if advertise_mode is CUSTOM\nand overrides the list defined for the router (in the \"bgp\" message).\nThese groups are advertised in addition to any specified prefixes.\nLeave this field blank to advertise no custom groups.", +"items": { +"enum": [ +"ALL_SUBNETS" +], +"enumDescriptions": [ +"Advertise all available subnets (including peer VPC subnets)." +], +"type": "string" +}, +"type": "array" +}, +"advertisedIpRanges": { +"description": "User-specified list of individual IP ranges to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\noverrides the list defined for the router (in the \"bgp\" message).\nThese IP ranges are advertised in addition to any specified groups.\nLeave this field blank to advertise no custom IP ranges.", +"items": { +"$ref": "RouterAdvertisedIpRange" +}, +"type": "array" +}, +"advertisedRoutePriority": { +"description": "The priority of routes advertised to this BGP peer. Where there is more\nthan one matching route of maximum length, the routes with the lowest\npriority value win.", +"format": "uint32", +"type": "integer" +}, +"bfd": { +"$ref": "RouterBgpPeerBfd", +"description": "BFD configuration for the BGP peering." +}, +"customLearnedIpRanges": { +"description": "A list of user-defined custom learned route IP address ranges for a BGP\nsession.", +"items": { +"$ref": "RouterBgpPeerCustomLearnedIpRange" +}, +"type": "array" +}, +"customLearnedRoutePriority": { +"description": "The user-defined custom learned route priority for a BGP session. This\nvalue is applied to all custom learned route ranges for the session.\nYou can choose a value from `0` to `65335`. If you don't provide a\nvalue, Google Cloud assigns a priority of `100` to the ranges.", +"format": "int32", +"type": "integer" +}, +"enable": { +"description": "The status of the BGP peer connection.\n\n\nIf set to FALSE, any active session with the peer is terminated and\nall associated routing information is removed. If set to TRUE, the\npeer connection can be established with routing information. The default\nis TRUE.", +"enum": [ +"FALSE", +"TRUE" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"enableIpv4": { +"description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if\nthe peerIpAddress is version 4.", +"type": "boolean" +}, +"enableIpv6": { +"description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the\npeerIpAddress is version 6.", +"type": "boolean" +}, +"exportPolicies": { +"description": "List of export policies applied to this peer, in the order they must be\nevaluated. The name must correspond to an existing policy that has\nROUTE_POLICY_TYPE_EXPORT type.", +"items": { +"type": "string" +}, +"type": "array" +}, +"importPolicies": { +"description": "List of import policies applied to this peer, in the order they must be\nevaluated. The name must correspond to an existing policy that has\nROUTE_POLICY_TYPE_IMPORT type.", +"items": { +"type": "string" +}, +"type": "array" +}, +"interfaceName": { +"description": "Name of the interface the BGP peer is associated with.", +"type": "string" +}, +"ipAddress": { +"description": "IP address of the interface inside Google Cloud Platform.", +"type": "string" +}, +"ipv4NexthopAddress": { +"description": "IPv4 address of the interface inside Google Cloud Platform.", +"type": "string" +}, +"ipv6NexthopAddress": { +"description": "IPv6 address of the interface inside Google Cloud Platform.", +"type": "string" +}, +"managementType": { +"description": "Output only. [Output Only] The resource that configures and manages this BGP peer.\n \n - MANAGED_BY_USER is the default value and can be managed by you\n or other users\n - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed\n by Cloud Interconnect, specifically by an InterconnectAttachment of type\n PARTNER. Google automatically creates, updates, and deletes this type of\n BGP peer when the PARTNER InterconnectAttachment is created, updated,\n or deleted.", +"enum": [ +"MANAGED_BY_ATTACHMENT", +"MANAGED_BY_USER" +], +"enumDescriptions": [ +"The BGP peer is automatically created for PARTNER type\nInterconnectAttachment; Google will automatically create/delete\nthis BGP peer when the PARTNER InterconnectAttachment is\ncreated/deleted, and Google will update the ipAddress and\npeerIpAddress when the PARTNER InterconnectAttachment is provisioned.\nThis type of BGP peer cannot be created or deleted, but can be\nmodified for all fields except for name, ipAddress and peerIpAddress.", +"Default value, the BGP peer is manually created and managed by user." +], +"readOnly": true, +"type": "string" +}, +"md5AuthenticationKeyName": { +"description": "Present if MD5 authentication is enabled for the peering. Must be the\nname of one of the entries in the Router.md5_authentication_keys. The\nfield must comply with RFC1035.", +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.routers.insert" +] +}, +"description": "Name of this BGP peer.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"peerAsn": { +"annotations": { +"required": [ +"compute.routers.insert" +] +}, +"description": "Peer BGP Autonomous System Number (ASN). Each BGP interface may use\na different value.", +"format": "uint32", +"type": "integer" +}, +"peerIpAddress": { +"description": "IP address of the BGP interface outside Google Cloud Platform.", +"type": "string" +}, +"peerIpv4NexthopAddress": { +"description": "IPv4 address of the BGP interface outside Google Cloud Platform.", +"type": "string" +}, +"peerIpv6NexthopAddress": { +"description": "IPv6 address of the BGP interface outside Google Cloud Platform.", +"type": "string" +}, +"routerApplianceInstance": { +"description": "URI of the VM instance that is used as third-party router\nappliances such as Next Gen Firewalls, Virtual Routers, or Router\nAppliances. The VM instance must be located in zones contained in the\nsame region as this Cloud Router.\nThe VM instance is the peer side of the BGP session.", +"type": "string" +} +}, +"type": "object" +}, +"RouterBgpPeerBfd": { +"id": "RouterBgpPeerBfd", +"properties": { +"minReceiveInterval": { +"description": "The minimum interval, in milliseconds, between BFD control packets\nreceived from the peer router. The actual value is negotiated between\nthe two routers and is equal to the greater of this value and the\ntransmit interval of the other router.\n\n\nIf set, this value must be between 1000 and 30000.\n\n\nThe default is 1000.", +"format": "uint32", +"type": "integer" +}, +"minTransmitInterval": { +"description": "The minimum interval, in milliseconds, between BFD control packets\ntransmitted to the peer router. The actual value is negotiated between\nthe two routers and is equal to the greater of this value and the\ncorresponding receive interval of the other router.\n\n\nIf set, this value must be between 1000 and 30000.\n\n\nThe default is 1000.", +"format": "uint32", +"type": "integer" +}, +"multiplier": { +"description": "The number of consecutive BFD packets that must be missed\nbefore BFD declares that a peer is unavailable.\n\n\nIf set, the value must be a value between 5 and 16.\n\n\nThe default is 5.", +"format": "uint32", +"type": "integer" +}, +"sessionInitializationMode": { +"description": "The BFD session initialization mode for this BGP peer.\n\n\nIf set to ACTIVE, the Cloud Router will initiate the BFD session for\nthis BGP peer. If set to PASSIVE, the Cloud Router will wait for the\npeer router to initiate the BFD session for this BGP peer. If set to\nDISABLED, BFD is disabled for this BGP peer. The default is DISABLED.", +"enum": [ +"ACTIVE", +"DISABLED", +"PASSIVE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"RouterBgpPeerCustomLearnedIpRange": { +"id": "RouterBgpPeerCustomLearnedIpRange", +"properties": { +"range": { +"description": "The custom learned route IP address range. Must be a valid\nCIDR-formatted prefix. If an IP address is provided without a subnet\nmask, it is interpreted as, for IPv4, a `/32` singular IP address\nrange, and, for IPv6, `/128`.", +"type": "string" +} +}, +"type": "object" +}, +"RouterInterface": { +"id": "RouterInterface", +"properties": { +"ipRange": { +"description": "IP address and range of the interface.\n \n - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must\n be a CIDR-formatted string, for example, 169.254.0.1/30.\n Note: Do not truncate the IP address, as it represents the IP address of\n the interface. \n - For Internet Protocol version 6 (IPv6), the value\n must be a unique local address (ULA) range from fdff:1::/64\n with a mask length of 126 or less. This value should be a CIDR-formatted\n string, for example, fdff:1::1/112. Within the router's\n VPC, this IPv6 prefix will be reserved exclusively for this connection\n and cannot be used for any other purpose.", +"type": "string" +}, +"ipVersion": { +"description": "IP version of this interface.", +"enum": [ +"IPV4", +"IPV6" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"linkedInterconnectAttachment": { +"description": "URI of the linked Interconnect attachment. It must be in the same region\nas the router. Each interface can have one linked resource, which can be\na VPN tunnel, an Interconnect attachment, or a subnetwork.", +"type": "string" +}, +"linkedVpnTunnel": { +"description": "URI of the linked VPN tunnel, which must be in the same region as the\nrouter. Each interface can have one linked resource, which can be\na VPN tunnel, an Interconnect attachment, or a subnetwork.", +"type": "string" +}, +"managementType": { +"description": "Output only. [Output Only] The resource that configures and manages this interface.\n \n - MANAGED_BY_USER is the default value and can be managed directly\n by users.\n - MANAGED_BY_ATTACHMENT is an interface that is configured and\n managed by Cloud Interconnect, specifically, by an InterconnectAttachment\n of type PARTNER. Google automatically creates, updates, and deletes\n this type of interface when the PARTNER InterconnectAttachment is\n created, updated, or deleted.", +"enum": [ +"MANAGED_BY_ATTACHMENT", +"MANAGED_BY_USER" +], +"enumDescriptions": [ +"The interface is automatically created for PARTNER type\nInterconnectAttachment, Google will automatically create/update/delete\nthis interface when the PARTNER InterconnectAttachment is\ncreated/provisioned/deleted.\nThis type of interface cannot be manually managed by user.", +"Default value, the interface is manually created and managed by user." +], +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.routers.insert" +] +}, +"description": "Name of this interface entry.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"privateIpAddress": { +"description": "The regional private internal IP address that is used to establish\nBGP sessions to a VM instance acting as a third-party\nRouter Appliance, such as a Next Gen Firewall, a Virtual Router, or\nan SD-WAN VM.", +"type": "string" +}, +"redundantInterface": { +"description": "Name of the interface that will be redundant with the current interface\nyou are creating. The redundantInterface must belong to the same Cloud\nRouter as the interface here. To establish the BGP session to a Router\nAppliance VM, you must create two BGP peers. The two BGP peers must be\nattached to two separate interfaces that are redundant with each other.\nThe redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must\nbe 1-63 characters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"subnetwork": { +"description": "The URI of the subnetwork resource that this interface belongs to, which\nmust be in the same region as the Cloud Router.\nWhen you establish a BGP session to a VM instance using this interface,\nthe VM instance must belong to the same subnetwork as the subnetwork\nspecified here.", +"type": "string" +} +}, +"type": "object" +}, +"RouterList": { +"description": "Contains a list of Router resources.", +"id": "RouterList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Router resources.", +"items": { +"$ref": "Router" +}, +"type": "array" +}, +"kind": { +"default": "compute#routerList", +"description": "Output only. [Output Only] Type of resource. Always compute#router for\nrouters.", +"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.", +"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" +}, +"RouterMd5AuthenticationKey": { +"id": "RouterMd5AuthenticationKey", +"properties": { +"key": { +"annotations": { +"required": [ +"compute.routers.insert" +] +}, +"description": "[Input only] Value of the key.\n\nFor patch and update calls, it can be skipped to\ncopy the value from the previous configuration. This is allowed if the\nkey with the same name existed before the operation. Maximum length is 80\ncharacters. Can only contain printable ASCII characters.", +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.routers.insert", +"compute.routers.update" +] +}, +"description": "Name used to identify the key.\n\nMust be unique within a router. Must be referenced by exactly\none bgpPeer. Must comply withRFC1035.", +"type": "string" +} +}, +"type": "object" +}, +"RouterNat": { +"description": "Represents a Nat resource. It enables the VMs within the specified\nsubnetworks to access Internet without external IP addresses. It specifies\na list of subnetworks (and the ranges within) that want to use NAT.\nCustomers can also provide the external IPs that would be used for NAT. GCP\nwould auto-allocate ephemeral IPs if no external IPs are provided.", +"id": "RouterNat", +"properties": { +"autoNetworkTier": { +"description": "The network tier to use when automatically reserving NAT IP addresses.\nMust be one of: PREMIUM, STANDARD.\nIf not specified, then the current \nproject-level default tier is used.", +"enum": [ +"FIXED_STANDARD", +"PREMIUM", +"STANDARD", +"STANDARD_OVERRIDES_FIXED_STANDARD" +], +"enumDescriptions": [ +"Public internet quality with fixed bandwidth.", +"High quality, Google-grade network tier, support for all networking\nproducts.", +"Public internet quality, only limited support for other networking\nproducts.", +"(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." +], +"type": "string" +}, +"drainNatIps": { +"description": "A list of URLs of the IP resources to be drained. These IPs\nmust be valid static external IPs that have been assigned to the NAT.\nThese IPs should be used for updating/patching a NAT only.", +"items": { +"type": "string" +}, +"type": "array" +}, +"effectiveTcpTimeWaitTimeoutSec": { +"description": "Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT\nstate. This value is equal to tcp_time_wait_timeout_sec.\nIf tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or\n120s. The field is output only.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"enableDynamicPortAllocation": { +"description": "Enable Dynamic Port Allocation.\n\n\nIf not specified, it is disabled by default.\n\n\nIf set to true,\n \n - Dynamic Port Allocation will be enabled on this NAT\n config.\n - enableEndpointIndependentMapping cannot be set to true.\n - If minPorts is set, minPortsPerVm must be set to a\n power of two greater than or equal to 32. If minPortsPerVm is not set, a\n minimum of 32 ports will be allocated to a VM from this NAT\n config.", +"type": "boolean" +}, +"enableEndpointIndependentMapping": { +"type": "boolean" +}, +"endpointTypes": { +"description": "List of NAT-ted endpoint types supported by the Nat Gateway. If the list\nis empty, then it will be equivalent to include ENDPOINT_TYPE_VM", +"items": { +"enum": [ +"ENDPOINT_TYPE_MANAGED_PROXY_LB", +"ENDPOINT_TYPE_SWG", +"ENDPOINT_TYPE_VM" +], +"enumDescriptions": [ +"This is used for regional Application Load Balancers (internal and\nexternal) and regional proxy Network Load Balancers (internal and\nexternal) endpoints.", +"This is used for Secure Web Gateway endpoints.", +"This is the default." +], +"type": "string" +}, +"type": "array" +}, +"icmpIdleTimeoutSec": { +"description": "Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.", +"format": "int32", +"type": "integer" +}, +"logConfig": { +"$ref": "RouterNatLogConfig", +"description": "Configure logging on this NAT." +}, +"maxPortsPerVm": { +"description": "Maximum number of ports allocated to a VM from this NAT config when\nDynamic Port Allocation is enabled.\n\n\nIf Dynamic Port Allocation is not enabled, this field has no effect.\n\n\nIf Dynamic Port Allocation is enabled, and this field is set, it must be\nset to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm\nis not set.\n\n\nIf Dynamic Port Allocation is enabled and this field is not set,\na maximum of 65536 ports will be allocated to a VM from this NAT\nconfig.", +"format": "int32", +"type": "integer" +}, +"minPortsPerVm": { +"description": "Minimum number of ports allocated to a VM from this NAT config. If not\nset, a default number of ports is allocated to a VM. This is rounded\nup to the nearest power of 2. For example, if the value of this field is\n50, at least 64 ports are allocated to a VM.", +"format": "int32", +"type": "integer" +}, +"name": { +"description": "Unique name of this Nat service.\nThe name must be 1-63 characters long and comply withRFC1035.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"nat64Subnetworks": { +"description": "List of Subnetwork resources whose traffic should be translated by NAT64\nGateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is\nselected for the SubnetworkIpRangeToNat64Option above.", +"items": { +"$ref": "RouterNatSubnetworkToNat64" +}, +"type": "array" +}, +"natIpAllocateOption": { +"description": "Specify the NatIpAllocateOption, which can take one of the following\nvalues: \n \n - MANUAL_ONLY: Uses only Nat IP addresses provided by\n customers. When there are not enough specified Nat IPs, the Nat service\n fails for new VMs.\n - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers\n can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should\n be empty.", +"enum": [ +"AUTO_ONLY", +"MANUAL_ONLY" +], +"enumDescriptions": [ +"Nat IPs are allocated by GCP; customers can not specify any Nat IPs.", +"Only use Nat IPs provided by customers. When specified Nat IPs are not\nenough then the Nat service fails for new VMs." +], +"type": "string" +}, +"natIps": { +"description": "A list of URLs of the IP resources used for this Nat service. These IP\naddresses must be valid static external IP addresses assigned to the\nproject.", +"items": { +"type": "string" +}, +"type": "array" +}, +"rules": { +"description": "A list of rules associated with this NAT.", +"items": { +"$ref": "RouterNatRule" +}, +"type": "array" +}, +"sourceSubnetworkIpRangesToNat": { +"description": "Specify the Nat option, which can take one of the following values:\n \n - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every\n Subnetwork are allowed to Nat.\n - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges\n in every Subnetwork are allowed to Nat.\n - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat\n (specified in the field subnetwork below)\n\n\nThe default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.\nNote that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there\nshould not be any other Router.Nat section in any Router for this network\nin this region.", +"enum": [ +"ALL_SUBNETWORKS_ALL_IP_RANGES", +"ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES", +"LIST_OF_SUBNETWORKS" +], +"enumDescriptions": [ +"All the IP ranges in every Subnetwork are allowed to Nat.", +"All the primary IP ranges in every Subnetwork are allowed to Nat.", +"A list of Subnetworks are allowed to Nat (specified in the field\nsubnetwork below)" +], +"type": "string" +}, +"sourceSubnetworkIpRangesToNat64": { +"description": "Specify the Nat option for NAT64, which can take one of the following\nvalues: \n \n - ALL_IPV6_SUBNETWORKS: All of the IP ranges in\n every Subnetwork are allowed to Nat.\n - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat\n (specified in the field nat64_subnetwork below)\n\n\nThe default is NAT64_OPTION_UNSPECIFIED.\nNote that if this field contains NAT64_ALL_V6_SUBNETWORKS no other\nRouter.Nat section in this region can also enable NAT64 for any\nSubnetworks in this network. Other Router.Nat sections can still be\npresent to enable NAT44 only.", +"enum": [ +"ALL_IPV6_SUBNETWORKS", +"LIST_OF_IPV6_SUBNETWORKS" +], +"enumDescriptions": [ +"NAT64 is enabled for all the IPv6 subnet ranges.\nIn dual stack subnets, NAT64 will only be enabled for IPv6-only VMs.", +"NAT64 is enabled for a list of IPv6 subnet ranges.\nIn dual stack subnets, NAT64 will only be enabled for IPv6-only VMs.\nIf this option is used, the nat64_subnetworks field must be specified." +], +"type": "string" +}, +"subnetworks": { +"description": "A list of Subnetwork resources whose traffic should be translated by NAT\nGateway. It is used only when LIST_OF_SUBNETWORKS is selected for the\nSubnetworkIpRangeToNatOption above.", +"items": { +"$ref": "RouterNatSubnetworkToNat" +}, +"type": "array" +}, +"tcpEstablishedIdleTimeoutSec": { +"description": "Timeout (in seconds) for TCP established connections. Defaults to 1200s\nif not set.", +"format": "int32", +"type": "integer" +}, +"tcpTimeWaitTimeoutSec": { +"description": "Timeout (in seconds) for TCP connections that are in TIME_WAIT state.\nDefaults to 120s if not set.", +"format": "int32", +"type": "integer" +}, +"tcpTransitoryIdleTimeoutSec": { +"description": "Timeout (in seconds) for TCP transitory connections. Defaults to 30s if\nnot set.", +"format": "int32", +"type": "integer" +}, +"type": { +"description": "Indicates whether this NAT is used for public or private IP\ntranslation. If unspecified, it defaults to PUBLIC.", +"enum": [ +"PRIVATE", +"PUBLIC" +], +"enumDescriptions": [ +"NAT used for private IP translation.", +"NAT used for public IP translation.\nThis is the default." +], +"type": "string" +}, +"udpIdleTimeoutSec": { +"description": "Timeout (in seconds) for UDP connections. Defaults to 30s if not set.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"RouterNatLogConfig": { +"description": "Configuration of logging on a NAT.", +"id": "RouterNatLogConfig", +"properties": { +"enable": { +"description": "Indicates whether or not to export logs. This is false by default.", +"type": "boolean" +}, +"filter": { +"description": "Specify the desired filtering of logs on this NAT. If unspecified,\nlogs are exported for all connections handled by this NAT.\nThis option can take one of the following values:\n \n - ERRORS_ONLY: Export logs only for connection failures.\n - TRANSLATIONS_ONLY: Export logs only for successful\n connections.\n - ALL: Export logs for all connections, successful and\n unsuccessful.", +"enum": [ +"ALL", +"ERRORS_ONLY", +"TRANSLATIONS_ONLY" +], +"enumDescriptions": [ +"Export logs for all (successful and unsuccessful) connections.", +"Export logs for connection failures only.", +"Export logs for successful connections only." +], +"type": "string" +} +}, +"type": "object" +}, +"RouterNatRule": { +"id": "RouterNatRule", +"properties": { +"action": { +"$ref": "RouterNatRuleAction", +"description": "The action to be enforced for traffic that matches this rule." +}, +"description": { +"description": "An optional description of this rule.", +"type": "string" +}, +"match": { +"description": "CEL expression that specifies the match condition that egress traffic\nfrom a VM is evaluated against. If it evaluates to true, the\ncorresponding `action` is enforced.\n\nThe following examples are valid match expressions for public NAT:\n\n`inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,\n '2.2.0.0/16')`\n\n`destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`\n\nThe following example is a valid match expression for private NAT:\n\n`nexthop.hub ==\n'//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", +"type": "string" +}, +"ruleNumber": { +"description": "An integer uniquely identifying a rule in the list. The rule number\nmust be a positive value between 0 and 65000, and\nmust be unique among rules within a NAT.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"RouterNatRuleAction": { +"id": "RouterNatRuleAction", +"properties": { +"sourceNatActiveIps": { +"description": "A list of URLs of the IP resources used for this NAT rule. These IP\naddresses must be valid static external IP addresses assigned to the\nproject.\nThis field is used for public NAT.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceNatActiveRanges": { +"description": "A list of URLs of the subnetworks used as source ranges for this\nNAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.\nThis field is used for private NAT.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceNatDrainIps": { +"description": "A list of URLs of the IP resources to be drained. These IPs\nmust be valid static external IPs that have been assigned to the NAT.\nThese IPs should be used for updating/patching a NAT rule only.\nThis field is used for public NAT.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceNatDrainRanges": { +"description": "A list of URLs of subnetworks representing source ranges to be\ndrained. This is only supported on patch/update, and these\nsubnetworks must have previously been used as active ranges in this\nNAT Rule.\nThis field is used for private NAT.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RouterNatSubnetworkToNat": { +"description": "Defines the IP ranges that want to use NAT for a subnetwork.", +"id": "RouterNatSubnetworkToNat", +"properties": { +"name": { +"description": "URL for the subnetwork resource that will use NAT.", +"type": "string" +}, +"secondaryIpRangeNames": { +"description": "A list of the secondary ranges of the Subnetwork that are allowed to\nuse NAT. This can be populated only if \"LIST_OF_SECONDARY_IP_RANGES\"\nis one of the values in source_ip_ranges_to_nat.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceIpRangesToNat": { +"description": "Specify the options for NAT ranges in the Subnetwork. All\noptions of a single value are valid except\nNAT_IP_RANGE_OPTION_UNSPECIFIED.\nThe only valid option with multiple values is: [\"PRIMARY_IP_RANGE\",\n\"LIST_OF_SECONDARY_IP_RANGES\"]\nDefault: [ALL_IP_RANGES]", +"items": { +"enum": [ +"ALL_IP_RANGES", +"LIST_OF_SECONDARY_IP_RANGES", +"PRIMARY_IP_RANGE" +], +"enumDescriptions": [ +"The primary and all the secondary ranges are allowed to Nat.", +"A list of secondary ranges are allowed to Nat.", +"The primary range is allowed to Nat." +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"RouterNatSubnetworkToNat64": { +"description": "Specifies a subnetwork to enable NAT64.", +"id": "RouterNatSubnetworkToNat64", +"properties": { +"name": { +"description": "URL for the subnetwork resource that will use NAT64.", +"type": "string" +} +}, +"type": "object" +}, +"RouterParams": { +"description": "Additional router parameters.", +"id": "RouterParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource.\nThe 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" +}, +"RouterStatus": { +"id": "RouterStatus", +"properties": { +"bestRoutes": { +"description": "A list of the best dynamic routes for this Cloud Router's Virtual Private\nCloud (VPC) network in the same region as this Cloud Router.\n\nLists all of the best routes per prefix that are programmed into this\nregion's VPC data plane.\n\nWhen global dynamic routing mode is turned on in the VPC network, this list\ncan include cross-region dynamic routes from Cloud Routers in other\nregions.", +"items": { +"$ref": "Route" +}, +"type": "array" +}, +"bestRoutesForRouter": { +"description": "A list of the best BGP routes learned by this Cloud Router.\n\nIt is possible that routes listed might not be programmed into the data\nplane, if the Google Cloud control plane finds a more optimal route for a\nprefix than a route learned by this Cloud Router.", +"items": { +"$ref": "Route" +}, +"type": "array" +}, +"bgpPeerStatus": { +"items": { +"$ref": "RouterStatusBgpPeerStatus" +}, +"type": "array" +}, +"natStatus": { +"items": { +"$ref": "RouterStatusNatStatus" +}, +"type": "array" +}, +"nccGateway": { +"description": "URI of the ncc_gateway to which this router associated.", +"type": "string" +}, +"network": { +"description": "URI of the network to which this router belongs.", +"type": "string" +} +}, +"type": "object" +}, +"RouterStatusBgpPeerStatus": { +"id": "RouterStatusBgpPeerStatus", +"properties": { +"advertisedRoutes": { +"description": "Routes that were advertised to the remote BGP peer", +"items": { +"$ref": "Route" +}, +"type": "array" +}, +"bfdStatus": { +"$ref": "BfdStatus" +}, +"enableIpv4": { +"description": "Output only. Enable IPv4 traffic over BGP Peer.\nIt is enabled by default if the peerIpAddress is version 4.", +"readOnly": true, +"type": "boolean" +}, +"enableIpv6": { +"description": "Output only. Enable IPv6 traffic over BGP Peer.\nIt is enabled by default if the peerIpAddress is version 6.", +"readOnly": true, +"type": "boolean" +}, +"ipAddress": { +"description": "Output only. IP address of the local BGP interface.", +"readOnly": true, +"type": "string" +}, +"ipv4NexthopAddress": { +"description": "Output only. IPv4 address of the local BGP interface.", +"readOnly": true, +"type": "string" +}, +"ipv6NexthopAddress": { +"description": "Output only. IPv6 address of the local BGP interface.", +"readOnly": true, +"type": "string" +}, +"linkedVpnTunnel": { +"description": "Output only. URL of the VPN tunnel that this BGP peer controls.", +"readOnly": true, +"type": "string" +}, +"md5AuthEnabled": { +"description": "Informs whether MD5 authentication is enabled on this BGP peer.", +"type": "boolean" +}, +"name": { +"description": "Output only. Name of this BGP peer. Unique within the Routers resource.", +"readOnly": true, +"type": "string" +}, +"numLearnedRoutes": { +"description": "Output only. Number of routes learned from the remote BGP Peer.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"peerIpAddress": { +"description": "Output only. IP address of the remote BGP interface.", +"readOnly": true, +"type": "string" +}, +"peerIpv4NexthopAddress": { +"description": "Output only. IPv4 address of the remote BGP interface.", +"readOnly": true, +"type": "string" +}, +"peerIpv6NexthopAddress": { +"description": "Output only. IPv6 address of the remote BGP interface.", +"readOnly": true, +"type": "string" +}, +"routerApplianceInstance": { +"description": "Output only. [Output only] URI of the VM instance that is used as third-party router\nappliances such as Next Gen Firewalls, Virtual Routers, or Router\nAppliances.\nThe VM instance is the peer side of the BGP session.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The state of the BGP session. For a list of possible values for this\nfield, seeBGP session states.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. Status of the BGP peer: {UP, DOWN}", +"enum": [ +"DOWN", +"UNKNOWN", +"UP" +], +"enumDescriptions": [ +"", +"", +"" +], +"readOnly": true, +"type": "string" +}, +"statusReason": { +"description": "Indicates why particular status was returned.", +"enum": [ +"IPV4_PEER_ON_IPV6_ONLY_CONNECTION", +"IPV6_PEER_ON_IPV4_ONLY_CONNECTION", +"MD5_AUTH_INTERNAL_PROBLEM", +"STATUS_REASON_UNSPECIFIED" +], +"enumDescriptions": [ +"BGP peer disabled because it requires IPv4 but the underlying\nconnection is IPv6-only.", +"BGP peer disabled because it requires IPv6 but the underlying\nconnection is IPv4-only.", +"Indicates internal problems with configuration of MD5 authentication.\nThis particular reason can only be returned when md5AuthEnabled is true\nand status is DOWN.", +"" +], +"type": "string" +}, +"uptime": { +"description": "Output only. Time this session has been up.\nFormat:\n 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds", +"readOnly": true, +"type": "string" +}, +"uptimeSeconds": { +"description": "Output only. Time this session has been up, in seconds.\nFormat:\n 145", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"RouterStatusNatStatus": { +"description": "Status of a NAT contained in this router.", +"id": "RouterStatusNatStatus", +"properties": { +"autoAllocatedNatIps": { +"description": "Output only. A list of IPs auto-allocated for NAT. Example: [\"1.1.1.1\", \"129.2.16.89\"]", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"drainAutoAllocatedNatIps": { +"description": "Output only. A list of IPs auto-allocated for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"drainUserAllocatedNatIps": { +"description": "Output only. A list of IPs user-allocated for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"minExtraNatIpsNeeded": { +"description": "Output only. The number of extra IPs to allocate. This will be greater than 0 only if\nuser-specified IPs are NOT enough to allow all configured VMs to use NAT.\nThis value is meaningful only when auto-allocation of NAT IPs is *not*\nused.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"name": { +"description": "Output only. Unique name of this NAT.", +"readOnly": true, +"type": "string" +}, +"numVmEndpointsWithNatMappings": { +"description": "Output only. Number of VM endpoints (i.e., Nics) that can use NAT.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"ruleStatus": { +"description": "Status of rules in this NAT.", +"items": { +"$ref": "RouterStatusNatStatusNatRuleStatus" +}, +"type": "array" +}, +"userAllocatedNatIpResources": { +"description": "Output only. A list of fully qualified URLs of reserved IP address resources.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"userAllocatedNatIps": { +"description": "Output only. A list of IPs user-allocated for NAT.\nThey will be raw IP strings like \"179.12.26.133\".", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"RouterStatusNatStatusNatRuleStatus": { +"description": "Status of a NAT Rule contained in this NAT.", +"id": "RouterStatusNatStatusNatRuleStatus", +"properties": { +"activeNatIps": { +"description": "Output only. A list of active IPs for NAT.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"drainNatIps": { +"description": "Output only. A list of IPs for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"minExtraIpsNeeded": { +"description": "Output only. The number of extra IPs to allocate. This will be greater than 0 only\nif the existing IPs in this NAT Rule are NOT enough to allow all\nconfigured VMs to use NAT.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"numVmEndpointsWithNatMappings": { +"description": "Output only. Number of VM endpoints (i.e., NICs) that have NAT Mappings from this\nNAT Rule.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"ruleNumber": { +"description": "Output only. Rule number of the rule.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"RouterStatusResponse": { +"id": "RouterStatusResponse", +"properties": { +"kind": { +"default": "compute#routerStatusResponse", +"description": "Output only. Type of resource.", +"readOnly": true, +"type": "string" +}, +"result": { +"$ref": "RouterStatus" +} +}, +"type": "object" +}, +"RoutersGetNamedSetResponse": { +"id": "RoutersGetNamedSetResponse", +"properties": { +"etag": { +"description": "end_interface: MixerGetResponseWithEtagBuilder", +"type": "string" +}, +"resource": { +"$ref": "NamedSet" +} +}, +"type": "object" +}, +"RoutersGetRoutePolicyResponse": { +"id": "RoutersGetRoutePolicyResponse", +"properties": { +"resource": { +"$ref": "RoutePolicy" +} +}, +"type": "object" +}, +"RoutersListBgpRoutes": { +"id": "RoutersListBgpRoutes", +"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#routersListBgpRoutes", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes.", +"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 bgp routes.", +"items": { +"$ref": "BgpRoute" +}, +"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" +}, +"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": { +"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#routersListRoutePolicies", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies.", +"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 route policies.", +"items": { +"$ref": "RoutePolicy" +}, +"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" +}, +"RoutersPreviewResponse": { +"id": "RoutersPreviewResponse", +"properties": { +"resource": { +"$ref": "Router", +"description": "Preview of given router." +} +}, +"type": "object" +}, +"RoutersScopedList": { +"id": "RoutersScopedList", +"properties": { +"routers": { +"description": "A list of routers contained in this scope.", +"items": { +"$ref": "Router" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of routers when\nthe 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.", +"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" +}, +"SSLHealthCheck": { +"id": "SSLHealthCheck", +"properties": { +"port": { +"description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"request": { +"description": "Instructs the health check prober to send this exact ASCII string, up to\n1024 bytes in length, after establishing the TCP connection and SSL\nhandshake.", +"type": "string" +}, +"response": { +"description": "Creates a content-based SSL health check. In addition to establishing a\nTCP connection and the TLS handshake, you can configure the health check to\npass only when the backend sends this exact response ASCII string, up to\n1024 bytes in length. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", +"type": "string" +} +}, +"type": "object" +}, +"SavedAttachedDisk": { +"description": "DEPRECATED: Please use compute#savedDisk instead.\nAn instance-attached disk resource.", +"id": "SavedAttachedDisk", +"properties": { +"autoDelete": { +"description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (but not when the disk is detached from the instance).", +"type": "boolean" +}, +"boot": { +"description": "Indicates that this is a boot disk. The virtual machine will use the first\npartition of the disk for its root filesystem.", +"type": "boolean" +}, +"deviceName": { +"description": "Specifies the name of the disk attached to the source instance.", +"type": "string" +}, +"diskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "The encryption key for the disk." +}, +"diskSizeGb": { +"description": "The size of the disk in base-2 GB.", +"format": "int64", +"type": "string" +}, +"diskType": { +"description": "Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or\npd-ssd", +"readOnly": true, +"type": "string" +}, +"guestOsFeatures": { +"description": "A list of features to enable on the guest operating system. Applicable only\nfor bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", +"items": { +"$ref": "GuestOsFeature" +}, +"type": "array" +}, +"index": { +"description": "Output only. Specifies zero-based index of the disk that is attached to the source\ninstance.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"interface": { +"description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME.", +"enum": [ +"NVME", +"SCSI" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"kind": { +"default": "compute#savedAttachedDisk", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.", +"readOnly": true, +"type": "string" +}, +"licenses": { +"description": "Output only. [Output Only] Any valid publicly visible licenses.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"mode": { +"description": "The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.", +"enum": [ +"READ_ONLY", +"READ_WRITE" +], +"enumDescriptions": [ +"Attaches this disk in read-only mode. Multiple virtual machines can use\na disk in read-only mode at a time.", +"*[Default]* Attaches this disk in read-write mode. Only one\nvirtual machine at a time can be attached to a disk in read-write mode." +], +"type": "string" +}, +"source": { +"description": "Specifies a URL of the disk attached to the source instance.", +"type": "string" +}, +"storageBytes": { +"description": "Output only. [Output Only] A size of the storage used by the disk's snapshot by this\nmachine image.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"storageBytesStatus": { +"description": "Output only. [Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be UPDATING, meaning\nthe size of the snapshot is being updated, or UP_TO_DATE,\nmeaning the size of the snapshot is up-to-date.", +"enum": [ +"UPDATING", +"UP_TO_DATE" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +}, +"type": { +"description": "Specifies the type of the attached disk, either SCRATCH orPERSISTENT.", +"enum": [ +"PERSISTENT", +"SCRATCH" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SavedDisk": { +"description": "An instance-attached disk resource.", +"id": "SavedDisk", +"properties": { +"architecture": { +"description": "Output only. [Output Only] The architecture of the attached disk.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#savedDisk", +"description": "Output only. [Output Only] Type of the resource. Always compute#savedDisk\nfor attached disks.", +"readOnly": true, +"type": "string" +}, +"sourceDisk": { +"description": "Output only. Specifies a URL of the disk attached to the source instance.", +"readOnly": true, +"type": "string" +}, +"storageBytes": { +"description": "Output only. [Output Only] Size of the individual disk snapshot used by this machine\nimage.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"storageBytesStatus": { +"description": "Output only. [Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be UPDATING, meaning\nthe size of the snapshot is being updated, or UP_TO_DATE,\nmeaning the size of the snapshot is up-to-date.", +"enum": [ +"UPDATING", +"UP_TO_DATE" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"ScalingScheduleStatus": { +"id": "ScalingScheduleStatus", +"properties": { +"lastStartTime": { +"description": "[Output Only] The last time the scaling schedule became active.\nNote: this is a timestamp when a schedule actually became active, not when\nit was planned to do so.\nThe timestamp is in RFC3339\ntext format.", +"type": "string" +}, +"nextStartTime": { +"description": "[Output Only] The next time the scaling schedule is to become active.\nNote: this is a timestamp when a schedule is planned to run, but the actual\ntime might be slightly different.\nThe timestamp is in RFC3339\ntext format.", +"type": "string" +}, +"state": { +"description": "[Output Only] The current state of a scaling schedule.", +"enum": [ +"ACTIVE", +"DISABLED", +"OBSOLETE", +"READY" +], +"enumDescriptions": [ +"The current autoscaling recommendation is influenced by this scaling\nschedule.", +"This scaling schedule has been disabled by the user.", +"This scaling schedule will never become active again.", +"The current autoscaling recommendation is not influenced by this scaling\nschedule." +], +"type": "string" +} +}, +"type": "object" +}, +"Scheduling": { +"description": "Sets the scheduling options for an Instance.", +"id": "Scheduling", +"properties": { +"automaticRestart": { +"description": "Specifies whether the instance should be automatically restarted if it is\nterminated by Compute Engine (not terminated by a user). You can only set\nthe automatic restart option for standard instances.Preemptible instances\ncannot be automatically restarted.\n\nBy default, this is set to true so an instance is\nautomatically restarted if it is terminated by Compute Engine.", +"type": "boolean" +}, +"availabilityDomain": { +"description": "Specifies the availability domain to place the instance in. The value\nmust be a number between 1 and the number of availability domains\nspecified in the spread placement policy attached to the instance.", +"format": "int32", +"type": "integer" +}, +"exposeHostTopology": { +"description": "This optional flag exposes the hashed physical host ID in the\nResourceStatus resource of the VM.", +"type": "boolean" +}, +"gracefulShutdown": { +"$ref": "SchedulingGracefulShutdown" +}, +"hostErrorTimeoutSeconds": { +"description": "Specify the time in seconds for host error detection, the value must be\nwithin the range of [90, 330] with the increment of 30, if unset, the\ndefault behavior of host error recovery will be used.", +"format": "int32", +"type": "integer" +}, +"instanceTerminationAction": { +"description": "Specifies the termination action for the instance.", +"enum": [ +"DELETE", +"INSTANCE_TERMINATION_ACTION_UNSPECIFIED", +"STOP" +], +"enumDescriptions": [ +"Delete the VM.", +"Default value. This value is unused.", +"Stop the VM without storing in-memory content. default action." +], +"type": "string" +}, +"localSsdRecoveryTimeout": { +"$ref": "Duration", +"description": "Specifies the maximum amount of time a Local Ssd Vm should wait while\nrecovery of the Local Ssd state is attempted. Its value should be in\nbetween 0 and 168 hours with hour granularity and the default value being 1\nhour." +}, +"locationHint": { +"description": "An opaque location hint used to place the instance close to other\nresources.\nThis field is for use by internal tools that use the public API.", +"type": "string" +}, +"maxRunDuration": { +"$ref": "Duration", +"description": "Specifies the max run duration for the given instance. If specified,\nthe instance termination action will be performed at the end of the run\nduration." +}, +"minNodeCpus": { +"description": "The minimum number of virtual CPUs this instance will consume when running\non a sole-tenant node.", +"format": "int32", +"type": "integer" +}, +"nodeAffinities": { +"description": "A set of node affinity and anti-affinity configurations. Refer toConfiguring node\naffinity for more information.\nOverrides reservationAffinity.", +"items": { +"$ref": "SchedulingNodeAffinity" +}, +"type": "array" +}, +"onHostMaintenance": { +"description": "Defines the maintenance behavior for this instance. For standard instances,\nthe default behavior is MIGRATE. Forpreemptible instances,\nthe default and only possible behavior is TERMINATE. For more\ninformation, see\n Set\n VM host maintenance policy.", +"enum": [ +"MIGRATE", +"TERMINATE" +], +"enumDescriptions": [ +"*[Default]* Allows Compute Engine to automatically migrate instances\nout of the way of maintenance events.", +"Tells Compute Engine to terminate and (optionally) restart the instance\naway from the maintenance activity. If you would like your instance to be\nrestarted, set the automaticRestart flag to true. Your\ninstance may be restarted more than once, and it may be restarted outside\nthe window of maintenance events." +], +"type": "string" +}, +"onInstanceStopAction": { +"$ref": "SchedulingOnInstanceStopAction" +}, +"preemptible": { +"description": "Defines whether the instance is preemptible. This can only be set during\ninstance creation or while the instance isstopped and\ntherefore, in a `TERMINATED` state. SeeInstance Life\nCycle for more information on the possible instance states.", +"type": "boolean" +}, +"preemptionNoticeDuration": { +"$ref": "Duration", +"description": "Specifies the Metadata Service preemption notice duration before the GCE ACPI G2\nSoft Off signal is triggered for Spot VMs only. If not specified,\nthere will be no wait before the G2 Soft Off signal is triggered." +}, +"provisioningModel": { +"description": "Specifies the provisioning model of the instance.", +"enum": [ +"FLEX_START", +"RESERVATION_BOUND", +"SPOT", +"STANDARD" +], +"enumDescriptions": [ +"Instance is provisioned using the Flex Start provisioning model and\nhas a limited runtime.", +"Bound to the lifecycle of the reservation in which it is provisioned.", +"Heavily discounted, no guaranteed runtime.", +"Standard provisioning with user controlled runtime, no discounts." +], +"type": "string" +}, +"skipGuestOsShutdown": { +"description": "Default is false and there will be 120 seconds between GCE ACPI G2 Soft\nOff and ACPI G3 Mechanical\nOff for Standard VMs and 30 seconds for Spot VMs.", +"type": "boolean" +}, +"terminationTime": { +"description": "Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance\ntermination action will be performed at the termination time.", +"type": "string" +} +}, +"type": "object" +}, +"SchedulingGracefulShutdown": { +"description": "The configuration for gracefully shutting down the instance.", +"id": "SchedulingGracefulShutdown", +"properties": { +"enabled": { +"description": "Opts-in for graceful shutdown.", +"type": "boolean" +}, +"maxDuration": { +"$ref": "Duration", +"description": "The time allotted for the instance to gracefully shut down. If the\ngraceful shutdown isn't complete after this time, then the instance\ntransitions to the STOPPING state." +} +}, +"type": "object" +}, +"SchedulingNodeAffinity": { +"description": "Node Affinity: the configuration of desired nodes onto which this Instance\n could be scheduled.", +"id": "SchedulingNodeAffinity", +"properties": { +"key": { +"description": "Corresponds to the label key of Node resource.", +"type": "string" +}, +"operator": { +"description": "Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.", +"enum": [ +"IN", +"NOT_IN", +"OPERATOR_UNSPECIFIED" +], +"enumDescriptions": [ +"Requires Compute Engine to seek for matched nodes.", +"Requires Compute Engine to avoid certain nodes.", +"" +], +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of Node resource.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SchedulingOnInstanceStopAction": { +"description": "Defines the behaviour for instances with the instance_termination_actionSTOP.", +"id": "SchedulingOnInstanceStopAction", +"properties": { +"discardLocalSsd": { +"description": "If true, the contents of any attached Local SSD disks will be discarded\nelse, the Local SSD data will be preserved when the instance is stopped\nat the end of the run duration/termination time.", +"type": "boolean" +} +}, +"type": "object" +}, +"Screenshot": { +"description": "An instance's screenshot.", +"id": "Screenshot", +"properties": { +"contents": { +"description": "[Output Only] The Base64-encoded screenshot data.", +"type": "string" +}, +"kind": { +"default": "compute#screenshot", +"description": "Output only. [Output Only] Type of the resource. Always compute#screenshot\nfor the screenshots.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"SecurityPoliciesAggregatedList": { +"id": "SecurityPoliciesAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "SecurityPoliciesScopedList", +"description": "Name of the scope containing this set of security policies." +}, +"description": "A list of SecurityPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#securityPoliciesAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security\nPolicies.", +"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" +}, +"SecurityPoliciesListPreconfiguredExpressionSetsResponse": { +"id": "SecurityPoliciesListPreconfiguredExpressionSetsResponse", +"properties": { +"preconfiguredExpressionSets": { +"$ref": "SecurityPoliciesWafConfig" +} +}, +"type": "object" +}, +"SecurityPoliciesScopedList": { +"id": "SecurityPoliciesScopedList", +"properties": { +"securityPolicies": { +"description": "A list of SecurityPolicies contained in this scope.", +"items": { +"$ref": "SecurityPolicy" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nsecurity policies 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.", +"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" +}, +"SecurityPoliciesWafConfig": { +"id": "SecurityPoliciesWafConfig", +"properties": { +"wafRules": { +"$ref": "PreconfiguredWafSet" +} +}, +"type": "object" +}, +"SecurityPolicy": { +"description": "Represents a Google Cloud Armor security policy resource.\n\nOnly external backend services that use load balancers can\nreference a security policy. For more information, see\nGoogle Cloud Armor security policy overview.", +"id": "SecurityPolicy", +"properties": { +"adaptiveProtectionConfig": { +"$ref": "SecurityPolicyAdaptiveProtectionConfig" +}, +"advancedOptionsConfig": { +"$ref": "SecurityPolicyAdvancedOptionsConfig" +}, +"associations": { +"description": "A list of associations that belong to this policy.", +"items": { +"$ref": "SecurityPolicyAssociation" +}, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"ddosProtectionConfig": { +"$ref": "SecurityPolicyDdosProtectionConfig" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"fingerprint": { +"description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make get() request to the\nsecurity policy.", +"format": "byte", +"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#securityPolicy", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this security policy, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\nsecurity policy.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"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.\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" +}, +"parent": { +"description": "Output only. [Output Only] The parent of the security policy.", +"readOnly": true, +"type": "string" +}, +"recaptchaOptionsConfig": { +"$ref": "SecurityPolicyRecaptchaOptionsConfig" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional security policy\nresides. This field is not applicable to global security policies.", +"readOnly": true, +"type": "string" +}, +"rules": { +"description": "A list of rules that belong to this policy.\nThere must always be a default rule which is a rule with priority\n2147483647 and match all condition (for the match condition this means\nmatch \"*\" for srcIpRanges and for the networkMatch condition every field\nmust be either match \"*\" or not set). If no rules are provided when\ncreating a security policy, a default rule with action \"allow\" will be\nadded.", +"items": { +"$ref": "SecurityPolicyRule" +}, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"shortName": { +"description": "User-provided name of the organization security policy. The name should be\nunique in the organization in which the security policy is created. This\nshould only be used when SecurityPolicyType is CLOUD_ARMOR.\nThe name must be 1-63 characters long, and comply with\nhttps://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"type": { +"description": "The type indicates the intended use of the security policy.\n \n - CLOUD_ARMOR: Cloud Armor backend security policies can\n be configured to filter incoming HTTP requests targeting backend services.\n They filter requests before they hit the origin servers.\n - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can\n be configured to filter incoming HTTP requests targeting backend services\n (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).\n They filter requests before the request is served from Google's cache.\n - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor\n internal service policies can be configured to filter HTTP requests\n targeting services managed by Traffic Director in a service mesh. They\n filter requests before the request is served from the application.\n\n- CLOUD_ARMOR_NETWORK: Cloud Armor network policies\ncan be configured to filter packets targeting network load balancing\nresources such as backend services, target pools, target instances, and\ninstances with external IPs. They filter requests before the request is\nserved from the application.\n\n\nThis field can be set only at resource creation time.", +"enum": [ +"CLOUD_ARMOR", +"CLOUD_ARMOR_EDGE", +"CLOUD_ARMOR_NETWORK" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"userDefinedFields": { +"description": "Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A\nuser-defined field consists of up to 4 bytes extracted from a fixed offset\nin the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an\noptional mask to select certain bits. Rules may then specify matching\nvalues for these fields.\n\nExample:\n\n userDefinedFields:\n - name: \"ipv4_fragment_offset\"\n base: IPV4\n offset: 6\n size: 2\n mask: \"0x1fff\"", +"items": { +"$ref": "SecurityPolicyUserDefinedField" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyAdaptiveProtectionConfig": { +"description": "Configuration options for Cloud Armor Adaptive Protection (CAAP).", +"id": "SecurityPolicyAdaptiveProtectionConfig", +"properties": { +"layer7DdosDefenseConfig": { +"$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", +"description": "If set to true, enables Cloud Armor Machine Learning." +} +}, +"type": "object" +}, +"SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig": { +"description": "Configuration options for L7 DDoS detection.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", +"id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", +"properties": { +"enable": { +"description": "If set to true, enables CAAP for L7 DDoS detection.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", +"type": "boolean" +}, +"ruleVisibility": { +"description": "Rule visibility can be one of the following:\nSTANDARD - opaque rules. (default)\nPREMIUM - transparent rules.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", +"enum": [ +"PREMIUM", +"STANDARD" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"thresholdConfigs": { +"description": "Configuration options for layer7 adaptive protection for various\ncustomizable thresholds.", +"items": { +"$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig": { +"id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig", +"properties": { +"autoDeployConfidenceThreshold": { +"format": "float", +"type": "number" +}, +"autoDeployExpirationSec": { +"format": "int32", +"type": "integer" +}, +"autoDeployImpactedBaselineThreshold": { +"format": "float", +"type": "number" +}, +"autoDeployLoadThreshold": { +"format": "float", +"type": "number" +}, +"detectionAbsoluteQps": { +"format": "float", +"type": "number" +}, +"detectionLoadThreshold": { +"format": "float", +"type": "number" +}, +"detectionRelativeToBaselineQps": { +"format": "float", +"type": "number" +}, +"name": { +"description": "The name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the security policy.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"trafficGranularityConfigs": { +"description": "Configuration options for enabling Adaptive Protection to operate\non specified granular traffic units.", +"items": { +"$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig": { +"description": "Configurations to specifc granular traffic units processed by\nAdaptive Protection.", +"id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig", +"properties": { +"enableEachUniqueValue": { +"description": "If enabled, traffic matching each unique value for the specified\ntype constitutes a separate traffic unit.\nIt can only be set to true if `value` is empty.", +"type": "boolean" +}, +"type": { +"description": "Type of this configuration.", +"enum": [ +"HTTP_HEADER_HOST", +"HTTP_PATH", +"UNSPECIFIED_TYPE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"value": { +"description": "Requests that match this value constitute a granular traffic unit.", +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyAdvancedOptionsConfig": { +"id": "SecurityPolicyAdvancedOptionsConfig", +"properties": { +"jsonCustomConfig": { +"$ref": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", +"description": "Custom configuration to apply the JSON parsing. Only applicable when\njson_parsing is set to STANDARD." +}, +"jsonParsing": { +"enum": [ +"DISABLED", +"STANDARD", +"STANDARD_WITH_GRAPHQL" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"logLevel": { +"enum": [ +"NORMAL", +"VERBOSE" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"requestBodyInspectionSize": { +"description": "The maximum request size chosen by the customer with Waf enabled.\nValues supported are \"8KB\", \"16KB, \"32KB\", \"48KB\" and \"64KB\".\nValues are case insensitive.", +"type": "string" +}, +"userIpRequestHeaders": { +"description": "An optional list of case-insensitive request header names to use for\nresolving the callers client IP address.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyAdvancedOptionsConfigJsonCustomConfig": { +"id": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", +"properties": { +"contentTypes": { +"description": "A list of custom Content-Type header values to apply the JSON parsing.\n\nAs per RFC 1341, a Content-Type header value has the following format:\n\nContent-Type := type \"/\" subtype *[\";\" parameter]\n\nWhen configuring a custom Content-Type header value, only the\ntype/subtype needs to be specified, and the parameters should be\nexcluded.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyAssociation": { +"id": "SecurityPolicyAssociation", +"properties": { +"attachmentId": { +"description": "The resource that the security policy is attached to.", +"type": "string" +}, +"displayName": { +"deprecated": true, +"description": "Output only. [Output Only] The display name of the security policy of the association.", +"readOnly": true, +"type": "string" +}, +"excludedFolders": { +"description": "A list of folders to exclude from the security policy.", +"items": { +"type": "string" +}, +"type": "array" +}, +"excludedProjects": { +"description": "A list of projects to exclude from the security policy.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"description": "The name for an association.", +"type": "string" +}, +"securityPolicyId": { +"description": "Output only. [Output Only] The security policy ID of the association.", +"readOnly": true, +"type": "string" +}, +"shortName": { +"description": "Output only. [Output Only] The short name of the security policy of the association.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyDdosProtectionConfig": { +"id": "SecurityPolicyDdosProtectionConfig", +"properties": { +"ddosAdaptiveProtection": { +"enum": [ +"DDOS_ADAPTIVE_PROTECTION_UNSPECIFIED", +"DISABLED", +"ENABLED", +"PREVIEW", +"UNSPECIFIED_ADAPTIVE_PROTECTION" +], +"enumDeprecated": [ +false, +false, +false, +false, +true +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"ddosImpactedBaselineThreshold": { +"description": "DDoS Protection for Network Load Balancers (and VMs with public IPs)\nbuilds DDoS mitigations that minimize collateral damage. It quantifies\nthis as the fraction of a non-abuse baseline that's inadvertently\nblocked.\n\nRules whose collateral damage exceeds ddosImpactedBaselineThreshold will\nnot be deployed. Using a lower value will prioritize keeping collateral\ndamage low, possibly at the cost of its effectiveness in rate limiting\nsome or all of the attack. It should typically be unset, so Advanced DDoS\n(and Adaptive Protection) uses the best mitigation it can find. Setting\nthe threshold is advised if there are logs for false positive detections\nwith high collateral damage, and will cause Advanced DDoS to attempt to\nfind a less aggressive rule that satisfies the constraint. If a suitable\nrule cannot be found, the system falls back to either no mitigation for\nsmaller attacks or broader network throttles for larger ones.", +"format": "float", +"type": "number" +}, +"ddosProtection": { +"enum": [ +"ADVANCED", +"ADVANCED_PREVIEW", +"STANDARD" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyList": { +"id": "SecurityPolicyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of SecurityPolicy resources.", +"items": { +"$ref": "SecurityPolicy" +}, +"type": "array" +}, +"kind": { +"default": "compute#securityPolicyList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies", +"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" +}, +"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" +}, +"SecurityPolicyRecaptchaOptionsConfig": { +"id": "SecurityPolicyRecaptchaOptionsConfig", +"properties": { +"redirectSiteKey": { +"description": "An optional field to supply a reCAPTCHA site key to be used for all the\nrules using the redirect action with the type of GOOGLE_RECAPTCHA under\nthe security policy. The specified site key needs to be created from the\nreCAPTCHA API. The user is responsible for the validity of the specified\nsite key. If not specified, a Google-managed site key is used.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyReference": { +"id": "SecurityPolicyReference", +"properties": { +"securityPolicy": { +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRule": { +"description": "Represents a rule that describes one or more match conditions along with\nthe action to be taken when traffic matches this condition (allow or deny).", +"id": "SecurityPolicyRule", +"properties": { +"action": { +"description": "The Action to perform when the rule is matched.\nThe following are the valid actions:\n \n - allow: allow access to target.\n - deny(STATUS): deny access to target, returns the\n HTTP response code specified. Valid values for `STATUS`\n are 403, 404, and 502.\n - rate_based_ban: limit client traffic to the configured\n threshold and ban the client if the traffic exceeds the threshold.\n Configure parameters for this action in RateLimitOptions. Requires\n rate_limit_options to be set.\n - redirect: redirect to a different target. This can\n either be an internal reCAPTCHA redirect, or an external URL-based\n redirect via a 302 response. Parameters for this action can be configured\n via redirectOptions. This action is only supported in Global Security\n Policies of type CLOUD_ARMOR.\n - throttle: limit\n client traffic to the configured threshold. Configure parameters for this\n action in rateLimitOptions. Requires rate_limit_options to be set for\n this.\n - fairshare (preview only): when traffic reaches the\n threshold limit, requests from the clients matching this rule begin to be\n rate-limited using the Fair Share algorithm. This action is only allowed\n in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"headerAction": { +"$ref": "SecurityPolicyRuleHttpHeaderAction", +"description": "Optional, additional actions that are performed on headers.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." +}, +"kind": { +"default": "compute#securityPolicyRule", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules", +"readOnly": true, +"type": "string" +}, +"match": { +"$ref": "SecurityPolicyRuleMatcher", +"description": "A match condition that incoming traffic is evaluated against.\nIf it evaluates to true, the corresponding 'action' is enforced." +}, +"networkMatch": { +"$ref": "SecurityPolicyRuleNetworkMatcher", +"description": "A match condition that incoming packets are evaluated against for\nCLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding\n'action' is enforced.\n\nThe match criteria for a rule consists of built-in match fields (like\n'srcIpRanges') and potentially multiple user-defined match fields\n('userDefinedFields').\n\nField values may be extracted directly from the packet or derived from it\n(e.g. 'srcRegionCodes'). Some fields may not be present in every packet\n(e.g. 'srcPorts'). A user-defined field is only present if the base\nheader is found in the packet and the entire field is in bounds.\n\nEach match field may specify which values can match it, listing one or\nmore ranges, prefixes, or exact values that are considered a match for\nthe field. A field value must be present in order to match a specified\nmatch field. If no match values are specified for a match field, then any\nfield value is considered to match it, and it's not required to be\npresent. For strings specifying '*' is also equivalent to match all.\n\nFor a packet to match a rule, all specified match fields must match the\ncorresponding field values derived from the packet.\n\nExample:\n\nnetworkMatch:\n srcIpRanges:\n - \"192.0.2.0/24\"\n - \"198.51.100.0/24\"\n userDefinedFields:\n - name: \"ipv4_fragment_offset\"\n values:\n - \"1-0x1fff\"\n\nThe above match condition matches packets with a source IP in\n192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named\n\"ipv4_fragment_offset\" with a value between 1 and 0x1fff inclusive." +}, +"preconfiguredWafConfig": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfig", +"description": "Preconfigured WAF configuration to be applied for the rule. If the rule\ndoes not evaluate preconfigured WAF rules, i.e., if\nevaluatePreconfiguredWaf() is not used, this field will have no effect." +}, +"preview": { +"description": "If set to true, the specified action is not enforced.", +"type": "boolean" +}, +"priority": { +"description": "An integer indicating the priority of a rule in the list. The priority\nmust be a positive value between 0 and 2147483647.\nRules are evaluated from highest to lowest priority where 0 is the\nhighest priority and 2147483647 is the lowest priority.", +"format": "int32", +"type": "integer" +}, +"rateLimitOptions": { +"$ref": "SecurityPolicyRuleRateLimitOptions", +"description": "Must be specified if the action is \"rate_based_ban\" or \"throttle\" or\n\"fairshare\". Cannot be specified for any other actions." +}, +"redirectOptions": { +"$ref": "SecurityPolicyRuleRedirectOptions", +"description": "Parameters defining the redirect action. Cannot be specified for any\nother actions.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." +} +}, +"type": "object" +}, +"SecurityPolicyRuleHttpHeaderAction": { +"id": "SecurityPolicyRuleHttpHeaderAction", +"properties": { +"requestHeadersToAdds": { +"description": "The list of request headers to add or overwrite if they're already\npresent.", +"items": { +"$ref": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRuleHttpHeaderActionHttpHeaderOption": { +"id": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption", +"properties": { +"headerName": { +"description": "The name of the header to set.", +"type": "string" +}, +"headerValue": { +"description": "The value to set the named header to.", +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRuleMatcher": { +"description": "Represents a match condition that incoming traffic is evaluated against.\nExactly one field must be specified.", +"id": "SecurityPolicyRuleMatcher", +"properties": { +"config": { +"$ref": "SecurityPolicyRuleMatcherConfig", +"description": "The configuration options available when specifying versioned_expr.\nThis field must be specified if versioned_expr is specified and cannot\nbe specified if versioned_expr is not specified." +}, +"expr": { +"$ref": "Expr", +"description": "User defined CEVAL expression.\nA CEVAL expression is used to specify match criteria such as origin.ip,\nsource.region_code and contents in the request header.\nExpressions containing `evaluateThreatIntelligence` require a Cloud\nArmor Enterprise subscription and are not supported in Edge Policies\nnor in Regional Policies. Expressions containing\n`evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor\nEnterprise subscription and are only supported in Global Security\nPolicies." +}, +"exprOptions": { +"$ref": "SecurityPolicyRuleMatcherExprOptions", +"description": "The configuration options available when specifying a user defined\nCEVAL expression (i.e., 'expr')." +}, +"versionedExpr": { +"description": "Preconfigured versioned expression.\nIf this field is specified, config must also be specified.\nAvailable preconfigured expressions along with their requirements are:\nSRC_IPS_V1 - must specify the corresponding src_ip_range field in\nconfig.", +"enum": [ +"SRC_IPS_V1" +], +"enumDescriptions": [ +"Matches the source IP address of a request to the IP ranges supplied\nin config." +], +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRuleMatcherConfig": { +"id": "SecurityPolicyRuleMatcherConfig", +"properties": { +"srcIpRanges": { +"description": "CIDR IP address range.\nMaximum number of src_ip_ranges allowed is 10.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRuleMatcherExprOptions": { +"id": "SecurityPolicyRuleMatcherExprOptions", +"properties": { +"recaptchaOptions": { +"$ref": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", +"description": "reCAPTCHA configuration options to be applied for the rule. If the\nrule does not evaluate reCAPTCHA tokens, this field has no effect." +} +}, +"type": "object" +}, +"SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions": { +"id": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", +"properties": { +"actionTokenSiteKeys": { +"description": "A list of site keys to be used during the validation of reCAPTCHA\naction-tokens. The provided site keys need to be created from\nreCAPTCHA API under the same project where the security policy is\ncreated.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sessionTokenSiteKeys": { +"description": "A list of site keys to be used during the validation of reCAPTCHA\nsession-tokens. The provided site keys need to be created from\nreCAPTCHA API under the same project where the security policy is\ncreated.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRuleNetworkMatcher": { +"description": "Represents a match condition that incoming network traffic is evaluated\nagainst.", +"id": "SecurityPolicyRuleNetworkMatcher", +"properties": { +"destIpRanges": { +"description": "Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text\nformat.", +"items": { +"type": "string" +}, +"type": "array" +}, +"destPorts": { +"description": "Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit\nunsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", +"items": { +"type": "string" +}, +"type": "array" +}, +"ipProtocols": { +"description": "IPv4 protocol / IPv6 next header (after extension headers). Each\nelement can be an 8-bit unsigned decimal number (e.g. \"6\"), range (e.g.\n\"253-254\"), or one of the following protocol names: \"tcp\", \"udp\",\n\"icmp\", \"esp\", \"ah\", \"ipip\", or \"sctp\".", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcAsns": { +"description": "BGP Autonomous System Number associated with the source IP address.", +"items": { +"format": "uint32", +"type": "integer" +}, +"type": "array" +}, +"srcIpRanges": { +"description": "Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcPorts": { +"description": "Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit\nunsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", +"items": { +"type": "string" +}, +"type": "array" +}, +"srcRegionCodes": { +"description": "Two-letter ISO 3166-1 alpha-2 country code associated with the source\nIP address.", +"items": { +"type": "string" +}, +"type": "array" +}, +"userDefinedFields": { +"description": "User-defined fields. Each element names a defined field and lists the\nmatching values for that field.", +"items": { +"$ref": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch": { +"id": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch", +"properties": { +"name": { +"description": "Name of the user-defined field, as given in the definition.", +"type": "string" +}, +"values": { +"description": "Matching values of the field. Each element can be a 32-bit unsigned\ndecimal or hexadecimal (starting with \"0x\") number (e.g. \"64\") or\nrange (e.g. \"0x400-0x7ff\").", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRulePreconfiguredWafConfig": { +"id": "SecurityPolicyRulePreconfiguredWafConfig", +"properties": { +"exclusions": { +"description": "A list of exclusions to apply during preconfigured WAF evaluation.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusion" +}, +"type": "array" +} +}, +"type": "object" +}, +"SecurityPolicyRulePreconfiguredWafConfigExclusion": { +"id": "SecurityPolicyRulePreconfiguredWafConfigExclusion", +"properties": { +"requestBodiesToExclude": { +"description": "A list of request body fields to be excluded from inspection during\npreconfigured WAF evaluation.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" +}, +"type": "array" +}, +"requestCookiesToExclude": { +"description": "A list of request cookie names whose value will be excluded from\ninspection during preconfigured WAF evaluation.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" +}, +"type": "array" +}, +"requestHeadersToExclude": { +"description": "A list of request header names whose value will be excluded from\ninspection during preconfigured WAF evaluation.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" +}, +"type": "array" +}, +"requestQueryParamsToExclude": { +"description": "A list of request query parameter names whose value will be excluded\nfrom inspection during preconfigured WAF evaluation. Note that the\nparameter can be in the query string or in the POST body.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" +}, +"type": "array" +}, +"requestUrisToExclude": { +"description": "A list of request URIs from the request line to be excluded from\ninspection during preconfigured WAF evaluation. When specifying this\nfield, the query or fragment part should be excluded.", +"items": { +"$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" +}, +"type": "array" +}, +"targetRuleIds": { +"description": "A list of target rule IDs under the WAF rule set to apply the\npreconfigured WAF exclusion. If omitted, it refers to all the rule\nIDs under the WAF rule set.", +"items": { +"type": "string" +}, +"type": "array" +}, +"targetRuleSet": { +"description": "Target WAF rule set to apply the preconfigured WAF exclusion.", +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams": { +"id": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams", +"properties": { +"op": { +"description": "The match operator for the field.", +"enum": [ +"CONTAINS", +"ENDS_WITH", +"EQUALS", +"EQUALS_ANY", +"STARTS_WITH" +], +"enumDescriptions": [ +"The operator matches if the field value contains the specified\nvalue.", +"The operator matches if the field value ends with the specified\nvalue.", +"The operator matches if the field value equals the specified\nvalue.", +"The operator matches if the field value is any value.", +"The operator matches if the field value starts with the specified\nvalue." +], +"type": "string" +}, +"val": { +"description": "The value of the field.", +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRuleRateLimitOptions": { +"id": "SecurityPolicyRuleRateLimitOptions", +"properties": { +"banDurationSec": { +"description": "Can only be specified if the action for the rule is\n\"rate_based_ban\". If specified, determines the time (in seconds)\nthe traffic will continue to be banned by the rate limit after the\nrate falls below the threshold.", +"format": "int32", +"type": "integer" +}, +"banThreshold": { +"$ref": "SecurityPolicyRuleRateLimitOptionsThreshold", +"description": "Can only be specified if the action for the rule is\n\"rate_based_ban\". If specified, the key will be banned for the\nconfigured 'ban_duration_sec' when the number of requests that exceed\nthe 'rate_limit_threshold' also exceed this 'ban_threshold'." +}, +"conformAction": { +"description": "Action to take for requests that are under the configured rate limit\nthreshold. Valid option is \"allow\" only.", +"type": "string" +}, +"enforceOnKey": { +"description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKey\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the value\n is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of the\n HTTPS request. The key value is truncated to the first 128 bytes. The\n key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the request\n originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration or\n an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n\n\nFor \"fairshare\" action, this value is limited to ALL i.e. a single rate\nlimit threshold is enforced for all the requests matching the rule.", +"enum": [ +"ALL", +"ASN", +"HTTP_COOKIE", +"HTTP_HEADER", +"HTTP_PATH", +"IP", +"REGION_CODE", +"SNI", +"TLS_JA3_FINGERPRINT", +"TLS_JA4_FINGERPRINT", +"USER_IP", +"XFF_IP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"enforceOnKeyConfigs": { +"description": "If specified, any combination of values of\nenforce_on_key_type/enforce_on_key_name is treated as the key on which\nratelimit threshold/action is enforced. You can specify up to 3\nenforce_on_key_configs. If enforce_on_key_configs is specified,\nenforce_on_key must not be specified.", +"items": { +"$ref": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig" +}, +"type": "array" +}, +"enforceOnKeyName": { +"description": "Rate limit key name applicable only for the following key types:\nHTTP_HEADER -- Name of the HTTP header whose value is taken as the key\nvalue.\nHTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key\nvalue.", +"type": "string" +}, +"exceedAction": { +"description": "Action to take for requests that are above the configured rate limit\nthreshold, to either deny with a specified HTTP response code, or\nredirect to a different endpoint.\nValid options are `deny(STATUS)`, where valid values for\n`STATUS` are 403, 404, 429, and 502, and\n`redirect`, where the redirect parameters come from\n`exceedRedirectOptions` below.\nThe `redirect` action is only supported in Global Security Policies of\ntype CLOUD_ARMOR.", +"type": "string" +}, +"exceedRedirectOptions": { +"$ref": "SecurityPolicyRuleRedirectOptions", +"description": "Parameters defining the redirect action that is used as the exceed\naction. Cannot be specified if the exceed action is not redirect.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." +}, +"rateLimitThreshold": { +"$ref": "SecurityPolicyRuleRateLimitOptionsThreshold", +"description": "Threshold at which to begin ratelimiting." +} +}, +"type": "object" +}, +"SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig": { +"id": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig", +"properties": { +"enforceOnKeyName": { +"description": "Rate limit key name applicable only for the following key types:\nHTTP_HEADER -- Name of the HTTP header whose value is taken as the\nkey value. HTTP_COOKIE -- Name of the HTTP cookie whose value is\ntaken as the key value.", +"type": "string" +}, +"enforceOnKeyType": { +"description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKeyConfigs\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the\n value is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of\n the HTTPS request. The key value is truncated to the first 128 bytes.\n The key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the\n request originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration\n or an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL.", +"enum": [ +"ALL", +"ASN", +"HTTP_COOKIE", +"HTTP_HEADER", +"HTTP_PATH", +"IP", +"REGION_CODE", +"SNI", +"TLS_JA3_FINGERPRINT", +"TLS_JA4_FINGERPRINT", +"USER_IP", +"XFF_IP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyRuleRateLimitOptionsThreshold": { +"id": "SecurityPolicyRuleRateLimitOptionsThreshold", +"properties": { +"count": { +"description": "Number of HTTP(S) requests for calculating the threshold.", +"format": "int32", +"type": "integer" +}, +"intervalSec": { +"description": "Interval over which the threshold is computed.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"SecurityPolicyRuleRedirectOptions": { +"id": "SecurityPolicyRuleRedirectOptions", +"properties": { +"target": { +"description": "Target for the redirect action. This is required if the type is\nEXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.", +"type": "string" +}, +"type": { +"description": "Type of the redirect action. Possible values are:\n \n - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual\n challenge assessment.\n - EXTERNAL_302: redirect to a different URL via a 302\n response.", +"enum": [ +"EXTERNAL_302", +"GOOGLE_RECAPTCHA" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SecurityPolicyUserDefinedField": { +"id": "SecurityPolicyUserDefinedField", +"properties": { +"base": { +"description": "The base relative to which 'offset' is measured. Possible values are:\n \n - IPV4: Points to the beginning of the IPv4 header.\n - IPV6: Points to the beginning of the IPv6 header.\n - TCP: Points to the beginning of the TCP header, skipping\n over any IPv4 options or IPv6 extension headers. Not present for\n non-first fragments.\n - UDP: Points to the beginning of the UDP header, skipping\n over any IPv4 options or IPv6 extension headers. Not present for\n non-first fragments.\n\n\nrequired", +"enum": [ +"IPV4", +"IPV6", +"TCP", +"UDP" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +}, +"mask": { +"description": "If specified, apply this mask (bitwise AND) to the field to ignore bits\nbefore matching. Encoded as a hexadecimal number (starting with \"0x\").\nThe last byte of the field (in network byte order) corresponds to the\nleast significant byte of the mask.", +"type": "string" +}, +"name": { +"description": "The name of this field. Must be unique within the policy.", +"type": "string" +}, +"offset": { +"description": "Offset of the first byte of the field (in network byte order) relative to\n'base'.", +"format": "int32", +"type": "integer" +}, +"size": { +"description": "Size of the field in bytes. Valid values: 1-4.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"SecuritySettings": { +"description": "The authentication and authorization settings for a BackendService.", +"id": "SecuritySettings", +"properties": { +"awsV4Authentication": { +"$ref": "AWSV4Signature", +"description": "The configuration needed to generate a signature for access to private\nstorage buckets that support AWS's Signature Version 4 for authentication.\nAllowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends." +}, +"clientTlsPolicy": { +"description": "Optional. A URL referring to a networksecurity.ClientTlsPolicy resource\nthat describes how clients should authenticate with this service's\nbackends.\n\n clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set\nto INTERNAL_SELF_MANAGED.\n\n If left blank, communications are not encrypted.", +"type": "string" +}, +"subjectAltNames": { +"description": "Optional. A list of Subject Alternative Names (SANs) that the client\nverifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate\nto the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the\nspecified values, the communication continues. Otherwise, it fails. This\nadditional check enables the client to verify that the server is authorized\nto run the requested service.\n\n Note that the contents of the server\ncertificate's subjectAltName field are configured by the\nPublic Key Infrastructure which provisions server identities.\n\n Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.\nOnly applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS\nmode).", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SerialPortOutput": { +"description": "An instance serial console output.", +"id": "SerialPortOutput", +"properties": { +"contents": { +"description": "[Output Only] The contents of the console output.", +"type": "string" +}, +"kind": { +"default": "compute#serialPortOutput", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output.", +"readOnly": true, +"type": "string" +}, +"next": { +"description": "[Output Only] The position of the next byte of content, regardless of\nwhether the content exists, following the output returned in the `contents`\nproperty. Use this value in the next request as the start\nparameter.", +"format": "int64", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"start": { +"description": "The starting byte position of the output that was returned.\nThis should match the start parameter sent with the request.\nIf the serial console output exceeds the size of the buffer (1 MB), older\noutput is overwritten by newer content. The output start value will\nindicate the byte position of the output that was returned, which might be\ndifferent than the `start` value that was specified in the request.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"ServerBinding": { +"id": "ServerBinding", +"properties": { +"type": { +"enum": [ +"RESTART_NODE_ON_ANY_SERVER", +"RESTART_NODE_ON_MINIMAL_SERVERS", +"SERVER_BINDING_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Node may associate with any physical server over its lifetime.", +"Node may associate with minimal physical servers over its lifetime.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ServiceAccount": { +"description": "A service account.", +"id": "ServiceAccount", +"properties": { +"email": { +"description": "Email address of the service account.", +"type": "string" +}, +"scopes": { +"description": "The list of scopes to be made available for this service account.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"ServiceAttachment": { +"description": "Represents a ServiceAttachment resource.\n\nA service attachment represents a service that a producer has exposed.\nIt encapsulates the load balancer which fronts the service runs and\na list of NAT IP ranges that the producers uses to represent\nthe consumers connecting to the service.", +"id": "ServiceAttachment", +"properties": { +"connectedEndpoints": { +"description": "Output only. [Output Only] An array of connections for all the consumers connected to\nthis service attachment.", +"items": { +"$ref": "ServiceAttachmentConnectedEndpoint" +}, +"readOnly": true, +"type": "array" +}, +"connectionPreference": { +"description": "The connection preference of service attachment. The value can be set\nto ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC\nservice attachment is one that always accepts the connection from consumer\nforwarding rules.", +"enum": [ +"ACCEPT_AUTOMATIC", +"ACCEPT_MANUAL", +"CONNECTION_PREFERENCE_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"consumerAcceptLists": { +"description": "Specifies which consumer projects or networks are allowed to connect to the\nservice attachment. Each project or network has a connection limit. A given\nservice attachment can manage connections at either the project or network\nlevel. Therefore, both the accept and reject lists for a given service\nattachment must contain either only projects or only networks or only\nendpoints.", +"items": { +"$ref": "ServiceAttachmentConsumerProjectLimit" +}, +"type": "array" +}, +"consumerRejectLists": { +"description": "Specifies a list of projects or networks that are not allowed to connect to\nthis service attachment. The project can be specified using its project ID\nor project number and the network can be specified using its URL. A given\nservice attachment can manage connections at either the project or network\nlevel. Therefore, both the reject and accept lists for a given service\nattachment must contain either only projects or only networks.", +"items": { +"type": "string" +}, +"type": "array" +}, +"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" +}, +"domainNames": { +"description": "If specified, the domain name will be used during the integration between\nthe PSC connected endpoints and the Cloud DNS. For example, this is a valid\ndomain name: \"p.mycompany.com.\". Current max number of domain names\nsupported is 1.", +"items": { +"type": "string" +}, +"type": "array" +}, +"enableProxyProtocol": { +"description": "If true, enable the proxy protocol which is for supplying client TCP/IP\naddress data in TCP connections that traverse proxies on their way to\ndestination servers.", +"type": "boolean" +}, +"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 ServiceAttachment. An up-to-date fingerprint must\nbe provided in order to patch/update the ServiceAttachment; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nServiceAttachment.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#serviceAttachment", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.", +"readOnly": true, +"type": "string" +}, +"metadata": { +"additionalProperties": { +"type": "string" +}, +"description": "Metadata of the service attachment.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.serviceAttachments.insert" +] +}, +"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" +}, +"natIpsPerEndpoint": { +"description": "The number of NAT IP addresses to be allocated per connected endpoint.\nIf not specified, the default value is 1.", +"format": "uint32", +"type": "integer" +}, +"natSubnets": { +"description": "An array of URLs where each entry is the URL of a subnet provided\nby the service producer to use for NAT in this service attachment.", +"items": { +"type": "string" +}, +"type": "array" +}, +"producerForwardingRule": { +"deprecated": true, +"description": "The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is\nserving the endpoint identified by this service attachment.", +"type": "string" +}, +"propagatedConnectionLimit": { +"description": "The number of consumer spokes that connected Private Service Connect\nendpoints can be propagated to through Network Connectivity Center. This\nlimit lets the service producer limit how many propagated Private Service\nConnect connections can be established to this service attachment from a\nsingle consumer.\n\nIf the connection preference of the service attachment is ACCEPT_MANUAL,\nthe limit applies to each project or network that is listed in the consumer\naccept list. If the connection preference of the service attachment is\nACCEPT_AUTOMATIC, the limit applies to each project that contains a\nconnected endpoint.\n\nIf unspecified, the default propagated connection limit is 250.", +"format": "uint32", +"type": "integer" +}, +"pscServiceAttachmentId": { +"$ref": "Uint128", +"description": "Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.", +"readOnly": true +}, +"reconcileConnections": { +"description": "This flag determines whether a consumer accept/reject list change can\nreconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.\n \n \n - If false, connection policy update will only affect existing PENDING\n PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched\n regardless how the connection policy is modified . \n - If true,\n update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For\n example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project\n is added to the reject list.\n\n\nFor newly created service attachment, this boolean defaults to false.", +"type": "boolean" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the service attachment resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"targetService": { +"description": "The URL of a service serving the endpoint identified by this service\nattachment.", +"type": "string" +} +}, +"type": "object" +}, +"ServiceAttachmentAggregatedList": { +"description": "Contains a list of ServiceAttachmentsScopedList.", +"id": "ServiceAttachmentAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "ServiceAttachmentsScopedList", +"description": "Name of the scope containing this set of ServiceAttachments." +}, +"description": "A list of ServiceAttachmentsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#serviceAttachmentAggregatedList", +"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" +}, +"ServiceAttachmentConnectedEndpoint": { +"description": "[Output Only] A connection connected to this service attachment.", +"id": "ServiceAttachmentConnectedEndpoint", +"properties": { +"consumerNetwork": { +"description": "The url of the consumer network.", +"type": "string" +}, +"endpoint": { +"description": "The url of a connected endpoint.", +"type": "string" +}, +"endpointWithId": { +"description": "The url of a connected endpoint with resource id.", +"type": "string" +}, +"natIps": { +"description": "NAT IPs of the connected PSC endpoint and those of other endpoints\npropagated from it.", +"items": { +"type": "string" +}, +"type": "array" +}, +"propagatedConnectionCount": { +"description": "The number of consumer Network Connectivity Center spokes that the\nconnected Private Service Connect endpoint has propagated to.", +"format": "uint32", +"type": "integer" +}, +"pscConnectionId": { +"description": "The PSC connection id of the connected endpoint.", +"format": "uint64", +"type": "string" +}, +"status": { +"description": "The status of a connected endpoint to this service attachment.", +"enum": [ +"ACCEPTED", +"CLOSED", +"NEEDS_ATTENTION", +"PENDING", +"REJECTED", +"STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The connection has been accepted by the producer.", +"The connection has been closed by the producer.", +"The connection has been accepted by the producer, but the producer\nneeds to take further action before the forwarding rule can serve\ntraffic.", +"The connection is pending acceptance by the producer.", +"The consumer is still connected but not using the connection.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ServiceAttachmentConsumerProjectLimit": { +"id": "ServiceAttachmentConsumerProjectLimit", +"properties": { +"connectionLimit": { +"description": "The value of the limit to set. For endpoint_url, the limit should be no\nmore than 1.", +"format": "uint32", +"type": "integer" +}, +"endpointUrl": { +"description": "The URL for the PSC endpoint to accept", +"type": "string" +}, +"networkUrl": { +"description": "The network URL for the network to set the limit for.", +"type": "string" +}, +"projectIdOrNum": { +"description": "The project id or number for the project to set the limit for.", +"type": "string" +} +}, +"type": "object" +}, +"ServiceAttachmentList": { +"id": "ServiceAttachmentList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of ServiceAttachment resources.", +"items": { +"$ref": "ServiceAttachment" +}, +"type": "array" +}, +"kind": { +"default": "compute#serviceAttachmentList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.", +"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] Server-defined URL for this resource.", +"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" +}, +"ServiceAttachmentsScopedList": { +"id": "ServiceAttachmentsScopedList", +"properties": { +"serviceAttachments": { +"description": "A list of ServiceAttachments contained in this scope.", +"items": { +"$ref": "ServiceAttachment" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nservice attachments 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.", +"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" +}, +"SetCommonInstanceMetadataOperationMetadata": { +"id": "SetCommonInstanceMetadataOperationMetadata", +"properties": { +"clientOperationId": { +"description": "[Output Only] The client operation id.", +"type": "string" +}, +"perLocationOperations": { +"additionalProperties": { +"$ref": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo" +}, +"description": "[Output Only] Status information per location (location name is key).\nExample key: zones/us-central1-a", +"type": "object" +} +}, +"type": "object" +}, +"SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo": { +"id": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo", +"properties": { +"error": { +"$ref": "Status", +"description": "[Output Only] If state is `ABANDONED` or `FAILED`, this field is\npopulated." +}, +"state": { +"description": "[Output Only] Status of the action, which can be one of the following:\n`PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.", +"enum": [ +"ABANDONED", +"DONE", +"FAILED", +"PROPAGATED", +"PROPAGATING", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Operation not tracked in this location e.g. zone is marked as DOWN.", +"Operation has completed successfully.", +"Operation is in an error state.", +"Operation is confirmed to be in the location.", +"Operation is not yet confirmed to have been created in the location.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"ShareSettings": { +"description": "The share setting for reservations and sole tenancy node groups.", +"id": "ShareSettings", +"properties": { +"projectMap": { +"additionalProperties": { +"$ref": "ShareSettingsProjectConfig" +}, +"description": "A map of project id and project config. This is only valid when\nshare_type's value is SPECIFIC_PROJECTS.", +"type": "object" +}, +"shareType": { +"description": "Type of sharing for this shared-reservation", +"enum": [ +"LOCAL", +"ORGANIZATION", +"SHARE_TYPE_UNSPECIFIED", +"SPECIFIC_PROJECTS" +], +"enumDescriptions": [ +"Default value.", +"Shared-reservation is open to entire Organization", +"Default value. This value is unused.", +"Shared-reservation is open to specific projects" +], +"type": "string" +} +}, +"type": "object" +}, +"ShareSettingsProjectConfig": { +"description": "Config for each project in the share settings.", +"id": "ShareSettingsProjectConfig", +"properties": { +"projectId": { +"description": "The project ID, should be same as the key of this project config in the\nparent map.", +"type": "string" +} +}, +"type": "object" +}, +"ShieldedInstanceConfig": { +"description": "A set of Shielded Instance options.", +"id": "ShieldedInstanceConfig", +"properties": { +"enableIntegrityMonitoring": { +"description": "Defines whether the instance has integrity monitoring enabled.Enabled by\ndefault.", +"type": "boolean" +}, +"enableSecureBoot": { +"description": "Defines whether the instance has Secure Boot enabled.Disabled by\ndefault.", +"type": "boolean" +}, +"enableVtpm": { +"description": "Defines whether the instance has the vTPM enabled.Enabled by\ndefault.", +"type": "boolean" +} +}, +"type": "object" +}, +"ShieldedInstanceIdentity": { +"description": "A Shielded Instance Identity.", +"id": "ShieldedInstanceIdentity", +"properties": { +"eccP256EncryptionKey": { +"$ref": "ShieldedInstanceIdentityEntry", +"description": "An Endorsement Key (EK) made by the ECC P256 algorithm\nissued to the Shielded Instance's vTPM." +}, +"eccP256SigningKey": { +"$ref": "ShieldedInstanceIdentityEntry", +"description": "An Attestation Key (AK) made by the ECC P256 algorithm\nissued to the Shielded Instance's vTPM." +}, +"encryptionKey": { +"$ref": "ShieldedInstanceIdentityEntry", +"description": "An Endorsement Key (EK) made by the RSA 2048 algorithm\nissued to the Shielded Instance's vTPM." +}, +"kind": { +"default": "compute#shieldedInstanceIdentity", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance\nidentity entry.", +"readOnly": true, +"type": "string" +}, +"signingKey": { +"$ref": "ShieldedInstanceIdentityEntry", +"description": "An Attestation Key (AK) made by the RSA 2048 algorithm\nissued to the Shielded Instance's vTPM." +} +}, +"type": "object" +}, +"ShieldedInstanceIdentityEntry": { +"description": "A Shielded Instance Identity Entry.", +"id": "ShieldedInstanceIdentityEntry", +"properties": { +"ekCert": { +"description": "A PEM-encoded X.509 certificate. This field can be empty.", +"type": "string" +}, +"ekPub": { +"description": "A PEM-encoded public key.", +"type": "string" +} +}, +"type": "object" +}, +"ShieldedInstanceIntegrityPolicy": { +"description": "The policy describes the baseline against which\nInstance boot integrity is measured.", +"id": "ShieldedInstanceIntegrityPolicy", +"properties": { +"updateAutoLearnPolicy": { +"description": "Updates the integrity policy baseline using the\nmeasurements from the VM instance's most recent boot.", +"type": "boolean" +} +}, +"type": "object" +}, +"SignedUrlKey": { +"description": "Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs", +"id": "SignedUrlKey", +"properties": { +"keyName": { +"description": "Name of the key. The 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" +}, +"keyValue": { +"description": "128-bit key value used for signing the URL. The key value must be a validRFC\n4648 Section 5 base64url encoded string.", +"type": "string" +} +}, +"type": "object" +}, +"Snapshot": { +"description": "Represents a Persistent Disk Snapshot resource.\n\nYou can use snapshots to back up data on a regular interval. For more\ninformation, read Creating\npersistent disk snapshots.", +"id": "Snapshot", +"properties": { +"architecture": { +"description": "Output only. [Output Only] The architecture of the snapshot. Valid values are\nARM64 or X86_64.", +"enum": [ +"ARCHITECTURE_UNSPECIFIED", +"ARM64", +"X86_64" +], +"enumDescriptions": [ +"Default value indicating Architecture is not set.", +"Machines with architecture ARM64", +"Machines with architecture X86_64" +], +"readOnly": true, +"type": "string" +}, +"autoCreated": { +"description": "Output only. [Output Only] Set to true if snapshots are automatically created by\napplying resource policy on the target disk.", +"readOnly": true, +"type": "boolean" +}, +"chainName": { +"description": "Creates the new snapshot in the snapshot chain labeled with the\nspecified name. The chain name must be 1-63 characters long and comply\nwith RFC1035. This is an uncommon option only for advanced service\nowners who needs to create separate snapshot chains, for example,\nfor chargeback tracking. When you describe your snapshot resource, this\nfield is visible only if it has a non-empty value.", +"type": "string" +}, +"creationSizeBytes": { +"description": "Output only. [Output Only] Size in bytes of the snapshot at creation time.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"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" +}, +"diskSizeGb": { +"description": "Output only. [Output Only] Size of the source disk, specified in GB.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"downloadBytes": { +"description": "Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"enableConfidentialCompute": { +"description": "Output only. Whether this snapshot is created from a confidential compute mode disk.\n[Output Only]: This field is not set by user, but from source disk.", +"readOnly": true, +"type": "boolean" +}, +"guestFlush": { +"description": "[Input Only] Whether to attempt an application consistent snapshot by\ninforming the OS to prepare for the snapshot process.", +"type": "boolean" +}, +"guestOsFeatures": { +"description": "Output only. [Output Only] A list of features to enable on the guest operating system.\nApplicable only for bootable images. Read \nEnabling guest operating system features to see a list of available\noptions.", +"items": { +"$ref": "GuestOsFeature" +}, +"readOnly": true, +"type": "array" +}, +"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#snapshot", +"description": "Output only. [Output Only] Type of the resource. Always compute#snapshot\nfor Snapshot resources.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this snapshot, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a snapshot.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this snapshot. These can be later modified by\nthe setLabels method.\nLabel values may be empty.", +"type": "object" +}, +"licenseCodes": { +"description": "Output only. [Output Only] Integer license codes indicating which licenses are attached\nto this snapshot.", +"items": { +"format": "int64", +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"licenses": { +"description": "Output only. [Output Only] A list of public visible licenses that apply to this\nsnapshot. This can be because the original image had licenses attached\n(such as a Windows image).", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"locationHint": { +"description": "An opaque location hint used to place the snapshot close to other\nresources.\nThis field is for use by internal tools that use the public API.", +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.disks.createSnapshot", +"compute.snapshots.insert" +] +}, +"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 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" +}, +"params": { +"$ref": "SnapshotParams", +"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 snapshot resides. Only applicable\nfor regional snapshots.", +"readOnly": true, +"type": "string" +}, +"satisfiesPzi": { +"description": "Output only. Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"satisfiesPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"snapshotEncryptionKey": { +"$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. The usage of snapshot group feature is restricted.", +"readOnly": true, +"type": "string" +}, +"snapshotGroupName": { +"description": "Output only. [Output only] The snapshot group that this snapshot belongs to. The usage\nof snapshot group feature is restricted.", +"readOnly": true, +"type": "string" +}, +"snapshotType": { +"description": "Indicates the type of the snapshot.", +"enum": [ +"ARCHIVE", +"STANDARD" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"sourceDisk": { +"description": "The source disk used to create this snapshot.", +"type": "string" +}, +"sourceDiskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "The customer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." +}, +"sourceDiskForRecoveryCheckpoint": { +"description": "The source disk whose recovery checkpoint will be used to create this\nsnapshot.", +"type": "string" +}, +"sourceDiskId": { +"description": "Output only. [Output Only] The ID value of the disk used to create this snapshot. This\nvalue may be used to determine whether the snapshot was taken from the\ncurrent or a previous instance of a given disk name.", +"readOnly": true, +"type": "string" +}, +"sourceInstantSnapshot": { +"description": "The source instant snapshot used to create this snapshot. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot\n - projects/project/zones/zone/instantSnapshots/instantSnapshot \n - zones/zone/instantSnapshots/instantSnapshot", +"type": "string" +}, +"sourceInstantSnapshotEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Customer provided encryption key when creating Snapshot from Instant\nSnapshot." +}, +"sourceInstantSnapshotId": { +"description": "Output only. [Output Only] The unique ID of the instant snapshot used to create this\nsnapshot. This value identifies the exact instant snapshot that was used to\ncreate this snapshot. For example, if you created the snapshot from an\ninstant snapshot that was later deleted and recreated under the same name,\nthe source instant snapshot ID would identify the exact instant snapshot\nthat was used.", +"readOnly": true, +"type": "string" +}, +"sourceSnapshotSchedulePolicy": { +"description": "Output only. [Output Only] URL of the resource policy which created this\nscheduled snapshot.", +"readOnly": true, +"type": "string" +}, +"sourceSnapshotSchedulePolicyId": { +"description": "Output only. [Output Only] ID of the resource policy which created this\nscheduled snapshot.", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY", +"UPLOADING" +], +"enumDescriptions": [ +"Snapshot creation is in progress.", +"Snapshot is currently being deleted.", +"Snapshot creation failed.", +"Snapshot has been created successfully.", +"Snapshot is being uploaded." +], +"readOnly": true, +"type": "string" +}, +"storageBytes": { +"description": "Output only. [Output Only] A size of the storage used by the snapshot. As snapshots\nshare storage, this number is expected to change with snapshot\ncreation/deletion.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"storageBytesStatus": { +"description": "Output only. [Deprecated] Instead, check the storageBytes field. After\nsnapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.\n[Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be unset, meaning the snapshot is\nbeing created, or UP_TO_DATE, meaning the size of the snapshot\nis up-to-date.", +"enum": [ +"UPDATING", +"UP_TO_DATE" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +}, +"storageLocations": { +"description": "Cloud Storage bucket storage location of the snapshot (regional or\nmulti-regional).", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"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" +}, +"SnapshotList": { +"description": "Contains a list of Snapshot resources.", +"id": "SnapshotList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Snapshot resources.", +"items": { +"$ref": "Snapshot" +}, +"type": "array" +}, +"kind": { +"default": "compute#snapshotList", +"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.", +"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" +}, +"SnapshotParams": { +"description": "Additional snapshot params.", +"id": "SnapshotParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"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/{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" +}, +"SnapshotSettings": { +"id": "SnapshotSettings", +"properties": { +"accessLocation": { +"$ref": "SnapshotSettingsAccessLocation", +"description": "(Regional snapshots use only)Policy of which location is allowed to access\nsnapshot." +}, +"storageLocation": { +"$ref": "SnapshotSettingsStorageLocationSettings", +"description": "Policy of which storage location is going to be resolved, and additional\ndata that particularizes how the policy is going to be carried out." +} +}, +"type": "object" +}, +"SnapshotSettingsAccessLocation": { +"id": "SnapshotSettingsAccessLocation", +"properties": { +"locations": { +"additionalProperties": { +"$ref": "SnapshotSettingsAccessLocationAccessLocationPreference" +}, +"description": "List of regions that can restore a regional\n snapshot from the current region", +"type": "object" +}, +"policy": { +"description": "Policy of which location is allowed to access snapshot.", +"enum": [ +"ALL_REGIONS", +"POLICY_UNSPECIFIED", +"SPECIFIC_REGIONS" +], +"enumDescriptions": [ +"Any regions will be able to access the source location.", +"", +"Only allowlisted regions will be able to restore region scoped\nsnapshots" +], +"type": "string" +} +}, +"type": "object" +}, +"SnapshotSettingsAccessLocationAccessLocationPreference": { +"description": "A structure for specifying an allowed target region.", +"id": "SnapshotSettingsAccessLocationAccessLocationPreference", +"properties": { +"region": { +"description": "Accessible region name", +"type": "string" +} +}, +"type": "object" +}, +"SnapshotSettingsStorageLocationSettings": { +"id": "SnapshotSettingsStorageLocationSettings", +"properties": { +"locations": { +"additionalProperties": { +"$ref": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference" +}, +"description": "When the policy is SPECIFIC_LOCATIONS, snapshots will be stored\nin the locations listed in this field. Keys are Cloud Storage bucket\nlocations. Only one location can be specified.", +"type": "object" +}, +"policy": { +"description": "The chosen location policy.", +"enum": [ +"LOCAL_REGION", +"NEAREST_MULTI_REGION", +"SPECIFIC_LOCATIONS", +"STORAGE_LOCATION_POLICY_UNSPECIFIED" +], +"enumDescriptions": [ +"Store snapshot in the same region as with the originating disk.\nNo additional parameters are needed.", +"Store snapshot in the nearest multi region Cloud Storage bucket,\nrelative to the originating disk. No additional parameters are needed.", +"Store snapshot in the specific locations, as specified by the user.\nThe list of regions to store must be defined under the `locations`\nfield.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SnapshotSettingsStorageLocationSettingsStorageLocationPreference": { +"description": "A structure for specifying storage locations.", +"id": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference", +"properties": { +"name": { +"description": "Name of the location. It should be one of the Cloud Storage buckets.\nOnly one location can be specified.", +"type": "string" +} +}, +"type": "object" +}, +"SnapshotUpdateKmsKeyRequest": { +"id": "SnapshotUpdateKmsKeyRequest", +"properties": { +"kmsKeyName": { +"description": "Optional. The new KMS key to replace the current one on the snapshot. If empty, the\nsnapshot will be re-encrypted using the primary version of the snapshot's\ncurrent KMS key.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/region/keyRings/key_ring/cryptoKeys/key", +"type": "string" +} +}, +"type": "object" +}, +"SourceDiskEncryptionKey": { +"id": "SourceDiskEncryptionKey", +"properties": { +"diskEncryptionKey": { +"$ref": "CustomerEncryptionKey", +"description": "Thecustomer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." +}, +"sourceDisk": { +"description": "URL of the disk attached to the source instance. This can be a full or\nvalid partial URL. For example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", +"type": "string" +} +}, +"type": "object" +}, +"SourceInstanceParams": { +"description": "A specification of the parameters to use when creating the instance template\nfrom a source instance.", +"id": "SourceInstanceParams", +"properties": { +"diskConfigs": { +"description": "Attached disks configuration. If not provided, defaults are applied:\nFor boot disk and any other R/W disks, the source images for each disk\nwill be used. For read-only disks, they will be attached in read-only\nmode. Local SSD disks will be created as blank volumes.", +"items": { +"$ref": "DiskInstantiationConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"SourceInstanceProperties": { +"description": "DEPRECATED: Please use compute#instanceProperties instead.\nNew properties will not be added to this field.", +"id": "SourceInstanceProperties", +"properties": { +"canIpForward": { +"description": "Enables instances created based on this machine image to send packets with\nsource IP addresses other than their own and receive packets with\ndestination IP addresses other than their own. If these instances will be\nused as an IP gateway or it will be set as the next-hop in a Route\nresource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding\ndocumentation for more information.", +"type": "boolean" +}, +"deletionProtection": { +"description": "Whether the instance created from this machine image should be protected\nagainst deletion.", +"type": "boolean" +}, +"description": { +"description": "An optional text description for the instances that are created from this\nmachine image.", +"type": "string" +}, +"disks": { +"description": "An array of disks that are associated with the instances that are created\nfrom this machine image.", +"items": { +"$ref": "SavedAttachedDisk" +}, +"type": "array" +}, +"guestAccelerators": { +"description": "A list of guest accelerator cards' type and count to use for instances\ncreated from this machine image.", +"items": { +"$ref": "AcceleratorConfig" +}, +"type": "array" +}, +"keyRevocationActionType": { +"description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", +"enum": [ +"KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", +"NONE", +"STOP" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Indicates user chose no operation.", +"Indicates user chose to opt for VM shutdown on key revocation." +], +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to instances that are created from this machine image.", +"type": "object" +}, +"machineType": { +"description": "The machine type to use for instances that are created from this machine\nimage.", +"type": "string" +}, +"metadata": { +"$ref": "Metadata", +"description": "The metadata key/value pairs to assign to instances that are created from\nthis machine image. These pairs can consist of custom metadata or\npredefined keys. SeeProject and\ninstance metadata for more information." +}, +"minCpuPlatform": { +"description": "Minimum cpu/platform to be used by instances created from this machine\nimage. The instance may be scheduled on the specified or newer\ncpu/platform. Applicable values are the friendly names of CPU platforms,\nsuch as minCpuPlatform: \"Intel Haswell\" orminCpuPlatform: \"Intel Sandy Bridge\". For more\ninformation, read Specifying a\nMinimum CPU Platform.", +"type": "string" +}, +"networkInterfaces": { +"description": "An array of network access configurations for this interface.", +"items": { +"$ref": "NetworkInterface" +}, +"type": "array" +}, +"postKeyRevocationActionType": { +"description": "PostKeyRevocationActionType of the instance.", +"enum": [ +"NOOP", +"POST_KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", +"SHUTDOWN" +], +"enumDescriptions": [ +"Indicates user chose no operation.", +"Default value. This value is unused.", +"Indicates user chose to opt for VM shutdown on key revocation." +], +"type": "string" +}, +"scheduling": { +"$ref": "Scheduling", +"description": "Specifies the scheduling options for the instances that are created from\nthis machine image." +}, +"serviceAccounts": { +"description": "A list of service accounts with specified scopes. Access tokens for these\nservice accounts are available to the instances that are created from this\nmachine image. Use metadata queries to obtain the access tokens for these\ninstances.", +"items": { +"$ref": "ServiceAccount" +}, +"type": "array" +}, +"tags": { +"$ref": "Tags", +"description": "A list of tags to apply to the instances that are created from this machine\nimage. The tags identify valid sources or targets for network firewalls.\nThe setTags method can modify this list of tags. Each tag within the list\nmust comply withRFC1035." +} +}, +"type": "object" +}, +"SslCertificate": { +"description": "Represents an SSL certificate resource.\n\nGoogle Compute Engine has two SSL certificate resources:\n\n* [Global](/compute/docs/reference/rest/v1/sslCertificates)\n* [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)\n\n\nThe global SSL certificates (sslCertificates) are used by:\n \n - Global external Application Load Balancers\n - Classic Application Load Balancers\n - Proxy Network Load Balancers (with target SSL proxies)\n\n\n\nThe regional SSL certificates (regionSslCertificates) are used\nby:\n \n - Regional external Application Load Balancers\n - Regional internal Application Load Balancers\n\n\n\nOptionally, certificate file contents that you upload can contain a set of up\nto five PEM-encoded certificates.\nThe API call creates an object (sslCertificate) that holds this data.\nYou can use SSL keys and certificates to secure connections to a load\nbalancer.\nFor more information, read \nCreating and using SSL certificates,SSL certificates\nquotas and limits, and\nTroubleshooting SSL certificates.", +"id": "SslCertificate", +"properties": { +"certificate": { +"description": "A value read into memory from a certificate file. The certificate file must\nbe in PEM format. The certificate chain must be no greater than 5 certs\nlong. The chain must include at least one intermediate cert.", +"type": "string" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"expireTime": { +"description": "Output only. [Output Only] Expire time of the certificate. RFC3339", +"readOnly": true, +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#sslCertificate", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.", +"readOnly": true, +"type": "string" +}, +"managed": { +"$ref": "SslCertificateManagedSslCertificate", +"description": "Configuration and status of a managed SSL certificate." +}, +"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.\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" +}, +"privateKey": { +"description": "A value read into memory from a write-only private key file. The private\nkey file must be in PEM format. For security, only insert\nrequests include this field.", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional SSL Certificate\nresides. This field is not applicable to global SSL Certificate.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output only] Server-defined URL for the resource.", +"type": "string" +}, +"selfManaged": { +"$ref": "SslCertificateSelfManagedSslCertificate", +"description": "Configuration and status of a self-managed SSL certificate." +}, +"subjectAlternativeNames": { +"description": "Output only. [Output Only] Domains associated with the certificate via Subject\nAlternative Name.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"type": { +"description": "(Optional) Specifies the type of SSL certificate, either \"SELF_MANAGED\" or\n\"MANAGED\". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.", +"enum": [ +"MANAGED", +"SELF_MANAGED", +"TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"Google-managed SSLCertificate.", +"Certificate uploaded by user.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"SslCertificateAggregatedList": { +"id": "SslCertificateAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "SslCertificatesScopedList", +"description": "Name of the scope containing this set of SslCertificates." +}, +"description": "A list of SslCertificatesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#sslCertificateAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL\nCertificates.", +"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" +}, +"SslCertificateList": { +"description": "Contains a list of SslCertificate resources.", +"id": "SslCertificateList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of SslCertificate resources.", +"items": { +"$ref": "SslCertificate" +}, +"type": "array" +}, +"kind": { +"default": "compute#sslCertificateList", +"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.", +"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" +}, +"SslCertificateManagedSslCertificate": { +"description": "Configuration and status of a managed SSL certificate.", +"id": "SslCertificateManagedSslCertificate", +"properties": { +"domainStatus": { +"additionalProperties": { +"enum": [ +"ACTIVE", +"DOMAIN_STATUS_UNSPECIFIED", +"FAILED_CAA_CHECKING", +"FAILED_CAA_FORBIDDEN", +"FAILED_NOT_VISIBLE", +"FAILED_RATE_LIMITED", +"PROVISIONING" +], +"enumDescriptions": [ +"A managed certificate can be provisioned, no issues for this domain.", +"", +"Failed to check CAA records for the domain.", +"Certificate issuance forbidden by an explicit CAA record for the\ndomain.", +"There seems to be problem with the user's DNS or load balancer\nconfiguration for this domain.", +"Reached rate-limit for certificates per top-level private domain.", +"Certificate provisioning for this domain is under way. GCP will\nattempt to provision the first certificate." +], +"type": "string" +}, +"description": "Output only. [Output only] Detailed statuses of the domains specified for managed\ncertificate resource.", +"readOnly": true, +"type": "object" +}, +"domains": { +"description": "The domains for which a managed SSL certificate will be generated. Each\nGoogle-managed SSL certificate supports up to the [maximum number of\ndomains per Google-managed SSL\ncertificate](/load-balancing/docs/quotas#ssl_certificates).", +"items": { +"type": "string" +}, +"type": "array" +}, +"status": { +"description": "Output only. [Output only] Status of the managed certificate resource.", +"enum": [ +"ACTIVE", +"MANAGED_CERTIFICATE_STATUS_UNSPECIFIED", +"PROVISIONING", +"PROVISIONING_FAILED", +"PROVISIONING_FAILED_PERMANENTLY", +"RENEWAL_FAILED" +], +"enumDescriptions": [ +"The certificate management is working, and a certificate has been\nprovisioned.", +"", +"The certificate management is working. GCP will attempt to provision\nthe first certificate.", +"Certificate provisioning failed due to an issue with the DNS\nor load balancing configuration.\nFor details of which domain failed, consult domain_status field.", +"Certificate provisioning failed due to an issue with the DNS\nor load balancing configuration. It won't be retried. To try again\ndelete and create a new managed SslCertificate resource.\nFor details of which domain failed, consult domain_status field.", +"Renewal of the certificate has failed due to an issue with the DNS\nor load balancing configuration. The existing cert is still serving;\nhowever, it will expire shortly. To provision a renewed certificate,\ndelete and create a new managed SslCertificate resource.\nFor details on which domain failed, consult domain_status field." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"SslCertificateSelfManagedSslCertificate": { +"description": "Configuration and status of a self-managed SSL certificate.", +"id": "SslCertificateSelfManagedSslCertificate", +"properties": { +"certificate": { +"description": "A local certificate file. The certificate must be in\nPEM format. The certificate chain must be no greater than 5 certs\nlong. The chain must include at least one intermediate cert.", +"type": "string" +}, +"privateKey": { +"description": "A write-only private key in PEM format. Only insert\nrequests will include this field.", +"type": "string" +} +}, +"type": "object" +}, +"SslCertificatesScopedList": { +"id": "SslCertificatesScopedList", +"properties": { +"sslCertificates": { +"description": "List of SslCertificates contained in this scope.", +"items": { +"$ref": "SslCertificate" +}, +"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.", +"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" +}, +"SslPoliciesAggregatedList": { +"id": "SslPoliciesAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "SslPoliciesScopedList", +"description": "Name of the scope containing this set of SSL policies." +}, +"description": "A list of SslPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#sslPoliciesAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies.", +"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" +}, +"SslPoliciesList": { +"id": "SslPoliciesList", +"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 SslPolicy resources.", +"items": { +"$ref": "SslPolicy" +}, +"readOnly": true, +"type": "array" +}, +"kind": { +"default": "compute#sslPoliciesList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies.", +"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" +}, +"SslPoliciesListAvailableFeaturesResponse": { +"id": "SslPoliciesListAvailableFeaturesResponse", +"properties": { +"features": { +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SslPoliciesScopedList": { +"id": "SslPoliciesScopedList", +"properties": { +"sslPolicies": { +"description": "A list of SslPolicies contained in this scope.", +"items": { +"$ref": "SslPolicy" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nSSL policies 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.", +"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" +}, +"SslPolicy": { +"description": "Represents an SSL Policy resource.\n\nUse SSL policies to control SSL features, such as versions and cipher\nsuites, that are offered by Application Load Balancers and proxy Network Load\nBalancers. For more information, read \nSSL policies overview.", +"id": "SslPolicy", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"customFeatures": { +"description": "A list of features enabled when the selected profile is CUSTOM. The\n method returns the set of features that can be\nspecified in this list. This field must be empty if the profile is notCUSTOM.", +"items": { +"type": "string" +}, +"type": "array" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"enabledFeatures": { +"description": "Output only. [Output Only] The list of features enabled in the SSL policy.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"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 SslPolicy. An up-to-date fingerprint must be\nprovided in order to update the SslPolicy, otherwise the\nrequest will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an SslPolicy.", +"format": "byte", +"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#sslPolicy", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.", +"readOnly": true, +"type": "string" +}, +"minTlsVersion": { +"description": "The minimum version of SSL protocol that can be used by the clients to\nestablish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field\nmust be set to RESTRICTED.", +"enum": [ +"TLS_1_0", +"TLS_1_1", +"TLS_1_2", +"TLS_1_3" +], +"enumDescriptions": [ +"TLS 1.0", +"TLS 1.1", +"TLS 1.2", +"TLS 1.3" +], +"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" +}, +"postQuantumKeyExchange": { +"description": "One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates\nX25519MLKEM768 key exchange when clients advertise support for it. When set\nto DEFAULT, or if no SSL Policy is attached to the target\nproxy, the load balancer disallows X25519MLKEM768 key exchange before\nOctober 2026, and allows it afterward. When set to ENABLED,\nthe load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key\nexchange until October 2027, and allows it afterward.", +"enum": [ +"DEFAULT", +"DEFERRED", +"ENABLED" +], +"enumDescriptions": [ +"Default behavior: disabled until October 2026, enabled afterward.", +"Disabled until October 2027, enabled afterward.", +"Enabled now." +], +"type": "string" +}, +"profile": { +"description": "Profile specifies the set of SSL features that can be used by the load\nbalancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in\nthe customFeatures field. If using FIPS_202205,\nthe min_tls_version field must be set to TLS_1_2.", +"enum": [ +"COMPATIBLE", +"CUSTOM", +"FIPS_202205", +"MODERN", +"RESTRICTED" +], +"enumDescriptions": [ +"Compatible profile. Allows the broadset set of clients, even those which\nsupport only out-of-date SSL features to negotiate with the load\nbalancer.", +"Custom profile. Allow only the set of allowed SSL features specified in\nthe customFeatures field.", +"FIPS compatible profile. Supports a reduced set of SSL features,\nintended to meet FIPS 140-3 compliance requirements.", +"Modern profile. Supports a wide set of SSL features, allowing modern\nclients to negotiate SSL with the load balancer.", +"Restricted profile. Supports a reduced set of SSL features, intended to\nmeet stricter compliance requirements." +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional SSL policy\nresides. This field is not applicable to global SSL policies.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"warnings": { +"description": "Output only. [Output Only] If potential misconfigurations are detected for this\nSSL policy, this field will be populated with warning messages.", +"items": { +"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" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"SslPolicyReference": { +"id": "SslPolicyReference", +"properties": { +"sslPolicy": { +"type": "string" +} +}, +"type": "object" +}, +"StatefulPolicy": { +"id": "StatefulPolicy", +"properties": { +"preservedState": { +"$ref": "StatefulPolicyPreservedState" +} +}, +"type": "object" +}, +"StatefulPolicyPreservedState": { +"description": "Configuration of preserved resources.", +"id": "StatefulPolicyPreservedState", +"properties": { +"disks": { +"additionalProperties": { +"$ref": "StatefulPolicyPreservedStateDiskDevice" +}, +"description": "Disks created on the instances that will be preserved on instance\ndelete, update, etc. This map is keyed with the device names of\nthe disks.", +"type": "object" +}, +"externalIPs": { +"additionalProperties": { +"$ref": "StatefulPolicyPreservedStateNetworkIp" +}, +"description": "External network IPs assigned to the instances that will be preserved on\ninstance delete, update, etc. This map is keyed with the network\ninterface name.", +"type": "object" +}, +"internalIPs": { +"additionalProperties": { +"$ref": "StatefulPolicyPreservedStateNetworkIp" +}, +"description": "Internal network IPs assigned to the instances that will be preserved on\ninstance delete, update, etc. This map is keyed with the network\ninterface name.", +"type": "object" +} +}, +"type": "object" +}, +"StatefulPolicyPreservedStateDiskDevice": { +"id": "StatefulPolicyPreservedStateDiskDevice", +"properties": { +"autoDelete": { +"description": "These stateful disks will never be deleted during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the disk should be deleted after it\nis no longer used by the group, e.g. when the given instance or\nthe whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.", +"enum": [ +"NEVER", +"ON_PERMANENT_INSTANCE_DELETION" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"StatefulPolicyPreservedStateNetworkIp": { +"id": "StatefulPolicyPreservedStateNetworkIp", +"properties": { +"autoDelete": { +"description": "These stateful IPs will never be released during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the IP reservation should be deleted\nafter it is no longer used by the group, e.g. when the given instance\nor the whole group is deleted.", +"enum": [ +"NEVER", +"ON_PERMANENT_INSTANCE_DELETION" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"Status": { +"description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", +"id": "Status", +"properties": { +"code": { +"description": "The status code, which should be an enum value of google.rpc.Code.", +"format": "int32", +"type": "integer" +}, +"details": { +"description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", +"items": { +"additionalProperties": { +"description": "Properties of the object. Contains field @type with type URL.", +"type": "any" +}, +"format": "google.protobuf.Any", +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", +"type": "string" +} +}, +"type": "object" +}, +"StoragePool": { +"description": "Represents a zonal storage pool resource.", +"id": "StoragePool", +"properties": { +"capacityProvisioningType": { +"description": "Provisioning type of the byte capacity of the pool.", +"enum": [ +"ADVANCED", +"STANDARD", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Advanced provisioning \"thinly\" allocates the related resource.", +"Standard provisioning allocates the related resource for the pool\ndisks' exclusive use.", +"" +], +"type": "string" +}, +"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" +}, +"exapoolProvisionedCapacityGb": { +"$ref": "StoragePoolExapoolProvisionedCapacityGb", +"description": "Provisioned capacities for each SKU for this Exapool in GiB" +}, +"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#storagePool", +"description": "Output only. [Output Only] Type of the resource. Always compute#storagePool\nfor storage pools.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this storage pool, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a storage pool.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels to apply to this storage pool. These can be later modified by\nthe setLabels method.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.storagePools.insert" +] +}, +"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])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"params": { +"$ref": "StoragePoolParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"performanceProvisioningType": { +"description": "Provisioning type of the performance-related parameters of the pool,\nsuch as throughput and IOPS.", +"enum": [ +"ADVANCED", +"STANDARD", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Advanced provisioning \"thinly\" allocates the related resource.", +"Standard provisioning allocates the related resource for the pool\ndisks' exclusive use.", +"" +], +"type": "string" +}, +"poolProvisionedCapacityGb": { +"annotations": { +"required": [ +"compute.storagePools.insert" +] +}, +"description": "Size of the storage pool in GiB. For more information about the size\nlimits, see https://cloud.google.com/compute/docs/disks/storage-pools.", +"format": "int64", +"type": "string" +}, +"poolProvisionedIops": { +"description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool\ntype is hyperdisk-balanced.", +"format": "int64", +"type": "string" +}, +"poolProvisionedThroughput": { +"description": "Provisioned throughput of the storage pool in MiB/s. Only relevant if the\nstorage pool type is hyperdisk-balanced or hyperdisk-throughput.", +"format": "int64", +"type": "string" +}, +"resourceStatus": { +"$ref": "StoragePoolResourceStatus", +"description": "Output only. [Output Only] Status information for the storage pool resource.", +"readOnly": true +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"shareSettings": { +"$ref": "StoragePoolShareSettings", +"description": "Share settings for the storage pool." +}, +"state": { +"description": "Output only. [Output Only] The status of storage pool creation.\n \n \n - CREATING: Storage pool is provisioning.\n storagePool.\n - FAILED: Storage pool creation failed.\n - READY: Storage pool is ready for use.\n - DELETING: Storage pool is deleting.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY" +], +"enumDescriptions": [ +"StoragePool is provisioning", +"StoragePool is deleting.", +"StoragePool creation failed.", +"StoragePool is ready for use." +], +"readOnly": true, +"type": "string" +}, +"status": { +"$ref": "StoragePoolResourceStatus", +"description": "Output only. [Output Only] Status information for the storage pool resource.", +"readOnly": true +}, +"storagePoolType": { +"description": "Type of the storage pool.", +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the storage pool resides.\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" +} +}, +"type": "object" +}, +"StoragePoolAggregatedList": { +"id": "StoragePoolAggregatedList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "StoragePoolsScopedList", +"description": "[Output Only] Name of the scope containing this set of storage pool." +}, +"description": "A list of StoragePoolsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#storagePoolAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of\nstorage pools.", +"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" +}, +"StoragePoolDisk": { +"id": "StoragePoolDisk", +"properties": { +"attachedInstances": { +"description": "Output only. [Output Only] Instances this disk is attached to.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"disk": { +"description": "Output only. [Output Only] The URL of the disk.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Output only. [Output Only] The name of the disk.", +"readOnly": true, +"type": "string" +}, +"provisionedIops": { +"description": "Output only. [Output Only] The number of IOPS provisioned for the disk.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"provisionedThroughput": { +"description": "Output only. [Output Only] The throughput provisioned for the disk.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"resourcePolicies": { +"description": "Output only. [Output Only] Resource policies applied to disk for automatic snapshot\ncreations.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"sizeGb": { +"description": "Output only. [Output Only] The disk size, in GB.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"status": { +"description": "Output only. [Output Only] The disk status.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY", +"RESTORING", +"UNAVAILABLE" +], +"enumDescriptions": [ +"Disk is provisioning", +"Disk is deleting.", +"Disk creation failed.", +"Disk is ready for use.", +"Source data is being copied into the disk.", +"Disk is currently unavailable and cannot be accessed, attached or\ndetached." +], +"readOnly": true, +"type": "string" +}, +"type": { +"description": "Output only. [Output Only] The disk type.", +"readOnly": true, +"type": "string" +}, +"usedBytes": { +"description": "Output only. [Output Only] Amount of disk space used.", +"format": "int64", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"StoragePoolExapoolProvisionedCapacityGb": { +"description": "Exapool provisioned capacities for each SKU type", +"id": "StoragePoolExapoolProvisionedCapacityGb", +"properties": { +"capacityOptimized": { +"description": "Size, in GiB, of provisioned capacity-optimized capacity for this Exapool", +"format": "int64", +"type": "string" +}, +"readOptimized": { +"description": "Size, in GiB, of provisioned read-optimized capacity for this Exapool", +"format": "int64", +"type": "string" +}, +"writeOptimized": { +"description": "Size, in GiB, of provisioned write-optimized capacity for this Exapool", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"StoragePoolList": { +"description": "A list of StoragePool resources.", +"id": "StoragePoolList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of StoragePool resources.", +"items": { +"$ref": "StoragePool" +}, +"type": "array" +}, +"kind": { +"default": "compute#storagePoolList", +"description": "Output only. [Output Only] Type of resource. Always compute#storagePoolList\nfor lists of storagePools.", +"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" +}, +"StoragePoolListDisks": { +"id": "StoragePoolListDisks", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "A list of StoragePoolDisk resources.", +"items": { +"$ref": "StoragePoolDisk" +}, +"type": "array" +}, +"kind": { +"default": "compute#storagePoolListDisks", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a\nstoragePool.", +"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" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "Output only. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"StoragePoolParams": { +"description": "Additional storage pool params.", +"id": "StoragePoolParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the storage pool. 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/{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" +}, +"StoragePoolResourceStatus": { +"description": "[Output Only] Contains output only fields.", +"id": "StoragePoolResourceStatus", +"properties": { +"diskCount": { +"description": "[Output Only] Number of disks used.", +"format": "int64", +"type": "string" +}, +"exapoolMaxReadIops": { +"description": "Output only. [Output Only] Maximum allowed read IOPS for this Exapool.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"exapoolMaxReadThroughput": { +"description": "Output only. [Output Only] Maximum allowed read throughput in MiB/s for\nthis Exapool.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"exapoolMaxWriteIops": { +"description": "Output only. [Output Only] Maximum allowed write IOPS for this Exapool.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"exapoolMaxWriteThroughput": { +"description": "Output only. [Output Only] Maximum allowed write throughput in MiB/s\nfor this Exapool.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"lastResizeTimestamp": { +"description": "Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.", +"readOnly": true, +"type": "string" +}, +"maxTotalProvisionedDiskCapacityGb": { +"description": "[Output Only] Maximum allowed aggregate disk size in GiB.", +"format": "int64", +"type": "string" +}, +"poolUsedCapacityBytes": { +"description": "[Output Only] Space used by data stored in disks within the storage pool\n(in bytes). This will reflect the total number of bytes written to the\ndisks in the pool, in contrast to the capacity of those disks.", +"format": "int64", +"type": "string" +}, +"poolUsedIops": { +"description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount\nthat is allowed per disk that is not counted towards pool's IOPS\ncapacity. For more information, see\nhttps://cloud.google.com/compute/docs/disks/storage-pools.", +"format": "int64", +"type": "string" +}, +"poolUsedThroughput": { +"description": "[Output Only] Sum of all the disks' provisioned throughput in MiB/s.", +"format": "int64", +"type": "string" +}, +"poolUserWrittenBytes": { +"description": "[Output Only] Amount of data written into the pool, before it is\ncompacted.", +"format": "int64", +"type": "string" +}, +"totalProvisionedDiskCapacityGb": { +"description": "[Output Only] Sum of all the disks' provisioned capacity (in GiB) in\nthis storage pool. A disk's provisioned capacity is the same as its total\ncapacity.", +"format": "int64", +"type": "string" +}, +"totalProvisionedDiskIops": { +"description": "[Output Only] Sum of all the disks' provisioned IOPS.", +"format": "int64", +"type": "string" +}, +"totalProvisionedDiskThroughput": { +"description": "[Output Only] Sum of all the disks' provisioned throughput in MiB/s,\nminus some amount that is allowed per disk that is not counted towards\npool's throughput capacity.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"StoragePoolShareSettings": { +"description": "Share settings for the storage pool.", +"id": "StoragePoolShareSettings", +"properties": { +"projectMap": { +"additionalProperties": { +"$ref": "StoragePoolShareSettingsProjectConfig" +}, +"description": "A map of project id and project config.", +"type": "object" +} +}, +"type": "object" +}, +"StoragePoolShareSettingsProjectConfig": { +"description": "Config for each project in the share settings.", +"id": "StoragePoolShareSettingsProjectConfig", +"properties": { +"projectId": { +"description": "The project ID, should be same as the key of this project config in the\nparent map.", +"type": "string" +} +}, +"type": "object" +}, +"StoragePoolType": { +"id": "StoragePoolType", +"properties": { +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this storage pool\ntype." +}, +"description": { +"description": "[Output Only] An optional description of this resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#storagePoolType", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types.", +"readOnly": true, +"type": "string" +}, +"maxPoolProvisionedCapacityGb": { +"description": "[Output Only] Maximum storage pool size in GB.", +"format": "int64", +"type": "string" +}, +"maxPoolProvisionedIops": { +"description": "[Output Only] Maximum provisioned IOPS.", +"format": "int64", +"type": "string" +}, +"maxPoolProvisionedThroughput": { +"description": "[Output Only] Maximum provisioned throughput.", +"format": "int64", +"type": "string" +}, +"minPoolProvisionedCapacityGb": { +"description": "[Output Only] Minimum storage pool size in GB.", +"format": "int64", +"type": "string" +}, +"minPoolProvisionedIops": { +"description": "[Output Only] Minimum provisioned IOPS.", +"format": "int64", +"type": "string" +}, +"minPoolProvisionedThroughput": { +"description": "[Output Only] Minimum provisioned throughput.", +"format": "int64", +"type": "string" +}, +"minSizeGb": { +"description": "[Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb\ninstead.", +"format": "int64", +"type": "string" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", +"readOnly": true, +"type": "string" +}, +"supportedDiskTypes": { +"description": "[Output Only] The list of disk types supported in this storage pool type.", +"items": { +"type": "string" +}, +"type": "array" +}, +"zone": { +"description": "[Output Only] URL of the zone where the storage pool type 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" +} +}, +"type": "object" +}, +"StoragePoolTypeAggregatedList": { +"id": "StoragePoolTypeAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "StoragePoolTypesScopedList", +"description": "[Output Only] Name of the scope containing this set of storage pool types." +}, +"description": "A list of StoragePoolTypesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#storagePoolTypeAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList.", +"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.", +"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" +}, +"StoragePoolTypeList": { +"description": "Contains a list of storage pool types.", +"id": "StoragePoolTypeList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of StoragePoolType resources.", +"items": { +"$ref": "StoragePoolType" +}, +"type": "array" +}, +"kind": { +"default": "compute#storagePoolTypeList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types.", +"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.", +"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" +}, +"StoragePoolTypesScopedList": { +"id": "StoragePoolTypesScopedList", +"properties": { +"storagePoolTypes": { +"description": "[Output Only] A list of storage pool types contained in this scope.", +"items": { +"$ref": "StoragePoolType" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of storage pool\ntypes 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.", +"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" +}, +"StoragePoolsScopedList": { +"id": "StoragePoolsScopedList", +"properties": { +"storagePools": { +"description": "[Output Only] A list of storage pool contained in this scope.", +"items": { +"$ref": "StoragePool" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of storage pool\nwhen 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.", +"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" +}, +"Subnetwork": { +"description": "Represents a Subnetwork resource.\n\nA subnetwork (also known as a subnet) is a logical partition of a Virtual\nPrivate Cloud network with one primary IP range and zero or more secondary\nIP ranges. For more information, read\nVirtual Private Cloud (VPC) Network.", +"id": "Subnetwork", +"properties": { +"allowSubnetCidrRoutesOverlap": { +"description": "Whether this subnetwork's ranges can conflict with existing custom routes.\nSetting this to true allows this subnetwork's primary and secondary ranges\nto overlap with (and contain) custom routes that have already been\nconfigured on the corresponding network.\n\nFor example if a static route has range 10.1.0.0/16, a subnet\nrange 10.0.0.0/8 could only be created if allow_conflicting_routes=true.\n\nOverlapping is only allowed on subnetwork operations; routes\nwhose ranges conflict with this subnetwork's ranges won't be allowed unless\nroute.allow_conflicting_subnetworks is set to true.\n\nTypically packets destined to IPs within the subnetwork (which may contain\nprivate/sensitive data) are prevented from leaving the virtual network.\nSetting this field to true will disable this feature.\n\nThe default value is false and applies to all existing subnetworks and\nautomatically created subnetworks.", +"type": "boolean" +}, +"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. This field can be set only at resource creation time.", +"type": "string" +}, +"enableFlowLogs": { +"description": "Whether to enable flow logging for this subnetwork. If this field is not\nexplicitly set, it will not appear in get listings. If not set\nthe default behavior is determined by the org policy, if there is no org\npolicy specified, then it will default to disabled. This field isn't\nsupported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.", +"type": "boolean" +}, +"externalIpv6Prefix": { +"description": "The external IPv6 address range that is owned by this\nsubnetwork.", +"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 Subnetwork. An up-to-date fingerprint must be\nprovided in order to update the Subnetwork, otherwise the\nrequest will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a Subnetwork.", +"format": "byte", +"type": "string" +}, +"gatewayAddress": { +"description": "Output only. [Output Only] The gateway address for default routes to reach destination\naddresses outside this subnetwork.", +"readOnly": true, +"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" +}, +"internalIpv6Prefix": { +"description": "The internal IPv6 address range that is owned by this\nsubnetwork.", +"type": "string" +}, +"ipCidrRange": { +"description": "The range of internal addresses that are owned by this subnetwork.\nProvide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must\nbe unique and non-overlapping within a network. Only IPv4 is supported.\nThis field is set at resource creation time. The range can be any range\nlisted in theValid\nranges list. The range can be expanded after creation usingexpandIpCidrRange.", +"type": "string" +}, +"ipCollection": { +"description": "Reference to the source of IP, like a PublicDelegatedPrefix\n(PDP) for BYOIP. The PDP must be a sub-PDP in\nEXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION\nmode.\n\nUse one of the following formats to specify a sub-PDP when creating a dual\nstack or IPv6-only subnetwork with external access using BYOIP:\n \n - \n Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - \n Partial URL, as in\n \n \n - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - regions/region/publicDelegatedPrefixes/sub-pdp-name", +"type": "string" +}, +"ipv6AccessType": { +"description": "The access type of IPv6 address this subnet holds. It's immutable and can\nonly be specified during creation or the first time the subnet is updated\ninto IPV4_IPV6 dual stack.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"VMs on this subnet will be assigned IPv6 addresses that are accessible\nvia the Internet, as well as the VPC network.", +"VMs on this subnet will be assigned IPv6 addresses that are only\naccessible over the VPC network." +], +"type": "string" +}, +"ipv6CidrRange": { +"description": "Output only. [Output Only] This field is for internal use.", +"readOnly": true, +"type": "string" +}, +"ipv6GceEndpoint": { +"description": "Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the\nfollowing:\n \n - VM_ONLY: The subnetwork can be used for creating instances and\n IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6\n ranges from a public delegated prefix and cannot be used to create NetLb.\n - VM_AND_FR: The subnetwork can be used for creating both VM\n instances and Forwarding Rules. It can also be used to reserve IPv6\n addresses with both VM and FR endpoint types. Such a subnetwork gets its\n IPv6 range from Google IP Pool directly.", +"enum": [ +"VM_AND_FR", +"VM_ONLY" +], +"enumDescriptions": [ +"", +"" +], +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#subnetwork", +"description": "Output only. [Output Only] Type of the resource. Always compute#subnetwork\nfor Subnetwork resources.", +"readOnly": true, +"type": "string" +}, +"logConfig": { +"$ref": "SubnetworkLogConfig", +"description": "This field denotes the VPC flow logging options for this subnetwork.\nIf logging is enabled, logs are exported to Cloud Logging." +}, +"name": { +"description": "The name of the resource, provided by the client when initially creating\nthe resource. The 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" +}, +"network": { +"description": "The URL of the network to which this subnetwork belongs, provided by the\nclient when initially creating the subnetwork. This field can be set only\nat resource creation time.", +"type": "string" +}, +"params": { +"$ref": "SubnetworkParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, +"privateIpGoogleAccess": { +"description": "Whether the VMs in this subnet can access Google services without assigned\nexternal IP addresses. This field can be both set at resource creation\ntime and updated using setPrivateIpGoogleAccess.", +"type": "boolean" +}, +"privateIpv6GoogleAccess": { +"description": "This field is for internal use.\n\nThis field can be both set at resource creation time and updated usingpatch.", +"enum": [ +"DISABLE_GOOGLE_ACCESS", +"ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", +"ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" +], +"enumDescriptions": [ +"Disable private IPv6 access to/from Google services.", +"Bidirectional private IPv6 access to/from Google services.", +"Outbound private IPv6 access from VMs in this subnet to Google services." +], +"type": "string" +}, +"purpose": { +"enum": [ +"GLOBAL_MANAGED_PROXY", +"INTERNAL_HTTPS_LOAD_BALANCER", +"PEER_MIGRATION", +"PRIVATE", +"PRIVATE_NAT", +"PRIVATE_RFC_1918", +"PRIVATE_SERVICE_CONNECT", +"REGIONAL_MANAGED_PROXY" +], +"enumDescriptions": [ +"Subnet reserved for Global Envoy-based Load Balancing.", +"Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", +"Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", +"Regular user created or automatically created subnet.", +"Subnetwork used as source range for Private NAT Gateways.", +"Regular user created or automatically created subnet.", +"Subnetworks created for Private Service Connect in the producer network.", +"Subnetwork used for Regional Envoy-based Load Balancing." +], +"type": "string" +}, +"region": { +"description": "URL of the region where the Subnetwork resides. This\nfield can be set only at resource creation time.", +"type": "string" +}, +"reservedInternalRange": { +"description": "The URL of the reserved internal range.", +"type": "string" +}, +"resolveSubnetMask": { +"description": "Configures subnet mask resolution for this subnetwork.", +"enum": [ +"ARP_ALL_RANGES", +"ARP_BROADCAST_PRIMARY_RANGE", +"ARP_BROADCAST_PRIMARY_RANGE_WITH_LEARNING", +"ARP_PRIMARY_RANGE" +], +"enumDescriptions": [ +"All ranges assigned to the VM NIC will respond to ARP.", +"VMs will receive an ARP response from a VM instance owning the target IP\naddress within the subnetwork's primary CIDR range, if such a VM instance\nexists and is running.", +"Combines ARP_BROADCAST_PRIMARY_RANGE with MAC learning. Enables cache\nmapping between IP addresses and custom MAC addresses of instances and\nuse of it to set the correct destination MAC address. If this option is\nchosen, the subnetwork must have /24 or a smaller CIDR range.", +"Only the primary range of the VM NIC will respond to ARP." +], +"type": "string" +}, +"role": { +"description": "The role of subnetwork. Currently, this field is only used when\npurpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE\nsubnetwork is one that is currently being used for Envoy-based load\nbalancers in a region. A BACKUP subnetwork is one that is\nready to be promoted to ACTIVE or is currently draining.\nThis field can be updated with a patch request.", +"enum": [ +"ACTIVE", +"BACKUP" +], +"enumDescriptions": [ +"The ACTIVE subnet that is currently used.", +"The BACKUP subnet that could be promoted to ACTIVE." +], +"type": "string" +}, +"secondaryIpRanges": { +"description": "An array of configurations for secondary IP ranges for VM instances\ncontained in this subnetwork. The primary IP of such VM must belong to the\nprimary ipCidrRange of the subnetwork. The alias IPs may belong to either\nprimary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.", +"items": { +"$ref": "SubnetworkSecondaryRange" +}, +"type": "array" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"stackType": { +"description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs\nin the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and\nIPv6 addresses. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at resource creation time and updated usingpatch.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"New VMs in this subnet can have both IPv4 and IPv6 addresses.", +"New VMs in this subnet will only be assigned IPv4 addresses.", +"New VMs in this subnet will only be assigned IPv6 addresses." +], +"type": "string" +}, +"state": { +"description": "Output only. [Output Only] The state of the subnetwork, which can be one of the\nfollowing values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the\npurpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that\nconnections to the load balancer are being drained. A subnetwork that is\ndraining cannot be used or modified until it reaches a status ofREADY", +"enum": [ +"DRAINING", +"READY" +], +"enumDescriptions": [ +"Subnetwork is being drained.", +"Subnetwork is ready for use." +], +"readOnly": true, +"type": "string" +}, +"systemReservedExternalIpv6Ranges": { +"description": "Output only. [Output Only] The array of external IPv6 network ranges reserved from\nthe subnetwork's external IPv6 range for system use.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"systemReservedInternalIpv6Ranges": { +"description": "Output only. [Output Only] The array of internal IPv6 network ranges reserved from\nthe subnetwork's internal IPv6 range for system use.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"utilizationDetails": { +"$ref": "SubnetworkUtilizationDetails", +"description": "Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains\nthe total number of allocated and free IPs in each range.", +"readOnly": true +} +}, +"type": "object" +}, +"SubnetworkAggregatedList": { +"id": "SubnetworkAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "SubnetworksScopedList", +"description": "Name of the scope containing this set of Subnetworks." +}, +"description": "A list of SubnetworksScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#subnetworkAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of\nsubnetworks.", +"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" +}, +"SubnetworkList": { +"description": "Contains a list of Subnetwork resources.", +"id": "SubnetworkList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Subnetwork resources.", +"items": { +"$ref": "Subnetwork" +}, +"type": "array" +}, +"kind": { +"default": "compute#subnetworkList", +"description": "Output only. [Output Only] Type of resource. Always compute#subnetworkList\nfor lists of subnetworks.", +"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.", +"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" +}, +"SubnetworkLogConfig": { +"description": "The available logging options for this subnetwork.", +"id": "SubnetworkLogConfig", +"properties": { +"aggregationInterval": { +"description": "Can only be specified if VPC flow logging for this subnetwork is enabled.\nToggles the aggregation interval for collecting flow logs. Increasing the\ninterval time will reduce the amount of generated flow logs for long\nlasting connections. Default is an interval of 5 seconds per connection.", +"enum": [ +"INTERVAL_10_MIN", +"INTERVAL_15_MIN", +"INTERVAL_1_MIN", +"INTERVAL_30_SEC", +"INTERVAL_5_MIN", +"INTERVAL_5_SEC" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"enable": { +"description": "Whether to enable flow logging for this subnetwork. If this field is not\nexplicitly set, it will not appear in get listings. If not\nset the default behavior is determined by the org policy, if there is no\norg policy specified, then it will default to disabled.\nFlow logging isn't supported if the subnet purpose field is\nset to REGIONAL_MANAGED_PROXY.", +"type": "boolean" +}, +"filterExpr": { +"description": "Can only be specified if VPC flow logs for this subnetwork is enabled.\nThe filter expression is used to define which VPC flow logs should be\nexported to Cloud Logging.", +"type": "string" +}, +"flowSampling": { +"description": "Can only be specified if VPC flow logging for this subnetwork is enabled.\nThe value of the field must be in [0, 1]. Set the sampling rate of VPC\nflow logs within the subnetwork where 1.0 means all collected logs are\nreported and 0.0 means no logs are reported. Default is 0.5 unless\notherwise specified by the org policy, which means half of all collected\nlogs are reported.", +"format": "float", +"type": "number" +}, +"metadata": { +"description": "Can only be specified if VPC flow logs for this subnetwork is enabled.\nConfigures whether all, none or a subset of metadata fields should be\nadded to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.", +"enum": [ +"CUSTOM_METADATA", +"EXCLUDE_ALL_METADATA", +"INCLUDE_ALL_METADATA" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"metadataFields": { +"description": "Can only be specified if VPC flow logs for this subnetwork is enabled and\n\"metadata\" was set to CUSTOM_METADATA.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"SubnetworkParams": { +"description": "Additional subnetwork parameters.", +"id": "SubnetworkParams", +"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.", +"type": "object" +} +}, +"type": "object" +}, +"SubnetworkSecondaryRange": { +"description": "Represents a secondary IP range of a subnetwork.", +"id": "SubnetworkSecondaryRange", +"properties": { +"ipCidrRange": { +"description": "The range of IP addresses belonging to this subnetwork secondary range.\nProvide this property when you create the subnetwork. Ranges must be\nunique and non-overlapping with all primary and secondary IP ranges\nwithin a network. Both IPv4 and IPv6 ranges are supported. For IPv4,\nthe range can be any range listed in theValid\nranges list.\n\nFor IPv6:\nThe range must have a /64 prefix length.\nThe range must be omitted, for auto-allocation from Google-defined ULA\nIPv6 range.\nFor BYOGUA internal IPv6 secondary range, the range may be specified\nalong with the `ipCollection` field.\nIf an `ipCollection` is specified, the requested ip_cidr_range must lie\nwithin the range of the PDP referenced by the `ipCollection` field for\nallocation.\nIf `ipCollection` field is specified, but ip_cidr_range is not,\nthe range is auto-allocated from the PDP referenced by the `ipCollection`\nfield.", +"type": "string" +}, +"ipCollection": { +"description": "Reference to a Public Delegated Prefix (PDP) for BYOIP.\nThis field should be specified for configuring BYOGUA internal IPv6\nsecondary range.\nWhen specified along with the ip_cidr_range, the ip_cidr_range must lie\nwithin the PDP referenced by the `ipCollection` field.\nWhen specified without the ip_cidr_range, the range is auto-allocated\nfrom the PDP referenced by the `ipCollection` field.", +"type": "string" +}, +"ipVersion": { +"enum": [ +"IPV4", +"IPV6", +"IP_VERSION_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"Treated as IPV4 for backward-compatibility." +], +"type": "string" +}, +"rangeName": { +"description": "The name associated with this subnetwork secondary range, used when adding\nan alias IP/IPv6 range to a VM instance.\nThe name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the subnetwork.", +"type": "string" +}, +"reservedInternalRange": { +"description": "The URL of the reserved internal range. Only IPv4 is supported.", +"type": "string" +} +}, +"type": "object" +}, +"SubnetworkUtilizationDetails": { +"description": "The current IP utilization of all subnetwork ranges. Contains the total\nnumber of allocated and free IPs in each range.", +"id": "SubnetworkUtilizationDetails", +"properties": { +"externalIpv6InstanceUtilization": { +"$ref": "SubnetworkUtilizationDetailsIPV6Utilization", +"description": "Utilizations of external IPV6 IP range." +}, +"externalIpv6LbUtilization": { +"$ref": "SubnetworkUtilizationDetailsIPV6Utilization", +"description": "Utilizations of external IPV6 IP range for NetLB." +}, +"internalIpv6Utilization": { +"$ref": "SubnetworkUtilizationDetailsIPV6Utilization", +"description": "Utilizations of internal IPV6 IP range." +}, +"ipv4Utilizations": { +"description": "Utilizations of all IPV4 IP ranges. For primary ranges, the range name\nwill be empty.", +"items": { +"$ref": "SubnetworkUtilizationDetailsIPV4Utilization" +}, +"type": "array" +} +}, +"type": "object" +}, +"SubnetworkUtilizationDetailsIPV4Utilization": { +"description": "The IPV4 utilization of a single IP range.", +"id": "SubnetworkUtilizationDetailsIPV4Utilization", +"properties": { +"rangeName": { +"description": "Will be set for secondary range. Empty for primary IPv4 range.", +"type": "string" +}, +"totalAllocatedIp": { +"format": "int64", +"type": "string" +}, +"totalFreeIp": { +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"SubnetworkUtilizationDetailsIPV6Utilization": { +"description": "The IPV6 utilization of a single IP range.", +"id": "SubnetworkUtilizationDetailsIPV6Utilization", +"properties": { +"totalAllocatedIp": { +"$ref": "Uint128" +}, +"totalFreeIp": { +"$ref": "Uint128" +} +}, +"type": "object" +}, +"SubnetworksExpandIpCidrRangeRequest": { +"id": "SubnetworksExpandIpCidrRangeRequest", +"properties": { +"ipCidrRange": { +"description": "The IP (in CIDR format or netmask) of internal addresses that are legal on\nthis Subnetwork. This range should be disjoint from other subnetworks\nwithin this network. This range can only be larger than (i.e. a superset\nof) the range previously defined before the update.", +"type": "string" +} +}, +"type": "object" +}, +"SubnetworksScopedList": { +"id": "SubnetworksScopedList", +"properties": { +"subnetworks": { +"description": "A list of subnetworks contained in this scope.", +"items": { +"$ref": "Subnetwork" +}, +"type": "array" +}, +"warning": { +"description": "An informational warning that appears when the list of addresses\nis 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.", +"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" +}, +"SubnetworksScopedWarning": { +"id": "SubnetworksScopedWarning", +"properties": { +"scopeName": { +"description": "Name of the scope containing this set of Subnetworks.", +"type": "string" +}, +"warning": { +"description": "An informational warning about unreachable scope", +"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" +}, +"SubnetworksSetPrivateIpGoogleAccessRequest": { +"id": "SubnetworksSetPrivateIpGoogleAccessRequest", +"properties": { +"privateIpGoogleAccess": { +"type": "boolean" +} +}, +"type": "object" +}, +"Subsetting": { +"description": "Subsetting configuration for this BackendService.\nCurrently this is applicable only for Internal TCP/UDP load balancing,\nInternal HTTP(S) load balancing and Traffic Director.", +"id": "Subsetting", +"properties": { +"policy": { +"enum": [ +"CONSISTENT_HASH_SUBSETTING", +"NONE" +], +"enumDescriptions": [ +"Subsetting based on consistent hashing.\n\nFor Traffic Director, the number of backends per backend group\n(the subset size) is based on the `subset_size` parameter.\n\nFor Internal HTTP(S) load balancing, the number of backends per backend\ngroup (the subset size) is dynamically adjusted in two cases:\n- As the number of proxy instances participating in Internal HTTP(S) load\n balancing increases, the subset size decreases.\n- When the total number of backends in a network exceeds the capacity of\n a single proxy instance, subset sizes are reduced automatically for\n each service that has backend subsetting enabled.", +"No Subsetting.\n\nClients may open connections and send traffic to all backends of this\nbackend service. This can lead to performance issues if there is\nsubstantial imbalance in the count of clients and backends." +], +"type": "string" +} +}, +"type": "object" +}, +"TCPHealthCheck": { +"id": "TCPHealthCheck", +"properties": { +"port": { +"description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 80. Valid values are 1 through65535.", +"format": "int32", +"type": "integer" +}, +"portName": { +"description": "Not supported.", +"type": "string" +}, +"portSpecification": { +"description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \nUSE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", +"enum": [ +"USE_FIXED_PORT", +"USE_NAMED_PORT", +"USE_SERVING_PORT" +], +"enumDescriptions": [ +"The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", +"Not supported.", +"For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." +], +"type": "string" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"request": { +"description": "Instructs the health check prober to send this exact ASCII string, up to\n1024 bytes in length, after establishing the TCP connection.", +"type": "string" +}, +"response": { +"description": "Creates a content-based TCP health check. In addition to establishing a\nTCP connection, you can configure the health check to pass only when the\nbackend sends this exact response ASCII string, up to 1024 bytes in length.\nFor details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", +"type": "string" +} +}, +"type": "object" +}, +"Tags": { +"description": "A set of instance tags.", +"id": "Tags", +"properties": { +"fingerprint": { +"description": "Specifies a fingerprint for this request, which is essentially a hash of\nthe tags' contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update tags. You must always provide an\nup-to-date fingerprint hash in order to update or change tags.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", +"format": "byte", +"type": "string" +}, +"items": { +"description": "An array of tags. Each tag must be 1-63 characters long, and comply\nwith RFC1035.", +"items": { +"type": "string" +}, +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "array" +} +}, +"type": "object" +}, +"TargetGrpcProxy": { +"description": "Represents a Target gRPC Proxy resource.\n\nA target gRPC proxy is a component of load balancers intended for\nload balancing gRPC traffic. Only global forwarding rules with load balancing\nscheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target\ngRPC Proxy references a URL map that specifies how traffic is routed to\ngRPC backend services.", +"id": "TargetGrpcProxy", +"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 TargetGrpcProxy. An up-to-date fingerprint must\nbe provided in order to patch/update the TargetGrpcProxy; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nTargetGrpcProxy.", +"format": "byte", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#targetGrpcProxy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.", +"readOnly": true, +"type": "string" +}, +"name": { +"annotations": { +"required": [ +"compute.targetGrpcProxies.insert" +] +}, +"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" +}, +"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 with id for the resource.", +"readOnly": true, +"type": "string" +}, +"urlMap": { +"description": "URL to the UrlMap resource that defines the mapping from URL to the\nBackendService. The protocol field in the BackendService must be set to\nGRPC.", +"type": "string" +}, +"validateForProxyless": { +"description": "If true, indicates that the BackendServices referenced by the urlMap may be\naccessed by gRPC applications without using a sidecar proxy. This will\nenable configuration checks on urlMap and its referenced BackendServices to\nnot allow unsupported features. A gRPC application must use\n\"xds:///\" scheme in the target URI of the service it is\nconnecting to.\nIf false, indicates that the BackendServices referenced by the urlMap will\nbe accessed by gRPC applications via a sidecar proxy. In this case, a gRPC\napplication must not use \"xds:///\" scheme in the target URI of\nthe service it is connecting to", +"type": "boolean" +} +}, +"type": "object" +}, +"TargetGrpcProxyList": { +"id": "TargetGrpcProxyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetGrpcProxy resources.", +"items": { +"$ref": "TargetGrpcProxy" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetGrpcProxyList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.", +"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] Server-defined URL for this resource.", +"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" +}, +"TargetHttpProxiesScopedList": { +"id": "TargetHttpProxiesScopedList", +"properties": { +"targetHttpProxies": { +"description": "A list of TargetHttpProxies contained in this scope.", +"items": { +"$ref": "TargetHttpProxy" +}, +"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.", +"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" +}, +"TargetHttpProxy": { +"description": "Represents a Target HTTP Proxy resource.\n\nGoogle Compute Engine has two Target HTTP Proxy resources:\n\n* [Global](/compute/docs/reference/rest/v1/targetHttpProxies)\n* [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)\n\nA target HTTP proxy is a component of Google Cloud HTTP load balancers.\n\n* targetHttpProxies are used by global external Application Load Balancers,\n classic Application Load Balancers, cross-region internal Application Load\n Balancers, and Traffic Director.\n* regionTargetHttpProxies are used by regional internal Application Load\n Balancers and regional external Application Load Balancers.\n\nForwarding rules reference a target HTTP proxy, and the target proxy\nthen references a URL map. For more information, readUsing Target Proxies\nand \nForwarding rule concepts.", +"id": "TargetHttpProxy", +"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 TargetHttpProxy. An up-to-date fingerprint must\nbe provided in order to patch/update the TargetHttpProxy; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nTargetHttpProxy.", +"format": "byte", +"type": "string" +}, +"httpKeepAliveTimeoutSec": { +"description": "Specifies how long to keep a connection open, after completing a response,\nwhile there is no matching traffic (in seconds). If an HTTP keep-alive is\nnot specified, a default value (610 seconds) will be used.\n\nFor global external Application Load Balancers, the minimum allowed value\nis 5 seconds and the maximum allowed value is 1200 seconds.\n\nFor classic Application Load Balancers, this option is not supported.", +"format": "int32", +"type": "integer" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#targetHttpProxy", +"description": "Output only. [Output Only] Type of resource. Always compute#targetHttpProxy\nfor target HTTP proxies.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"proxyBind": { +"description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", +"type": "boolean" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional Target HTTP Proxy\nresides. This field is not applicable to global Target HTTP Proxies.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"urlMap": { +"description": "URL to the UrlMap resource that defines the mapping from URL to\nthe BackendService.", +"type": "string" +} +}, +"type": "object" +}, +"TargetHttpProxyAggregatedList": { +"id": "TargetHttpProxyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetHttpProxiesScopedList", +"description": "Name of the scope containing this set of TargetHttpProxies." +}, +"description": "A list of TargetHttpProxiesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetHttpProxyAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP\nProxies.", +"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" +} +}, +"type": "object" +}, +"TargetHttpProxyList": { +"description": "A list of TargetHttpProxy resources.", +"id": "TargetHttpProxyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetHttpProxy resources.", +"items": { +"$ref": "TargetHttpProxy" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetHttpProxyList", +"description": "Output only. Type of resource. Always compute#targetHttpProxyList for lists\nof target HTTP proxies.", +"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.", +"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" +}, +"TargetHttpsProxiesScopedList": { +"id": "TargetHttpsProxiesScopedList", +"properties": { +"targetHttpsProxies": { +"description": "A list of TargetHttpsProxies contained in this scope.", +"items": { +"$ref": "TargetHttpsProxy" +}, +"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.", +"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" +}, +"TargetHttpsProxiesSetCertificateMapRequest": { +"id": "TargetHttpsProxiesSetCertificateMapRequest", +"properties": { +"certificateMap": { +"description": "URL of the Certificate Map to associate with this TargetHttpsProxy.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", +"type": "string" +} +}, +"type": "object" +}, +"TargetHttpsProxiesSetQuicOverrideRequest": { +"id": "TargetHttpsProxiesSetQuicOverrideRequest", +"properties": { +"quicOverride": { +"description": "QUIC policy for the TargetHttpsProxy resource.", +"enum": [ +"DISABLE", +"ENABLE", +"NONE" +], +"enumDescriptions": [ +"The load balancer will not attempt to negotiate QUIC with clients.", +"The load balancer will attempt to negotiate QUIC with clients.", +"No overrides to the default QUIC policy. This option is implicit if\nno QUIC override has been specified in the request." +], +"type": "string" +} +}, +"type": "object" +}, +"TargetHttpsProxiesSetSslCertificatesRequest": { +"id": "TargetHttpsProxiesSetSslCertificatesRequest", +"properties": { +"sslCertificates": { +"description": "New set of SslCertificate resources to associate\nwith this TargetHttpsProxy resource. At least one SSL\ncertificate must be specified. Currently, you may specify up to 15 SSL\ncertificates.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetHttpsProxy": { +"description": "Represents a Target HTTPS Proxy resource.\n\nGoogle Compute Engine has two Target HTTPS Proxy resources:\n\n* [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)\n* [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)\n\nA target HTTPS proxy is a component of Google Cloud HTTPS load balancers.\n\n* targetHttpsProxies are used by global external Application Load Balancers,\n classic Application Load Balancers, cross-region internal Application Load\n Balancers, and Traffic Director.\n* regionTargetHttpsProxies are used by regional internal Application Load\n Balancers and regional external Application Load Balancers.\n\nForwarding rules reference a target HTTPS proxy, and the target proxy\nthen references a URL map. For more information, readUsing Target Proxies\nand \nForwarding rule concepts.", +"id": "TargetHttpsProxy", +"properties": { +"authorizationPolicy": { +"description": "Optional. A URL referring to a networksecurity.AuthorizationPolicy resource\nthat describes how the proxy should authorize inbound traffic. If left\nblank, access will not be restricted by an authorization policy.\n\n Refer to the AuthorizationPolicy resource for additional\ndetails.\n\n authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.\n\n Note: This field currently has no impact.", +"type": "string" +}, +"certificateMap": { +"description": "URL of a certificate map that identifies a certificate map associated with\nthe given target proxy.\nThis field can only be set for Global external Application Load Balancer or\nClassic Application Load Balancer. For other products use Certificate\nManager Certificates instead.\n\nIf set, sslCertificates will be ignored.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", +"type": "string" +}, +"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 TargetHttpsProxy. An up-to-date fingerprint must\nbe provided in order to patch the TargetHttpsProxy; otherwise, the request\nwill fail with error 412 conditionNotMet. To see the latest\nfingerprint, make a get() request to retrieve the\nTargetHttpsProxy.", +"format": "byte", +"type": "string" +}, +"httpKeepAliveTimeoutSec": { +"description": "Specifies how long to keep a connection open, after completing a response,\nwhile there is no matching traffic (in seconds). If an HTTP keep-alive is\nnot specified, a default value (610 seconds) will be used.\n\nFor global external Application Load Balancers, the minimum allowed value\nis 5 seconds and the maximum allowed value is 1200 seconds.\n\nFor classic Application Load Balancers, this option is not supported.", +"format": "int32", +"type": "integer" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#targetHttpsProxy", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"proxyBind": { +"description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", +"type": "boolean" +}, +"quicOverride": { +"description": "Specifies the QUIC override policy for this TargetHttpsProxy resource. This\nsetting determines whether the load balancer attempts to negotiate QUIC\nwith clients.\nYou can specify NONE, ENABLE, orDISABLE.\n \n - When quic-override is set to NONE,\n Google manages whether QUIC is used.\n - When quic-override is set to ENABLE, the\n load balancer uses QUIC when possible.\n - When quic-override is set to DISABLE, the\n load balancer doesn't use QUIC.\n - If the quic-override flag is not specified,NONE is implied.", +"enum": [ +"DISABLE", +"ENABLE", +"NONE" +], +"enumDescriptions": [ +"The load balancer will not attempt to negotiate QUIC with clients.", +"The load balancer will attempt to negotiate QUIC with clients.", +"No overrides to the default QUIC policy. This option is implicit if\nno QUIC override has been specified in the request." +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional TargetHttpsProxy\nresides. This field is not applicable to global TargetHttpsProxies.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"serverTlsPolicy": { +"description": "Optional. A URL referring to a networksecurity.ServerTlsPolicy resource\nthat describes how the proxy should authenticate inbound traffic.\n\n serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED\nor EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.\nIt also applies to a regional TargetHttpsProxy attached to\nregional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy\ndocumentation.\n\n If left blank, communications are not encrypted.", +"type": "string" +}, +"sslCertificates": { +"description": "URLs to SslCertificate resources that are used to authenticate\nconnections between users and the load balancer. At least one SSL\ncertificate must be specified. SslCertificates do not apply when the load\nbalancing scheme is set to INTERNAL_SELF_MANAGED.\n\nThe URLs should refer to a SSL Certificate resource or Certificate Manager\nCertificate resource. Mixing Classic Certificates and Certificate Manager\nCertificates is not allowed. Certificate Manager Certificates must include\nthe certificatemanager API namespace. Using Certificate Manager\nCertificates in this field is not supported by Global external Application\nLoad Balancer or Classic Application Load Balancer, use certificate_map\ninstead.\n\nCurrently, you may specify up to 15 Classic SSL Certificates or up to 100\nCertificate Manager Certificates.\n\nCertificate Manager Certificates accepted formats are:\n \n - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.\n - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sslPolicy": { +"description": "URL of SslPolicy resource that will be associated with the TargetHttpsProxy\nresource. If not set, the TargetHttpsProxy resource has no\nSSL policy configured.", +"type": "string" +}, +"tlsEarlyData": { +"description": "Specifies whether TLS 1.3 0-RTT Data (\"Early Data\") should be accepted\nfor this service. Early Data allows a TLS resumption handshake to include\nthe initial application payload (a HTTP request) alongside the handshake,\nreducing the effective round trips to \"zero\". This applies to TLS 1.3\nconnections over TCP (HTTP/2) as well as over UDP (QUIC/h3).\n\n\nThis can improve application performance, especially on networks where\ninterruptions may be common, such as on mobile.\n\n\nRequests with Early Data will have the \"Early-Data\" HTTP header set on\nthe request, with a value of \"1\", to allow the backend to determine whether\nEarly Data was included.\n\n\nNote: TLS Early Data may allow requests to be replayed, as the data is\nsent to the backend before the handshake has fully completed. Applications\nthat allow idempotent HTTP methods to make non-idempotent changes, such as\na GET request updating a database, should not accept Early Data on those\nrequests, and reject requests with the \"Early-Data: 1\" HTTP header by\nreturning a HTTP 425 (Too Early) status code, in order to remain RFC\ncompliant.\n\n\nThe default value is DISABLED.", +"enum": [ +"DISABLED", +"PERMISSIVE", +"STRICT", +"UNRESTRICTED" +], +"enumDescriptions": [ +"TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send\nEarly Data will be rejected by closing the connection.", +"This enables TLS 1.3 0-RTT, and only allows Early Data to be included on\nrequests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode\ndoes not enforce any other limitations for requests with Early Data. The\napplication owner should validate that Early Data is acceptable for a\ngiven request path.", +"This enables TLS 1.3 0-RTT, and only allows Early Data to be included on\nrequests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query\nparameters. Requests that send Early Data with non-idempotent HTTP\nmethods or with query parameters will be rejected with a HTTP 425.", +"This enables TLS 1.3 Early Data for requests with any HTTP method\nincluding non-idempotent methods list POST. This mode does not enforce\nany other limitations. This may be valuable for gRPC use cases. However,\nwe do not recommend this method unless you have evaluated your security\nstance and mitigated the risk of replay attacks using other mechanisms." +], +"type": "string" +}, +"urlMap": { +"description": "A fully-qualified or valid partial URL to the UrlMap resource that defines\nthe mapping from URL to the BackendService. For example, the following are\nall valid URLs for specifying a URL map:\n \n - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map \n - projects/project/global/urlMaps/url-map \n - global/urlMaps/url-map", +"type": "string" +} +}, +"type": "object" +}, +"TargetHttpsProxyAggregatedList": { +"id": "TargetHttpsProxyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetHttpsProxiesScopedList", +"description": "Name of the scope containing this set of TargetHttpsProxies." +}, +"description": "A list of TargetHttpsProxiesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetHttpsProxyAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target\nHTTP Proxies.", +"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" +}, +"TargetHttpsProxyList": { +"description": "Contains a list of TargetHttpsProxy resources.", +"id": "TargetHttpsProxyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetHttpsProxy resources.", +"items": { +"$ref": "TargetHttpsProxy" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetHttpsProxyList", +"description": "Output only. Type of resource. Always compute#targetHttpsProxyList for\nlists of target HTTPS proxies.", +"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.", +"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" +}, +"TargetInstance": { +"description": "Represents a Target Instance resource.\n\nYou can use a target instance to handle traffic for one or more forwarding\nrules, which is ideal for forwarding protocol traffic that is managed by a\nsingle source. For example, ESP, AH, TCP, or UDP.\nFor more information, readTarget\ninstances.", +"id": "TargetInstance", +"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" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"instance": { +"description": "A URL to the virtual machine instance that handles traffic for this target\ninstance. When creating a target instance, you can provide the\nfully-qualified URL or a valid partial URL to the desired virtual machine.\nFor example, the following are all valid URLs:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance \n - zones/zone/instances/instance", +"type": "string" +}, +"kind": { +"default": "compute#targetInstance", +"description": "Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"natPolicy": { +"description": "Must have a value of NO_NAT.\nProtocol forwarding delivers packets while preserving the destination IP\naddress of the forwarding rule referencing the target instance.", +"enum": [ +"NO_NAT" +], +"enumDescriptions": [ +"No NAT performed." +], +"type": "string" +}, +"network": { +"description": "The URL of the network this target instance uses to forward traffic.\nIf not specified, the traffic will be forwarded to the network that\nthe default network interface belongs to.", +"type": "string" +}, +"securityPolicy": { +"description": "[Output Only] The resource URL for the security policy associated with this\ntarget instance.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"zone": { +"description": "Output only. [Output Only] URL of the zone where the target instance resides.\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" +} +}, +"type": "object" +}, +"TargetInstanceAggregatedList": { +"id": "TargetInstanceAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetInstancesScopedList", +"description": "Name of the scope containing this set of target instances." +}, +"description": "A list of TargetInstance resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetInstanceAggregatedList", +"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" +}, +"TargetInstanceList": { +"description": "Contains a list of TargetInstance resources.", +"id": "TargetInstanceList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetInstance resources.", +"items": { +"$ref": "TargetInstance" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetInstanceList", +"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.", +"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" +}, +"TargetInstancesScopedList": { +"id": "TargetInstancesScopedList", +"properties": { +"targetInstances": { +"description": "A list of target instances contained in this scope.", +"items": { +"$ref": "TargetInstance" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of addresses when\nthe 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.", +"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" +}, +"TargetPool": { +"description": "Represents a Target Pool resource.\n\nTarget pools are used with external passthrough Network Load Balancers.\nA target pool references member instances, an associated legacy\nHttpHealthCheck resource, and, optionally, a backup target pool.\nFor more information, readUsing target pools.", +"id": "TargetPool", +"properties": { +"backupPool": { +"description": "The server-defined URL for the resource. This field is applicable only when\nthe containing target pool is serving a forwarding rule as the primary\npool, and its failoverRatio field is properly set to a value\nbetween [0, 1].\nbackupPool and failoverRatio together define\nthe fallback behavior of the primary target pool: if the ratio of the\nhealthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced\nIP will be directed to the backup pool.\n\nIn case where failoverRatio and backupPool\nare not set, or all the instances in the backup pool are unhealthy,\nthe traffic will be directed back to the primary pool in the \"force\"\nmode, where traffic will be spread to the healthy instances with the\nbest effort, or to all instances when no instance is healthy.", +"type": "string" +}, +"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" +}, +"failoverRatio": { +"description": "This field is applicable only when the containing target pool is serving a\nforwarding rule as the primary pool (i.e., not as a backup pool to some\nother target pool). The value of the field must be in [0, 1].\n\nIf set, backupPool must also be set. They together define\nthe fallback behavior of the primary target pool: if the ratio of the\nhealthy instances in the primary pool is at or below this number,\ntraffic arriving at the load-balanced IP will be directed to the\nbackup pool.\n\nIn case where failoverRatio is not set or all the\ninstances in the backup pool are unhealthy, the traffic will be\ndirected back to the primary pool in the \"force\" mode, where traffic\nwill be spread to the healthy instances with the\nbest effort, or to all instances when no instance is healthy.", +"format": "float", +"type": "number" +}, +"healthChecks": { +"description": "The URL of the HttpHealthCheck resource. A member instance in this\npool is considered healthy if and only if the health checks pass.\nOnly legacy HttpHealthChecks are supported. Only one health check may be\nspecified.", +"items": { +"type": "string" +}, +"type": "array" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"instances": { +"description": "A list of resource URLs to the virtual machine instances serving this pool.\nThey must live in zones contained in the same region as this pool.", +"items": { +"type": "string" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetPool", +"description": "Output only. [Output Only] Type of the resource. Always compute#targetPool\nfor target pools.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the target pool resides.", +"readOnly": true, +"type": "string" +}, +"securityPolicy": { +"description": "[Output Only] The resource URL for the security policy associated with this\ntarget pool.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"sessionAffinity": { +"description": "Session affinity option, must be one of the following values: \nNONE: Connections from the same client IP may go to any\n instance in the pool. \nCLIENT_IP: Connections from the same client IP will go\n to the same instance in\n the pool while that instance remains healthy. \nCLIENT_IP_PROTO: Connections from the same client IP\n with the same IP protocol will go to the same instance in the\n pool while that instance remains healthy.", +"enum": [ +"CLIENT_IP", +"CLIENT_IP_NO_DESTINATION", +"CLIENT_IP_PORT_PROTO", +"CLIENT_IP_PROTO", +"GENERATED_COOKIE", +"HEADER_FIELD", +"HTTP_COOKIE", +"NONE", +"STRONG_COOKIE_AFFINITY" +], +"enumDescriptions": [ +"2-tuple hash on packet's source and destination IP addresses. Connections\nfrom the same source IP address to the same destination IP address will be\nserved by the same backend VM while that VM remains healthy.", +"1-tuple hash only on packet's source IP address. Connections from the\nsame source IP address will be served by the same backend VM while that VM\nremains healthy. This option can only be used for Internal TCP/UDP\nLoad Balancing.", +"5-tuple hash on packet's source and destination IP addresses, IP protocol,\nand source and destination ports. Connections for the same IP protocol\nfrom the same source IP address and port to the same destination IP address\nand port will be served by the same backend VM while that VM remains\nhealthy. This option cannot be used for HTTP(S) load balancing.", +"3-tuple hash on packet's source and destination IP addresses, and IP\nprotocol. Connections for the same IP protocol from the same source IP\naddress to the same destination IP address will be served by the same\nbackend VM while that VM remains healthy. This option cannot be used for\nHTTP(S) load balancing.", +"Hash based on a cookie generated by the L7 loadbalancer.\nOnly valid for HTTP(S) load balancing.", +"The hash is based on a user specified header field.", +"The hash is based on a user provided cookie.", +"No session affinity. Connections from the same client IP may go\nto any instance in the pool.", +"Strong cookie-based affinity. Connections bearing the same cookie will be\nserved by the same backend VM while that VM remains healthy, as long as the\ncookie has not expired." +], +"type": "string" +} +}, +"type": "object" +}, +"TargetPoolAggregatedList": { +"id": "TargetPoolAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetPoolsScopedList", +"description": "Name of the scope containing this set of target pools." +}, +"description": "A list of TargetPool resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetPoolAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of\ntarget pools.", +"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" +}, +"TargetPoolInstanceHealth": { +"id": "TargetPoolInstanceHealth", +"properties": { +"healthStatus": { +"items": { +"$ref": "HealthStatus" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetPoolInstanceHealth", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of\nan instance.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"TargetPoolList": { +"description": "Contains a list of TargetPool resources.", +"id": "TargetPoolList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetPool resources.", +"items": { +"$ref": "TargetPool" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetPoolList", +"description": "Output only. [Output Only] Type of resource. Always compute#targetPoolList\nfor lists of target pools.", +"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.", +"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" +}, +"TargetPoolsAddHealthCheckRequest": { +"id": "TargetPoolsAddHealthCheckRequest", +"properties": { +"healthChecks": { +"description": "The HttpHealthCheck to add to the target pool.", +"items": { +"$ref": "HealthCheckReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetPoolsAddInstanceRequest": { +"id": "TargetPoolsAddInstanceRequest", +"properties": { +"instances": { +"description": "A full or partial URL to an instance to add to this target pool. This can\nbe a full or partial URL. For example, the following are valid URLs: \n \n - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name \n - projects/project-id/zones/zone/instances/instance-name \n - zones/zone/instances/instance-name", +"items": { +"$ref": "InstanceReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetPoolsRemoveHealthCheckRequest": { +"id": "TargetPoolsRemoveHealthCheckRequest", +"properties": { +"healthChecks": { +"description": "Health check URL to be removed. This can be a full or valid partial URL.\nFor example, the following are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check \n - projects/project/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", +"items": { +"$ref": "HealthCheckReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetPoolsRemoveInstanceRequest": { +"id": "TargetPoolsRemoveInstanceRequest", +"properties": { +"instances": { +"description": "URLs of the instances to be removed from target pool.", +"items": { +"$ref": "InstanceReference" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetPoolsScopedList": { +"id": "TargetPoolsScopedList", +"properties": { +"targetPools": { +"description": "A list of target pools contained in this scope.", +"items": { +"$ref": "TargetPool" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of addresses when\nthe 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.", +"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" +}, +"TargetReference": { +"id": "TargetReference", +"properties": { +"target": { +"type": "string" +} +}, +"type": "object" +}, +"TargetSslProxiesSetBackendServiceRequest": { +"id": "TargetSslProxiesSetBackendServiceRequest", +"properties": { +"service": { +"description": "The URL of the new BackendService resource for the targetSslProxy.", +"type": "string" +} +}, +"type": "object" +}, +"TargetSslProxiesSetCertificateMapRequest": { +"id": "TargetSslProxiesSetCertificateMapRequest", +"properties": { +"certificateMap": { +"description": "URL of the Certificate Map to associate with this TargetSslProxy.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", +"type": "string" +} +}, +"type": "object" +}, +"TargetSslProxiesSetProxyHeaderRequest": { +"id": "TargetSslProxiesSetProxyHeaderRequest", +"properties": { +"proxyHeader": { +"description": "The new type of proxy header to append before sending data to the\nbackend. NONE or PROXY_V1 are allowed.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"TargetSslProxiesSetSslCertificatesRequest": { +"id": "TargetSslProxiesSetSslCertificatesRequest", +"properties": { +"sslCertificates": { +"description": "New set of URLs to SslCertificate resources to associate with this\nTargetSslProxy. At least one SSL certificate must be specified.\nCurrently, you may specify up to 15 SSL certificates.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetSslProxy": { +"description": "Represents a Target SSL Proxy resource.\n\nA target SSL proxy is a component of a Proxy Network Load Balancer.\nThe forwarding rule references the target SSL proxy, and the target proxy\nthen references a backend service. For more information, readProxy Network\nLoad Balancer overview.", +"id": "TargetSslProxy", +"properties": { +"certificateMap": { +"description": "URL of a certificate map that identifies a certificate map associated with\nthe given target proxy.\nThis field can only be set for global target proxies.\nIf set, sslCertificates will be ignored.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", +"type": "string" +}, +"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" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#targetSslProxy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"service": { +"description": "URL to the BackendService resource.", +"type": "string" +}, +"sslCertificates": { +"description": "URLs to SslCertificate resources that are used to\nauthenticate connections to Backends. At least one SSL certificate\nmust be specified. Currently, you may specify up to 15 SSL certificates.\nsslCertificates do not apply when the load balancing scheme is set to\nINTERNAL_SELF_MANAGED.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sslPolicy": { +"description": "URL of SslPolicy resource that will be associated with the TargetSslProxy\nresource. If not set, the TargetSslProxy resource will not have any\nSSL policy configured.", +"type": "string" +} +}, +"type": "object" +}, +"TargetSslProxyList": { +"description": "Contains a list of TargetSslProxy resources.", +"id": "TargetSslProxyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetSslProxy resources.", +"items": { +"$ref": "TargetSslProxy" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetSslProxyList", +"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.", +"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" +}, +"TargetTcpProxiesScopedList": { +"id": "TargetTcpProxiesScopedList", +"properties": { +"targetTcpProxies": { +"description": "A list of TargetTcpProxies contained in this scope.", +"items": { +"$ref": "TargetTcpProxy" +}, +"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.", +"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" +}, +"TargetTcpProxiesSetBackendServiceRequest": { +"id": "TargetTcpProxiesSetBackendServiceRequest", +"properties": { +"service": { +"description": "The URL of the new BackendService resource for the targetTcpProxy.", +"type": "string" +} +}, +"type": "object" +}, +"TargetTcpProxiesSetProxyHeaderRequest": { +"id": "TargetTcpProxiesSetProxyHeaderRequest", +"properties": { +"proxyHeader": { +"description": "The new type of proxy header to append before sending data to the\nbackend. NONE or PROXY_V1 are allowed.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"TargetTcpProxy": { +"description": "Represents a Target TCP Proxy resource.\n\nA target TCP proxy is a component of a Proxy Network Load Balancer.\nThe forwarding rule references the target TCP proxy, and the target proxy\nthen references a backend service. For more information, readProxy Network\nLoad Balancer overview.", +"id": "TargetTcpProxy", +"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" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#targetTcpProxy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.", +"readOnly": true, +"type": "string" +}, +"loadBalancingScheme": { +"description": "Specifies the type of load balancing scheme used by this target proxy.", +"enum": [ +"EXTERNAL", +"EXTERNAL_MANAGED", +"INTERNAL_MANAGED", +"LOAD_BALANCING_SCHEME_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +}, +"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.\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" +}, +"proxyBind": { +"description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", +"type": "boolean" +}, +"proxyHeader": { +"description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", +"enum": [ +"NONE", +"PROXY_V1" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional TCP proxy resides.\nThis field is not applicable to global TCP proxy.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"service": { +"description": "URL to the BackendService resource.", +"type": "string" +} +}, +"type": "object" +}, +"TargetTcpProxyAggregatedList": { +"id": "TargetTcpProxyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetTcpProxiesScopedList", +"description": "Name of the scope containing this set of TargetTcpProxies." +}, +"description": "A list of TargetTcpProxiesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetTcpProxyAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target\nTCP Proxies.", +"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" +}, +"TargetTcpProxyList": { +"description": "Contains a list of TargetTcpProxy resources.", +"id": "TargetTcpProxyList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetTcpProxy resources.", +"items": { +"$ref": "TargetTcpProxy" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetTcpProxyList", +"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.", +"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" +}, +"TargetVpnGateway": { +"description": "Represents a Target VPN Gateway resource.\n\nThe target VPN gateway resource represents a Classic Cloud VPN gateway.\nFor more information, read thethe\nCloud VPN Overview.", +"id": "TargetVpnGateway", +"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" +}, +"forwardingRules": { +"description": "[Output Only] A list of URLs to the ForwardingRule resources.\nForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN\ngateway.", +"items": { +"type": "string" +}, +"type": "array" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#targetVpnGateway", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this TargetVpnGateway, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a TargetVpnGateway.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.targetVpnGateways.insert" +] +}, +"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" +}, +"network": { +"annotations": { +"required": [ +"compute.targetVpnGateways.insert" +] +}, +"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" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"status": { +"description": "[Output Only] The status of the VPN gateway,\nwhich can be one of the following: CREATING, READY, FAILED, or DELETING.", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"READY" +], +"enumDescriptions": [ +"", +"", +"", +"" +], +"type": "string" +}, +"tunnels": { +"description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are\ncreated using the compute.vpntunnels.insert method and\nassociated with a VPN gateway.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"TargetVpnGatewayAggregatedList": { +"id": "TargetVpnGatewayAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "TargetVpnGatewaysScopedList", +"description": "[Output Only] Name of the scope containing this set of target VPN gateways." +}, +"description": "A list of TargetVpnGateway resources.", +"type": "object" +}, +"kind": { +"default": "compute#targetVpnGatewayAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", +"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" +}, +"TargetVpnGatewayList": { +"description": "Contains a list of TargetVpnGateway resources.", +"id": "TargetVpnGatewayList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of TargetVpnGateway resources.", +"items": { +"$ref": "TargetVpnGateway" +}, +"type": "array" +}, +"kind": { +"default": "compute#targetVpnGatewayList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", +"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.", +"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" +}, +"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": { +"targetVpnGateways": { +"description": "[Output Only] A list of target VPN gateways contained in this scope.", +"items": { +"$ref": "TargetVpnGateway" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of addresses\nwhen 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.", +"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" +}, +"TestFailure": { +"id": "TestFailure", +"properties": { +"actualOutputUrl": { +"description": "The actual output URL evaluated by a load balancer containing the scheme,\nhost, path and query parameters.", +"type": "string" +}, +"actualRedirectResponseCode": { +"description": "Actual HTTP status code for rule with `urlRedirect`\ncalculated by load balancer", +"format": "int32", +"type": "integer" +}, +"actualService": { +"description": "BackendService or BackendBucket returned by load\nbalancer.", +"type": "string" +}, +"expectedOutputUrl": { +"description": "The expected output URL evaluated by a load balancer containing the scheme,\nhost, path and query parameters.", +"type": "string" +}, +"expectedRedirectResponseCode": { +"description": "Expected HTTP status code for rule with `urlRedirect`\ncalculated by load balancer", +"format": "int32", +"type": "integer" +}, +"expectedService": { +"description": "Expected BackendService or BackendBucket resource\nthe given URL should be mapped to.", +"type": "string" +}, +"headers": { +"description": "HTTP headers of the request.", +"items": { +"$ref": "UrlMapTestHeader" +}, +"type": "array" +}, +"host": { +"description": "Host portion of the URL.", +"type": "string" +}, +"path": { +"description": "Path portion including query parameters in the URL.", +"type": "string" +} +}, +"type": "object" +}, +"TestPermissionsRequest": { +"id": "TestPermissionsRequest", +"properties": { +"permissions": { +"description": "The set of permissions to check for the 'resource'. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"TestPermissionsResponse": { +"id": "TestPermissionsResponse", +"properties": { +"permissions": { +"description": "A subset of `TestPermissionsRequest.permissions` that the caller is\nallowed.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"TimeZone": { +"description": "Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones).", +"id": "TimeZone", +"properties": { +"id": { +"description": "IANA Time Zone Database time zone. For example \"America/New_York\".", +"type": "string" +}, +"version": { +"description": "Optional. IANA Time Zone Database version number. For example \"2019a\".", +"type": "string" +} +}, +"type": "object" +}, +"Uint128": { +"id": "Uint128", +"properties": { +"high": { +"format": "uint64", +"type": "string" +}, +"low": { +"format": "uint64", +"type": "string" +} +}, +"type": "object" +}, +"UpcomingMaintenance": { +"description": "Upcoming Maintenance notification information.", +"id": "UpcomingMaintenance", +"properties": { +"canReschedule": { +"description": "Indicates if the maintenance can be customer triggered.", +"type": "boolean" +}, +"latestWindowStartTime": { +"description": "The latest time for the planned maintenance window to start.\nThis timestamp value is in RFC3339 text format.", +"type": "string" +}, +"maintenanceOnShutdown": { +"description": "Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.", +"type": "boolean" +}, +"maintenanceReasons": { +"description": "The reasons for the maintenance. Only valid for vms.", +"items": { +"enum": [ +"FAILURE_DISK", +"FAILURE_GPU", +"FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED", +"FAILURE_GPU_NVLINK_SWITCH_CUSTOMER_REPORTED", +"FAILURE_GPU_TEMPERATURE", +"FAILURE_GPU_XID", +"FAILURE_INFRA", +"FAILURE_INTERFACE", +"FAILURE_MEMORY", +"FAILURE_NETWORK", +"FAILURE_NVLINK", +"FAILURE_REDUNDANT_HARDWARE_FAULT", +"FAILURE_TPU", +"INFRASTRUCTURE_RELOCATION", +"MAINTENANCE_REASON_UNKNOWN", +"PLANNED_NETWORK_UPDATE", +"PLANNED_UPDATE" +], +"enumDescriptions": [ +"Maintenance due to disk errors.", +"Maintenance due to GPU errors.", +"Maintenance due to customer reported multiple faulty hosts via R&R\nSubblock API.", +"Maintenance due to customer reported NVLink switch failure via R&R\nSubblock API.", +"Maintenance due to high GPU temperature.", +"Maintenance due to GPU xid failure.", +"Maintenance due to infrastructure errors.", +"Maintenance due to interface errors.", +"Maintenance due to memory errors.", +"Maintenance due to network errors.", +"Maintenance due to NVLink failure.", +"Maintenance due to redundant hardware fault.", +"Maintenance due to TPU errors.", +"Maintenance due to infrastructure relocation.", +"Unknown maintenance reason. Do not use this value.", +"Maintenance due to planned network update.", +"Maintenance due to planned update to the instance." +], +"type": "string" +}, +"type": "array" +}, +"maintenanceStatus": { +"enum": [ +"ONGOING", +"PENDING", +"UNKNOWN" +], +"enumDescriptions": [ +"There is ongoing maintenance on this VM.", +"There is pending maintenance.", +"Unknown maintenance status. Do not use this value." +], +"type": "string" +}, +"type": { +"description": "Defines the type of maintenance.", +"enum": [ +"MULTIPLE", +"SCHEDULED", +"UNKNOWN_TYPE", +"UNSCHEDULED" +], +"enumDescriptions": [ +"Multiple maintenance types in one window.\nThis is only intended to be used for groups.", +"Scheduled maintenance (e.g. maintenance after uptime guarantee is\ncomplete).", +"No type specified. Do not use this value.", +"Unscheduled maintenance (e.g. emergency maintenance during\nuptime guarantee)." +], +"type": "string" +}, +"windowEndTime": { +"description": "The time by which the maintenance disruption will be completed.\nThis timestamp value is in RFC3339 text format.", +"type": "string" +}, +"windowStartTime": { +"description": "The current start time of the maintenance window.\nThis timestamp value is in RFC3339 text format.", +"type": "string" +} +}, +"type": "object" +}, +"UrlMap": { +"description": "Represents a URL Map resource.\n\nCompute Engine has two URL Map resources:\n\n* [Global](/compute/docs/reference/rest/v1/urlMaps)\n* [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)\n\nA URL map resource is a component of certain types of cloud load balancers\nand Traffic Director:\n\n* urlMaps are used by global external Application Load\nBalancers, classic Application Load Balancers, and cross-region internal\nApplication Load Balancers.\n* regionUrlMaps are used by internal Application Load Balancers,\nregional external Application Load Balancers and regional internal\nApplication Load Balancers.\n\nFor a list of supported URL map features by the load balancer type, see the\nLoad balancing features: Routing and traffic management table.\n\nFor a list of supported URL map features for Traffic Director, see the\nTraffic Director features: Routing and traffic management table.\n\nThis resource defines mappings from hostnames and URL paths to either a\nbackend service or a backend bucket.\n\nTo use the global urlMaps resource, the backend service must\nhave a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use\nthe regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more\ninformation, read URL\nMap Concepts.", +"id": "UrlMap", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"defaultCustomErrorResponsePolicy": { +"$ref": "CustomErrorResponsePolicy", +"description": "defaultCustomErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nThis policy takes\neffect at the load balancer level and applies only when no policy has been\ndefined for the error code at lower levels like PathMatcher, RouteRule and\nPathRule within this UrlMap. \n\nFor example, consider a UrlMap with the\nfollowing configuration:\n \n \n - defaultCustomErrorResponsePolicy containing policies for\n responding to 5xx and 4xx errors\n - A PathMatcher configured for *.example.com has\n defaultCustomErrorResponsePolicy for 4xx.\n\nIf a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.\nWhen the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When\na request that does not match any host in *.example.com such\nas http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy\ntakes effect. \n\nWhen used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only\nonce all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the defaultCustomErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ndefaultCustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." +}, +"defaultRouteAction": { +"$ref": "HttpRouteAction", +"description": "defaultRouteAction takes effect when none of the \nhostRules match. The load balancer performs advanced routing\nactions, such as URL rewrites and header transformations, before forwarding\nthe request to the selected backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\n URL maps for classic Application Load Balancers only support\nthe urlRewrite action within defaultRouteAction.\n\n\ndefaultRouteAction has no effect when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true." +}, +"defaultService": { +"description": "The full or partial URL of the defaultService resource to\nwhich traffic is directed if none of the hostRules match.\nIf defaultRouteAction is also specified, advanced\nrouting actions, such as URL rewrites, take effect before sending the\nrequest to the backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\ndefaultService has no effect when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true.", +"type": "string" +}, +"defaultUrlRedirect": { +"$ref": "HttpRedirectAction", +"description": "When none of the specified hostRules match, the request\nis redirected to a URL specified by defaultUrlRedirect.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." +}, +"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 is ignored when\ninserting a UrlMap. An up-to-date fingerprint must be provided\nin order to update the UrlMap, otherwise the request will\nfail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a UrlMap.", +"format": "byte", +"type": "string" +}, +"headerAction": { +"$ref": "HttpHeaderAction", +"description": "Specifies changes to request and response headers that need to take effect\nfor the selected backendService.\n\nThe headerAction specified here take effect afterheaderAction specified under pathMatcher.\n\nheaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." +}, +"hostRules": { +"description": "The list of host rules to use against the URL.", +"items": { +"$ref": "HostRule" +}, +"type": "array" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#urlMap", +"description": "Output only. [Output Only] Type of the resource. Always compute#urlMaps for\nurl maps.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"pathMatchers": { +"description": "The list of named PathMatchers to use against the URL.", +"items": { +"$ref": "PathMatcher" +}, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the regional URL map resides.\nThis field is not applicable to global URL maps.\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] Server-defined URL for the resource.", +"type": "string" +}, +"tests": { +"description": "The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a\nmaximum of 100 tests per UrlMap.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true.", +"items": { +"$ref": "UrlMapTest" +}, +"type": "array" +} +}, +"type": "object" +}, +"UrlMapList": { +"description": "Contains a list of UrlMap resources.", +"id": "UrlMapList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of UrlMap resources.", +"items": { +"$ref": "UrlMap" +}, +"type": "array" +}, +"kind": { +"default": "compute#urlMapList", +"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.", +"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" +}, +"UrlMapReference": { +"id": "UrlMapReference", +"properties": { +"urlMap": { +"type": "string" +} +}, +"type": "object" +}, +"UrlMapTest": { +"description": "Message for the expected URL mappings.", +"id": "UrlMapTest", +"properties": { +"description": { +"description": "Description of this test case.", +"type": "string" +}, +"expectedOutputUrl": { +"description": "The expected output URL evaluated by the load balancer\ncontaining the scheme, host, path and query parameters.\n\nFor rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by\nthe load balancer to backends. For rules with urlRewrite,\nthe test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.\n\nFor rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's\nredirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.\nIf urlRedirect specifies strip_query, the test\npasses only if expectedOutputUrl does not contain any query\nparameters. \n\nexpectedOutputUrl is optional whenservice is specified.", +"type": "string" +}, +"expectedRedirectResponseCode": { +"description": "For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in\nload balancer's redirect response.\n\nexpectedRedirectResponseCode cannot be set whenservice is set.", +"format": "int32", +"type": "integer" +}, +"headers": { +"description": "HTTP headers for this request. If headers contains\na host header, then host must also match the header value.", +"items": { +"$ref": "UrlMapTestHeader" +}, +"type": "array" +}, +"host": { +"description": "Host portion of the URL. If headers contains a host header,\nthen host must also match the header value.", +"type": "string" +}, +"path": { +"description": "Path portion of the URL.", +"type": "string" +}, +"service": { +"description": "Expected BackendService or BackendBucket resource\nthe given URL should be mapped to. \n\nThe service field cannot\nbe set if expectedRedirectResponseCode is set.", +"type": "string" +} +}, +"type": "object" +}, +"UrlMapTestHeader": { +"description": "HTTP headers used in UrlMapTests.", +"id": "UrlMapTestHeader", +"properties": { +"name": { +"description": "Header name.", +"type": "string" +}, +"value": { +"description": "Header value.", +"type": "string" +} +}, +"type": "object" +}, +"UrlMapValidationResult": { +"description": "Message representing the validation result for a UrlMap.", +"id": "UrlMapValidationResult", +"properties": { +"loadErrors": { +"items": { +"type": "string" +}, +"type": "array" +}, +"loadSucceeded": { +"description": "Whether the given UrlMap can be successfully loaded.\nIf false, 'loadErrors' indicates the reasons.", +"type": "boolean" +}, +"testFailures": { +"items": { +"$ref": "TestFailure" +}, +"type": "array" +}, +"testPassed": { +"description": "If successfully loaded, this field indicates whether the test passed.\nIf false, 'testFailures's indicate the reason of failure.", +"type": "boolean" +} +}, +"type": "object" +}, +"UrlMapsAggregatedList": { +"id": "UrlMapsAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "UrlMapsScopedList", +"description": "Name of the scope containing this set of UrlMaps." +}, +"description": "A list of UrlMapsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#urlMapsAggregatedList", +"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" +}, +"UrlMapsScopedList": { +"id": "UrlMapsScopedList", +"properties": { +"urlMaps": { +"description": "A list of UrlMaps contained in this scope.", +"items": { +"$ref": "UrlMap" +}, +"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.", +"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" +}, +"UrlMapsValidateRequest": { +"id": "UrlMapsValidateRequest", +"properties": { +"loadBalancingSchemes": { +"description": "Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load\nBalancers and regional external Application Load Balancers.\nUse EXTERNAL for classic Application Load Balancers.\n\nUse INTERNAL_MANAGED for internal Application Load Balancers. For more\ninformation, refer to Choosing\na load balancer.\n\nIf unspecified, the load balancing scheme will be inferred from the backend\nservice resources this URL map references. If that can not be inferred (for\nexample, this URL map only references backend buckets, or this Url map is\nfor rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type.\n\nIf specified, the scheme(s) must not conflict with the load balancing\nscheme of the backend service resources this Url map references.", +"items": { +"enum": [ +"EXTERNAL", +"EXTERNAL_MANAGED", +"LOAD_BALANCING_SCHEME_UNSPECIFIED" +], +"enumDescriptions": [ +"Signifies that this will be used for classic Application Load Balancers.", +"Signifies that this will be used for Envoy-based global external\nApplication Load Balancers.", +"If unspecified, the validation will try to infer the scheme from the\nbackend service resources this Url map references. If the inference is not\npossible, EXTERNAL will be used as the default type." +], +"type": "string" +}, +"type": "array" +}, +"resource": { +"$ref": "UrlMap", +"description": "Content of the UrlMap to be validated." +} +}, +"type": "object" +}, +"UrlMapsValidateResponse": { +"id": "UrlMapsValidateResponse", +"properties": { +"result": { +"$ref": "UrlMapValidationResult" +} +}, +"type": "object" +}, +"UrlRewrite": { +"description": "The spec for modifying the path before sending the request to the matched\nbackend service.", +"id": "UrlRewrite", +"properties": { +"hostRewrite": { +"description": "Before forwarding the request to the selected service, the request's\nhost header is replaced with contents of hostRewrite.\n\nThe value must be from 1 to 255 characters.", +"type": "string" +}, +"pathPrefixRewrite": { +"description": "Before forwarding the request to the selected backend service, the\nmatching portion of the request's path is replaced bypathPrefixRewrite.\n\nThe value must be from 1 to 1024 characters.", +"type": "string" +}, +"pathTemplateRewrite": { +"description": "If specified, the pattern rewrites the URL path (based on the :path\nheader) using the HTTP template syntax. \n\nA corresponding\npath_template_match must be specified. Any template variables must exist in\nthe path_template_match field. \n \n \n - -At least one variable must be specified in the path_template_match\n field \n - You can omit variables from the rewritten URL\n - The * and ** operators cannot be matched\n unless they have a corresponding variable name - e.g.\n {format=*} or {var=**}.\n\nFor example, a path_template_match of /static/{format=**}\ncould be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a\nrewrite, so that /{country}/{format}/{suffix=**} can be\nrewritten as /content/{format}/{country}/{suffix}. \n\nAt least\none non-empty routeRules[].matchRules[].path_template_match is\nrequired. \n\nOnly one of path_prefix_rewrite orpath_template_rewrite may be specified.", +"type": "string" +}, +"regexRewrite": { +"$ref": "RegexRewrite", +"description": "The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified." +} +}, +"type": "object" +}, +"UsableSubnetwork": { +"description": "Subnetwork which the current user has compute.subnetworks.use permission on.", +"id": "UsableSubnetwork", +"properties": { +"externalIpv6Prefix": { +"description": "Output only. [Output Only] The external IPv6 address range that is assigned to this\nsubnetwork.", +"readOnly": true, +"type": "string" +}, +"internalIpv6Prefix": { +"description": "Output only. [Output Only] The internal IPv6 address range that is assigned to this\nsubnetwork.", +"readOnly": true, +"type": "string" +}, +"ipCidrRange": { +"description": "The range of internal addresses that are owned by this subnetwork.", +"type": "string" +}, +"ipv6AccessType": { +"description": "The access type of IPv6 address this subnet holds. It's immutable and can\nonly be specified during creation or the first time the subnet is updated\ninto IPV4_IPV6 dual stack.", +"enum": [ +"EXTERNAL", +"INTERNAL" +], +"enumDescriptions": [ +"VMs on this subnet will be assigned IPv6 addresses that are accessible\nvia the Internet, as well as the VPC network.", +"VMs on this subnet will be assigned IPv6 addresses that are only\naccessible over the VPC network." +], +"type": "string" +}, +"network": { +"description": "Network URL.", +"type": "string" +}, +"purpose": { +"enum": [ +"GLOBAL_MANAGED_PROXY", +"INTERNAL_HTTPS_LOAD_BALANCER", +"PEER_MIGRATION", +"PRIVATE", +"PRIVATE_NAT", +"PRIVATE_RFC_1918", +"PRIVATE_SERVICE_CONNECT", +"REGIONAL_MANAGED_PROXY" +], +"enumDescriptions": [ +"Subnet reserved for Global Envoy-based Load Balancing.", +"Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", +"Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", +"Regular user created or automatically created subnet.", +"Subnetwork used as source range for Private NAT Gateways.", +"Regular user created or automatically created subnet.", +"Subnetworks created for Private Service Connect in the producer network.", +"Subnetwork used for Regional Envoy-based Load Balancing." +], +"type": "string" +}, +"role": { +"description": "The role of subnetwork. Currently, this field is only used when\npurpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE\nsubnetwork is one that is currently being used for Envoy-based load\nbalancers in a region. A BACKUP subnetwork is one that is\nready to be promoted to ACTIVE or is currently draining.\nThis field can be updated with a patch request.", +"enum": [ +"ACTIVE", +"BACKUP" +], +"enumDescriptions": [ +"The ACTIVE subnet that is currently used.", +"The BACKUP subnet that could be promoted to ACTIVE." +], +"type": "string" +}, +"secondaryIpRanges": { +"description": "Secondary IP ranges.", +"items": { +"$ref": "UsableSubnetworkSecondaryRange" +}, +"type": "array" +}, +"stackType": { +"description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs\nin the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and\nIPv6 addresses. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at resource creation time and updated usingpatch.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"New VMs in this subnet can have both IPv4 and IPv6 addresses.", +"New VMs in this subnet will only be assigned IPv4 addresses.", +"New VMs in this subnet will only be assigned IPv6 addresses." +], +"type": "string" +}, +"subnetwork": { +"description": "Subnetwork URL.", +"type": "string" +} +}, +"type": "object" +}, +"UsableSubnetworkSecondaryRange": { +"description": "Secondary IP range of a usable subnetwork.", +"id": "UsableSubnetworkSecondaryRange", +"properties": { +"ipCidrRange": { +"description": "The range of IP addresses belonging to this subnetwork secondary range.\nCan be Ipv4 or Ipv6 range.", +"type": "string" +}, +"rangeName": { +"description": "The name associated with this subnetwork secondary range, used when adding\nan alias IP range to a VM instance.\nThe name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the subnetwork.", +"type": "string" +} +}, +"type": "object" +}, +"UsableSubnetworksAggregatedList": { +"id": "UsableSubnetworksAggregatedList", +"properties": { +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"items": { +"description": "[Output] A list of usable subnetwork URLs.", +"items": { +"$ref": "UsableSubnetwork" +}, +"type": "array" +}, +"kind": { +"default": "compute#usableSubnetworksAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists\nof usable subnetworks.", +"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.\nIn special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the\nnext page of results.", +"type": "string" +}, +"scopedWarnings": { +"description": "Output only. [Output Only] Informational warning messages for failures encountered from\nscopes.", +"items": { +"$ref": "SubnetworksScopedWarning" +}, +"readOnly": true, +"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" +}, +"UsageExportLocation": { +"description": "The location in Cloud Storage and naming method of the daily usage\nreport. Contains bucket_name and report_name prefix.", +"id": "UsageExportLocation", +"properties": { +"bucketName": { +"description": "The name of an existing bucket in Cloud Storage where the usage report\nobject is stored. The Google Service Account is granted write access to\nthis bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://\nor https://storage.googleapis.com/ in front of it, such\nas gs://example-bucket.", +"type": "string" +}, +"reportNamePrefix": { +"description": "An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.\nIf you supply a prefix, it should conform to Cloud Storageobject naming\nconventions.", +"type": "string" +} +}, +"type": "object" +}, +"VmEndpointNatMappings": { +"description": "Contain information of Nat mapping for a VM endpoint (i.e., NIC).", +"id": "VmEndpointNatMappings", +"properties": { +"instanceName": { +"description": "Output only. Name of the VM instance which the endpoint belongs to", +"readOnly": true, +"type": "string" +}, +"interfaceNatMappings": { +"items": { +"$ref": "VmEndpointNatMappingsInterfaceNatMappings" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"VmEndpointNatMappingsInterfaceNatMappings": { +"description": "Contain information of Nat mapping for an interface of this endpoint.", +"id": "VmEndpointNatMappingsInterfaceNatMappings", +"properties": { +"drainNatIpPortRanges": { +"description": "Output only. List of all drain IP:port-range mappings assigned to this interface.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"natIpPortRanges": { +"description": "Output only. A list of all IP:port-range mappings assigned to this interface.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"numTotalDrainNatPorts": { +"description": "Output only. Total number of drain ports across all NAT IPs allocated to this\ninterface. It equals to the aggregated port number in the field\ndrain_nat_ip_port_ranges.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"numTotalNatPorts": { +"description": "Output only. Total number of ports across all NAT IPs allocated to this interface.\nIt equals to the aggregated port number in the field nat_ip_port_ranges.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"ruleMappings": { +"description": "Output only. Information about mappings provided by rules in this NAT.", +"items": { +"$ref": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings" +}, +"readOnly": true, +"type": "array" +}, +"sourceAliasIpRange": { +"description": "Output only. Alias IP range for this interface endpoint.\nIt will be a private (RFC 1918) IP range.\nExamples: \"10.33.4.55/32\", or \"192.168.5.0/24\".", +"readOnly": true, +"type": "string" +}, +"sourceVirtualIp": { +"description": "Output only. Primary IP of the VM for this NIC.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings": { +"description": "Contains information of NAT Mappings provided by a NAT Rule.", +"id": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings", +"properties": { +"drainNatIpPortRanges": { +"description": "Output only. List of all drain IP:port-range mappings assigned to this interface\nby this rule.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"natIpPortRanges": { +"description": "Output only. A list of all IP:port-range mappings assigned to this interface by this\nrule.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"numTotalDrainNatPorts": { +"description": "Output only. Total number of drain ports across all NAT IPs allocated to this\ninterface by this rule.\nIt equals the aggregated port number in the field\ndrain_nat_ip_port_ranges.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"numTotalNatPorts": { +"description": "Output only. Total number of ports across all NAT IPs allocated to this interface\nby this rule.\nIt equals the aggregated port number in the field nat_ip_port_ranges.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, +"ruleNumber": { +"description": "Output only. Rule number of the NAT Rule.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"VmEndpointNatMappingsList": { +"description": "Contains a list of VmEndpointNatMappings.", +"id": "VmEndpointNatMappingsList", +"properties": { +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"kind": { +"default": "compute#vmEndpointNatMappingsList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of\nVM endpoints.", +"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 Nat mapping information of VM endpoints.", +"items": { +"$ref": "VmEndpointNatMappings" +}, +"type": "array" +}, +"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" +}, +"VmExtensionPoliciesScopedList": { +"id": "VmExtensionPoliciesScopedList", +"properties": { +"vmExtensionPolicies": { +"description": "List of VmExtensionPolicy resources contained in this scope.", +"items": { +"$ref": "VmExtensionPolicy" +}, +"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.", +"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" +}, +"VmExtensionPolicy": { +"description": "Represents a VM extension policy.", +"id": "VmExtensionPolicy", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource.", +"type": "string" +}, +"extensionPolicies": { +"additionalProperties": { +"$ref": "VmExtensionPolicyExtensionPolicy" +}, +"description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", +"type": "object" +}, +"globalResourceLink": { +"description": "Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if\napplicable.", +"readOnly": true, +"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" +}, +"instanceSelectors": { +"description": "Optional. Selectors to target VMs for this policy. VMs are selected if they match\n*any* of the provided selectors (logical OR). If this list is empty, the\npolicy applies to all VMs.", +"items": { +"$ref": "VmExtensionPolicyInstanceSelector" +}, +"type": "array" +}, +"kind": { +"default": "compute#vmExtensionPolicy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.", +"readOnly": true, +"type": "string" +}, +"managedByGlobal": { +"description": "Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.", +"readOnly": true, +"type": "boolean" +}, +"name": { +"annotations": { +"required": [ +"compute.zoneVmExtensionPolicies.insert" +] +}, +"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])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"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 most recent creation timestamp takes precedence.", +"format": "int32", +"type": "integer" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING.", +"enum": [ +"ACTIVE", +"DELETING", +"STATE_UNSPECIFIED" +], +"enumDescriptions": [ +"The policy is active and applied to matching VMs.\nNewly created VMs that match the policy will also receive the\nextension policy.", +"The policy is in the process of being deleted. After the extension is\nremoved from all matching VMs, the policy will be deleted.", +"Default value. Do not use." +], +"readOnly": true, +"type": "string" +}, +"updateTimestamp": { +"description": "Output only. [Output Only] Update timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"VmExtensionPolicyAggregatedListResponse": { +"description": "Response for the aggregated list of VM extension policies.", +"id": "VmExtensionPolicyAggregatedListResponse", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "VmExtensionPoliciesScopedList", +"description": "Name of the scope containing this set of VmExtensionPolicies." +}, +"description": "A list of VmExtensionPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#VmExtensionPolicyAggregatedList", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#VmExtensionPolicyAggregatedList for lists of\nVmExtensionPolicies.", +"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" +}, +"VmExtensionPolicyExtensionPolicy": { +"description": "Configuration for a specific VM extension.", +"id": "VmExtensionPolicyExtensionPolicy", +"properties": { +"pinnedVersion": { +"description": "Optional. The specific version of the extension to install. If not set, the latest\nversion is used.", +"type": "string" +}, +"stringConfig": { +"description": "Optional. String-based configuration data for the extension.", +"type": "string" +} +}, +"type": "object" +}, +"VmExtensionPolicyInstanceSelector": { +"description": "Defines how to select VMs to apply a zone VM extension policy.", +"id": "VmExtensionPolicyInstanceSelector", +"properties": { +"labelSelector": { +"$ref": "VmExtensionPolicyLabelSelector", +"description": "Optional. LabelSelector selects VMs based on their labels." +} +}, +"type": "object" +}, +"VmExtensionPolicyLabelSelector": { +"description": "A LabelSelector is applied to a VM only if it matches all the specified\nlabels.", +"id": "VmExtensionPolicyLabelSelector", +"properties": { +"inclusionLabels": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. A map of key-value pairs representing VM labels.\nVMs must have all of the labels specified in this map to be selected\n(logical AND).\n\ne.g. If the `inclusion_labels` are {(\"key1\", \"value1\"), (\"key2\",\n\"value2\")}, the VM labels must contain both (\"key1\", \"value1\") and\n(\"key2\", \"value2\") to be selected. If the VM labels are (\"key1\",\n\"value1\") and (\"something\", \"else\"), it will not be selected.\n\nIf the map is empty, it's considered a match.", +"type": "object" +} +}, +"type": "object" +}, +"VmExtensionPolicyList": { +"id": "VmExtensionPolicyList", +"properties": { +"etag": { +"description": "Output only. [Output Only] Fingerprint of this resource. A hash of the contents stored\nin this object. This field is used in optimistic locking. This field will\nbe ignored when inserting a VmExtensionPolicy. An up-to-date\nfingerprint must be provided in order to update the VmExtensionPolicy.\n\nTo see the latest value of the fingerprint, make a get() request to\nretrieve a VmExtensionPolicy.", +"readOnly": true, +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "Output only. [Output Only] A list of VM extension policy resources.", +"items": { +"$ref": "VmExtensionPolicy" +}, +"readOnly": true, +"type": "array" +}, +"kind": { +"default": "compute#vmExtensionPolicyList", +"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, +"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. [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" +} +}, +"readOnly": true, +"type": "object" +} +}, +"type": "object" +}, +"VpnGateway": { +"description": "Represents a HA VPN gateway.\n\nHA VPN is a high-availability (HA) Cloud VPN solution that lets you securely\nconnect your on-premises network to your Google Cloud Virtual Private Cloud\nnetwork through an IPsec VPN connection in a single region.\nFor more information about Cloud HA VPN solutions, see\nCloud VPN topologies .", +"id": "VpnGateway", +"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" +}, +"gatewayIpVersion": { +"description": "The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not\nspecified, IPV4 will be used.", +"enum": [ +"IPV4", +"IPV6" +], +"enumDescriptions": [ +"Every HA-VPN gateway interface is configured with an IPv4 address.", +"Every HA-VPN gateway interface is configured with an IPv6 address." +], +"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#vpnGateway", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this VpnGateway, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a VpnGateway.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"name": { +"annotations": { +"required": [ +"compute.vpnGateways.insert" +] +}, +"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" +}, +"network": { +"annotations": { +"required": [ +"compute.vpnGateways.insert" +] +}, +"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, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"stackType": { +"description": "The stack type for this VPN gateway to identify the IP protocols that are\nenabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY", +"IPV6_ONLY" +], +"enumDescriptions": [ +"Enable VPN gateway with both IPv4 and IPv6 protocols.", +"Enable VPN gateway with only IPv4 protocol.", +"Enable VPN gateway with only IPv6 protocol." +], +"type": "string" +}, +"vpnInterfaces": { +"description": "The list of VPN interfaces associated with this VPN gateway.", +"items": { +"$ref": "VpnGatewayVpnGatewayInterface" +}, +"type": "array" +} +}, +"type": "object" +}, +"VpnGatewayAggregatedList": { +"id": "VpnGatewayAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "VpnGatewaysScopedList", +"description": "[Output Only] Name of the scope containing this set of VPN gateways." +}, +"description": "A list of VpnGateway resources.", +"type": "object" +}, +"kind": { +"default": "compute#vpnGatewayAggregatedList", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", +"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" +}, +"VpnGatewayList": { +"description": "Contains a list of VpnGateway resources.", +"id": "VpnGatewayList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of VpnGateway resources.", +"items": { +"$ref": "VpnGateway" +}, +"type": "array" +}, +"kind": { +"default": "compute#vpnGatewayList", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", +"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.", +"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" +}, +"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": { +"vpnConnections": { +"description": "Output only. List of VPN connection for this VpnGateway.", +"items": { +"$ref": "VpnGatewayStatusVpnConnection" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"VpnGatewayStatusHighAvailabilityRequirementState": { +"description": "Describes the high availability requirement state for the VPN connection\nbetween this Cloud VPN gateway and a peer gateway.", +"id": "VpnGatewayStatusHighAvailabilityRequirementState", +"properties": { +"state": { +"description": "Indicates the high availability requirement state for the VPN connection.\nValid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET.", +"enum": [ +"CONNECTION_REDUNDANCY_MET", +"CONNECTION_REDUNDANCY_NOT_MET" +], +"enumDescriptions": [ +"VPN tunnels are configured with adequate redundancy from Cloud VPN\ngateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP\nconnections, the adequate redundancy is a pre-requirement for users to\nget 99.99% availability on GCP side; please note that for any\nconnection, end-to-end 99.99% availability is subject to proper\nconfiguration on the peer VPN gateway.", +"VPN tunnels are not configured with adequate redundancy from the Cloud\nVPN gateway to the peer gateway" +], +"type": "string" +}, +"unsatisfiedReason": { +"description": "Indicates the reason why the VPN connection does not meet the high\navailability redundancy criteria/requirement.\nValid values is INCOMPLETE_TUNNELS_COVERAGE.", +"enum": [ +"INCOMPLETE_TUNNELS_COVERAGE" +], +"enumDescriptions": [ +"" +], +"type": "string" +} +}, +"type": "object" +}, +"VpnGatewayStatusTunnel": { +"description": "Contains some information about a VPN tunnel.", +"id": "VpnGatewayStatusTunnel", +"properties": { +"localGatewayInterface": { +"description": "Output only. The VPN gateway interface this VPN tunnel is associated with.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"peerGatewayInterface": { +"description": "Output only. The peer gateway interface this VPN tunnel is connected to, the peer\ngateway could either be an external VPN gateway or a Google Cloud\nVPN gateway.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"tunnelUrl": { +"description": "Output only. URL reference to the VPN tunnel.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"VpnGatewayStatusVpnConnection": { +"description": "A VPN connection contains all VPN tunnels connected from this VpnGateway\nto the same peer gateway. The peer gateway could either be an external VPN\ngateway or a Google Cloud VPN gateway.", +"id": "VpnGatewayStatusVpnConnection", +"properties": { +"peerExternalGateway": { +"description": "Output only. URL reference to the peer external VPN gateways to which the VPN tunnels\nin this VPN connection are connected.\nThis field is mutually exclusive with peer_gcp_gateway.", +"readOnly": true, +"type": "string" +}, +"peerGcpGateway": { +"description": "Output only. URL reference to the peer side VPN gateways to which the VPN tunnels in\nthis VPN connection are connected.\nThis field is mutually exclusive with peer_gcp_gateway.", +"readOnly": true, +"type": "string" +}, +"state": { +"$ref": "VpnGatewayStatusHighAvailabilityRequirementState", +"description": "HighAvailabilityRequirementState for the VPN connection." +}, +"tunnels": { +"description": "List of VPN tunnels that are in this VPN connection.", +"items": { +"$ref": "VpnGatewayStatusTunnel" +}, +"type": "array" +} +}, +"type": "object" +}, +"VpnGatewayVpnGatewayInterface": { +"description": "A VPN gateway interface.", +"id": "VpnGatewayVpnGatewayInterface", +"properties": { +"id": { +"description": "Output only. [Output Only] Numeric identifier for this VPN interface associated with\nthe VPN gateway.", +"format": "uint32", +"readOnly": true, +"type": "integer" +}, +"interconnectAttachment": { +"description": "URL of the VLAN attachment (interconnectAttachment) resource for this\nVPN gateway interface. When the value of this field is present, the VPN\ngateway is used for HA VPN over Cloud Interconnect; all egress\nor ingress traffic for this VPN gateway interface goes through the\nspecified VLAN attachment resource.", +"type": "string" +}, +"ipAddress": { +"description": "Output only. [Output Only] IP address for this VPN interface associated with the VPN\ngateway.\nThe IP address could be either a regional external IP address or\na regional internal IP address. The two IP addresses for a VPN gateway\nmust be all regional external or regional internal IP addresses. There\ncannot be a mix of regional external IP addresses and regional internal\nIP addresses. For HA VPN over Cloud Interconnect, the IP addresses\nfor both interfaces could either be regional internal IP addresses or\nregional external IP addresses. For regular (non HA VPN over Cloud\nInterconnect) HA VPN tunnels, the IP address must be a regional external\nIP address.", +"readOnly": true, +"type": "string" +}, +"ipv6Address": { +"description": "Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN\ngateway.\nThe IPv6 address must be a regional external IPv6 address. The format is\nRFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"VpnGatewaysGetStatusResponse": { +"id": "VpnGatewaysGetStatusResponse", +"properties": { +"result": { +"$ref": "VpnGatewayStatus" +} +}, +"type": "object" +}, +"VpnGatewaysScopedList": { +"id": "VpnGatewaysScopedList", +"properties": { +"vpnGateways": { +"description": "[Output Only] A list of VPN gateways contained in this scope.", +"items": { +"$ref": "VpnGateway" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning which replaces the list of addresses\nwhen 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.", +"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" +}, +"VpnTunnel": { +"description": "Represents a Cloud VPN Tunnel resource.\n\nFor more information about VPN, read the\nthe Cloud VPN Overview.", +"id": "VpnTunnel", +"properties": { +"cipherSuite": { +"$ref": "VpnTunnelCipherSuite", +"description": "User specified list of ciphers to use for the phase 1 and phase 2 of the\nIKE protocol." +}, +"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" +}, +"detailedStatus": { +"description": "[Output Only] Detailed status message for the VPN tunnel.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"ikeVersion": { +"description": "IKE protocol version to use when establishing the VPN tunnel with the peer\nVPN gateway. Acceptable IKE versions are 1 or 2.\nThe default version is 2.", +"format": "int32", +"type": "integer" +}, +"kind": { +"default": "compute#vpnTunnel", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", +"readOnly": true, +"type": "string" +}, +"labelFingerprint": { +"description": "A fingerprint for the labels being applied to this VpnTunnel, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a VpnTunnel.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", +"type": "object" +}, +"localTrafficSelector": { +"description": "Local traffic selector to use when establishing the VPN tunnel with the\npeer VPN gateway. The value should be a CIDR formatted string, for\nexample: 192.168.0.0/16. The ranges must be disjoint.\nOnly IPv4 is supported for Classic VPN tunnels. This field is output only\nfor HA VPN tunnels.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"annotations": { +"required": [ +"compute.vpnTunnels.insert" +] +}, +"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" +}, +"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" +}, +"peerExternalGatewayInterface": { +"description": "The interface ID of the external VPN gateway to which this VPN tunnel is\nconnected. Provided by the client when the VPN tunnel is created.\nPossible values are: `0`, `1`, `2`, `3`. The number of IDs in use\ndepends on the external VPN gateway redundancy type.", +"format": "int32", +"type": "integer" +}, +"peerGcpGateway": { +"description": "URL of the peer side HA VPN gateway to which this VPN tunnel\nis connected. Provided by the client when the VPN tunnel is created.\nThis field can be used when creating highly available VPN from VPC network\nto VPC network, the field is exclusive with the field peerExternalGateway.\nIf provided, the VPN tunnel will automatically use the same\nvpnGatewayInterface ID in the peer Google Cloud VPN gateway.", +"type": "string" +}, +"peerIp": { +"description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can\nbe set only for Classic VPN tunnels.", +"type": "string" +}, +"region": { +"description": "[Output Only] URL of the region where the VPN tunnel 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" +}, +"remoteTrafficSelector": { +"description": "Remote traffic selectors to use when establishing the VPN tunnel with\nthe peer VPN gateway. The value should be a CIDR formatted string,\nfor example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is\nsupported for Classic VPN tunnels. This field is output only for HA VPN\ntunnels.", +"items": { +"type": "string" +}, +"type": "array" +}, +"router": { +"description": "URL of the router resource to be used for dynamic routing.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"sharedSecret": { +"description": "Shared secret used to set the secure session between the Cloud VPN gateway\nand the peer VPN gateway.", +"type": "string" +}, +"sharedSecretHash": { +"description": "Hash of the shared secret.", +"type": "string" +}, +"status": { +"description": "[Output Only] The status of the VPN tunnel, which can be one of the\nfollowing:\n \n - PROVISIONING: Resource is being allocated for the VPN tunnel.\n - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs\n from\n the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route\n resources are needed to setup the VPN tunnel.\n - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.\n - ESTABLISHED: Secure session is successfully established with the peer\n VPN. \n - NETWORK_ERROR: Deprecated, replaced by\n NO_INCOMING_PACKETS \n - AUTHORIZATION_ERROR: Auth error (for example,\n bad shared secret). \n - NEGOTIATION_FAILURE: Handshake failed.\n - DEPROVISIONING: Resources are being deallocated for the VPN\n tunnel. \n - FAILED: Tunnel creation has failed and the tunnel is not\n ready to be used. \n - NO_INCOMING_PACKETS: No incoming packets from\n peer. \n - REJECTED: Tunnel configuration was rejected, can be result\n of being denied access. \n - ALLOCATING_RESOURCES: Cloud VPN is in the\n process of allocating all required resources.\n - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted\n for Classic VPN tunnels or the project is in frozen state.\n - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,\n probably behind NAT. \n - TS_NARROWING_NOT_ALLOWED: Traffic selector\n narrowing not allowed for an HA-VPN tunnel.", +"enum": [ +"ALLOCATING_RESOURCES", +"AUTHORIZATION_ERROR", +"DEPROVISIONING", +"ESTABLISHED", +"FAILED", +"FIRST_HANDSHAKE", +"NEGOTIATION_FAILURE", +"NETWORK_ERROR", +"NO_INCOMING_PACKETS", +"PROVISIONING", +"REJECTED", +"STOPPED", +"WAITING_FOR_FULL_CONFIG" +], +"enumDescriptions": [ +"Cloud VPN is in the process of allocating all required resources\n(specifically, a borg task).", +"Auth error (e.g. bad shared secret).", +"Resources is being deallocated for the VPN tunnel.", +"Secure session is successfully established with peer VPN.", +"Tunnel creation has failed and the tunnel is not ready to be used.", +"Successful first handshake with peer VPN.", +"Handshake failed.", +"Deprecated, replaced by NO_INCOMING_PACKETS", +"No incoming packets from peer", +"Resource is being allocated for the VPN tunnel.", +"Tunnel configuration was rejected, can be result of being denylisted.", +"Tunnel is stopped due to its Forwarding Rules being deleted.", +"Waiting to receive all VPN-related configs from user. Network,\nTargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are\nneeded to setup VPN tunnel." +], +"type": "string" +}, +"targetVpnGateway": { +"description": "URL of the Target VPN gateway with which this VPN tunnel is associated.\nProvided by the client when the VPN tunnel is created.\nThis field can be set only for Classic VPN tunnels.", +"type": "string" +}, +"vpnGateway": { +"description": "URL of the VPN gateway with which this VPN tunnel is associated.\nProvided by the client when the VPN tunnel is created. This must be\nused (instead of target_vpn_gateway) if a High Availability VPN gateway\nresource is created.", +"type": "string" +}, +"vpnGatewayInterface": { +"description": "The interface ID of the VPN gateway with which this VPN tunnel is\nassociated.\nPossible values are: `0`, `1`.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"VpnTunnelAggregatedList": { +"id": "VpnTunnelAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "VpnTunnelsScopedList", +"description": "Name of the scope containing this set of VPN tunnels." +}, +"description": "A list of VpnTunnelsScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#vpnTunnelAggregatedList", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", +"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" +}, +"VpnTunnelCipherSuite": { +"id": "VpnTunnelCipherSuite", +"properties": { +"phase1": { +"$ref": "VpnTunnelPhase1Algorithms" +}, +"phase2": { +"$ref": "VpnTunnelPhase2Algorithms" +} +}, +"type": "object" +}, +"VpnTunnelList": { +"description": "Contains a list of VpnTunnel resources.", +"id": "VpnTunnelList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of VpnTunnel resources.", +"items": { +"$ref": "VpnTunnel" +}, +"type": "array" +}, +"kind": { +"default": "compute#vpnTunnelList", +"description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", +"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.", +"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" +}, +"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": { +"dh": { +"items": { +"type": "string" +}, +"type": "array" +}, +"encryption": { +"items": { +"type": "string" +}, +"type": "array" +}, +"integrity": { +"items": { +"type": "string" +}, +"type": "array" +}, +"prf": { +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"VpnTunnelPhase2Algorithms": { +"id": "VpnTunnelPhase2Algorithms", +"properties": { +"encryption": { +"items": { +"type": "string" +}, +"type": "array" +}, +"integrity": { +"items": { +"type": "string" +}, +"type": "array" +}, +"pfs": { +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"VpnTunnelsScopedList": { +"id": "VpnTunnelsScopedList", +"properties": { +"vpnTunnels": { +"description": "A list of VPN tunnels contained in this scope.", +"items": { +"$ref": "VpnTunnel" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of addresses when\nthe 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.", +"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" +}, +"WafExpressionSet": { +"id": "WafExpressionSet", +"properties": { +"aliases": { +"description": "A list of alternate IDs. The format should be:\n- E.g. XSS-stable\nGeneric suffix like \"stable\" is particularly useful if a policy\nlikes to avail newer set of expressions without having to change\nthe policy.\nA given alias name can't be used for more than one entity set.", +"items": { +"type": "string" +}, +"type": "array" +}, +"expressions": { +"description": "List of available expressions.", +"items": { +"$ref": "WafExpressionSetExpression" +}, +"type": "array" +}, +"id": { +"description": "Google specified expression set ID. The format should be:\n- E.g. XSS-20170329\nrequired", +"type": "string" +} +}, +"type": "object" +}, +"WafExpressionSetExpression": { +"id": "WafExpressionSetExpression", +"properties": { +"id": { +"description": "Expression ID should uniquely identify the origin of the expression.\nE.g. owasp-crs-v020901-id973337 identifies Owasp core rule set\nversion 2.9.1 rule id 973337.\nThe ID could be used to determine the individual attack definition\nthat has been detected. It could also be used to exclude it from\nthe policy in case of false positive.\nrequired", +"type": "string" +}, +"sensitivity": { +"description": "The sensitivity value associated with the WAF rule ID. This corresponds\nto the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for\nopt-in only rules.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"WeightedBackendService": { +"description": "In contrast to a single BackendService in \nHttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across\nmultiple backend services. The volume of traffic for each\nbackend service is proportional to the weight specified\nin each WeightedBackendService", +"id": "WeightedBackendService", +"properties": { +"backendService": { +"description": "The full or partial URL to the default BackendService\nresource. Before\nforwarding the request to backendService, the load balancer\napplies any relevant headerActions specified as part of thisbackendServiceWeight.", +"type": "string" +}, +"headerAction": { +"$ref": "HttpHeaderAction", +"description": "Specifies changes to request and response headers that need to take\neffect for the selected backendService.\n\nheaderAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.\n\nheaderAction is not supported for load balancers that have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." +}, +"weight": { +"description": "Specifies the fraction of traffic sent to a backend service,\ncomputed asweight / (sum of all weightedBackendService weights in routeAction).\n\nThe selection of a backend service is determined only for new traffic.\nOnce a user's request has been directed to a backend service,\nsubsequent requests are sent to the same backend service as\ndetermined by the backend service's session affinity policy.\nDon't configure session affinity if you're using weighted traffic\nsplitting. If you do, the weighted traffic splitting configuration takes\nprecedence.\n\nThe value must be from 0 to 1000.", +"format": "uint32", +"type": "integer" +} +}, +"type": "object" +}, +"Wire": { +"description": "A pseudowire that connects two Interconnect connections.", +"id": "Wire", +"properties": { +"adminEnabled": { +"description": "Output only. [Output Only] Indicates whether the wire is enabled.\nWhen false, the wire is disabled. When true and when the wire group of\nthe wire is also enabled, the wire is enabled. Defaults to true.", +"readOnly": true, +"type": "boolean" +}, +"endpoints": { +"description": "Output only. Wire endpoints are specific Interconnect connections.", +"items": { +"$ref": "WireEndpoint" +}, +"readOnly": true, +"type": "array" +}, +"label": { +"description": "Output only. [Output Only] A label that identifies the wire. The format of this label\ncombines the existing labels of the wire group endpoints and Interconnect\nconnections used by this wire in alphabetical order as follows:\n`ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:\n \n - ENDPOINT_A and ENDPOINT_B: are the labels\n that you entered as map keys when you specified the wire group endpoint\n objects.\n - CONNECTION_A1 and CONNECTION_B1: are the\n labels that you entered as map keys when you specified the wire group\n Interconnect objects.", +"readOnly": true, +"type": "string" +}, +"wireProperties": { +"$ref": "WireProperties", +"description": "Output only. [Output Only] Properties of the wire.", +"readOnly": true +} +}, +"type": "object" +}, +"WireEndpoint": { +"description": "Wire endpoints are specific Interconnect connections.", +"id": "WireEndpoint", +"properties": { +"interconnect": { +"readOnly": true, +"type": "string" +}, +"vlanTag": { +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"WireGroup": { +"description": "A resource that represents a group of redundant wires.", +"id": "WireGroup", +"properties": { +"adminEnabled": { +"description": "Indicates whether the wires in the wire group are enabled. When false, the\nwires in the wire group are disabled. When true and when\nthere is simultaneously no wire-specific override of `adminEnabled` to\nfalse, a given wire is enabled. Defaults to true.", +"type": "boolean" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of the wire group.", +"type": "string" +}, +"endpoints": { +"additionalProperties": { +"$ref": "WireGroupEndpoint" +}, +"description": "A map that contains the logical endpoints of the wire group. Specify\nkey-value pairs for the map as follows:\n \n - Key: an RFC1035 user-specified label.\n - Value: an Endpoint object.", +"type": "object" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#wireGroup", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.", +"readOnly": true, +"type": "string" +}, +"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.\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" +}, +"reconciling": { +"description": "Output only. [Output Only] Indicates whether there are wire changes yet to be processed.", +"readOnly": true, +"type": "boolean" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"topology": { +"$ref": "WireGroupTopology", +"description": "Output only. Topology details for the wire group configuration.", +"readOnly": true +}, +"wireProperties": { +"$ref": "WireProperties", +"description": "Properties for all wires in the wire group." +}, +"wires": { +"description": "Output only. The single/redundant wire(s) managed by the wire group.", +"items": { +"$ref": "Wire" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"WireGroupEndpoint": { +"description": "A logical endpoint for the wire group. An endpoint represents a metro that\ncontains redundant Interconnect connections. A wire group is created\nbetween two endpoints.", +"id": "WireGroupEndpoint", +"properties": { +"interconnects": { +"additionalProperties": { +"$ref": "WireGroupEndpointInterconnect" +}, +"description": "A map that contains the redundant Interconnect connections. Specify\nkey-value pairs for the map as follows:\n \n - Key: an RFC1035 user-specified label.\n - Value: an Interconnect object.", +"type": "object" +} +}, +"type": "object" +}, +"WireGroupEndpointInterconnect": { +"description": "The redundant Interconnect connections for this endpoint.", +"id": "WireGroupEndpointInterconnect", +"properties": { +"interconnect": { +"description": "Required. An Interconnect connection. You can specify the connection as\na partial or full URL. If the connection is in a different project from\nthe cross-site network, use a format that specifies the project. See\nthe following examples of partial and full URLs:\n \n \n \n global/interconnects/NAME\n \n \n projects/PROJECT_ID/global/interconnects/NAME\n \n - \n https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME", +"type": "string" +}, +"vlanTags": { +"description": "Required. To configure the wire group for VLAN mode, enter a VLAN tag,\nwhich is a number from `2` to `4093`. You can autoallocate a tag by\nentering `0`. To configure the wire group for port mode, enter `-1`.\nReview the following guidelines:\n \n - A VLAN tag must be unique for an Interconnect connection across all\n attachments and wire groups.\n - Both endpoints of a wire must use the same VLAN tag value.\n - Single wire and redundant type wire groups must have only one\n VLAN tag.\n - Port mode pseudowires must have a single VLAN tag with a value of\n `-1` for both endpoints.\n - Box and cross type wire groups must have two VLAN tags. The first\n is for the same-zone pseudowire, and the second is for the cross-zone\n pseudowire.", +"items": { +"format": "int32", +"type": "integer" +}, +"type": "array" +} +}, +"type": "object" +}, +"WireGroupList": { +"description": "Response for the list request.", +"id": "WireGroupList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of wire group resources.", +"items": { +"$ref": "WireGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#wireGroup", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.", +"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] Server-defined URL for this resource.", +"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" +}, +"WireGroupTopology": { +"description": "Topology details for the wire group.", +"id": "WireGroupTopology", +"properties": { +"endpoints": { +"description": "Output only. Topology details for all endpoints in the wire group.", +"items": { +"$ref": "WireGroupTopologyEndpoint" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"WireGroupTopologyEndpoint": { +"description": "Topology details for a single wire group endpoint.", +"id": "WireGroupTopologyEndpoint", +"properties": { +"city": { +"description": "Output only. The InterconnectLocation.city (metropolitan area designator) that all\ninterconnects are located in.", +"readOnly": true, +"type": "string" +}, +"label": { +"description": "Output only. Endpoint label from the wire group.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"WireProperties": { +"description": "The properties of a wire.", +"id": "WireProperties", +"properties": { +"bandwidthAllocation": { +"description": "The configuration of the bandwidth allocation, one of the following:\n \n - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation\n (and associated charges) for each wire in the group.\n - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures\n one unmetered bandwidth allocation for the wire group. The unmetered\n bandwidth is divided equally across each wire in the group, but dynamic\n throttling reallocates unused unmetered bandwidth from unused or underused\n wires to other wires in the group.", +"enum": [ +"ALLOCATE_PER_WIRE", +"SHARED_WITH_WIRE_GROUP" +], +"enumDescriptions": [ +"Configures a separate unmetered bandwidth allocation (and associated\ncharges) for each wire in the group.", +"This is the default behavior. Configures one unmetered bandwidth\nallocation for the wire group. The unmetered bandwidth is divided equally\nacross each wire in the group, but dynamic throttling reallocates unused\nunmetered bandwidth from unused or underused wires to other wires in the\ngroup." +], +"type": "string" +}, +"bandwidthUnmetered": { +"description": "The unmetered bandwidth in Gigabits per second, using decimal units. `10`\nis 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.", +"format": "int64", +"type": "string" +}, +"faultResponse": { +"description": "Response when a fault is detected in a pseudowire:\n \n - NONE: default.\n - DISABLE_PORT: set the port line protocol down when inline probes\n detect a fault. This setting is only permitted on port mode\n pseudowires.", +"enum": [ +"DISABLE_PORT", +"NONE" +], +"enumDescriptions": [ +"Set the port line protocol down when inline probes detect a fault. This\nsetting is only permitted on port mode pseudowires.", +"Default." +], +"type": "string" +} +}, +"type": "object" +}, +"WorkloadIdentityConfig": { +"id": "WorkloadIdentityConfig", +"properties": { +"identity": { +"type": "string" +}, +"identityCertificateEnabled": { +"type": "boolean" +} +}, +"type": "object" +}, +"XpnHostList": { +"id": "XpnHostList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "[Output Only] A list of shared VPC host project URLs.", +"items": { +"$ref": "Project" +}, +"type": "array" +}, +"kind": { +"default": "compute#xpnHostList", +"description": "Output only. [Output Only] Type of resource. Always compute#xpnHostList for\nlists of shared VPC hosts.", +"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.", +"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" +}, +"XpnResourceId": { +"description": "Service resource (a.k.a service project) ID.", +"id": "XpnResourceId", +"properties": { +"id": { +"description": "The ID of the service resource. In the case of projects, this field\nsupports project id (e.g., my-project-123) and project number\n(e.g. 12345678).", +"type": "string" +}, +"type": { +"description": "The type of the service resource.", +"enum": [ +"PROJECT", +"XPN_RESOURCE_TYPE_UNSPECIFIED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"Zone": { +"description": "Represents a Zone resource.\n\nA zone is a deployment area. These deployment areas are subsets of a region.\nFor example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and\nZones.", +"id": "Zone", +"properties": { +"availableCpuPlatforms": { +"description": "[Output Only] Available cpu/platform selections for the zone.", +"items": { +"type": "string" +}, +"type": "array" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp inRFC3339\ntext format.", +"type": "string" +}, +"deprecated": { +"$ref": "DeprecationStatus", +"description": "[Output Only] The deprecation status associated with this zone." +}, +"description": { +"description": "[Output Only] Textual description of the resource.", +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#zone", +"description": "Output only. [Output Only] Type of the resource. Always compute#zone for\nzones.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "[Output Only] Name of the resource.", +"type": "string" +}, +"region": { +"description": "[Output Only] Full URL reference to the region which hosts the zone.", +"type": "string" +}, +"resourceStatus": { +"$ref": "ZoneResourceStatus", +"readOnly": true +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"status": { +"description": "[Output Only] Status of the zone, either UP orDOWN.", +"enum": [ +"DOWN", +"UP" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"supportsPzs": { +"description": "Output only. [Output Only] Reserved for future use.", +"readOnly": true, +"type": "boolean" +} +}, +"type": "object" +}, +"ZoneList": { +"description": "Contains a list of zone resources.", +"id": "ZoneList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of Zone resources.", +"items": { +"$ref": "Zone" +}, +"type": "array" +}, +"kind": { +"default": "compute#zoneList", +"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.", +"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" +}, +"ZoneResourceStatus": { +"id": "ZoneResourceStatus", +"properties": { +"upcomingMaintenances": { +"description": "Output only. [Output Only] The upcoming maintenance schedule.", +"items": { +"$ref": "PeriodicPartialMaintenanceSchedule" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"ZoneSetLabelsRequest": { +"id": "ZoneSetLabelsRequest", +"properties": { +"labelFingerprint": { +"description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash in order to update or change\nlabels. Make a get() request to the resource to get the latest\nfingerprint.", +"format": "byte", +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The labels to set for this resource.", +"type": "object" +} +}, +"type": "object" +}, +"ZoneSetNestedPolicyRequest": { +"id": "ZoneSetNestedPolicyRequest", +"properties": { +"bindings": { +"description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", +"format": "byte", +"type": "string" +}, +"policy": { +"$ref": "Policy", +"description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." +} +}, +"type": "object" +}, +"ZoneSetPolicyRequest": { +"id": "ZoneSetPolicyRequest", +"properties": { +"bindings": { +"description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", +"items": { +"$ref": "Binding" +}, +"type": "array" +}, +"etag": { +"description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", +"format": "byte", +"type": "string" +}, +"policy": { +"$ref": "Policy", +"description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." +} +}, +"type": "object" +} +}, +"servicePath": "compute/v1/", +"serviceVersion": "2026-10-01-preview", +"title": "Compute Engine API", +"version": "preview", +"version_module": true +} \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/dataform.v1.json b/googleapiclient/discovery_cache/documents/dataform.v1.json index f943fba9c5..9765fa5e6a 100644 --- a/googleapiclient/discovery_cache/documents/dataform.v1.json +++ b/googleapiclient/discovery_cache/documents/dataform.v1.json @@ -3220,7 +3220,7 @@ } } }, -"revision": "20260906", +"revision": "20260920", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4163,7 +4163,7 @@ "id": "FileSearchResult", "properties": { "path": { -"description": "File system path relative to the workspace root.", +"description": "File system path relative to the file tree root.", "type": "string" } }, diff --git a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json index a0c8f966a4..f8051ae51c 100644 --- a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json @@ -3428,7 +3428,7 @@ } } }, -"revision": "20260906", +"revision": "20260920", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4466,7 +4466,7 @@ "id": "FileSearchResult", "properties": { "path": { -"description": "File system path relative to the workspace root.", +"description": "File system path relative to the file tree root.", "type": "string" } }, diff --git a/googleapiclient/discovery_cache/documents/datalineage.v1.json b/googleapiclient/discovery_cache/documents/datalineage.v1.json index e84ae447f8..3553fcc83f 100644 --- a/googleapiclient/discovery_cache/documents/datalineage.v1.json +++ b/googleapiclient/discovery_cache/documents/datalineage.v1.json @@ -253,6 +253,7 @@ "location": "us-west4" }, { +"deprecated": true, "description": "Regional Endpoint", "endpointUrl": "https://datalineage.us-west8.rep.googleapis.com/", "location": "us-west8" @@ -1278,7 +1279,7 @@ } } }, -"revision": "20260822", +"revision": "20260912", "rootUrl": "https://datalineage.googleapis.com/", "schemas": { "GoogleCloudDatacatalogLineageConfigmanagementV1Config": { diff --git a/googleapiclient/discovery_cache/documents/dataplex.v1.json b/googleapiclient/discovery_cache/documents/dataplex.v1.json index 4a058f5b5c..e0f3b25de8 100644 --- a/googleapiclient/discovery_cache/documents/dataplex.v1.json +++ b/googleapiclient/discovery_cache/documents/dataplex.v1.json @@ -7631,7 +7631,7 @@ ], "parameters": { "name": { -"description": "Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/MetadataFeeds/{metadata_feed_id}.", +"description": "Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/metadataFeeds/{metadata_feed_id}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/metadataFeeds/[^/]+$", "required": true, @@ -7657,7 +7657,7 @@ ], "parameters": { "name": { -"description": "Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/MetadataFeeds/{metadata_feed_id}.", +"description": "Required. The resource name of the metadata feed, in the format projects/{project_id_or_number}/locations/{location_id}/metadataFeeds/{metadata_feed_id}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/metadataFeeds/[^/]+$", "required": true, @@ -8044,7 +8044,7 @@ } } }, -"revision": "20260823", +"revision": "20260917", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -11766,6 +11766,10 @@ "format": "google-datetime", "type": "string" }, +"dataDocumentation": { +"$ref": "GoogleCloudDataplexV1DataScanEventDataDocumentationResult", +"description": "Data documentation result for data documentation (insights) scan." +}, "dataProfile": { "$ref": "GoogleCloudDataplexV1DataScanEventDataProfileResult", "description": "Data profile result for data profile type data scan." @@ -11881,6 +11885,64 @@ }, "type": "object" }, +"GoogleCloudDataplexV1DataScanEventDataDocumentationResult": { +"description": "Data documentation result for data scan job.", +"id": "GoogleCloudDataplexV1DataScanEventDataDocumentationResult", +"properties": { +"billableTokenUsage": { +"$ref": "GoogleCloudDataplexV1DataScanEventDataDocumentationResultTokenUsage", +"description": "Breakdown of token consumption for the data documentation scan." +} +}, +"type": "object" +}, +"GoogleCloudDataplexV1DataScanEventDataDocumentationResultTokenUsage": { +"description": "Captures structured token usage breakdown for LLM-powered scans.", +"id": "GoogleCloudDataplexV1DataScanEventDataDocumentationResultTokenUsage", +"properties": { +"cachedContentTokenCount": { +"description": "Billable cached content tokens (billed at discounted prompt caching SKU).", +"format": "int64", +"type": "string" +}, +"candidatesTokenCount": { +"description": "Generated candidate response tokens.", +"format": "int64", +"type": "string" +}, +"inputTokenCount": { +"description": "Billable non-cached input tokens.", +"format": "int64", +"type": "string" +}, +"outputTokenCount": { +"description": "Billable output tokens (candidates + thoughts).", +"format": "int64", +"type": "string" +}, +"promptTokenCount": { +"description": "Base prompt and system instructions tokens.", +"format": "int64", +"type": "string" +}, +"thoughtsTokenCount": { +"description": "Reasoning / Chain-of-Thought tokens.", +"format": "int64", +"type": "string" +}, +"toolUsePromptTokenCount": { +"description": "Tool use context tokens (schema, profile, query history).", +"format": "int64", +"type": "string" +}, +"totalTokenCount": { +"description": "Total billable tokens (billable_input + billable_cached + billable_output). Evaluates to 0 for failed or cancelled jobs.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs": { "description": "Applied configs for data profile type data scan job.", "id": "GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs", @@ -11905,6 +11967,11 @@ "description": "Data profile result for data scan job.", "id": "GoogleCloudDataplexV1DataScanEventDataProfileResult", "properties": { +"dcuConsumed": { +"description": "Dataplex Compute Units (DCUs) used in the data scan job.", +"format": "double", +"type": "number" +}, "rowCount": { "description": "The count of rows processed in the data scan job.", "format": "int64", diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json index 9f53af8e98..3f2bd620b7 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json @@ -9937,7 +9937,7 @@ } } }, -"revision": "20260915", +"revision": "20260922", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "A2aV1APIKeySecurityScheme": { @@ -14665,7 +14665,7 @@ "type": "integer" }, "selectedSuggestion": { -"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", +"description": "Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", "type": "string" } }, @@ -19793,7 +19793,7 @@ "type": "string" }, "searchQuery": { -"description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", "type": "string" } }, @@ -22408,7 +22408,7 @@ false "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1CustomAttribute" }, -"description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", +"description": "Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", "type": "object" }, "attributionToken": { @@ -23059,6 +23059,11 @@ false "name": { "description": "The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.", "type": "string" +}, +"tag": { +"description": "Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on.", +"readOnly": true, +"type": "string" } }, "type": "object" @@ -29162,6 +29167,11 @@ false "description": "Optional. Whether the license config should be auto renewed when it reaches the end date.", "type": "boolean" }, +"billingAccountLicenseConfig": { +"description": "Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set.", +"readOnly": true, +"type": "string" +}, "earlyTerminated": { "description": "Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3.", "readOnly": true, diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json index 730b81d507..502c6e664d 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json @@ -6619,6 +6619,45 @@ } } }, +"collaborativeProjects": { +"resources": { +"knowledgeSpaces": { +"resources": { +"operations": { +"methods": { +"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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/collaborativeProjects/{collaborativeProjectsId}/knowledgeSpaces/{knowledgeSpacesId}/operations/{operationsId}", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.operations.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "The name of the operation resource.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/collaborativeProjects/[^/]+/knowledgeSpaces/[^/]+/operations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1alpha/{+name}", +"response": { +"$ref": "GoogleLongrunningOperation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite", +"https://www.googleapis.com/auth/discoveryengine.serving.readwrite" +] +} +} +} +} +} +} +}, "completionConfig": { "methods": { "completeQuery": { @@ -13653,7 +13692,7 @@ } } }, -"revision": "20260915", +"revision": "20260922", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -19427,12 +19466,14 @@ "enum": [ "SCOPE_UNSPECIFIED", "RESTRICTED", -"ALL_USERS" +"ALL_USERS", +"PRIVATE" ], "enumDescriptions": [ "Default value. Behaves as `RESTRICTED`.", -"The agent is shared based on the IAM policy.", -"The agent is shared with all users." +"The agent is shared with specific users based on the IAM policy.", +"The agent is shared with all users.", +"The agent is not shared: it is only accessible to its creator and to administrators." ], "type": "string" } @@ -23528,7 +23569,7 @@ "type": "integer" }, "selectedSuggestion": { -"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", +"description": "Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", "type": "string" } }, @@ -26932,6 +26973,10 @@ "outputConfig": { "$ref": "GoogleCloudDiscoveryengineV1alphaOutputConfig", "description": "Required. The output location of the data." +}, +"startDate": { +"$ref": "GoogleTypeDate", +"description": "Optional. The earliest date (inclusive), interpreted in the UTC time zone, whose metrics are included in the export. If unset, defaults to 30 days before the current UTC date. The value must be a valid calendar date that is not in the future and not older than 180 days (the source data retention window); otherwise the request fails with `INVALID_ARGUMENT`." } }, "type": "object" @@ -28574,6 +28619,11 @@ "description": "Optional. Whether the license config should be auto renewed when it reaches the end date.", "type": "boolean" }, +"billingAccountLicenseConfig": { +"description": "Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set.", +"readOnly": true, +"type": "string" +}, "earlyTerminated": { "description": "Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3.", "readOnly": true, @@ -31456,7 +31506,7 @@ "type": "string" }, "searchQuery": { -"description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", "type": "string" } }, @@ -34653,7 +34703,7 @@ false "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1alphaCustomAttribute" }, -"description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", +"description": "Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", "type": "object" }, "attributionToken": { @@ -35363,6 +35413,11 @@ false "name": { "description": "The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.", "type": "string" +}, +"tag": { +"description": "Output only. The version-independent label of the connector backing this collection, mirroring `DataConnector.tag`. Unlike the version-pinned data store id it survives a connector version upgrade, so an upgraded connector keeps the same tag. Not a unique key. As `DataConnector.tag` documents, several connectors may share a tag under the same (project, location, collection, data_source), and tag-based lookup resolves to the one with the greatest create_time. Clients must not treat this as a connector identifier. Empty when the connector was created before the tag-write launch, and for synthetic placeholder entries, which have no underlying `DataConnector`. Populated only when `ConnectorsFeature.enable_connector_tag` is on.", +"readOnly": true, +"type": "string" } }, "type": "object" diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json index 189d5a2358..a2cc284982 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json @@ -9680,7 +9680,7 @@ } } }, -"revision": "20260915", +"revision": "20260922", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -20156,6 +20156,11 @@ "description": "Optional. Whether the license config should be auto renewed when it reaches the end date.", "type": "boolean" }, +"billingAccountLicenseConfig": { +"description": "Output only. The name of the BillingAccountLicenseConfig from which this LicenseConfig is assigned, if this field is set.", +"readOnly": true, +"type": "string" +}, "earlyTerminated": { "description": "Output only. Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3.", "readOnly": true, @@ -26505,7 +26510,7 @@ false "type": "integer" }, "selectedSuggestion": { -"description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", +"description": "Optional. End user selected CompleteQueryResponse.QuerySuggestion.suggestion.", "type": "string" } }, @@ -31606,7 +31611,7 @@ false "type": "string" }, "searchQuery": { -"description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.", "type": "string" } }, @@ -34541,7 +34546,7 @@ false "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1betaCustomAttribute" }, -"description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", +"description": "Optional. Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.", "type": "object" }, "attributionToken": { diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v2.json b/googleapiclient/discovery_cache/documents/displayvideo.v2.json index 55acb76afe..daae8abcb6 100644 --- a/googleapiclient/discovery_cache/documents/displayvideo.v2.json +++ b/googleapiclient/discovery_cache/documents/displayvideo.v2.json @@ -7823,7 +7823,7 @@ } } }, -"revision": "20260915", +"revision": "20260923", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -9676,7 +9676,7 @@ "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." } }, "type": "object" @@ -10323,32 +10323,33 @@ "id": "CommonInStreamAttribute", "properties": { "actionButtonLabel": { -"description": "The text on the call-to-action button.", +"description": "Optional. The text on the call-to-action button.", "type": "string" }, "actionHeadline": { -"description": "The headline of the call-to-action banner.", +"description": "Optional. The headline of the call-to-action banner.", "type": "string" }, "companionBanner": { "$ref": "ImageAsset", -"description": "The image which shows next to the video ad." +"description": "Optional. The image which shows next to the video ad." }, "displayUrl": { -"description": "The webpage address that appears with the ad.", +"description": "Required. The webpage address that appears with the ad.", "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "video": { "$ref": "YoutubeVideoDetails", -"description": "The YouTube video of the ad." +"description": "Required. The YouTube video of the ad." } }, "type": "object" @@ -11934,9 +11935,8 @@ false "type": "string" }, "youtubeAndPartnersBidMultiplier": { -"description": "Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", +"description": "Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", "format": "double", -"readOnly": true, "type": "number" } }, @@ -14491,13 +14491,13 @@ false "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -16452,13 +16452,13 @@ true "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -18975,14 +18975,14 @@ true "id": "VideoPerformanceAd", "properties": { "actionButtonLabels": { -"description": "The list of text assets shown on the call-to-action button.", +"description": "Optional. The list of text assets shown on the call-to-action button.", "items": { "type": "string" }, "type": "array" }, "companionBanners": { -"description": "The list of companion banners used by this ad.", +"description": "Optional. The list of companion banners used by this ad.", "items": { "$ref": "ImageAsset" }, @@ -18992,22 +18992,22 @@ true "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" }, "descriptions": { -"description": "The list of descriptions shown on the call-to-action banner.", +"description": "Optional. The list of descriptions shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "displayUrlBreadcrumb1": { -"description": "The first piece after the domain in the display URL.", +"description": "Optional. The first piece after the domain in the display URL.", "type": "string" }, "displayUrlBreadcrumb2": { -"description": "The second piece after the domain in the display URL.", +"description": "Optional. The second piece after the domain in the display URL.", "type": "string" }, "domain": { @@ -19016,29 +19016,30 @@ true "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "headlines": { -"description": "The list of headlines shown on the call-to-action banner.", +"description": "Optional. The list of headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "longHeadlines": { -"description": "The list of long headlines shown on the call-to-action banner.", +"description": "Optional. The list of long headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "videos": { -"description": "The list of YouTube video assets used by this ad.", +"description": "Required. The list of YouTube video assets used by this ad.", "items": { "$ref": "YoutubeVideoDetails" }, @@ -19633,7 +19634,7 @@ true "type": "string" }, "unavailableReason": { -"description": "The reason why the video data is not available.", +"description": "Output only. The reason why the video data is not available.", "enum": [ "VIDEO_UNAVAILABLE_REASON_UNSPECIFIED", "VIDEO_UNAVAILABLE_REASON_PRIVATE", @@ -19644,6 +19645,7 @@ true "The video is private.", "The video is deleted." ], +"readOnly": true, "type": "string" }, "videoAssetId": { diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v3.json b/googleapiclient/discovery_cache/documents/displayvideo.v3.json index dc882fb9dd..d98d25bb1a 100644 --- a/googleapiclient/discovery_cache/documents/displayvideo.v3.json +++ b/googleapiclient/discovery_cache/documents/displayvideo.v3.json @@ -8360,7 +8360,7 @@ } } }, -"revision": "20260915", +"revision": "20260923", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -8616,8 +8616,7 @@ }, "bumperAd": { "$ref": "BumperAd", -"description": "Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.", -"readOnly": true +"description": "Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach." }, "dcmTrackingInfo": { "$ref": "DcmTrackingInfo", @@ -8625,19 +8624,19 @@ }, "demandGenCarouselAd": { "$ref": "DemandGenCarouselAd", -"description": "Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd)." +"description": "Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd)." }, "demandGenImageAd": { "$ref": "DemandGenImageAd", -"description": "Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd)." +"description": "Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd)." }, "demandGenProductAd": { "$ref": "DemandGenProductAd", -"description": "Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd)." +"description": "Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd)." }, "demandGenVideoAd": { "$ref": "DemandGenVideoAd", -"description": "Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd)." +"description": "Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd)." }, "displayName": { "description": "Required. The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes.", @@ -8670,8 +8669,7 @@ }, "inStreamAd": { "$ref": "InStreamAd", -"description": "Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.", -"readOnly": true +"description": "Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives." }, "mastheadAd": { "$ref": "MastheadAd", @@ -8685,8 +8683,7 @@ }, "nonSkippableAd": { "$ref": "NonSkippableAd", -"description": "Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.", -"readOnly": true +"description": "Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives." }, "videoDiscoverAd": { "$ref": "VideoDiscoveryAd", @@ -8695,8 +8692,7 @@ }, "videoPerformanceAd": { "$ref": "VideoPerformanceAd", -"description": "Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.", -"readOnly": true +"description": "Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product." } }, "type": "object" @@ -12031,7 +12027,7 @@ "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." } }, "type": "object" @@ -12713,32 +12709,33 @@ "id": "CommonInStreamAttribute", "properties": { "actionButtonLabel": { -"description": "The text on the call-to-action button.", +"description": "Optional. The text on the call-to-action button.", "type": "string" }, "actionHeadline": { -"description": "The headline of the call-to-action banner.", +"description": "Optional. The headline of the call-to-action banner.", "type": "string" }, "companionBanner": { "$ref": "ImageAsset", -"description": "The image which shows next to the video ad." +"description": "Optional. The image which shows next to the video ad." }, "displayUrl": { -"description": "The webpage address that appears with the ad.", +"description": "Required. The webpage address that appears with the ad.", "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "video": { "$ref": "YoutubeVideoDetails", -"description": "The YouTube video of the ad." +"description": "Required. The YouTube video of the ad." } }, "type": "object" @@ -14975,9 +14972,8 @@ false "type": "string" }, "youtubeAndPartnersBidMultiplier": { -"description": "Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", +"description": "Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", "format": "double", -"readOnly": true, "type": "number" } }, @@ -17642,13 +17638,13 @@ false "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -19630,13 +19626,13 @@ false "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -22237,14 +22233,14 @@ false "id": "VideoPerformanceAd", "properties": { "actionButtonLabels": { -"description": "The list of text assets shown on the call-to-action button.", +"description": "Optional. The list of text assets shown on the call-to-action button.", "items": { "type": "string" }, "type": "array" }, "companionBanners": { -"description": "The list of companion banners used by this ad.", +"description": "Optional. The list of companion banners used by this ad.", "items": { "$ref": "ImageAsset" }, @@ -22254,22 +22250,22 @@ false "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" }, "descriptions": { -"description": "The list of descriptions shown on the call-to-action banner.", +"description": "Optional. The list of descriptions shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "displayUrlBreadcrumb1": { -"description": "The first piece after the domain in the display URL.", +"description": "Optional. The first piece after the domain in the display URL.", "type": "string" }, "displayUrlBreadcrumb2": { -"description": "The second piece after the domain in the display URL.", +"description": "Optional. The second piece after the domain in the display URL.", "type": "string" }, "domain": { @@ -22278,29 +22274,30 @@ false "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "headlines": { -"description": "The list of headlines shown on the call-to-action banner.", +"description": "Optional. The list of headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "longHeadlines": { -"description": "The list of long headlines shown on the call-to-action banner.", +"description": "Optional. The list of long headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "videos": { -"description": "The list of YouTube video assets used by this ad.", +"description": "Required. The list of YouTube video assets used by this ad.", "items": { "$ref": "YoutubeVideoDetails" }, @@ -22651,7 +22648,7 @@ false "type": "string" }, "unavailableReason": { -"description": "The reason why the video data is not available.", +"description": "Output only. The reason why the video data is not available.", "enum": [ "VIDEO_UNAVAILABLE_REASON_UNSPECIFIED", "VIDEO_UNAVAILABLE_REASON_PRIVATE", @@ -22662,6 +22659,7 @@ false "The video is private.", "The video is deleted." ], +"readOnly": true, "type": "string" }, "videoAssetId": { diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v4.json b/googleapiclient/discovery_cache/documents/displayvideo.v4.json index 27330d668c..a9149d5b5e 100644 --- a/googleapiclient/discovery_cache/documents/displayvideo.v4.json +++ b/googleapiclient/discovery_cache/documents/displayvideo.v4.json @@ -9618,7 +9618,7 @@ } } }, -"revision": "20260915", +"revision": "20260923", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -9944,8 +9944,7 @@ }, "bumperAd": { "$ref": "BumperAd", -"description": "Output only. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.", -"readOnly": true +"description": "Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach." }, "dcmTrackingInfo": { "$ref": "DcmTrackingInfo", @@ -9953,19 +9952,19 @@ }, "demandGenCarouselAd": { "$ref": "DemandGenCarouselAd", -"description": "Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd)." +"description": "Optional. Details of a [Demand Gen carousel ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd)." }, "demandGenImageAd": { "$ref": "DemandGenImageAd", -"description": "Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd)." +"description": "Optional. Details of a [Demand Gen image ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd)." }, "demandGenProductAd": { "$ref": "DemandGenProductAd", -"description": "Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd)." +"description": "Optional. Details of a [Demand Gen product ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd)." }, "demandGenVideoAd": { "$ref": "DemandGenVideoAd", -"description": "Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd)." +"description": "Optional. Details of a [Demand Gen video ad](//support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd)." }, "displayName": { "description": "Required. The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes.", @@ -9998,8 +9997,7 @@ }, "inStreamAd": { "$ref": "InStreamAd", -"description": "Output only. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.", -"readOnly": true +"description": "Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives." }, "mastheadAd": { "$ref": "MastheadAd", @@ -10013,8 +10011,7 @@ }, "nonSkippableAd": { "$ref": "NonSkippableAd", -"description": "Output only. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.", -"readOnly": true +"description": "Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives." }, "videoDiscoverAd": { "$ref": "VideoDiscoveryAd", @@ -10023,8 +10020,7 @@ }, "videoPerformanceAd": { "$ref": "VideoPerformanceAd", -"description": "Output only. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.", -"readOnly": true +"description": "Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product." } }, "type": "object" @@ -13566,7 +13562,7 @@ "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." } }, "type": "object" @@ -14264,32 +14260,33 @@ "id": "CommonInStreamAttribute", "properties": { "actionButtonLabel": { -"description": "The text on the call-to-action button.", +"description": "Optional. The text on the call-to-action button.", "type": "string" }, "actionHeadline": { -"description": "The headline of the call-to-action banner.", +"description": "Optional. The headline of the call-to-action banner.", "type": "string" }, "companionBanner": { "$ref": "ImageAsset", -"description": "The image which shows next to the video ad." +"description": "Optional. The image which shows next to the video ad." }, "displayUrl": { -"description": "The webpage address that appears with the ad.", +"description": "Required. The webpage address that appears with the ad.", "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "video": { "$ref": "YoutubeVideoDetails", -"description": "The YouTube video of the ad." +"description": "Required. The YouTube video of the ad." } }, "type": "object" @@ -16688,9 +16685,8 @@ false "type": "string" }, "youtubeAndPartnersBidMultiplier": { -"description": "Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", +"description": "Optional. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price. For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0. Only applicable to YouTube and Partners line items.", "format": "double", -"readOnly": true, "type": "number" } }, @@ -19652,13 +19648,13 @@ false "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -22228,13 +22224,13 @@ false "properties": { "commonInStreamAttribute": { "$ref": "CommonInStreamAttribute", -"description": "Common ad attributes." +"description": "Required. Common ad attributes." }, "customParameters": { "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" } }, @@ -25884,14 +25880,14 @@ false "id": "VideoPerformanceAd", "properties": { "actionButtonLabels": { -"description": "The list of text assets shown on the call-to-action button.", +"description": "Optional. The list of text assets shown on the call-to-action button.", "items": { "type": "string" }, "type": "array" }, "companionBanners": { -"description": "The list of companion banners used by this ad.", +"description": "Optional. The list of companion banners used by this ad.", "items": { "$ref": "ImageAsset" }, @@ -25901,22 +25897,22 @@ false "additionalProperties": { "type": "string" }, -"description": "The custom parameters and accompanying values to add to the tracking URL.", +"description": "Optional. The custom parameters and accompanying values to add to the tracking URL.", "type": "object" }, "descriptions": { -"description": "The list of descriptions shown on the call-to-action banner.", +"description": "Optional. The list of descriptions shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "displayUrlBreadcrumb1": { -"description": "The first piece after the domain in the display URL.", +"description": "Optional. The first piece after the domain in the display URL.", "type": "string" }, "displayUrlBreadcrumb2": { -"description": "The second piece after the domain in the display URL.", +"description": "Optional. The second piece after the domain in the display URL.", "type": "string" }, "domain": { @@ -25925,29 +25921,30 @@ false "type": "string" }, "finalUrl": { -"description": "The URL address of the webpage that people reach after they click the ad.", +"description": "Required. The URL address of the webpage that people reach after they click the ad.", "type": "string" }, "headlines": { -"description": "The list of headlines shown on the call-to-action banner.", +"description": "Optional. The list of headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "longHeadlines": { -"description": "The list of long headlines shown on the call-to-action banner.", +"description": "Optional. The list of long headlines shown on the call-to-action banner.", "items": { "type": "string" }, "type": "array" }, "trackingUrl": { -"description": "The URL address loaded in the background for tracking purposes.", +"description": "Output only. The URL address loaded in the background for tracking purposes.", +"readOnly": true, "type": "string" }, "videos": { -"description": "The list of YouTube video assets used by this ad.", +"description": "Required. The list of YouTube video assets used by this ad.", "items": { "$ref": "YoutubeVideoDetails" }, @@ -26521,7 +26518,7 @@ false "type": "string" }, "unavailableReason": { -"description": "The reason why the video data is not available.", +"description": "Output only. The reason why the video data is not available.", "enum": [ "VIDEO_UNAVAILABLE_REASON_UNSPECIFIED", "VIDEO_UNAVAILABLE_REASON_PRIVATE", @@ -26532,6 +26529,7 @@ false "The video is private.", "The video is deleted." ], +"readOnly": true, "type": "string" }, "videoAssetId": { diff --git a/googleapiclient/discovery_cache/documents/drive.v2.json b/googleapiclient/discovery_cache/documents/drive.v2.json index 87660bed26..4bfb88d045 100644 --- a/googleapiclient/discovery_cache/documents/drive.v2.json +++ b/googleapiclient/discovery_cache/documents/drive.v2.json @@ -2649,7 +2649,7 @@ "permissions": { "methods": { "delete": { -"description": "Deletes a permission from a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.", +"description": "Deletes a permission from a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions/{permissionId}", "httpMethod": "DELETE", "id": "drive.permissions.delete", @@ -2791,7 +2791,7 @@ ] }, "insert": { -"description": "Inserts a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.", +"description": "Inserts a permission for a file or shared drive. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions", "httpMethod": "POST", "id": "drive.permissions.insert", @@ -2936,7 +2936,7 @@ ] }, "patch": { -"description": "Updates a permission using patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.", +"description": "Updates a permission using patch semantics. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions/{permissionId}", "httpMethod": "PATCH", "id": "drive.permissions.patch", @@ -3009,7 +3009,7 @@ ] }, "update": { -"description": "Updates a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.", +"description": "Updates a permission. **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions/{permissionId}", "httpMethod": "PUT", "id": "drive.permissions.update", @@ -3923,7 +3923,7 @@ } } }, -"revision": "20260405", +"revision": "20260916", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/googleapiclient/discovery_cache/documents/drive.v3.json b/googleapiclient/discovery_cache/documents/drive.v3.json index a1f9e922ca..030038876f 100644 --- a/googleapiclient/discovery_cache/documents/drive.v3.json +++ b/googleapiclient/discovery_cache/documents/drive.v3.json @@ -2171,7 +2171,7 @@ "permissions": { "methods": { "create": { -"description": "Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.", +"description": "Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions", "httpMethod": "POST", "id": "drive.permissions.create", @@ -2254,7 +2254,7 @@ ] }, "delete": { -"description": "Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.", +"description": "Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions/{permissionId}", "httpMethod": "DELETE", "id": "drive.permissions.delete", @@ -2432,7 +2432,7 @@ ] }, "update": { -"description": "Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.", +"description": "Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permission modifications (such as update or delete) on the same file, folder, or shared drive aren't supported across any users or clients; only the last update is applied.", "flatPath": "files/{fileId}/permissions/{permissionId}", "httpMethod": "PATCH", "id": "drive.permissions.update", @@ -3044,7 +3044,7 @@ } } }, -"revision": "20260913", +"revision": "20260916", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/googleapiclient/discovery_cache/documents/firebasehosting.v1beta1.json b/googleapiclient/discovery_cache/documents/firebasehosting.v1beta1.json index 39a3396f79..d952abea6b 100644 --- a/googleapiclient/discovery_cache/documents/firebasehosting.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/firebasehosting.v1beta1.json @@ -824,7 +824,7 @@ "type": "boolean" }, "name": { -"description": "Output only. The fully-qualified name of the `CustomDomain`.", +"description": "Identifier. The fully-qualified name of the `CustomDomain`.", "location": "path", "pattern": "^projects/[^/]+/sites/[^/]+/customDomains/[^/]+$", "required": true, @@ -2427,7 +2427,7 @@ } } }, -"revision": "20251207", +"revision": "20260920", "rootUrl": "https://firebasehosting.googleapis.com/", "schemas": { "ActingUser": { @@ -2756,8 +2756,7 @@ "type": "object" }, "name": { -"description": "Output only. The fully-qualified name of the `CustomDomain`.", -"readOnly": true, +"description": "Identifier. The fully-qualified name of the `CustomDomain`.", "type": "string" }, "ownershipState": { diff --git a/googleapiclient/discovery_cache/documents/health.v4.json b/googleapiclient/discovery_cache/documents/health.v4.json index cd173cfb35..7e0c94dce9 100644 --- a/googleapiclient/discovery_cache/documents/health.v4.json +++ b/googleapiclient/discovery_cache/documents/health.v4.json @@ -630,7 +630,7 @@ ], "parameters": { "name": { -"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "location": "path", "pattern": "^users/[^/]+/profile$", "required": true, @@ -664,7 +664,7 @@ ], "parameters": { "name": { -"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "location": "path", "pattern": "^users/[^/]+/settings$", "required": true, @@ -972,7 +972,7 @@ ], "parameters": { "dataSourceFamily": { -"description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "location": "query", "type": "string" }, @@ -1134,7 +1134,7 @@ } } }, -"revision": "20260908", +"revision": "20260923", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -1146,7 +1146,7 @@ "description": "Required. Observed interval" }, "kcal": { -"description": "Required. Energy burned during an activity, measured in kilocalories.", +"description": "Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`.", "format": "double", "type": "number" } @@ -1434,7 +1434,7 @@ "id": "Altitude", "properties": { "gainMillimeters": { -"description": "Required. Altitude gain in millimeters over the observed interval.", +"description": "Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`.", "format": "int64", "type": "string" }, @@ -1514,7 +1514,7 @@ "id": "BloodGlucose", "properties": { "bloodGlucoseMilligramsPerDeciliter": { -"description": "Required. Blood glucose level concentration in mg/dL.", +"description": "Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`.", "format": "double", "type": "number" }, @@ -1624,7 +1624,7 @@ "id": "BodyFat", "properties": { "percentage": { -"description": "Required. Body fat percentage, in range [0, 100].", +"description": "Required. Body fat percentage. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1778,7 +1778,7 @@ "description": "Required. The time at which core body temperature was measured." }, "temperatureCelsius": { -"description": "Required. The core body temperature in Celsius.", +"description": "Required. The core body temperature in Celsius. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -1901,7 +1901,7 @@ "id": "DailyOxygenSaturation", "properties": { "averagePercentage": { -"description": "Required. The average value of the oxygen saturation samples during the sleep.", +"description": "Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1910,7 +1910,7 @@ "description": "Required. Date (in user's timezone) of the daily oxygen saturation record." }, "lowerBoundPercentage": { -"description": "Required. The lower bound of the confidence interval of oxygen saturation samples during sleep.", +"description": "Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1920,7 +1920,7 @@ "type": "number" }, "upperBoundPercentage": { -"description": "Required. The upper bound of the confidence interval of oxygen saturation samples during sleep.", +"description": "Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -1989,7 +1989,7 @@ "id": "DailyRollUpDataPointsRequest", "properties": { "dataSourceFamily": { -"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -2195,7 +2195,7 @@ "type": "boolean" }, "vo2Max": { -"description": "Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min.", +"description": "Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -2578,7 +2578,7 @@ "description": "Required. Observed interval." }, "millimeters": { -"description": "Required. Distance in millimeters over the observed interval.", +"description": "Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`.", "format": "int64", "type": "string" } @@ -2692,7 +2692,7 @@ "id": "EnergyQuantity", "properties": { "kcal": { -"description": "Required. The energy value in kilocalories.", +"description": "Required. The energy value in kilocalories. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, @@ -3259,7 +3259,7 @@ "id": "Floors", "properties": { "count": { -"description": "Required. Number of floors in the recorded interval", +"description": "Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`.", "format": "int64", "type": "string" }, @@ -3533,7 +3533,7 @@ "id": "HeartRate", "properties": { "beatsPerMinute": { -"description": "Required. The heart rate value in beats per minute.", +"description": "Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`.", "format": "int64", "type": "string" }, @@ -3622,7 +3622,7 @@ "description": "Optional. Metadata used in 1P surfaces." }, "rootMeanSquareOfSuccessiveDifferencesMilliseconds": { -"description": "Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health.", +"description": "Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`.", "format": "double", "type": "number" }, @@ -3712,7 +3712,7 @@ "id": "Height", "properties": { "heightMillimeters": { -"description": "Required. Height of the user in millimeters.", +"description": "Required. Height of the user in millimeters. Must be in the range `[0, 3000]`.", "format": "int64", "type": "string" }, @@ -4210,7 +4210,19 @@ "LONGING", "ACCOMPLISHED", "LOVING", -"COMPASSIONATE" +"COMPASSIONATE", +"DEPRESSED", +"GOOD", +"LOW_ENERGY", +"OBSESSIVE_THOUGHTS", +"PANIC", +"PLAYFUL", +"PLEASED", +"SENSITIVE", +"SLEEPY", +"SWINGS", +"UNHAPPY", +"VERY_SELF_CRITICAL" ], "enumDescriptions": [ "Unspecified mood.", @@ -4269,7 +4281,19 @@ "Longing.", "Accomplished.", "Loving.", -"Compassionate." +"Compassionate.", +"Depressed.", +"Good.", +"Low energy.", +"Obsessive thoughts.", +"Panic.", +"Playful.", +"Pleased.", +"Sensitive.", +"Sleepy.", +"Mood swings.", +"Unhappy.", +"Very self-critical." ], "type": "string" }, @@ -4760,7 +4784,7 @@ "id": "OxygenSaturation", "properties": { "percentage": { -"description": "Required. The oxygen saturation percentage. Valid values are from 0 to 100.", +"description": "Required. The oxygen saturation percentage. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -4859,7 +4883,7 @@ "readOnly": true }, "name": { -"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "type": "string" }, "userConfiguredRunningStrideLengthMm": { @@ -5111,7 +5135,7 @@ "id": "RollUpDataPointsRequest", "properties": { "dataSourceFamily": { -"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -5259,7 +5283,7 @@ "id": "RunVO2Max", "properties": { "runVo2Max": { -"description": "Required. Run VO2 max value in ml/kg/min.", +"description": "Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -5433,7 +5457,7 @@ "type": "string" }, "name": { -"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "type": "string" }, "strideLengthRunningType": { @@ -5903,7 +5927,7 @@ "id": "Steps", "properties": { "count": { -"description": "Required. Number of steps in the recorded interval.", +"description": "Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`.", "format": "int64", "type": "string" }, @@ -6426,7 +6450,7 @@ "description": "Required. The time at which VO2 max was measured." }, "vo2Max": { -"description": "Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min.", +"description": "Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -6438,7 +6462,7 @@ "id": "VolumeQuantity", "properties": { "milliliters": { -"description": "Required. Value representing the volume in milliliters.", +"description": "Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, @@ -6522,7 +6546,7 @@ "description": "Required. The time at which the weight was measured" }, "weightGrams": { -"description": "Required. Weight of a user in grams.", +"description": "Required. Weight of a user in grams. Must be in the range `[0, 1000000]`.", "format": "double", "type": "number" } @@ -6534,7 +6558,7 @@ "id": "WeightQuantity", "properties": { "grams": { -"description": "Required. The weight value in grams.", +"description": "Required. The weight value in grams. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, diff --git a/googleapiclient/discovery_cache/documents/health.v4beta.json b/googleapiclient/discovery_cache/documents/health.v4beta.json index c1445a1b34..435135b7f1 100644 --- a/googleapiclient/discovery_cache/documents/health.v4beta.json +++ b/googleapiclient/discovery_cache/documents/health.v4beta.json @@ -630,7 +630,7 @@ ], "parameters": { "name": { -"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "location": "path", "pattern": "^users/[^/]+/profile$", "required": true, @@ -664,7 +664,7 @@ ], "parameters": { "name": { -"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "location": "path", "pattern": "^users/[^/]+/settings$", "required": true, @@ -972,7 +972,7 @@ ], "parameters": { "dataSourceFamily": { -"description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "location": "query", "type": "string" }, @@ -1134,7 +1134,7 @@ } } }, -"revision": "20260908", +"revision": "20260923", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -1146,7 +1146,7 @@ "description": "Required. Observed interval" }, "kcal": { -"description": "Required. Energy burned during an activity, measured in kilocalories.", +"description": "Required. Energy burned during an activity, measured in kilocalories. Must be in the range `[0, 1000000]`.", "format": "double", "type": "number" } @@ -1434,7 +1434,7 @@ "id": "Altitude", "properties": { "gainMillimeters": { -"description": "Required. Altitude gain in millimeters over the observed interval.", +"description": "Required. Altitude gain in millimeters over the observed interval. Must be in the range `[-1000000000, 1000000000]`.", "format": "int64", "type": "string" }, @@ -1514,7 +1514,7 @@ "id": "BloodGlucose", "properties": { "bloodGlucoseMilligramsPerDeciliter": { -"description": "Required. Blood glucose level concentration in mg/dL.", +"description": "Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`.", "format": "double", "type": "number" }, @@ -1624,7 +1624,7 @@ "id": "BodyFat", "properties": { "percentage": { -"description": "Required. Body fat percentage, in range [0, 100].", +"description": "Required. Body fat percentage. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1778,7 +1778,7 @@ "description": "Required. The time at which core body temperature was measured." }, "temperatureCelsius": { -"description": "Required. The core body temperature in Celsius.", +"description": "Required. The core body temperature in Celsius. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -1901,7 +1901,7 @@ "id": "DailyOxygenSaturation", "properties": { "averagePercentage": { -"description": "Required. The average value of the oxygen saturation samples during the sleep.", +"description": "Required. The average value of the oxygen saturation samples during the sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1910,7 +1910,7 @@ "description": "Required. Date (in user's timezone) of the daily oxygen saturation record." }, "lowerBoundPercentage": { -"description": "Required. The lower bound of the confidence interval of oxygen saturation samples during sleep.", +"description": "Required. The lower bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -1920,7 +1920,7 @@ "type": "number" }, "upperBoundPercentage": { -"description": "Required. The upper bound of the confidence interval of oxygen saturation samples during sleep.", +"description": "Required. The upper bound of the confidence interval of oxygen saturation samples during sleep. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -1989,7 +1989,7 @@ "id": "DailyRollUpDataPointsRequest", "properties": { "dataSourceFamily": { -"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -2195,7 +2195,7 @@ "type": "boolean" }, "vo2Max": { -"description": "Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min.", +"description": "Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -2578,7 +2578,7 @@ "description": "Required. Observed interval." }, "millimeters": { -"description": "Required. Distance in millimeters over the observed interval.", +"description": "Required. Distance in millimeters over the observed interval. Must be in the range `[0, 1000000000]`.", "format": "int64", "type": "string" } @@ -2692,7 +2692,7 @@ "id": "EnergyQuantity", "properties": { "kcal": { -"description": "Required. The energy value in kilocalories.", +"description": "Required. The energy value in kilocalories. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, @@ -3259,7 +3259,7 @@ "id": "Floors", "properties": { "count": { -"description": "Required. Number of floors in the recorded interval", +"description": "Required. Number of floors in the recorded interval. Must be in the range `[0, 1000000]`.", "format": "int64", "type": "string" }, @@ -3533,7 +3533,7 @@ "id": "HeartRate", "properties": { "beatsPerMinute": { -"description": "Required. The heart rate value in beats per minute.", +"description": "Required. The heart rate value in beats per minute. Must be in the range `[1, 300]`.", "format": "int64", "type": "string" }, @@ -3622,7 +3622,7 @@ "description": "Optional. Metadata used in 1P surfaces." }, "rootMeanSquareOfSuccessiveDifferencesMilliseconds": { -"description": "Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health.", +"description": "Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range `[1, 200]`.", "format": "double", "type": "number" }, @@ -3712,7 +3712,7 @@ "id": "Height", "properties": { "heightMillimeters": { -"description": "Required. Height of the user in millimeters.", +"description": "Required. Height of the user in millimeters. Must be in the range `[0, 3000]`.", "format": "int64", "type": "string" }, @@ -4210,7 +4210,19 @@ "LONGING", "ACCOMPLISHED", "LOVING", -"COMPASSIONATE" +"COMPASSIONATE", +"DEPRESSED", +"GOOD", +"LOW_ENERGY", +"OBSESSIVE_THOUGHTS", +"PANIC", +"PLAYFUL", +"PLEASED", +"SENSITIVE", +"SLEEPY", +"SWINGS", +"UNHAPPY", +"VERY_SELF_CRITICAL" ], "enumDescriptions": [ "Unspecified mood.", @@ -4269,7 +4281,19 @@ "Longing.", "Accomplished.", "Loving.", -"Compassionate." +"Compassionate.", +"Depressed.", +"Good.", +"Low energy.", +"Obsessive thoughts.", +"Panic.", +"Playful.", +"Pleased.", +"Sensitive.", +"Sleepy.", +"Mood swings.", +"Unhappy.", +"Very self-critical." ], "type": "string" }, @@ -4760,7 +4784,7 @@ "id": "OxygenSaturation", "properties": { "percentage": { -"description": "Required. The oxygen saturation percentage. Valid values are from 0 to 100.", +"description": "Required. The oxygen saturation percentage. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -4859,7 +4883,7 @@ "readOnly": true }, "name": { -"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "type": "string" }, "userConfiguredRunningStrideLengthMm": { @@ -5111,7 +5135,7 @@ "id": "RollUpDataPointsRequest", "properties": { "dataSourceFamily": { -"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", +"description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -5259,7 +5283,7 @@ "id": "RunVO2Max", "properties": { "runVo2Max": { -"description": "Required. Run VO2 max value in ml/kg/min.", +"description": "Required. Run VO2 max value in ml/kg/min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" }, @@ -5433,7 +5457,7 @@ "type": "string" }, "name": { -"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", +"description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user. This field is read-only.", "type": "string" }, "strideLengthRunningType": { @@ -5903,7 +5927,7 @@ "id": "Steps", "properties": { "count": { -"description": "Required. Number of steps in the recorded interval.", +"description": "Required. Number of steps in the recorded interval. Must be in the range `[0, 1000000]`.", "format": "int64", "type": "string" }, @@ -6426,7 +6450,7 @@ "description": "Required. The time at which VO2 max was measured." }, "vo2Max": { -"description": "Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min.", +"description": "Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`.", "format": "double", "type": "number" } @@ -6438,7 +6462,7 @@ "id": "VolumeQuantity", "properties": { "milliliters": { -"description": "Required. Value representing the volume in milliliters.", +"description": "Required. Value representing the volume in milliliters. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, @@ -6522,7 +6546,7 @@ "description": "Required. The time at which the weight was measured" }, "weightGrams": { -"description": "Required. Weight of a user in grams.", +"description": "Required. Weight of a user in grams. Must be in the range `[0, 1000000]`.", "format": "double", "type": "number" } @@ -6534,7 +6558,7 @@ "id": "WeightQuantity", "properties": { "grams": { -"description": "Required. The weight value in grams.", +"description": "Required. The weight value in grams. Must be in the range `[0, 100000]`.", "format": "double", "type": "number" }, diff --git a/googleapiclient/discovery_cache/documents/iam.v1.json b/googleapiclient/discovery_cache/documents/iam.v1.json index 73e5d8f10e..3b11493c6d 100644 --- a/googleapiclient/discovery_cache/documents/iam.v1.json +++ b/googleapiclient/discovery_cache/documents/iam.v1.json @@ -4341,7 +4341,7 @@ } } }, -"revision": "20260911", +"revision": "20260918", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -4896,7 +4896,7 @@ "type": "integer" }, "useDefaultSharedCa": { -"description": "Optional. If set to true, the trust domain will utilize the GCP-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates.", +"description": "Optional. Determines whether the trust domain utilizes the Google Cloud-provisioned default CA. A default CA in the same region as the workload will be selected to issue the certificate. Enabling this will clear any existing `ca_pools` configuration to provision the certificates. NOTE: This field is mutually exclusive with `ca_pools`. If this flag is enabled, certificates will be automatically provisioned from the default shared CAs. This flag should not be set if you want to use your own CA pools to provision the certificates.", "type": "boolean" } }, @@ -6290,7 +6290,7 @@ false "type": "array" }, "trustDefaultSharedCa": { -"description": "Optional. If set to True, the trust bundle will include the private ca managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource.", +"description": "Optional. Determines whether the trust bundle includes the private CA managed identity regional root public certificates. Important: `trust_default_shared_ca` is only supported for managed identity trust domain resource.", "type": "boolean" } }, @@ -6852,7 +6852,7 @@ false "id": "WorkloadIdentityPoolProvider", "properties": { "attributeCondition": { -"description": "Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credential are accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", +"description": "Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", "type": "string" }, "attributeMapping": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.loyaltycustomers_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.loyaltycustomers_v1.json index 046d999ef2..7c34de30f5 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.loyaltycustomers_v1.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.loyaltycustomers_v1.json @@ -110,7 +110,7 @@ "loyaltyCustomers": { "methods": { "manage": { -"description": "Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.", +"description": "Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. For more information on how to use this method, see [Overview of the loyalty customer match service](/merchant/api/guides/loyalty/customer-match-service). **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.", "flatPath": "loyaltyCustomers/v1/accounts/{accountsId}/loyaltyCustomers:manage", "httpMethod": "POST", "id": "merchantapi.accounts.loyaltyCustomers.manage", @@ -142,7 +142,7 @@ } } }, -"revision": "20260901", +"revision": "20260921", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "AddressInfo": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json index 6bfeed7466..afb15172fe 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json @@ -281,7 +281,7 @@ } } }, -"revision": "20260910", +"revision": "20260921", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "AutomatedDiscounts": { @@ -1121,7 +1121,7 @@ false "type": "object" }, "LoyaltyProgram": { -"description": "A message that represents loyalty program.", +"description": "A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs).", "id": "LoyaltyProgram", "properties": { "cashbackForFutureUse": { @@ -2569,7 +2569,7 @@ false }, "warranty": { "$ref": "Warranty", -"description": "The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle." +"description": "The [warranty](https://support.google.com/merchants/answer/15957626) of the product." }, "year": { "description": "The [Year](https://support.google.com/google-ads/answer/14152816) of the vehicle model.", @@ -3552,13 +3552,27 @@ false "id": "Warranty", "properties": { "duration": { -"description": "The warranty duration in months.", +"description": "The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.", "format": "int64", "type": "string" }, +"durationUnit": { +"description": "The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.", +"enum": [ +"WARRANTY_DURATION_UNIT_UNSPECIFIED", +"MONTH", +"YEAR" +], +"enumDescriptions": [ +"Indicates that the warranty duration unit is unspecified.", +"Indicates that the warranty duration unit is month.", +"Indicates that the warranty duration unit is year." +], +"type": "string" +}, "mileage": { "$ref": "Mileage", -"description": "The warranty mileage." +"description": "The warranty mileage (only applies to vehicles)." } }, "type": "object" diff --git a/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json index 9cf86379ee..0397200423 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json @@ -281,7 +281,7 @@ } } }, -"revision": "20260903", +"revision": "20260921", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -1199,7 +1199,7 @@ false "type": "object" }, "LoyaltyProgram": { -"description": "A message that represents loyalty program.", +"description": "A message that represents loyalty program. For more information on loyalty programs, see [Overview of loyalty programs](/merchant/api/guides/loyalty/loyalty-programs).", "id": "LoyaltyProgram", "properties": { "cashbackForFutureUse": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json index 768d0f5b56..3d0d9d7c72 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json @@ -142,7 +142,7 @@ } } }, -"revision": "20260901", +"revision": "20260921", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "BestSellersBrandView": { @@ -476,7 +476,7 @@ "description": "Date of this row. A condition on `date` is required in the `WHERE` clause." }, "domain": { -"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", +"description": "Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", "type": "string" }, "higherPositionRate": { @@ -545,7 +545,7 @@ "description": "Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause." }, "domain": { -"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", +"description": "Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", "type": "string" }, "higherPositionRate": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json index c7d3c1d58a..3489e75eac 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json @@ -142,7 +142,7 @@ } } }, -"revision": "20260901", +"revision": "20260921", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "BestSellersBrandView": { @@ -476,7 +476,7 @@ "description": "Date of this row. A condition on `date` is required in the `WHERE` clause." }, "domain": { -"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", +"description": "Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", "type": "string" }, "higherPositionRate": { @@ -545,7 +545,7 @@ "description": "Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause." }, "domain": { -"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", +"description": "Domain of your competitor or your domain, if `is_your_domain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", "type": "string" }, "higherPositionRate": { diff --git a/googleapiclient/discovery_cache/documents/metastore.v1.json b/googleapiclient/discovery_cache/documents/metastore.v1.json index eb59763235..f090414ecd 100644 --- a/googleapiclient/discovery_cache/documents/metastore.v1.json +++ b/googleapiclient/discovery_cache/documents/metastore.v1.json @@ -1695,7 +1695,7 @@ } } }, -"revision": "20260910", +"revision": "20260916", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { @@ -2649,6 +2649,26 @@ }, "type": "object" }, +"LakehouseProxyConfig": { +"description": "Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS.", +"id": "LakehouseProxyConfig", +"properties": { +"catalog": { +"description": "Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}.", +"readOnly": true, +"type": "string" +}, +"namespaces": { +"description": "Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, "LatestBackup": { "description": "The details of the latest scheduled backup.", "id": "LatestBackup", @@ -3724,6 +3744,11 @@ "description": "User-defined labels for the metastore service.", "type": "object" }, +"lakehouseProxyConfig": { +"$ref": "LakehouseProxyConfig", +"description": "Output only. The Lakehouse proxy routing configuration for the metastore service.", +"readOnly": true +}, "maintenanceWindow": { "$ref": "MaintenanceWindow", "description": "Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type." diff --git a/googleapiclient/discovery_cache/documents/metastore.v1alpha.json b/googleapiclient/discovery_cache/documents/metastore.v1alpha.json index a68ae06560..5d6027732e 100644 --- a/googleapiclient/discovery_cache/documents/metastore.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/metastore.v1alpha.json @@ -1807,7 +1807,7 @@ } } }, -"revision": "20260910", +"revision": "20260916", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { @@ -2841,6 +2841,26 @@ }, "type": "object" }, +"LakehouseProxyConfig": { +"description": "Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS.", +"id": "LakehouseProxyConfig", +"properties": { +"catalog": { +"description": "Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}.", +"readOnly": true, +"type": "string" +}, +"namespaces": { +"description": "Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, "LatestBackup": { "description": "The details of the latest scheduled backup.", "id": "LatestBackup", @@ -3987,6 +4007,11 @@ "description": "User-defined labels for the metastore service.", "type": "object" }, +"lakehouseProxyConfig": { +"$ref": "LakehouseProxyConfig", +"description": "Output only. The Lakehouse proxy routing configuration for the metastore service.", +"readOnly": true +}, "maintenanceWindow": { "$ref": "MaintenanceWindow", "description": "Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type." diff --git a/googleapiclient/discovery_cache/documents/metastore.v1beta.json b/googleapiclient/discovery_cache/documents/metastore.v1beta.json index 00235a0816..4518b82c42 100644 --- a/googleapiclient/discovery_cache/documents/metastore.v1beta.json +++ b/googleapiclient/discovery_cache/documents/metastore.v1beta.json @@ -1807,7 +1807,7 @@ } } }, -"revision": "20260910", +"revision": "20260916", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { @@ -2841,6 +2841,26 @@ }, "type": "object" }, +"LakehouseProxyConfig": { +"description": "Configuration for Dataproc Metastore to Lakehouse proxy routing.In a phased migration, namespaces are migrated from Dataproc Metastore to a Lakehouse Iceberg REST Catalog in batches. Between and after migration phases, the metastore service operates in PROXY state where requests for migrated namespaces are forwarded to the Lakehouse catalog while unmigrated namespaces continue to be served locally by DPMS.", +"id": "LakehouseProxyConfig", +"properties": { +"catalog": { +"description": "Output only. The Lakehouse Iceberg REST Catalog where requests are being proxied to. Format: projects/{project_id_or_number}/catalogs/{catalog_id}.", +"readOnly": true, +"type": "string" +}, +"namespaces": { +"description": "Output only. The list of namespaces currently proxied to the Lakehouse catalog. As each migration batch completes, newly migrated namespaces are added to this list.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, "LatestBackup": { "description": "The details of the latest scheduled backup.", "id": "LatestBackup", @@ -3987,6 +4007,11 @@ "description": "User-defined labels for the metastore service.", "type": "object" }, +"lakehouseProxyConfig": { +"$ref": "LakehouseProxyConfig", +"description": "Output only. The Lakehouse proxy routing configuration for the metastore service.", +"readOnly": true +}, "maintenanceWindow": { "$ref": "MaintenanceWindow", "description": "Optional. The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time. Maintenance window is not needed for services with the SPANNER database type." diff --git a/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json b/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json index 22225c4f80..bebb18c721 100644 --- a/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json +++ b/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json @@ -344,7 +344,7 @@ } } }, -"revision": "20260828", +"revision": "20260918", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AISkillAnalysisOccurrence": { @@ -2528,7 +2528,9 @@ "type": "array" }, "layerDetails": { -"$ref": "LayerDetails" +"$ref": "LayerDetails", +"deprecated": true, +"description": "Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted." }, "licenses": { "description": "The list of licenses found that are related to a given package. Note that licenses may also be stored on the BinarySourceInfo. If there is no BinarySourceInfo (because there's no concept of source vs binary), then it will be stored here, while if there are BinarySourceInfos, it will be stored there, as one source can have multiple binaries with different licenses.", diff --git a/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json b/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json index 6854235430..c3fdd0a7dc 100644 --- a/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json @@ -344,7 +344,7 @@ } } }, -"revision": "20260828", +"revision": "20260918", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AISkillAnalysisOccurrence": { @@ -2523,7 +2523,9 @@ "type": "array" }, "layerDetails": { -"$ref": "LayerDetails" +"$ref": "LayerDetails", +"deprecated": true, +"description": "Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted." }, "licenses": { "description": "The list of licenses found that are related to a given package. Note that licenses may also be stored on the BinarySourceInfo. If there is no BinarySourceInfo (because there's no concept of source vs binary), then it will be stored here, while if there are BinarySourceInfos, it will be stored there, as one source can have multiple binaries with different licenses.", diff --git a/googleapiclient/discovery_cache/documents/retail.v2alpha.json b/googleapiclient/discovery_cache/documents/retail.v2alpha.json index 9a966bde79..4410e98ab0 100644 --- a/googleapiclient/discovery_cache/documents/retail.v2alpha.json +++ b/googleapiclient/discovery_cache/documents/retail.v2alpha.json @@ -2874,7 +2874,7 @@ } } }, -"revision": "20260826", +"revision": "20260920", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4459,6 +4459,10 @@ "description": "Output only. The source data for the latest import of the autocomplete denylist phrases.", "readOnly": true }, +"enableAgentPrompts": { +"description": "Optional. If set to true, the conversational shopping agent prompts will be served. Default value is false.", +"type": "boolean" +}, "lastAllowlistImportOperation": { "description": "Output only. Name of the LRO corresponding to the latest allowlist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation.", "readOnly": true, diff --git a/googleapiclient/discovery_cache/documents/run.v1.json b/googleapiclient/discovery_cache/documents/run.v1.json index 6a38ef0a56..19798d5a63 100644 --- a/googleapiclient/discovery_cache/documents/run.v1.json +++ b/googleapiclient/discovery_cache/documents/run.v1.json @@ -3652,7 +3652,7 @@ } } }, -"revision": "20260904", +"revision": "20260917", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -4998,6 +4998,11 @@ false ], "type": "string" }, +"resolvedWorkerRelease": { +"description": "Output only. Worker release resolved from the release channel.", +"readOnly": true, +"type": "string" +}, "secretEnv": { "description": "A list of global environment variables, which are encrypted using a Cloud Key Management Service crypto key. These values must be specified in the build's `Secret`. These variables will be available to all build steps in this build.", "items": { @@ -5051,6 +5056,10 @@ false "deprecated": true, "description": "This field deprecated; please use `pool.name` instead.", "type": "string" +}, +"workerRelease": { +"description": "Optional. Option to specify which release or release channel (rapid|regular|stable) to use to run this build.", +"type": "string" } }, "type": "object" @@ -5623,6 +5632,16 @@ false "name": { "description": "The `WorkerPool` resource to execute the build on. You must have `cloudbuild.workerpools.use` on the project hosting the WorkerPool. Format projects/{project}/locations/{location}/workerPools/{workerPoolId}", "type": "string" +}, +"resolvedWorkerRelease": { +"description": "Output only. OUTPUT_ONLY. Worker release resolved from the release channel.", +"readOnly": true, +"type": "string" +}, +"workerRelease": { +"description": "Output only. OUTPUT_ONLY. The release or release channel used to run the Build. This is set to the same value as `PrivatePoolV1Config.WorkerConfig.worker_release` for the UI to easily access.", +"readOnly": true, +"type": "string" } }, "type": "object" @@ -6976,7 +6995,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance.", +"description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service, Revision. * `run.googleapis.com/build-id`: Service, Revision. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service, Revision. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution, Instance. * `run.googleapis.com/container-dependencies`: Revision, Instance. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision. * `run.googleapis.com/encryption-key`: Revision, Execution, Instance. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/gpu-zonal-redundancy-disabled`: Revision. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service, Instance. * `run.googleapis.com/invoker-iam-disabled`: Service, Instance. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service. * `run.googleapis.com/maxScale`: Service. * `run.googleapis.com/manualInstanceCount`: Service. * `run.googleapis.com/network-interfaces`: Revision, Execution, Instance. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/scalingMode`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution, Instance.", "type": "object" }, "clusterName": { diff --git a/googleapiclient/discovery_cache/documents/servicecontrol.v1.json b/googleapiclient/discovery_cache/documents/servicecontrol.v1.json index 65ff357ca9..ac73bb5511 100644 --- a/googleapiclient/discovery_cache/documents/servicecontrol.v1.json +++ b/googleapiclient/discovery_cache/documents/servicecontrol.v1.json @@ -197,7 +197,7 @@ } } }, -"revision": "20260806", +"revision": "20260914", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "AllocateInfo": { @@ -1421,10 +1421,6 @@ "orgPolicyViolationInfo": { "$ref": "OrgPolicyViolationInfo", "description": "Indicates the orgpolicy violations for this resource." -}, -"rabPolicyViolationInfo": { -"$ref": "RabPolicyViolationInfo", -"description": "Indicates the regional access boundary policy violations for this resource." } }, "type": "object" @@ -1616,24 +1612,6 @@ }, "type": "object" }, -"RabPolicyViolationInfo": { -"description": "Represents Regional Access Boundary (RAB) Policy Violation information.", -"id": "RabPolicyViolationInfo", -"properties": { -"errorMessage": { -"description": "Optional. Error message detailing what triggered the violation. The error message content originates from the authz library e.g., google3/cloud/security/iam/cap/deny_explanation/internal/make_error_msg.cc. This will be the same (canonical) error message provided by the http error code.", -"type": "string" -}, -"resourceLocations": { -"description": "Optional. The list of target locations of the resource.", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" -}, "ReportError": { "description": "Represents the processing error of one Operation in the request.", "id": "ReportError", diff --git a/googleapiclient/discovery_cache/documents/servicedirectory.v1.json b/googleapiclient/discovery_cache/documents/servicedirectory.v1.json index bf13593653..addaa1543f 100644 --- a/googleapiclient/discovery_cache/documents/servicedirectory.v1.json +++ b/googleapiclient/discovery_cache/documents/servicedirectory.v1.json @@ -564,7 +564,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", +"description": "Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+$", "required": true, @@ -815,7 +815,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", +"description": "Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/services/[^/]+$", "required": true, @@ -1066,7 +1066,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", +"description": "Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/services/[^/]+/endpoints/[^/]+$", "required": true, @@ -1101,7 +1101,7 @@ } } }, -"revision": "20260724", +"revision": "20260916", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { @@ -1148,7 +1148,7 @@ "type": "object" }, "name": { -"description": "Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", +"description": "Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", "type": "string" }, "network": { @@ -1332,7 +1332,7 @@ "type": "object" }, "name": { -"description": "Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", +"description": "Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", "type": "string" }, "uid": { @@ -1413,7 +1413,7 @@ "type": "array" }, "name": { -"description": "Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", +"description": "Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", "type": "string" }, "uid": { diff --git a/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json b/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json index bfaaa0cbe7..7100f84ba9 100644 --- a/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json @@ -564,7 +564,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", +"description": "Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+$", "required": true, @@ -815,7 +815,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", +"description": "Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/services/[^/]+$", "required": true, @@ -1066,7 +1066,7 @@ ], "parameters": { "name": { -"description": "Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", +"description": "Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/services/[^/]+/endpoints/[^/]+$", "required": true, @@ -1189,7 +1189,7 @@ } } }, -"revision": "20260724", +"revision": "20260916", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { @@ -1242,7 +1242,7 @@ "type": "object" }, "name": { -"description": "Immutable. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", +"description": "Identifier. The resource name for the endpoint in the format `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.", "type": "string" }, "network": { @@ -1438,7 +1438,7 @@ "type": "object" }, "name": { -"description": "Immutable. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", +"description": "Identifier. The resource name for the namespace in the format `projects/*/locations/*/namespaces/*`.", "type": "string" }, "uid": { @@ -1531,7 +1531,7 @@ "type": "object" }, "name": { -"description": "Immutable. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", +"description": "Identifier. The resource name for the service in the format `projects/*/locations/*/namespaces/*/services/*`.", "type": "string" }, "uid": { diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1.json index e7632efcfa..83ad49d408 100644 --- a/googleapiclient/discovery_cache/documents/serviceusage.v1.json +++ b/googleapiclient/discovery_cache/documents/serviceusage.v1.json @@ -431,7 +431,7 @@ } } }, -"revision": "20260819", +"revision": "20260921", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1561,26 +1561,16 @@ "type": "object" }, "EnableRule": { -"description": "The consumer policy rule that defines enabled services and groups.", +"description": "The consumer policy rule that defines enabled services and catalogs.", "id": "EnableRule", "properties": { -"enableType": { -"deprecated": true, -"description": "Deprecated: EnableType is not supported.", -"enum": [ -"ENABLE_TYPE_UNSPECIFIED", -"CLIENT", -"RESOURCE", -"V1_COMPATIBLE" -], -"enumDescriptions": [ -"Unspecified enable type, which means enabled as both client and resource project.", -"Enable all clients under the CRM node specified by `ConsumerPolicy.name` to use the listed services. A client can be an API key, an OAuth client, or a service account.", -"Enable resources in the list services to be created and used under the CRM node specified by the `ConsumerPolicy.name`.", -"Activation made by Service Usage v1 API. This will be how consumers differentiate between policy changes made by v1 and v2 clients and understand what is actually possible based on those different policies." -], +"catalogs": { +"description": "The names of the catalogs that are enabled. Example: `catalogs/default-cloud-services`.", +"items": { "type": "string" }, +"type": "array" +}, "services": { "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.", "items": { @@ -2484,6 +2474,13 @@ "description": "The consumer policy rule that defines enabled services, groups, and categories.", "id": "GoogleApiServiceusageV2betaEnableRule", "properties": { +"catalogs": { +"description": "The names of the catalogs that are enabled. Example: `catalogs/default-cloud-services`.", +"items": { +"type": "string" +}, +"type": "array" +}, "services": { "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.", "items": { diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json index 2e56176101..22f4febcce 100644 --- a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json @@ -969,7 +969,7 @@ } } }, -"revision": "20260819", +"revision": "20260921", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -2152,26 +2152,16 @@ "type": "object" }, "EnableRule": { -"description": "The consumer policy rule that defines enabled services and groups.", +"description": "The consumer policy rule that defines enabled services and catalogs.", "id": "EnableRule", "properties": { -"enableType": { -"deprecated": true, -"description": "Deprecated: EnableType is not supported.", -"enum": [ -"ENABLE_TYPE_UNSPECIFIED", -"CLIENT", -"RESOURCE", -"V1_COMPATIBLE" -], -"enumDescriptions": [ -"Unspecified enable type, which means enabled as both client and resource project.", -"Enable all clients under the CRM node specified by `ConsumerPolicy.name` to use the listed services. A client can be an API key, an OAuth client, or a service account.", -"Enable resources in the list services to be created and used under the CRM node specified by the `ConsumerPolicy.name`.", -"Activation made by Service Usage v1 API. This will be how consumers differentiate between policy changes made by v1 and v2 clients and understand what is actually possible based on those different policies." -], +"catalogs": { +"description": "The names of the catalogs that are enabled. Example: `catalogs/default-cloud-services`.", +"items": { "type": "string" }, +"type": "array" +}, "services": { "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.", "items": { @@ -3075,6 +3065,13 @@ "description": "The consumer policy rule that defines enabled services, groups, and categories.", "id": "GoogleApiServiceusageV2betaEnableRule", "properties": { +"catalogs": { +"description": "The names of the catalogs that are enabled. Example: `catalogs/default-cloud-services`.", +"items": { +"type": "string" +}, +"type": "array" +}, "services": { "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.", "items": { diff --git a/googleapiclient/discovery_cache/documents/sts.v1.json b/googleapiclient/discovery_cache/documents/sts.v1.json index 41e26ce4cc..9f5561b241 100644 --- a/googleapiclient/discovery_cache/documents/sts.v1.json +++ b/googleapiclient/discovery_cache/documents/sts.v1.json @@ -342,7 +342,7 @@ "openid": { "methods": { "getJwks": { -"description": "Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available \"as is\" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).", +"description": "Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available \"as is\" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloadIdentityPools/{workloadIdentityPoolsId}/openid/jwks", "httpMethod": "GET", "id": "sts.organizations.locations.workloadIdentityPools.openid.getJwks", @@ -351,7 +351,7 @@ ], "parameters": { "name": { -"description": "Required. The name of the pool whose JWKS needs to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog'", +"description": "Required. The name of the pool whose JWKs need to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog'", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/workloadIdentityPools/[^/]+$", "required": true, @@ -406,7 +406,7 @@ "openid": { "methods": { "getJwks": { -"description": "Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWKs format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available \"as is\" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).", +"description": "Fetches the signing keys for an agentic or managed workload identity pool and returns them in JWK Set format, defined in [RFC 7517](https://tools.ietf.org/html/rfc7517). For now, only agentic system pools are supported. **Preview** This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available \"as is\" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workloadIdentityPools/{workloadIdentityPoolsId}/openid/jwks", "httpMethod": "GET", "id": "sts.projects.locations.workloadIdentityPools.openid.getJwks", @@ -415,7 +415,7 @@ ], "parameters": { "name": { -"description": "Required. The name of the pool whose JWKS needs to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog'", +"description": "Required. The name of the pool whose JWKs need to be retrieved. Format: 'organizations/{ORGANIZATION_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' 'projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/{POOL_ID}' Example(s): 'organizations/1234/locations/global/workloadIdentityPools/agents.global.org-1234.system.id.goog' 'projects/12345678/locations/global/workloadIdentityPools/agents.global.proj-12345678.system.id.goog'", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/workloadIdentityPools/[^/]+$", "required": true, @@ -481,7 +481,7 @@ } } }, -"revision": "20260722", +"revision": "20260916", "rootUrl": "https://sts.googleapis.com/", "schemas": { "GoogleIamV1Binding": { @@ -607,7 +607,7 @@ "type": "object" }, "GoogleIdentityStsV1Jwk": { -"description": "A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle", +"description": "A JSON web key set (JWK) See also https://datatracker.ietf.org/doc/html/rfc7517 and https://github.com/spiffe/spiffe/blob/main/standards/JWT-SVID.md#6-representation-in-the-spiffe-bundle.", "id": "GoogleIdentityStsV1Jwk", "properties": { "alg": { @@ -642,7 +642,7 @@ "id": "GoogleIdentityStsV1Jwks", "properties": { "keys": { -"description": "The JWKS for this OP.", +"description": "The JWKs for this OP.", "items": { "$ref": "GoogleIdentityStsV1Jwk" }, @@ -652,7 +652,7 @@ "type": "object" }, "GoogleIdentityStsV1OpenIdProviderConfig": { -"description": "Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse", +"description": "Response message for GetOpenIdProviderConfig. Message fields are defined in https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse.", "id": "GoogleIdentityStsV1OpenIdProviderConfig", "properties": { "authorization_endpoint": { @@ -660,7 +660,7 @@ "type": "string" }, "id_token_signing_alg_values_supported": { -"description": "JSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT [JWT]. Note: Currently always \"[\"RS256\"]\".", +"description": "JSON array that contains a list of the JWS signing algorithms (alg values) supported by the OP for the ID token to encode the claims in a JWT. Supported value: `RS256`.", "items": { "type": "string" }, @@ -671,18 +671,18 @@ "type": "string" }, "jwks_uri": { -"description": "URL of the OP's JWK Set [JWK] document, which MUST use the https scheme.", +"description": "URL of the OP's JWK Set document, which MUST use the https scheme.", "type": "string" }, "response_types_supported": { -"description": "JSON array containing a list of the OAuth 2.0 response_type values that this OP supports. Note: Currently always \"[\"id_token\"]\".", +"description": "JSON array that contains a list of the OAuth 2.0 response_type values that this OP supports. Supported value: `id_token`.", "items": { "type": "string" }, "type": "array" }, "subject_types_supported": { -"description": "JSON array containing a list of the subject identifier types that this OP supports. Note: Currently always \"[\"public\"]\".", +"description": "JSON array that contains a list of the subject identifier types that this OP supports. Supported value: `public`.", "items": { "type": "string" }, @@ -704,7 +704,7 @@ "description": "An access boundary that defines the upper bound of permissions the credential may have. The value should be a JSON object of AccessBoundary. The access boundary can include up to 10 rules. The size of the parameter value should not exceed 2048 characters." }, "bindCertFingerprint": { -"description": "The unpadded, url-escaped, base64-encoded SHA-256 hash of the certificate's DER encoding. It must be 43 characters long. The resulting token will be bound to this value.", +"description": "The unpadded, URL-escaped, base64-encoded SHA-256 hash of the certificate's DER encoding. It must be 43 characters long. The resulting token will be bound to this value.", "type": "string" }, "userProject": { diff --git a/googleapiclient/discovery_cache/documents/sts.v1beta.json b/googleapiclient/discovery_cache/documents/sts.v1beta.json index 5a2c20832f..41a5099840 100644 --- a/googleapiclient/discovery_cache/documents/sts.v1beta.json +++ b/googleapiclient/discovery_cache/documents/sts.v1beta.json @@ -353,7 +353,7 @@ } } }, -"revision": "20260318", +"revision": "20260916", "rootUrl": "https://sts.googleapis.com/", "schemas": { "GoogleIamV1Binding": { @@ -423,7 +423,7 @@ "description": "An access boundary that defines the upper bound of permissions the credential may have. The value should be a JSON object of AccessBoundary. The access boundary can include up to 10 rules. The size of the parameter value should not exceed 2048 characters." }, "bindCertFingerprint": { -"description": "The unpadded, url-escaped, base64-encoded SHA-256 hash of the certificate's DER encoding. It must be 43 characters long. The resulting token will be bound to this value.", +"description": "The unpadded, URL-escaped, base64-encoded SHA-256 hash of the certificate's DER encoding. It must be 43 characters long. The resulting token will be bound to this value.", "type": "string" }, "userProject": { diff --git a/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json b/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json index e41a216896..7901898064 100644 --- a/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json +++ b/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json @@ -842,9 +842,26 @@ } } }, -"revision": "20260913", +"revision": "20260920", "rootUrl": "https://threatintelligence.googleapis.com/", "schemas": { +"AVDetections": { +"description": "Details about the detection vendors.", +"id": "AVDetections", +"properties": { +"detectedVendorCount": { +"description": "Optional. Number of vendors that detected the threat.", +"format": "int32", +"type": "integer" +}, +"totalVendorCount": { +"description": "Optional. Total number of vendors.", +"format": "int32", +"type": "integer" +} +}, +"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", @@ -978,6 +995,10 @@ "readOnly": true, "type": "string" }, +"domainMonitoring": { +"$ref": "DomainMonitoringAlertDetail", +"description": "Domain Monitoring alert detail type." +}, "initialAccessBroker": { "$ref": "InitialAccessBrokerAlertDetail", "description": "Initial Access Broker alert detail type." @@ -1149,6 +1170,24 @@ }, "type": "object" }, +"CertificateDetails": { +"description": "Details regarding the SSL certificate configuration.", +"id": "CertificateDetails", +"properties": { +"issuer": { +"description": "Optional. The SSL certificate issuer.", +"type": "string" +}, +"subjectAlternativeNames": { +"description": "Optional. The SSL subject alternative names.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "Configuration": { "description": "A configuration represents a behavior an engine should follow when producing new findings.", "id": "Configuration", @@ -1227,6 +1266,10 @@ "$ref": "DomainConfiguration", "description": "Domain Configuration detail config." }, +"domainMonitoring": { +"$ref": "DomainMonitoringConfig", +"description": "Domain Monitoring detail config." +}, "technologyWatchlist": { "$ref": "TechnologyWatchListConfig", "description": "Technology Watchlist detail config." @@ -1720,6 +1763,52 @@ }, "type": "object" }, +"DiscoveryDocument": { +"description": "Replaces the raw string ID to hold associated metadata.", +"id": "DiscoveryDocument", +"properties": { +"documentId": { +"description": "Output only. The identifier of the discovery document.", +"readOnly": true, +"type": "string" +}, +"documentType": { +"description": "Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`).", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"DnsRegistrationDetails": { +"description": "Extracted WHOIS and DNS registration details of the domain.", +"id": "DnsRegistrationDetails", +"properties": { +"expireTime": { +"description": "Optional. The specific timestamp when the current domain registration expires.", +"format": "google-datetime", +"type": "string" +}, +"privateRegistration": { +"description": "Optional. Indicates whether private registration is enabled on the WHOIS record.", +"type": "boolean" +}, +"registrantCountry": { +"description": "Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes", +"type": "string" +}, +"registrar": { +"description": "Optional. The registrar where the domain was registered (e.g., NameCheap).", +"type": "string" +}, +"registrationTime": { +"description": "Optional. The specific timestamp when the domain registration was created.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "DocumentQuery": { "description": "Represents a query to match documents.", "id": "DocumentQuery", @@ -1759,6 +1848,152 @@ }, "type": "object" }, +"DomainMonitoringAlertDetail": { +"description": "A detailed object for a Domain or URL alert.", +"id": "DomainMonitoringAlertDetail", +"properties": { +"dnsDetails": { +"$ref": "DomainMonitoringDnsDetails", +"description": "Optional. The DNS details of the domain or URL." +}, +"domainDetails": { +"$ref": "DomainMonitoringDomainDetails", +"description": "Details specific to a monitored domain." +}, +"gtiDetails": { +"$ref": "DomainMonitoringGtiDetails", +"description": "Optional. The GTI details of the domain or URL." +}, +"infrastructure": { +"$ref": "Infrastructure", +"description": "Optional. The infrastructure of the domain or URL." +}, +"matchedDomain": { +"description": "Optional. The matched domain.", +"type": "string" +}, +"protectedBrand": { +"description": "The protected brand name that triggered the alert.", +"type": "string" +}, +"protectedDomain": { +"$ref": "DomainMonitoringDomainDetails", +"description": "The protected domain that triggered the alert." +}, +"registrationDetails": { +"$ref": "DnsRegistrationDetails", +"description": "Optional. Extracted WHOIS and DNS registration details." +}, +"relationships": { +"$ref": "Relationships", +"description": "Optional. The relationships of the domain or URL." +}, +"threatAttributionDetails": { +"$ref": "ThreatAttributionDetails", +"description": "Optional. The threat attribution details of the domain or URL." +}, +"urlDetails": { +"$ref": "DomainMonitoringUrlDetails", +"description": "Details specific to a monitored URL." +}, +"whoisDetails": { +"$ref": "DomainMonitoringWhoIsDetails", +"description": "Optional. The whois details of the domain or URL." +} +}, +"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" +}, +"DomainMonitoringDnsDetails": { +"description": "The DNS details of the domain.", +"id": "DomainMonitoringDnsDetails", +"properties": { +"dnsRecords": { +"description": "Optional. The DNS records of the domain.", +"items": { +"$ref": "DomainMonitoringDnsRecord" +}, +"type": "array" +}, +"retrievalTime": { +"description": "Optional. The time the DNS details were retrieved.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"DomainMonitoringDnsRecord": { +"description": "The DNS record of the domain.", +"id": "DomainMonitoringDnsRecord", +"properties": { +"asnHosting": { +"description": "Optional. The ASN hosting the domain.", +"type": "string" +}, +"asnRegionCode": { +"description": "Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes.", +"type": "string" +}, +"ipRegionCode": { +"description": "Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes.", +"type": "string" +}, +"recordData": { +"description": "Optional. The value of the DNS record.", +"type": "string" +}, +"resolvedIp": { +"description": "Optional. The resolved IP address.", +"type": "string" +}, +"ttl": { +"description": "Optional. The TTL of the DNS record.", +"format": "int32", +"type": "integer" +}, +"type": { +"description": "Optional. The type of the DNS record.", +"type": "string" +} +}, +"type": "object" +}, +"DomainMonitoringDomain": { +"description": "A Domain Monitoring \"domain\"", +"id": "DomainMonitoringDomain", +"properties": { +"domain": { +"description": "The domain name to match against.", +"type": "string" +} +}, +"type": "object" +}, +"DomainMonitoringDomainDetails": { +"description": "Details specific to a monitored domain.", +"id": "DomainMonitoringDomainDetails", +"properties": { +"domain": { +"description": "Required. The domain name to match against.", +"type": "string" +} +}, +"type": "object" +}, "DomainMonitoringFeatureConfig": { "description": "Specific configuration for the Domain Monitoring feature.", "id": "DomainMonitoringFeatureConfig", @@ -1770,6 +2005,137 @@ }, "type": "object" }, +"DomainMonitoringFindingDetail": { +"description": "A detailed object for a Domain or URL finding.", +"id": "DomainMonitoringFindingDetail", +"properties": { +"dnsDetails": { +"$ref": "DomainMonitoringDnsDetails", +"description": "Optional. The DNS details of the domain or URL." +}, +"domainDetails": { +"$ref": "DomainMonitoringDomainDetails", +"description": "Details specific to a monitored domain." +}, +"gtiDetails": { +"$ref": "DomainMonitoringGtiDetails", +"description": "Optional. The GTI details of the domain or URL." +}, +"infrastructure": { +"$ref": "Infrastructure", +"description": "Optional. The infrastructure of the domain or URL." +}, +"matchedDomain": { +"description": "Optional. The matched domain.", +"type": "string" +}, +"protectedBrand": { +"description": "The protected brand name that triggered the alert.", +"type": "string" +}, +"protectedDomain": { +"$ref": "DomainMonitoringDomainDetails", +"description": "The protected domain that triggered the alert." +}, +"registrationDetails": { +"$ref": "DnsRegistrationDetails", +"description": "Optional. Extracted WHOIS and DNS registration details." +}, +"relationships": { +"$ref": "Relationships", +"description": "Optional. The relationships of the domain or URL." +}, +"threatAttributionDetails": { +"$ref": "ThreatAttributionDetails", +"description": "Optional. The threat attribution details of the domain or URL." +}, +"urlDetails": { +"$ref": "DomainMonitoringUrlDetails", +"description": "Details specific to a monitored URL." +}, +"whoisDetails": { +"$ref": "DomainMonitoringWhoIsDetails", +"description": "Optional. The whois details of the domain or URL." +} +}, +"type": "object" +}, +"DomainMonitoringGtiDetails": { +"description": "The GTI details of the domain.", +"id": "DomainMonitoringGtiDetails", +"properties": { +"avDetections": { +"$ref": "AVDetections", +"description": "Optional. Detection counts across vendor feeds." +}, +"domainPermutation": { +"description": "Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph).", +"type": "string" +}, +"gtiDomainUri": { +"description": "Optional. The GTI link for the domain.", +"type": "string" +}, +"gtiScore": { +"description": "Optional. The GTI score of the domain. The threat score is a number between 0 and 100.", +"format": "int32", +"type": "integer" +}, +"threatClassification": { +"description": "Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring).", +"type": "string" +}, +"verdict": { +"description": "Output only. The verdict of the domain.", +"enum": [ +"DOMAIN_MONITORING_GTI_VERDICT_UNSPECIFIED", +"DOMAIN_MONITORING_GTI_VERDICT_BENIGN", +"DOMAIN_MONITORING_GTI_VERDICT_UNDETECTED", +"DOMAIN_MONITORING_GTI_VERDICT_SUSPICIOUS", +"DOMAIN_MONITORING_GTI_VERDICT_MALICIOUS", +"DOMAIN_MONITORING_GTI_VERDICT_UNKNOWN" +], +"enumDescriptions": [ +"Default value. The verdict is not set or unspecified.", +"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" +} +}, +"type": "object" +}, +"DomainMonitoringUrlDetails": { +"description": "Details specific to a monitored URL.", +"id": "DomainMonitoringUrlDetails", +"properties": { +"url": { +"description": "Required. The URL to match against.", +"type": "string" +} +}, +"type": "object" +}, +"DomainMonitoringWhoIsDetails": { +"description": "The whois details of the domain.", +"id": "DomainMonitoringWhoIsDetails", +"properties": { +"retrievalTime": { +"description": "Optional. The time the whois details were retrieved.", +"format": "google-datetime", +"type": "string" +}, +"whois": { +"description": "Optional. The whois details of the domain.", +"type": "string" +} +}, +"type": "object" +}, "DomainSetting": { "description": "Feature settings and toggles for a single specific domain.", "id": "DomainSetting", @@ -1967,6 +2333,10 @@ "readOnly": true, "type": "string" }, +"domainMonitoring": { +"$ref": "DomainMonitoringFindingDetail", +"description": "Domain Monitoring finding detail type." +}, "initialAccessBroker": { "$ref": "InitialAccessBrokerFindingDetail", "description": "Initial Access Broker finding detail type." @@ -2008,17 +2378,41 @@ }, "type": "object" }, +"Infrastructure": { +"description": "Core infrastructure observations associated with the URL or Domain.", +"id": "Infrastructure", +"properties": { +"certificateDetails": { +"$ref": "CertificateDetails", +"description": "Optional. SSL certificate details." +}, +"urlResponse": { +"description": "Optional. The raw URL response string.", +"type": "string" +} +}, +"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", +"deprecated": true, +"description": "Optional. Deprecated: Use `discovery_documents` instead. Array of ids to accommodate multiple discovery documents.", "items": { "type": "string" }, "type": "array" }, +"discoveryDocuments": { +"description": "Output only. New structured metadata payload.", +"items": { +"$ref": "DiscoveryDocument" +}, +"readOnly": true, +"type": "array" +}, "severity": { "description": "Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL`", "type": "string" @@ -2049,11 +2443,11 @@ "CRITICAL" ], "enumDescriptions": [ -"", -"", -"", -"", -"" +"Default value, should never be set.", +"Low severity.", +"Medium severity.", +"High severity.", +"Critical severity." ], "type": "string" } @@ -2503,6 +2897,34 @@ }, "type": "object" }, +"Relationships": { +"description": "Related entities and domains observed for the target.", +"id": "Relationships", +"properties": { +"relatedUrls": { +"description": "Optional. Related URLs associated with the domain.", +"items": { +"type": "string" +}, +"type": "array" +}, +"siblingDomains": { +"description": "Optional. Sibling domains sharing the same IP address.", +"items": { +"type": "string" +}, +"type": "array" +}, +"subdomains": { +"description": "Optional. Subdomains associated with the target domain or URL.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "RelevanceAnalysis": { "description": "Structured relevance analysis for a threat.", "id": "RelevanceAnalysis", @@ -2762,6 +3184,34 @@ }, "type": "object" }, +"ThreatAttributionDetails": { +"description": "Threat attribution information (actor, campaign, etc.).", +"id": "ThreatAttributionDetails", +"properties": { +"actors": { +"description": "Optional. The threat actors associated with the target.", +"items": { +"type": "string" +}, +"type": "array" +}, +"collections": { +"description": "Optional. The threat collections detected.", +"items": { +"type": "string" +}, +"type": "array" +}, +"malware": { +"description": "Optional. The malware associated with the threat.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "UpsertConfigurationResponse": { "description": "Response message for UpsertConfiguration.", "id": "UpsertConfigurationResponse", diff --git a/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json b/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json index 4d0ee0ee50..574a5bb7e1 100644 --- a/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json +++ b/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json @@ -193,7 +193,7 @@ "type": "string" }, "parent": { -"description": "Required. The parent organization whose publications to list. Format: `organizations/{organization}`.", +"description": "Required. The parent organization whose publications to list, or \"organizations/-\" for all organizations a user has access to. Format: `organizations/{organization}`.", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -446,7 +446,7 @@ } } }, -"revision": "20260906", +"revision": "20260924", "rootUrl": "https://webcontentpublisher.googleapis.com/", "schemas": { "CheckFreeAccessResponse": { diff --git a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json index 2ebaf6f858..4432c0aab7 100644 --- a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json +++ b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json @@ -15,273 +15,6 @@ "description": "Workload Manager is a service that provides tooling for enterprise workloads to automate the deployment and validation of your workloads against best practices and recommendations.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/workload-manager/docs", -"endpoints": [ -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-central1.rep.googleapis.com/", -"location": "us-central1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-east1.rep.googleapis.com/", -"location": "us-east1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-east4.rep.googleapis.com/", -"location": "us-east4" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-west1.rep.googleapis.com/", -"location": "us-west1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-west4.rep.googleapis.com/", -"location": "us-west4" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.australia-southeast1.rep.googleapis.com/", -"location": "australia-southeast1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west3.rep.googleapis.com/", -"location": "europe-west3" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west1.rep.googleapis.com/", -"location": "europe-west1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west2.rep.googleapis.com/", -"location": "europe-west2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-east5.rep.googleapis.com/", -"location": "us-east5" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-south1.rep.googleapis.com/", -"location": "us-south1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-west2.rep.googleapis.com/", -"location": "us-west2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-west3.rep.googleapis.com/", -"location": "us-west3" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west9.rep.googleapis.com/", -"location": "europe-west9" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-south1.rep.googleapis.com/", -"location": "asia-south1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-south2.rep.googleapis.com/", -"location": "asia-south2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west4.rep.googleapis.com/", -"location": "europe-west4" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west8.rep.googleapis.com/", -"location": "europe-west8" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.northamerica-northeast1.rep.googleapis.com/", -"location": "northamerica-northeast1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.northamerica-northeast2.rep.googleapis.com/", -"location": "northamerica-northeast2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.australia-southeast2.rep.googleapis.com/", -"location": "australia-southeast2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-central2.rep.googleapis.com/", -"location": "europe-central2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west6.rep.googleapis.com/", -"location": "europe-west6" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west10.rep.googleapis.com/", -"location": "europe-west10" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-west12.rep.googleapis.com/", -"location": "europe-west12" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-east1.rep.googleapis.com/", -"location": "asia-east1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-east2.rep.googleapis.com/", -"location": "asia-east2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-northeast1.rep.googleapis.com/", -"location": "asia-northeast1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-northeast2.rep.googleapis.com/", -"location": "asia-northeast2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-northeast3.rep.googleapis.com/", -"location": "asia-northeast3" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-southeast1.rep.googleapis.com/", -"location": "asia-southeast1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-southeast2.rep.googleapis.com/", -"location": "asia-southeast2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-north1.rep.googleapis.com/", -"location": "europe-north1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-southwest1.rep.googleapis.com/", -"location": "europe-southwest1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.me-central1.rep.googleapis.com/", -"location": "me-central1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.me-central2.rep.googleapis.com/", -"location": "me-central2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.southamerica-east1.rep.googleapis.com/", -"location": "southamerica-east1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.southamerica-west1.rep.googleapis.com/", -"location": "southamerica-west1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.me-west1.rep.googleapis.com/", -"location": "me-west1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.africa-south1.rep.googleapis.com/", -"location": "africa-south1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.northamerica-south1.rep.googleapis.com/", -"location": "northamerica-south1" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us-central2.rep.googleapis.com/", -"location": "us-central2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.europe-north2.rep.googleapis.com/", -"location": "europe-north2" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.asia-southeast3.rep.googleapis.com/", -"location": "asia-southeast3" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.au.rep.googleapis.com/", -"location": "au" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.ca.rep.googleapis.com/", -"location": "ca" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.ch.rep.googleapis.com/", -"location": "ch" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.eu.rep.googleapis.com/", -"location": "eu" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.gb.rep.googleapis.com/", -"location": "gb" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.in.rep.googleapis.com/", -"location": "in" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.jp.rep.googleapis.com/", -"location": "jp" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.sa.rep.googleapis.com/", -"location": "sa" -}, -{ -"description": "Regional Endpoint", -"endpointUrl": "https://workloadmanager.us.rep.googleapis.com/", -"location": "us" -} -], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -1515,7 +1248,7 @@ } } }, -"revision": "20260908", +"revision": "20260916", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "ActiveDirectory": { diff --git a/googleapiclient/discovery_cache/documents/youtube.v3.json b/googleapiclient/discovery_cache/documents/youtube.v3.json index 1f0fa310ce..04cc96e503 100644 --- a/googleapiclient/discovery_cache/documents/youtube.v3.json +++ b/googleapiclient/discovery_cache/documents/youtube.v3.json @@ -803,7 +803,7 @@ ], "parameters": { "onBehalfOfContentOwner": { -"description": "The *onBehalfOfContentOwner* parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner.", +"description": "The *onBehalfOfContentOwner* parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner. This parameter must be provided if the request is authenticated with credentials for a CMS content owner user acting on a managed channel. If omitted, the request executes under the authenticated user's direct context and returns an HTTP 403 Forbidden error.", "location": "query", "type": "string" }, @@ -2784,7 +2784,7 @@ "completed" ], "enumDescriptions": [ -"", +"The resource does not have live broadcast content.", "The live broadcast is upcoming.", "The live broadcast is active.", "The live broadcast has been completed." @@ -3894,7 +3894,7 @@ "dislike" ], "enumDescriptions": [ -"", +"The entity has not been rated.", "The entity is liked.", "The entity is disliked." ], @@ -3963,7 +3963,7 @@ "dislike" ], "enumDescriptions": [ -"", +"The entity has not been rated.", "The entity is liked.", "The entity is disliked." ], @@ -4193,7 +4193,7 @@ } } }, -"revision": "20260902", +"revision": "20260923", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -4291,14 +4291,6 @@ "$ref": "ActivityContentDetailsComment", "description": "The `comment` object contains information about a resource that received a comment. This property is only present if the `snippet.type` is `comment`." }, -"favorite": { -"$ref": "ActivityContentDetailsFavorite", -"description": "The `favorite` object contains information about a video that was marked as a favorite video. This property is only present if the `snippet.type` is `favorite`. Deprecated: This property is no longer returned." -}, -"like": { -"$ref": "ActivityContentDetailsLike", -"description": "The `like` object contains information about a resource that received a positive (like) rating. This property is only present if the `snippet.type` is `like`. Deprecated: This property is no longer returned." -}, "playlistItem": { "$ref": "ActivityContentDetailsPlaylistItem", "description": "The `playlistItem` object contains information about a new playlist item. This property is only present if the `snippet.type` is `playlistItem`." @@ -4317,7 +4309,7 @@ }, "subscription": { "$ref": "ActivityContentDetailsSubscription", -"description": "The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`. Deprecated: This property is no longer returned." +"description": "The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`." }, "upload": { "$ref": "ActivityContentDetailsUpload", @@ -4359,28 +4351,6 @@ }, "type": "object" }, -"ActivityContentDetailsFavorite": { -"description": "Information about a video that was marked as a favorite video. Deprecated: This resource is no longer returned.", -"id": "ActivityContentDetailsFavorite", -"properties": { -"resourceId": { -"$ref": "ResourceId", -"description": "The `resourceId` object contains information that identifies the resource that was marked as a favorite." -} -}, -"type": "object" -}, -"ActivityContentDetailsLike": { -"description": "Information about a resource that received a positive (like) rating. Deprecated: This resource is no longer returned.", -"id": "ActivityContentDetailsLike", -"properties": { -"resourceId": { -"$ref": "ResourceId", -"description": "The `resourceId` object contains information that identifies the rated resource." -} -}, -"type": "object" -}, "ActivityContentDetailsPlaylistItem": { "description": "Information about a new playlist item.", "id": "ActivityContentDetailsPlaylistItem", @@ -4469,14 +4439,10 @@ "description": "The reason that the resource is recommended to the user.", "enum": [ "reasonUnspecified", -"videoFavorited", -"videoLiked", "videoWatched" ], "enumDescriptions": [ "", -"Deprecated: This reason is no longer used.", -"Deprecated: This reason is no longer used.", "" ], "type": "string" @@ -4532,7 +4498,7 @@ "type": "object" }, "ActivityContentDetailsSubscription": { -"description": "Information about a channel that a user subscribed to. Deprecated: This resource is no longer returned.", +"description": "Information about a channel that a user subscribed to.", "id": "ActivityContentDetailsSubscription", "properties": { "resourceId": { @@ -4638,8 +4604,6 @@ "enum": [ "typeUnspecified", "upload", -"like", -"favorite", "comment", "subscription", "playlistItem", @@ -4652,10 +4616,8 @@ "enumDescriptions": [ "", "", -"Deprecated: This type is no longer supported.", -"Deprecated: This type is no longer supported.", "", -"Deprecated: This type is no longer supported.", +"", "", "", "", @@ -6053,7 +6015,7 @@ false "dislike" ], "enumDescriptions": [ -"", +"The entity has not been rated.", "The entity is liked.", "The entity is disliked." ], @@ -10834,7 +10796,7 @@ false "completed" ], "enumDescriptions": [ -"", +"The resource does not have live broadcast content.", "The live broadcast is upcoming.", "The live broadcast is active.", "The live broadcast has been completed." @@ -12238,7 +12200,7 @@ false "dislike" ], "enumDescriptions": [ -"", +"The entity has not been rated.", "The entity is liked.", "The entity is disliked." ], @@ -12308,7 +12270,7 @@ false "completed" ], "enumDescriptions": [ -"", +"The resource does not have live broadcast content.", "The live broadcast is upcoming.", "The live broadcast is active.", "The live broadcast has been completed." @@ -12464,7 +12426,7 @@ false "type": "object" }, "VideoStatus": { -"description": "Basic details about a video category, such as its localized title. Next Id: 19", +"description": "Basic details about a video category, such as its localized title. Next Id: 20", "id": "VideoStatus", "properties": { "containsSyntheticMedia": { @@ -12502,8 +12464,8 @@ false "creativeCommon" ], "enumDescriptions": [ -"", -"" +"Standard YouTube license.", +"Creative Commons license." ], "type": "string" },